Robinhood Chain 测试网水龙头

使用 API key 领取测试 ETH：主网地址资格、领取限额、交易受理状态与错误处理。

通过水龙头获取 Robinhood Chain 测试网（robinhood_testnet，chain ID 46630）交易所需的测试 ETH。领取免费、不扣 CU；后续测试网 RPC 调用正常计 CU。

领取前准备

需要有效的 BlockVectra API key。可在控制台创建，或按程序化开户指南获取。

收款地址在 robinhood_mainnet 上的余额或 nonce 必须大于 0。两者均为 0 的地址，包括没有主网余额且未发送过主网交易的新钱包，会收到 HTTP 403、错误码 not_eligible。资格无法查询时，请求以临时服务错误拒绝受理，这不表示地址无资格。

地址格式为 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.01 test ETH（10000000000000000 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。
403	`not_eligible`	待地址的主网余额或 nonce 大于 0 后重新申请。
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 指南。