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

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

• Первый шаг: Ознакомьтесь с таблицей параметров сети для кошелька и введите ее поля в кошелек, используя путь /v1/{chain}/{api_key} для аутентифицированного RPC.
• Критерий завершения: сохранение добавляет сеть и переключается на нее в MetaMask; настроенный Chain 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. URL RPC (RPC URL): эндпоинт для связи. API key должен быть указан в пути URL, с использованием пути /v1/{chain}/{api_key} на api.blockvectra.com:

   Копировать текст

   /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): основной веб-адрес обозревателя блоков сети.

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

Ограничение 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. Выберите Добавить сеть, затем внизу нажмите Добавить сеть вручную.
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).

Редактирование существующей сети: чтобы обновить 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 (см. страницу тарифов) в рамках лимитов вашего аккаунта.
2. Создайте отдельный API key для каждого кошелька: В Консоли создайте отдельный API key с меткой, указывающей на ваш кошелек (например, metamask-desktop или rabby-extension). Это изолирует трафик вашего персонального кошелька от серверных приложений, автоматических скриптов и AI Agent.
3. Независимый отзыв ключа при компрометации: Если вы подозреваете, что API key, настроенный в кошельке, был скомпрометирован, немедленно отзовите этот конкретный ключ в консоли без ущерба для других работающих ключей или сервисов. Если ваша сессия истекла или ключ утерян, обратитесь к разделу Потеряли сессию или API key? в руководстве по программной регистрации, чтобы восстановить доступ с помощью подписи вашего Ethereum-кошелька.

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

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

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

• Изучите каталог наборов данных, чтобы увидеть все наборы данных, индексируемые BlockVectra.
• Посмотрите бесплатный тариф и цены, чтобы узнать, что включено в ваш аккаунт.
• Войдите в консоль, чтобы создать API key.