Solana Pulse: agent safety layer

Solana Pulse

Solana と AI エージェントをつなぐインテリジェンスレイヤーです。 エージェントがトランザクションに署名する前にチェックし、トランザクションがエージェントの意図どおりに実行されることを確認します。また、トークンの安全性を判定し、失敗の原因を説明し、実際のオンチェーン小数桁数を使って金額を変換することで、エージェントが幻覚による誤った値で資金を失うのを防ぎます。

• AI に 1 分で追加できます（Claude、ChatGPT、Cursor、VS Code、Codex など）：Connect ページの手順に沿ってください
• ライブ環境：https://solana-pulse-gateway-1021990235790.us-central1.run.app
• MCP エンドポイント：POST /mcp（Streamable HTTP）または /mcp/sse
• 公式 MCP Registry に io.github.Timothymycompc/solana-pulse-gateway として登録されています
• オープンソース（MIT）で、無料で利用できます：各ツールは毎日 25 回まで無料で呼び出せます
• 原則に基づいて構築されています：出典付きの実データ、推測ではなく「不明」という回答、そしてチェーン上に誤ったデータを残さないこと。安全性チェックをしてもトークンが安全になるわけではありませんし、そうすることもできません。トークンを使った詐欺で知られている手口を探します。「SAFE」が本当に意味するのは、「既知の罠が見つからなかった」ということです。すべてのルールは、実際の詐欺に当てはまるものとして設けられています。

理由

Solana では、自動化されたアカウントが予想以上に頻繁に失敗します。15 億件を超える失敗したトランザクションを調査した研究では、ボットの 58% が失敗していました（Why Does My Transaction Fail?、ISSTA 2025）。AI エージェントの場合、よくある原因は、モデルが自信たっぷりに間違えることです。小数桁数の誤り、模倣ティッカー、捏造されたアドレスや署名、期限切れのブロックハッシュ、単位を間違えた優先手数料、そして誰も効果を確認していないトランザクションへの署名などです。ここにある各ツールは、こうした間違いをひとつずつ取り除き、判定結果とその理由、修正方法を返します。

ツール

ツール	防止すること	価格
check_tx	ドレイナーへの署名や失敗するトランザクションへの署名：各ウォレットの正確な損益を表示し、承認、権限の変更、アカウントの閉鎖、期限切れのブロックハッシュ、手数料の払いすぎを警告します	$0.02
tx_matches	要求内容（「X に 5 USDC を送金」や「1 USDC を JUP にスワップ」など）と異なるトランザクション：トークン、正確な金額、送信先、送信元を比較し、スワップで購入したトークンがあなたに戻ってくるかを確認して、余計な処理があれば警告します	$0.02
token_safety	詐欺トークンの購入：実際の保有者による売却シミュレーション、流動性を引き出せるか、作成者のラグ履歴、インサイダーウォレットのネットワーク、発行および凍結の権限、Token-2022 の罠、検証状況、流動性、保有者、経過期間に基づき、安全／注意／回避を判定します	$0.02
explain_tx	ログからの推測：ウォレットごとの実際の残高変動、使用されたプログラム、失敗した理由を確認できます	$0.01
find_token	便乗ティッカー：ティッカーに対応する検証済みトークンアドレスと、便乗トークンの数を確認できます	$0.01
fee	手数料単位の間違い：コンピュートユニットあたりのマイクロラムポート単位で、低速、標準、高速の価格と、SOL での正確なコストを確認できます	$0.01
wallet	スパムのエアドロップで水増しされた合計額：USD 評価額付きの保有資産を、価格付け済み／未価格付け、検証済み／未検証に分けて確認できます	$0.01
trace	ドレイン後に資金がどこへ行ったかを推測すること：各トランザクションの SOL とトークンの純変動額および相手先、大半の資金の移動先（ウォレットかプログラム管理下かも含む）、ドレインのパターンとそれを示すトランザクション（他者が手数料を負担して一掃、直接転送、残高を空にする、類似アドレスからのダスト、見知らぬ相手からのダスト）を確認できます。また、問題を一行で示した概要、Solscan リンクと呼び出し元のローカル時刻を含むすべてのトランザクション、理由付きの信頼度、示唆される内容、次の手順をまとめたレポートを作成します	$0.02
convert	小数の間違い：通常の金額をトークンの実際の小数桁数に基づく正確な最小単位に変換します	$0.01
why_failed	やみくもな再試行：Solana のエラーコードを平易な言葉で説明し、修正方法を示します	$0.01
whats_this	種類の違うアドレスへの誤送信：ウォレット、トークンアカウント、トークン、プログラムなどを判別します	$0.01
token_account	間違ったトークンアカウント：Token-2022 に対応したアドレス、そのアカウントが存在するか、作成にかかる費用を確認できます	$0.01
balance	チャットの以前のやり取りで記憶された残高：最新の SOL 残高を確認できます	$0.01
tokens	偽の保有資産：保有トークンを USD 評価額順に表示し、未検証（スパムであることが多い）のトークンに警告を付けます	$0.01
history	捏造されたトランザクション ID：ウォレットの最近のトランザクションを確認できます。実在し、検証可能です	$0.01
blockhash	期限切れのブロックハッシュ：有効期限までの秒数付きで、新しいものを取得します	$0.01

