JSON-RPC

概述复制锚点链接

Robinhood Chain 使用 JSON-RPC 2.0 网关（rpc-gateway）提供付费 API 访问。所有请求按 计算单位（CU） 计量，并按 key 进行限流。

• 入口：/v1/（nginx）→ 网关（直连）或通过 POST /v1/{api_key}
• 协议：HTTP POST，单个调用或批量（最多 100 个调用）
• 计量：请求到达时，按整个请求的 CU 开销从该 key 的限流令牌桶预扣；账户 CU 余额的实际计费只在网关收到节点应答之后才发生，按小时结算
• 可用性：匹配 eth_*、net_*、web3_*、debug_trace* 的方法（除了部分例外；见下文）

完整规范请见完整参考，含端点详情和真实示例。

接入方式复制锚点链接

1. 申请 API Key复制锚点链接

参考快速上手 → 申请 API Key。

2. 调用 JSON-RPC复制锚点链接

curl -X POST https://dev-api.blockvectra.network/v1/YOUR_API_KEY \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 1
  }'

Key 传递方式（优先级顺序）：

• URL 路径：POST /v1/{api_key}
• 请求头：x-api-key: {api_key}（如果非空，覆盖 Bearer）
• 请求头：Authorization: Bearer {api_key}

3. 处理 CU 成本复制锚点链接

每个方法都有对应的 CU（计算单位）权重，请求的成本是其包含的所有调用权重之和。各方法权重、缓存命中值与默认值见下方 CU 权重表；具体哪些错误会计费见错误码表的「是否计费」列。

CU 计量规则复制锚点链接

方法策略复制锚点链接

只有匹配允许模式的方法才可调用；其中一部分方法即使匹配了允许模式，仍会被显式拦截（返回 -32601 method not available）。

限制：

• 批量：每个请求最多 100 个调用
• 请求体：最大 2 MiB
• CU 突发：单个请求的 CU 开销不能超过该 key 的桶容量（request cost <N> CU exceeds burst capacity <M> CU）

错误码表复制锚点链接

完整规范复制锚点链接

查看完整 JSON-RPC 参考了解所有路径、请求/响应模式和真实示例。