# Настройка пользовательского RPC в MetaMask и Rabby: URL и Chain ID

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

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

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

[Параметры сети и варианты доступа](https://blockvectra.com/ru/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. **URL RPC (RPC URL)**: эндпоинт для связи. **API key должен быть указан в пути URL**, с использованием пути `/v1/{chain}/{api_key}` на `api.blockvectra.com`:
   ```http
   /v1/{chain}/{api_key}
   ```
   > **Важно**: кошельки, такие как MetaMask и Rabby, принимают только стандартные HTTP(S) URL в поле 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. **URL проводника блоков (Block Explorer URL)**: основной веб-адрес обозревателя блоков сети.

### Таблица параметров сети поддерживаемых сетей

| Название сети | URL RPC (Key в пути) | Chain ID | Символ валюты | URL обозревателя блоков |
| --- | --- | --- | --- | --- |
| [arb_mainnet](https://blockvectra.com/ru/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/ru/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/ru/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/ru/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/ru/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/ru/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/ru/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/ru/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/ru/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/ru/guides/hyperevm-backfill/#deploy-with-foundry-or-hardhat) в руководстве по HyperEVM.

API key работает во всех поддерживаемых сетях путем подстановки нужного слага сети вместо `{chain}` в пути. Подробности об общих квотах и маршрутизации URL см. в [руководстве «Один ключ — множество сетей»](https://docs.blockvectra.com/ru/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. Выберите **Добавить сеть**, затем внизу нажмите **Добавить сеть вручную**.
4. Заполните данные сети, используя приведенную выше таблицу:
   * **Имя сети**: введите название сети из таблицы выше.
   * **Новый URL RPC**: введите ваш эндпоинт с аутентификацией в пути, например `https://api.blockvectra.com/v1/robinhood_mainnet/{api_key}` (замените `{api_key}` на ваш реальный API key).
   * **Идентификатор цепочки**: введите целочисленный Chain ID из таблицы выше.
   * **Символ валюты**: введите символ нативного актива из таблицы выше.
   * **URL-адрес проводника блоков**: введите официальный адрес проводника блоков из таблицы выше (необязательно).
5. Нажмите **Сохранить**, чтобы добавить сеть и переключиться на нее.

> **Отправка транзакций в HyperEVM**: эндпоинт HyperEVM от BlockVectra поддерживает чтение, но не выполняет широковещательную рассылку транзакций. Используйте RPC с поддержкой eth\_sendRawTransaction при отправке транзакций из вашего кошелька (см. [разъяснение о рассылке транзакций в HyperEVM](https://docs.blockvectra.com/ru/guides/hyperevm-backfill/#deploy-with-foundry-or-hardhat)).

> **Редактирование существующей сети**: чтобы обновить RPC-эндпоинт для сети, которая уже есть в вашем списке, перейдите в Настройки > Сети, выберите целевую сеть, отредактируйте или добавьте ваш URL от BlockVectra в поле «URL RPC» и сохраните изменения.

### Шаги по настройке кошелька Rabby

В настройках пользовательской сети или пользовательского 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**: путь в URL RPC содержит ваш API key в виде открытого текста. Никогда не делитесь скриншотами настроек сети вашего кошелька в публичных чатах или на форумах и не коммитьте URL с вашим действующим ключом в публичные репозитории кода или документацию.

1. **Запросы кошелька учитываются в объеме использования аккаунта**:
   Открытие кошелька, переключение аккаунтов или обновление списков активов вызывают реальные запросы JSON-RPC (такие как `eth_blockNumber`, `eth_getBalance` и `eth_call`). Эти запросы расходуют лимит в соответствии с весом вызываемого метода в CU (см. [страницу тарифов](https://blockvectra.com/ru/pricing/)) в рамках лимитов вашего аккаунта.
2. **Создайте отдельный API key для каждого кошелька**:
   В [Консоли](https://console.blockvectra.com/login/?next=%2Fkeys%2F) создайте отдельный API key с меткой, указывающей на ваш кошелек (например, `metamask-desktop` или `rabby-extension`). Это изолирует трафик вашего персонального кошелька от серверных приложений, автоматических скриптов и AI Agent.
3. **Независимый отзыв ключа при компрометации**:
   Если вы подозреваете, что API key, настроенный в кошельке, был скомпрометирован, немедленно отзовите этот конкретный ключ в консоли без ущерба для других работающих ключей или сервисов.
   Если ваша сессия истекла или ключ утерян, обратитесь к разделу [Потеряли сессию или API key?](https://docs.blockvectra.com/ru/guides/programmatic-signup/#lost-your-session-or-api-key) в руководстве по программной регистрации, чтобы восстановить доступ с помощью подписи вашего Ethereum-кошелька.

## 5. Связанные ресурсы

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

## Следующие шаги

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