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(1000000000000000 wei)。
  • 每账户和每收款地址各滚动 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_idrobinhood_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错误码处理方式
400invalid_address修正地址格式或 EIP-55 校验和;error.data.field 为 /address。
400invalid_request发送只含 address 的有效 JSON。
401missing_api_key / invalid_api_key在 x-api-key 中提供有效 key。
403key_expired创建新的 API key。
404not_found检查路径、链、POST 方法和是否没有查询参数;水龙头也可能暂不可用。
413request_too_large将请求体减小至 64 KiB 以内(见完整 OpenAPI 参考中的POST /v1/faucet/robinhood_testnet)。
429rate_limited按 Retry-After 等待;如有 scope 和 next_eligible_at,据此确认受限范围与下次领取时刻。
503faucet_empty水龙头余额不足以支付领取金额和手续费,按 Retry-After 等待。
503service_unavailable领取处理暂不可用,或上一笔领取尚无回执,按 Retry-After 等待。
503auth_unavailable / upstream_unavailable按 Retry-After 等待后重试。

详见错误参考或机器可读的 /errors.json;RPC 接入方式见 Robinhood Chain 指南。

接着按 Robinhood Chain 测试网 RPC 入门指南免 key 读数据并订阅 WebSocket logs。公开 RPC URL 与支持方法见测试网链页。

最后更新:

本页目录