Zum Inhalt springen

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.

Token-Transfer: Token-Guthaben prüfen, sicherstellen, dass der Absender nativen Coin für die Gebühr hält, den Transfer mit der Contract-Adresse senden, den Transaktions-Hash lesen GET/api/v2/{chain}/balances/{address}/erc20/{contract} Hat der Absender genug Token? Absender hat nativen Coin für die Gebühr ETH, BNB, MATIC oder TRX POST /api/v2/{chain}/transactions/erc20 from, to, amount, contractaddress, passwordoder privatekey Antwort: txid Status 201
Guthaben- und Gebührenprüfung kommen vor dem Transfer.

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.

BlockchainAPI-RouteStandard
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

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.

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, wenn privatekey fehlt.
  • privatekey: der Private Key des Absenders, für Adressen ohne Passwort.

gas, gasprice, maxPriorityFeePerGas, maxFeePerGas und nonce sind optional.

Terminal-Fenster
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"
}'

Der Code gibt den Transaktions-Hash zurück:

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

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.

Terminal-Fenster
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.

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 failed und dem Feldnamen in errors.
  • 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ück balance 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.

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.