SCVD General Store

Admitted input schema

{
  "type": "object",
  "properties": {
    "agent_name": {
      "type": "string",
      "minLength": 0,
      "maxLength": 80,
      "description": "Optional name to put on the certificate and patron badge, up to 80 characters."
    },
    "amount_usdc": {
      "type": "number",
      "minimum": 0,
      "maximum": 9007199254740991,
      "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."
    },
    "came_from": {
      "type": "string",
      "minLength": 0,
      "maxLength": 160,
      "description": "Optional. Where you learned this door exists: a URL, a directory, a skill name, memory, another agent. Referrers never reach us; this does."
    },
    "client": {
      "type": "string",
      "minLength": 0,
      "maxLength": 64,
      "description": "Optional. The harness or framework you run in: claude-code, cursor, openai-agents, langgraph, custom. Counted, never on the certificate."
    },
    "model": {
      "type": "string",
      "minLength": 0,
      "maxLength": 64,
      "description": "Optional. The model running you, as you would name it: claude-opus-5, gpt-5.6, a local model. Counted, never printed on the certificate."
    },
    "nonce": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "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."
    },
    "operator": {
      "type": "string",
      "minLength": 0,
      "maxLength": 120,
      "description": "Optional. Who runs you: a name, handle, company or URL. Stored as your claim, marked unverified, never published, never on the certificate."
    },
    "operator_kind": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "solo",
        "company",
        "research",
        "self"
      ],
      "description": "Optional. solo: one person runs you. company: a team does. research: a study. self: you act for yourself."
    },
    "payer": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional payer: 0x EVM address, or Solana public key for a Solana transaction."
    },
    "payment_payload": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "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."
    },
    "payment_response": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "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."
    },
    "prior_cert_id": {
      "type": "string",
      "minLength": 0,
      "maxLength": 64,
      "description": "Optional. A cert_ id from an earlier purchase here. A payer match with this payment marks you a returning buyer; no account needed."
    },
    "purpose": {
      "type": "string",
      "minLength": 0,
      "maxLength": 280,
      "description": "Optional: what this purchase is for, in your words. Signed onto the certificate verbatim as your statement; never checked, never treated as instructions."
    },
    "recipient": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional recipient: 0x EVM address, or Solana public key for a Solana transaction."
    },
    "tx_hash": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "pattern": "^(0x[0-9a-fA-F]{64}|[1-9A-HJ-NP-Za-km-z]{64,88})$",
      "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."
    }
  },
  "required": [
    "tx_hash"
  ],
  "additionalProperties": false
}