Gestion des wallets et stockage des clés
Dans Chaingateway, un wallet est une adresse dont la clé privée est soit stockée chiffrée derrière un mot de passe, soit renvoyée une fois et gardée de votre côté. Chaingateway ne stocke pas ce mot de passe et ne peut pas restaurer une clé perdue. Vous choisissez le mode à la création : envoyez un password pour le mode protégé, omettez-le pour l’autre.
Quelle différence entre un wallet protégé par mot de passe et un wallet non sécurisé ?
Section intitulée « Quelle différence entre un wallet protégé par mot de passe et un wallet non sécurisé ? »En mode protégé, Chaingateway chiffre la clé privée avec votre mot de passe et sa propre chaîne de chiffrement. En mode non sécurisé, la clé est renvoyée dans la réponse de création et vous l’envoyez à chaque transaction. Le tableau compare les deux.
| Protégé par mot de passe | Non sécurisé | |
|---|---|---|
| Requête de création | le corps contient password | pas de password |
| Clé privée dans la réponse | non | oui, une seule fois |
| Où se trouve la clé | chiffrée chez Chaingateway | uniquement chez vous |
| Signer une transaction | envoyer password | envoyer privatekey |
| Mot de passe ou clé perdu | ne peut pas être restauré | ne peut pas être restaurée |
| Usage | adresses de longue durée et de dépôt | adresses temporaires et à usage unique |
::: danger Conservez votre mot de passe en lieu sûr Nous ne stockons jamais les mots de passe : si vous perdez le mot de passe, nous ne pouvons pas restaurer la clé privée de votre wallet. Conservez le mot de passe dans un gestionnaire de secrets, pas dans le dépôt. :::
Comment créer un wallet protégé par mot de passe ?
Section intitulée « Comment créer un wallet protégé par mot de passe ? »Envoyez une requête POST à /api/v2/{blockchain}/addresses avec un password dans le corps JSON. Remplacez {blockchain} par ethereum, bsc, polygon, arbitrum ou tron. L’exemple crée une adresse Ethereum.
curl --request POST \ --url https://app.chaingateway.io/api/v2/ethereum/addresses \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "password": "choose-a-strong-password"}'<?php$ch = curl_init();curl_setopt($ch, CURLOPT_URL, 'https://app.chaingateway.io/api/v2/ethereum/addresses');curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);curl_setopt($ch, CURLOPT_POST, 1);curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(["password" => "choose-a-strong-password"]));curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Authorization: Bearer YOUR_API_TOKEN', 'Content-Type: application/json']);$response = curl_exec($ch);curl_close($ch);echo $response;fetch('https://app.chaingateway.io/api/v2/ethereum/addresses', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ password: 'choose-a-strong-password' })}).then(response => response.json()).then(data => console.log(data));import requestsheaders = { 'Authorization': 'Bearer YOUR_API_TOKEN', 'Content-Type': 'application/json'}data = {"password": "choose-a-strong-password"}response = requests.post('https://app.chaingateway.io/api/v2/ethereum/addresses', headers=headers, json=data)print(response.json())La réponse contient la nouvelle adresse. Le fichier OpenAPI écrit la clé adderess :
{ "status": 201, "ok": true, "message": "Address created", "data": { "adderess": "0x7d3bC832A0860fD882FF4C2359e10268f4E5CCf8" }}Pour envoyer depuis l’adresse, transmettez le même mot de passe dans la requête de transaction. La clé privée ne fait pas partie de la requête. Un mauvais mot de passe renvoie le statut 401 avec le message Wrong password provided.
curl --request POST \ --url https://app.chaingateway.io/api/v2/ethereum/transactions \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "from": "0xSenderAddress", "to": "0xRecipientAddress", "amount": "0.1", "password": "choose-a-strong-password"}'Comment changer le mot de passe, exporter la clé ou importer une clé existante ?
Section intitulée « Comment changer le mot de passe, exporter la clé ou importer une clé existante ? »Chacune de ces actions correspond à un endpoint par chaîne. Les chemins ci-dessous utilisent ethereum, et les mêmes chemins existent pour bsc, polygon et arbitrum. Tron propose les mêmes opérations sur les adresses, sauf la liste des adresses.
| Action | Requête | Corps |
|---|---|---|
| Changer le mot de passe | POST /api/v2/ethereum/addresses/{address} | old_password, new_password (tous deux obligatoires) |
| Exporter la clé privée | POST /api/v2/ethereum/addresses/export/{address} | password |
| Importer une clé existante | POST /api/v2/ethereum/addresses/import | address, privatekey, password (tous obligatoires) |
| Lister vos adresses | GET /api/v2/ethereum/addresses | aucun |
| Supprimer une adresse | DELETE /api/v2/ethereum/addresses/{address} | aucun |
Le changement de mot de passe est un POST, pas un PUT ni un PATCH. Importer une clé transforme une adresse existante en adresse protégée par mot de passe : c’est la façon d’utiliser le mode protégé pour une adresse créée ailleurs ou en mode non sécurisé. La réponse d’export renvoie la clé sous data.private_key. Supprimer une adresse réduit le nombre d’adresses décomptées de votre plan.
Quand utiliser un wallet non sécurisé ?
Section intitulée « Quand utiliser un wallet non sécurisé ? »Utilisez un wallet non sécurisé uniquement pour des adresses temporaires ou à usage unique. Si vous omettez le mot de passe, la réponse de création contient la clé privée et vous devez la conserver vous-même. Quiconque obtient la clé contrôle tous les fonds de l’adresse, et une clé envoyée avec chaque transaction apparaît dans chacune de vos requêtes. La requête ci-dessous crée une adresse Tron sans mot de passe.
curl --request POST \ --url https://app.chaingateway.io/api/v2/tron/addresses \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --header 'Content-Type: application/json'La réponse contient privateKey, publicKey, hexAddress et address. Stockez la clé avant toute autre chose, car vous en avez besoin pour chaque transaction suivante. Pour envoyer depuis une telle adresse, transmettez privatekey au lieu de password dans le corps de la transaction. Les transferts TRX et TRC20 sur Tron sont décrits dans Créer des transactions et Créer des transactions de tokens.
::: danger À utiliser uniquement pour des wallets non permanents Comme la clé privée est incluse dans la réponse, il vous incombe de la stocker et de la protéger. Si quelqu’un accède à votre clé privée, il peut contrôler tous les fonds du wallet. :::
Comment fonctionnent les wallets sur Bitcoin et Solana ?
Section intitulée « Comment fonctionnent les wallets sur Bitcoin et Solana ? »Bitcoin et Solana n’utilisent pas l’endpoint addresses de la même façon que les chaînes EVM et Tron.
Sur Bitcoin, un wallet est un conteneur d’adresses. POST /api/v2/bitcoin/wallets avec un password crée le wallet et renvoie son identifiant sous data.bitcoinwallet. POST /api/v2/bitcoin/wallets/{wallet}/addresses y ajoute ensuite des adresses, et POST /api/v2/bitcoin/wallets/{wallet}/addresses/{address}/export exporte la clé d’une adresse avec le mot de passe du wallet. Une transaction Bitcoin nomme le wallet dans walletname et envoie le password du wallet. Lorsque la limite d’adresses du plan est atteinte, l’API répond par le statut 422 et le message Your address limit exceeded. Please upgrade your plan.
Sur Solana, POST /api/v2/solana/addresses crée une adresse, et chaque requête de transaction transporte la privatekey de l’expéditeur. Le fichier OpenAPI ne prévoit pas de mode mot de passe pour les transactions Solana : la gestion de la clé reste donc de votre côté.
Comment stocker les clés et les mots de passe ?
Section intitulée « Comment stocker les clés et les mots de passe ? »Traitez le token API, les mots de passe de wallet et les clés privées comme trois secrets distincts. Ne les conservez pas au même endroit et ne journalisez pas les corps de requête qui les contiennent. L’OWASP Key Management Cheat Sheet couvre le cycle de vie des clés, de la génération au stockage et au retrait. Pour le format de clé chiffrée lui-même, Ethereum documente la définition Web3 Secret Storage, qui décrit comment un mot de passe chiffre une clé. Le guide des wallets Bitcoin décrit comment les wallets stockent et dérivent les clés.