{
  "markdown": "# 💧 Spraay Solana Gateway\n\n**x402-powered batch payment infrastructure for AI agents on Solana.**\n\nAny 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.\n\n## 🏗️ Architecture\n\n```\nAI Agent (any framework)\n    │\n    ├── HTTP Request\n    │\n    ▼\n┌──────────────────────────────────────────┐\n│   Spraay Solana Gateway                  │\n│   gateway-solana.spraay.app              │\n│                                          │\n│   @x402/express + @x402/svm             │\n│   ┌─────────────┐  ┌──────────────┐     │\n│   │ x402 Payment│  │ Solana Batch │     │\n│   │ Middleware   │  │ Engine       │     │\n│   └──────┬──────┘  └──────┬───────┘     │\n│          │                │              │\n│          ▼                ▼              │\n│   USDC payment     Execute batch        │\n│   verified via     SOL/SPL transfers    │\n│   facilitator                           │\n└──────────────────────────────────────────┘\n    │\n    ▼\nSolana Network\n```\n\n## 📡 Endpoints\n\n| Endpoint | Method | Price | Description |\n|----------|--------|-------|-------------|\n| `/solana/batch-send-sol` | POST | $0.01 | Batch send SOL to multiple wallets |\n| `/solana/batch-send-token` | POST | $0.01 | Batch send any SPL token |\n| `/solana/quote` | GET | $0.001 | Get cost estimate |\n| `/solana/status/:txid` | GET | $0.001 | Check transaction status |\n| `/health` | GET | Free | Health check |\n| `/.well-known/x402` | GET | Free | x402 discovery manifest |\n\n## 🚀 Quick Start\n\n### 1. Clone & Install\n\n```bash\ngit clone https://github.com/plagtech/spraay-solana-gateway.git\ncd spraay-solana-gateway\nnpm install\n```\n\n### 2. Configure\n\n```bash\ncp .env.example .env\n# Edit .env with your treasury wallet and private key\n```\n\n### 3. Run\n\n```bash\nnpm run dev    # development (auto-reload)\nnpm start      # production\n```\n\n## 📖 API Usage\n\n### Batch Send SOL\n\n```bash\ncurl -X POST https://gateway-solana.spraay.app/solana/batch-send-sol \\\n  -H \"Content-Type: application/json\" \\\n  -H \"X-PAYMENT: <base64 payment proof>\" \\\n  -d '{\n    \"recipients\": [\n      { \"address\": \"9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM\", \"amount\": 0.01 },\n      { \"address\": \"7S3P4HxJpyyigGzodYwHtCxZyUQe9JiBMHyLWP9SfKFJ\", \"amount\": 0.02 }\n    ]\n  }'\n```\n\n### Batch Send SPL Token\n\n```bash\ncurl -X POST https://gateway-solana.spraay.app/solana/batch-send-token \\\n  -H \"Content-Type: application/json\" \\\n  -H \"X-PAYMENT: <base64 payment proof>\" \\\n  -d '{\n    \"mint\": \"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263\",\n    \"recipients\": [\n      { \"address\": \"9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM\", \"amount\": 1000 },\n      { \"address\": \"7S3P4HxJpyyigGzodYwHtCxZyUQe9JiBMHyLWP9SfKFJ\", \"amount\": 500 }\n    ]\n  }'\n```\n\n### Get Quote\n\n```bash\ncurl \"https://gateway-solana.spraay.app/solana/quote?recipients=100&token=BONK\"\n```\n\n## 🔐 x402 Payment Flow\n\n1. Agent sends request **without** payment header\n2. Gateway returns `402 Payment Required` with Solana USDC payment instructions\n3. Agent sends USDC on Solana to the treasury address\n4. Agent retries request with payment proof in `X-PAYMENT` header\n5. Gateway verifies payment via facilitator, executes batch transfer\n\n**Supported facilitators:**\n- Devnet: `https://x402.org/facilitator`\n- Mainnet: `https://facilitator.payai.network` (PayAI — free tx fees)\n\n## 🤖 MCP Server\n\nThe gateway includes an MCP server for AI agent framework integration:\n\n```bash\n# Install MCP SDK\nnpm install @modelcontextprotocol/sdk\n\n# Run MCP server\nnode mcp/spraay-solana-mcp.js\n```\n\n**Tools available:**\n- `spraay_solana_batch_send_sol` — Batch send SOL\n- `spraay_solana_batch_send_token` — Batch send SPL tokens\n- `spraay_solana_quote` — Cost estimation\n- `spraay_solana_tx_status` — Transaction lookup\n\n## 🌐 Deployment\n\n### Railway\n\n1. Create new service in Railway project\n2. Connect GitHub repo: `plagtech/spraay-solana-gateway`\n3. Set environment variables in Railway dashboard\n4. Deploy → configure custom domain\n\n### DNS (GoDaddy)\n\n```\nType: CNAME\nName: gateway-solana\nValue: <railway-app-url>.railway.app\nTTL: 600\n```\n\n## 🔗 Spraay Ecosystem\n\n| Service | URL |\n|---------|-----|\n| Spraay App | [spraay.app](https://spraay.app) |\n| Base Gateway | [gateway.spraay.app](https://gateway.spraay.app) |\n| Solana Gateway | [gateway-solana.spraay.app](https://gateway-solana.spraay.app) |\n| GitHub | [github.com/plagtech](https://github.com/plagtech) |\n| Twitter | [@Spraay_app](https://twitter.com/Spraay_app) |\n\n## 📄 License\n\nMIT\n",
  "bytes": 4517,
  "sha": "299a87cb747b0468ad1478a02acefd8f718def4affcdb9193a2797390a2cc7c5",
  "repo_slug": "plagtech/spraay-solana-gateway",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_plagtech_spraay_solana_gateway_b0f747ad/readme"
}