各入力と返却フィールドについて、平易な言葉で説明しています。入力で何を指定するのか、どこで取得できるのか、返却される各値が何を意味し、どのように算出されるのかを確認できます（GET /api/tools/<name>）。ツール名とフィールド名は、2026 年 10 月に短く分かりやすい名前に変更されました（preflight_transaction は check_tx に、transaction は tx に、walletChanges は balance_changes に変更）。以前のツール名と入力名も引き続き使用できます。

料金が適用されるのは、1 日あたり 25 回の無料呼び出しを使い切った後のみです。

各ツールでは、すべての入力（取得方法を含む）と返却フィールド（意味と正確な算出方法を含む）について説明しています。GET /api/tools と GET /api/tools/<name> を参照してください。GET /api/tools/<name>/example は、ライブのメインネットデータに基づく、すぐに実行できる入力を返します。

呼び出し方法

HTTP：

curl -X POST https://solana-pulse-gateway-1021990235790.us-central1.run.app/api/tools/convert \
  -H 'content-type: application/json' -d '{"token":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","amount":"5"}'

MCP（https://solana-pulse-gateway-1021990235790.us-central1.run.app/mcp）：

• Claude（claude.ai と Claude アプリ）：カスタマイズ、コネクター、カスタムコネクターを追加を選択し、URLを貼り付けて、サインインしないを選択します。
• Claude Code：claude mcp add --transport http solana-pulse https://solana-pulse-gateway-1021990235790.us-central1.run.app/mcp
• ChatGPT（ウェブ版。Business、Enterprise、Edu、Pro で開発者モードを有効にします）：ChatGPT Plugins、プラスボタン、カスタム MCP サーバーを追加を選択し、URLを貼り付けて、認証：認証なしを選び、プラグインとして作成します。
• Gemini CLI：gemini mcp add -s user --transport http solana-pulse https://solana-pulse-gateway-1021990235790.us-central1.run.app/mcp
• Antigravity（無料アカウントと Google One アカウントでは Gemini CLI に代わって使用）：~/.gemini/config/mcp_config.json に { "mcpServers": { "solana-pulse": { "serverUrl": "https://solana-pulse-gateway-1021990235790.us-central1.run.app/mcp" } } } を設定します。
• Cursor（~/.cursor/mcp.json）およびURLを指定できるほとんどのクライアント：{ "mcpServers": { "solana-pulse": { "url": "https://solana-pulse-gateway-1021990235790.us-central1.run.app/mcp" } } }
• VS Code（Copilot）：code --add-mcp '{"name":"solana-pulse","type":"http","url":"https://solana-pulse-gateway-1021990235790.us-central1.run.app/mcp"}' を実行するか、servers と "type": "http" を含む .vscode/mcp.json を使用します。
• Windsurf（~/.codeium/windsurf/mcp_config.json）：{ "mcpServers": { "solana-pulse": { "serverUrl": "https://solana-pulse-gateway-1021990235790.us-central1.run.app/mcp" } } }
• Cline（cline_mcp_settings.json）：{ "mcpServers": { "solana-pulse": { "type": "streamableHttp", "url": "https://solana-pulse-gateway-1021990235790.us-central1.run.app/mcp" } } }
• Codex CLI：codex mcp add solana-pulse --url https://solana-pulse-gateway-1021990235790.us-central1.run.app/mcp
• Zed（settings.json）：{ "context_servers": { "solana-pulse": { "url": "https://solana-pulse-gateway-1021990235790.us-central1.run.app/mcp" } } }
• OpenCode（opencode.json）：{ "mcp": { "solana-pulse": { "type": "remote", "url": "https://solana-pulse-gateway-1021990235790.us-central1.run.app/mcp" } } }
• ElizaOS と Coinbase AgentKit：接続ページで設定します。

