Налаштування власного RPC у MetaMask та Rabby: URL та Chain ID

Додайте RPC URL, Chain ID та нативний символ у MetaMask або Rabby та використовуйте окремий ключ гаманця, коли потрібна автентифікація.

• Перший крок: Ознайомтеся з таблицею параметрів мережі для гаманців та введіть її поля у вашому гаманці, використовуючи /v1/{chain}/{api_key} для автентифікованого RPC.
• Готово, коли: Збереження додає мережу та перемикається на неї в MetaMask; налаштований Chain ID збігається з ID, який повертає ендпоінт.

Параметри мережі та варіанти доступу.

1. Чому варто використовувати власний RPC

Блокчейн-екосистеми зазвичай надають загальнодоступні публічні RPC-ендпоінти за замовчуванням для базового використання спільнотою та знайомства розробників. Проте офіційна документація мереж визначає чіткі ліміти швидкості та сферу використання для цих ендпоінтів:

• Robinhood Chain: На сторінці офіційної документації Connecting to Robinhood Chain зазначено, що публічний ендпоінт https://rpc.mainnet.chain.robinhood.com має обмеження швидкості та не рекомендується для робочих навантажень у продакшені (The following public endpoints are available but are rate-limited and not recommended for production use. For production, use a provider).
• HyperEVM: На сторінці офіційної документації Rate limits and user limits вказано ліміт за IP для публічного ендпоінта rpc.hyperliquid.xyz/evm, що становить щонайбільше 100 запитів EVM JSON-RPC на хвилину (Maximum of 100 EVM JSON-RPC requests per minute for rpc.hyperliquid.xyz/evm).

2. Обов'язкові поля гаманця та параметри мережі

EVM-гаманці вимагають заповнення кількох обов'язкових полів під час додавання або редагування мережі:

1. Network Name: Зручна для читання назва, що відображається в інтерфейсі гаманця.
2. RPC URL: Ендпоінт для зв'язку. API key має бути вказаний у шляху URL, використовуючи шлях /v1/{chain}/{api_key} на api.blockvectra.com:

   Скопіювати текст

   /v1/{chain}/{api_key}

   Важливо: Такі гаманці, як MetaMask та Rabby, приймають лише стандартні URL-адреси HTTP(S) у полі RPC URL і не підтримують кастомні заголовки запитів (наприклад, x-api-key: {api_key}). Відповідно, підключення з гаманця повинні передавати API key безпосередньо у шляху URL. Не додавайте скісну риску в кінці після {api_key}, і зверніть увагу, що запити до невідомої {chain} повертають HTTP 404.

3. Chain ID: Цілочисельний ідентифікатор мережі згідно з EIP-155.
4. Currency Symbol: Символ нативного газу мережі (наприклад, ETH, HYPE).
5. Block Explorer URL: Основна веб-адреса оглядача блоків мережі.

Таблиця параметрів мереж підтримуваних блокчейнів

Обмеження HyperEVM щодо режиму тільки для читання: Ендпоінт HyperEVM від BlockVectra підтримує операції читання, але не транслює транзакції в мережу. Використовуйте RPC з підтримкою eth_sendRawTransaction під час надсилання транзакцій із вашого гаманця. Подробиці щодо трансляції див. у розділі Розгортання за допомогою Foundry або Hardhat посібника з HyperEVM.

API key працює для всіх підтримуваних мереж шляхом заміни {chain} у шляху на потрібний слаг мережі. Детальніше про спільні квоти та маршрутизацію URL див. у Посібнику «Один ключ, багато мереж».

3. Покрокові інструкції для гаманців

Кроки налаштування MetaMask

На основі офіційного посібника MetaMask How to add a custom network RPC:

