Salta ai contenuti

Inviare transazioni ETH, BNB, TRX e BTC

Per inviare una moneta nativa con Chaingateway, invii mittente, destinatario, importo e un segreto di firma a POST /api/v2/{chain}/transactions. Chaingateway firma la transazione, la trasmette e restituisce l’ID della transazione (txid). Il segreto di firma è la password del wallet, oppure la privatekey per gli indirizzi senza password. Il tutorial copre ETH, BNB, MATIC, TRX, BTC e SOL.

I token come USDT usano altri endpoint, descritti in Creare transazioni di token. Servono un token API e un indirizzo con fondi, vedi Guida rapida e Creare indirizzi.

Invio di una moneta nativa: invii from, to, amount e password o private key, Chaingateway firma e trasmette la transazione, la risposta restituisce il txid, poi leggi lo stato della transazione POST /api/v2/{chain}/transactions from, to, amount, password o privatekey Chaingateway firma e trasmette Risposta: txid status 201, message Succesfully createdtransaction GET /api/v2/{chain}/transactions/{txid} controlla la transazione sulla chain
I quattro passaggi sono gli stessi su ogni chain, cambiano solo i campi del corpo.

Usa l’endpoint della chain: /ethereum, /bsc, /polygon o /arbitrum. Il corpo per le chain EVM ha tre campi obbligatori e un segreto di firma.

CampoObbligatorioSignificato
fromsìIndirizzo del mittente, validato come 40 caratteri esadecimali con 0x facoltativo.
tosìIndirizzo del destinatario, stesso formato.
amountsìL’importo da inviare.
passworduno dei duePassword del wallet. Obbligatoria se privatekey non è presente.
privatekeyuno dei duePrivate key del mittente, per gli indirizzi creati senza password.
gas, gasprice, maxPriorityFeePerGas, maxFeePerGas, nonce, datanoImpostazioni facoltative della transazione.

Invia prima un importo piccolo sulla testnet, con l’header X-Network: testnet, e confronta la variazione del saldo prima di spostare fondi reali. L’unità di amount segue il riferimento API dell’endpoint, quindi verificala lì. L’header di autorizzazione contiene il tuo token: Authorization: Bearer YOUR_API_TOKEN.

Terminal window
curl --request POST \
--url https://app.chaingateway.io/api/v2/ethereum/transactions \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--data '{
"from": "0xYourSenderAddress",
"to": "0xRecipientAddress",
"amount": "0.1",
"password": "YourPassword"
}'

Una chiamata riuscita risponde con lo status 201 e l’hash della transazione:

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

POST /api/v2/tron/transactions accetta from, to e amount, più password o privatekey. Gli indirizzi Tron devono corrispondere al pattern T seguito da 33 caratteri alfanumerici. Il mittente ha bisogno di TRX sufficienti per l’importo e per le risorse di rete usate dal trasferimento, come descrive il modello di risorse di TRON.

Terminal window
curl --request POST \
--url https://app.chaingateway.io/api/v2/tron/transactions \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--data '{
"from": "YourSenderAddress",
"to": "RecipientAddress",
"amount": 1,
"privatekey": "YourPrivateKey"
}'

La risposta ha la stessa forma di quella EVM sopra, con l’hash della transazione in data.txid. Se firmi le transazioni nel tuo codice, POST /api/v2/tron/transactions/build restituisce una transazione non firmata e POST /api/v2/tron/transactions/broadcast accetta quella firmata nel campo signed_transaction.

Bitcoin invia da un wallet, non da un singolo indirizzo. POST /api/v2/bitcoin/transactions richiede to, amount, walletname, password e speed. Il valore di speed è fast, medium o slow e determina il livello della commissione. Il campo facoltativo subtractfee sottrae la commissione dall’importo invece di aggiungerla.

Terminal window
curl --request POST \
--url https://app.chaingateway.io/api/v2/bitcoin/transactions \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--data '{
"to": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",
"amount": 0.0001,
"walletname": "mywallet",
"password": "YourWalletPassword",
"speed": "medium",
"subtractfee": false
}'

Gli indirizzi Bitcoin sono validati con il pattern (bc1|tb1|[13]) seguito da 25-39 caratteri, che accetta i formati mainnet e testnet. La guida per sviluppatori Bitcoin sulle transazioni spiega input, output e commissioni.

POST /api/v2/solana/transactions accetta from, to, amount e la privatekey del mittente. Il file OpenAPI li indica tutti e quattro come obbligatori e per Solana non prevede la modalità con password. I token SPL usano POST /api/v2/solana/transactions/SPL con il campo aggiuntivo contractaddress, che contiene l’indirizzo mint del token.

Non è necessario, perché gas, gasprice, maxPriorityFeePerGas e maxFeePerGas sono facoltativi. Per impostarli tu, leggi il prezzo corrente con GET /api/v2/ethereum/gasprice, che restituisce in data un valore come {"gasPrice":"12.28"}. I due campi max corrispondono ai parametri di commissione di EIP-1559. La documentazione Ethereum sulle transazioni elenca tutti i campi di una transazione, incluso nonce.

Come verifico che la transazione sia andata a buon fine?

Sezione intitolata “Come verifico che la transazione sia andata a buon fine?”

Usa il txid della risposta. GET /api/v2/ethereum/transactions/{txid} restituisce la transazione, e GET /api/v2/ethereum/transactions/{txid}/decoded la restituisce con i dati di input decodificati. Un hash di transazione sconosciuto al nodo risponde con lo status 422 e il messaggio transaction not found. Per sapere quando arrivano fondi, crea un webhook invece di fare polling.

Gli errori usano lo stesso envelope delle chiamate riuscite, con ok impostato su false.

StatusMessaggioCausa
401Wrong password providedLa password non corrisponde all’indirizzo.
422insufficient funds for gas * price + value: ...Il saldo non copre l’importo più la commissione.
422Data validation failedUn campo manca o ha il formato sbagliato. L’oggetto errors lo indica.
422Error: The wallet passphrase entered was incorrect.Bitcoin: la password del wallet è sbagliata.

Chaingateway non memorizza le tue password né le private key degli indirizzi non protetti. Se le perdi, nessuno può recuperare i fondi sull’indirizzo. Conservale entrambe in un secrets store e mai nel codice lato client.