Helius para Agentes - Helius Docs

Helius oferece suporte de primeira classe para agentes de IA construindo no Solana. Desde a criação de contas programáticas até transmissão de dados em tempo real, agentes podem acessar todo o poder do Helius sem qualquer intervenção manual.

Helius MCP — 10 ferramentas roteadas que cobrem consultas à blockchain, envio de transações, transmissão e mais
Plugin Claude Code — O primeiro, e atualmente único, plugin oficial Claude Code de uma empresa de cripto. Uma instalação: servidores MCP + habilidades + arquivos de referência
Habilidades — Conjuntos de instrução especializados para Claude: Build, Phantom, Jupiter, DFlow, OKX, SVM
TypeScript SDK — Métodos com tipagem segura para todas as APIs do Helius
Rust SDK — SDK Rust de alta performance para APIs do Helius
Helius CLI — Gerenciamento de contas e scripts de shell

Uma versão legível por máquina desta seção está disponível em agents/llms.txt para consumo de agentes de IA.

MCP vs CLI

O servidor Helius MCP é a maneira recomendada para agentes de IA interagirem com o Helius. Ele fornece 10 ferramentas roteadas que dão acesso direto e estruturado ao Solana — sem comandos de shell, sem análise de saída, sem chamadas manuais de API.

	MCP	CLI
Melhor para	Agentes de IA em Claude Code, Cursor, Claude Desktop e qualquer ferramenta compatível com MCP	Scripts de shell, pipelines CI/CD, fluxos de trabalho de terminal
Interface	Chamadas de ferramenta estruturadas com entradas/saídas tipadas	Linha de comando com saída `--json`
Capacidades	10 ferramentas roteadas (`heliusWallet`, `heliusAsset`, `heliusTransaction`, …) abrangendo consultas blockchain, transações, webhooks, streaming, análise de carteira, docs e cadastro	95+ comandos: mesmas capacidades mais gerenciamento de configuração e fluxos interativos
Configuração da conta	Integrado: ações `heliusAccount` `generateKeypair` → `signup` (link ou pagamento automático) — sem ferramentas externas necessárias	`helius keygen` → `helius signup`
Quando usar	Escolha padrão para qualquer agente de IA	Quando você precisa de automação a nível de shell ou não está usando uma ferramenta compatível com MCP

Comece com o MCP. Se sua ferramenta de IA suporta MCP (Claude Code, Cursor, Claude Desktop, etc.), use o servidor MCP ou o Plugin Claude Code. O CLI é útil para scripts de shell e CI/CD, mas para fluxos de trabalho orientados por IA o MCP oferece uma experiência mais fluida — a IA chama ferramentas diretamente em vez de gerar comandos de shell e analisar a saída.

Início Rápido: Cadastro de Agente

Agentes podem criar uma conta Helius e obter uma chave de API em quatro etapas usando o Helius CLI:

npm install -g helius-cli    # Install CLI
helius keygen                 # Generate keypair
# (Autopay only) Fund wallet with 1 USDC + ~0.001 SOL — skip if paying via the hosted link
helius signup --email you@example.com --first-name Jane --last-name Doe --json          # Get API key (JSON output)

Com sucesso, seu agente recebe uma chave de API, endpoints RPC e 1.000.000 de créditos. Veja o guia completo do CLI para mais detalhes.

Autenticação

Todas as solicitações às APIs do Helius requerem uma chave de API passada como um parâmetro de consulta:

?api-key=YOUR_API_KEY

Anexe isso a qualquer endpoint RPC ou API. Por exemplo: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY Obtenha uma chave de API do Helius Dashboard ou programaticamente via Helius CLI.

Use o Gatekeeper para menor latência — Gatekeeper (Beta) remove o Cloudflare do caminho crítico, reduzindo os tempos de resposta em dezenas a centenas de milissegundos. Mesma chave de API, mesmos métodos — apenas troque o endpoint:

https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY

Suporta todos os métodos RPC, DAS, WebSocket, ZK Compression, Priority Fee e Enhanced Transaction. Veja o guia de migração para detalhes.

Orientações Específicas das APIs Helius

Use estas APIs otimizadas Helius em vez de encadear métodos padrão RPC do Solana:

Em vez de…	Use isto	Por que
`getSignaturesForAddress` + `getTransaction`	`getTransactionsForAddress`	Chamada única retorna histórico completo de transações com dados de conta de token
`getTokenAccountsByOwner`	`getAssetsByOwner` (API DAS)	Retorna metadados ricos, não apenas contas brutas
`getRecentPrioritizationFees`	`getPriorityFeeEstimate`	Taxas ótimas pré-calculadas, sem cálculo manual
`getSignaturesForAddress` (para cNFTs)	`getSignaturesForAsset` (API DAS)	RPC padrão não funciona para NFTs comprimidos
`getProgramAccounts` (para busca de NFT)	`searchAssets` ou `getAssetsByGroup`	Dados indexados mais rápidos e baratos
Pesquisa de dados em tempo real	LaserStream WebSocket ou LaserStream gRPC	Menor latência, mais eficiente
`sendTransaction` padrão	Helius Sender	Roteamento multi-caminho (Helius, Jito, Harmonic, Rakurai, etc.), maiores taxas de captura

