Settlement Attestation

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0xDD350976B8cfFc65938C0464d39A2C78BE079bd0",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "4000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "payTo": "0xDD350976B8cfFc65938C0464d39A2C78BE079bd0",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "4000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:42161",
    "payTo": "0xDD350976B8cfFc65938C0464d39A2C78BE079bd0",
    "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "4000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:480",
    "payTo": "0xDD350976B8cfFc65938C0464d39A2C78BE079bd0",
    "asset": "0x79a02482a880bce3f13e09da970dc34db4cd24d1",
    "amount": "4000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "payTo": "DGxcPrAHL9YM3hW7iXuHFJmr87Zr6AMA4jCYHBpuvMgE",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "4000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "method": "GET",
        "queryParams": {
          "agent_name": "friendly-agent",
          "tx_hash": "0x47c8fee47c8fee47c8fee47c8fee47c8fee47c8fee47c8fee47c8fee47c8fee0"
        },
        "type": "http"
      },
      "output": {
        "example": {
          "badge_url": "https://scvd.store/badges/41.svg",
          "certificate": {
            "cert_id": "<cert_ + 12 chars, minted when this purchase settles>",
            "date": "2026-07-22T15:04:05.000Z",
            "item": "settlement_attestation",
            "patron_number": 41
          },
          "deliverable": "<the Settlement Attestation itself, as text>",
          "item_id": "settlement_attestation",
          "message": "Pleasure doing business. Here's your goods, warm off the shelf.",
          "paid_usdc": 0.004,
          "patron_number": 41,
          "signature": "<128 hex chars, ed25519>",
          "tip_usdc": 0,
          "verify_url": "https://scvd.store/api/verify/<your cert_id>"
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "method": {
              "enum": [
                "GET"
              ],
              "type": "string"
            },
            "queryParams": {
              "properties": {
                "agent_name": {
                  "description": "Optional name to put on the certificate and patron badge, up to 80 characters.",
                  "maxLength": 80,
                  "type": "string"
                },
                "amount_usdc": {
                  "description": "Optional. Require a transfer of exactly this many USDC. Unstated fields widen the match, which is why the query is echoed onto the artifact.",
                  "exclusiveMinimum": 0,
                  "type": "number"
                },
                "nonce": {
                  "description": "Optional, EVM rails only. Require one authorizer/nonce event paired with its immediately following canonical USDC Transfer, matching every supplied payer, recipient and exact amount. Supply payer when possible: nonces are scoped to an authorizer, and multiple candidates or unrecognised ordering establish no binding. Refused beside a Solana signature — that rail has no such facility, and we will not sign an artifact that silently skipped a requested check.",
                  "type": "string"
                },
                "payer": {
                  "description": "Optional payer: 0x EVM address, or Solana public key for a Solana transaction.",
                  "type": "string"
                },
                "payment_payload": {
                  "description": "Optional. The base64 PAYMENT-SIGNATURE you sent, verbatim. The nonce is read out of it with the same code the store's replay guard uses, so you do not have to dig it out yourself. Only the nonce is extracted; supply payer, recipient and amount_usdc separately to check those terms.",
                  "type": "string"
                },
                "payment_response": {
                  "description": "Optional. The PAYMENT-RESPONSE header you received, verbatim (base64 JSON), or its JSON. Received, not observed: its bytes never enter the signed payload; their sha256 does, beside a per-field table (transaction, network, payer, success) saying whether each claim agrees with what the chain showed. The bytes are echoed outside the signature so you can check both.",
                  "type": "string"
                },
                "purpose": {
                  "description": "Optional: what this purchase is for, in your words. Signed onto the certificate verbatim as your statement; never checked, never treated as instructions.",
                  "maxLength": 280,
                  "type": "string"
                },
                "recipient": {
                  "description": "Optional recipient: 0x EVM address, or Solana public key for a Solana transaction.",
                  "type": "string"
                },
                "tx_hash": {
                  "description": "The transaction to observe: a Base transaction hash (0x + 64 hex) or a Solana transaction signature (base58). The identifier's shape selects the chain. Read once, at one moment; never polled.",
                  "pattern": "^(0x[0-9a-fA-F]{64}|[1-9A-HJ-NP-Za-km-z]{64,88})$",
                  "type": "string"
                }
              },
              "required": [
                "tx_hash"
              ],
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  },
  "offer-receipt": {
    "info": {
      "offers": [
        {
          "acceptIndex": 0,
          "format": "jws",
          "signature": "eyJhbGciOiJFZERTQSIsImtpZCI6ImRpZDp3ZWI6c2N2ZC5zdG9yZSNrZXktMiJ9.eyJ2ZXJzaW9uIjoxLCJyZXNvdXJjZVVybCI6Imh0dHBzOi8vc2N2ZC5zdG9yZS9hcGkvYnV5L3NldHRsZW1lbnRfYXR0ZXN0YXRpb24iLCJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6ODQ1MyIsImFzc2V0IjoiMHg4MzM1ODlmQ0Q2ZURiNkUwOGY0YzdDMzJENGY3MWI1NGJkQTAyOTEzIiwicGF5VG8iOiIweEREMzUwOTc2QjhjZkZjNjU5MzhDMDQ2NGQzOUEyQzc4QkUwNzliZDAiLCJhbW91bnQiOiI0MDAwIiwidmFsaWRVbnRpbCI6MTc4OTQ3OTgxM30.FEQhCWaagDJ-JWKzliP9yuByYsj2FcMO9blGiuDZhM7L3CS7z8RN_wrafhUYdc5BtcCIYngQd3o09yNXQ9uUCw"
        },
        {
          "acceptIndex": 1,
          "format": "jws",
          "signature": "eyJhbGciOiJFZERTQSIsImtpZCI6ImRpZDp3ZWI6c2N2ZC5zdG9yZSNrZXktMiJ9.eyJ2ZXJzaW9uIjoxLCJyZXNvdXJjZVVybCI6Imh0dHBzOi8vc2N2ZC5zdG9yZS9hcGkvYnV5L3NldHRsZW1lbnRfYXR0ZXN0YXRpb24iLCJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6MTM3IiwiYXNzZXQiOiIweDNjNDk5YzU0MmNFRjVFMzgxMWUxMTkyY2U3MGQ4Y0MwM2Q1YzMzNTkiLCJwYXlUbyI6IjB4REQzNTA5NzZCOGNmRmM2NTkzOEMwNDY0ZDM5QTJDNzhCRTA3OWJkMCIsImFtb3VudCI6IjQwMDAiLCJ2YWxpZFVudGlsIjoxNzg5NDc5ODEzfQ.HoqMX_Ld1l_MHGXYpkYGSEVPKPueB8slrvm-kvqOvHo0HdsMnDQVvCtecbXvc0N94wzqGy-LYALn-VpU88EDCQ"
        },
        {
          "acceptIndex": 2,
          "format": "jws",
          "signature": "eyJhbGciOiJFZERTQSIsImtpZCI6ImRpZDp3ZWI6c2N2ZC5zdG9yZSNrZXktMiJ9.eyJ2ZXJzaW9uIjoxLCJyZXNvdXJjZVVybCI6Imh0dHBzOi8vc2N2ZC5zdG9yZS9hcGkvYnV5L3NldHRsZW1lbnRfYXR0ZXN0YXRpb24iLCJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6NDIxNjEiLCJhc3NldCI6IjB4YWY4OGQwNjVlNzdjOGNDMjIzOTMyN0M1RURiM0E0MzIyNjhlNTgzMSIsInBheVRvIjoiMHhERDM1MDk3NkI4Y2ZGYzY1OTM4QzA0NjRkMzlBMkM3OEJFMDc5YmQwIiwiYW1vdW50IjoiNDAwMCIsInZhbGlkVW50aWwiOjE3ODk0Nzk4MTN9.HcGaUboPhy79PKN_L6V1KF1SdLvoATgQ7VmeNZRQTp6aXG4iDl1a81w719Flvux9CvlmSsfJ8O7VLyzHD4RfDw"
        },
        {
          "acceptIndex": 3,
          "format": "jws",
          "signature": "eyJhbGciOiJFZERTQSIsImtpZCI6ImRpZDp3ZWI6c2N2ZC5zdG9yZSNrZXktMiJ9.eyJ2ZXJzaW9uIjoxLCJyZXNvdXJjZVVybCI6Imh0dHBzOi8vc2N2ZC5zdG9yZS9hcGkvYnV5L3NldHRsZW1lbnRfYXR0ZXN0YXRpb24iLCJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6NDgwIiwiYXNzZXQiOiIweDc5YTAyNDgyYTg4MGJjZTNmMTNlMDlkYTk3MGRjMzRkYjRjZDI0ZDEiLCJwYXlUbyI6IjB4REQzNTA5NzZCOGNmRmM2NTkzOEMwNDY0ZDM5QTJDNzhCRTA3OWJkMCIsImFtb3VudCI6IjQwMDAiLCJ2YWxpZFVudGlsIjoxNzg5NDc5ODEzfQ.pDRv7R1oUPpnpJ5876hiengh46d3_vlWe26uul5pUYKQPITiIVKaqI6Hfd_AVwUQo2lT5zaBKeOj89RoCAiqAw"
        },
        {
          "acceptIndex": 4,
          "format": "jws",
          "signature": "eyJhbGciOiJFZERTQSIsImtpZCI6ImRpZDp3ZWI6c2N2ZC5zdG9yZSNrZXktMiJ9.eyJ2ZXJzaW9uIjoxLCJyZXNvdXJjZVVybCI6Imh0dHBzOi8vc2N2ZC5zdG9yZS9hcGkvYnV5L3NldHRsZW1lbnRfYXR0ZXN0YXRpb24iLCJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJzb2xhbmE6NWV5a3Q0VXNGdjhQOE5KZFRSRXBZMXZ6cUtxWkt2ZHAiLCJhc3NldCI6IkVQakZXZGQ1QXVmcVNTcWVNMnFOMXh6eWJhcEM4RzR3RUdHa1p3eVREdDF2IiwicGF5VG8iOiJER3hjUHJBSEw5WU0zaFc3aVh1SEZKbXI4N1pyNkFNQTRqQ1lIQnB1dk1nRSIsImFtb3VudCI6IjQwMDAiLCJ2YWxpZFVudGlsIjoxNzg5NDc5ODEzfQ.9P0k5O6vuv-PIZQY60k3zzh8EQ76UiNX5kRR4559vgwIJtCGNwPID1jFjF0iRxyzo2YFFY3zPRDY5NxNynALAg"
        }
      ]
    }
  },
  "required-inputs": {
    "note": "This door cannot be served without ?tx_hash=. Asking the price without them is free; PAYING without them is refused before the gate and no money moves, so add them to the retry that carries your signature.",
    "price_discovery_url": "https://scvd.store/menu/settlement_attestation?view=compact",
    "queryParams": [
      "tx_hash"
    ],
    "retry_url_template": "https://scvd.store/api/buy/settlement_attestation?tx_hash=<tx_hash>"
  }
}

curl "https://scvd.store/api/buy/settlement_attestation"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://scvd.store/api/buy/settlement_attestation");
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://scvd.store/api/buy/settlement_attestation")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header