Adresse BEP20 : format, validation et création via l'API
Une adresse BEP20 est l'identifiant hexadécimal de 42 caractères, préfixé par 0x, d'un compte sur BNB Smart Chain. Une même adresse détient du BNB et tous les tokens BEP-20. Elle a le même format qu'une adresse Ethereum, car BSC est compatible EVM, et elle diffère d'une adresse BEP-2, qui commence par bnb1.
Pour obtenir une adresse BEP20, générez une paire de clés dans un wallet ou appelez POST /api/v2/bsc/addresses. Le résultat est une chaîne 0x de 42 caractères. Vous pouvez la publier pour recevoir des dépôts, car elle est dérivée de la clé publique et seule la clé privée peut en dépenser les fonds.
Cette page explique le format, la différence entre BEP-20 et BEP-2, puis la création et la surveillance d'adresses en REST. Le guide sur l'adresse BEP20 du blog détaille les checksums.
À quoi ressemble une adresse BEP20 ?
Une adresse BEP20 ressemble à 0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed : le préfixe 0x suivi de 40 caractères hexadécimaux. Ces 40 caractères représentent 20 octets. D'après la documentation des comptes d'ethereum.org, l'adresse d'un compte externe correspond aux 20 derniers octets du hachage Keccak-256 de sa clé publique, écrits avec un 0x devant. BNB Smart Chain exécute l'Ethereum Virtual Machine et reprend donc ce schéma sans changement.
Le mélange de majuscules et de minuscules est voulu. EIP-55 définit un checksum qui met certaines lettres en majuscule, ce qui permet à un wallet de détecter la plupart des fautes de frappe. Une adresse entièrement en minuscules reste valide, elle ne porte simplement aucun checksum.
- Le préfixe 0x indique que la valeur est en hexadécimal.
- Les 40 caractères hexadécimaux représentent 20 octets : les 20 derniers octets du hachage Keccak-256 de la clé publique.
- 42 caractères au total. L'alternance de majuscules et de minuscules est le checksum EIP-55.
En quoi BEP-20 diffère-t-il de BEP-2 et d'ERC-20 ?
BEP-20 est le standard de token de BNB Smart Chain. La spécification BEP-20 indique qu'il dérive de l'ERC-20 d'Ethereum et ajoute la prise en charge des transferts entre BNB Beacon Chain et BNB Smart Chain. Les fonctions sont les mêmes : balanceOf, transfer, approve et les événements associés.
BEP-2 est un autre standard. Il appartient à BNB Beacon Chain, anciennement Binance Chain, et ses adresses commencent par bnb1 au lieu de 0x. Un actif BEP-2 ne peut pas être envoyé directement vers une adresse 0x. Déplacer de la valeur entre les deux chaînes demande un transfert cross-chain, donc vérifiez quel réseau l'écran de dépôt demande.
Une adresse Ethereum et une adresse BEP20 sont identiques à l'œil, mais elles vivent sur des réseaux différents. La même clé privée contrôle la même chaîne sur les deux chaînes. Un transfert n'atteint que la chaîne sur laquelle il a été diffusé.
Une adresse BEP20 contient-elle le BNB et tous les tokens BEP-20 ?
Oui. Une adresse est un compte sur BNB Smart Chain, et elle détient en même temps le BNB natif et tous les tokens BEP-20. Le solde d'un token n'est pas stocké sur l'adresse elle-même. Le smart contract du token tient une table qui associe chaque adresse à un solde, et balanceOf(address) la lit.
Ne confondez pas une adresse de wallet et l'adresse d'un contrat de token. Ce sont deux chaînes 0x de 42 caractères, et rien dans la chaîne ne les distingue. L'adresse du contrat indique quel token circule, et elle ne doit jamais être la destination d'un transfert. Des tokens envoyés à une adresse de contrat sont dans la plupart des cas perdus.
Un wallet qui détient des tokens BEP-20 a aussi besoin d'un peu de BNB. Le gas sur BNB Smart Chain se paie en BNB, donc un solde de tokens seul ne peut pas bouger.
Créer et surveiller une adresse BEP20 en REST
Au lieu de générer une adresse dans une application wallet et de la copier dans votre backend, l'API BSC crée et importe les adresses directement. Un webhook vous prévient ensuite quand un dépôt arrive.
| Endpoint | Ce qu'il fait |
|---|---|
POST /api/v2/bsc/addresses | Générer une nouvelle adresse BEP20 |
POST /api/v2/bsc/addresses/import | Importer une clé privée existante pour que l'API puisse signer pour cette adresse |
GET /api/v2/bsc/addresses | Lister les adresses enregistrées dans votre compte |
GET /api/v2/bsc/balances/{address} | Solde en BNB de l'adresse |
GET /api/v2/bsc/balances/{address}/bep20/{contract_address} | Solde d'un token BEP-20 |
POST /api/v2/bsc/webhooks | Enregistrer un webhook pour qu'un dépôt sur l'adresse déclenche un callback signé HMAC |
GET /api/v2/bsc/webhooks/notifications | Lister les notifications de dépôt passées pour la réconciliation |
Surveiller une adresse ne demande aucune clé privée. Seul l'envoi depuis cette adresse en a besoin. Gardez vos adresses de dépôt en lecture seule et n'importez une clé que pour le hot wallet qui effectue les paiements. L'API documente les champs d'adresse comme 0x suivi d'exactement 40 caractères hexadécimaux, donc une chaîne mal formée est rejetée.
Créer une adresse et la surveiller pour les dépôts BEP-20
Les deux appels demandent un token Bearer. Ajoutez X-Network: testnet pour répéter d'abord le flux sur le 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"
}'Comment valider une adresse BEP20 avant d'envoyer ?
Faites trois vérifications avant de diffuser un paiement sortant. D'abord, comparez la chaîne à l'expression ^0x[a-fA-F0-9]{40}$, qui rejette les mauvaises longueurs et les caractères parasites. Ensuite, si l'adresse mélange majuscules et minuscules, vérifiez le checksum EIP-55, car une seule lettre erronée fait alors échouer le contrôle.
Enfin, confirmez le réseau. Une adresse 0x est valide sur toutes les chaînes EVM, donc le contrôle de format ne dit pas si le destinataire attend BSC, Ethereum ou Polygon. Demandez le réseau explicitement à l'utilisateur et envoyez un petit premier transfert vers toute nouvelle adresse de paiement.
Le validateur d'adresses exécute les contrôles de format et de checksum dans le navigateur, si vous voulez tester une adresse à la main.
Sources
- BEP-20 : Tokens on BNB Smart Chain (bnb-chain/BEPs)
- Ethereum accounts (ethereum.org)
- ERC-55 : Mixed-case checksum address encoding
Vérifié le 5 novembre 2026.
Besoin d'adresses en volume plutôt qu'une par une ? Créez un compte gratuit et générez un lot d'adresses BEP20 sur testnet. Essai de 7 jours, sans carte, sans KYC.
FAQ : adresses BEP20
Prêt à construire sur BNB Smart Chain ?
Créez un compte et générez une adresse BEP20 de testnet en quelques minutes. Essai de 7 jours, sans carte, sans KYC. La référence complète des endpoints se trouve dans la documentation de l'API BSC. L'API blockchain multi-chaînes couvre les sept chaînes.