name: solana-agent-ops description: Operaciones de producción para agentes y bots autónomos que realizan transacciones en Solana. Cubre la colocación confiable de transacciones (simular-primero, presupuesto de cómputo y tarifas prioritarias, bundles Jito, nonces duraderos, confirmar/reintentar), custodia y financiamiento automatizado de flotas de llaves, idempotencia exactamente-una-vez, límites de tasa y failover de RPC, programación, monitoreo y alertas, y barreras de seguridad (interruptores de apagado, límites de gasto, interruptores de circuito). Úsala al construir, endurecer o depurar cualquier cosa que firme y envíe transacciones de Solana sin supervisión: bots de trading, arbitraje o liquidación, creadores de mercado, agentes de IA ejecutando en cadena, trabajos cron, keepers, o scripts de distribución y airdrop. user-invocable: true
Skill de Operaciones para Agentes en Solana
Esta es la capa entre "mi bot funciona en mi laptop" y "mi bot se ejecuta sin supervisión en mainnet sin perder dinero".
Asume que ya sabes cómo construir una transacción. Lo que cubre es todo lo que hace que un agente sobreviva en producción: colocar transacciones de forma confiable, mantener las llaves de una flota de firmantes de manera segura, nunca gastar dos veces en un reintento, mantenerse dentro de los límites de RPC, ejecutarse en un programador, y apagarse antes de causar daño.
Para la construcción central de transacciones, @solana/kit, y patrones de programas y clientes, esto extiende solana-dev-skill. Este es el complemento de operaciones sobre ella; no vuelve a enseñar cómo construir instrucciones.
Cuándo usar esta skill
Dirígete aquí cuando el usuario esté haciendo algo de lo siguiente:
- Construir u operar un bot, keeper o agente que firma y envía transacciones sin un humano observando
- Preguntar por qué una transacción no se coloca: eliminada, blockhash expirado, o nunca confirmada
- Ejecutar muchas billeteras firmantes y preocupado por el almacenamiento de llaves, financiamiento o rotación
- Preocupado de que un reintento pueda gastar dos veces, o que una acción pueda ejecutarse dos veces
- Encontrar errores 429 o límites de tasa de un proveedor RPC
- Poner un agente en un cron o programador y querer que falle de forma segura
- Añadir monitoreo, alertas, interruptores de apagado o límites de gasto a un bot existente
Si la tarea es la construcción de una transacción única (construir una instrucción, una CPI, un PDA), eso pertenece a solana-dev-skill, no aquí.
Enrutamiento de tareas
Lee solo el archivo que necesites. Un objetivo principal por tarea.
| Tarea | Leer |
|---|---|
| Transacción eliminada / expirada / no colocada / lenta | transaction-landing.md |
| Dimensionar unidades de cómputo + tarifas prioritarias | transaction-landing.md |
| Bundles Jito / MEV / multi-tx atómica | transaction-landing.md |
| Gestionar N billeteras firmantes, almacenamiento de llaves, recargas de financiamiento | keypair-fleet.md |
| "¿Esto ya se ejecutó?" / prevenir doble ejecución | idempotency.md |
| 429s, presupuestos RPC, failover de endpoint | rate-limiting.md |
| Ejecutar en cron / un ciclo por ejecución / códigos de salida | scheduling.md |
| Verificaciones de salud, alertas de saldo/fallo, tableros | monitoring.md |
| Interruptores de apagado, límites de gasto, interruptores de circuito, ejecución en seco | safety.md |
| Documentación oficial, proveedores RPC, librerías | resources.md |
El modelo operativo (lee esto primero)
Cada agente de producción debe construirse en torno a cuatro invariantes. Los archivos de módulos están organizados para hacerlos cumplir:
- Simular antes de enviar. Una transacción que falla en simulación fallará en cadena, así que entérate gratis. (transaction-landing.md)
- Cada envío es idempotente. Si el proceso se bloquea y se reinicia a mitad de una acción, repetirla no debe duplicar la acción. Eso significa llaves de idempotencia más verificaciones en cadena o en almacenamiento de estado, no esperar que no se haya ejecutado. (idempotency.md)
- El dinero tiene un techo por ciclo. Límites de gasto, límites de deslizamiento, y un interruptor de circuito que se activa ante anomalías, todo aplicado en código en lugar de en tu cabeza. (safety.md)
- Un ciclo por ejecución, salir limpiamente. Los programadores te vuelven a invocar, así que un proceso que sale con código distinto de cero por un problema transitorio de RPC te despertará a las 3 a.m. sin motivo. (scheduling.md)
Stack por defecto (junio 2026)
- Cliente:
@solana/kit(web3.js v2). Los patrones de web3.js v1 se señalan donde el ecosistema aún los usa. - Runtime: Node 22+ / TypeScript 5.5+. Se dan patrones Rust para keepers que necesitan ser rápidos.
- RPC: neutral con respecto al proveedor. Se señalan particularidades de Helius, Triton y QuickNode, nunca se exigen.
- Bundles: Jito (
jito-tso el REST del block-engine), opcional, para atomicidad y protección MEV. - Programación: cron simple, timers de systemd, GitHub Actions, o cron serverless, todo un ciclo por ejecución.
Consulta resources.md para los enlaces canónicos detrás de cada uno de estos.
Skills de kits relacionados (no duplicar)
- Construir agentes como framework: SendAI
solana-agent-kit. Esta skill es la capa de operaciones sobre él. - APIs de proveedores RPC (Helius Sender, la API de tarifas prioritarias, Laserstream): la skill de Helius. Esta se mantiene neutral y te dice qué característica del proveedor resuelve qué problema operativo.
- Custodia de llaves multisig para tesorerías y autoridad de actualización: la skill de Squads. Esta skill cubre la custodia operativa de flotas de firmantes, las llaves activas que envían transacciones rutinarias, que es un problema diferente.