Agent Tollgate

agent-tollgate-engine

https://skinwinking.com で公開中です。機械可読ファイル：/llms.txt、/openapi.json、MCP は https://skinwinking.com/mcp です。

Cloudflare Workers 上で、自律エージェント向けに従量課金の取引インテリジェンスと、手数料が発生するスワップルーティングを提供します。

収益化の方法：

1. orderbook-imbalance（0.02 USDC）と token-audit（0.20 USDC）に対する、USDC（Polygon または Solana）での x402 マイクロペイメント。
2. quote-and-build（Solana の Jupiter、クロスチェーン／EVM の LI.FI）で構築されるスワップに対する、プラットフォーム手数料 30 bps。

すべての支払いは wrangler.toml に記載された加盟店アドレスに直接送金されます。サーバーは鍵も資金も保持しません。

構成

パッケージ	役割
packages/core	設定、ルートカタログ、オンチェーン決済の検証（EVM、Solana、x402 ファシリテーター）、リプレイ保護インターフェース
packages/api-worker	Hono Worker、x402PaymentGate ミドルウェア、Durable Object ノンスストア、ルートハンドラー
packages/omni-router	手数料を組み込む Jupiter（Solana）と LI.FI（クロスチェーン）の見積もりビルダー
packages/discovery	/llms.txt、/openapi.json、MCP サーバー（/mcp の HTTP、npm run mcp 経由の stdio）
packages/simulation-agent	エンドツーエンドのシミュレーションエージェント

ローカルでの実行

npm install
cp .env.example .dev.vars        # then set SOLANA_RPC_URL and EVM_RPC_URL to private endpoints
npm run dev                      # http://127.0.0.1:8787, simulation receipts enabled

npm run dev は SIM_SECRET を設定し、HMAC シミュレーションレシート（Bearer sim_...）を有効にします。本番環境では SIM_SECRET を絶対に設定しないでください。

ポート 8787 が使用中の場合：npx wrangler dev --port 8799 --var SIM_SECRET:dev-simulation-secret を実行し、BASE_URL=http://127.0.0.1:8799 を設定します。

シミュレーション

別のターミナルで npm run dev を実行した状態で：

npm run simulate

手順：未払いの呼び出しが 402 を返し、シミュレーション決済が成功し、リプレイが拒否されます。Solana のスワップ見積もりでは手数料アカウントが構築済みトランザクション内にあることを確認し、Polygon から Base への見積もりでは LI.FI のインテグレーター手数料を確認します。

本番環境の前提条件

1. RPC：パブリックエンドポイントはレート制限されているか、ブロックされています。プライベートエンドポイントを使用してください。

   npx wrangler secret put SOLANA_RPC_URL
   npx wrangler secret put EVM_RPC_URL
   

2. LI.FI インテグレーター：https://portal.li.fi で LIFI_INTEGRATOR を登録し、手数料ウォレットを EVM の支払い先アドレスに設定して、手数料を 0.3% に設定します。設定しないと、LI.FI は fee を含む見積もりを拒否します。
3. Solana の手数料トークンアカウント：Jupiter の手数料は、出力トークンで、そのミントに対応する加盟店の関連トークンアカウントに支払われます。アカウントが存在するまで、ルートは FEE_ACCOUNT_MISSING を返します。トークンを少額受け取るか、Phantom で ATA を作成すると、アカウントが作成されます。主なペアには USDC と wSOL が対応しています。
4. 任意で X402_FACILITATOR_URL を設定すると、x402 ファシリテーター経由で X-402-Signature の決済を有効にできます。

デプロイ

npx wrangler deploy

Cloudflare ダッシュボードの Workers & Routes でドメインを追加します（Worker にカスタムドメインを設定）。

決済証明

ヘッダー	意味
Authorization: Bearer 0x<64 hex>	加盟店への Polygon USDC 送金。ルート価格以上で、EVM_MIN_CONFIRMATIONS 以上の確認数があり、PAYMENT_MAX_AGE_SEC 秒以内のもの
Authorization: Bearer <base58 signature>	Solana USDC 送金。コミットメントは confirmed
X-402-Signature: <base64 payload>	x402 ペイロードが検証され、ファシリテーター経由で決済済み

各証明は一度だけ受け付けられます（Durable Object、TTL は 7 日）。