Aller au contenu

Créer des adresses Ethereum et Tron

Vous créez une adresse avec une seule requête : POST /api/v2/{chain}/addresses. Si le corps contient un password, Chaingateway stocke la clé privée chiffrée et la réponse ne renvoie que l’adresse. Sans mot de passe, la réponse contient la clé privée. Ce tutoriel montre les deux variantes pour Ethereum et Tron, valables aussi pour BNB Smart Chain, Polygon et Arbitrum.

Les appels ci-dessous nécessitent un token API. Le Démarrage rapide explique comment en créer un.

Création d'adresse : une requête POST vers /addresses, avec ou sans mot de passe ; la réponse contient l'adresse et, sans mot de passe, la clé privée POST /api/v2/{chain}/addresses Authorization: Bearer token Avec mot de passe clé stockée chiffrée, réponse : adresse Sans mot de passe réponse : adresse et clé privée, vous stockezla clé
Le mot de passe décide qui détient la clé privée.

Comment créer une adresse protégée par mot de passe ?

Section intitulée « Comment créer une adresse protégée par mot de passe ? »

Envoyez le champ password dans le corps JSON. Pour les chaînes EVM, Chaingateway crée un keystore, un format de fichier chiffré pour une clé privée décrit dans la définition Web3 Secret Storage. Le keystore est chiffré avec votre mot de passe. Qui ne possède que le keystore ou que le mot de passe ne peut pas accéder à l’adresse. Vos transactions utilisent le mot de passe au lieu de la clé privée.

Le password est une valeur que vous choisissez. Chaingateway ne le stocke pas et ne peut pas le récupérer. Si vous perdez le mot de passe, vous perdez l’accès à l’adresse. Conservez-le donc dans un gestionnaire de mots de passe ou un coffre à secrets.

Fenêtre de terminal
curl --request POST \
--url https://app.chaingateway.io/api/v2/ethereum/addresses \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--data '{"password":"choose-a-strong-password"}'

La réponse a le statut 201. Le fichier OpenAPI écrit la clé de l’adresse adderess :

{
"status": 201,
"ok": true,
"message": "Address created",
"data": {
"adderess": "0x7d3bC832A0860fD882FF4C2359e10268f4E5CCf8"
}
}

Omettez le password. La réponse contient alors la clé privée, et chaque transaction depuis l’adresse exige cette clé dans un champ privatekey. N’utilisez ce mode que pour des adresses à usage unique, car une clé privée transmise à chaque requête risque facilement de fuiter. L’exemple crée une adresse Tron.

Fenêtre de terminal
curl --request POST \
--url https://app.chaingateway.io/api/v2/tron/addresses \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN'

Une adresse Tron créée sans mot de passe renvoie directement le matériel de clé :

{
"status": 201,
"ok": true,
"message": "Address created",
"data": {
"privateKey": "59f1c6200e01a2ca9471411f10198bfa63678d0e87cc2ca30f9c4a68dee78edc",
"publicKey": "040fe6e677442c36f7fdd5535ba3ff1cef0110d78363420f7e24b65298990e3467aed68b9a67e1396d84753db25b32a2fa3e1fc0a673f01638e9bcfab2d8f4ceb5",
"hexAddress": "41a56a6505ffbee78eb916dd44f4846874deddaebd",
"address": "TR3qx91smURF3R455V1ubqtoUsZbgqikfg"
}
}

Stockez la privateKey avec l’address dans un endroit sûr. La clé de cet exemple est une valeur d’exemple : ne l’approvisionnez jamais. La documentation des comptes de Tron explique le lien entre l’adresse base58 et l’adresse hexadécimale.

Lisez le solde, approvisionnez l’adresse, puis envoyez depuis celle-ci. GET /api/v2/ethereum/balances/{address} renvoie le solde de l’adresse sous forme de chaîne :

{
"status": 200,
"ok": true,
"message": "Balance fetched",
"data": "0.000000000000000000"
}

Une nouvelle adresse commence avec un solde de zéro. Envoyez-y des coins depuis un wallet que vous contrôlez, ou depuis le faucet testnet de la chaîne lorsque vous travaillez avec X-Network: testnet. GET /api/v2/ethereum/addresses liste toutes les adresses que vous avez créées et pas supprimées. Pour être notifié à l’arrivée de fonds, créez un webhook pour l’adresse. L’envoi de fonds depuis l’adresse est traité dans Créer des transactions.

Bitcoin et Solana diffèrent. Sur Bitcoin, vous créez d’abord un wallet avec POST /api/v2/bitcoin/wallets, puis vous y ajoutez des adresses. Sur Solana, POST /api/v2/solana/addresses crée l’adresse. La gestion des wallets décrit les deux cas.

Quelles erreurs la création d’adresse peut-elle renvoyer ?

Section intitulée « Quelles erreurs la création d’adresse peut-elle renvoyer ? »

Les appels d’adresses utilisent l’enveloppe standard, avec ok à false en cas d’échec. Un token absent ou invalide renvoie le statut 401 avec {"message":"Unauthenticated."}. Un corps qui échoue à la validation renvoie le statut 422 avec Data validation failed et les noms des champs dans errors. Lorsque la limite d’adresses de votre offre est atteinte, l’API répond par le statut 422 et Your address limit exceeded. Please upgrade your plan. Le fichier OpenAPI montre ce message pour les wallets Bitcoin.

DELETE /api/v2/ethereum/addresses/{address} supprime une adresse et réduit le nombre d’adresses comptées dans votre offre. Supprimez les adresses dont vous n’avez plus besoin, mais exportez d’abord la clé privée si l’adresse peut encore contenir des fonds.

Comment les adresses sont-elles formatées sur chaque chaîne ?

Section intitulée « Comment les adresses sont-elles formatées sur chaque chaîne ? »

Ethereum et les autres chaînes EVM utilisent des adresses de 20 octets, écrites en 40 caractères hexadécimaux avec le préfixe 0x. La documentation des comptes Ethereum décrit comment un compte externe est dérivé d’une paire de clés. Les adresses Tron commencent par T et comptent 34 caractères, format que l’API valide avec le motif T[a-zA-Z0-9]{33}. La documentation des comptes TRON est la référence principale pour ce format.