Robinhood Chain 测试网水龙头与 RPC:领取测试 ETH,再连接测试网
用自己的 API key 领取 Robinhood Chain 测试网 ETH(每次 0.001)。测试网链 ID 46630,免 key RPC 地址 https://api.blockvectra.com/v1/robinhood_testnet/public;含领取限额与错误处理。
领取 Robinhood Chain 测试网 ETH:用自己的 API key 放在 x-api-key,把收款地址放进 JSON 正文,向 POST https://api.blockvectra.com/v1/faucet/robinhood_testnet 发请求;每次受理发放 0.001 测试 ETH,每个账户、每个收款地址在滚动 24 小时内各限一次。测试网 RPC 地址是 https://api.blockvectra.com/v1/robinhood_testnet/public(链 ID 46630),免 key,每 IP 每秒 3 次请求;领取被受理后可用它确认到账。核对于 。
通过水龙头获取 Robinhood Chain 测试网(robinhood_testnet,chain ID 46630)交易所需的测试 ETH。领取免费、不扣 CU。后续 RPC 调用中,免密钥公共端点仅支持 GET /v1/chains 中该链 public.methods 列出的方法;使用 API key 认证的调用正常计 CU。
- 第一步:使用自己的 API key 与收款地址,按下方 curl 示例发起领取。
- 完成标准:HTTP
202与tx_hash表示领取已受理;仍需按下方交易回执查询确认上链,才能视为已确认。
领取前准备
注册 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。使用上述完整端点,不添加查询参数(见完整 OpenAPI 参考中的POST /v1/faucet/robinhood_testnet)。
领取窗口与限额
- 每次受理发放 0.001 test ETH(
1000000000000000wei)。 - 每账户和每收款地址各滚动 24 小时最多受理一次新领取。更换同一账户的 key 不会增加额度。
- 所有用户合计,每 UTC 日最多受理 1,000 次新领取。
- 请求与
/v1/account共用每 key 每秒 5 次的频率限制(见完整 OpenAPI 参考中的POST /v1/faucet/robinhood_testnet)。
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}"]}'判断回执结果
检查 JSON-RPC 正文:仅有 HTTP 200 不能证明已获取回执或付款成功。
| 响应 | 判断与操作 |
|---|---|
error | 查询错误。按现有重试策略与错误参考处理,不算领取成功。 |
result: null | 未确认。没有返回回执,不能据此判断成功或失败。核对 tx_hash 与 robinhood_testnet,再对同一查询退避重试,并设置最大查询次数或截止时间。 |
result.status = 0x1, blockHash != null, blockNumber != null | 执行成功。已纳入区块且执行成功,但不等于 Ethereum 最终确定性。 |
result.status = 0x0 | 执行失败。已纳入区块但执行失败,不能算已收到测试 ETH。 |
| 其它值或缺少字段 | 未确认。缺少状态、区块信息或返回非预期值,都不能判为成功。 |
等待中或超时后仍是未确认;保留原 tx_hash,不要更换账户或 key 再领,也不要绕过限额。
参见 Ethereum 回执字段与 Robinhood 确认层级。
错误与重试
错误信封包含 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 以内(见完整 OpenAPI 参考中的POST /v1/faucet/robinhood_testnet)。 |
| 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 logs。公开 RPC URL 与支持方法见测试网链页。
最后更新: