如何选择 RPC 服务商

按完成实际任务的费用与可靠性选择 RPC 服务商:先用 GET /v1/chains 核对方法单价、日志区块跨度与链覆盖,再通过有界自测记录成功调用、重试数与计费错误,确认是否满足任务。

按完成实际任务的费用与可靠性选择 RPC 服务商:先确认链、方法与历史覆盖,再测查询次数、吞吐与恢复能力。

列出应用或 AI Agent 需要的链、方法、固定块高、每日流量分布、峰值并发以及通知或数据集依赖。下方 BlockVectra 公开数据来自 GET /v1/plans 与 GET /v1/chains,做决定前应重新查询。数据覆盖来自 GET /v1/status。接口声明是测试起点,不是延迟测量或 SLA。

可按任务评估 BlockVectra:受支持的合约读取采用按方法计量的用量计费;HyperEVM 日志回填每次认证请求最多覆盖 1,000 块;多链地址通知可使用一个自助订阅和一个 HTTPS 接收端。合约读取按下方方法表的当前 eth_call 权重计费,Push 地址天数与投递事件采用独立费率。按任务选择合约读取计价、HyperEVM 日志回填或地址通知与容量流程。价格与限额已于 2026-10-09 对照 plans 与 chains 核实;通过当前接口确认覆盖,再按所需块高、完整结果和恢复路径执行对应自测。

方法单价与计费单位

仅有请求数不能为任务定价。记录每个方法的计费权重、美元换算、包含额度、超额价以及订阅或附加服务费。credits、CU 与请求单位都需按各自规则换算后才能跨服务商比较。

BlockVectra 当前方法权重与标价在构建页面时从公开 plans 接口读取:

当前换算基准参数

1 USD = 10,000 计费单位,1 计费单位 = 1,000 CU(即 1 USD = 10,000,000 CU)。

换算公式:单次调用 CU 权重 × 1,000,000 ÷ (10,000 × 1,000) 美元。

方法单次调用 CU每百万次调用价格(USD)
eth_blockNumber1$0.10
eth_call15$1.50
eth_getLogs30$3.00
debug_traceTransaction100$10.00
data.block5$0.50

Push 自助档每个订阅最多 1,000,000 个地址。每订阅 10,000,000 / 100,000,000 个地址的更高容量, 请联系我们开通.

BlockVectra 任务费用与请求速率 免费账户新 key 默认预算:100 CU/s。

方法算例调用数单次调用 CU任务费用(USD)key CU 预算换算请求/秒
eth_call1,000,00015$1.506
eth_getLogs100,00030$0.303

任务费用为未扣免费额度的标价,不含 gas 与附加服务。速率按 key_defaults.cu_per_sec ÷ 方法 CU 计算,假设该 key 只调用这一方法。免费账户上限与其他流量可能降低可用速率;换算值不是实测吞吐。

当前权重、价格与 key 限额:GET /v1/plans。

workload_cu = sum(calls_for_method × current_method_cu_weight)
cu_per_usd = pricing.units_per_usd × pricing.cu_per_unit
list_cost_usd = workload_cu / cu_per_usd
paid_compute_usd = max(0, workload_cu − available_free_cu) / cu_per_usd

标价不含免费额度、gas、附加服务与迁移工作。区分周期补充额度与到期试用,也要区分额外 credit 单价与包含请求的平均费用。哪些响应消耗 CU,见计费规则。

如何自测: 固定块高,回放少量有代表性的方法组合,记录成功调用、重试与计费错误。将账户用量变化与方法权重计算对照。按取得完整结果所需的请求数预算,包含分页与回填。换算详见 CU 计价教程。

日志范围与历史状态

对 eth_getLogs,核对具体链与套餐的区块跨度、结果大小限制及过滤条件支持。只有响应完整,大跨度才有意义。BlockVectra 认证调用的跨度来自链目录:

