Agent quickstart

PRUDRA_API_KEY=prv_test_sk_... \
PAYMENT_STUB_MODE=true \
npx tsx example-01-basic-paywall.ts
# Server running on :4001

curl -X POST http://localhost:4001/summarise \
  -H "Content-Type: application/json" \
  -d '{"text": "Summarise this"}'

HTTP/1.1 402 Payment Required
PAYMENT-REQUIRED: <base64-encoded challenge>
WWW-Authenticate: Payment realm="..." id="..." request="..." expires="..."

import { ethers } from 'ethers';
import {
  signX402Payment,
  decodePaymentRequirements,
  selectPaymentOption,
} from '@prudra/payments';

const agentWallet = new ethers.Wallet(
  '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80'
  // ↑ test-only private key — never use in production
);

// Step 1: Hit endpoint, get 402
const r1 = await fetch('http://localhost:4001/summarise', {
  method:  'POST',
  headers: { 'Content-Type': 'application/json' },
  body:    JSON.stringify({ text: 'Summarise this' }),
});
// r1.status === 402

// Step 2: Decode challenge and sign
const requirements = decodePaymentRequirements(r1.headers.get('payment-required')!);
const option = selectPaymentOption(requirements, 'USDC');
const { xPaymentHeader } = await signX402Payment(agentWallet, option);

// Step 3: Retry with signature
const r2 = await fetch('http://localhost:4001/summarise', {
  method:  'POST',
  headers: {
    'Content-Type':    'application/json',
    'PAYMENT-SIGNATURE': xPaymentHeader,
  },
  body: JSON.stringify({ text: 'Summarise this' }),
});
// r2.status === 200

const result = await r2.json();
console.log('Vault ID:', result.vaultId);
console.log('Result:', result);

{
  "vaultId": "vlt_clx1abc123",
  "summary": "This is a summary...",
  "payment": {
    "protocol": "x402",
    "txHash":   "0xabc...",
    "amount":   "0.01"
  }
}