← Blog
10 min de lecture
|
Publié le
|
Mis à jour le

Portefeuilles Tron protégés par mot de passe via API

Créez des portefeuilles Tron avec un mot de passe : l'API ne renvoie jamais la clé privée. Création, envoi, export et changement de mot de passe d'une adresse.

Chapitres
C
Chaingateway Team
Experts blockchain

Relu par Maurice Sobiera

Un portefeuille Tron protégé par mot de passe est une adresse créée via l’API de Chaingateway avec un paramètre password. La clé privée est chiffrée avec ce mot de passe et n’est pas renvoyée. Pour envoyer depuis l’adresse, vous transmettez le mot de passe, pas la clé. Chaingateway ne le stocke pas : un mot de passe perdu est irrécupérable.

Qu’est-ce qui a changé avec les portefeuilles protégés par mot de passe ?

Jusqu’au 18 février 2025, les adresses Tron créées via l’API renvoyaient la clé privée dans la réponse. Cela convient pour des adresses temporaires, mais la clé reste alors dans vos journaux, votre base de données et tous les systèmes qui traitent la réponse. Les portefeuilles protégés par mot de passe sont l’alternative. La documentation sur la gestion des portefeuilles les présente comme la méthode recommandée et décrit la clé comme chiffrée avec votre mot de passe et avec les mécanismes de chiffrement propres à Chaingateway. La variante non sécurisée existe toujours : si vous omettez password, vous recevez directement la clé privée et vous devez la stocker vous-même.

Comment créer un portefeuille Tron protégé par mot de passe ?

Envoyez une requête POST à /api/v2/tron/addresses avec un password :

Terminal window
curl --request POST \
--url https://app.chaingateway.io/api/v2/tron/addresses \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--header 'Content-Type: application/json' \
--data '{ "password": "your_secure_password" }'

La réponse contient la nouvelle adresse dans data. Elle ne contient pas la clé privée. Utilisez un mot de passe long et aléatoire, issu d’un gestionnaire de mots de passe. L’aide-mémoire OWASP sur l’authentification juge faibles les mots de passe de moins de 15 caractères quand aucun second facteur ne les protège, et un mot de passe de portefeuille n’en a pas. Conservez-le dans votre stockage de secrets, car le même mot de passe est nécessaire pour toutes les requêtes ultérieures sur cette adresse.

Comment envoyer depuis un portefeuille protégé par mot de passe ?

Transmettez le champ password à la place de privatekey. Un transfert de TRX nécessite from, to, amount et password :

Terminal window
curl --request POST \
--url https://app.chaingateway.io/api/v2/tron/transactions \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"from": "TSenderAddress",
"to": "TDestinationAddress",
"amount": 100,
"password": "your_secure_password"
}'

Le même champ password fonctionne sur POST /api/v2/tron/transactions/trc20, .../trc721 et .../trc10. Les transferts TRC20 exigent aussi un contractaddress. Un transfert TRC20 depuis une adresse sans TRX ni Energy stakée échoue avec le statut 422, comme l’explique le tutoriel TronFuel et Paymaster. Le Paymaster de Chaingateway est obsolète, et TronFuel est la méthode recommandée pour couvrir les frais.

Comment exporter la clé, changer le mot de passe ou importer une clé ?

Trois autres endpoints complètent le cycle de vie du portefeuille. Chacun prend l’adresse dans le chemin :

TâcheRequêteCorps
Exporter la clé privéePOST /api/v2/tron/addresses/export/{address}password
Changer le mot de passePOST /api/v2/tron/addresses/{address}old_password, new_password
Importer une clé existantePOST /api/v2/tron/addresses/importaddress, privatekey, password

L’import permet de placer sous protection par mot de passe une adresse existante non sécurisée. Après l’import, envoyez depuis l’adresse avec le mot de passe et arrêtez de transmettre la clé. Supprimez la clé de votre propre stockage dès que vous avez vérifié un transfert de test sur le testnet. L’export est la porte de sortie : il vous permet de quitter le service avec votre clé, et il exige le mot de passe.

Quelles sont les limites de la protection par mot de passe ?

Un compte Tron est contrôlé par sa clé privée, comme le formule la documentation de Tron : c’est donc la clé que vous protégez. Le mot de passe protège la clé au repos. Il ne protège pas un serveur compromis qui connaît déjà le mot de passe, et il n’aide pas en cas de mot de passe perdu. Selon la documentation, Chaingateway ne peut pas restaurer un portefeuille dont le mot de passe est perdu. Sauvegardez le mot de passe et testez une fois l’export avant de déplacer de vrais fonds. Gardez les soldes importants dans un portefeuille dont vous détenez vous-même la clé, et utilisez les portefeuilles de l’API comme hot wallets à solde limité.

Avant de déplacer de vrais fonds, suivez cette liste de contrôle :

  1. Créez un portefeuille sur le testnet et envoyez un petit transfert avec le mot de passe.
  2. Exportez une fois la clé privée et vérifiez qu’elle correspond à l’adresse.
  3. Changez le mot de passe et vérifiez qu’un envoi avec l’ancien mot de passe échoue et qu’un envoi avec le nouveau fonctionne.
  4. Stockez le mot de passe dans votre gestionnaire de secrets et supprimez-le de l’historique du shell et des journaux.

Utilisez d’abord le testnet. Ajoutez l’en-tête X-Network: testnet à chaque requête ci-dessus, créez un portefeuille sur Nile, et parcourez la création, l’envoi, l’export et le changement de mot de passe. La page des réseaux pris en charge liste les réseaux de test, et la documentation des réseaux Tron explique Nile et Shasta.

Quelles questions reviennent le plus souvent ?

Un portefeuille protégé par mot de passe fonctionne-t-il sur d’autres chaînes ?

Oui. La documentation sur la gestion des portefeuilles décrit le paramètre password pour /api/v2/{blockchain}/addresses, et le fichier OpenAPI liste des endpoints d’adresses suivant le même schéma pour Ethereum, BNB Smart Chain, Polygon et Arbitrum.

Chaingateway peut-il réinitialiser un mot de passe perdu ?

Non. La documentation indique que Chaingateway ne peut pas restaurer la clé privée d’un portefeuille dont le mot de passe est perdu. Exportez la clé une fois et conservez-la dans votre propre coffre.

Les webhooks ont-ils besoin du mot de passe du portefeuille ?

Non. Un webhook surveille une adresse et n’a besoin que de l’adresse, d’une URL et d’un filtre. Le mot de passe est nécessaire pour signer des transactions, exporter la clé et changer le mot de passe.

Puis-je mélanger des portefeuilles protégés par mot de passe et non sécurisés ?

Oui. Chaque adresse est créée avec ou sans mot de passe. Dans une requête, envoyez soit password, soit privatekey, comme le décrit le fichier OpenAPI pour les endpoints de transaction.

Comment nous rédigeons ces articles

Prêt à le construire vous-même ? Obtenir votre clé API — essai de 7 jours, sans carte bancaire — ou consultez API Tron pour la référence complète des endpoints.

C
Chaingateway Team
Experts blockchain

L'équipe Chaingateway s'attache à simplifier l'intégration blockchain pour les développeurs du monde entier.