Aller au contenu

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.

Wallet protégé par mot de passe : l'adresse est créée avec un mot de passe, Chaingateway stocke la clé chiffrée, les transactions suivantes sont signées avec le mot de passe au lieu de la clé privée POST /api/v2/{chain}/addresses corps : password La clé est stockée chiffrée Chaingateway ne garde aucune copie de votremot de passe POST /api/v2/{chain}/transactions corps : from, to, amount, password La transaction est signée et diffusée réponse : txid
Dans ce mode, la clé privée n'apparaît jamais dans une requête ni dans une réponse.

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 passeNon sécurisé
Requête de créationle corps contient passwordpas de password
Clé privée dans la réponsenonoui, une seule fois
Où se trouve la cléchiffrée chez Chaingatewayuniquement chez vous
Signer une transactionenvoyer passwordenvoyer privatekey
Mot de passe ou clé perdune peut pas être restauréne peut pas être restaurée
Usageadresses de longue durée et de dépôtadresses 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.

Fenêtre de terminal
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"
}'

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.

Fenêtre de terminal
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.

ActionRequêteCorps
Changer le mot de passePOST /api/v2/ethereum/addresses/{address}old_password, new_password (tous deux obligatoires)
Exporter la clé privéePOST /api/v2/ethereum/addresses/export/{address}password
Importer une clé existantePOST /api/v2/ethereum/addresses/importaddress, privatekey, password (tous obligatoires)
Lister vos adressesGET /api/v2/ethereum/addressesaucun
Supprimer une adresseDELETE /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.

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.

Fenêtre de terminal
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é.

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.