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.
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.
| Blockchain | Route API | Standard |
|---|---|---|
| Ethereum | /api/v2/ethereum/transactions/erc20 | ERC-20 |
| Binance Smart Chain | /api/v2/bsc/transactions/bep20 | BEP20 |
| Polygon | /api/v2/polygon/transactions/erc20 | ERC-20 |
| Arbitrum | /api/v2/arbitrum/transactions/erc20 | ERC-20 |
| Tron | /api/v2/tron/transactions/trc20 | TRC20 |
| Solana | /api/v2/solana/transactions/SPL | SPL |
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.
Comment envoyer un token ERC20 ou BEP20 ?
Section intitulée « Comment envoyer un token ERC20 ou BEP20 ? »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 quandprivatekeyest 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.
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" }'const axios = require('axios');
const url = 'https://app.chaingateway.io/api/v2/ethereum/transactions/erc20';const payload = { from: '0xYourSenderAddress', to: '0xRecipientAddress', amount: 100, contractaddress: '0xTokenContractAddress', password: 'YourPassword'};const headers = { 'Accept': 'application/json', 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_API_TOKEN'};
axios.post(url, payload, { headers }) .then(response => { console.log(response.data); }) .catch(error => { console.error(error.response?.data ?? error); });import requests
url = "https://app.chaingateway.io/api/v2/ethereum/transactions/erc20"payload = { "from": "0xYourSenderAddress", "to": "0xRecipientAddress", "amount": 100, "contractaddress": "0xTokenContractAddress", "password": "YourPassword"}headers = { 'Accept': 'application/json', 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_API_TOKEN'}
response = requests.post(url, json=payload, headers=headers)print(response.json())<?phprequire 'vendor/autoload.php';
use GuzzleHttp\Client;
$client = new Client();$response = $client->post('https://app.chaingateway.io/api/v2/ethereum/transactions/erc20', [ 'headers' => [ 'Accept' => 'application/json', 'Authorization' => 'Bearer YOUR_API_TOKEN', ], 'json' => [ 'from' => '0xYourSenderAddress', 'to' => '0xRecipientAddress', 'amount' => 100, 'contractaddress' => '0xTokenContractAddress', 'password' => 'YourPassword' ]]);
echo $response->getBody();Le code renvoie le hash de la transaction :
{ "status": 201, "ok": true, "message": "Succesfully created", "data": { "txid": "0x73344d178812d4919e9002c560781f288030edf72ece88823ef1c377dfb71f27" }}Comment envoyer un token TRC20 ?
Section intitulée « Comment envoyer un token TRC20 ? »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.
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.
Pourquoi mon transfert de token échoue-t-il ?
Section intitulée « Pourquoi mon transfert de token échoue-t-il ? »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 failedet le nom du champ danserrors. - 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 estbalance 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.
Comment envoyer un NFT ?
Section intitulée « Comment envoyer un NFT ? »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.
- EIP-20: Token Standard définit
transferetbalanceOfpour les tokens ERC-20. - TRC20 protocol interface dans la documentation développeur de TRON.
- Gas and fees dans la documentation développeur d’Ethereum.