Documentação da carteira

Um nó Ergo fornece uma carteira embutida para armazenar chaves privadas e assinar transações. O seguinte descreve como configurar e proteger sua carteira Ergo.

A carteira usa o padrão BIP39 para gerar uma semente a partir de uma frase mnemônica, que é então usada para gerar as chaves privadas de acordo com o padrão BIP32 (Carteiras Determinísticas Hierárquicas). Você pode usar sua própria frase mnemônica composta pelas palavras de uma dessas listas de palavras se desejar.
Os comprimentos de frase permitidos são 12, 15, 18, 21, 24 representando respectivamente, 128, 160, 192, 224, 256 bits de segurança. Para inicializar uma carteira com tal mnemônica, você deve usar o endpoint da API wallet/restore.
No entanto, é muito mais seguro usar a mnemônica gerada pela carteira.

Neste estágio, todas as interações com a carteira podem ser feitas apenas através da API REST do nó. Certifique-se de que você configurou uma chave de API em seu nó antes de realizar os próximos passos.

Configurando a carteira

A carteira é configurada através do arquivo de configuração do nó. Abaixo estão os parâmetros de configuração que merecem atenção ao configurar a carteira pela primeira vez:

• ergo.wallet.seedStrengthBits - Comprimento em bits de uma semente caso ela seja gerada pelo nó. Nota: quanto mais forte a semente, maior o comprimento da frase mnemônica. Opções: 128, 160, 192, 224, 256
• ergo.wallet.secretStorage.secretDir - Diretório onde o segredo será armazenado em forma criptografada
• ergo.wallet.mnemonicPhraseLanguage - Idioma a ser usado na frase mnemônica. Opções: "chinese_simplified", "chinese_traditional", "english", "french", "italian", "japanese", "korean", "spanish"

Usando a carteira pela primeira vez

A carteira precisa ser inicializada via API REST ao executar o nó pela primeira vez. Duas opções estão disponíveis aqui:

1. Inicializá-la do zero (a semente será gerada pelo nó) fazendo uma solicitação POST para /wallet/init com dados body: {"pass": "123", "mnemonicPass": "abc"}. Não se esqueça de salvar a frase mnemônica com a qual o nó responde. (Nota: O parâmetro mnemonicPass no corpo da solicitação é opcional e é usado para proteger a frase mnemônica).
2. Restaurar a carteira de uma semente existente. Você terá que fornecer sua frase mnemônica ao usar esta opção. Isso é feito fazendo uma solicitação POST para /wallet/restore com dados body: {"pass": "123", "mnemonic": "abandon abandon ...", "mnemonicPass": "abc"} (Nota: o campo mnemonicPass é necessário apenas caso sua frase mnemônica tenha sido protegida por uma senha adicional na criação).

Desbloqueando a carteira

Após a inicialização e antes de cada uso, a carteira precisa ser desbloqueada fazendo uma solicitação POST para /wallet/unlock com dados body: {"pass": "123"}. (Nota: use a senha que você escolheu na fase de inicialização)

Você deve realizar esta etapa toda vez que o nó for reiniciado ou a carteira for bloqueada.
Em particular, a carteira deve ser desbloqueada para as seguintes operações:

• Usando minerador interno
• Assinando transações
• Rastreando caixas

Bloqueando a carteira

Uma carteira é automaticamente bloqueada após algum tempo, o que significa que todos os segredos atualmente carregados são removidos da memória. Você também pode usar a API REST para bloquear a carteira fazendo uma solicitação GET para /wallet/lock.
É recomendável bloquear a carteira quando não estiver em uso.
Após o bloqueio, você precisará desbloquear a carteira para usá-la novamente.

Gerenciando chaves

Uma carteira implementa BIP32 ("Carteiras determinísticas hierárquicas"). Quando a carteira é inicializada, a única chave raiz é criada.
Para derivar um par de chaves adicionais correspondentes a um caminho de derivação específico (método: POST, corpo da solicitação: {"derivationPath": "m/1/2"}) pode-se usar a rota da API /wallet/deriveKey.
Para simplesmente criar um par de chaves adicionais, use uma rota da API /wallet/deriveNextKey (método: GET).