ERC20- und TRC20-Token-Transfers senden
Um einen ERC20-, BEP20- oder TRC20-Token mit Chaingateway zu senden, schicken Sie Absender, Empfänger, Betrag und Contract-Adresse an den Token-Endpunkt der Chain. Dazu kommen Wallet-Passwort oder Private Key. Ein Token-Transfer ist ein Smart-Contract-Aufruf, daher braucht der Absender auch den nativen Coin der Chain für die Gebühr: ETH, BNB, MATIC oder TRX. Die Antwort enthält den Transaktions-Hash.
Zum API-Token siehe den Schnellstart. Auf Ethereum, BNB Smart Chain und Polygon muss die sendende Adresse mit der Chaingateway-API erstellt oder in sie importiert worden sein. Sonst schlägt die Signierung fehl. Adressen erstellen zeigt, wie Sie eine Adresse anlegen.
Welcher Endpunkt sendet einen Token auf welcher Chain?
Abschnitt betitelt „Welcher Endpunkt sendet einen Token auf welcher Chain?“Jede Chain hat einen eigenen Token-Endpunkt, benannt nach dem Token-Standard. Der Body ist auf allen EVM-Chains gleich.
| Blockchain | API-Route | 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 |
Um die Anfrage auf einem Testnetz auszuführen, fügen Sie den Header X-Network: testnet hinzu. Die Testnetze stehen unter Unterstützte Netzwerke. Für Bitcoin gibt es keinen Token-Endpunkt.
Wie sende ich einen ERC20- oder BEP20-Token?
Abschnitt betitelt „Wie sende ich einen ERC20- oder BEP20-Token?“Senden Sie die folgenden Felder an die Route Ihrer Chain. Das Beispiel sendet einen ERC20-Token auf Ethereum.
from: die Adresse des Absenders.to: die Adresse des Empfängers.amount: die Menge der zu sendenden Token.contractaddress: die Contract-Adresse des Tokens.password: das Wallet-Passwort, Pflicht, wennprivatekeyfehlt.privatekey: der Private Key des Absenders, für Adressen ohne Passwort.
gas, gasprice, maxPriorityFeePerGas, maxFeePerGas und nonce sind optional.
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();Der Code gibt den Transaktions-Hash zurück:
{ "status": 201, "ok": true, "message": "Succesfully created", "data": { "txid": "0x73344d178812d4919e9002c560781f288030edf72ece88823ef1c377dfb71f27" }}Wie sende ich einen TRC20-Token?
Abschnitt betitelt „Wie sende ich einen TRC20-Token?“Die TRC20-Anfrage funktioniert fast wie die ERC20-Anfrage. Die Route ist /api/v2/tron/transactions/trc20, die Adressen sind Tron-Adressen, und Sie signieren mit password oder privatekey. Die OpenAPI-Datei führt from, to, contractaddress und amount als Pflichtfelder auf. Das Beispiel nutzt den Private Key einer Adresse, die ohne Passwort erstellt wurde.
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"}'TRC20-Token-Transaktionen auf TRON erstellen führt durch den gesamten TRC20-Ablauf, einschließlich des Lesens des Contracts und der Endpunkte zum Selbst-Signieren.
Wie prüfe ich ein Token-Guthaben, bevor ich sende?
Abschnitt betitelt „Wie prüfe ich ein Token-Guthaben, bevor ich sende?“Lesen Sie zuerst das Guthaben, damit Sie keine Transaktion senden, die scheitert. Auf EVM-Chains gibt GET /api/v2/ethereum/balances/{address}/erc20/{contract_address} das Guthaben eines Tokens zurück. GET /api/v2/ethereum/balances/{address}/erc20 listet die Token-Guthaben eines Wallets auf. Auf BNB Smart Chain heißt das Segment bep20, auf Tron lautet der Aufruf GET /api/v2/tron/balances/{address}/trc20/{contract_address}. GET /api/v2/ethereum/erc20/{contract_address} liefert die Contract-Informationen eines Tokens.
Warum schlägt mein Token-Transfer fehl?
Abschnitt betitelt „Warum schlägt mein Token-Transfer fehl?“Die meisten Fehler haben eine von drei Ursachen, und jede hat eine andere Meldung.
- Ein falsches Passwort liefert den Status 401 mit
Wrong password provided. - Ein fehlendes oder falsch formatiertes Feld liefert den Status 422 mit
Data validation failedund dem Feldnamen inerrors. - Ein Absender ohne genug nativen Coin liefert den Status 422 mit der Meldung des Nodes, zum Beispiel
insufficient funds for gas * price + value. Auf Tron lautet das Gegenstückbalance is not sufficient.
Die letzte Ursache überrascht Nutzer, die nur Token halten: Die Gebühr wird in ETH, BNB, MATIC oder TRX bezahlt, nie im Token. Das Gebührenmodell der EVM-Chains steht in der Ethereum-Dokumentation zu Gas, Energy und Bandwidth erklärt das Ressourcenmodell von TRON. Halten Ihre TRON-Adressen Token, aber kein TRX, listet TRC20-Gebühren sponsern die Optionen auf.
Wie sende ich ein NFT?
Abschnitt betitelt „Wie sende ich ein NFT?“NFT-Transfers nutzen die ERC721-Endpunkte, zum Beispiel POST /api/v2/ethereum/transactions/erc721. Der Body hat dieselben Signaturfelder wie oben. Statt amount erwartet er tokenId, die ID des NFTs. from, contractaddress, to und tokenId sind Pflichtfelder. GET /api/v2/ethereum/nfts/{contract_address}/owner/{token_id} gibt den aktuellen Besitzer zurück, und .../uri/{token_id} gibt die Token-URI zurück. Der Standard ist in EIP-721 definiert.
Quellen
Abschnitt betitelt „Quellen“- EIP-20: Token Standard definiert
transferundbalanceOffür ERC-20-Token. - TRC20 protocol interface in der TRON-Entwicklerdokumentation.
- Gas and fees in der Ethereum-Entwicklerdokumentation.