Agent-friendly multi-chain faucet routing through verified CDP and Paxos testnet providers

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0xbD62F8DCB52E21CA5BDf20ba173488Da101eBCf0",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "990000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "body": {
          "asset": "usdg",
          "idempotencyKey": "agent-run-20260723-001",
          "network": "robinhood-testnet",
          "recipient": "0xbD62F8DCB52E21CA5BDf20ba173488Da101eBCf0"
        },
        "bodyType": "json",
        "method": "POST",
        "type": "http"
      },
      "output": {
        "example": {
          "claim": {
            "amount": "100",
            "asset": "usdg",
            "deliveryStatus": "submitted",
            "explorerUrl": "https://explorer.testnet.chain.robinhood.com/address/0x...",
            "id": "faucetv2_...",
            "network": "robinhood-testnet",
            "provider": "paxos",
            "recipient": "0x...",
            "status": "settled",
            "transactionHash": null
          },
          "convenience": "Programmatic routing, payment, idempotency, and quota handling; test tokens have no sale price.",
          "ok": true,
          "priceUsd": 0.99,
          "receiptId": "pagw_faucet_...",
          "service": "testnet-faucet"
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "body": {
              "properties": {
                "asset": {
                  "description": "Test asset to request. Read the free assets catalog for valid combinations, amounts, and exact prices.",
                  "enum": [
                    "eth",
                    "usdc",
                    "eurc",
                    "cbbtc",
                    "sol",
                    "usdg",
                    "pyusd",
                    "usdp"
                  ],
                  "type": "string"
                },
                "idempotencyKey": {
                  "description": "Caller-stable key for this logical claim.",
                  "pattern": "^[A-Za-z0-9][A-Za-z0-9:._/-]{0,199}$",
                  "type": "string"
                },
                "network": {
                  "description": "Test network to fund. Read the free assets catalog for supported network/asset pairs.",
                  "enum": [
                    "base-sepolia",
                    "ethereum-sepolia",
                    "solana-devnet",
                    "xlayer-testnet",
                    "arbitrum-sepolia",
                    "ink-sepolia",
                    "robinhood-testnet",
                    "stellar-testnet",
                    "polygon-amoy"
                  ],
                  "type": "string"
                },
                "recipient": {
                  "description": "Recipient address in the selected network's EVM, Solana, or Stellar format.",
                  "maxLength": 56,
                  "minLength": 32,
                  "type": "string"
                }
              },
              "required": [
                "network",
                "asset",
                "recipient",
                "idempotencyKey"
              ]
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            },
            "method": {
              "enum": [
                "POST"
              ],
              "type": "string"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method",
            "bodyType",
            "body"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  },
  "builder-code": {
    "info": {
      "a": "bc_svz4q1d7"
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "properties": {
        "a": {
          "description": "App builder code",
          "pattern": "^[a-z0-9_]{1,32}$",
          "type": "string"
        },
        "s": {
          "description": "Service builder codes",
          "items": {
            "pattern": "^[a-z0-9_]{1,32}$",
            "type": "string"
          },
          "maxItems": 11,
          "type": "array"
        },
        "w": {
          "description": "Wallet builder code",
          "pattern": "^[a-z0-9_]{1,32}$",
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}

curl "https://hivemindos-paid-agent-gateway.hivemindos.workers.dev/api/x402/testnet-faucet/claims"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://hivemindos-paid-agent-gateway.hivemindos.workers.dev/api/x402/testnet-faucet/claims");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://hivemindos-paid-agent-gateway.hivemindos.workers.dev/api/x402/testnet-faucet/claims")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header