1. Відкрийте розширення MetaMask для браузера або мобільний застосунок.
2. Натисніть на спадне меню вибору мережі у верхній частині інтерфейсу (або перейдіть у Налаштування > Мережі).
3. Виберіть Add network, а потім натисніть Add a network manually внизу.
4. Заповніть дані мережі, використовуючи наведену вище таблицю:
   • Network Name: Введіть назву мережі з таблиці вище.
   • New RPC URL: Введіть ваш ендпоінт з автентифікацією через шлях, наприклад https://api.blockvectra.com/v1/robinhood_mainnet/{api_key} (замініть {api_key} на ваш справжній API key).
   • Chain ID: Введіть цілочисельний Chain ID з таблиці вище.
   • Currency Symbol: Введіть символ нативного активу з таблиці вище.
   • Block Explorer URL: Введіть офіційну адресу оглядача блоків із таблиці вище (необов'язково).
5. Натисніть Save, щоб додати мережу та перемкнутися на неї.

Надсилання транзакцій на HyperEVM: Ендпоінт HyperEVM від BlockVectra підтримує читання, але не транслює транзакції в мережу. Використовуйте RPC, що підтримує eth_sendRawTransaction, під час відправлення з гаманця (див. пояснення щодо трансляції на HyperEVM).

Редагування наявної мережі: Щоб оновити RPC-ендпоінт для мережі, яка вже є у вашому списку, перейдіть у Налаштування > Мережі, виберіть потрібну мережу, відредагуйте або додайте URL-адресу BlockVectra в полі RPC URL та збережіть зміни.

Кроки налаштування Rabby Wallet

У налаштуваннях кастомної мережі або кастомного RPC в Rabby введіть параметри з таблиці вище: Network Name, RPC URL (з ключем у шляху https://api.blockvectra.com/v1/{chain}/{api_key}), Chain ID, Currency Symbol та Block Explorer URL.

Примітка: Під час додавання кастомної мережі або тестової мережі переконайтеся, що Chain ID збігається з ID, який повертає ендпоінт, щоб уникнути помилок невідповідності мережі.

4. Поради щодо безпеки та керування використанням

Пам'ятайте про такі принципи безпеки та тарифікації під час роботи з власним RPC:

[!WARNING] Ризик розкриття API key: Шлях RPC URL містить ваш API key у відкритому вигляді. Ніколи не діліться знімками екрана з конфігурацією мережі гаманця в публічних чатах або на форумах, і не додавайте URL-адреси з вашим активним ключем у публічні репозиторії коду чи документацію.

1. Запити гаманця враховуються у використання акаунта: Відкриття гаманця, перемикання акаунтів або оновлення списків активів викликає живі JSON-RPC запити (такі як eth_blockNumber, eth_getBalance та eth_call). Ці запити споживають ліміти відповідно до ваги CU викликаного методу (див. сторінку цін) у межах квот вашого акаунта.
2. Створюйте окремий API key для кожного гаманця: У Консолі створіть окремий API key з міткою спеціально для вашого гаманця (наприклад, metamask-desktop або rabby-extension). Це дозволить ізолювати особистий трафік гаманця від ваших серверних застосунків, автоматизованих скриптів та AI-агентів.
3. Незалежне відкликання в разі компрометації: Якщо ви підозрюєте, що API key, налаштований у гаманці, скомпрометовано, негайно відкличте цей окремий ключ у консолі без будь-якого впливу на інші активні ключі чи сервіси. Якщо термін дії вашої сесії закінчився або ключ втрачено, перегляньте розділ Втратили сесію або API key? у посібнику з програмної реєстрації, щоб відновити контроль за допомогою підпису вашого Ethereum-гаманця.

5. Пов'язані ресурси

• Ліміти історичного стану: перевіряйте вікна автентифікованого стану та історію без ключа перед запитом давнього балансу або значення контракту; діапазони запитів журналів мають окремий ліміт.
• Посібник «Один ключ, багато мереж»: детальні правила маршрутизації URL, програмне виявлення через GET /v1/chains та механіка міжмережевих квот.
• Ціни та ліміти планів: інформація про вагу CU, швидкість поповнення пропускної здатності та оновлення через депозит платежів.

Наступні кроки

• Переглянути каталог наборів даних, щоб ознайомитися з кожним набором даних, який індексує BlockVectra.
• Ознайомитися з безкоштовним планом та цінами, щоб дізнатися, що включено у ваш акаунт.
• Увійти в консоль, щоб створити API key.