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つの不変条件を中心に構築されるべきです。モジュールファイルはこれらを強制するように構成されています。
- 送信前にシミュレートする。 シミュレーションに失敗するトランザクションはオンチェーンでも失敗するため、無料で事前に発見できます。(transaction-landing.md)
- すべての送信は冪等であること。 プロセスがクラッシュし、アクションの途中で再起動した場合、再実行によって二重にアクションが実行されてはなりません。つまり、冪等性キーに加えて、オンチェーンまたはステートストアでのチェックが必要であり、「実行されていないはず」と期待するだけでは不十分です。(idempotency.md)
- 1サイクルあたりの資金に上限があること。 支出上限、スリッページ範囲、異常を検知するサーキットブレーカーを、頭の中ではなくコードで強制します。(safety.md)
- 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スキル。このスキルは、運用上の署名者キーペア管理、つまりルーチントランザクションを送信するホットキーを対象としており、これは異なる問題です。