Portafogli Tron protetti da password via API
Crea portafogli Tron con una password: l'API non restituisce mai la chiave privata. Come creare, inviare, esportare e cambiare la password.
Verificato da Maurice Sobiera
Un portafoglio Tron protetto da password è un indirizzo che crei tramite l’API di Chaingateway con un parametro password. La chiave privata viene cifrata con quella password e non compare nella risposta. Per inviare dall’indirizzo passi la password al posto della chiave. Chaingateway non memorizza la password, quindi una password smarrita non può essere recuperata.
Cosa è cambiato con i portafogli protetti da password?
Fino al 18 febbraio 2025 gli indirizzi Tron creati tramite API restituivano la chiave privata nella risposta. Questo va bene per indirizzi temporanei, ma lascia la chiave nei tuoi log, nel tuo database e in ogni sistema che tocca la risposta. I portafogli protetti da password sono l’alternativa. La documentazione sulla gestione dei portafogli li indica come metodo consigliato e descrive la chiave come cifrata con la tua password e con i meccanismi di cifratura propri di Chaingateway. La variante non sicura esiste ancora: se ometti password, ottieni direttamente la chiave privata e devi conservarla tu.
Come si crea un portafoglio Tron protetto da password?
Invia una richiesta POST a /api/v2/tron/addresses con un password:
curl --request POST \ --url https://app.chaingateway.io/api/v2/tron/addresses \ --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "password": "your_secure_password" }'La risposta contiene il nuovo indirizzo in data. Non contiene la chiave privata. Usa una password lunga e casuale, generata da un gestore di password. La guida OWASP sull’autenticazione definisce deboli le password più corte di 15 caratteri quando nessun secondo fattore le protegge, e una password di portafoglio non ne ha. Conservala nel tuo archivio di segreti, perché la stessa password serve per ogni richiesta successiva su questo indirizzo.
Come si invia da un portafoglio protetto da password?
Passa il campo password al posto di privatekey. Un trasferimento di TRX richiede from, to, amount e password:
curl --request POST \ --url https://app.chaingateway.io/api/v2/tron/transactions \ --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "from": "TSenderAddress", "to": "TDestinationAddress", "amount": 100, "password": "your_secure_password"}'Lo stesso campo password funziona su POST /api/v2/tron/transactions/trc20, .../trc721 e .../trc10. I trasferimenti TRC20 richiedono anche un contractaddress. Un trasferimento TRC20 da un indirizzo senza TRX o Energy in staking fallisce con lo stato 422, come spiega il tutorial su TronFuel e Paymaster. Il Paymaster di Chaingateway è deprecato, e TronFuel è il modo consigliato per coprire la commissione.
Come si esporta la chiave, si cambia la password o si importa una chiave?
Altri tre endpoint completano il ciclo di vita del portafoglio. Ognuno riceve l’indirizzo nel percorso:
| Operazione | Richiesta | Corpo |
|---|---|---|
| Esportare la chiave privata | POST /api/v2/tron/addresses/export/{address} | password |
| Cambiare la password | POST /api/v2/tron/addresses/{address} | old_password, new_password |
| Importare una chiave esistente | POST /api/v2/tron/addresses/import | address, privatekey, password |
L’importazione serve a portare un indirizzo esistente e non protetto sotto protezione con password. Dopo l’importazione invia dall’indirizzo con la password e smetti di passare la chiave. Elimina la chiave dal tuo archivio una volta verificato un trasferimento di prova sulla testnet. L’esportazione è la via di uscita: ti consente di portare via la chiave dal servizio, e richiede la password.
Quali sono i limiti della protezione con password?
Un account Tron è controllato dalla sua chiave privata, come afferma la documentazione Tron, quindi è la chiave che devi proteggere. La password protegge la chiave a riposo. Non protegge un server compromesso che conosce già la password, e non aiuta in caso di password smarrita. Secondo la documentazione, Chaingateway non può ripristinare un portafoglio la cui password è stata persa. Salva la password e prova l’esportazione una volta prima di spostare fondi reali. Tieni i saldi elevati in un portafoglio la cui chiave possiedi tu, e usa i portafogli API come hot wallet con saldi limitati.
Prima di spostare fondi reali, esegui questa checklist:
- Crea un portafoglio sulla testnet e invia un piccolo trasferimento con la password.
- Esporta la chiave privata una volta e verifica che corrisponda all’indirizzo.
- Cambia la password e verifica che un invio con la vecchia password fallisca e uno con la nuova funzioni.
- Conserva la password nel tuo gestore di segreti e rimuovila dalla cronologia della shell e dai log.
Usa prima la testnet. Aggiungi l’header X-Network: testnet a ogni richiesta sopra, crea un portafoglio su Nile e prova creazione, invio, esportazione e cambio password. La pagina delle reti supportate elenca le reti di test, e la documentazione delle reti Tron spiega Nile e Shasta.
Quali domande ricorrono più spesso?
Un portafoglio con password funziona anche su altre catene?
Sì. La documentazione sulla gestione dei portafogli descrive il parametro password per /api/v2/{blockchain}/addresses, e il file OpenAPI elenca gli endpoint degli indirizzi con lo stesso schema per Ethereum, BNB Smart Chain, Polygon e Arbitrum.
Chaingateway può reimpostare una password smarrita?
No. La documentazione afferma che Chaingateway non può ripristinare la chiave privata di un portafoglio la cui password è stata persa. Esporta la chiave una volta e conservala nel tuo vault.
I webhook richiedono la password del portafoglio?
No. Un webhook controlla un indirizzo e richiede solo l’indirizzo, un URL e un filtro. La password serve per firmare le transazioni, esportare la chiave e cambiare la password.
Posso combinare portafogli protetti da password e portafogli non sicuri?
Sì. Ogni indirizzo viene creato con o senza password. In una richiesta invia password oppure privatekey, come descrive il file OpenAPI per gli endpoint delle transazioni.
Come scriviamo questi articoli
Pronto a costruirlo da solo? Ottieni la tua API key — prova di 7 giorni, senza carta — oppure consulta API Tron per il riferimento completo degli endpoint.