如何使用币安智能链API？

币安智能链API决策清单

在集成币安智能链API之前，评估以下因素：

理解币安智能链API

币安智能链（BSC）是一个兼容以太坊虚拟机（EVM）的区块链，这意味着它支持与以太坊相同的JSON-RPC方法。BSC API允许你读取区块链数据、提交交易以及与智能合约交互。大多数为以太坊构建的工具（如web3.js、ethers.js和viem）只需进行最小配置更改即可与BSC配合使用。

JSON-RPC方法

BSC支持标准的以太坊JSON-RPC方法，以及一些用于其最终性机制的自定义方法。常见方法包括：

• eth_blockNumber – 获取最新区块号。
• eth_getBalance – 获取地址的余额。
• eth_call – 执行智能合约调用而不创建交易。
• eth_sendRawTransaction – 广播已签名的交易。
• eth_getTransactionReceipt – 获取交易回执。
• eth_getLogs – 检索事件日志。
• eth_subscribe / eth_unsubscribe – 实时订阅（仅WebSocket）。
• 自定义BSC方法：eth_getFinalizedHeader、eth_getFinalizedBlock、eth_newFinalizedHeaderFilter用于最终性查询。

RPC端点

公共端点

官方公共RPC端点可用，但有严格的速率限制，不建议用于生产环境。示例：

https://bsc-dataseed.binance.org/
https://bsc-dataseed1.defibit.io/

这些是免费的，但可能受到限流。仅用于测试或低流量应用。

私有/提供商端点

对于生产工作负载，请使用可靠的RPC提供商，如OnFinality。提供商提供专用或共享端点，具有更高的速率限制、更好的性能和支持选项。OnFinality提供的BSC RPC端点具有：

• 高吞吐量和低延迟。
• WebSocket支持。
• 归档节点访问以获取历史数据。
• API密钥管理。

要在OnFinality上创建BSC端点，请访问我们的网络页面或在api-service注册。

代码示例

使用cURL

获取最新区块号：

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

响应：

{"jsonrpc":"2.0","id":1,"result":"0x10d4f3b"}

使用ethers.js (JavaScript)

const { ethers } = require("ethers");

const provider = new ethers.JsonRpcProvider("https://rpc.onfinality.io/rpc?apikey=YOUR_API_KEY");

async function main() {
  const blockNumber = await provider.getBlockNumber();
  console.log("当前区块:", blockNumber);

  const balance = await provider.getBalance("0x742d35Cc6634C0532925a3b844Bc4a23d0b5f8e2");
  console.log("余额 (BNB):", ethers.formatEther(balance));
}

main();

使用viem (JavaScript)

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

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

const blockNumber = await client.getBlockNumber();
console.log("区块号:", blockNumber);

常见陷阱

• 使用过期的nonce：发送交易时，确保nonce与地址的下一个预期nonce匹配。使用带有"pending"参数的eth_getTransactionCount。
• 超出速率限制：公共端点通常施加严格限制。使用具有更高限制或专用节点的提供商。
• 缺少归档数据：某些端点不支持归档状态。如果你的应用需要历史eth_call，确保端点提供归档访问。
• WebSocket断开连接：WebSocket连接可能断开；实现重连逻辑。

如何选择正确的API访问方式

公共端点、共享私有端点和专用节点端点之间的选择取决于你的工作负载：

• 公共端点：适用于原型设计和低容量只读查询。避免用于生产环境。
• 共享私有端点（例如通过OnFinality）：为大多数dApp提供平衡的性能和成本。适用于以读取为主、交易提交适中的应用。
• 专用节点：完全控制资源、清晰的速率限制和低延迟。适用于高吞吐量dApp、实时交易或数据索引。

有关提供商选择的更多详细信息，请参阅我们的选择RPC提供商指南。

关键要点

• 币安智能链使用与以太坊相同的JSON-RPC，使迁移现有代码变得容易。
• 公共端点可用，但由于速率限制不适合生产环境。
• 使用可靠的RPC提供商（如OnFinality）以获得更快、更可靠的访问。
• 在部署之前，始终测试端点的性能和归档支持。
• 为WebSocket订阅实现适当的错误处理和重连。

常见问题

问：BSC API和币安交易所API有什么区别？

答：BSC API用于与BNB智能链区块链交互（读/写数据、部署合约），而币安交易所API用于在币安中心化交易所进行交易。它们用途不同。

问：我可以将以太坊工具与BSC一起使用吗？

答：可以，因为BSC兼容EVM。大多数以太坊库无需修改即可使用。只需将RPC端点更改为BSC端点即可。

问：如何获取BSC API密钥？

答：在RPC提供商（如OnFinality）注册以获取API密钥。或者，你可以使用公共端点而无需密钥，但有限制。

问：BSC支持WebSocket吗？

答：是的，大多数提供商提供WebSocket端点用于实时订阅。请查阅提供商的文档以获取WSS URL。

问：什么是归档节点访问？

答：归档节点存储完整的状态历史，允许查询任何过去区块的eth_call。对于分析和历史数据检索很有用。

更多信息，请查看我们的RPC定价和支持的网络。