Dokumentácia peňaženky

Uzol Ergo poskytuje vstavanú peňaženku na uchovávanie súkromných kľúčov a podpisovanie transakcií. Nasledujúce popisuje, ako nastaviť a chrániť vašu peňaženku Ergo.

Peňaženka používa štandard BIP39 na generovanie semena z mnemotechnickej vety, ktorá sa potom používa na generovanie súkromných kľúčov podľa štandardu BIP32 (Hierarchické deterministické peňaženky). Môžete použiť svoju vlastnú mnemotechnickú vetu zloženú zo slov z jedného z týchto zoznamov slov, ak chcete.
Povolené dĺžky viet sú 12, 15, 18, 21, 24, čo zodpovedá 128, 160, 192, 224, 256 bitom bezpečnosti. Na inicializáciu peňaženky s takouto mnemotechnickou vetou by ste mali použiť API koncový bod wallet/restore.
Avšak, je oveľa bezpečnejšie použiť mnemotechnickú vetu generovanú peňaženkou.

V tejto fáze môžu byť všetky interakcie s peňaženkou vykonané iba prostredníctvom REST API uzla. Uistite sa, že ste nastavili API kľúč vo vašom uzle pred vykonaním nasledujúcich krokov.

Konfigurácia peňaženky

Peňaženka sa konfiguruje prostredníctvom konfiguračného súboru uzla. Nižšie sú uvedené konfiguračné parametre, na ktoré je potrebné venovať pozornosť pri prvej konfigurácii peňaženky:

• ergo.wallet.seedStrengthBits - Dĺžka semena v bitoch v prípade, že bude generované uzlom. Poznámka: čím silnejšie je semeno, tým dlhšia je dĺžka mnemotechnickej vety. Možnosti: 128, 160, 192, 224, 256
• ergo.wallet.secretStorage.secretDir - Adresár, kde bude tajomstvo uložené v šifrovanej forme
• ergo.wallet.mnemonicPhraseLanguage - Jazyk, ktorý sa má použiť v mnemotechnickej vete. Možnosti: "chinese_simplified", "chinese_traditional", "english", "french", "italian", "japanese", "korean", "spanish"

Používanie peňaženky po prvýkrát

Peňaženka musí byť inicializovaná prostredníctvom REST API pri prvom spustení uzla. Tu sú k dispozícii dve možnosti:

1. Inicializovať ju od nuly (semienko bude generované uzlom) vykonaním POST požiadavky na /wallet/init s údajmi body: {"pass": "123", "mnemonicPass": "abc"}. Nezabudnite uložiť mnemotechnickú vetu, ktorú uzol vráti. (Poznámka: Parameter mnemonicPass v tele požiadavky je voliteľný a slúži na ochranu mnemotechnickej vety).
2. Obnoviť peňaženku z existujúceho semena. Pri použití tejto možnosti budete musieť poskytnúť svoju mnemotechnickú vetu. To sa vykonáva vykonaním POST požiadavky na /wallet/restore s údajmi body: {"pass": "123", "mnemonic": "abandon abandon ...", "mnemonicPass": "abc"} (Poznámka: pole mnemonicPass je povinné iba v prípade, že bola vaša mnemotechnická veta chránená ďalším heslom pri vytváraní).

Odomknutie peňaženky

Po inicializácii a pred každým použitím je potrebné peňaženku odomknúť vykonaním POST požiadavky na /wallet/unlock s údajmi body: {"pass": "123"}. (Poznámka: použite heslo, ktoré ste si vybrali pri inicializačnej fáze)

Tento krok musíte vykonať zakaždým, keď je uzol reštartovaný alebo je peňaženka zamknutá.
Konkrétne, peňaženka musí byť odomknutá pre nasledujúce operácie:

• Používanie interného baníka
• Podpisovanie transakcií
• Sledovanie boxov

Zamknutie peňaženky

Peňaženka je automaticky zamknutá po určitom čase, čo znamená, že všetky aktuálne načítané tajomstvá sú vymazané z pamäte. Môžete tiež použiť REST API na zamknutie peňaženky vykonaním GET požiadavky na /wallet/lock.
Odporúča sa zamknúť peňaženku, keď nie je v používaní.
Po zamknutí budete musieť peňaženku odomknúť, aby ste ju mohli znova použiť.

Správa kľúčov

Peňaženka implementuje BIP32 ("Hierarchické deterministické peňaženky"). Keď je peňaženka inicializovaná, vytvorí sa iba koreňový kľúč.
Na deriváciu ďalšieho páru kľúčov zodpovedajúceho konkrétnej derivácii cesty (metóda: POST, telo požiadavky: {"derivationPath": "m/1/2"}) sa môže použiť API cesta /wallet/deriveKey.
Na jednoduché vytvorenie ďalšieho páru kľúčov použite API cestu /wallet/deriveNextKey (metóda: GET).