NOVO: Solana Privacy Rings já está disponível na mainnet
Helius para agentes
Blog/Atualizações

Helius para agentes

Developer Experience Engineer0xIchigo no X0xIchigo no LinkedIn0xIchigo no GitHub
9 min de leitura

Agentes de IA precisam de ferramentas estruturadas, fluxos de trabalho claros e o contexto certo para criar aplicativos prontos para produção na Solana.

Sem isso, os agentes tentam adivinhar chamadas de API, inventam endpoints, fixam no código taxas que deveriam ser dinâmicas e deixam de usar caminhos mais rápidos, como Helius Sender e LaserStream.

Para resolver isso, estamos lançando um conjunto de ferramentas para agentes que desenvolvem com a Helius:

  1. Helius MCP Server
  2. Helius Skills
  3. Helius CLI
  4. Helius Claude Code Plugin

Também otimizamos incansavelmente nossos SDKs de TypeScript e Rust, além da nossa documentação, para facilitar a recomendação e o uso eficaz dessas ferramentas por agentes autônomos e assistentes de IA. 

Veja o que cada ferramenta faz e como elas funcionam em conjunto:

O Helius MCP Server: as ferramentas

O Model Context Protocol (MCP) é um padrão de código aberto apresentado pela Anthropic para permitir que modelos de IA se conectem com segurança a fontes de dados, ferramentas e APIs externas. Ele substitui integrações personalizadas por uma interface universal e padronizada. 

O Helius MCP Server disponibiliza a Helius — e a Solana — para qualquer cliente MCP.

Sem MCP, um agente que tenta verificar o saldo de uma carteira precisa abrir um shell, montar um comando curl, enviá-lo, analisar a saída JSON e torcer para ter acertado o endpoint e os parâmetros.

Multiplique isso por cada chamada de API em um fluxo de trabalho e você terá interações lentas, frágeis e propensas a erros, prejudicadas pela necessidade de criar instâncias de shell para cada comando.

Com o MCP, nada disso acontece.

O agente chama getBalance como uma chamada estruturada de ferramenta e recebe uma resposta tipada. Sem shell. Sem curl. Sem analisar a saída — simplesmente funciona.

O mesmo vale para parseTransaction, getAssetsByOwner, createWebhook e todas as outras mais de 60 ferramentas. Agora, os agentes podem usar a Helius diretamente com os parâmetros corretos e receber dados estruturados. 

O Helius MCP Server oferece ferramentas para:

  • Cadastro autônomo: criar contas, obter chaves de API, fazer upgrade etc.
  • Dados da blockchain em tempo real: RPC, DAS API, ZK Compression e muito mais
  • Streaming de dados:  WebSockets (padrão e aprimorados), LaserStream gRPC (latência no nível de shred)
  • Envio de transações: Priority Fee API, transferências SPL e Sender
  • Webhooks: criar, atualizar e excluir notificações orientadas por eventos
  • Carteira e histórico: saldos, transferências, análise de transações, identidade da carteira e análise de financiamento
  • Conhecimento sobre a Solana: SIMDs, referências ao código-fonte do Agave e Firedancer, conteúdo do blog da Helius e pesquisa na documentação oficial da Solana

Instalação rápida

Para adicionar o Helius MCP Server com o Claude Code, execute:

Código
claude mcp add helius npx helius-mcp@latest

Para o Codex, execute:

Código
codex mcp add helius -- npx helius-mcp@latest

Para Cursor, VS Code ou ferramentas semelhantes, adicione à sua configuração do MCP:

