Pénztárca dokumentáció

Egy Ergo csomópont beépített pénztárcát biztosít a privát kulcsok tárolására és a tranzakciók aláírására. Az alábbiakban leírjuk, hogyan állíthatja be és védheti meg az Ergo pénztárcáját.

A pénztárca a BIP39 szabványt használja, hogy egy mnemonikus mondatból seed-et generáljon, amelyet ezután a BIP32 szabvány (Hierarchikus Determinisztikus Pénztárcák) szerint privát kulcsok generálására használnak. Használhatja a saját mnemonikus mondatát, amely a ezekből a szószedetekből áll, ha szeretné.
A megengedett mondathosszak 12, 15, 18, 21, 24, amelyek a biztonság 128, 160, 192, 224, 256 bitjét képviselik. Ahhoz, hogy egy ilyen mnemonikussal inicializáljon egy pénztárcát, a wallet/restore API végpontot kell használnia.
Azonban sokkal biztonságosabb a pénztárca által generált mnemonikus használata.

Ebben a szakaszban a pénztárcával való összes interakciót csak a csomópont REST API-ján keresztül lehet végrehajtani. Kérjük, győződjön meg arról, hogy beállított egy API kulcsot a csomópontjában, mielőtt a következő lépéseket végrehajtaná.

A pénztárca konfigurálása

A pénztárca a csomópont konfigurációs fájlján keresztül van konfigurálva. Az alábbiakban a konfigurációs paraméterek találhatók, amelyekre érdemes figyelni, amikor először konfigurálja a pénztárcát:

• ergo.wallet.seedStrengthBits - A seed bit-hossza, ha azt a csomópont generálja. Megjegyzés: minél erősebb a seed, annál hosszabb a mnemonikus mondat hossza. Opciók: 128, 160, 192, 224, 256
• ergo.wallet.secretStorage.secretDir - A titkos tárolásának helye titkosított formában
• ergo.wallet.mnemonicPhraseLanguage - A mnemonikus mondatban használandó nyelv. Opciók: "chinese_simplified", "chinese_traditional", "english", "french", "italian", "japanese", "korean", "spanish"

A pénztárca első használata

A pénztárcát a REST API-n keresztül kell inicializálni, amikor a csomópontot először futtatja. Két lehetőség áll rendelkezésre itt:

1. Inicializálja a nulláról (a seed-et a csomópont generálja) egy POST kérés küldésével a /wallet/init végpontra az alábbi adatokkal: body: {"pass": "123", "mnemonicPass": "abc"}. Ne felejtse el elmenteni a mnemonikus mondatot, amellyel a csomópont válaszol. (Megjegyzés: A mnemonicPass paraméter a kérés törzsében opcionális, és a mnemonikus mondat védelmére szolgál).
2. Állítsa vissza a pénztárcát egy meglévő seed-ből. Ekkor meg kell adnia a mnemonikus mondatát. Ezt egy POST kérés küldésével teheti meg a /wallet/restore végpontra az alábbi adatokkal: body: {"pass": "123", "mnemonic": "abandon abandon ...", "mnemonicPass": "abc"} (Megjegyzés: a mnemonicPass mező csak akkor kötelező, ha a mnemonikus mondatot egy további jelszó védte a létrehozáskor).

A pénztárca feloldása

Az inicializálás után és minden használat előtt a pénztárcát fel kell oldani egy POST kérés küldésével a /wallet/unlock végpontra az alábbi adatokkal: body: {"pass": "123"}. (Megjegyzés: használja azt a jelszót, amelyet az inicializálás során választott)

Ezt a lépést minden alkalommal el kell végezni, amikor a csomópont újraindul vagy a pénztárca zárolva van.
Különösen a pénztárcát fel kell oldani a következő műveletekhez:

• Belső bányász használata
• Tranzakciók aláírása
• Boxok nyomon követése

A pénztárca zárolása

A pénztárca automatikusan zárolódik egy idő után, ami azt jelenti, hogy az összes jelenleg betöltött titkos adat törlődik a memóriából. A pénztárca zárolásához a REST API-t is használhatja, ha egy GET kérést küld a /wallet/lock végpontra.
Ajánlott a pénztárcát zárolni, amikor az nincs használatban.
Zárolás után fel kell oldania a pénztárcát, hogy újra használhassa.

Kulcsok kezelése

A pénztárca megvalósítja a BIP32-t ("Hierarchikus determinisztikus pénztárcák"). Amikor a pénztárca inicializálva van, csak egy gyökérkulcs jön létre.
Ahhoz, hogy további kulcspárt származtasson egy adott származtatási úthoz (módszer: POST, kérés törzse: {"derivationPath": "m/1/2"}), a /wallet/deriveKey API útvonalat használhatja.
Ahhoz, hogy egyszerűen létrehozzon további kulcspárt, használja a /wallet/deriveNextKey API útvonalat (módszer: GET).