Cüzdan belgeleri

Bir Ergo düğümü, özel anahtarları saklamak ve işlemleri imzalamak için yerleşik bir cüzdan sağlar. Aşağıda, Ergo cüzdanınızı nasıl kuracağınız ve koruyacağınız açıklanmaktadır.

Cüzdan, bir mnemonik cümleden bir tohum oluşturmak için BIP39 standardını kullanır; bu tohum daha sonra BIP32 standardına (Hiyerarşik Belirleyici Cüzdanlar) göre özel anahtarları oluşturmak için kullanılır. İsterseniz, bu kelime listelerinden kelimelerden oluşan kendi mnemonik cümlenizi kullanabilirsiniz.
İzin verilen cümle uzunlukları 12, 15, 18, 21, 24 olup sırasıyla 128, 160, 192, 224, 256 bit güvenliği temsil eder. Böyle bir mnemonikle bir cüzdan başlatmak için wallet/restore API uç noktasını kullanmalısınız.
Ancak, cüzdan tarafından üretilen mnemonik kullanmak çok daha güvenlidir.

Bu aşamada, cüzdanla olan tüm etkileşimler yalnızca düğümün REST API'si aracılığıyla yapılabilir. Lütfen bir sonraki adımları gerçekleştirmeden önce düğümünüzde bir API anahtarı ayarladığınızdan emin olun.

Cüzdanı yapılandırma

Cüzdan, düğüm yapılandırma dosyası aracılığıyla yapılandırılır. Cüzdanı ilk kez yapılandırırken dikkat edilmesi gereken yapılandırma parametreleri aşağıda verilmiştir:

• ergo.wallet.seedStrengthBits - Düğüm tarafından oluşturulacaksa bir tohumun bit uzunluğu. Not: Tohum ne kadar güçlü olursa, mnemonik cümle uzunluğu o kadar uzun olur. Seçenekler: 128, 160, 192, 224, 256
• ergo.wallet.secretStorage.secretDir - Sırrın şifreli formda saklanacağı dizin
• ergo.wallet.mnemonicPhraseLanguage - Mnemonik cümlede kullanılacak dil. Seçenekler: "çince_basitleştirilmiş", "çince_geleneksel", "ingilizce", "fransızca", "italyanca", "japonca", "korece", "ispanyolca"

Cüzdanı ilk kez kullanma

Cüzdan, düğümü ilk kez çalıştırırken REST API aracılığıyla başlatılmalıdır. Burada iki seçenek mevcuttur:

1. Sıfırdan başlatın (tohum düğüm tarafından oluşturulacak) ve /wallet/init adresine body: {"pass": "123", "mnemonicPass": "abc"} verisi ile POST isteği yapın. Düğümün yanıtladığı mnemonik cümleyi kaydetmeyi unutmayın. (Not: İstek gövdesindeki mnemonicPass parametresi isteğe bağlıdır ve mnemonik cümleyi korumak için kullanılır).
2. Mevcut bir tohumdan cüzdanı geri yükleyin. Bu seçeneği kullanırken mnemonik cümlenizi sağlamanız gerekecek. Bu, /wallet/restore adresine body: {"pass": "123", "mnemonic": "abandon abandon ...", "mnemonicPass": "abc"} verisi ile POST isteği yapılarak gerçekleştirilir (Not: mnemonicPass alanı yalnızca mnemonik cümleniz oluşturulurken ek bir şifre ile korunmuşsa gereklidir).

Cüzdanı kilidini açma

Başlatmadan sonra ve her kullanım öncesinde cüzdanın, body: {"pass": "123"} verisi ile /wallet/unlock adresine POST isteği yapılarak kilidinin açılması gerekir. (Not: Başlatma aşamasında seçtiğiniz şifreyi kullanın)

Bu adımı, düğüm her yeniden başlatıldığında veya cüzdan kilitlendiğinde her seferinde gerçekleştirmeniz gerekir.
Özellikle, cüzdanın aşağıdaki işlemler için kilidinin açılması gerekir:

• Dahili madenciyi kullanma
• İşlemleri imzalama
• Kutuları takip etme

Cüzdanı kilitleme

Cüzdan, belirli bir süre sonra otomatik olarak kilitlenir; bu, şu anda yüklü olan tüm sırların bellekten silindiği anlamına gelir. Cüzdanı kilitlemek için ayrıca REST API'yi kullanarak /wallet/lock adresine GET isteği yapabilirsiniz.
Cüzdan kullanılmadığında kilitlenmesi önerilir.
Kilitlendikten sonra, cüzdanı tekrar kullanmak için kilidini açmanız gerekecektir.

Anahtarları yönetme

Bir cüzdan BIP32'yi ("Hiyerarşik belirleyici cüzdanlar") uygular. Cüzdan başlatıldığında yalnızca bir kök anahtar oluşturulur.
Belirli bir türetme yoluna karşılık gelen ek anahtar çiftini türetmek için (yöntem: POST, istek gövdesi: {"derivationPath": "m/1/2"}) /wallet/deriveKey API rotası kullanılabilir.
Basitçe ek bir anahtar çifti oluşturmak için /wallet/deriveNextKey API rotasını kullanın (yöntem: GET).