JSON-RPC

OverviewCopy Anchor Link

Robinhood Chain uses a JSON-RPC 2.0 gateway (rpc-gateway) for paid API access. All requests are metered in Computation Units (CU) and rate-limited per key.

• Endpoint: /v1/ (nginx) → network gateway (direct) or via POST /v1/{api_key}
• Protocol: HTTP POST, single call or batch (max 100 calls)
• Metering: The request's total CU cost is pre-deducted from the key's rate-limit bucket on arrival; billing against the account's CU balance only happens after the gateway receives the node's response, settled hourly
• Availability: Methods matching eth_*, net_*, web3_*, debug_trace* (with exceptions; see below)

See the full specification for endpoint details and live examples.

IntegrationCopy Anchor Link

1. Get an API KeyCopy Anchor Link

See Quickstart → Get an API key.

2. Call JSON-RPCCopy Anchor Link

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 passing (priority order):

• URL path: POST /v1/{api_key}
• Header: x-api-key: {api_key} (overrides Bearer if non-empty)
• Header: Authorization: Bearer {api_key}

3. Handle CU CostsCopy Anchor Link

Every method carries a CU (Computation Unit) weight; the cost of a request is the sum of the weights of all calls it contains. See the CU weight table below for per-method weights and the cache-hit/default values, and the Billed column of the error codes table for which error conditions are billed.

CU Metering RulesCopy Anchor Link

Method PolicyCopy Anchor Link

Only methods matching an allowed pattern are reachable; a handful of methods are explicitly blocked even though they match one (they return -32601 method not available).

Limits:

• Batch: max 100 calls per request
• Request body: max 2 MiB
• CU burst: a request's total CU cost must not exceed the key's bucket capacity (request cost <N> CU exceeds burst capacity <M> CU)

Error CodesCopy Anchor Link

Full SpecificationCopy Anchor Link

See the complete JSON-RPC reference for all paths, request/response schemas, and live examples.