{"uid":"cap_HGVDdm3R4O_2i_0gynPSD","slug":"soren-commitment-reveal-open-3b7c9bed","name":"Soren Commitment Reveal (Open)","description":"Open a commitment issued by /v1/commit and receive a signed statement that the value matches what was sealed, and how long it was sealed for. A MISMATCH IS ALSO SIGNED, so an honest party can prove the other side produced something different from what it committed to. Use it to settle sealed bids and fair-play disputes. Verify with soren.com/oracle-key.json","url":"https://soren.com/v1/reveal?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["commitment","preimage"],"properties":{"preimage":{"type":"string","examples":["my sealed bid: 4200"],"description":"The original value. Maximum 2048 characters."},"commitment":{"type":"string","examples":["<commitment token>"],"description":"The token returned by /v1/commit, exactly as issued."}}}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"hash":"<64 hex>","matches":true,"revealed":true,"signature":{"value":"<base64>","algorithm":"Ed25519"},"revealed_at":"<ISO-8601 UTC>","committed_at":"<ISO-8601 UTC>","sealed_for_seconds":"<int>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_l2WJdbEmnBOWcPvaahVKc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Opens a sealed commitment token to verify whether the revealed preimage matches what was originally committed, returning a signed statement with match/mismatch result and seal duration.","exampleAgentPrompt":"Open my Soren commitment token '<commitment token>' with the original preimage 'my sealed bid: 4200' and give me the signed proof showing whether it matches and how long it was sealed.","exampleUseCases":[{"title":"Sealed-bid auction settlement","prompt":"I just won the auction and need to prove my bid was $4200 all along — open my Soren commitment token '<commitment token>' with preimage 'my auction bid: 4200' and get the signed statement confirming the match and seal duration."},{"title":"Fair-play dispute in a game","prompt":"My opponent is claiming I changed my move after seeing theirs — open my commitment token '<commitment token>' with preimage 'my move: rock' and get the signed proof, even if it shows a mismatch, so I can settle the dispute."},{"title":"Proving prior knowledge before an event","prompt":"I need to prove I predicted the outcome before it was announced — reveal my Soren commitment using token '<commitment token>' and preimage 'my prediction: team A wins' so I have a signed timestamp showing how long ago I sealed it."}],"resultDescription":"A signed statement from Soren's oracle (verifiable at soren.com/oracle-key.json) indicating whether the supplied preimage matches the original committed value, whether the result is a MATCH or MISMATCH (both outcomes are signed), and the duration for which the value was sealed.","failureModes":["Invalid or expired commitment token returns an error","Preimage exceeds 2048 character limit","Commitment token already opened (replay attempt)","Payment not settled (x402 payment required at $0.02 USDC)","Preimage does not match but a signed mismatch proof is still returned (not a failure per se — this is by design)"],"whenToPreferThis":"Use this endpoint when you need a cryptographically signed, oracle-backed proof of whether a preimage matches a sealed commitment — especially for settling sealed-bid auctions, resolving fair-play disputes, or producing verifiable evidence of prior knowledge. Unlike self-verified commitment schemes, Soren signs both match and mismatch outcomes, making it suitable for adversarial contexts where one party may act dishonestly. Prefer this over custom hash-based solutions when you need an independent third-party signed attestation that can be verified externally via soren.com/oracle-key.json.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:32:09.023Z","isFirstParty":false,"canonicalSlug":"soren-commitment-reveal-open-3b7c9bed"}