Adresses BNB Smart Chain

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.

Essai gratuit de 7 jours — sans carte, sans KYC pour commencer Non-custodial — vos clés privées restent sous votre contrôle Les offres démarrent à 49 €/mois (490 €/an) — voir les offres et les limites de débit

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.

0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed 1 2 3
  1. Le préfixe 0x indique que la valeur est en hexadécimal.
  2. Les 40 caractères hexadécimaux représentent 20 octets : les 20 derniers octets du hachage Keccak-256 de la clé publique.
  3. 42 caractères au total. L'alternance de majuscules et de minuscules est le checksum EIP-55.
Anatomie d'une adresse EVM. BNB Smart Chain et Ethereum partagent cette structure.

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.

EndpointCe qu'il fait
POST /api/v2/bsc/addressesGénérer une nouvelle adresse BEP20
POST /api/v2/bsc/addresses/importImporter une clé privée existante pour que l'API puisse signer pour cette adresse
GET /api/v2/bsc/addressesLister 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/webhooksEnregistrer un webhook pour qu'un dépôt sur l'adresse déclenche un callback signé HMAC
GET /api/v2/bsc/webhooks/notificationsLister 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
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

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

Une chaîne hexadécimale de 42 caractères préfixée par 0x, qui identifie un compte sur BNB Smart Chain et détient du BNB et tout token BEP-20. Elle est dérivée comme une adresse Ethereum, ce qui explique que les deux chaînes partagent le même format.

Une adresse BEP20 est le format d'adresse de BNB Smart Chain (préfixe 0x, style EVM). BEP-2 est un standard distinct et plus ancien de BNB Beacon Chain, dont les adresses commencent par bnb1. Les deux ne sont pas interchangeables : vérifiez quelle chaîne une demande de dépôt attend réellement avant d'envoyer.

Le format est identique, le réseau ne l'est pas. La même clé privée produit une adresse 0x d'apparence identique sur Ethereum et sur BSC, mais des fonds envoyés sur une chaîne n'existent pas sur l'autre. Il faut diffuser la transaction sur la chaîne que le destinataire attend.

POST /api/v2/bsc/addresses en génère une via l'API. Si vous enregistrez un webhook sur cette adresse, votre backend reçoit une notification signée HMAC dès qu'un dépôt de BNB ou de BEP-20 arrive, sans polling.

Oui. Une adresse BEP20 détient le BNB natif et tous les tokens BEP-20, par exemple USDT, USDC ou le token d'un projet, à la même adresse. Le smart contract de chaque token suit les soldes, pas l'adresse elle-même.

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.

Relu par Maurice Sobiera Comment nous rédigeons ces pages