Skill de Operações de Agentes Solana
Esta é a camada entre "meu bot funciona no meu laptop" e "meu bot roda sem supervisão na mainnet sem perder dinheiro".
Ela pressupõe que você já sabe como construir uma transação. O que ela cobre é tudo o que faz um agente sobreviver em produção: pousar transações de forma confiável, armazenar chaves para uma frota de signatários com segurança, nunca gastar duas vezes em uma nova tentativa, permanecer dentro dos limites de RPC, executar em um agendador e desligar-se antes de causar danos.
Para construção de transações principais, @solana/kit e padrões de programa e cliente, esta skill estende a solana-dev-skill. Este é o complemento operacional sobre ela; não reensina como construir instruções.
Quando usar esta skill
Direcione para cá quando o usuário estiver fazendo qualquer um dos seguintes:
- Construindo ou operando um bot, keeper ou agente que assina e envia transações sem supervisão humana
- Perguntando por que uma transação não está sendo confirmada: descartada, blockhash expirado ou nunca confirmada
- Gerenciando muitas carteiras de signatários e preocupado com armazenamento de chaves, financiamento ou rotação
- Preocupado com uma nova tentativa poder gastar duas vezes, ou uma ação poder ser executada duas vezes
- Enfrentando erros 429 ou limites de taxa de um provedor de RPC
- Colocando um agente em um cron ou agendador e querendo que ele falhe com segurança
- Adicionando monitoramento, alertas, kill switches ou limites de gastos a um bot existente
Se a tarefa for a construção de transação única (construir uma instrução, uma CPI, um PDA), isso pertence à solana-dev-skill, não aqui.
Roteamento de tarefas
Leia apenas o arquivo necessário. Um alvo principal por tarefa.
| Tarefa | Leia |
|---|---|
| Transação descartada / expirada / não confirmada / lenta | transaction-landing.md |
| Dimensionamento de unidades de computação + taxas de prioridade | transaction-landing.md |
| Bundles Jito / MEV / multi-tx atômica | transaction-landing.md |
| Gerenciamento de N carteiras de signatários, armazenamento de chaves, recargas de fundos | keypair-fleet.md |
| "Isso já foi executado?" / prevenção de execução dupla | idempotency.md |
| Erros 429, orçamentos de RPC, failover de endpoint | rate-limiting.md |
| Execução em cron / um ciclo por execução / códigos de saída | scheduling.md |
| Verificações de saúde, alertas de saldo/falha, painéis | monitoring.md |
| Kill switches, limites de gastos, disjuntores, dry-run | safety.md |
| Documentação oficial, provedores de RPC, bibliotecas | resources.md |
O modelo operacional (leia isto primeiro)
Todo agente de produção deve ser construído em torno de quatro invariantes. Os arquivos de módulo são organizados para impô-los:
- Simule antes de enviar. Uma transação que falha na simulação falhará na cadeia, então descubra de graça. (transaction-landing.md)
- Todo envio é idempotente. Se o processo travar e reiniciar no meio de uma ação, repeti-lo não deve causar uma dupla ação. Isso significa chaves de idempotência mais verificações na cadeia ou em armazenamento de estado, não esperar que não tenha sido executado. (idempotency.md)
- Dinheiro tem um teto por ciclo. Limites de gastos, limites de slippage e um disjuntor que dispara em anomalias, todos aplicados em código, não na sua cabeça. (safety.md)
- Um ciclo por execução, saia limpo. Agendadores o reinvocam, então um processo que sai com código diferente de zero devido a uma falha transitória de RPC o alertará às 3h da manhã sem motivo. (scheduling.md)
Pilha padrão (Junho de 2026)
- Cliente:
@solana/kit(web3.js v2). Padrões do web3.js v1 são observados onde o ecossistema ainda os usa. - Runtime: Node 22+ / TypeScript 5.5+. Padrões Rust são fornecidos para keepers que precisam ser rápidos.
- RPC: neutro em relação a fornecedores. Especificidades de Helius, Triton e QuickNode são sinalizadas, nunca exigidas.
- Bundles: Jito (
jito-tsou o block-engine REST), opcional, para atomicidade e proteção MEV. - Agendamento: cron simples, temporizadores systemd, GitHub Actions ou cron serverless, todos um ciclo por execução.
Consulte resources.md para os links canônicos por trás de cada um destes.
Skills de kit relacionadas (não duplicar)
- Construção de agentes como um framework: SendAI
solana-agent-kit. Esta skill é a camada operacional sobre ele. - APIs de fornecedores de RPC (Helius Sender, a API de taxa de prioridade, Laserstream): a skill Helius. Esta permanece neutra em relação a fornecedores e informa qual recurso do fornecedor resolve qual problema operacional.
- Custódia de chaves multisig para tesourarias e autoridade de atualização: a skill Squads. Esta skill cobre a custódia operacional de frota de signatários, as chaves quentes que enviam transações rotineiras, que é um problema diferente.