链链标识max_logs_block_range(区块数)
Arbitrum Onearb_mainnet1,000
Arcarc_mainnet1,000
Avalanche C-Chainavax_mainnet1,000
Basebase_mainnet1,000
Berachainberachain_mainnet1,000
Bobaboba_mainnet1,000
BNB Smart Chainbsc_mainnet1,000
Celocelo_mainnet1,000
Ethereumeth_mainnet1,000
Ethereum Sepoliaeth_sepolia1,000
Fraxtalfraxtal_mainnet1,000
Gnosisgnosis_mainnet1,000
HyperEVMhyperevm_mainnet1,000
Inkink_mainnet1,000
Katanakatana_mainnet1,000
Linealinea_mainnet1,000
Metal L2metall2_mainnet1,000
Modemode_mainnet1,000
OP Mainnetop_mainnet1,000
Polygonpolygon_mainnet1,000
Robinhood Chainrobinhood_mainnet1,000
Robinhood Chain Testnetrobinhood_testnet1,000
Rootstockrootstock_mainnet1,000
Soneiumsoneium_mainnet1,000
Sonicsonic_mainnet1,000
Unichainunichain_mainnet1,000
World Chainworld_mainnet1,000
X Layerxlayer_mainnet1,000
Zorazora_mainnet1,000

历史日志与历史合约执行是不同能力。eth_call 应读取 state_window_blocks;免 key 读取还要核对 public.history_blocks。字段缺失或为 null 表示未声明,不代表无限历史。参考 EVM 历史状态。

如何自测: 选定已知合约与 topics 的固定区间,按声明跨度拆分,将结果并集与更小的重叠查询比较。按区块哈希、交易哈希与日志索引去重,检查区间边界。另用同一合约查询近期固定块高以及应用所需的最老块高,记录真实结果或 JSON-RPC 错误。分别测试事件密集与稀疏区间,并记录重试数。按日志范围与恢复保存进度。

免费额度、速率与峰值流量

BlockVectra 当前周期预算及可覆盖调用数由 plans 计算:

免费套餐需要注册账户并使用 API key 访问,同一账户下所有 key 共享平均每秒 25 次调用(允许短时突发);每个 30 天周期结束时,余额低于 30,000,000 CU 的补足到 30,000,000 CU。

方法名CU 权重单周期约可调用次数约每天标价每百万次
eth_blockNumber130,000,0001,000,000$0.10
eth_getBlockByNumber56,000,000200,000$0.50
eth_getBalance103,000,000100,000$1.00
eth_call152,000,00066,666$1.50
eth_getLogs301,000,00033,333$3.00
debug_traceTransaction100300,00010,000$10.00
data.block56,000,000200,000$0.50
data.address_balances251,200,00040,000$2.50
data.dex_prices152,000,00066,666$1.50
data.transaction_trace200150,0005,000$20.00

免费账户调用上限:上限 25 次/秒,账户内所有 key、所有链和 Data API 共享。 每个 key 还有 cu_per_sec 与 burst_cu 限额。符合条件的周期补充将免费余额补到目标,不是额外叠加完整额度。首次付费充值后停止周期补充,剩余免费 CU 仍可使用。参考免费计划规则。

每日配额、周期余额、请求/秒、CU/秒、突发容量与并发请求数需分别记录。付费增加用量本身不能证明每 key 吞吐也会增加。

如何自测: 使用认证 key,在账户限额内以任务所需节奏和并发执行少量有界请求。记录 HTTP 状态、JSON-RPC 错误、延迟分位数与完成调用数。额度耗尽时停止;限流时有界退避并持久化进度。用混合方法样本再测一次,因为高权重方法会占用更多 CU/秒预算。比较突发与稳定流量,核对共享账户上限时计入其他 key 的使用量。

公平比较延迟、错误与结果

两端使用同一条链、固定块区间、相同的 address/topics、并发、节奏与超时。不要用 latest 作区间端点:两次运行之间链会前进,两端处理的工作量因此不同。过滤字段定义见 eth_getLogs 文档,区间检查点见日志范围指南。

报告成功请求的 p50 与 p95 延迟时,附上成功样本数。对所有尝试另列超时、HTTP 错误与 JSON-RPC 错误的数量,并写明分母;类别可能交叠,不要按互斥类别求和。失败请求也要记录延迟,不能只报成功延迟。用返回 logs 条数与 response bytes 对齐结果量;条数相同不证明内容完整或链 canonicality。重试计入任务总耗时、请求数与费用。成功与失败延迟、错误率应分开看,参考四个黄金信号。

需要同链的外部参考时,可看这些独立榜单:Ink、Unichain、Fraxtal、Katana、Ethereum、Arbitrum、Boba 与 World Chain。先核对各页的测试方法、采样区域和时间窗;其负载不等于你的应用结果。

在每个 endpoint 上运行同一组有界请求

