> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Referência de Comandos CLI

> Referência completa para todos os mais de 95 comandos CLI do Helius — gerenciamento de contas, consultas de blockchain, transações, DAS API, carteira, webhooks, streaming, staking, compressão ZK, e mais.

Cada comando suporta `--json` para saída legível por máquina e `--api-key <key>` / `--network <net>` substituições globais. Veja [Opções Globais](/docs/pt-BR/agents/cli#global-options) para mais detalhes.

## Gerenciamento de Contas

Crie contas Helius, gere pares de chaves, autentique, atualize planos e pague renovações.

| Comando           | Descrição                                                                                                                               |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `helius keygen`   | Gerar um novo par de chaves Solana                                                                                                      |
| `helius signup`   | Criar uma conta Helius (requer `--email`, `--first-name`, `--last-name`; suporta `--plan`, `--period`, `--coupon`, `--pay`, `--resume`) |
| `helius login`    | Autenticar com uma carteira existente                                                                                                   |
| `helius upgrade`  | Atualizar seu plano (requer `--email`, `--first-name`, `--last-name`; suporta `--plan`, `--period`, `--coupon`)                         |
| `helius pay <id>` | Pagar uma intenção de pagamento existente (por exemplo, renovação)                                                                      |

## Gerenciamento de Projeto e Chave API

Listar projetos, criar e gerenciar chaves API, verificar uso de crédito e obter endpoints RPC.

| Comando                              | Descrição                       |
| ------------------------------------ | ------------------------------- |
| `helius projects`                    | Listar todos os projetos        |
| `helius project [id]`                | Obter detalhes do projeto       |
| `helius apikeys [project-id]`        | Listar chaves API de um projeto |
| `helius apikeys create [project-id]` | Criar uma nova chave API        |
| `helius usage [project-id]`          | Mostrar uso de créditos         |
| `helius rpc [project-id]`            | Mostrar endpoints RPC           |

## Configuração

Gerenciar configurações locais da CLI — chave API, rede, projeto padrão e credenciais armazenadas.

| Comando                           | Descrição                                                               |
| --------------------------------- | ----------------------------------------------------------------------- |
| `helius config show`              | Mostrar configuração atual (`--reveal` para mostrar chave API completa) |
| `helius config set-api-key <key>` | Definir chave API do Helius                                             |
| `helius config set-network <net>` | Definir rede (mainnet ou devnet)                                        |
| `helius config set-project <id>`  | Definir ID do projeto padrão                                            |
| `helius config clear`             | Limpar toda configuração                                                |

## Saldo & Tokens

Consultar saldos nativos de SOL, participações de tokens fungíveis e principais detentores de tokens.

| Comando                       | Descrição                                           |
| ----------------------------- | --------------------------------------------------- |
| `helius balance <address>`    | Obter saldo nativo de SOL                           |
| `helius tokens <address>`     | Obter saldos de tokens fungíveis (`--limit`)        |
| `helius token-holders <mint>` | Obter principais detentores de um token (`--limit`) |

## Transações

Analisar transações em formato legível, buscar histórico aprimorado e estimar taxas de prioridade.

| Comando                           | Descrição                                                                  |
| --------------------------------- | -------------------------------------------------------------------------- |
| `helius tx parse <signatures...>` | Analisar transação(ões) em formato legível                                 |
| `helius tx history <address>`     | Obter histórico de transações aprimorado (`--limit`, `--before`, `--type`) |
| `helius tx fees`                  | Obter estimativas de taxas de prioridade (`--accounts`)                    |

## Ativos Digitais (DAS API)

Consultar NFTs, NFTs comprimidos, tokens fungíveis e contas de tokens usando a API do Padrão de Ativos Digitais.

| Comando                             | Descrição                                                                 |
| ----------------------------------- | ------------------------------------------------------------------------- |
| `helius asset get <id>`             | Obter detalhes do ativo por endereço de mint                              |
| `helius asset batch <ids...>`       | Obter múltiplos ativos                                                    |
| `helius asset owner <address>`      | Obter ativos por proprietário (`--page`, `--limit`)                       |
| `helius asset creator <address>`    | Obter ativos por criador (`--verified`)                                   |
| `helius asset authority <address>`  | Obter ativos por autoridade de atualização                                |
| `helius asset collection <address>` | Obter ativos em uma coleção                                               |
| `helius asset search`               | Pesquisar com filtros (`--owner`, `--creator`, `--compressed`, `--burnt`) |
| `helius asset proof <id>`           | Obter prova de Merkle para um NFT comprimido                              |
| `helius asset proof-batch <ids...>` | Provas de Merkle em lote                                                  |
| `helius asset editions <mint>`      | Obter edições de NFT                                                      |
| `helius asset signatures <id>`      | Obter assinaturas de transação para um ativo                              |
| `helius asset token-accounts`       | Consultar contas de tokens (`--owner`, `--mint`)                          |

## API de Carteira

Pesquisar identidades de carteira, obter saldos de portfólio com valores em USD, visualizar histórico de transações e rastrear fontes de financiamento.

| Comando                                              | Descrição                                                             |
| ---------------------------------------------------- | --------------------------------------------------------------------- |
| `helius wallet identity <address-or-domain>`         | Pesquisar quem possui uma carteira (aceita `.sol` e domínios ANS)     |
| `helius wallet identity-batch <addrs-or-domains...>` | Pesquisa de identidade em lote (mistura endereços e domínios)         |
| `helius wallet balances <address>`                   | Obter todos os saldos de tokens com valores em USD (`--show-nfts`)    |
| `helius wallet history <address>`                    | Histórico de transações com alterações de saldo (`--type`, `--limit`) |
| `helius wallet transfers <address>`                  | Transferências de tokens com informações do remetente/destinatário    |
| `helius wallet funded-by <address>`                  | Encontrar fonte original de financiamento                             |

## Webhooks

Criar, atualizar, listar e excluir webhooks HTTP em tempo real para monitoramento de eventos on-chain.

| Comando                      | Descrição                                                             |
| ---------------------------- | --------------------------------------------------------------------- |
| `helius webhook list`        | Listar todos os webhooks                                              |
| `helius webhook get <id>`    | Obter detalhes do webhook                                             |
| `helius webhook create`      | Criar um webhook (`--url`, `--accounts`, `--types`, `--webhook-type`) |
| `helius webhook update <id>` | Atualizar um webhook                                                  |
| `helius webhook delete <id>` | Excluir um webhook                                                    |

## Envio de Transações

Transmitir transações assinadas, enviar via Helius Sender para latência ultra-baixa, e estimar unidades de computação.

| Comando                                 | Descrição                                                       |
| --------------------------------------- | --------------------------------------------------------------- |
| `helius send broadcast <base64-tx>`     | Transmitir uma transação assinada e aguardar confirmação        |
| `helius send raw <base64-tx>`           | Enviar uma transação bruta                                      |
| `helius send sender <base64-tx>`        | Enviar via Helius Sender para latência ultra-baixa (`--region`) |
| `helius send poll <signature>`          | Acompanhar status da transação até confirmado                   |
| `helius send compute-units <base64-tx>` | Simular e retornar estimativa de unidade de computação          |

## Assinaturas WebSocket

Transmitir mudanças de conta em tempo real, logs de transações, atualizações de slot e atividade de programas via WebSockets.

| Comando                          | Descrição                                     |
| -------------------------------- | --------------------------------------------- |
| `helius ws account <address>`    | Transmitir notificações de mudanças de conta  |
| `helius ws logs`                 | Transmitir notificações de log (`--mentions`) |
| `helius ws slot`                 | Transmitir notificações de slot               |
| `helius ws signature <sig>`      | Transmitir confirmação de assinatura          |
| `helius ws program <program-id>` | Transmitir mudanças de conta de programa      |

## Contas de Programa

Buscar contas de programas Solana, com filtragem opcional e paginação automática.

| Comando                                    | Descrição                                              |
| ------------------------------------------ | ------------------------------------------------------ |
| `helius program accounts <program-id>`     | Obter contas de um programa (`--data-size`, `--limit`) |
| `helius program accounts-all <program-id>` | Obter todas as contas do programa (auto-paginar)       |
| `helius program token-accounts <owner>`    | Obter contas de tokens por proprietário                |

## Staking

Criar transações de stake, desfazer stake, retirar e inspecionar contas de stake do Helius.

| Comando                                       | Descrição                          |
| --------------------------------------------- | ---------------------------------- |
| `helius stake create <amount>`                | Criar uma transação de stake (SOL) |
| `helius stake unstake <stake-account>`        | Desfazer stake                     |
| `helius stake withdraw <stake-account>`       | Retirar SOL em stake               |
| `helius stake accounts <wallet>`              | Listar contas de stake do Helius   |
| `helius stake withdrawable <stake-account>`   | Verificar valor retirável          |
| `helius stake instructions <amount>`          | Obter instruções de stake          |
| `helius stake unstake-instruction <account>`  | Obter instrução de desfazer stake  |
| `helius stake withdraw-instruction <account>` | Obter instrução de retirada        |

## Compressão ZK

Consultar contas comprimidas, saldos de tokens, provas de Merkle, provas de validade e assinaturas de compressão.

| Comando                                           | Descrição                                           |
| ------------------------------------------------- | --------------------------------------------------- |
| `helius zk account <addr-or-hash>`                | Obter conta comprimida                              |
| `helius zk accounts-by-owner <owner>`             | Obter contas comprimidas por proprietário           |
| `helius zk balance <addr-or-hash>`                | Obter saldo comprimido                              |
| `helius zk balance-by-owner <owner>`              | Obter saldo comprimido por proprietário             |
| `helius zk token-holders <mint>`                  | Obter detentores de tokens comprimidos              |
| `helius zk token-balance <account>`               | Obter saldo de tokens comprimidos                   |
| `helius zk token-accounts-by-owner <owner>`       | Obter contas de tokens comprimidos por proprietário |
| `helius zk token-accounts-by-delegate <delegate>` | Obter contas de tokens comprimidos por delegado     |
| `helius zk token-balances-by-owner <owner>`       | Obter saldos de tokens comprimidos (V2)             |
| `helius zk proof <addr-or-hash>`                  | Obter prova de conta comprimida                     |
| `helius zk proofs <addresses...>`                 | Obter múltiplas provas                              |
| `helius zk multiple-accounts <addresses...>`      | Obter múltiplas contas comprimidas                  |
| `helius zk address-proofs <addresses...>`         | Obter novas provas de endereço (V2)                 |
| `helius zk signatures-account <account>`          | Assinaturas para conta comprimida                   |
| `helius zk signatures-address <address>`          | Assinaturas para endereço                           |
| `helius zk signatures-owner <owner>`              | Assinaturas para proprietário                       |
| `helius zk signatures-token-owner <owner>`        | Assinaturas para proprietário de token              |
| `helius zk latest-signatures`                     | Assinaturas de compressão mais recentes             |
| `helius zk latest-non-voting`                     | Assinaturas mais recentes sem votação               |
| `helius zk tx <signature>`                        | Transação com informação de compressão              |
| `helius zk validity-proof`                        | Obter prova de validade (`--hashes`, `--addresses`) |
| `helius zk indexer-health`                        | Verificar saúde do indexador ZK                     |
| `helius zk indexer-slot`                          | Obter slot do indexador ZK                          |
| `helius zk signatures-for-asset <id>`             | Assinaturas de compressão para ativo                |

## Conta & Rede

Inspecionar contas individuais do Solana, verificar status da rede e buscar detalhes do bloco.

| Comando                    | Descrição                                  |
| -------------------------- | ------------------------------------------ |
| `helius account <address>` | Obter informações da conta Solana          |
| `helius network-status`    | Obter status da rede Solana                |
| `helius block <slot>`      | Obter detalhes do bloco por número de slot |

## Documentos de Melhoria Solana

Navegar e ler propostas SIMD que definem mudanças no protocolo Solana.

| Comando                    | Descrição                         |
| -------------------------- | --------------------------------- |
| `helius simd list`         | Listar todas as propostas SIMD    |
| `helius simd get <number>` | Ler um SIMD específico por número |
