English Français العربية

io.github.plagtech/spraay-solana-gateway

Registre officiel Finance et paiements

Batch send SOL or any SPL token to 1000+ wallets via x402. AI agent payments on Solana.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http spraay-solana-gateway 'https://gateway-solana.spraay.app/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "spraay-solana-gateway": {
            "type": "http",
            "url": "https://gateway-solana.spraay.app/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. 💧 Spraay Solana Gateway
  2. 🏗️ Architecture
  3. 📡 Endpoints
  4. 🚀 Quick Start
  5. 📖 API Usage
  6. 🔐 x402 Payment Flow
  7. 🤖 MCP Server
  8. 🌐 Deployment
  9. 🔗 Spraay Ecosystem
  10. 📄 License

💧 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

EndpointMethodPriceDescription
/solana/batch-send-solPOST$0.01Batch send SOL to multiple wallets
/solana/batch-send-tokenPOST$0.01Batch send any SPL token
/solana/quoteGET$0.001Get cost estimate
/solana/status/:txidGET$0.001Check transaction status
/healthGETFreeHealth check
/.well-known/x402GETFreex402 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

  1. Agent sends request without payment header
  2. Gateway returns 402 Payment Required with Solana USDC payment instructions
  3. Agent sends USDC on Solana to the treasury address
  4. Agent retries request with payment proof in X-PAYMENT header
  5. 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 SOL
  • spraay_solana_batch_send_token — Batch send SPL tokens
  • spraay_solana_quote — Cost estimation
  • spraay_solana_tx_status — Transaction lookup

🌐 Deployment

Railway
  1. Create new service in Railway project
  2. Connect GitHub repo: plagtech/spraay-solana-gateway
  3. Set environment variables in Railway dashboard
  4. Deploy → configure custom domain
DNS (GoDaddy)
Type: CNAME
Name: gateway-solana
Value: <railway-app-url>.railway.app
TTL: 600

🔗 Spraay Ecosystem

ServiceURL
Spraay Appspraay.app
Base Gatewaygateway.spraay.app
Solana Gatewaygateway-solana.spraay.app
GitHubgithub.com/plagtech
Twitter@Spraay_app

📄 License

MIT

Questions fréquentes

Qu'est-ce que io.github.plagtech/spraay-solana-gateway ?

Batch send SOL or any SPL token to 1000+ wallets via x402. AI agent payments on Solana.

Comment installer io.github.plagtech/spraay-solana-gateway ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http spraay-solana-gateway 'https://gateway-solana.spraay.app/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.plagtech/spraay-solana-gateway ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.plagtech/spraay-solana-gateway est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.plagtech/spraay-solana-gateway ?

Il est publié par plagtech. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.