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

> Source: https://docs.blockvectra.com/uk/guides/wallet-custom-rpc/

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

* **Перший крок:** [Ознайомтеся з таблицею параметрів мережі для гаманців](#supported-chains-network-parameter-table) та введіть її поля у вашому гаманці, використовуючи `/v1/{chain}/{api_key}` для автентифікованого RPC.
* **Готово, коли:** Збереження додає мережу та перемикається на неї в MetaMask; налаштований Chain ID збігається з ID, який повертає ендпоінт.

[Параметри мережі та варіанти доступу](https://blockvectra.com/en/chains/robinhood_mainnet/).

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

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

* **Robinhood Chain**:
  На сторінці офіційної документації [Connecting to Robinhood Chain](https://docs.robinhood.com/chain/connecting) зазначено, що публічний ендпоінт `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](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/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`:
   ```http
   /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**: Основна веб-адреса оглядача блоків мережі.

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

| Назва мережі | URL RPC (ключ у шляху) | Chain ID | Символ валюти | URL оглядача блоків |
| --- | --- | --- | --- | --- |
| [arb_mainnet](https://blockvectra.com/uk/chains/arb_mainnet/) | `https://api.blockvectra.com/v1/arb_mainnet/{api_key}` | 42161 | [ETH](https://docs.arbitrum.io/build-decentralized-apps/reference/node-providers) | [arbiscan.io](https://arbiscan.io) |
| [base_mainnet](https://blockvectra.com/uk/chains/base_mainnet/) | `https://api.blockvectra.com/v1/base_mainnet/{api_key}` | 8453 | [ETH](https://docs.base.org/docs/network-information/) | [basescan.org](https://basescan.org) |
| [bsc_mainnet](https://blockvectra.com/uk/chains/bsc_mainnet/) | `https://api.blockvectra.com/v1/bsc_mainnet/{api_key}` | 56 | [BNB](https://docs.bnbchain.org/) | [bscscan.com](https://bscscan.com) |
| [Ethereum](https://blockvectra.com/uk/chains/eth_mainnet/) | `https://api.blockvectra.com/v1/eth_mainnet/{api_key}` | 1 | [ETH](https://ethereum.org/) | [etherscan.io](https://etherscan.io) |
| [eth_sepolia](https://blockvectra.com/uk/chains/eth_sepolia/) | `https://api.blockvectra.com/v1/eth_sepolia/{api_key}` | 11155111 | [SepoliaETH](https://ethereum.org/en/developers/docs/networks/#sepolia) | [sepolia.etherscan.io](https://sepolia.etherscan.io) |
| [HyperEVM](https://blockvectra.com/uk/chains/hyperevm_mainnet/) | `https://api.blockvectra.com/v1/hyperevm_mainnet/{api_key}` | 999 | [HYPE](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm) | [hyperscan.com](https://www.hyperscan.com/) |
| [polygon_mainnet](https://blockvectra.com/uk/chains/polygon_mainnet/) | `https://api.blockvectra.com/v1/polygon_mainnet/{api_key}` | 137 | [POL](https://docs.polygon.technology/) | [polygonscan.com](https://polygonscan.com) |
| [Robinhood Chain](https://blockvectra.com/uk/chains/robinhood_mainnet/) | `https://api.blockvectra.com/v1/robinhood_mainnet/{api_key}` | 4663 | [ETH](https://docs.robinhood.com/chain/connecting) | [robinhoodchain.blockscout.com](https://robinhoodchain.blockscout.com) |
| [robinhood_testnet](https://blockvectra.com/uk/chains/robinhood_testnet/) | `https://api.blockvectra.com/v1/robinhood_testnet/{api_key}` | 46630 | [ETH](https://docs.robinhood.com/chain/connecting) | [explorer.testnet.chain.robinhood.com](https://explorer.testnet.chain.robinhood.com) |

> **Обмеження HyperEVM щодо режиму тільки для читання**: Ендпоінт HyperEVM від BlockVectra підтримує операції читання, але не транслює транзакції в мережу. Використовуйте RPC з підтримкою eth\_sendRawTransaction під час надсилання транзакцій із вашого гаманця. Подробиці щодо трансляції див. у розділі [Розгортання за допомогою Foundry або Hardhat](https://docs.blockvectra.com/en/guides/hyperevm-backfill/#deploy-with-foundry-or-hardhat) посібника з HyperEVM.

API key працює для всіх підтримуваних мереж шляхом заміни `{chain}` у шляху на потрібний слаг мережі. Детальніше про спільні квоти та маршрутизацію URL див. у [Посібнику «Один ключ, багато мереж»](https://docs.blockvectra.com/en/guides/one-key-many-chains/).

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

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

На основі офіційного посібника MetaMask [How to add a custom network RPC](https://support.metamask.io/networks-and-sidechains/managing-networks/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](https://docs.blockvectra.com/en/guides/hyperevm-backfill/#deploy-with-foundry-or-hardhat)).

> **Редагування наявної мережі**: Щоб оновити 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 викликаного методу (див. [сторінку цін](https://blockvectra.com/en/pricing/)) у межах квот вашого акаунта.
2. **Створюйте окремий API key для кожного гаманця**:
   У [Консолі](https://console.blockvectra.com/login/?next=%2Fkeys%2F) створіть окремий API key з міткою спеціально для вашого гаманця (наприклад, `metamask-desktop` або `rabby-extension`). Це дозволить ізолювати особистий трафік гаманця від ваших серверних застосунків, автоматизованих скриптів та AI-агентів.
3. **Незалежне відкликання в разі компрометації**:
   Якщо ви підозрюєте, що API key, налаштований у гаманці, скомпрометовано, негайно відкличте цей окремий ключ у консолі без будь-якого впливу на інші активні ключі чи сервіси.
   Якщо термін дії вашої сесії закінчився або ключ втрачено, перегляньте розділ [Втратили сесію або API key?](https://docs.blockvectra.com/en/guides/programmatic-signup/#lost-your-session-or-api-key) у посібнику з програмної реєстрації, щоб відновити контроль за допомогою підпису вашого Ethereum-гаманця.

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

* [Ліміти історичного стану](https://docs.blockvectra.com/en/guides/evm-historical-state/): перевіряйте вікна автентифікованого стану та історію без ключа перед запитом давнього балансу або значення контракту; діапазони запитів журналів мають окремий ліміт.
* [Посібник «Один ключ, багато мереж»](https://docs.blockvectra.com/en/guides/one-key-many-chains/): детальні правила маршрутизації URL, програмне виявлення через `GET /v1/chains` та механіка міжмережевих квот.
* [Ціни та ліміти планів](https://blockvectra.com/en/pricing/): інформація про вагу CU, швидкість поповнення пропускної здатності та оновлення через депозит платежів.

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

* [Переглянути каталог наборів даних](https://blockvectra.com/en/data/), щоб ознайомитися з кожним набором даних, який індексує BlockVectra.
* [Ознайомитися з безкоштовним планом та цінами](https://blockvectra.com/en/pricing/#free), щоб дізнатися, що включено у ваш акаунт.
* [Увійти в консоль](https://console.blockvectra.com/login/?next=%2Fkeys%2F), щоб створити API key.