Guida: Integrare Ledger Nano con la dApp di NNS
Come iniziare a utilizzare un wallet Ledger per gestire i token ICP e i neurons del Network Nervous System.
Ledger è uno degli hardware wallet più popolari al mondo per la custodia in sicurezza degli asset crypto.
Il lancio dell’app Internet Computer (ICP) di Ledger dà a tutti i token holders un ulteriore possibilità per custodire, gestire e mettere in staking i propri tokens e neurons (Network Nervous System).
La dApp NNS è compatibile con i wallet Ledger Nano S/X.
⚠ La documentazione completa della dApp NNS è disponibile qui.
Questa riguarda solo le modalità di integrazione degli hardware wallet di Ledger
📄Indice
- Connettere Ledger alla dApp NNS
- Richieste di approvazione
- Verificare Address e Principal ID
- Gestione dei fondi
— Inviare ICP - Gestione dei Neurons
— Staking
— Aumento del Dissolve Delay
— Aggiungere/Rimuovere le HotKeys
— Erogazione
— Spawning
— Listing Neurons
1. Connettere Ledger alla dApp NNS
La prima cosa che ci occorre per iniziare la procedura di integrazione è sicuramente un wallet Ledger impostato e funzionate.
Se sei un nuovo utente Ledger e non sai come inizializzare il tuo wallet consulta la Documentazione ufficiale Ledger.
Una volta scaricata Ledger Live ed impostato il tuo hardware wallet dobbiamo installare l’app di Internet Computer (ICP) cercandola nell’ “App Catalog” di Ledger Live.
Terminato il processo di installazione siamo pronti per l’integrazione: chiudiamo Ledger Live ed apriamo la NNS dApp.
⚠ Al momento i browser supportati sono Chrome (desktop) v89+, Edge v89+ e Opera v76+.
Cliccando su Login ci verrà richiesto di accedere attraverso la Internet Identity: esegui l’autenticazione con i tuoi dati o crea un nuovo account se non ne possiedi ancora uno.
I. Aggiungere un account clickando su “Add Account”
II. Selezionare “Attach Hardware Wallet”.
III. Assegnare un nome all’ hardware wallet. Poi fare click su “Connect to Wallet”.
⚠ ATTENZIONE: Assicurati che il tuo Ledger sia connesso al computer, sbloccato e che l’app Internet Computer (ICP) sia in esecuzione sul tuo device. Se una di queste condizioni non viene rispettata il browser vi mostrerà una finestra di errore che impedirà di proseguire.
IV. Il browser visualizzerà una finestra con i dispositivi disponibili, selezionare l’hardware wallet che si desidera connettere e fare click su “Connect”
V. Verificare le informazioni dell’ hardware wallet e fare click su “Attach Wallet”.
VI. Ben fatto, operazione completata! Verrai reindirizzato alla pagina Account del wallet.
2. Richieste di approvazione
Per ragioni progettuali, tutte le transazioni che cambiano lo stato di Internet Computer sono asincrone, di conseguenza anche tutte le transazioni del wallet Ledger sono asincrone.
Questo significa che per ogni transazione sarà necessario approvare due transazioni:
- La transazione che cambia lo stato (es. “Send ICP”, “Stake Neuron”).
- La transazione “Check Status”. Questa transazione, che appare pochi secondi dopo la prima, è necessaria per ottenere e leggere il risultato.
3. Verificare Address e Principal ID
Per verificare che l’accress visualizzato nella dApp NNS è lo stesso del wallet selezionare “Show Principal And Address On Device”.
Gli indirizzi saranno visualizzati sullo schermo del Ledger.
4. Gestione dei Fondi
Inviare ICP
I. Nella pagina principale selezionare “New Transaction”
II. Selezionare l’account da cui inviare i fondi
III. Inserire l’address del destinatario, o selezionare uno degli account esistenti in elenco.
IV. Inserire il quantitativo da inviare e fare click su “Review Transaction”
⚠ ATTENZIONE: Assicurati che il tuo Ledger sia connesso al computer, sbloccato e che l’app Internet Computer (ICP) sia in esecuzione sul tuo device. Se una di queste condizioni non viene rispettata il browser vi mostrerà una finestra di errore che impedirà di proseguire.
V. Controllare tutti i dati inseriti quindi fare click su “Confirm and Send”
VI. Sullo schermo del Ledger comparirà la richiesta di verifica della transazione, controllare i dati e verificare la transazione tramite il device.
(Ricorda: verrà richiesta la verifica di due transazioni, assicurati di verificarle entrambe)
VII. Una volta confermata la transazione sul Ledger la dApp visualizzerà la conferma di completamento della transazione.
5. Gestione dei Neurons
— Staking
I. Selezionare la pagina NEURONS e selezionare “Stake Neuron”
II. Selezionare l’account da cui prelevare gli ICP
III. Inserire il numero di ICP desiderato (min 1 ICP), quindi fare click su “Create”
⚠ ATTENZIONE: Assicurati che il tuo Ledger sia connesso al computer, sbloccato e che l’app Internet Computer (ICP) sia in esecuzione sul tuo device. Se una di queste condizioni non viene rispettata il browser vi mostrerà una finestra di errore che impedirà di proseguire.
IV. Sullo schermo del Ledger comparirà la richiesta di verifica della transazione, controllare i dati e verificare la transazione tramite il device.
(Ricorda: verrà richiesta la verifica di due transazioni, assicurati di verificarle entrambe)
N.B. Nonostante il Neuron sia stato creato la dApp NNS non ha ancora i permessi per leggerlo e visualizzarlo sull’interfaccia.
V. Per farlo è necessario aggiungere la dApp NNS come HotKey, quindi nella schermata successiva selezionare “Add NNS dapp as hotkey”.
Se si sceglierà di saltare questo passaggio (selezionando “Skip”) si potrà aggiungere come HotKey la dApp NNS seguendo il processo di “Listing Neurons”.
VI. Sullo schermo del Ledger comparirà la richiesta di verifica della transazione, controllare i dati e verificare la transazione tramite il device.
Una volta approvata la transazione il Neuron creato sarà visualizzato nella dashboard della sezione NEURONS.
— Aumentare il Dissolve Delay
Quando un Neuron viene messo in stake, verrà chiesto di impostare un Dissolve Deleay (ritardo -tempo- di dissolvenza).
I. È possibile regolare il dissolve delay anche dalla pagina del singolo neuron selezionando “Increase Dissolve Delay”
II. Impostare il tempo desiderato, poi fare click su “Update Delay”.
⚠ ATTENZIONE: Assicurati che il tuo Ledger sia connesso al computer, sbloccato e che l’app Internet Computer (ICP) sia in esecuzione sul tuo device. Se una di queste condizioni non viene rispettata il browser vi mostrerà una finestra di errore che impedirà di proseguire.
III. Approvare la transazione tramite Ledger
Una volta approvata la transazione, sarà possibile visualizzare il dissolve delay aggiornato nella pagina del Neuron.
— Aggiungere Hotkeys
I. Le Hotkeys possono essere aggiunte ad un neuron clickando sul tasto “Add Hotkey” button nella pagina del Neuron.
II. Inserire il Principal ID della hotkey e fare click “Confirm”.
⚠ ATTENZIONE: Assicurati che il tuo Ledger sia connesso al computer, sbloccato e che l’app Internet Computer (ICP) sia in esecuzione sul tuo device. Se una di queste condizioni non viene rispettata il browser vi mostrerà una finestra di errore che impedirà di proseguire.
III. Approvare la transazione tramite il Ledger
Una volta approvata la transazione la hotkey verrà aggiunta al Neuron.
— Rimuovere Hotkeys
I. Le Hotkeys possono essere aggiunte ad un neuron clickando sul tasto “Add Hotkey” button nella pagina del Neuron.
⚠ ATTENZIONE: Assicurati che il tuo Ledger sia connesso al computer, sbloccato e che l’app Internet Computer (ICP) sia in esecuzione sul tuo device. Se una di queste condizioni non viene rispettata il browser vi mostrerà una finestra di errore che impedirà di proseguire.
II. Approvare la transazione tramite Ledger
Una volta approvata la transazione la hotkey verrà rimossa.
ATTENZIONE: Rimuovendo la hotkey della NNS dApp, il neuron non sarà più visibile nella padina Neurons.
Per aggiungerla nuovamente è necessario seguire la procedura “Listing Neurons”
Erogazione
Se un Neuron non si sta dissolvendo, è possibile erogare i suoi fondi su un altro account.
I. Selezionare il tasto “Disburse”.
II. Inserire l’address di destinazione o selezionare un account dalla lista e fare click su “Continue”.
III. Controllare tutti i dati inseriti e, se conformi, fare click su “Confirm and Send”
⚠ ATTENZIONE: Assicurati che il tuo Ledger sia connesso al computer, sbloccato e che l’app Internet Computer (ICP) sia in esecuzione sul tuo device. Se una di queste condizioni non viene rispettata il browser vi mostrerà una finestra di errore che impedirà di proseguire.
IV. Approvare la transazione tramite il Ledger
Una volta approvata la transazione i fondi del neuron saranno disponibili all’indirizzo indicato come destinazione.
— Spawning
Se un Neuron ha raggiunto un livello di maturità sufficiente, il tasto “Spawn Neuron” nella pagina di quel Neuron si attiverà e potrà essere clickato.
⚠ ATTENZIONE: Assicurati che il tuo Ledger sia connesso al computer, sbloccato e che l’app Internet Computer (ICP) sia in esecuzione sul tuo device. Se una di queste condizioni non viene rispettata il browser vi mostrerà una finestra di errore che impedirà di proseguire.
Approvando la transazione verrà creato un nuovo neuron contenente una quantità di ICP corrispondente al livello di maturità del neuron.
Il nuovo neuron sarà quindi visibile nella pagina Neurons.
— Listing Neurons
Nella pagina account dell’Hardware wallet selezionare “Show Neurons”, verranno visualizzati tutti i Neuron appartenenti a quel wallet.
Questo processo è utile specialmente se si è in possesso di Neurons che la dApp NNS non ha il permesso di visualizzare.
Se sono presenti dei Neurons a cui non è stata aggiunta la dApp NNS come HotKey, è possibile clickare su “Add to NNS dapp”.
Il sistema chiederà di approvare l’aggiunta della dApp NNS come HotKey e, una volta completata l’operazione, sarà possibile visualizzare e gestire quel neuron nella dashboard.