下载 rpc-benchmark.mjs,逐次只向一个 endpoint 发送同一固定工作负载,并保存一份 JSON 报告供离线比较。使用 Node.js 24 或以上,只依赖内置模块。先检查 eth_chainId,再把同一 eth_getLogs filter 串行发送 repetitions 次。不重试、不跟随重定向、不签名、不广播交易、不自动扫描 provider,也不替你选块。

自行创建 benchmark.json;下面的值仅作示例。文件不能包含 endpoint 或 key。endpoint 通过 RPC_BENCHMARK_URL 设置;若 endpoint 需要 key,通过 BLOCKVECTRA_API_KEY 设置。优先使用把 key 放在 x-api-key 请求头的入口,避免 key 出现在 URL、日志或报告中。

{
  "chainId": "0x1",
  "filter": {
    "fromBlock": "0x1400000",
    "toBlock": "0x1400063",
    "address": "0x1111111111111111111111111111111111111111",
    "topics": []
  },
  "repetitions": 5,
  "intervalMs": 250,
  "timeoutMs": 10000,
  "maxDurationMs": 60000,
  "maxResponseBytes": 1048576,
  "maxTotalBytes": 16777216,
  "region": "eu-west"
}
export RPC_BENCHMARK_URL="https://your-rpc.example/v1/eth_mainnet"
export BLOCKVECTRA_API_KEY="set-your-key-here"
node rpc-benchmark.mjs --config ./benchmark.json > run.json

每个 endpoint 使用相同的 chainId、filter、repetitions、interval 和上限,独立运行,一次一个 endpoint。报告包含 stop_reason、原始 attempts、成功与失败 eth_getLogs 延迟分列(有样本时给出 nearest-rank p50 与 p95),以及不含 endpoint 和 key 的 workload fingerprint。还会记录脚本 SHA-256 与环境变量名,不记录其值。退出码 0 表示所有预定请求均成功完成;运行失败仍写出 JSON 并以 1 退出;配置无效会在任何请求前以 2 退出。

maxResponseBytes、maxTotalBytes 与 maxDurationMs 是应用侧停止阈值,不是网络限制,也不是 CU 或服务商账单的硬上限。小样本不是 SLA,不能证明结果完整或 canonical,也不是客户流量证据。比较结果前应独立核对固定区块哈希。User-Agent 以 BlockVectraQA/1 结尾。

链、方法与协议覆盖

用链目录核对网络身份、jsonrpc、methods.allow、methods.deny、public.methods、ws 与 subscriptions。支持一条链不代表支持所有方法或协议。免 key 与认证方法可能有不同限制。

如何自测: 复制所选网络的 public.url,调用 public.methods 中的方法。下方 Ethereum 示例用于检查网络 ID;然后用认证 key 和相同固定块高运行应用必需的方法。除允许规则外,也检查拒绝规则;跨端点对比结果时同时比较区块哈希。

curl --fail-with-body -sS --max-time 15 https://api.blockvectra.com/v1/eth_mainnet/public \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

这只验证公开方法,不证明归档覆盖或认证容量。应用需要 socket 时,应在声明支持 ws 的网络实测所需订阅、断线与续跑路径。参考 WebSocket 订阅。

工作流核对: 列出整条流程调用的全部方法,再分别对当前目录条目里带 key 与免 key 端点的 methods.allow、methods.deny、public.methods 逐项核对。eth_chainId 返回匹配只说明网络身份;方法支持、eth_getLogs 块范围与历史窗口要逐项确认,缺少的方法按缺少能力处理。主用与备用端点都要满足完整清单。HTTP 与 JSON-RPC 错误要原样返回给调用方,不要转成空日志或空事件列表。

例如读取日志并等待交易的日志扫描器,需要的方法不止首次回执查询。viem 2.47.10(源码)里 waitForTransactionReceipt 默认 checkReplacement: true:首次回执已可用时可直接返回;交易 pending,或检测到同发送方、同 nonce 的替换交易时,还可能额外调用 eth_getTransactionByHash 并读取区块。具体调用随 viem 版本与配置而变。目录核对不能证明数据完整,也不能证明历史可用。

import type { Client } from "viem";
import { waitForTransactionReceipt } from "viem/actions";

// Methods this workflow needs, checked against the catalog entry.
export const required = [
  "eth_chainId",
  "eth_getLogs",
  "eth_getTransactionReceipt",
  "eth_getTransactionByHash",
  "eth_blockNumber",
  "eth_getBlockByNumber",
];

type Scope = { allow?: string[]; deny?: string[] };

