Faucet testnet Robinhood Chain

Klaim test ETH dengan API key Anda sendiri: persyaratan akun, batas klaim, transaksi yang diterima, dan penanganan error.

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 atau ikuti panduan pendaftaran terprogram.

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:

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:

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 atau /errors.json untuk panduan yang dapat dibaca mesin, dan panduan Robinhood Chain untuk akses RPC.

Lanjutkan dengan panduan awal RPC Testnet Robinhood Chain untuk pembacaan tanpa kunci dan log WebSocket. Temukan URL RPC publik dan metode yang didukung di halaman rantai testnet.