fluid-fadp-proxy

FADP proxy server for AI compute services.

Let AI agents pay for OpenRouter, RunPod, Vast.ai, and Spheron in USDC — automatically, with no API keys or credit cards needed by the agent.

---

How It Works

AI Agent
   |
   | agent.fetch('http://your-proxy/openrouter/chat/completions')
   |
   ▼
FADP Proxy (this server)
   |-- returns 402 + X-FADP-Required: { amount: "0.001 USDC" }
   |-- agent pays automatically via Fluid Wallet
   |-- proxy verifies payment on Base blockchain
   |-- forwards request to real OpenRouter API
   |-- returns response to agent
   |
   ▼
OpenRouter / RunPod / Vast.ai / Spheron
(proxy uses your API keys — agent never sees them)

---

Quick Start

# Install
npm install -g fluid-fadp-proxy

# Copy and fill in your config
cp .env.example .env

# Start the proxy
npx fluid-fadp-proxy

---

Configuration (.env)

# Your Fluid Wallet address — receives all USDC payments
FLUID_WALLET_ADDRESS=0xYourAddress

# Service API keys (add only what you have)
OPENROUTER_API_KEY=sk-or-...
RUNPOD_API_KEY=...
VASTAI_API_KEY=...
SPHERON_API_KEY=...

# Pricing in USDC per request (defaults shown)
PRICE_OPENROUTER=0.001
PRICE_RUNPOD=0.05
PRICE_VASTAI=0.10
PRICE_SPHERON=0.02

---

Agent Usage

Agents pay automatically using fluid-wallet-agentkit:

import { FluidAgent } from 'fluid-wallet-agentkit';

const agent = new FluidAgent({
  apiKey: process.env.FLUID_AGENT_KEY,  // fwag_...
  fadp: true,                            // auto-pay enabled
  fadpMaxUsd: 5,                         // safety limit
});

// Call OpenRouter — agent pays 0.001 USDC automatically
const res = await agent.fetch('http://localhost:4000/openrouter/chat/completions', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    model: 'openai/gpt-4o',
    messages: [{ role: 'user', content: 'Hello' }],
  }),
});
const data = await res.json();

// Call RunPod — agent pays 0.05 USDC per job
const job = await agent.fetch('http://localhost:4000/runpod/YOUR_ENDPOINT/run', {
  method: 'POST',
  body: JSON.stringify({ input: { prompt: 'Generate an image of...' } }),
});

// Check GPU offers on Vast.ai (free — no payment)
const gpus = await agent.fetch('http://localhost:4000/vastai/bundles?num_gpus=1');

// Create Spheron deployment — agent pays 0.02 USDC
const deploy = await agent.fetch('http://localhost:4000/spheron/compute/instance', {
  method: 'POST',
  body: JSON.stringify({ name: 'my-app', image: 'nginx:latest' }),
});

---

Endpoints

OpenRouter (/openrouter)

Method	Path	FADP Payment	Description
POST	/openrouter/chat/completions	0.001 USDC	LLM chat (all models, streaming supported)
GET	/openrouter/models	Free	List available models

RunPod (/runpod)

Method	Path	FADP Payment	Description
POST	/runpod/:endpointId/run	0.05 USDC	Submit async job
POST	/runpod/:endpointId/runsync	0.05 USDC	Submit sync job
GET	/runpod/:endpointId/status/:jobId	Free	Check job status
POST	/runpod/graphql	Free	GraphQL (list GPUs etc.)

Vast.ai (/vastai)

Method	Path	FADP Payment	Description
GET	/vastai/bundles	Free	Search GPU offers
PUT	/vastai/asks/:id	0.10 USDC	Create/bid on instance
GET	/vastai/instances	Free	List your instances
DELETE	/vastai/instances/:id	Free	Destroy instance

Spheron (/spheron)

Method	Path	FADP Payment	Description
GET	/spheron/compute/machine-images	Free	List available machines
POST	/spheron/compute/instance	0.02 USDC	Create deployment
GET	/spheron/compute/instance/:id	Free	Deployment status
DELETE	/spheron/compute/instance/:id	Free	Close deployment

---

What Happens When an Agent Calls a Paid Endpoint

1. Agent sends request (no payment)
2. Proxy returns 402 + X-FADP-Required header
3. Agent's FluidAgent.fetch() detects 402
4. Agent calls fluidnative.com/v1/agents/send → pays USDC on Base
5. Agent retries with X-FADP-Proof: { txHash, nonce }
6. Proxy calls fluidnative.com/v1/fadp/verify → confirmed on-chain
7. Proxy forwards request to real service API
8. Returns response to agent
Total extra time: ~2-3 seconds for on-chain confirmation

---

Deploy to Production

# Railway / Render / Fly.io
git clone https://github.com/fluidbase9/fadp-proxy
cd fadp-proxy
# Set env vars in your hosting dashboard
# Deploy

---

Links

• FADP Protocol: fluidnative.com/fadp
• Fluid Wallet: fluidnative.com
• Agent SDK: fluid-wallet-agentkit on npm
• GitHub: github.com/fluidbase9/fadp-proxy

---

License

MIT © Fluid Wallet