Guia de referência rápida da Zallet
TL;DR
- A Zallet é uma carteira Zcash de nó integral escrita em Rust. Ela substitui a carteira que antes fazia parte do zcashd.
- O zcashd chegou à sua interrupção de fim de suporte em 18 de julho de 2026 e não é mais executado. O Zebra agora gerencia o lado do nó; a Zallet gerencia o lado da carteira.
- Você opera a Zallet pela linha de comando com
zallet rpc <command>, de forma semelhante a como usava zcash-cli antes.
- Todos os argumentos após o nome do comando precisam ser JSON válido, o que significa que os valores de texto mantêm suas aspas duplas.
- A Zallet está em beta. Os comandos podem mudar entre versões, e nem todos os RPCs do zcashd foram migrados ainda.
Explicação principal
A Zallet expõe suas funcionalidades por meio de JSON-RPC, o mesmo estilo de interface que a carteira do zcashd usava. Tudo o que você quiser que a carteira faça — verificar um saldo, criar uma conta, enviar um pagamento blindado — é um comando que você passa para zallet rpc.
Duas coisas diferem do antigo hábito com zcash-cli e explicam a maioria dos erros iniciais. Primeiro, os argumentos precisam ser JSON válido em vez de texto simples, por isso um argumento de texto traz suas próprias aspas dentro das aspas do shell. Segundo, o conjunto de comandos disponíveis depende da versão beta que você está executando, por isso a lista incorporada ao seu binário é mais confiável do que qualquer página escrita, incluindo esta.
Para listar todos os RPCs disponíveis:
Code-highlight
zallet rpc help
Para obter ajuda detalhada sobre um RPC específico:
Code-highlight
zallet rpc help '"<command>"'
Importante: Todos os argumentos após o nome do método precisam ser JSON válido.
Os valores de texto têm de ser escritos como "value" (incluindo as aspas duplas).
Erros comuns
- Omitir as aspas internas em argumentos de texto.
zallet rpc validateaddress u1abc... falha, porque o endereço tem de chegar como JSON. Tem de ser escrito como '"u1abc..."'.
- Supor que todos os RPCs existem aqui. A migração ainda está em andamento. Alguns métodos se comportam de forma idêntica, alguns precisam de uso diferente e alguns não serão migrados.
- Tratar esta página como mais confiável do que seu binário. A Zallet está em beta e evolui rapidamente. Quando um comando desta página não funcionar, verifique
zallet rpc help antes de supor que algo está quebrado.
- Esperar que a Zallet seja um nó. Ela é a metade da carteira do par. O Zebra executa o nó, e a Zallet se comunica com ele.
Comandos RPC
decoderawtransaction
Code-highlight
zallet rpc decoderawtransaction '"<hexstring>"'
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| hexstring | string | sim | String hexadecimal da transação |
decodescript
Code-highlight
zallet rpc decodescript '"<hexstring>"'
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| hexstring | string | sim | Script em hex |
getrawtransaction
Code-highlight
zallet rpc getrawtransaction '"<txid>"' [verbose] ['"<blockhash>"']
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|
| txid | string | sim | | ID da transação |
| verbose | number | não | 0 | 0 = hex, diferente de zero = objeto JSON |
| blockhash | string | não | | Restringir a busca a este bloco |
getwalletinfo
Code-highlight
zallet rpc getwalletinfo
Sem parâmetros.
getwalletstatus
Code-highlight
zallet rpc getwalletstatus
Sem parâmetros.
listaddresses
Code-highlight
zallet rpc listaddresses
Sem parâmetros.
rpc.discover
Code-highlight
zallet rpc rpc.discover
Sem parâmetros. Retorna o esquema OpenRPC.
stop
Code-highlight
zallet rpc stop
Sem parâmetros. (Apenas Regtest)
validateaddress
Code-highlight
zallet rpc validateaddress '"<address>"'
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| address | string | sim | Endereço transparente |
verifymessage
Code-highlight
zallet rpc verifymessage '"<address>"' '"<signature>"' '"<message>"'
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| address | string | sim | Endereço transparente |
| signature | string | sim | Assinatura Base64 |
| message | string | sim | Mensagem original |
walletlock
Code-highlight
zallet rpc walletlock
Sem parâmetros.
walletpassphrase
Code-highlight
zallet rpc walletpassphrase '"<passphrase>"' <timeout>
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| passphrase | string | sim | Senha da carteira |
| timeout | number | sim | Segundos para manter a carteira desbloqueada |
z_converttex
Code-highlight
zallet rpc z_converttex '"<transparent_address>"'
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| transparent_address | string | sim | Endereço P2PKH a converter |
z_exportkey
Code-highlight
zallet rpc z_exportkey '"<sapling_address>"'
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| address | string | sim | Endereço Sapling cuja chave de gastos será exportada |
A carteira precisa estar desbloqueada. Exporta apenas a chave de gastos Sapling.
z_getaccount
Code-highlight
zallet rpc z_getaccount '"<account_uuid>"'
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| account_uuid | string | sim | UUID da conta |
z_getaddressforaccount
Code-highlight
zallet rpc z_getaddressforaccount <account> ['["p2pkh","sapling","orchard"]'] [<diversifier_index>]
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| account | string / number | sim | UUID da conta ou índice da conta ZIP-32 |
| receiver_types | array of string | não | Tipos de receiver a incluir |
| diversifier_index | number | não | Índice específico do diversifier |
z_getbalanceforaccount
Code-highlight
zallet rpc z_getbalanceforaccount <account> [<minconf>]
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|
| account | string / number | sim | | UUID da conta ou índice ZIP-32 |
| minconf | number | não | 1 | Confirmações mínimas |
z_getbalances
Code-highlight
zallet rpc z_getbalances [<minconf>]
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|
| minconf | number | não | 1 | Confirmações mínimas |
z_getnewaccount
Code-highlight
zallet rpc z_getnewaccount '"<account_name>"' ['"<seedfp>"']
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| account_name | string | sim | Nome legível para humanos |
| seedfp | string | não | Obrigatório se a carteira tiver várias seeds |
z_getnotescount
Code-highlight
zallet rpc z_getnotescount [<minconf>] [<as_of_height>]
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|
| minconf | number | não | 1 | Confirmações mínimas |
| as_of_height | number | não | | Consultar a partir desta altura (-1 = tip) |
z_getoperationresult
Code-highlight
zallet rpc z_getoperationresult ['["opid1","opid2"]']
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| operationid | array of string | não | IDs de operação (omitir para todas as concluídas) |
z_getoperationstatus
Code-highlight
zallet rpc z_getoperationstatus ['["opid1","opid2"]']
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| operationid | array of string | não | IDs de operação (omitir para todas) |
z_gettotalbalance
Code-highlight
zallet rpc z_gettotalbalance [<minconf>] [<include_watchonly>]
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|
| minconf | number | não | 1 | Confirmações mínimas |
| include_watchonly | boolean | não | false | Incluir saldos somente de observação |
z_importaddress
Code-highlight
zallet rpc z_importaddress '"<account_uuid>"' '"<hex_data>"' [<rescan>]
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|
| account | string | sim | | UUID da conta |
| hex_data | string | sim | | Chave pública em hex ou redeem script |
| rescan | boolean | não | true | Reexaminar após a importação |
z_importkey
Code-highlight
zallet rpc z_importkey '"<key>"' ['"<rescan>"'] [<start_height>]
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|
| key | string | sim | | Chave de gastos estendida Sapling |
| rescan | string | não | "whenkeyisnew" | "yes", "no" ou "whenkeyisnew" |
| start_height | number | não | 0 | Altura inicial do reexame |
z_listaccounts
Code-highlight
zallet rpc z_listaccounts [<include_addresses>]
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|
| include_addresses | boolean | não | true | Também retornar endereços de cada conta |
z_listoperationids
Code-highlight
zallet rpc z_listoperationids ['"<status>"']
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| status | string | não | Filtrar por status (ex.: "success") |
z_listtransactions
Code-highlight
zallet rpc z_listtransactions ['"<account_uuid>"'] [<start_height>] [<end_height>] [<offset>] [<limit>]
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| account_uuid | string | não | Limitar a uma conta |
| start_height | number | não | Limite inferior inclusivo |
| end_height | number | não | Limite superior exclusivo |
| offset | number | não | Ignorar esta quantidade de resultados |
| limit | number | não | Número máximo de resultados a retornar |
z_listunifiedreceivers
Code-highlight
zallet rpc z_listunifiedreceivers '"<unified_address>"'
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| unified_address | string | sim | Unified Address a inspecionar |
z_listunspent
Code-highlight
zallet rpc z_listunspent [<minconf>] [<maxconf>] [<include_watchonly>] ['["addr1","addr2"]'] [<as_of_height>]
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|
| minconf | number | não | 1 | Confirmações mínimas |
| maxconf | number | não | ∞ | Confirmações máximas |
| include_watchonly | boolean | não | false | Incluir somente de observação |
| addresses | array of string | não | | Filtrar por estes endereços |
| as_of_height | number | não | | Consultar nesta altura |
z_recoveraccounts
Code-highlight
zallet rpc z_recoveraccounts '[{"name":"...","seedfp":"...","zip32_account_index":0,"birthday_height":123456}]'
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| accounts | array | sim | Array de objetos: name, seedfp, zip32_account_index, birthday_height |
z_sendmany
Code-highlight
zallet rpc z_sendmany '"<fromaddress>"' '[{"address":"...","amount":1.23,"memo":"..."}]' [<minconf>] [null] ['"<privacy_policy>"']
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|
| fromaddress | string | sim | | Endereço de origem ou "ANY_TADDR" |
| amounts | array of object | sim | | Destinatários (address, amount, memo opcional) |
| minconf | number | não | | Confirmações mínimas |
| fee | null | não | | Deve ser null (apenas ZIP-317) |
| privacy_policy | string | não | "FullPrivacy" | String da política de privacidade |
z_shieldcoinbase
Code-highlight
zallet rpc z_shieldcoinbase '"<fromaddress_or_account_uuid>"' '"<toaddress>"' [null] [<limit>] ['"<memo_hex>"'] ['"<privacy_policy>"']
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| fromaddress | string | sim | Endereço transparente ou UUID da conta |
| toaddress | string | sim | Destino blindado |
| fee | null | não | Deve ser null |
| limit | number | não | Número máximo de UTXOs coinbase a blindar |
| memo | string | não | Memorando codificado em hex |
| privacy_policy | string | não | AllowRevealedSenders ou AllowLinkingAccountAddresses |
z_viewtransaction
Code-highlight
zallet rpc z_viewtransaction '"<txid>"'
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
| txid | string | sim | ID da transação |
Páginas relacionadas
