BEP20 地址:格式、校验与通过 API 创建
BEP20 地址是 BNB Smart Chain 上账户的标识,由 42 个字符、以 0x 开头的十六进制字符串构成。一个地址可以持有 BNB 和所有 BEP-20 代币。因为 BSC 与 EVM 兼容,它的格式与 Ethereum 地址相同,也不同于以 bnb1 开头的 BEP-2 地址。
要获得 BEP20 地址,可以在钱包中生成密钥对,或调用 POST /api/v2/bsc/addresses。结果是一个由 42 个字符组成的 0x 字符串。你可以公开这个地址来接收存款,因为它由公钥派生,只有私钥才能动用其中的资金。
本页介绍地址格式、BEP-20 与 BEP-2 的区别,以及如何通过 REST 创建并监控地址。关于校验和的更多细节,见博客上的 BEP20 地址指南。
BEP20 地址是什么样的?
BEP20 地址形如 0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed:前缀 0x 加 40 个十六进制字符,这 40 个字符对应 20 字节。按 ethereum.org 账户文档的说明,外部拥有账户(EOA)的地址是其公钥 Keccak-256 哈希的最后 20 字节,前面再写上 0x。BNB Smart Chain 运行以太坊虚拟机(EVM),因此原样沿用这套规则。
大小写混用是有意为之。EIP-55 定义了一种校验和,把部分字母写成大写,钱包据此可以发现大多数输入错误。全小写的地址同样有效,只是不带校验和。
- 0x 前缀表示该值为十六进制。
- 40 个十六进制字符即 20 字节,是公钥 Keccak-256 哈希的最后 20 字节。
- 总共 42 个字符。其中大小写字母的混合排布就是 EIP-55 校验和。
BEP-20 与 BEP-2、ERC-20 有什么区别?
BEP-20 是 BNB Smart Chain 的代币标准。BEP-20 规范指出,它源自 Ethereum 的 ERC-20,并增加了对 BNB Beacon Chain 与 BNB Smart Chain 之间转账的支持。函数与 ERC-20 相同:balanceOf、transfer、approve 及相关事件。
BEP-2 是另一套标准,属于 BNB Beacon Chain(原 Binance Chain),其地址以 bnb1 而不是 0x 开头。BEP-2 资产不能直接发送到 0x 地址。两条链之间转移资产需要跨链转账,所以请先确认充值页面要求的是哪个网络。
Ethereum 地址和 BEP20 地址看起来完全一样,但它们位于不同的网络。同一个私钥在两条链上控制着同一串字符。一笔转账只会到达它被广播到的那条链。
一个 BEP20 地址能同时持有 BNB 和所有 BEP-20 代币吗?
能。一个地址就是 BNB Smart Chain 上的一个账户,同时持有原生 BNB 和所有 BEP-20 代币。代币余额并不存放在地址本身。代币的智能合约内部保存着从地址到余额的映射,balanceOf(address) 读取的就是它。
不要把钱包地址和代币合约地址混淆。两者都是 42 个字符的 0x 字符串,字符串本身无法区分。合约地址标识的是哪一种代币在转移,绝不能作为转账的收款地址。发送到合约地址的代币在大多数情况下会丢失。
持有 BEP-20 代币的钱包还需要少量 BNB。BNB Smart Chain 上的 gas 以 BNB 支付,只有代币余额无法完成转账。
通过 REST 创建并监控 BEP20 地址
无需在钱包应用中生成地址再复制到后端,BSC API 可以直接创建和导入地址。存款到账时由 webhook 通知你。
| 接口 | 作用 |
|---|---|
POST /api/v2/bsc/addresses | 生成新的 BEP20 地址 |
POST /api/v2/bsc/addresses/import | 导入已有私钥,让 API 能够代表该地址签名 |
GET /api/v2/bsc/addresses | 列出账户中保存的地址 |
GET /api/v2/bsc/balances/{address} | 该地址的 BNB 余额 |
GET /api/v2/bsc/balances/{address}/bep20/{contract_address} | 单个 BEP-20 代币的余额 |
POST /api/v2/bsc/webhooks | 注册 webhook,向该地址的存款会触发带 HMAC 签名的回调 |
GET /api/v2/bsc/webhooks/notifications | 列出历史存款通知,用于对账 |
监控地址不需要私钥,只有从地址发送资金才需要。请让存款地址保持只读监控,只为负责付款的热钱包导入私钥。API 文档把地址字段定义为 0x 后接恰好 40 个十六进制字符,格式错误的字符串会被拒绝。
创建地址并监控 BEP-20 存款
两个调用都需要 Bearer 令牌。加上 X-Network: testnet 可先在 BSC 测试网演练。
curl -X POST https://app.chaingateway.io/api/v2/bsc/addresses \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"password": "a-strong-password-per-wallet"}'
curl -X POST https://app.chaingateway.io/api/v2/bsc/webhooks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-backend.example/hooks/bsc",
"to": "0xYourDepositAddress",
"type": "BEP20",
"contractaddress": "0xTokenContract",
"reference": "customer-4711"
}'发送前如何校验 BEP20 地址?
广播付款前先做三项检查。第一,用 ^0x[a-fA-F0-9]{40}$ 匹配字符串,这样可以排除长度错误和多余字符。第二,如果地址中同时有大写和小写字母,就校验 EIP-55 校验和,因为只要有一个字母写错,校验就会失败。
第三,确认网络。0x 地址在每条 EVM 链上都有效,所以格式检查无法告诉你收款方期望的是 BSC、Ethereum 还是 Polygon。请明确向用户询问网络,并对每个新的付款地址先发一笔小额转账。
如果想手动测试单个地址,地址校验工具会在浏览器中完成格式和校验和检查。
来源
- BEP-20: Tokens on BNB Smart Chain(bnb-chain/BEPs)
- Ethereum accounts(ethereum.org)
- ERC-55: Mixed-case checksum address encoding
查证日期:2026 年 11 月 5 日。
需要批量生成地址,而不是逐个创建?创建免费账户,在测试网批量生成 BEP20 地址:7 天试用,无需信用卡,无需 KYC。