solana-agent-ops

Solana上でトランザクションを実行する自律エージェントのための本番運用スキル。Solana AI Kitのコミュニティスキル。

solana-agent-ops とは?

Solana Agent Opsは、自律エージェントやボットがSolana上でトランザクションを実行する際の本番運用に特化したスキルです。トランザクションの確実な着地(シミュレートファースト、Compute Budgetと優先手数料の設定、Jitoバンドル、Durable Nonce、確認/リトライ)、キーペアの管理と資金自動補充、完全に一度だけの冪等性、RPCレート制限とフェイルオーバー、スケジューリング、監視とアラート、そしてセーフティレール(キルスイッチ、支出上限、サーキットブレーカー)をカバーします。このスキルは、トレーディング、アービトラージ、清算ボット、マーケットメーカー、オンチェーンで実行するAIエージェント、cronジョブ、キーパー、エアドロップや配布スクリプトなど、無人でSolanaトランザクションに署名・送信するあらゆるものの構築、強化、デバッグに役立ちます。主にNode.js/TypeScript環境向けで、@solana/kit(web3.js v2)をベースとし、JitoバンドルやHelius、Triton、QuickNodeなどのRPCプロバイダに依存しない設計です。

対応~Claude Code~Codex CLI~Cursor
npx skills add fedelu/solana-agent-ops

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Solana Agent Ops スキル

これは「私のボットはラップトップで動作する」と「私のボットがメインネット上で無人で動作し、お金を失わない」の間のレイヤーです。

このスキルは、トランザクションの構築方法をすでに知っていることを前提としています。このスキルがカバーするのは、エージェントを本番環境で動作させるためのすべて、すなわち、トランザクションを確実に着地させること、複数の署名者からなるキーペアを安全に管理すること、リトライ時に二重送金を防ぐこと、RPC制限内に収めること、スケジューラー上で実行すること、そして損害が発生する前に自動停止することです。

コアとなるトランザクション構築、@solana/kit、プログラムやクライアントのパターンについては、solana-dev-skill を拡張しています。これはその上に構築される運用アドオンであり、インストラクションの構築方法を再教育するものではありません。

このスキルを使用するタイミング

ユーザーが以下のいずれかを行っている場合に、このスキルに誘導します。

  • 人間が監視せずにトランザクションに署名・送信するボット、キーパー、またはエージェントの構築または運用
  • トランザクションが着地しない理由(ドロップ、期限切れブロックハッシュ、未確認)の調査
  • 多数の署名者ウォレットを運用し、キーストレージ、資金調達、またはローテーションを懸念している
  • リトライによる二重送金やアクションの二重実行を懸念している
  • RPCプロバイダーからの429エラーやレート制限に遭遇している
  • エージェントをcronやスケジューラーに配置し、安全に失敗させたい
  • 既存のボットに監視、アラート、キルスイッチ、または支出上限を追加している

タスクが単発のトランザクション構築(インストラクション、CPI、PDAの構築)である場合、それは solana-dev-skill に属し、ここではありません。

タスクルーティング

必要なファイルのみを読んでください。タスクごとに1つの主要なターゲットファイルです。

タスク読むファイル
トランザクションのドロップ/期限切れ/不着地/遅延transaction-landing.md
Compute Unitと優先手数料の設定transaction-landing.md
Jitoバンドル/MEV/アトミックマルチトランザクションtransaction-landing.md
N個の署名者ウォレットの管理、キーストレージ、資金補充keypair-fleet.md
「これはすでに実行されたか?」/二重実行の防止idempotency.md
429エラー、RPC予算、エンドポイントフェイルオーバーrate-limiting.md
cronでの実行/1実行サイクル/終了コードscheduling.md
ヘルスチェック、残高/障害アラート、ダッシュボードmonitoring.md
キルスイッチ、支出上限、サーキットブレーカー、ドライランsafety.md
公式ドキュメント、RPCプロバイダー、ライブラリresources.md

運用モデル(最初に読むこと)

すべての本番エージェントは、4つの不変条件を中心に構築されるべきです。モジュールファイルはこれらを強制するように構成されています。

  1. 送信前にシミュレートする。 シミュレーションに失敗するトランザクションはオンチェーンでも失敗するため、無料で事前に発見できます。(transaction-landing.md)
  2. すべての送信は冪等であること。 プロセスがクラッシュし、アクションの途中で再起動した場合、再実行によって二重にアクションが実行されてはなりません。つまり、冪等性キーに加えて、オンチェーンまたはステートストアでのチェックが必要であり、「実行されていないはず」と期待するだけでは不十分です。(idempotency.md)
  3. 1サイクルあたりの資金に上限があること。 支出上限、スリッページ範囲、異常を検知するサーキットブレーカーを、頭の中ではなくコードで強制します。(safety.md)
  4. 1実行サイクルで終了し、クリーンに終了する。 スケジューラーはプロセスを再実行します。そのため、一時的なRPCの不調で非ゼロ終了するプロセスは、ユーザーを午前3時に無意味にページングすることになります。(scheduling.md)

デフォルトスタック(2026年6月時点)

  • クライアント: @solana/kit(web3.js v2)。web3.js v1のパターンは、エコシステムが依然として使用している場合に記載されます。
  • ランタイム: Node 22+ / TypeScript 5.5+。高速性が必要なキーパー向けにRustパターンも提供されます。
  • RPC: ベンダーニュートラル。Helius、Triton、QuickNode固有の情報はフラグが立てられますが、必須ではありません。
  • バンドル: Jito(jito-tsまたはブロックエンジンREST)。アトミック性とMEV保護のためにオプションです。
  • スケジューリング: プレーンなcron、systemdタイマー、GitHub Actions、またはサーバーレスクロン。すべて1実行サイクルです。

各項目の正規のリンクについては resources.md を参照してください。

関連キットスキル(重複しないこと)

  • エージェント構築フレームワーク: SendAIの solana-agent-kit。このスキルはその上に構築される運用レイヤーです。
  • RPCベンダーAPI(Helius Sender、優先手数料API、Laserstream): Heliusスキル。このスキルはベンダーニュートラルを保ち、どのベンダー機能がどの運用問題を解決するかを示します。
  • マルチシグキー管理(財務省、アップグレード権限): Squadsスキル。このスキルは、運用上の署名者キーペア管理、つまりルーチントランザクションを送信するホットキーを対象としており、これは異なる問題です。

関連スキル