SDK 与工具

JavaScript

Copy page

Binance Web3 Wallet API 官方 JavaScript 连接器，专为运行在 Node.js 上的后端应用程序而设计。

该连接器以 @binance-web3/wallet npm 包形式发布，支持 Web3 Wallet REST API，并提供内置的请求签名、连接管理以及 TypeScript 类型定义。

如需查看源代码、问题反馈及版本说明，请访问 GitHub 上的 binance-web3-connector-js 仓库。

支持的环境

• Node.js v22.12.0 或更高版本（推荐使用 LTS 版本）
• JavaScript 和 TypeScript 后端应用程序

本连接器仅适用于服务端使用。
目前不支持浏览器环境。

典型使用场景

• 查询余额、交易记录及支持链的后端服务
• 构建并提交兑换与转账交易
• 将 Web3 Wallet 行情与价格数据集成到后端系统

主要特性

• 支持 Binance Web3 Wallet REST API
• 内置针对需要身份验证接口的请求签名
• 完整的 TypeScript 类型定义
• 可配置的超时、重试与代理支持
• 一致的 API 设计

快速开始

安装该包：

Code
npm install @binance-web3/wallet

创建客户端并发送请求：

Code
import { Web3Wallet, Web3WalletRestAPI } from "@binance-web3/wallet";

const configurationRestAPI = {
  apiKey: process.env.BINANCE_API_KEY,
  apiSecret: process.env.BINANCE_API_SECRET,
};
const client = new Web3Wallet({ configurationRestAPI });

const response = await client.restAPI.getSupportedChains();
const data = await response.data();

上述示例使用基于 API Secret 的 HMAC 身份验证。同样支持使用私钥的非对称密钥身份验证方式。

如需 REST API 示例，请参阅该包的文档。

注意事项与最佳实践

• 使用环境变量或密钥管理工具安全存储 API 密钥
• 构建高吞吐量服务时，注意监控频率限制和接口权重