Dokumentasi Dompet

Node Ergo menyediakan dompet bawaan untuk menyimpan kunci pribadi dan menandatangani transaksi. Berikut ini menjelaskan cara mengatur dan melindungi dompet Ergo Anda.

Dompet menggunakan standar BIP39 untuk menghasilkan seed dari kalimat mnemonik, yang kemudian digunakan untuk menghasilkan kunci pribadi sesuai dengan standar BIP32 (Dompet Deterministik Hierarkis). Anda dapat menggunakan kalimat mnemonik Anda sendiri yang terdiri dari kata-kata dari salah satu daftar kata ini jika Anda mau.
Panjang kalimat yang diizinkan adalah 12, 15, 18, 21, 24 yang masing-masing mewakili 128, 160, 192, 224, 256 bit keamanan. Untuk menginisialisasi dompet dengan mnemonik seperti itu, Anda harus menggunakan endpoint API wallet/restore.
Namun, jauh lebih aman untuk menggunakan mnemonik yang dihasilkan oleh dompet.

Pada tahap ini, semua interaksi dengan dompet hanya dapat dilakukan melalui API REST node. Harap pastikan bahwa Anda telah mengatur kunci API di node Anda sebelum melakukan langkah-langkah berikutnya.

Mengonfigurasi dompet

Dompet dikonfigurasi melalui file konfigurasi node. Berikut adalah parameter konfigurasi yang perlu diperhatikan saat mengonfigurasi dompet untuk pertama kalinya:

• ergo.wallet.seedStrengthBits - Panjang bit dari seed jika akan dihasilkan oleh node. Catatan: semakin kuat seed, semakin panjang panjang kalimat mnemonik. Opsi: 128, 160, 192, 224, 256
• ergo.wallet.secretStorage.secretDir - Direktori tempat rahasia akan disimpan dalam bentuk terenkripsi
• ergo.wallet.mnemonicPhraseLanguage - Bahasa yang akan digunakan dalam kalimat mnemonik. Opsi: "chinese_simplified", "chinese_traditional", "english", "french", "italian", "japanese", "korean", "spanish"

Menggunakan dompet untuk pertama kalinya

Dompet perlu diinisialisasi melalui API REST saat menjalankan node untuk pertama kalinya. Dua opsi tersedia di sini:

1. Inisialisasi dari awal (seed akan dihasilkan oleh node) dengan membuat permintaan POST ke /wallet/init dengan data body: {"pass": "123", "mnemonicPass": "abc"}. Jangan lupa untuk menyimpan kalimat mnemonik yang dijawab oleh node. (Catatan: Parameter mnemonicPass dalam body permintaan bersifat opsional dan digunakan untuk melindungi kalimat mnemonik).
2. Memulihkan dompet dari seed yang ada. Anda harus memberikan kalimat mnemonik Anda saat menggunakan opsi ini. Ini dilakukan dengan membuat permintaan POST ke /wallet/restore dengan data body: {"pass": "123", "mnemonic": "abandon abandon ...", "mnemonicPass": "abc"} (Catatan: field mnemonicPass hanya diperlukan jika kalimat mnemonik Anda dilindungi oleh kata sandi tambahan saat dibuat).

Membuka kunci dompet

Setelah inisialisasi dan sebelum setiap penggunaan, dompet perlu dibuka kuncinya dengan membuat permintaan POST ke /wallet/unlock dengan data body: {"pass": "123"}. (Catatan: gunakan kata sandi yang Anda pilih pada tahap inisialisasi)

Anda harus melakukan langkah ini setiap kali node di-restart atau dompet terkunci.
Secara khusus, dompet harus dibuka kuncinya untuk operasi berikut:

• Menggunakan penambang internal
• Menandatangani transaksi
• Melacak kotak

Mengunci dompet

Dompet secara otomatis terkunci setelah beberapa waktu, yang berarti bahwa semua rahasia yang saat ini dimuat dibersihkan dari memori. Anda juga dapat menggunakan API REST untuk mengunci dompet dengan membuat permintaan GET ke /wallet/lock.
Disarankan untuk mengunci dompet saat tidak digunakan.
Setelah mengunci, Anda perlu membuka kunci dompet untuk menggunakannya lagi.

Mengelola kunci

Dompet menerapkan BIP32 ("Dompet deterministik hierarkis"). Ketika dompet diinisialisasi, hanya kunci akar yang dibuat.
Untuk menghasilkan pasangan kunci tambahan yang sesuai dengan jalur derivasi tertentu (metode: POST, body permintaan: {"derivationPath": "m/1/2"}) rute API /wallet/deriveKey dapat digunakan.
Untuk sekadar membuat pasangan kunci tambahan, gunakan rute API /wallet/deriveNextKey (metode: GET).