Edit this page on GitHub (opens in a new tab)
Zallet هي محفظة Zcash لعقدة كاملة مكتوبة بلغة Rust. وهي البديل للمحفظة التي كانت مضمّنة في zcashd. بعد أن وصلت zcashd إلى توقف نهاية الدعم في 18 يوليو 2026 عند ارتفاع الكتلة 3417100، تم فصل مهام الإجماع والمحفظة: تتحقق Zebra أو Zakura من السلسلة، بينما تحتفظ Zallet بالمفاتيح، وتمسح الملاحظات، وتوفّر JSON-RPC للمحفظة.
Zallet حاليًا في مرحلة beta. لم تخضع لمراجعة كاملة. قد تتطلب التغييرات غير المتوافقة حذف المحفظة وإعادة إنشائها. لا تتعامل معها كحفظٍ إنتاجي لكميات كبيرة من ZEC من دون قراءة تحذيرات الأمان في كتاب Zallet.
zcashd. أما جزء العقدة فهو Zebra أو Zakura.ReadStateService مباشرة إلى zebrad محلية) أو Zaino.wallet.db.zallet (المشغّل)، وzallet-zebra، وzallet-zaino.كانت zcashd تجمع عقدة إجماع مشتقة من Bitcoin Core ومحفظة في عملية واحدة. لم يعد هذا التصميم قائمًا.
| الدور | الحزمة القديمة | الحزمة الحالية |
|---|---|---|
| الإجماع / P2P | zcashd | Zebra (zebrad) أو Zakura |
| المحفظة / المفاتيح / الأرصدة | zcashd wallet.dat | Zallet (wallet.db) |
| مفهرس العميل الخفيف | lightwalletd | Zaino أو lightwalletd |
فصل المحفظة عن العقدة يعني:
zcashd.Zallet هي المحفظة المخصصة للمشغّلين الذين كانوا يشغّلون سابقًا zcashd كمحفظة ساخنة، أو خلفية لمنصة تداول، أو صنبور، أو محفظة لمدفوعات التعدين.
Zallet في مرحلة beta.
ما يعنيه ذلك عمليًا:
zcashd.zcashd. يجب على عمليات التكامل قراءة صفحة الدلالات المعدّلة.تُرسل الملاحظات إلى مشكلات GitHub أو إلى قناة #wallet-dev على Zcash Discord للبحث والتطوير.
تُخطط مرحلة مستقرة لاحقة عند اكتمال واجهة RPC المقصودة. وسيتوقع حينها من المستدعين الانتقال إلى طرائق Zallet، بما فيها الفروق الدلالية الموثقة.
تنقسم Zallet عبر ثلاث مساحات عمل Cargo كي تتمكن واجهتا السلسلة الخلفيتان من تتبع مخططات تبعيات مختلفة.
zallet launcher: reads `backend` in zallet.toml (default "zebra")
and execs zallet-zebra or zallet-zaino
zallet-core shared wallet: CLI, config, JSON-RPC, SQLite DB, sync
zallet-zebra zebra-state backend (ReadStateService + Zebra JSON-RPC)
zallet-zaino Zaino indexer backend
تفتح الملفات التنفيذية الثلاثة جميعها نفس wallet.db. يختار المشغّل واجهة خلفية وقت التشغيل؛ ولا تحتاج إلى إعادة الترجمة للتبديل.
نشر نموذجي:
zebrad (or Zakura)
│ JSON-RPC / ReadStateService
▼
Zallet (zallet-zebra or zallet-zaino)
│ JSON-RPC on 127.0.0.1
▼
Your application, exchange, faucet, or operator scripts
Zallet هي محفظة لعقدة كاملة: تتوقع عقدة تحقق محلية. وليست عميلًا خفيفًا. للمحافظ الخفيفة وخوادم الكتل المضغوطة، راجع Zaino وعقد Lightwallet.
تشغّل حزمة compose الخاصة بـ Zcash Foundation، وهي Z3، Zebra + Zallet مع Zaino مستقل اختياري للعملاء الخفيفين الخارجيين.
تستند Zallet إلى حسابات ZIP 32، وليس إلى حساب zcashd الضمني الوحيد.
zip32seedfp1…).(seedfp, account index).z_getaddressforaccount. يمكن أن يملك الحساب الواحد عناوين متنوعة كثيرة؛ ولا يمكن ربط مستقبِلات الحماية على السلسلة.z_importkey) وعناوين المراقبة فقط (z_importaddress) حسابات UUID لا تغطيها أي عبارة تذكّر.z_exportviewingkey، z_importviewingkey)، بما في ذلك مفاتيح العرض الكاملة الموحّدة ومفاتيح العرض الواردة.getnewaddress غير مطبّق. استخدم z_getnewaccount وz_getaddressforaccount.
إذا كان keystore.require_backup مفعّلًا (الصيغة المُرحّلة من zcashd الخاصة بـ walletrequirebackup)، ترفض Zallet اشتقاق سلطة إنفاق جديدة من عبارة تذكّر لم يُؤكَّد نسخها الاحتياطي.
تكون مادة المفاتيح مشفّرة دائمًا. لا يوجد وضع غير مشفّر ولا RPC لـ encryptwallet — إذ لم تكن طريقة zcashd تلك مدعومة بالكامل قط.
{datadir}/encryption-identity.txt.wallet.db.generate-encryption-identity -p). ألغِ القفل باستخدام RPC walletpassphrase؛ وأغلقه باستخدام walletlock.wallet.db تحتفظ بها (بصورة منفصلة ومشفّرة).نسخ wallet.db أثناء تشغيل Zallet ليس نسخة احتياطية آمنة. فقد تتمزق SQLite. فضّل إيقاف العملية، أو انتظر أمر النسخ الاحتياطي الرسمي عبر الإنترنت.
تطبّق Zallet مجموعة فرعية من RPCs لمحفظة zcashd عبر HTTP مع مصادقة Basic. اربطها بعنوان loopback. وينبغي أن يمر الاستخدام البعيد عبر نفق مشفّر. توجد rpc.allow_insecure_remote_bind وهي غير آمنة.
فروق بارزة عن zcashd:
getwalletinfo فارغة. استخدم z_getbalances، وz_getbalanceforaccount، وz_gettotalbalance.settxfee.ClientInInitialDownload / ForbiddenBySafeMode).تشمل الطرائق المحذوفة عمدًا createrawtransaction، وfundrawtransaction، وgetnewaddress، وgetrawchangeaddress، وkeypoolrefill، وimportwallet، وencryptwallet. تُدرج البدائل في كتاب Zallet.
توجد مسارات التثبيت الرسمية (حزم Debian وDocker والملفات التنفيذية للإصدار) في دليل التثبيت. تسمى أرشيفات الإصدار zallet-<version>-<arch>.tar.gz وتتضمن الملفات التنفيذية الثلاثة كلها.
مسار أدنى لإنشاء محفظة جديدة:
# data directory; default is $HOME/.zallet
zallet -d /path/to/zallet/datadir example-config > /path/to/zallet/datadir/zallet.toml
# edit zallet.toml: network, backend, indexer / read-state, rpc.bind
zallet -d /path/to/zallet/datadir generate-encryption-identity
zallet -d /path/to/zallet/datadir init-wallet-encryption
zallet -d /path/to/zallet/datadir generate-mnemonic
zallet -d /path/to/zallet/datadir confirm-backup
zallet -d /path/to/zallet/datadir start
وجّه [indexer] إلى نقطة نهاية JSON-RPC لـ zebrad محلية. تتطلب واجهة zebra الخلفية أيضًا [indexer.read_state_service] وzebrad مبنية بميزة المفهرس كي تتمكن Zallet من قراءة حالة السلسلة مباشرة.
يمكن بناء صور قابلة لإعادة الإنتاج باستخدام StageX (Docker 25+، ومخزن صور containerd، وGNU Make).
احتفظ بدليل بيانات zcashd القديم إلى أن تؤكد الأرصدة وتجرب استعادة ناجحة.
zallet init-wallet-encryption
zallet migrate-zcash-conf --zcashd-datadir /path/to/zcashd/datadir \
-o /path/to/zallet/datadir/zallet.toml
zallet migrate-zcashd-wallet --zcashd-datadir /path/to/zcashd/datadir
توجد migrate-zcashd-wallet فقط في الإصدارات التي تحتوي على ميزة zcashd-import. تتطلب قراءة wallet.dat مكتبة db_dump من Berkeley DB 6.2، وهو الإصدار الذي استخدمته zcashd.
ملاحظات المشغّل خطوة بخطوة: .
| Zallet | zecd | Zashi / ZODL / YWallet | Zebra / Zakura | Zaino | |
|---|---|---|---|---|---|
| ما هي | محفظة RPC لعقدة كاملة | خادم محفظة يضع الحماية أولًا | محافظ المستخدم النهائي | عقدة إجماع | مفهرس / بديل lightwalletd |
| تحل محل | محفظة zcashd | ليست نسخة مطابقة بديلة من zcashd | تطبيقات الهاتف المحمول/سطح المكتب | عقدة zcashd | lightwalletd |
| تحتاج إلى عقدة محلية | نعم | نعم (Zebra افتراضيًا) | لا (عميل خفيف) | هي العقدة نفسها | نعم |
| توافق RPC لـ zcashd |
يمكن لكل من Zallet وzecd أن يتصدرا Zebra. اختر Zallet عندما تحتاج إلى واجهة محفظة z_* ومسار ترحيل من wallet.dat. واختر zecd عندما تريد خادمًا يضع الحماية أولًا وليس، صراحةً، نسخة من zcashd.
يوجد منتج منفصل للمستهلكين على zallet.io يعيد استخدام الاسم. ذلك التطبيق ليس هذا المشروع.
zcashd المتوقفة| مصممة لتكون مسار التوافق |
| مجموعة فرعية صغيرة مختارة فقط |
| غير منطبق |
| وضع توافق جزئي / Zakura |
| واجهة API مختلفة |
| نموذج الحفظ | يحتفظ المشغّل بالمفاتيح في wallet.db | خادم قابل للاسترداد بالبذرة | مفاتيح على جهاز المستخدم | لا محفظة | لا مفاتيح |