Solana Agent Kit（SendAI）：agent-kit/ のプラグイン（npm の solana-agent-kit-plugin-pulse）は、各ツールをアクション（PULSE_CHECK_TX、PULSE_TOKEN_SAFETY、...）とメソッド（agent.methods.pulseCheckTx(agent, { tx })）に変換します。ツール一覧は同じレジストリから生成され（npm run agent-kit）、tests/agent-kit.test.ts は更新が遅れている場合に失敗します。

エージェントテンプレート：templates/ には、フォークして使える5つの小規模なエージェント（Vercel AI SDK、Claude Agent SDK、LangChain、elizaOS、Coinbase AgentKit）があります。各エージェントは署名前に check_tx（OKであること）と tx_matches（MATCHであること）を使ってすべての送金を確認し、Pulse が応答できない場合は拒否します。デフォルトではドライランです。

料金と支払い

• すべての呼び出しは、IP アドレスごとに毎分 120 リクエストまでに制限されています。
• 各ツールでは、呼び出し元ごとに毎日 25 回まで無料で呼び出せます（00:00 UTC にリセット。呼び出し元のネットワークのキー付きハッシュでカウントし、HTTP と MCP で共有します）。以降は 1 回あたり $0.01 USDC（check_tx、tx_matches、token_safety は $0.02）です。通常の利用は無料のままで、支払いは大量の自動利用を対象としています。Solana Foundation の pay ツールを使う呼び出し元は、同ツールのレジストリ（Pay.sh）に 402 を返すツールだけが掲載されているため、最初の呼び出しから支払います。
• 支払いは x402 v2（scheme exact、Solana mainnet 上の USDC）によるリクエスト単位です。HTTP は PAYMENT-REQUIRED ヘッダー付きで 402 を返します。MCP は PaymentRequired ツール結果を返し、_meta["x402/payment"] で支払いを受け付けます。Coinbase の x402 facilitator が検証、決済、ネットワーク手数料の支払いを行います。起動時に Coinbase に接続できない場合は、PayAI の facilitator がバックアップとして使われます。エラーを返す呼び出しに料金は発生しません。
• アカウント、API キー、保存された残高はありません。
• 利用記録にはルート、ステータス、クライアント名、呼び出し元のネットワークのキー付きハッシュが保存されますが、IP アドレスは保存されません。ツール呼び出しの場合は、ツールの入力と結果（それぞれ最大 32 KB）も 30 日間保存し、その後消去します。サイトへのアクセスも同様に記録され、ページと参照元サイトが保存されます。所有者は /owner で、所有者キーを使って、収益（ツールごとの内訳と、各ツールの名称変更前の名称で支払われた分）、ツールの実行状況、呼び出し元、訪問者、最新の実行状況を確認できます。それぞれの項目は個別のタブに表示されます。
• 各有料ツールは、x402 のディスカバリーリスティング（Bazaar 拡張機能：説明、入力スキーマ、実際の使用例）を公開します。そのため、Coinbase の x402 Bazaar や PayAI などの facilitator ディレクトリには、そのツールを介した最初の有料呼び出し後に掲載されます。

支払い方式の変遷

バージョン 1（2026 年 9 月から 10 月）は、私が Solana 上に直接構築したプリペイドクレジット方式でした。そのコードは v1-sol-credits タグに保存されています。

• ウォレットでのサインイン：サーバーがサインインメッセージを発行し、ウォレットの ed25519 署名を検証していました（tweetnacl）。メッセージの有効期限は 5 分で、再利用はできませんでした。サインインすると API キーが発行され、保存されるのはその SHA-256 ハッシュのみでした。
• 入金：共有シークレットを使って認証され、定時間比較で検証される Helius webhook が、支払い用ウォレットへの SOL 送金を通知していました。各トランザクション署名は一度だけ記録されるため、webhook が再送されても二重にクレジットが付与されることはありませんでした。0.0022 SOL ごとに 1 回呼び出せました。
• 利用量の計測：条件付きの UPDATE でクレジットを差し引くため、同時に行われた呼び出しが同じクレジットを使うことはなく、失敗した呼び出しのクレジットは返金されていました。

バージョン 2 では、購入者が AI エージェントであることから、x402 に置き換えました。v1 では、エージェントは最初の有料呼び出しを行う前に、サインインしてキーを保存し、入金し、クレジットへの反映を待つ必要があり、このサービス専用に作られたクライアントを使わなければなりませんでした。x402 では、エージェントの支払いライブラリがすでに対応している標準規格を使い、支払いが必要なリクエスト内で支払います。この切り替えに伴い、価格の単位を SOL から USDC に変更し、アカウント、保存された残高、webhook、4 つのデータベーステーブルをなくしました。

