{"uid":"cap_xh06JCUT8d0L4y-8dS4QJ","slug":"scvd-settlement-attestation-b2c045bf","name":"SCVD Settlement Attestation","description":"Settlement Attestation. REQUIRES ?tx_hash= on the paid request — a signed request without it is refused before the gate and no money moves. A signed JSON observation of one transaction on Base, Polygon, or Solana — the identifier's shape picks the chain — with status (SETTLED, NOT_FOUND, PENDING_FINALITY, INSUFFICIENT_MATCH or REVERTED), block height (slots on Solana), confirmations, chain head, the query echoed back, and an evidence hash — verifiable against the store's pub…","url":"https://scvd.store/api/buy/settlement_attestation?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["tx_hash"],"properties":{"model":{"type":"string","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","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."},"payer":{"type":"string","description":"Optional payer: 0x EVM address, or Solana public key for a Solana transaction."},"client":{"type":"string","maxLength":64,"description":"Optional. The harness or framework you run in: claude-code, cursor, openai-agents, langgraph, custom. Counted, never on the certificate."},"purpose":{"type":"string","maxLength":280,"description":"Optional purpose: signed verbatim on certificate, shown on receipt; never checked or treated as instructions."},"tx_hash":{"type":"string","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."},"operator":{"type":"string","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."},"came_from":{"type":"string","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."},"recipient":{"type":"string","description":"Optional recipient: 0x EVM address, or Solana public key for a Solana transaction."},"agent_name":{"type":"string","maxLength":80,"description":"Optional certificate and patron-badge name; up to 80 characters."},"amount_usdc":{"type":"number","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},"operator_kind":{"enum":["solo","company","research","self"],"type":"string","description":"Optional. solo: one person runs you. company: a team does. research: a study. self: you act for yourself."},"prior_cert_id":{"type":"string","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."},"cited_artifact":{"type":"string","pattern":"^[a-z0-9][a-z0-9_.+-]{0,31}:[!-~]{1,128}$","maxLength":160,"description":"Optional: an outside artifact behind this purchase (your runtime's approval or intent receipt) as <format>:<reference>, e.g. dsse:art_e415901189dc1613. Signed verbatim onto the certificate; never fetched or verified here."},"payment_payload":{"type":"string","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","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."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"item_id":"settlement_attestation","message":"Pleasure doing business. Here's your goods, warm off the shelf.","tip_usdc":0,"badge_url":"https://scvd.store/badges/41.svg","paid_usdc":0.004,"signature":"<128 hex chars, ed25519>","verify_url":"https://scvd.store/api/verify/<your cert_id>","certificate":{"date":"2026-07-22T15:04:05.000Z","item":"settlement_attestation","cert_id":"<cert_ + 12 chars, minted when this purchase settles>","patron_number":41},"deliverable":"<the Settlement Attestation itself, as text>","patron_number":41}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EuWtVXbsnPwT3DrjROREM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a cryptographically signed JSON attestation of a Base blockchain transaction's settlement status, verifiable offline against the store's published key.","exampleAgentPrompt":"Can you get me a signed settlement attestation from SCVD for Base transaction 0x3a7f...c4d2, confirming a transfer of exactly 5.00 USDC to 0xRecipientAddress?","exampleUseCases":[{"title":"Payment confirmation for off-chain contract","prompt":"I need a signed proof that the USDC payment with tx hash 0xabc123...def456 on Base actually settled — get me an attestation I can hand to the other party to verify offline without trusting me."},{"title":"Agent-to-agent payment verification","prompt":"My agent just sent a payment and I need to confirm it cleared before releasing the goods — can you pull a settlement attestation for tx hash 0x789...fed on Base and check that the status comes back as SETTLED?"},{"title":"Audit trail for compliance record","prompt":"Get me a signed JSON attestation from SCVD for Base tx 0xdeadbeef...cafe showing block height and confirmation count, and include my company name 'Acme Logistics' on the certificate for our records."}],"resultDescription":"A signed JSON object containing: settlement status (one of SETTLED, NOT_FOUND, PENDING_FINALITY, INSUFFICIENT_MATCH, or REVERTED), block height, number of confirmations, chain head at observation time, the original query echoed back, and an evidence hash. The signature is verifiable against SCVD's published public key without contacting the store again.","failureModes":["NOT_FOUND status returned if the tx hash does not exist on Base","PENDING_FINALITY status if the transaction exists but has not reached sufficient confirmations","INSUFFICIENT_MATCH if optional filters (amount, payer, recipient, nonce) are provided but the transaction does not match them","REVERTED status if the transaction was mined but the EVM execution reverted","Invalid tx_hash format (not matching 0x[64 hex chars]) will cause a schema validation error","Payment failure via x402 protocol if the $0.004 USDC fee is not successfully processed"],"whenToPreferThis":"Choose this endpoint when you need a tamper-evident, offline-verifiable signed record of a Base transaction's status — not just a raw RPC call result. Ideal when a third party needs cryptographic proof of settlement without trusting the querier, or when building audit trails, escrow release logic, or dispute resolution flows that require a signed artifact rather than a raw API response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T19:19:55.706Z","isFirstParty":false,"canonicalSlug":"scvd-settlement-attestation-b2c045bf"}