BSC API：端点、方法与开发者设置

BSC API 决策清单

在集成BSC API之前，请考虑以下关键点：

• 端点类型：公共、共享还是专用RPC？公共端点有速率限制；专用节点提供稳定的性能。
• 归档节点 vs. 全节点：归档节点提供历史状态数据；全节点只提供近期数据。根据您的数据需求选择。
• WebSocket 支持：如需实时订阅（例如待处理交易、日志），请确保您的提供商支持WSS。
• 速率限制：检查允许的每秒请求数（RPS）和月度配额。生产应用需要预留空间。
• 地理延迟：选择靠近用户群体的端点，或使用全局负载均衡器。
• 调试和跟踪 API：用于交易模拟和高级监控；并非所有提供商都启用。
• 定价模式：按需付费 vs. 固定费用。在确定前预估您的调用量。

更多详情请参见我们的 RPC 定价 和 支持的网络。

BSC API 快速介绍

BSC API 指 BNB 智能链（BSC）节点暴露的 JSON-RPC 接口。由于 BSC 兼容 EVM，其 API 几乎与以太坊的 JSON-RPC 相同——eth_blockNumber、eth_getBalance 和 eth_sendRawTransaction 等方法的工作方式完全相同。这意味着现有的以太坊工具（Hardhat、Foundry、viem、web3.js）只需极少修改即可用于 BSC。

BSC 添加了一些特定于其最终性机制和 blob 支持的 BEP 方法。理解这些有助于构建更可靠的 dApp。

BSC API 端点概览

BSC 端点主要有三种类型：

• 公共 RPC：免费，但速率限制严格（例如 5–10 req/s）。仅用于测试。
• 共享/服务 RPC：由 OnFinality 等基础设施平台提供。更高的限制、归档数据，通常带有 WebSocket 和跟踪 API。
• 专用节点：独立实例，拥有保证的资源、完全控制权，且无噪音邻居。

对于生产环境，推荐使用服务 RPC 或专用节点。您可以在我们的 网络页面 上找到 BSC 端点。

BSC JSON-RPC 方法

以下是最常用的方法，按类别分组：

大多数 EVM 库对这些方法进行了抽象。您很少直接调用它们；而是使用库的 API。

连接到 BSC API

以下是使用 curl 和 viem（JavaScript）连接到 BSC 主网的方法：

使用 curl

curl -X POST https://rpc.onfinality.io/bsc \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 1
  }'

使用 viem (JavaScript)

import { createPublicClient, http } from 'viem';
import { bsc } from 'viem/chains';

const client = createPublicClient({
  chain: bsc,
  transport: http('https://rpc.onfinality.io/bsc')
});

async function main() {
  const blockNumber = await client.getBlockNumber();
  console.log('Current BSC block:', blockNumber);
}

main();

WebSocket 订阅

import { createPublicClient, webSocket } from 'viem';
import { bsc } from 'viem/chains';

const client = createPublicClient({
  chain: bsc,
  transport: webSocket('wss://rpc.onfinality.io/bsc/ws')
});

const unwatch = await client.watchBlockNumber({
  onBlockNumber: (blockNumber) => console.log('New block:', blockNumber),
});

常见陷阱与故障排除

• 速率限制：公共端点常返回 429 Too Many Requests。使用限制更高的服务或专用节点。
• 最终性确认：BSC 具有概率最终性（约15个区块）和经济最终性（BEP-126）。对于不可逆交易，请等待 eth_getFinalizedBlock 或至少15个确认。
• 缺少归档数据：如果需要过去的状态（例如历史代币余额），请确保您的端点启用了归档数据。
• WebSocket 断开：不稳定的连接可能导致订阅丢失。使用指数退避实现重连逻辑。
• Gas 估算失败：如果 eth_estimateGas 回滚，请检查发送者余额和合约逻辑。使用带 stateOverride 的 eth_call 进行调试。

决定共享 vs. 专用 BSC API

对于中小型工作负载，共享 RPC 服务性价比高。高流量或延迟敏感型项目受益于专用节点。

关键要点

• BSC API 兼容 EVM；大多数以太坊工具在链 ID 56 上无需修改即可运行。
• 根据工作负载选择端点：测试用公共、生产用服务 RPC、高吞吐用专用。
• BSC 特有方法如 eth_getFinalizedBlock 有助于更快地确认最终性。
• 构建前务必检查速率限制、归档支持和 WebSocket 可用性。
• OnFinality 提供 BSC 主网 和 测试网 RPC 端点，包含共享和专用选项。