什么是 BNB API？如何在 BNB 智能链开发中使用它？

快速决策指南：应该使用哪个 BNB API 端点？

在编写任何代码之前，请决定哪种类型的 BNB API 端点适合你的工作负载。正确的选择取决于你预期的流量、是否需要历史数据，以及你愿意承担多少运维开销。

如果你正在构建生产应用，像 OnFinality 这样的托管 RPC 提供商可以节省时间并降低风险。你可以获得可靠的端点、多种网络选项和支持，而无需运行自己的基础设施。查看 RPC 定价 和 支持的网络 以了解适合你预算和需求的内容。

什么是 BNB API？

BNB API 是用于与 BNB 智能链（BSC）交互的一组 JSON-RPC 方法。BSC 是一个兼容 EVM 的区块链，因此该 API 遵循与以太坊 JSON-RPC 相同的标准。这意味着你可以使用熟悉的工具，如 ethers.js、viem 或直接 HTTP 请求来读取和写入 BSC 上的数据。

该 API 允许你：

• 查询区块和交易数据
• 读取合约状态
• 发送交易
• 通过 WebSocket 订阅事件

由于 BSC 兼容 EVM，大多数以太坊开发模式只需很少的更改即可使用。但是，BSC 有自己的链 ID、网络参数，以及一些 BSC 特有的方法，用于最终性和 blob 数据。

BNB API 链设置

要连接到 BNB 智能链，你需要正确的网络参数。以下是主网和测试网的基本设置：

对于生产环境，你不应依赖公共 RPC URL。它们有速率限制且可能不可靠。相反，请使用像 OnFinality 这样的托管提供商。你可以在 BNB 链网络页面 和 BNB 测试网页面 上找到最新的端点详情。

核心 BNB API 方法

BNB API 支持标准的以太坊 JSON-RPC 方法。以下是最常用的方法：

• eth_blockNumber – 获取最新区块号
• eth_getBalance – 获取地址余额
• eth_call – 执行只读合约调用
• eth_sendRawTransaction – 广播已签名的交易
• eth_getTransactionReceipt – 获取交易收据
• eth_getLogs – 查询事件日志
• eth_subscribe – 订阅事件（仅 WebSocket）

BSC 还有一些网络特定的方法，例如 eth_getFinalizedBlock 和 eth_getBlobSidecarByTxHash，这些在官方 BNB 链文档中有记录。

使用 curl 连接 BNB API

你可以使用简单的 curl 请求测试 BNB API。以下是一个获取最新区块号的示例：

curl -X POST https://bnb-mainnet.g.alchemy.com/v2/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

将 URL 替换为你的提供商端点。如果你使用 OnFinality，你将获得一个来自仪表板的专用 URL。

使用 viem 调用 BNB API

如果你正在构建 JavaScript dApp，viem 是一个流行的库。以下是如何为 BNB 智能链设置客户端：

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

const client = createPublicClient({
  chain: bsc,
  transport: http('https://bnb-mainnet.g.alchemy.com/v2/YOUR_API_KEY'),
});

const blockNumber = await client.getBlockNumber();
console.log('Current block number:', blockNumber);

对于测试网，请使用 viem 中的 bscTestnet 链和测试网端点。

BNB API 与币安交易所 API 的区别

很容易将 BNB API 与币安交易所 API 混淆。币安 API 用于在币安交易所进行交易——下单、检查余额和访问市场数据。BNB API 用于与 BNB 智能链区块链本身交互——读写链上数据。

如果你正在构建 dApp，你需要 BNB API。如果你正在构建交易机器人，你需要币安 API。它们是独立的系统，具有不同的身份验证和速率限制。

常见陷阱和故障排除

即使使用正确的端点，你也可能会遇到问题。以下是一些常见问题及解决方法：

• 速率限制：公共 RPC 通常限制每秒请求数。如果达到限制，请切换到付费提供商或实现缓存。
• 错误的链 ID：确保主网使用链 ID 56，测试网使用 97。错误的链 ID 会导致交易失败。
• WebSocket 断开：WebSocket 连接可能会断开。在客户端中实现重连逻辑。
• 缺少归档数据：如果需要历史状态，则需要归档节点。标准节点仅保留最近的状态。
• 找不到交易：如果找不到交易，可能尚未被挖掘。等待几秒钟后重试。

如何选择 BNB API 提供商

在评估 BNB API 提供商时，请考虑以下因素：

• 可靠性：寻找具有正常运行时间记录的提供商，但避免绝对声明。查看其状态页面。
• 吞吐量：速率限制是多少？他们是否为高流量提供专用节点？
• 归档数据：他们是否提供归档节点？这对于分析和索引至关重要。
• WebSocket 支持：他们是否支持 WebSocket 订阅？实时 dApp 需要此功能。
• 定价：比较成本。OnFinality 提供透明的 RPC 定价 和免费层。
• 支持：是否有文档和响应迅速的支持？

OnFinality 提供托管的 BNB 链 RPC 端点，包括共享和专用选项。你可以快速入门，并随着项目的发展进行扩展。

关键要点

• BNB API 是 BNB 智能链的 JSON-RPC 接口，与以太坊工具兼容。
• 使用正确的链 ID（主网 56，测试网 97）和网络参数。
• 公共 RPC 适合测试，但生产应用应使用可靠的提供商。
• 根据流量和数据需求选择共享或专用节点。
• OnFinality 提供 BNB 链 RPC 端点，具有灵活的定价和支持。

常见问题解答

什么是 BNB API？

BNB API 是 BNB 智能链的 JSON-RPC 接口，允许开发人员使用标准的以太坊方法与该区块链交互。

BNB API 与币安交易所 API 相同吗？

不。币安交易所 API 用于在交易所进行交易，而 BNB API 用于与 BNB 智能链区块链交互。

BNB 智能链使用什么链 ID？

BNB 智能链主网使用链 ID 56，测试网使用链 ID 97。

我需要为 BNB 使用归档节点吗？

如果你需要历史状态数据，是的。归档节点存储完整的状态历史，这对于某些分析和索引用例是必需的。

如何获取 BNB API 端点？

你可以使用公共 RPC，但对于生产环境，请考虑像 OnFinality 这样的托管提供商。注册获取 API 密钥并获得专用端点。