Salta ai contenuti

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.

Wallet protetto da password: crei l'indirizzo con una password, Chaingateway memorizza la chiave cifrata, le transazioni successive sono firmate con la password invece che con la private key POST /api/v2/{chain}/addresses corpo: password La chiave è memorizzata cifrata Chaingateway non conserva copia della tuapassword POST /api/v2/{chain}/transactions corpo: from, to, amount, password La transazione è firmata e trasmessa risposta: txid
In questa modalità la private key non compare mai in una richiesta o in una risposta.

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 passwordNon protetto
Richiesta di creazioneil corpo contiene passwordnessuna password
Private key nella rispostanosì, una sola volta
Dove si trova la chiavecifrata presso Chaingatewaysolo presso di te
Firma di una transazioneinvii passwordinvii privatekey
Password o chiave persanon può essere ripristinatanon può essere ripristinata
Uso consigliatoindirizzi di lunga durata e di depositoindirizzi 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. :::

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.

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

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.

Terminal window
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.

AzioneRichiestaCorpo
Cambiare la passwordPOST /api/v2/ethereum/addresses/{address}old_password, new_password (entrambi obbligatori)
Esportare la private keyPOST /api/v2/ethereum/addresses/export/{address}password
Importare una chiave esistentePOST /api/v2/ethereum/addresses/importaddress, privatekey, password (tutti obbligatori)
Elencare i tuoi indirizziGET /api/v2/ethereum/addressesnessuno
Eliminare un indirizzoDELETE /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.

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.

Terminal window
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. :::

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.

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.