Gestione wallet e memorizzazione delle chiavi
Un wallet in Chaingateway è un indirizzo la cui private key è memorizzata cifrata dietro una password scelta da te, oppure restituita una sola volta e conservata solo da te. Chaingateway non memorizza la tua password, quindi non può ripristinare una chiave persa. Scegli la modalità quando crei l’indirizzo: invia una password per quella protetta, omettila per quella non protetta.
Qual è la differenza tra wallet protetti da password e non protetti?
Sezione intitolata “Qual è la differenza tra wallet protetti da password e non protetti?”Nella modalità protetta Chaingateway cifra la private key con la tua password e con la propria catena di cifratura. Nella modalità non protetta la chiave viene restituita nella risposta di creazione e la invii a ogni transazione. La tabella confronta le due modalità.
| Protetto da password | Non protetto | |
|---|---|---|
| Richiesta di creazione | il corpo contiene password | nessuna password |
| Private key nella risposta | no | sì, una sola volta |
| Dove si trova la chiave | cifrata presso Chaingateway | solo presso di te |
| Firma di una transazione | invii password | invii privatekey |
| Password o chiave persa | non può essere ripristinata | non può essere ripristinata |
| Uso consigliato | indirizzi di lunga durata e di deposito | indirizzi temporanei e monouso |
::: danger Conserva la tua password in modo sicuro Non memorizziamo mai le password, quindi se perdi la password non possiamo ripristinare la private key del tuo wallet. Conserva la password in un gestore di segreti, non nel repository. :::
Come creo un wallet protetto da password?
Sezione intitolata “Come creo un wallet protetto da password?”Invia una richiesta POST a /api/v2/{blockchain}/addresses con una password nel corpo JSON. Sostituisci {blockchain} con ethereum, bsc, polygon, arbitrum o tron. L’esempio crea un indirizzo Ethereum.
curl --request POST \ --url https://app.chaingateway.io/api/v2/ethereum/addresses \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "password": "choose-a-strong-password"}'<?php$ch = curl_init();curl_setopt($ch, CURLOPT_URL, 'https://app.chaingateway.io/api/v2/ethereum/addresses');curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);curl_setopt($ch, CURLOPT_POST, 1);curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(["password" => "choose-a-strong-password"]));curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Authorization: Bearer YOUR_API_TOKEN', 'Content-Type: application/json']);$response = curl_exec($ch);curl_close($ch);echo $response;fetch('https://app.chaingateway.io/api/v2/ethereum/addresses', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ password: 'choose-a-strong-password' })}).then(response => response.json()).then(data => console.log(data));import requestsheaders = { 'Authorization': 'Bearer YOUR_API_TOKEN', 'Content-Type': 'application/json'}data = {"password": "choose-a-strong-password"}response = requests.post('https://app.chaingateway.io/api/v2/ethereum/addresses', headers=headers, json=data)print(response.json())La risposta contiene il nuovo indirizzo. Il file OpenAPI scrive la chiave come adderess:
{ "status": 201, "ok": true, "message": "Address created", "data": { "adderess": "0x7d3bC832A0860fD882FF4C2359e10268f4E5CCf8" }}Per inviare dall’indirizzo, passa la stessa password nella richiesta di transazione. La private key non fa parte della richiesta. Una password errata restituisce lo stato 401 con il messaggio Wrong password provided.
curl --request POST \ --url https://app.chaingateway.io/api/v2/ethereum/transactions \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "from": "0xSenderAddress", "to": "0xRecipientAddress", "amount": "0.1", "password": "choose-a-strong-password"}'Come cambio la password, esporto la chiave o importo una chiave esistente?
Sezione intitolata “Come cambio la password, esporto la chiave o importo una chiave esistente?”Ognuna di queste azioni corrisponde a un endpoint per chain. I percorsi seguenti usano ethereum e gli stessi percorsi esistono per bsc, polygon e arbitrum. Tron offre le stesse operazioni sugli indirizzi, tranne l’elenco degli indirizzi.
| Azione | Richiesta | Corpo |
|---|---|---|
| Cambiare la password | POST /api/v2/ethereum/addresses/{address} | old_password, new_password (entrambi obbligatori) |
| Esportare la private key | POST /api/v2/ethereum/addresses/export/{address} | password |
| Importare una chiave esistente | POST /api/v2/ethereum/addresses/import | address, privatekey, password (tutti obbligatori) |
| Elencare i tuoi indirizzi | GET /api/v2/ethereum/addresses | nessuno |
| Eliminare un indirizzo | DELETE /api/v2/ethereum/addresses/{address} | nessuno |
La modifica della password è una POST, non una PUT né una PATCH. Importare una chiave trasforma un indirizzo esistente in uno protetto da password: è il modo per usare la modalità protetta con un indirizzo creato altrove o in modalità non protetta. La risposta dell’esportazione restituisce la chiave come data.private_key. Eliminare un indirizzo riduce il numero di indirizzi conteggiati nel tuo piano.
Quando devo usare un wallet non protetto?
Sezione intitolata “Quando devo usare un wallet non protetto?”Usa un wallet non protetto solo per indirizzi temporanei o monouso. Se ometti la password, la risposta di creazione contiene la private key e devi conservarla tu. Chiunque ottenga la chiave controlla tutti i fondi dell’indirizzo, e una chiave che invii a ogni transazione compare in ogni richiesta che fai. La richiesta seguente crea un indirizzo Tron senza password.
curl --request POST \ --url https://app.chaingateway.io/api/v2/tron/addresses \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --header 'Content-Type: application/json'La risposta contiene privateKey, publicKey, hexAddress e address. Conserva la chiave prima di fare qualsiasi altra cosa, perché ti serve per ogni transazione successiva. Per inviare da un indirizzo di questo tipo, passa privatekey invece di password nel corpo della transazione. I trasferimenti TRX e TRC20 su Tron sono descritti in Creare transazioni e Creare transazioni di token.
::: danger Da usare solo per wallet non permanenti Poiché la private key è inclusa nella risposta, è tua responsabilità conservarla e proteggerla. Se qualcuno ottiene l’accesso alla tua private key, può controllare tutti i fondi nel wallet. :::
Come funzionano i wallet su Bitcoin e Solana?
Sezione intitolata “Come funzionano i wallet su Bitcoin e Solana?”Bitcoin e Solana non usano l’endpoint addresses allo stesso modo delle chain EVM e di Tron.
Su Bitcoin un wallet è un contenitore di indirizzi. POST /api/v2/bitcoin/wallets con una password crea il wallet e ne restituisce l’identificativo come data.bitcoinwallet. POST /api/v2/bitcoin/wallets/{wallet}/addresses aggiunge poi indirizzi al wallet, e POST /api/v2/bitcoin/wallets/{wallet}/addresses/{address}/export esporta la chiave di un indirizzo con la password del wallet. Una transazione Bitcoin indica il wallet in walletname e invia la password del wallet. Quando il limite di indirizzi del piano è raggiunto, l’API risponde con lo stato 422 e il messaggio Your address limit exceeded. Please upgrade your plan.
Su Solana POST /api/v2/solana/addresses crea un indirizzo, e ogni richiesta di transazione porta la privatekey del mittente. Nel file OpenAPI non esiste una modalità con password per le transazioni Solana, quindi la gestione della chiave resta a tuo carico.
Come devo conservare chiavi e password?
Sezione intitolata “Come devo conservare chiavi e password?”Tratta il token API, le password dei wallet e le private key come tre segreti distinti. Non conservarli nello stesso posto e non registrare nei log i corpi delle richieste che li contengono. L’OWASP Key Management Cheat Sheet copre il ciclo di vita della chiave, dalla generazione alla conservazione e al ritiro. Per il formato della chiave cifrata, Ethereum documenta la definizione Web3 secret storage, che descrive come una password cifra una chiave. La guida ai wallet Bitcoin descrive come i wallet memorizzano e derivano le chiavi.