Spraay Solana Gateway — Batch Payments For Ai Agents On Solana

💧 Spraay Solana Gateway

Solana 上の AI エージェント向け、x402 対応の一括決済インフラストラクチャです。

あらゆる AI エージェントが、x402 決済プロトコルを通じて 1,000 以上のウォレットに SOL、USDC、BONK、または任意の SPL トークンを一括送信できます。API キーは不要です。アカウント登録も不要です。リクエストごとの従量課金です。

🏗️ アーキテクチャ

AI Agent (any framework)
    │
    ├── HTTP Request
    │
    ▼
┌──────────────────────────────────────────┐
│   Spraay Solana Gateway                  │
│   gateway-solana.spraay.app              │
│                                          │
│   @x402/express + @x402/svm             │
│   ┌─────────────┐  ┌──────────────┐     │
│   │ x402 Payment│  │ Solana Batch │     │
│   │ Middleware   │  │ Engine       │     │
│   └──────┬──────┘  └──────┬───────┘     │
│          │                │              │
│          ▼                ▼              │
│   USDC payment     Execute batch        │
│   verified via     SOL/SPL transfers    │
│   facilitator                           │
└──────────────────────────────────────────┘
    │
    ▼
Solana Network

📡 エンドポイント

エンドポイント	メソッド	料金	説明
/solana/batch-send-sol	POST	$0.01	複数のウォレットに SOL を一括送信します
/solana/batch-send-token	POST	$0.01	任意の SPL トークンを一括送信します
/solana/quote	GET	$0.001	費用の見積もりを取得します
/solana/status/:txid	GET	$0.001	トランザクションのステータスを確認します
/health	GET	無料	ヘルスチェック
/.well-known/x402	GET	無料	x402 検出用マニフェスト

🚀 クイックスタート

1. クローンとインストール

git clone https://github.com/plagtech/spraay-solana-gateway.git
cd spraay-solana-gateway
npm install

2. 設定

cp .env.example .env
# Edit .env with your treasury wallet and private key

3. 実行

npm run dev    # development (auto-reload)
npm start      # production

📖 API の使用方法

SOL の一括送信

curl -X POST https://gateway-solana.spraay.app/solana/batch-send-sol \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <base64 payment proof>" \
  -d '{
    "recipients": [
      { "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM", "amount": 0.01 },
      { "address": "7S3P4HxJpyyigGzodYwHtCxZyUQe9JiBMHyLWP9SfKFJ", "amount": 0.02 }
    ]
  }'

SPL トークンの一括送信

curl -X POST https://gateway-solana.spraay.app/solana/batch-send-token \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <base64 payment proof>" \
  -d '{
    "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "recipients": [
      { "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM", "amount": 1000 },
      { "address": "7S3P4HxJpyyigGzodYwHtCxZyUQe9JiBMHyLWP9SfKFJ", "amount": 500 }
    ]
  }'

見積もりの取得

curl "https://gateway-solana.spraay.app/solana/quote?recipients=100&token=BONK"

🔐 x402 決済フロー

1. エージェントが決済ヘッダーなしでリクエストを送信します
2. ゲートウェイが、Solana USDC の決済手順とともに 402 Payment Required を返します
3. エージェントが Solana 上で USDC をトレジャリーアドレスに送信します
4. エージェントが X-PAYMENT ヘッダーに決済証明を含めてリクエストを再送します
5. ゲートウェイがファシリテーターを通じて決済を検証し、一括送金を実行します

対応ファシリテーター：

• Devnet：https://x402.org/facilitator
• Mainnet：https://facilitator.payai.network（PayAI — トランザクション手数料無料）

🤖 MCP サーバー

このゲートウェイには、AI エージェントのフレームワークとの統合に対応する MCP サーバーが含まれています。

# Install MCP SDK
npm install @modelcontextprotocol/sdk

# Run MCP server
node mcp/spraay-solana-mcp.js

利用可能なツール：

• spraay_solana_batch_send_sol — SOL の一括送信
• spraay_solana_batch_send_token — SPL トークンの一括送信
• spraay_solana_quote — 費用の見積もり
• spraay_solana_tx_status — トランザクションの照会

🌐 デプロイ

Railway

1. Railway プロジェクトで新しいサービスを作成します
2. GitHub リポジトリ plagtech/spraay-solana-gateway を接続します
3. Railway ダッシュボードで環境変数を設定します
4. デプロイし、カスタムドメインを設定します

DNS（GoDaddy）

Type: CNAME
Name: gateway-solana
Value: <railway-app-url>.railway.app
TTL: 600

🔗 Spraay エコシステム

サービス	URL
Spraay アプリ	spraay.app
Base ゲートウェイ	gateway.spraay.app
Solana ゲートウェイ	gateway-solana.spraay.app
GitHub	github.com/plagtech
Twitter	@Spraay_app

📄 ライセンス

MIT