Edit this page on GitHub (opens in a new tab)
Zallet es una billetera [wallet] de nodo completo [full-node] Zcash escrita en Rust. Es el reemplazo de la billetera que solía estar integrada en zcashd. Después de que zcashd alcanzara su detención de fin de soporte el 18 de julio de 2026 a la altura de bloque 3417100, las funciones de consenso y billetera se dividieron: Zebra o Zakura validan la red [chain], y Zallet guarda las claves, escanea notas y expone el JSON-RPC de la billetera.
Zallet se encuentra actualmente en beta. No ha sido revisado por completo. Los cambios incompatibles pueden requerir eliminar y volver a crear la billetera. No lo trates como custodia de producción para grandes cantidades de ZEC sin leer las advertencias de seguridad en El libro de Zallet.
zcashd. La parte de nodo es Zebra o Zakura.ReadStateService directo contra un zebrad local) o Zaino.wallet.db.zallet (iniciador), zallet-zebra y zallet-zaino.zcashd agrupaba un nodo de consenso derivado de Bitcoin Core y una billetera en un solo proceso. Ese diseño ya no existe.
| Función | Pila anterior | Pila actual |
|---|---|---|
| Consenso / P2P | zcashd | Zebra (zebrad) o Zakura |
| Billetera / claves / saldos | zcashd wallet.dat | Zallet (wallet.db) |
| Indexador de cliente ligero | lightwalletd | Zaino o lightwalletd |
Separar la billetera del nodo significa:
zcashd.Zallet es la billetera destinada a operadores que antes ejecutaban zcashd como billetera activa, backend de exchange, faucet o billetera de pagos de minado.
Zallet está en beta.
Esto significa en la práctica:
zcashd han sido migrados.zcashd. Las integraciones deben leer la página de semántica modificada.Los comentarios se envían a los problemas de GitHub o al canal #wallet-dev en el Zcash de I+D Discord.
Se planea una fase estable posterior una vez que exista la superficie RPC prevista. Entonces se esperará que quienes llamen migren a los métodos de Zallet, incluidas las diferencias semánticas documentadas.
Zallet está dividido en tres espacios de trabajo de Cargo para que los dos backends de red puedan seguir distintos grafos de dependencias.
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
Los tres binarios abren la misma wallet.db. El iniciador elige un backend en tiempo de ejecución; no necesitas recompilar para cambiarlo.
Implementación típica:
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 es una billetera de nodo completo: espera un nodo validador local. No es un cliente ligero. Para billeteras ligeras y servidores de bloques compactos, consulta Zaino y Nodos Lightwallet.
La pila compose Z3 de Zcash Foundation ejecuta Zebra + Zallet juntos, con Zaino independiente opcional para clientes ligeros externos.
Zallet se basa en cuentas ZIP 32, no en la única cuenta implícita de zcashd.
zip32seedfp1…).(seedfp, account index).z_getaddressforaccount. Una cuenta puede tener muchas direcciones diversificadas; los receptores blindados no pueden vincularse on-chain.z_importkey) y las direcciones de solo observación (z_importaddress) se convierten en cuentas UUID que ningún mnemónico cubre.z_exportviewingkey, z_importviewingkey), incluidas las claves de visualización completas unificadas y las claves de visualización entrantes.getnewaddress no está implementado. Usa z_getnewaccount y z_getaddressforaccount.
Si keystore.require_backup está activado (la forma migrada del walletrequirebackup de zcashd), Zallet se niega a derivar nueva autoridad de gasto de un mnemónico cuya copia de seguridad no haya sido confirmada.
El material de claves está siempre cifrado. No existe un modo sin cifrado ni un RPC encryptwallet; ese método de zcashd nunca fue completamente compatible.
{datadir}/encryption-identity.txt.wallet.db.generate-encryption-identity -p). Desbloquéala con el RPC walletpassphrase; bloquéala con walletlock.wallet.db que conserves.Copiar wallet.db mientras Zallet se está ejecutando no es una copia de seguridad segura. SQLite puede quedar incompleto. Prefiere un proceso detenido o espera un comando oficial de copia de seguridad en línea.
Zallet implementa un subconjunto de los RPC de billetera de zcashd mediante HTTP con autenticación Basic. Enlázalo a loopback. El uso remoto debe pasar por un túnel cifrado. rpc.allow_insecure_remote_bind existe y no es seguro.
Diferencias destacables con respecto a zcashd:
getwalletinfo están vacíos. Usa z_getbalances, z_getbalanceforaccount y z_gettotalbalance.settxfee.ClientInInitialDownload / ForbiddenBySafeMode).Los métodos omitidos intencionalmente incluyen createrawtransaction, fundrawtransaction, getnewaddress, getrawchangeaddress, keypoolrefill, importwallet y encryptwallet. Los reemplazos se enumeran en el Libro de Zallet.
Las rutas de instalación oficiales (paquetes Debian, Docker, binarios de lanzamiento) están en la guía de instalación. Los archivos de lanzamiento se denominan zallet-<version>-<arch>.tar.gz y contienen los tres binarios.
Flujo mínimo para una billetera nueva:
# 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
Apunta [indexer] a un endpoint JSON-RPC local de zebrad. El backend zebra también requiere [indexer.read_state_service] y un zebrad compilado con la función de indexador para que Zallet pueda leer directamente el estado de la red.
Las imágenes reproducibles pueden construirse con StageX (Docker 25+, almacén de imágenes containerd, GNU Make).
Conserva el directorio de datos antiguo de zcashd hasta que hayas confirmado los saldos y probado una restauración.
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 solo está disponible en compilaciones con la función zcashd-import. Leer wallet.dat requiere db_dump de Berkeley DB 6.2, la versión que usaba zcashd.
Notas paso a paso para operadores: .
| Zallet | zecd | Zashi / ZODL / YWallet | Zebra / Zakura | Zaino | |
|---|---|---|---|---|---|
| Qué es | Billetera RPC de nodo completo | Servidor de billetera centrado en blindados | Billeteras para usuarios finales | Nodo de consenso | Reemplazo de indexador / lightwalletd |
| Reemplaza | Billetera de zcashd | No es un clon directo de zcashd | Aplicaciones móviles/de escritorio | Nodo de zcashd | lightwalletd |
| Necesita un nodo local | Sí | Sí (Zebra de forma predeterminada) | No (cliente ligero) | Es el nodo | Sí |
Zallet y zecd pueden ubicarse ambos delante de Zebra. Elige Zallet cuando necesites la interfaz de billetera de z_* y una ruta de migración desde wallet.dat. Elige zecd cuando quieras un servidor centrado en blindados que explícitamente no sea un clon de zcashd.
Existe un producto de consumo independiente en zallet.io que reutiliza el nombre. Esa aplicación no es este proyecto.
zcashd retirado| Compatibilidad RPC de zcashd |
| Diseñada como la ruta de compatibilidad |
| Solo un pequeño subconjunto seleccionado |
| N/A |
| Modo de compatibilidad parcial / Zakura |
| API diferente |
| Modelo de custodia | El operador guarda las claves en wallet.db | Servidor recuperable mediante semilla | Claves en el dispositivo del usuario | Sin billetera | Sin claves |