Кран testnet Robinhood Chain

Получайте тестовый ETH со своим API key: требования к аккаунту, лимиты получения, принятые транзакции и обработка ошибок.

Используйте кран для получения тестового ETH для транзакций в testnet Robinhood Chain (robinhood_testnet, chain ID 46630). Запрос средств бесплатен и не расходует CU; последующие вызовы RPC в testnet тарифицируются в обычном порядке по CU.

Первый шаг: Отправьте запрос на получение средств со своим API key и адресом получателя, используя пример с curl ниже.
Критерий готовности: HTTP 202 и tx_hash подтверждают принятие запроса; используйте запрос квитанции транзакции ниже для проверки включения в блок перед тем, как считать получение подтвержденным.

Параметры testnet и варианты доступа.

Перед отправкой запроса

Зарегистрируйте аккаунт BlockVectra и используйте один из собственных API keys. Создайте ключ в консоли или следуйте руководству по программной регистрации.

Используйте 0x с последующими 40 шестнадцатеричными символами в нижнем регистре или со смешанным регистром с корректной контрольной суммой EIP-55. В ответах адреса возвращаются в нижнем регистре; различные варианты написания одного и того же адреса имеют общий лимит на получение средств.

Отправка запроса на получение средств

Вызовите POST https://api.blockvectra.com/v1/faucet/robinhood_testnet с заголовком Content-Type: application/json и вашим ключом в x-api-key. Этот эндпоинт не считывает ключ из пути URL или заголовка Authorization.

Замените {api_key} вашим ключом, а адрес из примера — вашим адресом получателя:

curl -i "https://api.blockvectra.com/v1/faucet/robinhood_testnet" \
  -H "Content-Type: application/json" \
  -H "x-api-key: {api_key}" \
  -d '{"address":"0x1111111111111111111111111111111111111111"}'

Тело JSON содержит только address и не должно превышать 64 КиБ. Неизвестные поля или некорректный JSON возвращают 400 invalid_request. Используйте точный эндпоинт без параметров запроса.

Окно получения и лимиты

Каждый принятый запрос отправляет 0.001 test ETH (1000000000000000 wei).
Каждый аккаунт и каждый адрес получателя могут совершать один новый запрос за скользящее 24-часовое окно. Использование другого ключа того же аккаунта не увеличивает лимит.
Кран принимает не более 1,000 новых запросов за сутки UTC суммарно от всех пользователей.
Запросы разделяют общий лимит 5 запросов в секунду на ключ с /v1/account.

next_eligible_at — это время принятия запроса плюс 24 часа, выраженное в виде временной метки UTC по стандарту RFC 3339. Окна аккаунта и адреса не сбрасываются в полночь по UTC. Ошибка 429 из-за лимита получения содержит error.data.scope (account, address или global) и error.data.next_eligible_at; для global метка времени соответствует началу следующих суток UTC. Ошибка 429 из-за частоты запросов не содержит поля scope.

«Принято» не означает «подтверждено»

HTTP 202 означает, что запрос принят, а не успешно включен в блок ончейн. Ответ JSON содержит:

Поле	Значение
`chain` / `chain_id`	`robinhood_testnet` / `46630`
`address`	Адрес получателя в нижнем регистре
`amount_wei`	Сумма получения в виде строки десятичного целого числа
`tx_hash`	Стабильный хэш принятой транзакции
`next_eligible_at`	Время следующей доступности для скользящего окна

Повторная отправка запроса для того же нормализованного адреса с того же аккаунта в течение 24 часов возвращает исходный ответ 202 и тот же tx_hash, в том числе при использовании другого действующего ключа этого аккаунта. Это не приводит к повторной отправке средств. Если ответ был утерян, повторите запрос с тем же адресом для того же аккаунта.

Проверьте транзакцию через существующий эндпоинт RPC testnet. Замените {tx_hash} хэшем из принятого ответа; этот запрос RPC тарифицируется в обычном порядке по CU:

curl -s "https://api.blockvectra.com/v1/robinhood_testnet" \
  -H "Content-Type: application/json" \
  -H "x-api-key: {api_key}" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getTransactionReceipt","params":["{tx_hash}"]}'

Ошибки и повторные попытки

Оболочка ошибки содержит error.code, error.message и error.data. error.data.reason совпадает с error.code; поля docs_url, retryable и request_id содержат ссылку на документацию ошибки, политику повторных попыток и идентификатор запроса. При любых кодах 429 или 503 подождите количество секунд, указанное в заголовке ответа Retry-After, прежде чем повторять попытку. Без принятого ответа не следует считать, что тестовый ETH был отправлен.

HTTP	Код ошибки	Что делать
400	`invalid_address`	Исправьте формат адреса или контрольную сумму EIP-55; поле ошибки `error.data.field` равно `/address`.
400	`invalid_request`	Отправьте корректный JSON, содержащий только поле `address`.
401	`missing_api_key` / `invalid_api_key`	Передайте действующий ключ в заголовке `x-api-key`.
403	`key_expired`	Создайте новый API key.
404	`not_found`	Проверьте путь, сеть, метод POST и отсутствие параметров запроса; кран может быть недоступен.
413	`request_too_large`	Уменьшите размер тела запроса, чтобы он укладывался в 64 КиБ.
429	`rate_limited`	Подождите указанное в `Retry-After` время; проверьте значения `scope` и `next_eligible_at`, если они присутствуют.
503	`faucet_empty`	На балансе крана недостаточно средств для отправки запрошенной суммы и покрытия комиссии. Подождите `Retry-After`.
503	`service_unavailable`	Обработка запросов на получение средств временно недоступна, либо по предыдущему запросу еще не получена квитанция. Подождите `Retry-After`.
503	`auth_unavailable` / `upstream_unavailable`	Подождите `Retry-After`, затем повторите попытку.

См. справочник по ошибкам или /errors.json для машиночитаемых указаний, а также руководство по Robinhood Chain для доступа к RPC.

Перейдите к руководству для начинающих по RPC Robinhood Chain Testnet для чтения без ключа и потоковой передачи логов по WebSocket. Найдите публичный RPC URL и поддерживаемые методы на странице сети testnet.