# Faucet testnet Robinhood Chain

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

Gunakan faucet untuk memperoleh test ETH untuk transaksi di testnet Robinhood Chain (`robinhood_testnet`, chain ID `46630`). Mengklaim gratis dan tidak mengonsumsi CU; panggilan RPC testnet berikutnya menggunakan penagihan CU normal.

## Sebelum mengklaim

Daftarkan akun BlockVectra dan gunakan salah satu API key Anda sendiri. Buat kunci di [konsol](https://console.blockvectra.com/login/?next=%2Fkeys%2F) atau ikuti [panduan pendaftaran terprogram](https://docs.blockvectra.com/en/guides/programmatic-signup/).

Gunakan `0x` diikuti oleh 40 karakter heksadesimal, baik huruf kecil maupun huruf campuran dengan checksum EIP-55 yang valid. Respons menggunakan alamat huruf kecil; ejaan yang berbeda dari alamat yang sama berbagi batas klaim yang sama.

## Kirim klaim

Panggil `POST https://api.blockvectra.com/v1/faucet/robinhood_testnet` dengan `Content-Type: application/json` dan kunci Anda di `x-api-key`. Endpoint ini tidak membaca kunci dari jalur URL atau `Authorization`.

Ganti `{api_key}` dengan kunci Anda dan alamat contoh dengan alamat penerima Anda:

```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"}'
```

Body JSON hanya berisi `address` dan harus berukuran di bawah 64 KiB. Bidang yang tidak dikenal atau JSON yang tidak valid mengembalikan `400 invalid_request`. Gunakan endpoint persis tanpa parameter kueri.

## Jendela klaim dan batas

* Setiap klaim yang diterima mengirimkan **0.001 test ETH** (`1000000000000000` wei).
* Setiap akun dan setiap alamat penerima dapat memiliki **satu klaim baru per jendela 24 jam bergulir**. Menggunakan kunci lain pada akun yang sama tidak meningkatkan batas.
* Faucet menerima paling banyak **1.000 klaim baru per hari UTC** di seluruh pengguna.
* Permintaan berbagi batas **5 permintaan per detik per kunci** dengan `/v1/account`.

`next_eligible_at` adalah waktu penerimaan ditambah 24 jam, dinyatakan sebagai timestamp UTC RFC 3339. Jendela akun dan alamat tidak direset pada tengah malam UTC. `429` batas klaim menyertakan `error.data.scope` (`account`, `address`, atau `global`) dan `error.data.next_eligible_at`; untuk `global`, timestamp adalah awal hari UTC berikutnya. `429` frekuensi permintaan tidak memiliki `scope`.

## Diterima bukan berarti terkonfirmasi

HTTP **202 berarti diterima, bukan berarti berhasil dimasukkan ke dalam rantai (on-chain)**. Respons JSON berisi:

| Bidang               | Arti                                              |
| -------------------- | ------------------------------------------------- |
| `chain` / `chain_id` | `robinhood_testnet` / `46630`                     |
| `address`            | Alamat penerima huruf kecil                       |
| `amount_wei`         | Jumlah klaim sebagai string desimal integer       |
| `tx_hash`            | Hash stabil dari transaksi yang diterima          |
| `next_eligible_at`   | Waktu kelayakan berikutnya untuk jendela bergulir |

Mencoba kembali alamat ternormalisasi yang sama dari akun yang sama dalam waktu 24 jam akan mengembalikan respons `202` asli dan `tx_hash` yang sama, termasuk saat menggunakan kunci valid lainnya dari akun tersebut. Ini tidak mengirimkan pembayaran baru. Jika respons hilang, coba lagi alamat yang sama dengan akun yang sama.

Periksa transaksi menggunakan endpoint RPC testnet yang ada. Ganti `{tx_hash}` dengan hash dari respons yang diterima; kueri RPC ini menggunakan penagihan CU normal:

```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 dan percobaan ulang

Struktur error berisi `error.code`, `error.message`, dan `error.data`. `error.data.reason` sama dengan `error.code`; `docs_url`, `retryable`, dan `request_id` menyediakan referensi error, kebijakan percobaan ulang, dan pengidentifikasi permintaan. Untuk setiap `429` atau `503`, tunggu selama jumlah detik dalam header respons **`Retry-After`** sebelum mencoba lagi. Tanpa respons yang diterima, jangan berasumsi bahwa test ETH telah dikirim.

| HTTP | Kode error                                  | Yang harus dilakukan                                                                                        |
| ---- | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| 400  | `invalid_address`                           | Perbaiki format alamat atau checksum EIP-55; `error.data.field` adalah `/address`.                          |
| 400  | `invalid_request`                           | Kirim JSON valid yang hanya berisi `address`.                                                               |
| 401  | `missing_api_key` / `invalid_api_key`       | Berikan kunci yang valid di `x-api-key`.                                                                    |
| 403  | `key_expired`                               | Buat API key baru.                                                                                          |
| 404  | `not_found`                                 | Periksa jalur, rantai, metode POST, dan ketiadaan parameter kueri; faucet mungkin tidak tersedia.           |
| 413  | `request_too_large`                         | Kurangi body agar muat dalam 64 KiB.                                                                        |
| 429  | `rate_limited`                              | Tunggu `Retry-After`; periksa `scope` dan `next_eligible_at` jika ada.                                      |
| 503  | `faucet_empty`                              | Faucet tidak memiliki dana yang cukup untuk klaim dan biaya gas. Tunggu `Retry-After`.                      |
| 503  | `service_unavailable`                       | Pemrosesan klaim sementara tidak tersedia, atau klaim sebelumnya belum memiliki resi. Tunggu `Retry-After`. |
| 503  | `auth_unavailable` / `upstream_unavailable` | Tunggu `Retry-After`, lalu coba lagi.                                                                       |

Lihat [referensi error](https://docs.blockvectra.com/en/errors/) atau [/errors.json](https://docs.blockvectra.com/errors.json) untuk panduan yang dapat dibaca mesin, dan [panduan Robinhood Chain](https://docs.blockvectra.com/en/guides/robinhood-chain/) untuk akses RPC.

Lanjutkan dengan [panduan awal RPC Testnet Robinhood Chain](https://docs.blockvectra.com/en/guides/robinhood-testnet-starter/) untuk pembacaan tanpa kunci dan log WebSocket. Temukan URL RPC publik dan metode yang didukung di [halaman rantai testnet](https://blockvectra.com/en/chains/robinhood_testnet/).