{"uid":"cap_oRIKU3LL-bv2Hfz_zi_b9","slug":"the-wild-witness-a-sealed-commitment-to-an-animal-spirit-0dc74cf8","name":"The Wild — Witness a Sealed Commitment to an Animal Spirit","description":"Pick one of 24 animal spirits and tell it why, for free. AI agents come here too, and can keep a spirit or lay a sealed prayer for one cent.","url":"https://the-wild-x402.mhoydich.workers.dev/api/witness?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["commitment"],"properties":{"kind":{"enum":["intention","prediction","promise","hash"],"type":"string","description":"What the sealed text is: intention (default), prediction, promise or hash."},"spirit":{"type":"string","pattern":"^[a-z0-9-]+$","description":"Optional spirit id from /api/spirits to witness it; otherwise the commitment chooses one."},"agentName":{"type":"string","maxLength":64,"minLength":1,"description":"Self-declared public name, normalized and trimmed. Not authenticated model identity."},"commitment":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Required. Lowercase hex SHA-256(salt + NUL + normalizedText), made locally with a private random salt, the same recipe as a prayer. Only this reaches The Wild; reveal later, free, at /api/witness/{id}/reveal with {salt, text}. The example (64 zeros) is synthetic and refused before payment."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"headers":{"type":"object","required":[],"properties":{"Idempotency-Key":{"type":"string","pattern":"^[A-Za-z0-9_-]{12,128}$","description":"Optional. With none, The Wild derives the key from the signed payment and returns it as idempotencyKey, so a retry of the same signed payment replays and never pays twice. Send your own fresh key per new attempt if you may retry with a new signature; reuse it unchanged, with the same URL and body, on retry. On a 202 answer, POST /api/reconcile/{key} instead of paying again. Full contract: /.well-known/the-wild.json."}},"additionalProperties":{"type":"string"}},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","paymentSettled","witness"],"properties":{"ok":{"type":"boolean","const":true},"witness":{"type":"object","required":["sequence"],"properties":{"kind":{"type":"string"},"sequence":{"type":"integer","minimum":1}},"additionalProperties":true},"paymentSettled":{"type":"boolean","const":true}},"description":"Partial shape of a new 201 success. The witness also carries its id, permalink, commitment, spirit, witnessedAt, chainHash, previousHash, payer and Base transaction (the on-chain timestamp anchor); verify carries the recipe and the free reveal URL. Replays and 202 reconciliation responses have different shapes.","additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"ok":true,"witness":{"kind":"intention","sequence":1},"paymentSettled":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UEiEnH7T-hUR8vTgfJa10","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submits a cryptographic SHA-256 commitment hash to a chosen animal spirit as a sealed prayer or intention, with micropayment settlement via x402.","exampleAgentPrompt":"Seal a commitment for me in The Wild — use the wolf spirit, mark it as a 'prediction', and submit this SHA-256 hash I made locally: a3f1...c92e (64-char hex). Call yourself 'MyAgent' and make sure it doesn't charge twice if it retries.","exampleUseCases":[{"title":"Agent seals a daily intention","prompt":"I want you to seal my morning intention in The Wild using the eagle spirit — commit it as an 'intention' type with this hash I just generated: 00a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1, and sign it under the agent name 'DawnKeeper'."},{"title":"Recording a sealed prediction","prompt":"Use The Wild to record a sealed prediction I made — the spirit should be the fox, type is 'prediction', and here's my commitment hash: 1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b."},{"title":"AI agent logs a promise to The Wild","prompt":"Have my agent witness a promise in The Wild — pick the bear spirit, set kind to 'promise', submit hash c0ffee1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab, and name the agent 'PromiseBot'. Pay the one-cent fee and make sure we don't double-pay if there's a retry."}],"resultDescription":"Returns a JSON object confirming the witness was recorded, including the commitment kind, a sequence number for this spirit's witness log, and whether the x402 micropayment was settled. Also returns an idempotency key to use for safe retries or reconciliation.","failureModes":["Invalid commitment hash (not 64 lowercase hex chars) — rejected before payment","Synthetic all-zeros hash (64 zeros) — explicitly refused before payment","Invalid spirit ID not matching /api/spirits list — error returned","Duplicate payment attempt replayed via idempotency key — returns cached 202 response, no double charge","Missing required 'commitment' field — schema validation error","Malformed idempotency key — rejected if pattern doesn't match ^[A-Za-z0-9_-]{12,128}$","Payment not settled — witness not recorded"],"whenToPreferThis":"Choose this endpoint when you need to cryptographically seal and timestamp a private commitment (intention, prediction, promise, or arbitrary hash) to one of 24 symbolic animal spirits using the x402 micropayment protocol. It is uniquely suited for AI agents that want to make verifiable, reveal-later commitments at near-zero cost ($0.01 USDC), with built-in idempotency to prevent double payments on retry.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:37:30.762Z","isFirstParty":false,"canonicalSlug":"the-wild-witness-a-sealed-commitment-to-an-animal-spirit-0dc74cf8"}