nervosnetwork / nervosnetwork/neuron

Steps to use Neuron as a cold wallet to circumvent buffer limit of Ledger

Open
#3,285 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Document replied
Dominant language
TypeScript
Stars
204
Forks
95
Avg merge
8d 9h
Merged PRs (30d)
4

Description

This guide is for users encountering the error Ledger device: UNKNOWN_ERROR (0x9405). The solution involves installing a custom version of Neuron on an offline computer, importing the Ledger’s recovery phrase to create a cold wallet for signing transactions.

Requirements:

  1. Backup of the Ledger recovery phrase.
  2. An offline computer.

Steps:

  1. Find an Offline Computer
    Locate a computer that is either offline or has not been connected to the internet and has no unknown software. Disconnect it from the network.

  2. Install Neuron
    Transfer the Neuron installer(https://github.com/nervosnetwork/neuron/issues/3285#issuecomment-2541654181) to the offline Computer for installation. Install Neuron and import the Ledger recovery phrase/mnemonics so we have an offline wallet, which is called cold wallet.

image
  1. Prepare the Transaction on an Online Computer
    On the online computer, complete synchronization with Neuron and initiate the desired transaction. In the transaction confirmation dialog, choose to export the transaction and save it as a file.
image
  1. Sign the Transaction with Cold Wallet
    Transfer the transaction file to the offline computer using the external device. Use the cold wallet Neuron to sign the transaction by navigating to Menu => Tools => Offline Sign. This will generate a signed transaction file.
image
  1. Broadcast the Signed Transaction
    Transfer the signed transaction file back to the online computer. Use Neuron’s Menu => Tools => Broadcast Transaction function to submit the signed transaction.
image
  1. Cleanup Process

    1. Recommended: Generate a new Ledger wallet and stop using the old wallet.
    2. If the old wallet will be used further: Delete Neuron and all wallet records from the offline computer. Steps to clear Neuron and wallet will be appended in the comment.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No documentation file or entry point is named. Start by locating Neuron’s existing wallet documentation and compare its conventions with this six-step offline-wallet workflow, including the Menu => Tools => Offline Sign and Broadcast Transaction paths. Done means the guide is placed in the appropriate documentation location and its Ledger, recovery-phrase, offline-signing, and cleanup instructions are reviewed for accuracy.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
blockchain, documentation, security
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.