Edit this page on GitHub (opens in a new tab)
A Zallet é uma carteira de nó integral do Zcash escrita em Rust. Ela substitui a carteira que antes vinha incorporada ao zcashd. Depois que o zcashd atingiu sua parada de fim de suporte em 18 de julho de 2026, na altura de bloco 3417100, as funções de consenso e de carteira foram separadas: o Zebra ou o Zakura validam a chain, e a Zallet guarda as chaves, escaneia as notes e expõe o JSON-RPC da carteira.
A Zallet está atualmente em beta. Ela ainda não foi totalmente revisada. Mudanças incompatíveis podem exigir que você exclua e recrie a carteira. Não a trate como custódia de produção para grandes quantias de ZEC sem ler os avisos de segurança em The Zallet Book.
zcashd. A metade de nó é o Zebra ou o Zakura.ReadStateService direto em um zebrad local) ou Zaino.wallet.db.zallet (inicializador), zallet-zebra e zallet-zaino.O zcashd reunia em um único processo um nó de consenso derivado do Bitcoin Core e uma carteira. Esse design ficou para trás.
| Função | Stack antiga | Stack atual |
|---|---|---|
| Consenso / P2P | zcashd | Zebra (zebrad) ou Zakura |
| Carteira / chaves / saldos | zcashd wallet.dat | Zallet (wallet.db) |
| Indexador de light client | lightwalletd | Zaino ou lightwalletd |
Separar a carteira do nó significa que:
zcashd.A Zallet é a carteira destinada aos operadores que antes executavam o zcashd como carteira quente, backend de corretora, faucet ou carteira de pagamentos de mineração.
A Zallet está em beta.
Na prática, isso significa que:
zcashd foi portado.zcashd. As integrações devem consultar a página de semântica alterada.Envie seu feedback pelas issues de GitHub ou pelo canal #wallet-dev no Discord de R&D do Zcash.
Uma fase estável está planejada para quando a superfície de RPC pretendida estiver pronta. A partir daí, quem faz chamadas deverá migrar para os métodos da Zallet, incluindo as diferenças semânticas documentadas.
A Zallet é dividida em três workspaces do Cargo para que os dois backends de chain possam seguir grafos de dependências diferentes.
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
Os três binários abrem o mesmo wallet.db. O inicializador escolhe um backend em tempo de execução; você não precisa recompilar para trocar.
Implantação 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
A Zallet é uma carteira de nó integral: ela precisa de um nó validador local. Ela não é um light client. Para carteiras leves e servidores de blocos compactos, veja Zaino e Nós de lightwallet.
A stack de compose Z3 de Zcash Foundation executa Zebra + Zallet juntos, com um Zaino autônomo opcional para light clients externos.
A Zallet é construída em torno de contas ZIP 32, e não da conta implícita única do zcashd.
zip32seedfp1…).(seedfp, account index).z_getaddressforaccount. Uma conta pode ter muitos endereços diversificados; os receptores blindados não podem ser vinculados on-chain.z_importkey) e endereços somente leitura (z_importaddress) se tornam contas UUID que não são cobertas por nenhum mnemônico.z_exportviewingkey, z_importviewingkey), incluindo chaves de visualização completas unificadas e chaves de visualização de entrada.getnewaddress não está implementado. Use z_getnewaccount e z_getaddressforaccount.
Se keystore.require_backup estiver ativado (a forma migrada do walletrequirebackup do zcashd), a Zallet se recusa a derivar nova autoridade de gasto a partir de um mnemônico cujo backup não tenha sido confirmado.
O material de chaves é sempre criptografado. Não existe modo sem criptografia nem o RPC encryptwallet — esse método do zcashd nunca teve suporte completo.
{datadir}/encryption-identity.txt.wallet.db.generate-encryption-identity -p). Desbloqueie com o RPC walletpassphrase; bloqueie com walletlock.wallet.db que você guardar.Copiar wallet.db enquanto a Zallet está em execução não é um backup seguro. O SQLite pode ficar corrompido. Prefira fazer a cópia com o processo parado ou aguarde um comando oficial de backup online.
A Zallet implementa um subconjunto dos RPCs de carteira do zcashd via HTTP com autenticação Basic. Vincule-a ao loopback. O uso remoto deve passar por um túnel criptografado. rpc.allow_insecure_remote_bind existe, mas é inseguro.
Diferenças notáveis em relação ao zcashd:
getwalletinfo estão vazios. Use z_getbalances, z_getbalanceforaccount, z_gettotalbalance.settxfee.ClientInInitialDownload / ForbiddenBySafeMode).Os métodos omitidos intencionalmente incluem createrawtransaction, fundrawtransaction, getnewaddress, getrawchangeaddress, keypoolrefill, importwallet e encryptwallet. As substituições estão listadas no Zallet Book.
Os caminhos oficiais de instalação (pacotes Debian, Docker, binários de release) estão no guia de instalação. Os arquivos compactados de release se chamam zallet-<version>-<arch>.tar.gz e contêm os três binários.
Fluxo mínimo para criar uma carteira nova:
# 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
Aponte a [indexer] para um endpoint JSON-RPC local do zebrad. O backend zebra também precisa de [indexer.read_state_service] e de um zebrad compilado com o recurso de indexador, para que a Zallet possa ler o estado da chain diretamente.
Imagens reproduzíveis podem ser criadas com StageX (Docker 25+, armazenamento de imagens do containerd, GNU Make).
Mantenha o datadir antigo do zcashd até confirmar os saldos e testar uma restauração.
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 só está disponível em builds com o recurso zcashd-import. Para ler wallet.dat, é preciso o db_dump do Berkeley DB 6.2, a versão que o zcashd usava.
Notas passo a passo para operadores: .
| Zallet | zecd | Zashi / ZODL / YWallet | Zebra / Zakura | Zaino | |
|---|---|---|---|---|---|
| O que é | Carteira RPC de nó integral | Servidor de carteira com foco em blindagem | Carteiras para usuários finais | Nó de consenso | Indexador / substituto do lightwalletd |
| Substitui | Carteira do zcashd | Não é um clone direto do zcashd | Apps móveis/desktop | Nó do zcashd | lightwalletd |
| Precisa de um nó local | Sim | Sim (Zebra por padrão) | Não (light client) | Ele é o nó | Sim |
Tanto a Zallet quanto o zecd podem ficar na frente do Zebra. Escolha a Zallet quando precisar da superfície de carteira do z_* e de um caminho de migração a partir do wallet.dat. Escolha o zecd quando quiser um servidor com foco em blindagem que explicitamente não seja um clone do zcashd.
Existe um produto separado para consumidores em zallet.io que usa o mesmo nome. Esse app não é este projeto.
zcashd aposentado| Compatibilidade com o RPC do zcashd |
| Projetada como caminho de compatibilidade |
| Apenas um pequeno subconjunto escolhido |
| N/A |
| Parcial / modo de compatibilidade Zakura |
| API diferente |
| Modelo de custódia | O operador guarda as chaves em wallet.db | Servidor recuperável pela seed | Chaves no dispositivo do usuário | Sem carteira | Sem chaves |