v1 で修正すべきだった点：サーバーは発行したサインインメッセージを保存していなかったため、最近のタイムスタンプを含む署名済みメッセージなら何でも受け付けていました。また、1 回分の料金に満たない入金ではクレジットが付与されませんでした。

アーキテクチャ

• ツールレジストリ（server/tools/）：各ツールの定義には、「使用するタイミング」の説明、ドキュメント、実際の使用例、コードが含まれます。MCP ツール、HTTP ルート、/api/tools、llms.txt、/.well-known/mcp.json、プレイグラウンドはすべてこの定義から生成されるため、ドキュメントと動作が食い違うことはありません。
• トランザクション分析（server/tools/decode.ts）：System、SPL Token、Token-2022、Compute Budget、Associated Token Account、Memo の各命令をデコードし、アドレスルックアップテーブルを解決し、最新の状態を使ってシミュレーションを実行し、ウォレットごとの残高変動を算出します。
• 決済（server/x402.ts、server/meter.ts、server/pricing.ts）：アクセス許可ゲート（無料ツール、オーナーキー、無料呼び出し、または x402）、公式の @x402/express と @x402/mcp の統合、および決済完了済みの支払いを記録する収益台帳を備えています。
• サーバー：Google Cloud Run 上の Node.js、Express、TypeScript、Cloud SQL 上の PostgreSQL（1 日ごとの無料呼び出し数、匿名利用統計、支払い台帳）。
• フロントエンド：レジストリ連動型のプレイグラウンドを備えた React、Vite、Tailwind。

ローカル開発

npm install
cp .env.example .env   # set DATABASE_URL at minimum
npm run dev            # Express + Vite on http://localhost:3000
npm run build          # type-check, then bundle frontend and server into dist/

フォルダー構成、ツールの追加方法、価格の変更方法、サイトの配色変更方法、デプロイ方法については、DEVELOPING.md を参照してください。

テスト

npm test               # 152 tests, offline, about a minute
npm run test:record    # re-record the mainnet scenarios (reads and simulations only)
npm run benchmark      # score the 10 attack cases
npm run everyday       # replay the 200 everyday transactions