// A rule is an exact name or a trailing "*" prefix; "*" matches every method.
const matches = (rule: string, method: string) =>
  rule.endsWith("*") ? method.startsWith(rule.slice(0, -1)) : rule === method;

// Deny wins; a missing allow list means nothing is allowed.
export function missingMethods(required: string[], scope: Scope) {
  return required.filter(
    (m) =>
      (scope.deny ?? []).some((r) => matches(r, m)) ||
      !(scope.allow ?? []).some((r) => matches(r, m)),
  );
}

type Entry = { methods?: Scope; public?: { methods?: string[] } };

// Keyed uses methods.allow/deny; keyless uses only public.methods.
export function checkEntry(required: string[], entry: Entry) {
  return {
    keyed: missingMethods(required, entry.methods ?? {}),
    public: missingMethods(required, { allow: entry.public?.methods }),
  };
}

// Synthetic entry for illustration, not a copy of the live catalog.
export const syntheticEntry: Entry = {
  methods: { allow: ["eth_*"] },
  public: { methods: ["eth_chainId", "eth_blockNumber"] },
};
export const missing = checkEntry(required, syntheticEntry);
// Missing methods per scope:
// keyed: []
// public: eth_getLogs, eth_getTransactionReceipt, eth_getTransactionByHash, eth_getBlockByNumber

export async function confirmTransaction(
  client: Client,
  hash: `0x${string}`,
  timeout = 60_000,
) {
  const receipt = await waitForTransactionReceipt(client, {
    hash,
    timeout,
  });
  return { hash: receipt.transactionHash, status: receipt.status };
}

在文档源码的 checkout 中,apps/docs/tests/rpc-workflow-coverage-guide.test.ts 在 mock transport 上运行这段代码,覆盖 pending 后原交易上链、pending 后被替换两种情况,使用已安装的 viem 版本而非 2.47.10。运行命令:pnpm exec vitest run apps/docs/tests/rpc-workflow-coverage-guide.test.ts。

推送投递与索引数据

地址通知应检查链的 push 声明与确认设置。BlockVectra 可在同一订阅中将同一组地址应用到多条受支持的链,并使用一个 HTTPS 接收端;按地址数量核对自助与企业容量。Data API 查询应核对 GET /v1/status 的数据集与已索引范围。索引记录不代表任意历史合约执行。RPC 轮询、WebSocket 消息、已投递 Push 事件与监听地址天数采用不同计费口径;按 plans 中适用权重分别计算所需工作流。

如何自测: Push 使用自己控制的 HTTPS 接收端,验证签名,并用自己控制地址的事件测试去重、重试与回放。Data API 查询已知的已索引交易或转账,将区块哈希与 RPC 对照,遍历全部分页,保存游标再续跑。记录覆盖缺口以及计费事件或调用数。按 Webhook Push、Webhook 与 WebSocket及 Data API 参考选择恢复路径。

鉴权与 Agent 接入

核对客户端能否安全携带 key、发现机器可读文档、创建账户并从错误中恢复。BlockVectra RPC 支持路径 key:POST /v1/{chain}/{api_key},或以 x-api-key 头调用 POST /v1/{chain}。Data API 使用 x-api-key。key 保存在服务端环境中,不放进浏览器产物、日志或聊天消息。

开发者与 AI Agent 使用相同价格和限额。程序化开户介绍基于钱包的账户创建,Agent 指南提供文档与 MCP 入口。Agent 可按文档中的充值流程用稳定币为账户用量余额充值,无需 RPC 月订阅。充值网络、币种与起充额来自 GET /v1/topup/status。

如何自测: 让目标客户端发现链与方法、读取文档、从环境加载 key,再执行一次有界认证请求。同时检查 HTTP 状态与 JSON-RPC error,在不记录凭据的前提下检查缺少 key 的响应。验证余额不足时保存进度,读取已启用的充值网络与币种,并按文档执行充值流程;开户与支付步骤使用自己控制的账户。连通文档 MCP 不能证明 Agent 已能执行认证 RPC 请求。

记录选型结果

保留一份简短结果表:来源与采样日期、链与方法、固定区块哈希、结果完整性、调用与重试总数、可用额度、付费任务费用、延迟与限流、历史与协议缺口、恢复步骤、迁移工作量。工作负载需要合同支持或 SLA 时,应在 API 测试之外取得适用条款。

明确工作负载后,可比较具体服务商:

最后更新:

本页目录