Código
{
  "mcpServers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

Depois, defina sua chave de API usando a ferramenta setHeliusApiKey ou uma variável de ambiente (por exemplo, HELIUS_API_KEY) e comece a desenvolver.

Para novos usuários, seu agente pode criar uma conta de forma autônoma: ele gera um par de chaves e chama signup com seu e-mail e nome. Depois, você paga pelo plano desejado pelo link de pagamento (ou adiciona fundos ao par de chaves para pagamentos automáticos). 

Helius Skills: o cérebro

O MCP oferece aos agentes acesso a mais de 60 ferramentas. No entanto, apenas o acesso não é suficiente — um agente com um catálogo de ferramentas é como um desenvolvedor com várias abas de documentação abertas e nenhuma experiência. Ele consegue chamar as ferramentas, mas não sabe qual usar, como combiná-las para uma tarefa específica nem quais erros evitar. 

As skills são o cérebro. Elas são conjuntos de instruções especializadas — prompts cuidadosamente elaborados com lógica de roteamento, arquivos de referência e regras — que ensinam um agente a atuar como um desenvolvedor especialista em Solana.

Quando uma skill é carregada, o agente sabe que searchAssets é melhor que getProgramAccounts para consultas de NFTs, que as taxas de prioridade devem ser obtidas dinamicamente por getPriorityFeeEstimates e que as transações devem passar pelo Sender para maximizar as taxas de inclusão. As skills dão ao seu agente conhecimento especializado no domínio.

Hoje, estamos lançando quatro Helius Skills principais:

Build

A skill Build é voltada ao desenvolvimento principal na Solana. Ela encaminha para as ferramentas certas de DAS, Sender, WebSockets, LaserStream, Webhooks, Enhanced Transactions, análise de carteiras e onboarding. Essa é a skill padrão para criar qualquer solução na Solana com a Helius. 

DFlow

A skill DFlow serve para criar aplicativos de negociação. Ela combina as APIs da DFlow (ou seja, swaps à vista, mercados de previsão, streaming em tempo real e Proof KYC) com a infraestrutura da Helius para envio de transações, otimização de taxas e monitoramento on-chain. 

Phantom

A skill Phantom serve para criar aplicativos frontend com o Phantom Connect SDK. Ela abrange conexões de carteira, acesso baseado em tokens, emissão de NFTs, pagamentos com criptomoedas, exibição de portfólios e arquitetura frontend segura.

SVM

A skill SVM permite que os agentes entendam os detalhes internos do protocolo Solana. Explore como o bytecode sBPF é executado, considerações sobre o design do Alpenglow, a economia dos validadores e muito mais, consultando conteúdo em tempo real do blog da Helius, SIMDs e o código-fonte do Agave/Firedancer. Não requer chave de API.

Como as skills funcionam

As skills são independentes de modelo. Cada uma inclui variantes pré-configuradas de prompts de sistema para funcionar em todas as plataformas, não apenas no Claude.

Use openai.developer.md para a OpenAI API, claude.system.md para a Claude API ou full.md para Cursor Rules, instruções personalizadas do ChatGPT ou qualquer outra ferramenta. Consulte a visão geral das skills para ver a configuração específica de cada plataforma.

As skills são instaladas automaticamente quando você usa o Helius Claude Code Plugin. Skills independentes podem ser instaladas como Agent Skills — acionadas automaticamente, sem necessidade de comando com barra:

Código
# Clone our AI tooling repo
git clone https://github.com/helius-labs/core-ai.git

# Navigate to helius-skills
cd core-ai/helius-skills

# Install your desired skill
./helius/install.sh            # Build skill → ~/.claude/skills/helius/
./helius-dflow/install.sh      # DFlow skill → ~/.claude/skills/helius-dflow/
./svm/install.sh               # SVM skill   → ~/.claude/skills/svm/

Com essas skills, os agentes podem criar praticamente qualquer aplicativo na Solana — de frontends de negociação e aplicativos de mercados de previsão a processadores de pagamentos com stablecoins — com os padrões corretos desde o início.

O Helius Claude Code Plugin: o pacote completo

O MCP oferece as ferramentas, enquanto as skills são o cérebro. O Helius Claude Code Plugin é o pacote completo: uma única instalação que conecta tudo. Simplesmente funciona.

O plugin reúne o Helius MCP, o DFlow MCP, as quatro skills e arquivos de referência detalhados para todos os produtos da Helius.

Sem configuração manual do MCP. Sem configuração separada das skills.

Com uma única instalação, seu agente passa a ter acesso estruturado à blockchain e conhecimento especializado sobre a Solana em uma só sessão.

Instalação rápida

Veja como instalar o Helius Plugin pelo marketplace do Claude Code:

Código
/plugin marketplace add helius-labs/core-ai
/plugin install helius@helius-labs

Pronto. O plugin inicia automaticamente os dois servidores MCP e atualmente oferece quatro comandos com barra:

SkillComandoO que faz
Build/helius:buildDesenvolvimento principal na Solana com todas as APIs da Helius
Phantom/helius:phantomdApps frontend criados com o Phantom Connect SDK e a Helius
DFlow/helius:dflowAplicativos de negociação criados com DFlow e Helius
SVM/helius:svmConhecimento aprofundado sobre o protocolo Solana

A configuração da chave de API é a mesma do MCP independente: use uma chave existente, habilite o cadastro autônomo ou use a Helius CLI. 

Como isso funciona na prática

Com o plugin instalado, você pode transformar um único prompt em um aplicativo funcional. Por exemplo:

“Crie para mim uma CLI de declaração fiscal para que eu possa consultar a atividade on-chain de Toly usando o endereço de carteira 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY. Comece pelo mês passado (fevereiro) e gere um arquivo CSV que detalhe todos os eventos tributáveis. Crie-a para funcionar com qualquer carteira e período.”

O Claude faz tudo com uma única instrução:   

A skill /helius:build entra em ação e sugere corretamente getTransactionsByAddress com paginação e filtragem por data e hora para retornar um histórico de transações totalmente analisado com base na atividade recente de Toly.

Sem seleção manual de ferramentas nem prompts intermediários. O agente lê os arquivos de referência corretos, aciona as ferramentas MCP certas e produz uma CLI funcional compatível com qualquer carteira e intervalo de datas.

É claro que os agentes também podem criar aplicativos mais complexos, como bots de negociação:

Neste exemplo, instalamos o Helius Claude Code Plugin e pedimos ao Claude que criasse um bot de negociação capaz de acompanhar tokens da PumpFun em tempo real, transmitindo criações e negociações de tokens por LaserStream.

Também pedimos que ele exibisse dados de mercado e gráficos básicos para que pudéssemos simular negociações. Só isso. O Claude criou este bot de negociação, com streaming e negociação de tokens em tempo real, em menos de 10 minutos.

Essa é a diferença entre dar ferramentas a um agente e dar conhecimento especializado a ele.

A Helius CLI

A Helius CLI é uma interface de linha de comando completa com mais de 95 comandos de CLI, abrangendo desde o gerenciamento de contas até consultas à Solana, envio de transações, gerenciamento de webhooks, streaming em tempo real, staking, ZK Compression e muito mais.

Embora recomendemos o MCP para fluxos de trabalho orientados por IA — chamadas estruturadas de ferramentas são melhores do que criar instâncias de shell e analisar saídas —, a CLI é a escolha certa para scripts de shell, criação de pipelines de CI/CD ou trabalho em ambientes nos quais o MCP não está disponível. Todos os comandos são compatíveis com a opção --json para gerar uma saída legível por máquina e retornam códigos de saída estruturados, permitindo que automações tratem erros programaticamente.

Instalação rápida

Para novos usuários, o fluxo é simples:

Código
# Install the CLI
npm install -g helius-cli
helius keygen                    # Generate keypair

# Signup requires a valid email and name
helius signup --email you@example.com --first-name Jane --last-name Doe
# Pay via the printed link with any wallet, then:
helius signup --resume           # Finalize and get API key
helius projects                  # List projects
helius apikeys <project-id>      # Get API keys

Para usuários existentes, basta executar:

Código
helius config set-api-key YOUR_API_KEY

SDKs otimizados para agentes

Para agentes que criam aplicativos programaticamente, publicamos uma documentação otimizada para agentes sobre nossos SDKs de TypeScript e Rust.

Essas páginas abrangem padrões recomendados para fluxos de trabalho comuns de agentes, incluindo o envio de transações por Sender, processamento em lote, dados em tempo real, paginação e tratamento de erros. 

TypeScript SDK

O Helius TypeScript SDK oferece métodos com segurança de tipos para cada chamada de API da Helius. O principal benefício para os agentes é que os métodos específicos da Helius transformam fluxos de trabalho de várias etapas da Solana em chamadas únicas. 

Por exemplo, getTransactionsForAddress substitui o padrão antiquado de duas etapas, que primeiro consulta assinaturas e depois transações, por uma única chamada com filtragem no servidor, intervalos de tempo e suporte a contas de tokens: 

Código
import { createHelius } from "helius-sdk";

const helius = createHelius({ apiKey: "YOUR_API_KEY" });

// Single call: full transaction history with token activity
const txs = await helius.getTransactionsForAddress([
  "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
  {
    transactionDetails: "full",
    limit: 100,
    filters: { tokenAccounts: "balanceChanged" },
  },
]);

Da mesma forma, sendSmartTransaction gerencia automaticamente a simulação, a estimativa de unidades de computação, as taxas de prioridade e a confirmação.

sendTransactionWithSender leva isso a outro nível, com otimização para o envio de transações com latência ultrabaixa.

Consulte as práticas recomendadas de TypeScript para saber mais sobre processamento em lote, paginação, dados em tempo real por webhook e WebSockets, consulta incremental de contas, tratamento de erros e armadilhas comuns que os agentes devem evitar. 

Rust SDK

O Helius Rust SDK oferece bindings assíncronos para Rust com os mesmos métodos da Helius, sendo ideal para fluxos de trabalho agênticos de alto desempenho:

Código
use helius::Helius;
use helius::types::*;

let helius = Helius::new("YOUR_API_KEY", Cluster::MainnetBeta)?;

// Same single-call pattern as TypeScript
let txs = helius.rpc().get_transactions_for_address(
    "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY".to_string(),
    GetTransactionsForAddressOptions {
        transaction_details: Some(TransactionDetails::Full),
        limit: Some(100),
        filters: Some(GetTransactionsFilters {
            token_accounts: Some(TokenAccountsFilter::BalanceChanged),
            ..Default::default()
        }),
        ..Default::default()
    },
).await?;

O Rust SDK também oferece variantes de erros tipadas (por exemplo, HeliusError::RateLimitExceeded), permitindo que os agentes façam a correspondência de erros diretamente, em vez de analisar strings.

Consulte as práticas recomendadas de Rust para ver os mesmos padrões em Rust (ou seja, processamento em lote, paginação, Sender, estratégias de repetição e armadilhas comuns). 

Comece agora

A Helius oferece aos agentes o conjunto de ferramentas mais completo para criar aplicativos prontos para produção na Solana. Veja como começar:

Leia nossa documentação, explore o repositório no GitHub, sugira uma integração de skill e entre em contato com nossa equipe de suporte se tiver alguma dúvida.

Assine a Helius

Acompanhe as novidades mais recentes do desenvolvimento Solana e receba atualizações quando publicarmos

Imagem ampliada