io.github.plagtech/spraay-solana-gateway
编码与调试by plagtech
通过 x402 将 SOL 或任意 SPL token 批量发送到 1000+ 钱包,支持 Solana 上的 AI agent 支付。
什么是 io.github.plagtech/spraay-solana-gateway?
通过 x402 将 SOL 或任意 SPL token 批量发送到 1000+ 钱包,支持 Solana 上的 AI agent 支付。
README
💧 Spraay Solana Gateway
x402-powered batch payment infrastructure for AI agents on Solana.
Any AI agent can batch send SOL, USDC, BONK, or any SPL token to 1,000+ wallets via the x402 payment protocol. No API keys. No accounts. Pay per request.
🏗️ Architecture
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
📡 Endpoints
| Endpoint | Method | Price | Description |
|---|---|---|---|
/solana/batch-send-sol | POST | $0.01 | Batch send SOL to multiple wallets |
/solana/batch-send-token | POST | $0.01 | Batch send any SPL token |
/solana/quote | GET | $0.001 | Get cost estimate |
/solana/status/:txid | GET | $0.001 | Check transaction status |
/health | GET | Free | Health check |
/.well-known/x402 | GET | Free | x402 discovery manifest |
🚀 Quick Start
1. Clone & Install
git clone https://github.com/plagtech/spraay-solana-gateway.git
cd spraay-solana-gateway
npm install
2. Configure
cp .env.example .env
# Edit .env with your treasury wallet and private key
3. Run
npm run dev # development (auto-reload)
npm start # production
📖 API Usage
Batch Send 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 }
]
}'
Batch Send SPL Token
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 }
]
}'
Get Quote
curl "https://gateway-solana.spraay.app/solana/quote?recipients=100&token=BONK"
🔐 x402 Payment Flow
- Agent sends request without payment header
- Gateway returns
402 Payment Requiredwith Solana USDC payment instructions - Agent sends USDC on Solana to the treasury address
- Agent retries request with payment proof in
X-PAYMENTheader - Gateway verifies payment via facilitator, executes batch transfer
Supported facilitators:
- Devnet:
https://x402.org/facilitator - Mainnet:
https://facilitator.payai.network(PayAI — free tx fees)
🤖 MCP Server
The gateway includes an MCP server for AI agent framework integration:
# Install MCP SDK
npm install @modelcontextprotocol/sdk
# Run MCP server
node mcp/spraay-solana-mcp.js
Tools available:
spraay_solana_batch_send_sol— Batch send SOLspraay_solana_batch_send_token— Batch send SPL tokensspraay_solana_quote— Cost estimationspraay_solana_tx_status— Transaction lookup
🌐 Deployment
Railway
- Create new service in Railway project
- Connect GitHub repo:
plagtech/spraay-solana-gateway - Set environment variables in Railway dashboard
- Deploy → configure custom domain
DNS (GoDaddy)
Type: CNAME
Name: gateway-solana
Value: <railway-app-url>.railway.app
TTL: 600
🔗 Spraay Ecosystem
| Service | URL |
|---|---|
| Spraay App | spraay.app |
| Base Gateway | gateway.spraay.app |
| Solana Gateway | gateway-solana.spraay.app |
| GitHub | github.com/plagtech |
| @Spraay_app |
📄 License
MIT
常见问题
io.github.plagtech/spraay-solana-gateway 是什么?
通过 x402 将 SOL 或任意 SPL token 批量发送到 1000+ 钱包,支持 Solana 上的 AI agent 支付。
相关 Skills
网页构建器
by anthropics
面向复杂 claude.ai HTML artifact 开发,快速初始化 React + Tailwind CSS + shadcn/ui 项目并打包为单文件 HTML,适合需要状态管理、路由或多组件交互的页面。
✎ 在 claude.ai 里做复杂网页 Artifact 很省心,多组件、状态和路由都能顺手搭起来,React、Tailwind 与 shadcn/ui 组合效率高、成品也更精致。
前端设计
by anthropics
面向组件、页面、海报和 Web 应用开发,按鲜明视觉方向生成可直接落地的前端代码与高质感 UI,适合做 landing page、Dashboard 或美化现有界面,避开千篇一律的 AI 审美。
✎ 想把页面做得既能上线又有设计感,就用前端设计:组件到整站都能产出,难得的是能避开千篇一律的 AI 味。
网页应用测试
by anthropics
用 Playwright 为本地 Web 应用编写自动化测试,支持启动开发服务器、校验前端交互、排查 UI 异常、抓取截图与浏览器日志,适合调试动态页面和回归验证。
✎ 借助 Playwright 一站式验证本地 Web 应用前端功能,调 UI 时还能同步查看日志和截图,定位问题更快。
相关 MCP Server
GitHub
编辑精选by GitHub
GitHub 是 MCP 官方参考服务器,让 Claude 直接读写你的代码仓库和 Issues。
✎ 这个参考服务器解决了开发者想让 AI 安全访问 GitHub 数据的问题,适合需要自动化代码审查或 Issue 管理的团队。但注意它只是参考实现,生产环境得自己加固安全。
Context7 文档查询
编辑精选by Context7
Context7 是实时拉取最新文档和代码示例的智能助手,让你告别过时资料。
✎ 它能解决开发者查找文档时信息滞后的问题,特别适合快速上手新库或跟进更新。不过,依赖外部源可能导致偶尔的数据延迟,建议结合官方文档使用。
by tldraw
tldraw 是让 AI 助手直接在无限画布上绘图和协作的 MCP 服务器。
✎ 这解决了 AI 只能输出文本、无法视觉化协作的痛点——想象让 Claude 帮你画流程图或白板讨论。最适合需要快速原型设计或头脑风暴的开发者。不过,目前它只是个基础连接器,你得自己搭建画布应用才能发挥全部潜力。