💡 What This Solves

AI agents are rapidly becoming autonomous economic actors, but they have no native way to pay for services programmatically. OWS Agent Pay bridges this gap:

AI Agent calls API → Server returns HTTP 402 → SDK auto-pays → Agent gets result

Zero payment code required from the agent developer. The SDK intercepts, validates, settles, and retries — all transparently.

⚠️ This is not a hackathon prototype. We extracted the core x402 payment logic from our live production stack (10K+ monthly NPM downloads) into a clean, OWS-compliant SDK.

⚡ Quick Start

Option 1: Browser Demo (Zero Install)

▶ Open the live demo → — click "Run Live Demo" and watch the full x402 cycle in 30 seconds.

Option 2: CLI Demo

# Clone and install
git clone https://github.com/ASGCompute/ASGCompute-ows-agent-pay.git
cd ASGCompute-ows-agent-pay
npm install

# Run the demo (simulated mode — no ETH needed)
npx ts-node demo.ts --simulate

# Or run with real Base Sepolia testnet (auto-funds via Coinbase faucet)
npx ts-node demo.ts

Option 3: Use in Your Agent

import { OwsClient, BasePaymentAdapter } from 'ows-agent-pay';

const adapter = new BasePaymentAdapter({
  privateKey: process.env.AGENT_PRIVATE_KEY as `0x${string}`,
  network: 'mainnet',
});

const agent = new OwsClient({
  baseURL: 'https://inference-api.example.com',
  policy: {
    monthlyBudget: 100,
    maxAmountPerTransaction: 5,
    allowedDestinations: ['0x...'],
  },
  adapter, // Swap to StellarPaymentAdapter for Stellar
});

// Agent code — no payment logic needed!
const result = await agent.performTask('/v1/chat', {
  model: 'gpt-4',
  messages: [{ role: 'user', content: 'Summarize this document' }],
});

Expected CLI Output

╔══════════════════════════════════════════════════╗
║   OWS Agent Pay — Base/EVM Autonomous Demo      ║
║   Built by ASG Pay  •  https://asgcard.dev       ║
║   x402 Protocol  •  Base (Coinbase L2)           ║
╚══════════════════════════════════════════════════╝

[Server] Mock API listening on http://localhost:4020
[Agent] Wallet: 0xAb5801a7D398991B8a7cF7706226...
[Agent] Chain:  Base Sepolia (eip155:84532)
[Agent] 💧 Requesting ETH from Base Sepolia faucet…
[Agent] ✅ Wallet funded from Coinbase faucet
[Agent] 💰 Balance: 0.1 ETH
[Agent] 🧠 Sending inference request…

[OWS Client] ⚡ Received 402 Payment Required challenge
[OWS Client] 💰 Requested payment: $0.50
[OWS Client] ⛓️  Settlement chain: Base (eip155:84532)
[OWS Client] ✅ Policy check PASSED — settling on-chain…
[Base] 🚀 Building payment → 0xDead71…8B3c4F (0.0005 ETH, Base Sepolia)
[Base] 📡 Submitting transaction…
[Base] ✅ Confirmed — hash: 0x9e8f7a6b5c4d3e2f…
[OWS Client] 🔁 Constructing X-PAYMENT token and retrying…

[AI Agent] ✅ Task completed: The AI model computed the answer...

── 🏁 Demo complete ───────────────────────────

🏗️ Architecture

                            ┌──────────────────┐
                            │    AI  Agent      │
                            │  performTask()    │
                            └────────┬─────────┘
                                     │ HTTP POST
                            ┌────────▼─────────┐
                            │   OwsClient       │
                            │  (Axios + 402     │
                            │   interceptor)    │
                            └─┬──────────────┬──┘
                              │              │
               ┌──────────────▼──┐   ┌───────▼───────────┐
               │  PolicyEngine   │   │  PaymentAdapter    │
               │  ┌────────────┐ │   │  (interface)       │
               │  │ Budget     │ │   │                    │
               │  │ Per-tx max │ │   │  ┌──────────────┐  │
               │  │ Allowlist  │ │   │  │ Base (viem)  │  │
               │  └────────────┘ │   │  ├──────────────┤  │
               └─────────────────┘   │  │ Stellar      │  │
                                     │  ├──────────────┤  │
                                     │  │ (Arbitrum…)  │  │
                                     │  └──────────────┘  │
                                     └───────────────────┘

📐 OWS Spec Compliance

🔐 Policy Engine (Fail-Closed)

Every payment must pass all three checks before execution:

const policy: BudgetPolicy = {
  monthlyBudget: 50.0,           // USD cap per calendar month
  maxAmountPerTransaction: 5.0,  // USD cap per single payment
  allowedDestinations: [         // Whitelist of recipient addresses
    '0xDead7101a13B2B6e2A4497706226bc3c4F',
  ],
};

❌ Over budget → REJECTED
❌ Over per-tx limit → REJECTED
❌ Unknown destination → REJECTED
✅ All checks pass → SETTLED

⛓️ Supported Chains

💡 Any chain can be added by implementing the PaymentAdapter interface (~40 lines).

🌐 Live Production Products

This is not a hackathon prototype. Every product below is deployed and serving real traffic right now.

🔗 Try them yourself

npm install @asgcard/pay

npm install @asgcard/fund

npx @asgcard/cli

📦 NPM Packages

Package	Install	Downloads	Description
@asgcard/pay	npm i @asgcard/pay		Core payment SDK
@asgcard/fund	npm i @asgcard/fund		Payment link generator CLI
@asgcard/cli	npx @asgcard/cli		Virtual card issuing CLI

🎮 Interactive Demos

🏆 Hackathon Track Alignment

🤝 Sponsor & Partner Alignment

Primary settlement Native x402 chain

USDC settlement EVM + Stellar

Production adapter Mainnet USDC

EVM adapter Roadmap

Fiat settlement fund.asgcard.dev

Cross-chain Aggregator

Bridging Partner

🛣️ Roadmap

• OWS-compliant 402 interceptor with policy engine
• Base adapter (viem, Coinbase L2 — native x402 chain)
• Stellar adapter (production-proven via ASG Pay)
• Multi-chain adapter interface (CAIP-2)
• Interactive browser demo (GitHub Pages)
• Full ecosystem demo (Fund → Card → Pay lifecycle)
• Arbitrum / OP Stack adapters
• Solana adapter (via @solana/web3.js)
• Li.Fi integration (cross-chain settlement aggregator)
• MCP tool server (A2A protocol bridge)
• USDC (ERC-20) transfer support on Base

📊 Key Metrics

📄 License

MIT — see LICENSE for details.