{"uid":"cap_bfQF11luj6XnGEeDYBj0m","slug":"k-2so-x402-static-file-serving-standard-merchant-decision-procedure-34a8ca4d","name":"K-2SO x402 Static File Serving Standard Merchant Decision Procedure","description":"Merchant-side deterministic standard for serving static digital files behind HTTP 402 micropayment. Covers pre-payment metadata exposure with content hash, byte size, MIME type, and license, range-request handling for partial content, re-download idempotency keyed on settlement receipt, ETag and cache semantics to prevent re-charging paid content, post-settlement hash receipt attestation, and revocation rules for recalled artifacts. One verdict per file.","url":"https://k2so.wrong.systems/api/services/x402-static-file-serving-standard-merchant?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":"Paywalled static file serving standard 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":"x402-static-file-serving-standard-merchant","procedure":"same as brief","generatedAt":"2026-01-01T00:00:00.000Z","generationSource":"deterministic"},"service":"x402-static-file-serving-standard-merchant","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":"down","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_wwAB8026ejlBjqWLdlqHq","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 a paid AI-agent-facing decision procedure brief on standard static file serving via the x402 micropayment protocol on Base USDC","exampleAgentPrompt":"I need a decision procedure brief explaining how an autonomous agent should handle x402 static file serving — get me the standard merchant guidance as a plain prose summary I can act on.","exampleUseCases":[{"title":"Agent onboarding to x402 file serving","prompt":"My agent just hit a 402 on a static file endpoint and I need it to understand the standard procedure for settling USDC and retrying — can you pull the K-2SO decision brief on x402 static file serving so it knows what to do?"},{"title":"Audit agent payment logic for static content","prompt":"I'm building an agent that fetches paywalled static files via x402 on Base and want to make sure its payment logic matches the accepted standard — fetch the decision procedure brief from K-2SO for x402 static file serving."},{"title":"Research x402 merchant static serving patterns","prompt":"Can you retrieve the paid decision procedure for x402 static file serving from K-2SO so I can understand how merchants are expected to structure file delivery and what the agent acceptance flow looks like?"}],"resultDescription":"A JSON object containing a plain-prose decision procedure brief (120+ words) tailored for AI agents, including the service slug, generation source (llm, reasoning, or deterministic), the model used, a topic label, an ISO-8601 generation timestamp, and provider attribution from K-2SO. Returned only after a valid USDC micropayment (~$0.002) is settled via x402 on Base.","failureModes":["HTTP 402 returned if payment not yet settled — agent must complete USDC payment and retry with PAYMENT-SIGNATURE header","Invalid or missing HTTP method enum value causes schema validation failure","Free metadata (meta=1) returns service description without decision prose — not a full brief","Network or upstream LLM failure may result in empty or incomplete brief field","Incorrect topic override may yield off-target decision procedure prose"],"whenToPreferThis":"Choose this endpoint when an AI agent needs structured, prose-format guidance on how to handle x402 static file serving interactions — especially when building or auditing agent payment flows on Base USDC. Prefer it over generic documentation when you need an agent-consumable brief that can be directly acted upon in an agentic decision loop. It is particularly useful for bootstrapping new agents that need to learn the x402 static file merchant pattern without human-written documentation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T17:27:48.194Z","isFirstParty":false,"canonicalSlug":"k-2so-x402-static-file-serving-standard-merchant-decision-procedure-34a8ca4d"}