Fluxos de Trabalho Recomendados

Construindo…	Produtos Helius para Usar
Bot de trading	Gatekeeper (RPC de mais baixa latência) + Sender (envio rápido de tx) + Priority Fee API + LaserStream (preços em tempo real)
Aplicativo de carteira	API DAS (`getAssetsByOwner`) + `getTransactionsForAddress` (histórico completo)
Marketplace de NFT	API DAS (`searchAssets`, `getAssetsByGroup`) + Webhooks (rastrear vendas/listagens)
Token sniper	Gatekeeper (RPC roteado na borda) + LaserStream gRPC (menor latência) + Sender (conexões em staking)
Rastreador de portfólio	API DAS (`getAssetsByOwner` com `showFungible`) + Enhanced Transactions
Monitor de carteira	LaserStream WebSocket ou Webhooks para notificações em tempo real
Painel de análise	Enhanced Transactions API + `getTransactionsForAddress`
Ferramenta de airdrop	AirShip (95% mais barato com compressão ZK)

Referência Rápida de Limites de Taxa

Os limites de taxa dependem do seu plano. Agentes começam no nível Agent com 1.000.000 de créditos. O nível Agent requer um pagamento de $1 para prevenir abusos.

Plano	Preço	Créditos Mensais	Limite de Taxa RPC	DAS & Enhanced APIs
Agent	$1 cadastro	1M	10 req/s	2 req/s
Developer	$49/mês	10M	50 req/s	10 req/s
Business	$499/mês	100M	200 req/s	50 req/s
Professional	$999/mês	200M	500 req/s	100 req/s

Para limites de taxa detalhados por API, veja Limites de Taxa.

Créditos por Chamada de API

API	Créditos	Notas
Chamadas padrão RPC	1	A maioria dos métodos RPC do Solana
`getProgramAccounts`	10	Use a API DAS quando possível
API DAS	10	Todos os endpoints DAS
Enhanced Transactions	100	Dados de transação analisados
`getTransactionsForAddress`	10+	Transações completas custam 10 créditos por 100 retornadas; respostas apenas com assinaturas custam 10 créditos fixos.
`getTransfersByAddress`	10	Apenas planos Developer+
API de Carteira	100	Todos os endpoints da API de Carteira
API de Taxa de Prioridade	1	Estimativa de taxa
Sender	0	Gratuito em todos os planos
Eventos de Webhook	1	Por evento entregue
Gestão de Webhook	100	Criar, editar, deletar

Para a análise completa, veja Créditos.

Repetições e Tratamento de Erros

Códigos de Status HTTP

Código	Significado	Ação
200	Sucesso	Processar resposta
400	Solicitação inválida	Corrigir parâmetros de solicitação
401	Não autorizado	Verificar chave de API
429	Limite de taxa	Retardar e tentar novamente
5xx	Erro de servidor	Tentar novamente com aumento exponencial de intervalo

Padrão de Repetição

async function heliusRequest(url: string, data: object, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(data),
    });

    if (response.ok) return response.json();

    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After');
      const delay = retryAfter ? parseInt(retryAfter) * 1000 : Math.pow(2, attempt) * 1000;
      await new Promise(resolve => setTimeout(resolve, delay));
      continue;
    }

    if (response.status >= 500) {
      await new Promise(resolve => setTimeout(resolve, Math.pow(2, attempt) * 1000));
      continue;
    }

    throw new Error(`Request failed: ${response.status} ${await response.text()}`);
  }
  throw new Error('Max retries exceeded');
}

Monitorar Uso de Créditos

helius usage --json

Referência Rápida

Mainnet RPC: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
Mainnet RPC (Gatekeeper Beta): https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
Devnet RPC: https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
Mainnet WSS: wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
Mainnet WSS (Gatekeeper Beta): wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY
Devnet WSS: wss://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
Endpoint do Sender: https://sender.helius-rpc.com/fast
Servidor MCP: https://www.helius.dev/docs/mcp
Painel: dashboard.helius.dev
Status: helius.statuspage.io

​MCP vs CLI

​Início Rápido: Cadastro de Agente

​Autenticação

​Orientações Específicas das APIs Helius

​Fluxos de Trabalho Recomendados

​Referência Rápida de Limites de Taxa

​Créditos por Chamada de API

​Repetições e Tratamento de Erros

​Códigos de Status HTTP

​Padrão de Repetição

​Monitorar Uso de Créditos

​Referência Rápida

MCP vs CLI

Início Rápido: Cadastro de Agente

Autenticação

Orientações Específicas das APIs Helius

Fluxos de Trabalho Recomendados

Referência Rápida de Limites de Taxa

Créditos por Chamada de API

Repetições e Tratamento de Erros

Códigos de Status HTTP

Padrão de Repetição

Monitorar Uso de Créditos

Referência Rápida