• Solana エージェント安全性ベンチマーク（benchmark/README.md、tests/benchmark.test.ts）：実際のメインネットアカウントをもとにした 10 件のケースを、稼働中のメインネット状態に対してシミュレーションします。正しい送金（合格する必要があります）、送金先の誤り、金額の誤り、トークンの誤り、余分な命令、隠された送金、悪意のあるプログラム、残高の流出、期限切れのトランザクション、再生された支払い（これらはすべて不合格になる必要があります）が含まれます。Solana Pulse は誤警告なしで、攻撃を正しい理由で 9 件中 9 件検出します。benchmark/score.ts を使うと、同じケースで任意のチェッカーを評価できます。
• 実際の 200 件のトランザクションに対する誤警告（benchmark/everyday.ts、tests/everyday.test.ts）：最新のメインネットブロックから、実際に成功した通常のトランザクションを 200 件選び、ウォレットが署名前に受け取る方法で検証します。BLOCK はなく、送金は 80 件中 80 件が OK かつ MATCH、スワップは 27 件中 26 件が MATCH でした（残りの 1 件はトレーディングボットに 1.54% を支払っていました）。REVIEW となったのは、check_tx が認識しないプログラムを呼び出すトランザクションです。このテストの構築中に、バージョン 1 のトランザクションを読み取れない問題と、計算上限のない場合に手数料が誤っていた問題が見つかりました。どちらも修正済みで、現在は 200 件すべてで手数料がメインネットの実際の請求額と一致します。
• 実際の流出事例と一般的なウォレットの追跡（tests/trace.test.ts、benchmark/trace-everyday.ts）：メインネットで記録された実際の流出事例を2件再生します。@KunalxWeb3 のウォレットでは、2.03 SOL が着金から7秒後に別のウォレットが手数料を負担して送金され、元のウォレットが空になったことと、送金先がプログラム管理のアドレスであることを特定します（調査結果から、ブリッジである可能性が非常に高いです）。@Adilak7777 のウォレットでは、攻撃者のウォレットと、そこに送られた正確な数量（2,176.26 JTO、5,375.82 RAY、1,446,074 PUMP）を特定します。最近のメインネットブロック（2026-10-27）にある一般的なアクティブウォレットでは、タイミングだけで40件中14件を通過アドレスと判定したため、ルールを厳格化しました。通過アドレスと判定するには、着金額の90％を送金する必要があります。また、各兆候単独では（通過アドレスが8件、別のウォレットが手数料を負担したものが7件、空になったものが45件中3件）、注記だけを付けます。取引所の入金アドレス、ブリッジ、手数料を負担するウォレットでも同じことが起きるためです。流出パターン（空になり、全額が送金される）は警告対象で、該当したのは45件中1件でした。同じ45件のアドレスを数時間後に再実行すると（最新のトランザクションが変わっていたため）、5件に該当しました。そのうち2件は使い捨ての取引ボット用ウォレット、3件は取引所の入金アドレスのように見えるものでした。オンチェーンのデータだけでは、これらと資金を流出させられた個人ウォレットを区別できないため、警告が出るたびにその旨を概要に記載します。類似アドレスを装ったダスト送金は該当なしで、実地調査中の2つのウォレットでは実際のポイズニングを検出しました。見知らぬ相手からの通常のダスト送金（dust_received。ポイズニングに先立って発生するプローブであり、注記のみ）は45件中4件で検出されました。結果は benchmark/trace-everyday-results.txt と -results-2.txt にあります。
• 初心者が実際に購入した628トークン（benchmark/first-wallet.ts、tests/first-wallet.test.ts）：各トークンがその後どうなったかを、token_safety と照らし合わせます。購入日にミント権限または凍結権限があった場合、現在は市場で取引されていない413トークンのうち400件（Jupiterで価格が取得できなくなったトークン）、現在も取引されているものの価値の大半を失った37トークンのうち4件、価値を保った20トークン（少数）のうち0件にフラグが付きました。158件は不明です。つまり、権限に関する警告は、取引を続けながら価値を失ったトークンではなく、その後取引されなくなったトークンにフラグを付けます。また、市場で取引されていないトークンが CAUTION にとどまっていたことも判明しました。現在は、Jupiter が取引不可と示すトークンを AVOID とします。
• 安全性チェック（tests/safety.test.ts）では、tests/fixtures/ に記録された実際のメインネットトランザクションを検証します。ドレイナーによるトークン承認（BLOCK）、隠された追加命令によるSOLの移動、小数点以下の桁数を10倍間違えたケース、見知らぬ相手へのUSDCの追加送金（いずれも MISMATCH）に加え、受取人のトークンアカウントを作成するケースを含め、問題のない送金が確実に通過することも検証します。
• 無料呼び出しの計測（tests/meter.test.ts）では、メモリ内のPostgres（PGlite）で実際のSQLを実行します。日次の利用枠、呼び出し失敗時の返金、日次リセット、パーセントエンコードされたツール名を検証します。
• 単位（tests/units.test.ts）：金額の正確な計算、エラーの説明、命令のデコードを検証します。
• 実際の結果に対する精度（server/accuracy.ts、tests/accuracy.test.ts）：Google Cloud上で、Cloud SchedulerがJupiterのアクティビティリストから、3日未満で流動性が少なくとも$10,000あるトークンを100件サンプリングします。token_safety の完全な判定と各チェックの結果を記録し、1週間後に再確認します。購入者は資金の大半を失ったでしょうか（価格または流動性が90％以上下落したか、RugCheckがラグと判定したか）。npm run accuracy で、次の4つの問いに答えます。各判定のトークンが資金の大半を失った頻度、損失を出したトークンのうち AVOID または SAFE と判定されていた件数、どのチェックがシグナルを捉えているか、よく知られたトークンのうち SAFE と判定される件数です。
• トークンの監視（server/watch.ts、tests/watch.test.ts）：Pulseは、初回チェックから7日間、若いトークンを繰り返し読み直します（Jupiterのアクティビティリストから1日あたり最大10件に加え、ユーザーが token_safety を実行した若いトークン）。流動性、価格、保有者、上位10アドレスの保有割合、ミント権限と凍結権限を、2時間ごとに確認します。Jupiterへの一括照会1回とオンチェーン読み取り1回で処理します。その後、token_safety は変化内容（流動性の引き出し、価格の暴落、権限の移動）を記録した history を追加します。精度チェックの実行時に動くため、専用のスケジュールは不要です。
• 公開トラックレコード（/track-record、GET /api/track-record、server/track-record.ts）：精度テストの結果と監視データを、Pulseが最初に付けた判定ごとに公開します。集計データと公開可能なトークンアドレスのみを掲載します。
• ディスカバリーリスト（tests/discovery.test.ts）：有料ツールの各 x402 リストが Bazaar 拡張機能独自のバリデーターを通過し、サンプルが有効な入力であることを検証します。 GitHub Actions は、プッシュのたびに型チェック、ツールチェック、テストを実行します。

Pulse が役に立った場合は、GitHub で ⭐ を付けていただくと、ほかの開発者が見つけやすくなります。

ライセンス

MIT。詳しくは LICENSE をご覧ください。