# Кран Robinhood Chain testnet

> Source: https://docs.blockvectra.com/uk/guides/robinhood-testnet-faucet/

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

* **Перший крок:** [Надішліть запит на отримання](#send-a-claim) із власним API ключем та адресою отримувача, використовуючи приклад curl нижче.
* **Готово, коли:** HTTP `202` та `tx_hash` підтвердять прийняття; використайте запит квитанції транзакції нижче, щоб перевірити включення в блок перед тим, як вважати отримання підтвердженим.

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

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

Зареєструйте акаунт BlockVectra та використовуйте один зі своїх API ключів. Створіть ключ у [консолі](https://console.blockvectra.com/login/?next=%2Fkeys%2F) або виконайте інструкції з [посібника з програмної реєстрації](https://docs.blockvectra.com/en/guides/programmatic-signup/).

Використовуйте `0x`, за яким слідують 40 шістнадцяткових символів у нижньому регістрі або у змішаному регістрі з валідною контрольною сумою EIP-55. Відповіді містять адреси в нижньому регістрі; різні варіанти написання однієї й тієї самої адреси мають спільний ліміт отримання.

## Відправка запиту на отримання

Викличте `POST https://api.blockvectra.com/v1/faucet/robinhood_testnet` із `Content-Type: application/json` та вашим ключем у `x-api-key`. Цей ендпоінт не читає ключ зі шляху URL або `Authorization`.

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

```bash
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 звичайним чином:

```bash
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`, потім повторіть спробу.                                                             |

Див. [довідник помилок](https://docs.blockvectra.com/en/errors/) або [/errors.json](https://docs.blockvectra.com/errors.json) для машиночитних інструкцій та [посібник з Robinhood Chain](https://docs.blockvectra.com/en/guides/robinhood-chain/) для доступу до RPC.

Продовжте зі [стартовим посібником Robinhood Chain Testnet RPC](https://docs.blockvectra.com/en/guides/robinhood-testnet-starter/) для читань без ключа та журналів WebSocket. Знайдіть публічний RPC URL та підтримувані методи на [сторінці мережі testnet](https://blockvectra.com/en/chains/robinhood_testnet/).