Creare indirizzi Ethereum e Tron
Crei un indirizzo con una sola richiesta: POST /api/v2/{chain}/addresses. Se il corpo contiene una password, Chaingateway memorizza la private key in forma crittografata e la risposta restituisce solo l’indirizzo. Senza password la risposta contiene la private key. Questo tutorial mostra entrambe le varianti per Ethereum e Tron. Le stesse richieste funzionano per BNB Smart Chain, Polygon e Arbitrum.
Per le chiamate seguenti serve un token API. La Guida rapida spiega come crearne uno.
Come creo un indirizzo protetto da password?
Sezione intitolata “Come creo un indirizzo protetto da password?”Invia il campo password nel corpo JSON. Per le chain EVM Chaingateway crea un keystore, un formato di file crittografato per una private key, descritto nella definizione Web3 secret storage. Il keystore è crittografato con la tua password. Chi ha solo il keystore o solo la password non può accedere all’indirizzo, e per le tue transazioni serve la password al posto della private key.
La password è un valore che scegli tu. Chaingateway non la memorizza e non può recuperarla. Se perdi la password, perdi l’accesso all’indirizzo: conservala in un password manager o in un secrets store.
curl --request POST \ --url https://app.chaingateway.io/api/v2/ethereum/addresses \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --data '{"password":"choose-a-strong-password"}'import requests
url = "https://app.chaingateway.io/api/v2/ethereum/addresses"payload = {"password": "choose-a-strong-password"}headers = { 'Accept': 'application/json', 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_API_TOKEN'}
response = requests.post(url, json=payload, headers=headers)print(response.json())const axios = require('axios');
const url = 'https://app.chaingateway.io/api/v2/ethereum/addresses';const payload = { password: 'choose-a-strong-password' };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); });<?phprequire 'vendor/autoload.php';
use GuzzleHttp\Client;
$client = new Client();$response = $client->post('https://app.chaingateway.io/api/v2/ethereum/addresses', [ 'headers' => [ 'Accept' => 'application/json', 'Authorization' => 'Bearer YOUR_API_TOKEN', ], 'json' => ['password' => 'choose-a-strong-password']]);
echo $response->getBody();La risposta ha status 201. Il file OpenAPI scrive la chiave dell’indirizzo come adderess:
{ "status": 201, "ok": true, "message": "Address created", "data": { "adderess": "0x7d3bC832A0860fD882FF4C2359e10268f4E5CCf8" }}Come creo un indirizzo senza password?
Sezione intitolata “Come creo un indirizzo senza password?”Ometti la password. La risposta contiene allora la private key, e ogni transazione dall’indirizzo richiede quella chiave in un campo privatekey. Usa questa modalità solo per indirizzi monouso, perché una private key che viaggia in ogni richiesta è facile da esporre. L’esempio crea un indirizzo Tron.
curl --request POST \ --url https://app.chaingateway.io/api/v2/tron/addresses \ --header 'Accept: application/json' \ --header 'Authorization: Bearer YOUR_API_TOKEN'import requests
url = "https://app.chaingateway.io/api/v2/tron/addresses"headers = { 'Accept': 'application/json', 'Authorization': 'Bearer YOUR_API_TOKEN'}
response = requests.post(url, headers=headers)print(response.json())const axios = require('axios');
const url = 'https://app.chaingateway.io/api/v2/tron/addresses';const headers = { 'Accept': 'application/json', 'Authorization': 'Bearer YOUR_API_TOKEN'};
axios.post(url, {}, { headers }) .then(response => { console.log(response.data); }) .catch(error => { console.error(error.response?.data ?? error); });<?phprequire 'vendor/autoload.php';
use GuzzleHttp\Client;
$client = new Client();$response = $client->post('https://app.chaingateway.io/api/v2/tron/addresses', [ 'headers' => [ 'Accept' => 'application/json', 'Authorization' => 'Bearer YOUR_API_TOKEN', ]]);
echo $response->getBody();Un indirizzo Tron creato senza password restituisce direttamente il materiale della chiave:
{ "status": 201, "ok": true, "message": "Address created", "data": { "privateKey": "59f1c6200e01a2ca9471411f10198bfa63678d0e87cc2ca30f9c4a68dee78edc", "publicKey": "040fe6e677442c36f7fdd5535ba3ff1cef0110d78363420f7e24b65298990e3467aed68b9a67e1396d84753db25b32a2fa3e1fc0a673f01638e9bcfab2d8f4ceb5", "hexAddress": "41a56a6505ffbee78eb916dd44f4846874deddaebd", "address": "TR3qx91smURF3R455V1ubqtoUsZbgqikfg" }}Conserva la privateKey insieme all’address in un luogo sicuro. La chiave in questo esempio è un valore di prova, quindi non accreditarvi mai fondi. La documentazione degli account di Tron spiega il rapporto tra l’indirizzo base58 e l’indirizzo hex.
Cosa faccio dopo aver creato l’indirizzo?
Sezione intitolata “Cosa faccio dopo aver creato l’indirizzo?”Leggi il saldo, accredita fondi sull’indirizzo e poi invia da lì. GET /api/v2/ethereum/balances/{address} restituisce il saldo dell’indirizzo come stringa:
{ "status": 200, "ok": true, "message": "Balance fetched", "data": "0.000000000000000000"}Un nuovo indirizzo parte con saldo zero. Invia monete da un wallet che controlli tu, oppure dal faucet testnet della chain se lavori con X-Network: testnet. GET /api/v2/ethereum/addresses elenca tutti gli indirizzi che hai creato e non hai eliminato. Se vuoi una notifica quando arrivano fondi, crea un webhook per l’indirizzo. L’invio di fondi dall’indirizzo è descritto in Creare transazioni.
Bitcoin e Solana funzionano diversamente. Su Bitcoin crei prima un wallet con POST /api/v2/bitcoin/wallets e poi vi aggiungi gli indirizzi. Su Solana POST /api/v2/solana/addresses crea l’indirizzo. Gestione wallet descrive entrambi i casi.
Quali errori può restituire la creazione di un indirizzo?
Sezione intitolata “Quali errori può restituire la creazione di un indirizzo?”Le chiamate sugli indirizzi usano l’envelope standard con ok impostato su false in caso di errore. Un token mancante o non valido restituisce lo status 401 con {"message":"Unauthenticated."}. Un corpo che non supera la validazione restituisce lo status 422 con Data validation failed e i nomi dei campi in errors. Quando il limite di indirizzi del tuo piano è esaurito, l’API risponde con lo status 422 e Your address limit exceeded. Please upgrade your plan. Il file OpenAPI mostra questo messaggio per i wallet Bitcoin.
DELETE /api/v2/ethereum/addresses/{address} rimuove un indirizzo e riduce il numero di indirizzi conteggiati nel tuo piano. Elimina gli indirizzi che non ti servono più, ma esporta prima la private key se l’indirizzo può contenere ancora fondi.
Come sono formattati gli indirizzi su ogni chain?
Sezione intitolata “Come sono formattati gli indirizzi su ogni chain?”Ethereum e le altre chain EVM usano indirizzi di 20 byte, scritti come 40 caratteri esadecimali con prefisso 0x. La documentazione sugli account Ethereum descrive come si ricava un account a controllo esterno da una coppia di chiavi. Gli indirizzi Tron iniziano con T e hanno 34 caratteri, il formato che l’API valida con il pattern T[a-zA-Z0-9]{33}. La documentazione degli account TRON è il riferimento primario per questo formato.