Salta ai contenuti

Inviare transfer di token ERC20 e TRC20

Per inviare un token ERC20, BEP20 o TRC20 con Chaingateway, invii mittente, destinatario, importo e indirizzo del contratto all’endpoint dei token della chain, con password o private key del wallet. Un trasferimento di token è una chiamata a uno smart contract: il mittente ha quindi bisogno anche della moneta nativa per la commissione (ETH, BNB, MATIC o TRX). La risposta restituisce l’hash della transazione.

Per il token API vedi la Guida rapida. Su Ethereum, BNB Smart Chain e Polygon l’indirizzo mittente deve essere stato creato con l’API Chaingateway o importato in essa. Altrimenti la firma fallisce. Creare indirizzi mostra come crearne uno.

Trasferimento di token: controlla il saldo del token, verifica che il mittente abbia moneta nativa per la commissione, invia il trasferimento con l'indirizzo del contratto, leggi l'hash della transazione GET/api/v2/{chain}/balances/{address}/erc20/{contract} il mittente ha abbastanza token? Il mittente ha moneta nativa per lacommissione ETH, BNB, MATIC o TRX POST /api/v2/{chain}/transactions/erc20 from, to, amount, contractaddress, password oprivatekey Risposta: txid status 201
Il controllo del saldo e quello della commissione vengono prima del trasferimento.

Ogni chain ha un proprio endpoint per i token, che prende il nome dallo standard del token. Il corpo è lo stesso su tutte le chain 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

Per eseguire la richiesta su una rete di test, aggiungi l’header X-Network: testnet. Le testnet sono elencate in Reti supportate. Bitcoin non ha un endpoint per i token.

Invia i campi seguenti alla route della tua chain. L’esempio invia un token ERC20 su Ethereum.

  • from: l’indirizzo del mittente.
  • to: l’indirizzo del destinatario.
  • amount: la quantità di token da inviare.
  • contractaddress: l’indirizzo del contratto del token.
  • password: la password del wallet, obbligatoria se privatekey non è presente.
  • privatekey: la private key del mittente, per gli indirizzi creati senza password.

gas, gasprice, maxPriorityFeePerGas, maxFeePerGas e nonce sono facoltativi.

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

Il codice restituisce l’hash della transazione:

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

La richiesta TRC20 funziona quasi come quella ERC20. La route è /api/v2/tron/transactions/trc20, gli indirizzi sono indirizzi Tron e firmi con password o privatekey. Il file OpenAPI indica from, to, contractaddress e amount come obbligatori. L’esempio usa la private key di un indirizzo creato senza password.

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

Creare transazioni di token TRC20 percorre l’intero flusso TRC20, inclusa la lettura del contratto e gli endpoint con firma autonoma.

Come controllo il saldo di un token prima di inviare?

Sezione intitolata “Come controllo il saldo di un token prima di inviare?”

Leggi prima il saldo, così non invii una transazione destinata a fallire. Sulle chain EVM, GET /api/v2/ethereum/balances/{address}/erc20/{contract_address} restituisce il saldo di un token. GET /api/v2/ethereum/balances/{address}/erc20 elenca i saldi dei token di un wallet. Su BNB Smart Chain il segmento è bep20, e su Tron è GET /api/v2/tron/balances/{address}/trc20/{contract_address}. GET /api/v2/ethereum/erc20/{contract_address} restituisce le informazioni sul contratto di un token.

La maggior parte dei fallimenti ha una di tre cause, ciascuna con un messaggio diverso.

  • Una password errata restituisce lo status 401 con Wrong password provided.
  • Un campo mancante o malformato restituisce lo status 422 con Data validation failed e il nome del campo in errors.
  • Un mittente senza abbastanza moneta nativa restituisce lo status 422 con il messaggio del nodo, ad esempio insufficient funds for gas * price + value. Su Tron l’equivalente è balance is not sufficient.

L’ultima causa sorprende chi possiede solo token: la commissione si paga in ETH, BNB, MATIC o TRX, mai nel token. Leggi la documentazione Ethereum sul gas per il modello di commissioni sulle chain EVM e il modello di risorse di TRON per energy e bandwidth. Se i tuoi indirizzi TRON contengono token ma nessun TRX, Sponsorizzare commissioni TRC20 elenca le opzioni.

I trasferimenti di NFT usano gli endpoint ERC721, ad esempio POST /api/v2/ethereum/transactions/erc721. Il corpo ha gli stessi campi di firma visti sopra, ma al posto di amount accetta tokenId, l’ID dell’NFT. from, contractaddress, to e tokenId sono obbligatori. GET /api/v2/ethereum/nfts/{contract_address}/owner/{token_id} restituisce il proprietario attuale, e .../uri/{token_id} restituisce l’URI del token. Lo standard è definito in EIP-721.