JSON-RPC

概述

所有请求按 计算单位（CU） 计量，并按 key 进行限流。

• 入口：POST /v1/{chain}/{api_key}（key 放在路径中）或 POST /v1/{chain}（key 放在请求头中）。Robinhood Chain 的 {chain} 是 robinhood_mainnet：https://api.blockvectra.com/v1/robinhood_mainnet。同一个 API key 可用于所有已支持的链
• 协议：HTTP POST，单个调用或批量
• 计量：请求到达时，其全部 CU 开销立即计入该 key 的突发容量；每个被受理并得到应答的调用按该方法公布的 CU 权重计费，不计费的情况见错误参考。按小时账期结算扣费（向下取整为整单位，余数结转下一期，账期结束约 15 分钟后执行）
• 以太坊：有自己的方法清单，状态窗口以 state_window_blocks 为准，见支持的链 → 以太坊。

关于全部方法的完整参数 schema、方法签名与交互式测试，请参阅完整参考。关于路径版本、向后兼容规则与对接建议，请参阅 API 版本与兼容性。

获取 API key 与发出第一个请求见快速上手，其中也说明了 key 的传递方式与批量请求。

常用调用示例

常用调用的完整示例。

日志查询（eth_getLogs）

按合约地址和 topic 过滤最近一段区块的日志——这里以 ERC-20 的 Transfer 事件（topic 为 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef）为例。eth_getLogs 的当前 CU 权重见下方CU 计量规则表；区块跨度超过该链 max_logs_block_range（取自 GET /v1/chains）的请求会被拒绝并返回 -32602。

export BLOCKVECTRA_API_KEY=rgw_your_api_key

curl -X POST "https://api.blockvectra.com/v1/robinhood_mainnet" \
  -H 'Content-Type: application/json' \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [{
      "fromBlock": "0x45a2409",
      "toBlock": "0x45a2609",
      "address": "0x1111111111111111111111111111111111111111",
      "topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"]
    }],
    "id": 1
  }'

交易 Trace（debug_traceTransaction）

用 callTracer 追踪一笔交易的内部调用。debug_traceTransaction 的当前 CU 权重见下方CU 计量规则表。和其他读状态的方法一样，目标区块若超出该链的近期状态窗口就会被拒绝（-32011）。窗口大小为该链的 state_window_blocks（取自 GET /v1/chains）。在提供 trace 的链上，历史 trace 请使用 Data API。

export BLOCKVECTRA_API_KEY=rgw_your_api_key

curl -X POST "https://api.blockvectra.com/v1/robinhood_mainnet" \
  -H 'Content-Type: application/json' \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "debug_traceTransaction",
    "params": ["0xYOUR_TRANSACTION_HASH", {"tracer": "callTracer"}],
    "id": 1
  }'

CU 计量规则

方法策略

可用方法因链而异，下面按链分别列出，其他说明见支持的链。只有匹配允许的方法名或模式的方法才可调用，其他方法返回 -32601 method not available。

限制：

• 批量：每个请求最多 100 个调用；同时受该 key 的 CU 突发容量限制，见下文。
• 请求体：最大 2 MiB（见完整 OpenAPI 参考中的“10. Limits at a glance”）
• CU 突发：每个 API key 均有 CU 令牌桶（cu_per_sec 补充速率、burst_cu 突发容量——默认 100 CU/s、突发 400 CU；付费充值后每个 key 至少 2,000 CU/s、突发 10,000 CU，更高的自定义限额保持不变；在控制台 Keys 表按 key 显示）。单个请求（包括整批 JSON-RPC 批量调用）的 CU 总开销若超过该 key 的突发容量，会被拒绝并返回 -32022 request_exceeds_burst（request cost <N> CU exceeds burst capacity <M> CU）；请拆分为更小的批次。

错误码表

全部错误码、是否计费与处理方式见错误参考。

完整 OpenAPI 参考

完整的机器可读规范（含所有方法签名、请求与响应 schema 及交互式参数详情）见完整 OpenAPI 参考。