Faucet testnet của Robinhood Chain

Nhận test ETH bằng API key của riêng bạn: yêu cầu tài khoản, giới hạn nhận, giao dịch được chấp nhận và xử lý lỗi.

Sử dụng faucet để nhận test ETH cho các giao dịch trên testnet của Robinhood Chain (robinhood_testnet, Chain ID 46630). Việc nhận faucet là miễn phí và không tiêu tốn CU; các lệnh gọi RPC testnet tiếp theo sẽ tính phí CU như bình thường.

Trước khi nhận faucet

Đăng ký tài khoản BlockVectra và sử dụng một trong các API key của riêng bạn. Tạo key trong console hoặc làm theo hướng dẫn đăng ký theo chương trình.

Sử dụng 0x theo sau bởi 40 ký tự thập lục phân, viết thường hoặc chữ hoa chữ thường kết hợp với checksum EIP-55 hợp lệ. Phản hồi sử dụng địa chỉ chữ thường; các cách viết khác nhau của cùng một địa chỉ chia sẻ cùng một giới hạn nhận.

Gửi yêu cầu nhận

Gọi POST https://api.blockvectra.com/v1/faucet/robinhood_testnet với Content-Type: application/json và key của bạn trong x-api-key. Endpoint này không đọc key từ đường dẫn URL hoặc Authorization.

Thay thế {api_key} bằng key của bạn và địa chỉ ví dụ bằng địa chỉ người nhận của bạn:

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

Nội dung JSON chỉ chứa address và phải vừa trong giới hạn 64 KiB. Các trường không xác định hoặc JSON không hợp lệ sẽ trả về 400 invalid_request. Sử dụng chính xác endpoint mà không có tham số truy vấn.

Cửa sổ và giới hạn nhận

Mỗi yêu cầu được chấp nhận sẽ gửi 0.001 test ETH (1000000000000000 wei).
Mỗi tài khoản và mỗi địa chỉ người nhận có thể có một lần nhận mới trong mỗi khoảng thời gian 24 giờ cuốn chiếu. Sử dụng một key khác trên cùng một tài khoản sẽ không làm tăng giới hạn.
Faucet chấp nhận tối đa 1,000 lần nhận mới mỗi ngày UTC trên tất cả người dùng.
Các yêu cầu chia sẻ giới hạn 5 yêu cầu mỗi giây trên mỗi key với /v1/account.

next_eligible_at là thời điểm chấp nhận cộng thêm 24 giờ, được biểu thị dưới dạng timestamp UTC RFC 3339. Khoảng thời gian của tài khoản và địa chỉ không đặt lại vào nửa đêm UTC. Lỗi 429 do giới hạn nhận bao gồm error.data.scope (account, address, hoặc global) và error.data.next_eligible_at; đối với global, timestamp là thời điểm bắt đầu của ngày UTC tiếp theo. Lỗi 429 do tần suất yêu cầu không có scope.

Được chấp nhận không đồng nghĩa với đã xác nhận

HTTP 202 có nghĩa là đã được chấp nhận, không phải là đã được đưa lên chuỗi thành công. Phản hồi JSON chứa:

Trường	Ý nghĩa
`chain` / `chain_id`	`robinhood_testnet` / `46630`
`address`	Địa chỉ người nhận dạng chữ thường
`amount_wei`	Số tiền nhận dưới dạng chuỗi số nguyên thập phân
`tx_hash`	Hash ổn định của giao dịch được chấp nhận
`next_eligible_at`	Thời điểm hợp lệ tiếp theo cho khoảng thời gian cuốn chiếu

Việc thử lại cùng một địa chỉ đã chuẩn hóa từ cùng một tài khoản trong vòng 24 giờ sẽ trả về phản hồi 202 ban đầu và cùng một tx_hash, bao gồm cả khi sử dụng một key hợp lệ khác từ tài khoản đó. Nó không gửi một khoản thanh toán khác. Nếu một phản hồi bị mất, hãy thử lại cùng địa chỉ đó với cùng tài khoản đó.

Kiểm tra giao dịch bằng endpoint RPC testnet hiện có. Thay thế {tx_hash} bằng hash từ phản hồi được chấp nhận; truy vấn RPC này sử dụng cách tính phí CU thông thường:

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

Lỗi và thử lại

Khung phản hồi lỗi chứa error.code, error.message, và error.data. error.data.reason bằng với error.code; docs_url, retryable, và request_id cung cấp tài liệu tham khảo lỗi, chính sách thử lại và mã định danh yêu cầu. Đối với mỗi lỗi 429 hoặc 503, hãy chờ số giây trong header phản hồi Retry-After trước khi thử lại. Khi chưa có phản hồi được chấp nhận, đừng cho rằng test ETH đã được gửi.

HTTP	Mã lỗi	Cách xử lý
400	`invalid_address`	Sửa định dạng địa chỉ hoặc checksum EIP-55; `error.data.field` là `/address`.
400	`invalid_request`	Gửi JSON hợp lệ chỉ chứa `address`.
401	`missing_api_key` / `invalid_api_key`	Cung cấp key hợp lệ trong `x-api-key`.
403	`key_expired`	Tạo một API key mới.
404	`not_found`	Kiểm tra đường dẫn, chuỗi, phương thức POST, và đảm bảo không có tham số truy vấn; faucet có thể không khả dụng.
413	`request_too_large`	Giảm kích thước thân yêu cầu để nằm trong giới hạn 64 KiB.
429	`rate_limited`	Chờ theo `Retry-After`; kiểm tra `scope` và `next_eligible_at` khi có mặt.
503	`faucet_empty`	Faucet không đủ tiền để thực hiện yêu cầu nhận và trả phí gas. Chờ theo `Retry-After`.
503	`service_unavailable`	Việc xử lý nhận faucet tạm thời không khả dụng, hoặc một yêu cầu nhận trước đó chưa có biên lai. Chờ theo `Retry-After`.
503	`auth_unavailable` / `upstream_unavailable`	Chờ theo `Retry-After`, sau đó thử lại.

Xem tài liệu tham khảo lỗi hoặc /errors.json để biết hướng dẫn mà máy đọc được, và hướng dẫn Robinhood Chain để truy cập RPC.

Tiếp tục với Robinhood Chain Testnet RPC starter cho các truy vấn đọc không cần key và log WebSocket. Tìm URL RPC công khai và các phương thức được hỗ trợ trên trang chuỗi testnet.