Кран Robinhood Chain testnet

Отримуйте тестовий ETH за допомогою власного API ключа: вимоги до акаунта, ліміти запитів, прийняті транзакції та обробка помилок.

Використовуйте кран для отримання тестового ETH для транзакцій у Robinhood Chain testnet (robinhood_testnet, chain ID 46630). Отримання безкоштовне і не споживає CU; наступні виклики RPC у testnet тарифікуються звичайним чином у CU.

Перший крок: Надішліть запит на отримання із власним API ключем та адресою отримувача, використовуючи приклад curl нижче.
Готово, коли: HTTP 202 та tx_hash підтвердять прийняття; використайте запит квитанції транзакції нижче, щоб перевірити включення в блок перед тим, як вважати отримання підтвердженим.

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

Перед отриманням

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

Використовуйте 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 KiB. Невідомі поля або недійсний JSON повертають 400 invalid_request. Використовуйте точний ендпоінт без параметрів запиту.

Вікно та ліміти отримання

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

next_eligible_at — це час прийняття плюс 24 години, виражений як мітка часу RFC 3339 UTC. Вікна для акаунта та адреси не скидаються опівночі 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, навіть у разі використання іншого дійсного ключа цього акаунта. Це не надсилає додатковий платіж. Якщо відповідь було втрачено, повторіть спробу для тієї самої адреси з тим самим акаунтом.

Перевірте транзакцію за допомогою наявного ендпоінта testnet RPC. Замініть {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 ключ.
404	`not_found`	Перевірте шлях, мережу, метод POST та відсутність параметрів запиту; кран може бути недоступний.
413	`request_too_large`	Зменшіть розмір тіла запиту, щоб він був у межах 64 KiB.
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.

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