Robinhood Chain 測試網水龍頭

使用自己的 API key 領取測試 ETH：帳戶要求、領取限額、交易受理狀態與錯誤處理。

透過水龍頭取得 Robinhood Chain 測試網（robinhood_testnet，chain ID 46630）交易所需的測試 ETH。領取免費、不扣 CU；後續測試網 RPC 呼叫正常計 CU。

領取前準備

註冊 BlockVectra 帳戶，並使用你自己的 API key。可在控制台建立 key，或參考程式化註冊指南。

地址格式為 0x 加 40 位十六進位字元，使用小寫或符合 EIP-55 校驗和的混合大小寫。回應中的地址統一小寫，同一地址的不同寫法共用領取限額。

發起領取

呼叫 POST https://api.blockvectra.com/v1/faucet/robinhood_testnet，攜帶 Content-Type: application/json 和 x-api-key。此端點不讀取 URL 路徑或 Authorization 中的 key。

將 {api_key} 替換為你的 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 小時最多受理一次新領取。更換同一帳戶的 key 不會增加額度。
所有使用者合計，每 UTC 日最多受理 1,000 次新領取。
請求與 /v1/account 共用每 key 每秒 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，更換該帳戶的另一把有效 key 也一樣，不會再次發幣。回應遺失時，使用同一帳戶對同一地址重試。

透過現有測試網 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`	發送只含 `address` 的有效 JSON。
401	`missing_api_key` / `invalid_api_key`	在 `x-api-key` 中提供有效 key。
403	`key_expired`	建立新的 API key。
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；RPC 接入方式見 Robinhood Chain 指南。

接著參考 Robinhood Chain 測試網 RPC 入門指南進行免 key 讀取並訂閱 WebSocket 日誌。公開 RPC URL 與支援方法見測試網鏈頁面。