Aller au contenu

Envoyer des tokens ERC20 et TRC20

Pour envoyer un token ERC20, BEP20 ou TRC20, postez à l’endpoint de token de la chaîne l’émetteur, le destinataire, le montant, l’adresse de contrat et le mot de passe ou la clé privée. L’émetteur doit aussi détenir du coin natif pour les frais (ETH, BNB, MATIC ou TRX), car un transfert est un appel de smart contract. La réponse renvoie le hash.

Pour le token API, voir le Démarrage rapide. Sur Ethereum, BNB Smart Chain et Polygon, l’adresse émettrice doit avoir été créée avec l’API Chaingateway ou importée dans celle-ci. Sinon, l’étape de signature échoue. Créer des adresses montre comment en créer une.

Transfert de token : vérifier le solde en tokens, s'assurer que l'émetteur détient du coin natif pour les frais, envoyer le transfert avec l'adresse de contrat, lire le hash de la transaction GET/api/v2/{chain}/balances/{address}/erc20/{contract} l'émetteur détient-il assez de tokens ? L'émetteur détient du coin natif pourles frais ETH, BNB, MATIC ou TRX POST /api/v2/{chain}/transactions/erc20 from, to, amount, contractaddress, password ouprivatekey Réponse : txid statut 201
La vérification du solde et celle des frais précèdent le transfert.

Quel endpoint envoie un token sur quelle chaîne ?

Section intitulée « Quel endpoint envoie un token sur quelle chaîne ? »

Chaque chaîne a son propre endpoint de token, nommé d’après le standard du token. Le corps est identique sur toutes les chaînes EVM.

BlockchainRoute APIStandard
Ethereum/api/v2/ethereum/transactions/erc20ERC-20
Binance Smart Chain/api/v2/bsc/transactions/bep20BEP20
Polygon/api/v2/polygon/transactions/erc20ERC-20
Arbitrum/api/v2/arbitrum/transactions/erc20ERC-20
Tron/api/v2/tron/transactions/trc20TRC20
Solana/api/v2/solana/transactions/SPLSPL

Pour exécuter la requête sur un réseau de test, ajoutez l’en-tête X-Network: testnet. Les testnets sont listés sous Réseaux pris en charge. Bitcoin n’a pas d’endpoint de token.

Envoyez les champs suivants à la route de votre chaîne. L’exemple envoie un token ERC20 sur Ethereum.

  • from : l’adresse de l’émetteur.
  • to : l’adresse du destinataire.
  • amount : le nombre de tokens à envoyer.
  • contractaddress : l’adresse de contrat du token.
  • password : le mot de passe du wallet, obligatoire quand privatekey est absent.
  • privatekey : la clé privée de l’émetteur, pour les adresses créées sans mot de passe.

gas, gasprice, maxPriorityFeePerGas, maxFeePerGas et nonce sont facultatifs.

Fenêtre de terminal
curl --request POST \
--url https://app.chaingateway.io/api/v2/ethereum/transactions/erc20 \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--data '{
"from": "0xYourSenderAddress",
"to": "0xRecipientAddress",
"amount": 100,
"contractaddress": "0xTokenContractAddress",
"password": "YourPassword"
}'

Le code renvoie le hash de la transaction :

{
"status": 201,
"ok": true,
"message": "Succesfully created",
"data": {
"txid": "0x73344d178812d4919e9002c560781f288030edf72ece88823ef1c377dfb71f27"
}
}

La requête TRC20 fonctionne presque comme la requête ERC20. La route est /api/v2/tron/transactions/trc20, les adresses sont des adresses Tron, et vous signez avec password ou privatekey. Le fichier OpenAPI indique from, to, contractaddress et amount comme obligatoires. L’exemple utilise la clé privée d’une adresse créée sans mot de passe.

Fenêtre de terminal
curl --request POST \
--url https://app.chaingateway.io/api/v2/tron/transactions/trc20 \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--data '{
"from": "TYourSenderAddress",
"to": "TRecipientAddress",
"amount": 100,
"contractaddress": "TTokenContractAddress",
"privatekey": "YourPrivateKey"
}'

Transactions de tokens TRC20 sur TRON parcourt tout le flux TRC20, y compris la lecture du contrat et les endpoints de signature autonome.

Comment vérifier le solde en tokens avant d’envoyer ?

Section intitulée « Comment vérifier le solde en tokens avant d’envoyer ? »

Lisez d’abord le solde, pour ne pas envoyer une transaction qui échouera. Sur les chaînes EVM, GET /api/v2/ethereum/balances/{address}/erc20/{contract_address} renvoie le solde d’un token. GET /api/v2/ethereum/balances/{address}/erc20 liste les soldes en tokens d’un wallet. Sur BNB Smart Chain, le segment est bep20, et sur Tron c’est GET /api/v2/tron/balances/{address}/trc20/{contract_address}. GET /api/v2/ethereum/erc20/{contract_address} renvoie les informations de contrat d’un token.

La plupart des échecs ont l’une de trois causes, chacune avec un message différent.

  • Un mauvais mot de passe renvoie le statut 401 avec Wrong password provided.
  • Un champ manquant ou mal formé renvoie le statut 422 avec Data validation failed et le nom du champ dans errors.
  • Un émetteur sans assez de coin natif renvoie le statut 422 avec le message du nœud, par exemple insufficient funds for gas * price + value. Sur Tron, l’équivalent est balance is not sufficient.

La dernière cause surprend ceux qui ne détiennent que des tokens : les frais se paient en ETH, BNB, MATIC ou TRX, jamais en token. Lisez la documentation Ethereum sur le gas pour le modèle de frais des chaînes EVM et le modèle de ressources de TRON pour l’energy et la bande passante. Si vos adresses TRON détiennent des tokens mais pas de TRX, Frais TRC20 : TronFuel, Paymaster liste les options.

Les transferts de NFT utilisent les endpoints ERC721, par exemple POST /api/v2/ethereum/transactions/erc721. Le corps contient les mêmes champs de signature que ci-dessus, mais au lieu de amount il prend tokenId, l’identifiant du NFT. from, contractaddress, to et tokenId sont obligatoires. GET /api/v2/ethereum/nfts/{contract_address}/owner/{token_id} renvoie le propriétaire actuel, et .../uri/{token_id} renvoie l’URI du token. Le standard est défini dans l’EIP-721.