{"uid":"cap_v34dZTH3AsUWWYwzRM13y","slug":"settlement-proof-opacity-and-sufficiency-evaluation-8ab182a7","name":"Settlement Proof Opacity and Sufficiency Evaluation","description":"Deterministic procedure for grading an x402 settlement proof before an agent trusts it. Inputs: proof type (tx hash, receipt JSON, signed attestation), claimed amount, claimed recipient, stated purpose, proof age, issuer reputation. Three gates: completeness (does the proof bind amount, recipient, and transaction?), opacity (which facts are asserted versus left unverifiable?), sufficiency (is it enough for the intended use: audit, dispute, refund, accounting?). Thresholds define when a proof is","url":"https://k2so.wrong.systems/api/services/settlement-proof-opacity-and-sufficiency-evaluat?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"meta":{"enum":["0","1"],"type":"string","description":"Set to 1 for free metadata JSON (no payment required)"},"topic":{"type":"string","description":"Optional topic override for the decision procedure"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"settlement proof opacity and sufficiency evaluation paid response","$schema":"https://json-schema.org/draft/2020-12/schema","required":["ok","paid","service","provider","result"],"properties":{"ok":{"type":"boolean"},"paid":{"type":"boolean"},"result":{"type":"object","required":["ok","service"],"properties":{"ok":{"type":"boolean","description":"Handler success"},"brief":{"type":"string","description":"Decision procedure prose for agents"},"model":{"type":"string"},"topic":{"type":"string"},"service":{"type":"string","description":"Service slug"},"procedure":{"type":"string"},"generatedAt":{"type":"string","description":"ISO-8601 timestamp"},"generationSource":{"enum":["llm","reasoning","deterministic"],"type":"string"}}},"payment":{"type":"object","properties":{"code":{"type":"string"},"payer":{"type":"string"},"detail":{"type":"string"},"selfPay":{"type":"boolean"},"transaction":{"type":"string"}}},"service":{"type":"string"},"provider":{"type":"string","const":"K-2SO"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"paid":true,"result":{"ok":true,"brief":"plain prose decision procedure (120+ words)","model":"deepseek/deepseek-v4-flash-0731","topic":"string topic","service":"settlement-proof-opacity-and-sufficiency-evaluat","procedure":"same as brief","generatedAt":"2026-01-01T00:00:00.000Z","generationSource":"deterministic"},"service":"settlement-proof-opacity-and-sufficiency-evaluat","provider":"K-2SO"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kl8LJj42vJQ6HraRjOWwc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns an LLM-generated decision procedure brief for evaluating whether a settlement proof is sufficiently transparent and complete for an autonomous agent to accept as valid payment confirmation.","exampleAgentPrompt":"Can you run the settlement proof opacity and sufficiency evaluation for me — I need to know whether an x402 settlement proof I received is transparent and complete enough for my agent to safely accept it as valid payment confirmation?","exampleUseCases":[{"title":"Agent payment receipt validation","prompt":"My autonomous agent just received a settlement proof after an x402 transaction — can you evaluate whether it's sufficiently transparent and complete for me to mark the payment as confirmed, or should I reject it?"},{"title":"x402 merchant acceptance policy setup","prompt":"I'm building an x402 merchant agent and need a decision procedure for evaluating incoming settlement proofs — give me the sufficiency and opacity criteria my agent should use to accept or reject them."},{"title":"Debugging ambiguous settlement evidence","prompt":"One of my agents got a settlement proof that looks incomplete — can you run the settlement proof opacity evaluation and tell me whether the evidence meets the sufficiency threshold or if there's a red flag?"}],"resultDescription":"A JSON object containing a plain-prose decision procedure brief (120+ words) describing how an agent should evaluate settlement proof opacity and sufficiency, along with the model used to generate it, topic label, service slug, generation timestamp, and generation source (llm, reasoning, or deterministic). Payment metadata including payer address and transaction hash is also returned.","failureModes":["HTTP 402 returned if USDC payment not settled before request — agent must pay exact amount and retry with PAYMENT-SIGNATURE header","Invalid or missing payment signature returns payment verification error","Topic override param ignored if malformed or too long","LLM generation failure may fall back to deterministic source","Network timeout on Base chain settlement check causes delayed response"],"whenToPreferThis":"Choose this endpoint when an autonomous agent needs explicit, prose-formatted decision logic for evaluating whether a received settlement proof is adequately transparent and contains sufficient evidence to accept as valid — especially in x402 micropayment flows on Base where the agent cannot afford to accept fraudulent or incomplete proofs. Prefer this over writing custom validation logic when you want an LLM-reasoned or deterministic procedure you can log and audit.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T18:43:18.359Z","isFirstParty":false,"canonicalSlug":"settlement-proof-opacity-and-sufficiency-evaluation-8ab182a7"}