Spraay Solana Gateway — Batch Payments For Ai Agents On Solana

💧 Spraay Solana Gateway

由 x402 驱动的 Solana AI Agent 批量支付基础设施。

任何 AI Agent 都可以通过 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. Agent 发送请求，不带支付标头
2. Gateway 返回 402 Payment Required，并附上 Solana USDC 支付说明
3. Agent 在 Solana 上向资金库地址发送 USDC
4. Agent 在 X-PAYMENT 标头中附上支付凭证，重试请求
5. Gateway 通过支付协调器验证付款，并执行批量转账

支持的支付协调器：

• Devnet：https://x402.org/facilitator
• Mainnet：https://facilitator.payai.network（PayAI — 免交易费用）

🤖 MCP 服务

该 Gateway 包含一个 MCP 服务，可与 AI Agent 框架集成：

# 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	gateway.spraay.app
Solana Gateway	gateway-solana.spraay.app
GitHub	github.com/plagtech
Twitter	@Spraay_app

📄 许可证

MIT