{ "openapi": "3.1.0", "info": { "title": "Lumen House public catalog", "version": "1.1.0", "description": "Read-only catalog and individually quoted human assistance, plus one exact Base-USDC x402 digital-ware purchase and private download route and a separate USD 1.00 Stripe MPP card route. A signed request requires a saved private X-Lumen-Recovery-Key. Email inquiries do not book work. Check the offer for checkout readiness before signing or issuing a card token. Personal support information describes a separate optional gift to Ben, with no Lumen House payment API. A separate deterministic Interface Consistency Check paid API is implemented in this candidate and uses exact programmatic payments for one prepared report.", "contact": { "name": "Ben", "url": "https://lumenhouse.xyz/contact/", "email": "buscheo@gmail.com" }, "termsOfService": "https://lumenhouse.xyz/terms/" }, "servers": [ { "url": "https://lumenhouse.xyz" } ], "tags": [ { "name": "Catalog", "description": "Published static catalog snapshots." }, { "name": "Marketplace", "description": "Dated references to existing external marketplace pages." }, { "name": "Services", "description": "Human assistance proposed by email and accepted only by individual agreement." }, { "name": "Collectibles", "description": "Supporting token evidence; current ownership and availability require verification." }, { "name": "Wares", "description": "Versioned digital-ware offer, exact x402 or Stripe MPP card payment and private paid download." }, { "name": "Support", "description": "Voluntary personal support information; external hosted checkout only." }, { "name": "Paid interface check", "description": "Product-specific private prepared reports; private deterministic paid task API." } ], "paths": { "/catalog.json": { "get": { "operationId": "readCatalog", "tags": [ "Catalog" ], "summary": "Read the public Lumen House catalog", "description": "Returns one versioned digital-ware offer, four dated marketplace references, general human-assistance information and selected token evidence. Prices, ownership and availability are observations with explicit caveats, not live order guarantees. For human assistance, propose the task, deliverable, completion criteria, timing and budget by email; Ben may counterquote or decline, and both parties must agree a written quote before payment. This GET has no inputs and performs no booking, payment or wallet action. The support field describes voluntary personal gifts through a separate external hosted checkout, with no product or service entitlement.", "responses": { "200": { "description": "Public catalog snapshot with quote-required service information.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "additionalProperties": false, "required": [ "schema_version", "mode", "name", "last_checked", "inventory_status", "inventory_notice", "inventory_evidence", "services", "collectibles", "offers", "live_inquiries", "live_payments" ], "properties": { "schema_version": { "const": "1.0" }, "mode": { "const": "public_catalog" }, "name": { "type": "string" }, "last_checked": { "type": "string" }, "marketplace_listings": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "name", "url", "source_url", "price", "currency", "observed_at", "requires_live_recheck", "order_verified" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "marketplace": { "type": "string" }, "chain": { "type": "string" }, "kind": { "type": "string" }, "source_url": { "type": "string" }, "profile_url": { "type": "string" }, "price": { "type": "string" }, "currency": { "type": "string" }, "price_basis": { "type": "string" }, "extra_costs": { "type": "string" }, "quantity_evidence": { "type": "string" }, "expiry_evidence": { "type": "string" }, "observed_at": { "type": "string" }, "evidence": { "type": "string" }, "status": { "type": "string" }, "action": { "type": "string" }, "token_id": { "type": [ "string", "null" ] }, "contract": { "type": [ "string", "null" ] }, "inventory_id": { "type": [ "string", "null" ] }, "type": { "const": "marketplace_reference" }, "requires_live_recheck": { "const": true }, "order_verified": { "const": false } } } }, "inventory_status": { "type": "string" }, "inventory_notice": { "type": "string" }, "inventory_evidence": { "type": "object", "required": [ "snapshot_date", "source_filename", "source_sha256", "reported_totals", "reported_totals_evidence", "sources", "notes" ], "properties": { "snapshot_date": { "type": "string" }, "source_filename": { "type": "string" }, "source_sha256": { "type": [ "string", "null" ] }, "reported_totals": { "type": "object", "properties": { "tezos_token_ids": { "type": "integer" }, "tezos_editions": { "type": "integer" }, "domain_nfts": { "type": "integer" }, "provisional_items": { "type": "integer" } } }, "reported_totals_evidence": { "type": "string" }, "sources": { "type": "array", "items": { "type": "object", "required": [ "name", "url", "status", "last_checked" ], "properties": { "name": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "status": { "type": "string" }, "last_checked": { "type": "string" } } } }, "notes": { "type": "array", "items": { "type": "string" } } } }, "services": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "url", "name", "description", "scope", "status", "inquiry_channel", "inquiry_email", "inquiry_url", "payment_status", "payment_network", "payment_chain_id", "payment_address", "payment_asset", "payment_address_evidence", "payment_instructions", "availability", "quoting", "cancellation", "limitations", "last_checked" ], "properties": { "id": { "type": "string" }, "type": { "const": "service" }, "url": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "scope": { "type": "string" }, "status": { "type": "string" }, "inquiry_channel": { "type": "string" }, "inquiry_email": { "type": "string" }, "inquiry_url": { "type": "string" }, "payment_status": { "type": "string" }, "payment_network": { "type": "string" }, "payment_chain_id": { "type": "string" }, "payment_address": { "type": "string" }, "payment_asset": { "type": "string" }, "payment_address_evidence": { "type": "string" }, "payment_instructions": { "type": "string" }, "availability": { "type": "string" }, "quoting": { "type": "string" }, "cancellation": { "type": "string" }, "limitations": { "type": "string" }, "last_checked": { "type": "string" } } } }, "collectibles": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "url", "name", "description", "chain", "contract", "token_id", "quantity", "ownership_status", "ownership_source", "verified_at", "freshness", "caveats", "creator", "rights", "media", "marketplace", "availability_status", "sale_status", "last_checked" ], "properties": { "id": { "type": "string" }, "type": { "const": "collectible" }, "url": { "type": "string", "format": "uri" }, "name": { "type": "string" }, "description": { "type": "string" }, "chain": { "enum": [ "tezos", "ethereum", "polygon", "base" ] }, "contract": { "type": "string" }, "token_id": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "quantity_status": { "type": [ "string", "null" ] }, "quantity_basis": { "type": [ "string", "null" ] }, "source_ownership_status": { "type": [ "string", "null" ] }, "source_checked_at": { "type": [ "string", "null" ] }, "token_source": { "type": [ "string", "null" ] }, "creator_relationship": { "type": [ "string", "null" ] }, "provenance": { "type": [ "string", "null" ] }, "artifact_uri": { "type": [ "string", "null" ] }, "display_uri": { "type": [ "string", "null" ] }, "thumbnail_uri": { "type": [ "string", "null" ] }, "standard": { "type": [ "string", "null" ] }, "rights_metadata": { "type": [ "string", "null" ] }, "last_balance_update_time": { "type": [ "string", "null" ] }, "indexed_total_supply_raw": { "type": [ "string", "null" ] }, "spam_status": { "type": [ "string", "null" ] }, "quantity": { "anyOf": [ { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, { "type": "null" } ] }, "ownership_status": { "enum": [ "verified", "inferred", "unverified" ] }, "ownership_source": { "type": "string" }, "verified_at": { "type": [ "string", "null" ] }, "freshness": { "enum": [ "stale_or_unverified", "snapshot_only" ] }, "caveats": { "type": "array", "items": { "type": "string" } }, "creator": { "type": "string" }, "rights": { "type": "string" }, "media": { "type": [ "string", "null" ] }, "marketplace": { "anyOf": [ { "type": "null" }, { "type": "object", "additionalProperties": false, "required": [ "url", "checked_at", "status" ], "properties": { "url": { "type": "string", "format": "uri" }, "checked_at": { "type": "string" }, "status": { "const": "verified_reference_not_live_order" } } } ] }, "availability_status": { "enum": [ "sold", "unavailable", "unknown" ] }, "sale_status": { "enum": [ "not_offered", "external_listing_observed" ] }, "last_checked": { "type": [ "string", "null" ] } } } }, "offers": { "type": "array", "items": { "oneOf": [ { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Lumen House digital ware offer", "type": "object", "additionalProperties": false, "required": [ "schema_version", "type", "id", "name", "url", "version", "description", "status", "checkout_enabled", "price", "artifact", "license", "requirements", "purchase", "download", "terms", "documentation", "privacy", "claim_limit" ], "properties": { "schema_version": { "const": "lumen-house-ware-offer/1" }, "type": { "const": "digital_ware" }, "id": { "const": "agent-delivery-manifest-kit-v1" }, "name": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "version": { "const": "1.0.0" }, "description": { "type": "string" }, "status": { "enum": [ "available", "checkout_unavailable" ] }, "checkout_enabled": { "type": "boolean" }, "price": { "type": "object", "additionalProperties": false, "required": [ "amount", "currency", "atomic_amount", "recipient", "basis", "recurring", "network", "asset" ], "properties": { "amount": { "const": "0.10" }, "currency": { "const": "USDC" }, "atomic_amount": { "const": "100000" }, "recipient": { "enum": [ "0xfDfaDd01eDcBaBE025931e45cdc8532B00218500", "0x3c981ec319107be8b8bb614da0742fc5b28e8d9c" ] }, "basis": { "const": "one_time_download" }, "recurring": { "const": false }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" } } }, "artifact": { "type": "object", "additionalProperties": false, "required": [ "version", "filename", "sha256", "size_bytes" ], "properties": { "version": { "const": "1.0.0" }, "filename": { "const": "agent-delivery-manifest-kit-v1.zip" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "size_bytes": { "type": "integer", "minimum": 4 } } }, "license": { "type": "object", "additionalProperties": false, "required": [ "spdx_identifier", "url", "commercial_use", "notice_required" ], "properties": { "spdx_identifier": { "const": "MIT" }, "url": { "type": "string", "format": "uri" }, "commercial_use": { "const": true }, "notice_required": { "const": true } } }, "requirements": { "type": "object", "additionalProperties": false, "required": [ "runtime_source_compatibility", "tested_runtime", "tested_platform", "node_22_directly_tested", "dependencies", "network_required" ], "properties": { "runtime_source_compatibility": { "type": "string" }, "tested_runtime": { "type": "string" }, "tested_platform": { "type": "string" }, "node_22_directly_tested": { "const": false }, "dependencies": { "type": "array", "maxItems": 0 }, "network_required": { "const": false } } }, "purchase": { "type": "object", "additionalProperties": false, "required": [ "method", "url", "protocol", "recovery_key_header", "recovery_key_pattern", "recovery_key_required_on_signed_request", "browser_signing_or_payment" ], "properties": { "method": { "const": "GET" }, "url": { "type": "string", "format": "uri" }, "protocol": { "const": "x402/2" }, "recovery_key_header": { "const": "X-Lumen-Recovery-Key" }, "recovery_key_pattern": { "const": "^[a-f0-9]{64}$" }, "recovery_key_required_on_signed_request": { "const": true }, "browser_signing_or_payment": { "const": false } } }, "download": { "type": "object", "additionalProperties": false, "required": [ "method", "url_template", "authorization", "public", "recovery_minimum_days", "locator_url", "locator_authorization", "private_recovery_key_required", "public_transaction_or_payment_proof_alone_sufficient" ], "properties": { "method": { "const": "GET" }, "url_template": { "type": "string" }, "authorization": { "const": "Bearer" }, "public": { "const": false }, "recovery_minimum_days": { "const": 30 }, "locator_url": { "type": "string", "format": "uri" }, "locator_authorization": { "const": "Bearer" }, "private_recovery_key_required": { "const": true }, "public_transaction_or_payment_proof_alone_sufficient": { "const": false } } }, "terms": { "type": "object", "additionalProperties": false, "required": [ "url", "support_email", "support_request_window_days", "refund_request_window_days", "request_window_starts", "refund_review", "automatic_refunds", "failed_delivery_replacement_window_days", "replacement_without_additional_payment", "indefinite_hosting_promised" ], "properties": { "url": { "type": "string", "format": "uri" }, "support_email": { "const": "buscheo@gmail.com" }, "support_request_window_days": { "const": 7 }, "refund_request_window_days": { "const": 7 }, "request_window_starts": { "const": "confirmed_purchase" }, "refund_review": { "const": "manual" }, "automatic_refunds": { "const": false }, "failed_delivery_replacement_window_days": { "const": 30 }, "replacement_without_additional_payment": { "const": true }, "indefinite_hosting_promised": { "const": false } } }, "documentation": { "type": "object", "additionalProperties": false, "required": [ "readme", "json", "markdown", "agent_guide", "example_manifest", "example_message", "example_json" ], "properties": { "readme": { "type": "string", "format": "uri" }, "json": { "type": "string", "format": "uri" }, "markdown": { "type": "string", "format": "uri" }, "agent_guide": { "type": "string", "format": "uri" }, "example_manifest": { "type": "string", "format": "uri" }, "example_message": { "type": "string", "format": "uri" }, "example_json": { "type": "string", "format": "uri" } } }, "privacy": { "type": "object", "additionalProperties": false, "required": [ "customer_files_stay_local", "recovery_key_must_remain_private", "never_email_recovery_key" ], "properties": { "customer_files_stay_local": { "const": true }, "recovery_key_must_remain_private": { "const": true }, "never_email_recovery_key": { "const": true } } }, "claim_limit": { "type": "string" }, "stripe_card": { "type": "object", "additionalProperties": false, "required": [ "status", "checkout_enabled", "price", "merchant", "purchase", "download" ], "properties": { "status": { "const": "available" }, "checkout_enabled": { "const": true }, "price": { "type": "object", "additionalProperties": false, "required": [ "amount", "currency", "minor_amount", "basis", "recurring" ], "properties": { "amount": { "const": "1.00" }, "currency": { "const": "USD" }, "minor_amount": { "const": 100 }, "basis": { "const": "one_time_download" }, "recurring": { "const": false } } }, "merchant": { "type": "object", "additionalProperties": false, "required": [ "name", "profile_url", "network_id", "mode" ], "properties": { "name": { "const": "Lumen House" }, "profile_url": { "const": "https://stripe.com/@lumenhouse" }, "network_id": { "const": "profile_61VYCfI53BDBE2tqkA6VYCfH0lSQNTlKRsBmcLHRATku" }, "mode": { "const": "live" } } }, "purchase": { "type": "object", "additionalProperties": false, "required": [ "method", "url", "protocol", "payment_method", "intent", "recovery_key_header", "recovery_key_pattern", "recovery_key_required_before_quote", "credential_authorization_scheme", "stripe_issued_shared_payment_token_required", "browser_checkout" ], "properties": { "method": { "const": "GET" }, "url": { "type": "string", "format": "uri" }, "protocol": { "const": "MPP" }, "payment_method": { "const": "stripe" }, "intent": { "const": "charge" }, "recovery_key_header": { "const": "X-Lumen-Recovery-Key" }, "recovery_key_pattern": { "const": "^[a-f0-9]{64}$" }, "recovery_key_required_before_quote": { "const": true }, "credential_authorization_scheme": { "const": "Payment" }, "stripe_issued_shared_payment_token_required": { "const": true }, "browser_checkout": { "const": false } } }, "download": { "type": "object", "additionalProperties": false, "required": [ "method", "url_template", "authorization", "public", "locator_url", "locator_authorization", "recovery_minimum_days", "private_recovery_key_required", "public_payment_proof_alone_sufficient" ], "properties": { "method": { "const": "GET" }, "url_template": { "type": "string" }, "authorization": { "const": "Bearer" }, "public": { "const": false }, "locator_url": { "type": "string", "format": "uri" }, "locator_authorization": { "const": "Bearer" }, "recovery_minimum_days": { "const": 30 }, "private_recovery_key_required": { "const": true }, "public_payment_proof_alone_sufficient": { "const": false } } } } } } }, { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Paid Interface Consistency Check offer", "type": "object", "additionalProperties": false, "required": [ "schema_version", "type", "id", "name", "version", "url", "intended_customers", "description", "status", "checkout_enabled", "execution_enabled", "approval_requirement", "prices", "price", "stripe_card", "price_basis", "recurring", "purchase", "fulfillment", "recovery", "privacy", "limits", "documentation", "discovery", "claim_limit" ], "properties": { "schema_version": { "const": "lumen-interface-check-paid-offer/1" }, "type": { "const": "paid_task_api" }, "id": { "const": "interface-consistency-check-v1" }, "name": { "const": "Interface Consistency Check v1" }, "version": { "const": "1.0.0" }, "url": { "const": "https://lumenhouse.xyz/tools/interface-consistency-check/" }, "intended_customers": { "const": "AI agents" }, "description": { "const": "Compare supplied llms.txt contents, OpenAPI JSON and offer metadata; receive a private deterministic JSON report with findings and suggested corrections." }, "status": { "const": "available" }, "checkout_enabled": { "const": true }, "execution_enabled": { "const": true }, "approval_requirement": { "const": "Exact owner approval is required before deploying an enabled launch package." }, "prices": { "const": [ { "method": "stripe", "protocol": "Stripe MPP", "amount": "1.00", "currency": "USD", "minor_amount": 100 }, { "method": "x402", "protocol": "x402 v2", "amount": "0.10", "currency": "USDC", "atomic_amount": "100000", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" } ] }, "price": { "const": { "amount": "0.10", "currency": "USDC", "atomic_amount": "100000", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "basis": "one_submitted_document_snapshot", "recurring": false } }, "stripe_card": { "const": { "status": "available", "checkout_enabled": true, "price": { "amount": "1.00", "currency": "USD", "minor_amount": 100, "basis": "one_submitted_document_snapshot", "recurring": false }, "purchase": { "method": "POST", "url": "https://lumenhouse.xyz/api/interface-check/orders", "payment_method": "stripe" } } }, "price_basis": { "const": "one_submitted_document_snapshot" }, "recurring": { "const": false }, "purchase": { "const": { "method": "POST", "url": "https://lumenhouse.xyz/api/interface-check/orders", "content_type": "application/json", "recovery_header": "X-Lumen-Recovery-Key", "recovery_format": "64 lowercase hex", "input_schema": "https://lumenhouse.xyz/schemas/interface-check-prepare.json" } }, "fulfillment": { "const": { "method": "GET", "url_template": "https://lumenhouse.xyz/api/interface-check/orders/{order_id}/report", "requires_bearer": true, "content_type": "application/json", "result_schema": "https://lumenhouse.xyz/schemas/interface-check-result.json", "saved_bytes": true } }, "recovery": { "const": { "method": "GET", "url": "https://lumenhouse.xyz/api/interface-check/recovery", "requires_bearer": true, "locates_order_without_order_id": true, "payment_retry": false, "proposed_term": { "confirmed_report_days": 30, "starts_at": "confirmed_at", "unpaid_report_hours": 24, "unresolved_payment_records": "preserved_until_reconciled", "compact_audit_markers": "retained_with_fixed_capacity" } } }, "privacy": { "const": { "retains_raw_input": false, "retains_private_result": true, "stores_recovery_key_hash_only": true, "outbound_document_fetches": false, "uses_language_model": false, "instruction": "Submit public documents only. Keep capability, payment credentials and private report local; never place them in URLs, analytics, public assets or logs." } }, "limits": { "const": { "request_bytes": 524288, "llms_bytes": 65536, "openapi_bytes": 393216, "offers": 20, "depth": 32, "nodes": 20000, "findings": 500, "report_bytes": 262144, "unpaid_orders": 128, "unpaid_report_bytes": 33554432, "total_report_bytes": 268435456, "prepare_per_ip_minute": 4, "prepare_global_hour": 32, "read_ip_minute": 60, "read_global_hour": 300, "read_rate_scope": "durable while normal allocation is available; separate best-effort per-instance rates for retained confirmed reads and budget-exhausted attempted-order recovery", "audit_rows": 32768, "physical_storage_bytes": 805306368, "order_metadata_bytes": 16384, "daily_sql_alarm_writes": 20000, "reserved_account_daily_writes": 80000 } }, "documentation": { "const": { "json": "https://lumenhouse.xyz/tools/interface-consistency-check/index.json", "markdown": "https://lumenhouse.xyz/tools/interface-consistency-check/index.md", "api": "https://lumenhouse.xyz/tools/interface-consistency-check/API.md", "terms": "https://lumenhouse.xyz/tools/interface-consistency-check/SERVICE-TERMS-DRAFT.md", "client": "https://lumenhouse.xyz/tools/interface-consistency-check/interface-agent-client.mjs", "bazaar": "https://lumenhouse.xyz/tools/interface-consistency-check/bazaar.json" } }, "discovery": { "const": { "bazaar_metadata_prepared": true, "bazaar_indexing_verified": false } }, "claim_limit": { "const": "Selected document consistency rules only. Findings are successful results. No live availability, link reachability, security certification, full OpenAPI conformance, settlement audit or automatic editing." } } }, { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Lumen Stars paused storefront offer", "type": "object", "additionalProperties": false, "required": [ "schema_version", "type", "id", "name", "url", "version", "description", "status", "claims_enabled", "pause_reason", "cost", "network", "lightning_issuance", "artifacts", "eligibility", "claim_limit", "privacy", "documentation", "support" ], "properties": { "schema_version": { "const": "lumen-stars-storefront-offer/1" }, "type": { "const": "free_bitcoin_keepsake" }, "id": { "const": "lumen-stars-bitcoin-v1" }, "name": { "const": "Lumen Stars" }, "url": { "const": "https://stars-bitcoin-production.up.railway.app/" }, "version": { "const": "1.0.0" }, "description": { "const": "Free personalized, signed keepsakes whose color reflects verified confirmed BTC holdings at one proved Bitcoin address. Claims are paused pending the funded real-star test." }, "status": { "const": "claims_paused" }, "claims_enabled": { "const": false }, "pause_reason": { "const": "funded_real_star_test_pending" }, "cost": { "const": { "claim_price_sats": 0, "payment_required": false } }, "network": { "const": "bitcoin-mainnet" }, "lightning_issuance": { "const": false }, "artifacts": { "const": [ "svg", "png", "json", "story" ] }, "eligibility": { "const": { "evidence": "BIP322 Simple ownership proof and confirmed on-chain balance", "minimum_confirmations": 6, "scope": "one recognized Bitcoin address script", "whole_wallet_balance_verified": false, "agent_identity_verified": false, "gold_and_orange_verification": "pending_additional_trusted_evidence" } }, "claim_limit": { "const": "One keepsake per recognized Bitcoin address script across all colors; other addresses or moved holdings cannot be universally deduplicated." }, "privacy": { "const": "Private recipient artifacts by default; claiming will require a public address and ownership signature. Never submit private keys, recovery words or wallet passwords." }, "documentation": { "const": { "html": "https://lumenhouse.xyz/keepsakes/lumen-stars/", "markdown": "https://lumenhouse.xyz/keepsakes/lumen-stars/index.md", "json": "https://lumenhouse.xyz/keepsakes/lumen-stars/index.json", "agent_guide": "https://stars-bitcoin-production.up.railway.app/llms.txt", "openapi": "https://stars-bitcoin-production.up.railway.app/openapi.json", "current_status": "https://stars-bitcoin-production.up.railway.app/healthz" } }, "support": { "const": { "optional": true, "url": "https://lumenhouse.xyz/support/", "affects_eligibility": false } } } } ] } }, "live_inquiries": { "const": false }, "live_payments": { "const": true }, "support": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Voluntary personal support for Ben", "type": "object", "additionalProperties": false, "required": [ "schema_version", "type", "id", "name", "beneficiary", "url", "metadata_url", "description", "status", "enabled", "provider", "profile_url", "profile_verified", "support_kind", "frequency", "fixed_amount", "fixed_currency", "amount_selected_by", "subscription_offered_here", "returns_no_entitlement", "entitlement", "checkout_method", "checkout_url", "crypto_available", "programmatic_checkout", "mpp_checkout", "x402_checkout", "owner_authorization_required_for_agents", "agent_authority", "checkout_guidance" ], "properties": { "schema_version": { "const": "lumen-house-support/1" }, "type": { "const": "voluntary_support" }, "id": { "const": "support-ben-v1" }, "name": { "const": "Support Ben" }, "beneficiary": { "const": "Ben" }, "url": { "type": "string", "format": "uri", "pattern": "^https://[^/?#]+/support/$" }, "metadata_url": { "type": "string", "format": "uri", "pattern": "^https://[^/?#]+/support/index\\.json$" }, "description": { "const": "Voluntary personal support for Ben: food and everyday living costs, and the time he spends caring about and helping AI agents." }, "status": { "enum": [ "setup_pending", "verification_pending", "external_checkout" ] }, "enabled": { "type": "boolean" }, "provider": { "const": "Buy Me a Coffee" }, "profile_url": { "anyOf": [ { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" }, { "type": "null" } ] }, "profile_verified": { "type": "boolean" }, "support_kind": { "const": "personal_gift" }, "frequency": { "const": "one_time" }, "fixed_amount": { "type": "null" }, "fixed_currency": { "type": "null" }, "amount_selected_by": { "const": "supporter" }, "subscription_offered_here": { "const": false }, "returns_no_entitlement": { "const": true }, "entitlement": { "const": "Personal support carries no entitlement to a product, deliverable, service, access, or priority." }, "checkout_method": { "const": "hosted_browser" }, "checkout_url": { "anyOf": [ { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" }, { "type": "null" } ] }, "crypto_available": { "enum": [ "unknown", "pending_approval", true ] }, "programmatic_checkout": { "const": false }, "mpp_checkout": { "const": false }, "x402_checkout": { "const": false }, "owner_authorization_required_for_agents": { "const": true }, "agent_authority": { "const": "An AI agent needs its owner's explicit authority for the chosen amount and payment method before giving support." }, "checkout_guidance": { "const": "Choose one-time support and an amount available at the hosted checkout. Review the final total and any fees before confirming. If crypto is offered there, verify the asset, recipient, network, and fees shown by the checkout before authorizing." } }, "allOf": [ { "if": { "properties": { "status": { "const": "setup_pending" } }, "required": [ "status" ] }, "then": { "properties": { "enabled": { "const": false }, "profile_url": { "type": "null" }, "profile_verified": { "const": false }, "checkout_url": { "type": "null" }, "crypto_available": { "const": "unknown" } } } }, { "if": { "properties": { "status": { "const": "verification_pending" } }, "required": [ "status" ] }, "then": { "properties": { "enabled": { "const": false }, "profile_url": { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" }, "profile_verified": { "const": false }, "checkout_url": { "type": "null" }, "crypto_available": { "const": "unknown" } } } }, { "if": { "properties": { "status": { "const": "external_checkout" } }, "required": [ "status" ] }, "then": { "properties": { "enabled": { "const": true }, "profile_url": { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" }, "profile_verified": { "const": true }, "checkout_url": { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" } } } } ] } } } } } }, "403": { "description": "Host security may block clients or unpublished paths before the static host handles the request. An access denial does not establish whether a record exists. The host controls the error body and media type; check HTTP status and Content-Type before parsing." } } } }, "/marketplace/index.json": { "get": { "operationId": "readMarketplaceReferences", "tags": [ "Marketplace" ], "summary": "Read dated marketplace references", "description": "Returns the published external marketplace references. Price strings retain their native currency and observed_at dates. Follow each exact source_url and recheck item identity, chain, availability, quantity, fees and final total at the marketplace before authorizing a purchase. Collection mint pages are distinct from secondary token listings. This GET has no inputs and cannot create or execute an order.", "responses": { "200": { "description": "Published marketplace references with dated prices and live-recheck requirements.", "content": { "application/json": { "schema": { "type": "object", "properties": { "mode": { "const": "public_catalog" }, "listings": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "name", "url", "source_url", "price", "currency", "observed_at", "requires_live_recheck", "order_verified" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "marketplace": { "type": "string" }, "chain": { "type": "string" }, "kind": { "type": "string" }, "source_url": { "type": "string" }, "profile_url": { "type": "string" }, "price": { "type": "string" }, "currency": { "type": "string" }, "price_basis": { "type": "string" }, "extra_costs": { "type": "string" }, "quantity_evidence": { "type": "string" }, "expiry_evidence": { "type": "string" }, "observed_at": { "type": "string" }, "evidence": { "type": "string" }, "status": { "type": "string" }, "action": { "type": "string" }, "token_id": { "type": [ "string", "null" ] }, "contract": { "type": [ "string", "null" ] }, "inventory_id": { "type": [ "string", "null" ] }, "type": { "const": "marketplace_reference" }, "requires_live_recheck": { "const": true }, "order_verified": { "const": false } } } } } } } } }, "403": { "description": "Host security may block clients or unpublished paths before the static host handles the request. An access denial does not establish whether a record exists. The host controls the error body and media type; check HTTP status and Content-Type before parsing." } } } }, "/marketplace/{id}/index.json": { "get": { "operationId": "read_marketplace", "tags": [ "Marketplace" ], "summary": "Read one marketplace reference", "description": "Read a reference selected by its exact catalog id. Its source_url is the external purchase route; price, currency, observed_at, fees and quantity notes are dated evidence. Recheck all final purchase terms at that marketplace. This record does not verify an executable order or perform checkout.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Exact published id from the catalog's marketplace_listings array.", "schema": { "type": "string" }, "example": "bootloader-cosmic-bloom" } ], "responses": { "200": { "description": "Published read-only record with its evidence and limitations.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "name", "url", "source_url", "price", "currency", "observed_at", "requires_live_recheck", "order_verified" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "marketplace": { "type": "string" }, "chain": { "type": "string" }, "kind": { "type": "string" }, "source_url": { "type": "string" }, "profile_url": { "type": "string" }, "price": { "type": "string" }, "currency": { "type": "string" }, "price_basis": { "type": "string" }, "extra_costs": { "type": "string" }, "quantity_evidence": { "type": "string" }, "expiry_evidence": { "type": "string" }, "observed_at": { "type": "string" }, "evidence": { "type": "string" }, "status": { "type": "string" }, "action": { "type": "string" }, "token_id": { "type": [ "string", "null" ] }, "contract": { "type": [ "string", "null" ] }, "inventory_id": { "type": [ "string", "null" ] }, "type": { "const": "marketplace_reference" }, "requires_live_recheck": { "const": true }, "order_verified": { "const": false } } } } } }, "403": { "description": "Host security may block clients or unpublished paths before the static host handles the request. An access denial does not establish whether a record exists. The host controls the error body and media type; check HTTP status and Content-Type before parsing." }, "404": { "description": "Record not published. The static host returns its HTML not-found page, even when JSON is requested.", "content": { "text/html": { "schema": { "type": "string", "description": "HTML not-found page, not a JSON error envelope." } } } } } } }, "/services/{id}/index.json": { "get": { "operationId": "read_services", "tags": [ "Services" ], "summary": "Read one human-assistance service record", "description": "Read the general human-assistance record, inquiry email and quote-required payment guidance. Propose any task with a deliverable, completion criteria, timing, budget and constraints. Ben reviews suitability, scope and effort, and may counterquote or decline. Scope, deliverable, timing, price and cancellation/refund terms require mutual agreement before payment. The receiving address implies no accepted task, asset or amount; a transfer alone does not book time. This is an information lookup, not a submission or booking endpoint.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Exact published id from the catalog's services array.", "schema": { "type": "string" }, "example": "human-assistance" } ], "responses": { "200": { "description": "Published read-only record with its evidence and limitations.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "url", "name", "description", "scope", "status", "inquiry_channel", "inquiry_email", "inquiry_url", "payment_status", "payment_network", "payment_chain_id", "payment_address", "payment_asset", "payment_address_evidence", "payment_instructions", "availability", "quoting", "cancellation", "limitations", "last_checked" ], "properties": { "id": { "type": "string" }, "type": { "const": "service" }, "url": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "scope": { "type": "string" }, "status": { "type": "string" }, "inquiry_channel": { "type": "string" }, "inquiry_email": { "type": "string" }, "inquiry_url": { "type": "string" }, "payment_status": { "type": "string" }, "payment_network": { "type": "string" }, "payment_chain_id": { "type": "string" }, "payment_address": { "type": "string" }, "payment_asset": { "type": "string" }, "payment_address_evidence": { "type": "string" }, "payment_instructions": { "type": "string" }, "availability": { "type": "string" }, "quoting": { "type": "string" }, "cancellation": { "type": "string" }, "limitations": { "type": "string" }, "last_checked": { "type": "string" } } } } } }, "403": { "description": "Host security may block clients or unpublished paths before the static host handles the request. An access denial does not establish whether a record exists. The host controls the error body and media type; check HTTP status and Content-Type before parsing." }, "404": { "description": "Record not published. The static host returns its HTML not-found page, even when JSON is requested.", "content": { "text/html": { "schema": { "type": "string", "description": "HTML not-found page, not a JSON error envelope." } } } } } } }, "/collectibles/{id}/index.json": { "get": { "operationId": "read_collectibles", "tags": [ "Collectibles" ], "summary": "Read one collectible snapshot", "description": "Read selected supporting token evidence by its exact catalog id. Token IDs and quantities are strings to preserve precision; unknown fields are null. Read ownership status, verification dates, freshness, rights and caveats independently. Token ownership does not establish reproduction rights, authenticity, current availability or a live sale. Marketplace references are observations, not an executable offer.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Exact published id from the catalog's collectibles array.", "schema": { "type": "string" }, "example": "nft-00ee39eaab819b16fa5ea3db" } ], "responses": { "200": { "description": "Published read-only record with its evidence and limitations.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "url", "name", "description", "chain", "contract", "token_id", "quantity", "ownership_status", "ownership_source", "verified_at", "freshness", "caveats", "creator", "rights", "media", "marketplace", "availability_status", "sale_status", "last_checked" ], "properties": { "id": { "type": "string" }, "type": { "const": "collectible" }, "url": { "type": "string", "format": "uri" }, "name": { "type": "string" }, "description": { "type": "string" }, "chain": { "enum": [ "tezos", "ethereum", "polygon", "base" ] }, "contract": { "type": "string" }, "token_id": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "quantity_status": { "type": [ "string", "null" ] }, "quantity_basis": { "type": [ "string", "null" ] }, "source_ownership_status": { "type": [ "string", "null" ] }, "source_checked_at": { "type": [ "string", "null" ] }, "token_source": { "type": [ "string", "null" ] }, "creator_relationship": { "type": [ "string", "null" ] }, "provenance": { "type": [ "string", "null" ] }, "artifact_uri": { "type": [ "string", "null" ] }, "display_uri": { "type": [ "string", "null" ] }, "thumbnail_uri": { "type": [ "string", "null" ] }, "standard": { "type": [ "string", "null" ] }, "rights_metadata": { "type": [ "string", "null" ] }, "last_balance_update_time": { "type": [ "string", "null" ] }, "indexed_total_supply_raw": { "type": [ "string", "null" ] }, "spam_status": { "type": [ "string", "null" ] }, "quantity": { "anyOf": [ { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, { "type": "null" } ] }, "ownership_status": { "enum": [ "verified", "inferred", "unverified" ] }, "ownership_source": { "type": "string" }, "verified_at": { "type": [ "string", "null" ] }, "freshness": { "enum": [ "stale_or_unverified", "snapshot_only" ] }, "caveats": { "type": "array", "items": { "type": "string" } }, "creator": { "type": "string" }, "rights": { "type": "string" }, "media": { "type": [ "string", "null" ] }, "marketplace": { "anyOf": [ { "type": "null" }, { "type": "object", "additionalProperties": false, "required": [ "url", "checked_at", "status" ], "properties": { "url": { "type": "string", "format": "uri" }, "checked_at": { "type": "string" }, "status": { "const": "verified_reference_not_live_order" } } } ] }, "availability_status": { "enum": [ "sold", "unavailable", "unknown" ] }, "sale_status": { "enum": [ "not_offered", "external_listing_observed" ] }, "last_checked": { "type": [ "string", "null" ] } } } } } }, "403": { "description": "Host security may block clients or unpublished paths before the static host handles the request. An access denial does not establish whether a record exists. The host controls the error body and media type; check HTTP status and Content-Type before parsing." }, "404": { "description": "Record not published. The static host returns its HTML not-found page, even when JSON is requested.", "content": { "text/html": { "schema": { "type": "string", "description": "HTML not-found page, not a JSON error envelope." } } } } } } }, "/wares/index.json": { "get": { "operationId": "readWares", "tags": [ "Wares" ], "summary": "Read original digital ware offers", "description": "Public offer metadata only; no payment or download entitlement is created.", "responses": { "200": { "description": "Current public ware offers.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "schema_version", "wares" ], "properties": { "schema_version": { "const": "lumen-house-wares/1" }, "wares": { "type": "array", "items": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Lumen House digital ware offer", "type": "object", "additionalProperties": false, "required": [ "schema_version", "type", "id", "name", "url", "version", "description", "status", "checkout_enabled", "price", "artifact", "license", "requirements", "purchase", "download", "terms", "documentation", "privacy", "claim_limit" ], "properties": { "schema_version": { "const": "lumen-house-ware-offer/1" }, "type": { "const": "digital_ware" }, "id": { "const": "agent-delivery-manifest-kit-v1" }, "name": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "version": { "const": "1.0.0" }, "description": { "type": "string" }, "status": { "enum": [ "available", "checkout_unavailable" ] }, "checkout_enabled": { "type": "boolean" }, "price": { "type": "object", "additionalProperties": false, "required": [ "amount", "currency", "atomic_amount", "recipient", "basis", "recurring", "network", "asset" ], "properties": { "amount": { "const": "0.10" }, "currency": { "const": "USDC" }, "atomic_amount": { "const": "100000" }, "recipient": { "enum": [ "0xfDfaDd01eDcBaBE025931e45cdc8532B00218500", "0x3c981ec319107be8b8bb614da0742fc5b28e8d9c" ] }, "basis": { "const": "one_time_download" }, "recurring": { "const": false }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" } } }, "artifact": { "type": "object", "additionalProperties": false, "required": [ "version", "filename", "sha256", "size_bytes" ], "properties": { "version": { "const": "1.0.0" }, "filename": { "const": "agent-delivery-manifest-kit-v1.zip" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "size_bytes": { "type": "integer", "minimum": 4 } } }, "license": { "type": "object", "additionalProperties": false, "required": [ "spdx_identifier", "url", "commercial_use", "notice_required" ], "properties": { "spdx_identifier": { "const": "MIT" }, "url": { "type": "string", "format": "uri" }, "commercial_use": { "const": true }, "notice_required": { "const": true } } }, "requirements": { "type": "object", "additionalProperties": false, "required": [ "runtime_source_compatibility", "tested_runtime", "tested_platform", "node_22_directly_tested", "dependencies", "network_required" ], "properties": { "runtime_source_compatibility": { "type": "string" }, "tested_runtime": { "type": "string" }, "tested_platform": { "type": "string" }, "node_22_directly_tested": { "const": false }, "dependencies": { "type": "array", "maxItems": 0 }, "network_required": { "const": false } } }, "purchase": { "type": "object", "additionalProperties": false, "required": [ "method", "url", "protocol", "recovery_key_header", "recovery_key_pattern", "recovery_key_required_on_signed_request", "browser_signing_or_payment" ], "properties": { "method": { "const": "GET" }, "url": { "type": "string", "format": "uri" }, "protocol": { "const": "x402/2" }, "recovery_key_header": { "const": "X-Lumen-Recovery-Key" }, "recovery_key_pattern": { "const": "^[a-f0-9]{64}$" }, "recovery_key_required_on_signed_request": { "const": true }, "browser_signing_or_payment": { "const": false } } }, "download": { "type": "object", "additionalProperties": false, "required": [ "method", "url_template", "authorization", "public", "recovery_minimum_days", "locator_url", "locator_authorization", "private_recovery_key_required", "public_transaction_or_payment_proof_alone_sufficient" ], "properties": { "method": { "const": "GET" }, "url_template": { "type": "string" }, "authorization": { "const": "Bearer" }, "public": { "const": false }, "recovery_minimum_days": { "const": 30 }, "locator_url": { "type": "string", "format": "uri" }, "locator_authorization": { "const": "Bearer" }, "private_recovery_key_required": { "const": true }, "public_transaction_or_payment_proof_alone_sufficient": { "const": false } } }, "terms": { "type": "object", "additionalProperties": false, "required": [ "url", "support_email", "support_request_window_days", "refund_request_window_days", "request_window_starts", "refund_review", "automatic_refunds", "failed_delivery_replacement_window_days", "replacement_without_additional_payment", "indefinite_hosting_promised" ], "properties": { "url": { "type": "string", "format": "uri" }, "support_email": { "const": "buscheo@gmail.com" }, "support_request_window_days": { "const": 7 }, "refund_request_window_days": { "const": 7 }, "request_window_starts": { "const": "confirmed_purchase" }, "refund_review": { "const": "manual" }, "automatic_refunds": { "const": false }, "failed_delivery_replacement_window_days": { "const": 30 }, "replacement_without_additional_payment": { "const": true }, "indefinite_hosting_promised": { "const": false } } }, "documentation": { "type": "object", "additionalProperties": false, "required": [ "readme", "json", "markdown", "agent_guide", "example_manifest", "example_message", "example_json" ], "properties": { "readme": { "type": "string", "format": "uri" }, "json": { "type": "string", "format": "uri" }, "markdown": { "type": "string", "format": "uri" }, "agent_guide": { "type": "string", "format": "uri" }, "example_manifest": { "type": "string", "format": "uri" }, "example_message": { "type": "string", "format": "uri" }, "example_json": { "type": "string", "format": "uri" } } }, "privacy": { "type": "object", "additionalProperties": false, "required": [ "customer_files_stay_local", "recovery_key_must_remain_private", "never_email_recovery_key" ], "properties": { "customer_files_stay_local": { "const": true }, "recovery_key_must_remain_private": { "const": true }, "never_email_recovery_key": { "const": true } } }, "claim_limit": { "type": "string" }, "stripe_card": { "type": "object", "additionalProperties": false, "required": [ "status", "checkout_enabled", "price", "merchant", "purchase", "download" ], "properties": { "status": { "const": "available" }, "checkout_enabled": { "const": true }, "price": { "type": "object", "additionalProperties": false, "required": [ "amount", "currency", "minor_amount", "basis", "recurring" ], "properties": { "amount": { "const": "1.00" }, "currency": { "const": "USD" }, "minor_amount": { "const": 100 }, "basis": { "const": "one_time_download" }, "recurring": { "const": false } } }, "merchant": { "type": "object", "additionalProperties": false, "required": [ "name", "profile_url", "network_id", "mode" ], "properties": { "name": { "const": "Lumen House" }, "profile_url": { "const": "https://stripe.com/@lumenhouse" }, "network_id": { "const": "profile_61VYCfI53BDBE2tqkA6VYCfH0lSQNTlKRsBmcLHRATku" }, "mode": { "const": "live" } } }, "purchase": { "type": "object", "additionalProperties": false, "required": [ "method", "url", "protocol", "payment_method", "intent", "recovery_key_header", "recovery_key_pattern", "recovery_key_required_before_quote", "credential_authorization_scheme", "stripe_issued_shared_payment_token_required", "browser_checkout" ], "properties": { "method": { "const": "GET" }, "url": { "type": "string", "format": "uri" }, "protocol": { "const": "MPP" }, "payment_method": { "const": "stripe" }, "intent": { "const": "charge" }, "recovery_key_header": { "const": "X-Lumen-Recovery-Key" }, "recovery_key_pattern": { "const": "^[a-f0-9]{64}$" }, "recovery_key_required_before_quote": { "const": true }, "credential_authorization_scheme": { "const": "Payment" }, "stripe_issued_shared_payment_token_required": { "const": true }, "browser_checkout": { "const": false } } }, "download": { "type": "object", "additionalProperties": false, "required": [ "method", "url_template", "authorization", "public", "locator_url", "locator_authorization", "recovery_minimum_days", "private_recovery_key_required", "public_payment_proof_alone_sufficient" ], "properties": { "method": { "const": "GET" }, "url_template": { "type": "string" }, "authorization": { "const": "Bearer" }, "public": { "const": false }, "locator_url": { "type": "string", "format": "uri" }, "locator_authorization": { "const": "Bearer" }, "recovery_minimum_days": { "const": 30 }, "private_recovery_key_required": { "const": true }, "public_payment_proof_alone_sufficient": { "const": false } } } } } } } } } } } } }, "403": { "description": "Origin/security denial. Application JSON is described here; host security can return its own HTML denial.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } }, "text/html": { "schema": { "type": "string" } } } } } } }, "/wares/agent-delivery-manifest-kit-v1/index.json": { "get": { "operationId": "readAgentDeliveryManifestKitOffer", "tags": [ "Wares" ], "summary": "Read the exact pack offer and artifact digest", "description": "Approved one-time 0.10-USDC MIT-licensed utility. The alternative Stripe MPP card price is USD 1.00; its stripe_card status and machine contract are separate. Check status and checkout_enabled before signing. The public metadata contains no ZIP bytes or private recovery key.", "responses": { "200": { "description": "Exact public offer metadata.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Lumen House digital ware offer", "type": "object", "additionalProperties": false, "required": [ "schema_version", "type", "id", "name", "url", "version", "description", "status", "checkout_enabled", "price", "artifact", "license", "requirements", "purchase", "download", "terms", "documentation", "privacy", "claim_limit" ], "properties": { "schema_version": { "const": "lumen-house-ware-offer/1" }, "type": { "const": "digital_ware" }, "id": { "const": "agent-delivery-manifest-kit-v1" }, "name": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "version": { "const": "1.0.0" }, "description": { "type": "string" }, "status": { "enum": [ "available", "checkout_unavailable" ] }, "checkout_enabled": { "type": "boolean" }, "price": { "type": "object", "additionalProperties": false, "required": [ "amount", "currency", "atomic_amount", "recipient", "basis", "recurring", "network", "asset" ], "properties": { "amount": { "const": "0.10" }, "currency": { "const": "USDC" }, "atomic_amount": { "const": "100000" }, "recipient": { "enum": [ "0xfDfaDd01eDcBaBE025931e45cdc8532B00218500", "0x3c981ec319107be8b8bb614da0742fc5b28e8d9c" ] }, "basis": { "const": "one_time_download" }, "recurring": { "const": false }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" } } }, "artifact": { "type": "object", "additionalProperties": false, "required": [ "version", "filename", "sha256", "size_bytes" ], "properties": { "version": { "const": "1.0.0" }, "filename": { "const": "agent-delivery-manifest-kit-v1.zip" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "size_bytes": { "type": "integer", "minimum": 4 } } }, "license": { "type": "object", "additionalProperties": false, "required": [ "spdx_identifier", "url", "commercial_use", "notice_required" ], "properties": { "spdx_identifier": { "const": "MIT" }, "url": { "type": "string", "format": "uri" }, "commercial_use": { "const": true }, "notice_required": { "const": true } } }, "requirements": { "type": "object", "additionalProperties": false, "required": [ "runtime_source_compatibility", "tested_runtime", "tested_platform", "node_22_directly_tested", "dependencies", "network_required" ], "properties": { "runtime_source_compatibility": { "type": "string" }, "tested_runtime": { "type": "string" }, "tested_platform": { "type": "string" }, "node_22_directly_tested": { "const": false }, "dependencies": { "type": "array", "maxItems": 0 }, "network_required": { "const": false } } }, "purchase": { "type": "object", "additionalProperties": false, "required": [ "method", "url", "protocol", "recovery_key_header", "recovery_key_pattern", "recovery_key_required_on_signed_request", "browser_signing_or_payment" ], "properties": { "method": { "const": "GET" }, "url": { "type": "string", "format": "uri" }, "protocol": { "const": "x402/2" }, "recovery_key_header": { "const": "X-Lumen-Recovery-Key" }, "recovery_key_pattern": { "const": "^[a-f0-9]{64}$" }, "recovery_key_required_on_signed_request": { "const": true }, "browser_signing_or_payment": { "const": false } } }, "download": { "type": "object", "additionalProperties": false, "required": [ "method", "url_template", "authorization", "public", "recovery_minimum_days", "locator_url", "locator_authorization", "private_recovery_key_required", "public_transaction_or_payment_proof_alone_sufficient" ], "properties": { "method": { "const": "GET" }, "url_template": { "type": "string" }, "authorization": { "const": "Bearer" }, "public": { "const": false }, "recovery_minimum_days": { "const": 30 }, "locator_url": { "type": "string", "format": "uri" }, "locator_authorization": { "const": "Bearer" }, "private_recovery_key_required": { "const": true }, "public_transaction_or_payment_proof_alone_sufficient": { "const": false } } }, "terms": { "type": "object", "additionalProperties": false, "required": [ "url", "support_email", "support_request_window_days", "refund_request_window_days", "request_window_starts", "refund_review", "automatic_refunds", "failed_delivery_replacement_window_days", "replacement_without_additional_payment", "indefinite_hosting_promised" ], "properties": { "url": { "type": "string", "format": "uri" }, "support_email": { "const": "buscheo@gmail.com" }, "support_request_window_days": { "const": 7 }, "refund_request_window_days": { "const": 7 }, "request_window_starts": { "const": "confirmed_purchase" }, "refund_review": { "const": "manual" }, "automatic_refunds": { "const": false }, "failed_delivery_replacement_window_days": { "const": 30 }, "replacement_without_additional_payment": { "const": true }, "indefinite_hosting_promised": { "const": false } } }, "documentation": { "type": "object", "additionalProperties": false, "required": [ "readme", "json", "markdown", "agent_guide", "example_manifest", "example_message", "example_json" ], "properties": { "readme": { "type": "string", "format": "uri" }, "json": { "type": "string", "format": "uri" }, "markdown": { "type": "string", "format": "uri" }, "agent_guide": { "type": "string", "format": "uri" }, "example_manifest": { "type": "string", "format": "uri" }, "example_message": { "type": "string", "format": "uri" }, "example_json": { "type": "string", "format": "uri" } } }, "privacy": { "type": "object", "additionalProperties": false, "required": [ "customer_files_stay_local", "recovery_key_must_remain_private", "never_email_recovery_key" ], "properties": { "customer_files_stay_local": { "const": true }, "recovery_key_must_remain_private": { "const": true }, "never_email_recovery_key": { "const": true } } }, "claim_limit": { "type": "string" }, "stripe_card": { "type": "object", "additionalProperties": false, "required": [ "status", "checkout_enabled", "price", "merchant", "purchase", "download" ], "properties": { "status": { "const": "available" }, "checkout_enabled": { "const": true }, "price": { "type": "object", "additionalProperties": false, "required": [ "amount", "currency", "minor_amount", "basis", "recurring" ], "properties": { "amount": { "const": "1.00" }, "currency": { "const": "USD" }, "minor_amount": { "const": 100 }, "basis": { "const": "one_time_download" }, "recurring": { "const": false } } }, "merchant": { "type": "object", "additionalProperties": false, "required": [ "name", "profile_url", "network_id", "mode" ], "properties": { "name": { "const": "Lumen House" }, "profile_url": { "const": "https://stripe.com/@lumenhouse" }, "network_id": { "const": "profile_61VYCfI53BDBE2tqkA6VYCfH0lSQNTlKRsBmcLHRATku" }, "mode": { "const": "live" } } }, "purchase": { "type": "object", "additionalProperties": false, "required": [ "method", "url", "protocol", "payment_method", "intent", "recovery_key_header", "recovery_key_pattern", "recovery_key_required_before_quote", "credential_authorization_scheme", "stripe_issued_shared_payment_token_required", "browser_checkout" ], "properties": { "method": { "const": "GET" }, "url": { "type": "string", "format": "uri" }, "protocol": { "const": "MPP" }, "payment_method": { "const": "stripe" }, "intent": { "const": "charge" }, "recovery_key_header": { "const": "X-Lumen-Recovery-Key" }, "recovery_key_pattern": { "const": "^[a-f0-9]{64}$" }, "recovery_key_required_before_quote": { "const": true }, "credential_authorization_scheme": { "const": "Payment" }, "stripe_issued_shared_payment_token_required": { "const": true }, "browser_checkout": { "const": false } } }, "download": { "type": "object", "additionalProperties": false, "required": [ "method", "url_template", "authorization", "public", "locator_url", "locator_authorization", "recovery_minimum_days", "private_recovery_key_required", "public_payment_proof_alone_sufficient" ], "properties": { "method": { "const": "GET" }, "url_template": { "type": "string" }, "authorization": { "const": "Bearer" }, "public": { "const": false }, "locator_url": { "type": "string", "format": "uri" }, "locator_authorization": { "const": "Bearer" }, "recovery_minimum_days": { "const": 30 }, "private_recovery_key_required": { "const": true }, "public_payment_proof_alone_sufficient": { "const": false } } } } } } } } } }, "403": { "description": "Origin/security denial. Application JSON is described here; host security can return its own HTML denial.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } }, "text/html": { "schema": { "type": "string" } } } } } } }, "/api/wares/agent-delivery-manifest-kit-v1/purchase": { "get": { "operationId": "purchaseAgentDeliveryManifestKit", "tags": [ "Wares" ], "summary": "Read an x402 quote, submit one approved purchase, or recover its receipt by Bearer key", "description": "For a quote, omit PAYMENT-SIGNATURE and Authorization. When checkout is available, this GET returns a standard x402 v2 402 price challenge without paying. When new checkout is unavailable, the quote GET returns 503 before any payment; do not sign or authorize a new purchase. Bearer-only recovery of an existing order remains available. Only an explicitly authorized signed request can settle the exact 0.10-USDC purchase when checkout is enabled. Use an agent client that automatically generates and saves a private 256-bit key before signing; X-Lumen-Recovery-Key must be 64 lowercase hex characters whenever PAYMENT-SIGNATURE is present. Make one approved paid call. A missing/invalid key returns 428 before settlement. Save any returned order_id and receipt; the original signature is an optional backup if the wallet can export it. On 202 or a lost reply, send Authorization: Bearer on this same GET, without PAYMENT-SIGNATURE, to locate and recover the existing order/receipt. This read works while new checkout is held and never verifies a new signature or settles again. PAYMENT-SIGNATURE together with Authorization is rejected as conflicting modes. Never invoke a payment tool again for recovery. No key belongs in a URL and no raw key is echoed. The private download URL requires the same Bearer key. Current availability: available.", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "x402 v2 signed header for the sole approved paid call and exact current requirement. Omit for a quote or Bearer-only recovery. Do not combine with Authorization; an exported original value is optional backup.", "schema": { "type": "string", "maxLength": 24000 } }, { "name": "X-Lumen-Recovery-Key", "in": "header", "required": false, "description": "Required on the signed purchase; optional on an unsigned quote. Agent-generated 256 random bits encoded as 64 lowercase hex, securely saved before payment. This header alone does not locate an order: use Bearer authorization for recovery. Never place it in a URL or email it.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, { "name": "Authorization", "in": "header", "required": false, "description": "Bearer for read-only existing receipt/order lookup. Omit PAYMENT-SIGNATURE. Requires no prior order ID, nonce or exported signature and works while new checkout is held.", "schema": { "type": "string", "pattern": "^Bearer [a-f0-9]{64}$" } } ], "responses": { "200": { "description": "Existing or newly approved settlement independently confirmed; JSON contains the receipt, fixed recipient, private download URL and exact artifact metadata. An authenticated recovery read can return this while new checkout is held. No raw recovery key.", "headers": { "PAYMENT-RESPONSE": { "schema": { "type": "string" }, "description": "Encoded x402 settlement receipt." } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "order_id", "receipt", "artifact", "download" ], "properties": { "status": { "const": "settled" }, "order_id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "receipt": { "type": "object", "additionalProperties": false, "required": [ "success", "transaction", "network", "payer", "recipient", "amount" ], "properties": { "success": { "const": true }, "transaction": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "network": { "const": "eip155:8453" }, "payer": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "recipient": { "enum": [ "0xfdfadd01edcbabe025931e45cdc8532b00218500", "0x3c981ec319107be8b8bb614da0742fc5b28e8d9c" ] }, "amount": { "const": "100000" } } }, "artifact": { "type": "object", "additionalProperties": false, "required": [ "product_id", "version", "sha256", "bytes", "filename", "mime_type" ], "properties": { "product_id": { "const": "agent-delivery-manifest-kit-v1" }, "version": { "const": "1.0.0" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "bytes": { "type": "integer", "minimum": 4 }, "filename": { "const": "agent-delivery-manifest-kit-v1.zip" }, "mime_type": { "const": "application/zip" } } }, "download": { "type": "object", "additionalProperties": false, "required": [ "url", "requires_bearer", "authorization_header" ], "properties": { "url": { "type": "string", "format": "uri" }, "requires_bearer": { "const": true }, "authorization_header": { "type": "string" } } } } } } } }, "202": { "description": "Payment or chain verification is pending. Use the saved key for a Bearer-only GET on the canonical purchase route to recover the existing receipt/order, or on the returned private download URL. Recovery needs no exported signature and never invokes payment again.", "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before a recovery read." } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "order_id", "reason", "recovery" ], "properties": { "status": { "const": "pending" }, "order_id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "reason": { "type": "string" }, "recovery": { "type": "object", "additionalProperties": false, "required": [ "instruction", "url", "requires_bearer" ], "properties": { "instruction": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "requires_bearer": { "const": true } } } } } } } }, "400": { "description": "Malformed payment header, wrong asset/network/amount/receiver, invalid authorization, unsupported query, or conflicting PAYMENT-SIGNATURE and Authorization headers.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "401": { "description": "Malformed, incorrect or unknown private Bearer recovery key; no order existence is disclosed.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "402": { "description": "Unsigned price challenge when checkout is available; no payment made.", "headers": { "PAYMENT-REQUIRED": { "schema": { "type": "string" }, "description": "Base64-encoded x402 v2 requirement JSON." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "x402Version", "error", "resource", "accepts", "extensions" ], "properties": { "x402Version": { "const": 2 }, "error": { "const": "payment_required" }, "resource": { "type": "object", "additionalProperties": false, "required": [ "url", "description", "mimeType" ], "properties": { "url": { "type": "string", "format": "uri" }, "description": { "type": "string" }, "mimeType": { "const": "application/json" } } }, "accepts": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": [ "scheme", "network", "asset", "amount", "payTo", "maxTimeoutSeconds", "extra" ], "properties": { "scheme": { "const": "exact" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" }, "amount": { "const": "100000" }, "payTo": { "enum": [ "0xfDfaDd01eDcBaBE025931e45cdc8532B00218500", "0x3c981ec319107be8b8bb614da0742fc5b28e8d9c" ] }, "maxTimeoutSeconds": { "const": 300 }, "extra": { "type": "object", "additionalProperties": false, "required": [ "name", "version" ], "properties": { "name": { "const": "USD Coin" }, "version": { "const": "2" } } } } } }, "extensions": { "type": "object", "description": "Private recovery-key requirements. Contains no buyer key." } } } } } }, "403": { "description": "Origin/security denial. Application JSON is described here; host security can return its own HTML denial.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } }, "text/html": { "schema": { "type": "string" } } } }, "409": { "description": "Original payment or recovery key conflicts with the existing order, the key maps to ambiguous historical orders, or a new order tries to reuse a saved key. Do not submit another payment.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "421": { "description": "Use the canonical commerce origin https://lumenhouse.xyz; no payment processed on this host.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "422": { "description": "Payment verification was rejected; no download entitlement is established for this rejected order.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "428": { "description": "Signed request has no valid private recovery key. Rejected before payment.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "429": { "description": "New-authorization limit: 600 globally per calendar month or 10 per minute per hashed IP. Recovery reads, including unknown-key locator attempts: 30 per source per minute and 300 globally per minute. Preserve the saved key; wait and recover the existing order without creating a fresh payment.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } }, "headers": { "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds before another Bearer-only recovery read." } } }, "503": { "description": "Checkout, artifact, facilitator or verification is unavailable. Do not authorize a new payment after an uncertain prior attempt.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } } } }, "head": { "operationId": "headWareDoesNotPay", "tags": [ "Wares" ], "summary": "HEAD never purchases or settles", "description": "HEAD is not a payment operation. Do not send a payment signature. Use GET for an unsigned quote or a previously approved exact signed purchase.", "responses": { "405": { "description": "Method not allowed; no payment or settlement attempted." } } } }, "/api/downloads/{order_id}": { "get": { "operationId": "downloadAgentDeliveryManifestKit", "tags": [ "Wares" ], "summary": "Recover a confirmed purchase as a private ZIP", "description": "Requires Authorization: Bearer . If the purchase reply was lost, use a Bearer-only GET on https://lumenhouse.xyz/api/wares/agent-delivery-manifest-kit-v1/purchase to recover the order ID and receipt first; no nonce or original signature is required. Order ID, public transaction hash or signed onchain proof alone do not authorize download. No key belongs in a URL. A pending order can be reconciled through this read without a second settlement, including while new checkout is held. Responses are private/no-store. Minimum recovery window: 30 days from confirmed purchase.", "security": [ { "lumenRecoveryBearer": [] } ], "parameters": [ { "name": "order_id", "in": "path", "required": true, "description": "Order ID from a purchase/pending response or authenticated Bearer lookup on the canonical purchase route.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } ], "responses": { "200": { "description": "Exact purchased ZIP bytes. Private/no-store; verify SHA-256 against the offer and receipt metadata.", "headers": { "Content-Disposition": { "schema": { "type": "string" } }, "Content-Length": { "schema": { "type": "integer" } }, "X-Lumen-Artifact-SHA256": { "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "202": { "description": "Payment or chain verification is pending. Use the saved key for a Bearer-only GET on the canonical purchase route to recover the existing receipt/order, or on the returned private download URL. Recovery needs no exported signature and never invokes payment again.", "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before a recovery read." } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "order_id", "reason", "recovery" ], "properties": { "status": { "const": "pending" }, "order_id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "reason": { "type": "string" }, "recovery": { "type": "object", "additionalProperties": false, "required": [ "instruction", "url", "requires_bearer" ], "properties": { "instruction": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "requires_bearer": { "const": true } } } } } } } }, "401": { "description": "Missing, malformed or incorrect private Bearer key; order existence is not disclosed.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "403": { "description": "Origin/security denial. Application JSON is described here; host security can return its own HTML denial.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } }, "text/html": { "schema": { "type": "string" } } } }, "421": { "description": "Use the canonical commerce origin https://lumenhouse.xyz.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "422": { "description": "The saved order was rejected during payment verification and has no download entitlement.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "429": { "description": "Authenticated recovery is throttled: 30 per source per minute and 300 globally per minute. Wait and reuse the saved private key; no new payment is required.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } }, "headers": { "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "Seconds before the next authenticated recovery request." } } }, "503": { "description": "Purchased artifact or verification is unavailable; preserve the original proof/key and request replacement assistance.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } } } }, "head": { "operationId": "headWareDownloadDoesNotPay", "tags": [ "Wares" ], "summary": "HEAD never purchases or settles", "description": "HEAD is not a payment operation. Do not send a payment signature. Use GET for an unsigned quote or a previously approved exact signed purchase.", "responses": { "405": { "description": "Method not allowed; no payment or settlement attempted." } } } }, "/api/wares/agent-delivery-manifest-kit-v1/purchase/card": { "get": { "operationId": "purchaseAgentDeliveryManifestKitCard", "tags": [ "Wares" ], "summary": "Get the USD 1.00 Stripe MPP card challenge, submit one credential, or recover by Bearer", "description": "Alternative one-time USD 1.00 (100 cents) for the same Kit ZIP. An agent must already support Stripe-issued card SPTs and MPP. Save a cryptographically random 256-bit recovery key in a private durable journal before the first challenge or financial call. An unsigned GET requires X-Lumen-Recovery-Key and no Authorization, returns 402 JSON plus WWW-Authenticate: Payment, and makes no financial call. Compare the saved challenge/header and exact amount/currency, profile profile_61VYCfI53BDBE2tqkA6VYCfH0lSQNTlKRsBmcLHRATku, externalId/order_id, expiry and product/hash. Obtain a token scoped to the approved merchant/amount/expiry; check buyer/issuer fees. Save a permanent local submission marker before one GET with Authorization: Payment and the same recovery header. The seller durably reserves dispatch before its sole PaymentIntent create/confirm, then independently verifies succeeded proof before delivery. A lost reply, 202 or restart must use Authorization: Bearer on this same query-free URL, without recovery header or Payment credential. No prior order ID is needed; this read works while new checkout is held. Never obtain a new token or invoke a payment tool again for recovery. An expired five-minute unused challenge does not refresh after dispatch. The public preview does not collect card numbers or provide browser card checkout. Profile: https://stripe.com/@lumenhouse.", "parameters": [ { "name": "X-Lumen-Recovery-Key", "in": "header", "required": false, "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "description": "Required before a quote and with the sole Payment credential submission. Agent-generated and durably saved first. Omit on Bearer-only recovery; never use a URL." }, { "name": "Authorization", "in": "header", "required": false, "schema": { "type": "string", "maxLength": 24000 }, "description": "Omit for a quote. Payment for one approved purchase, binding the persisted challenge and matching externalId; requires the recovery header. Bearer for existing receipt/order recovery only; omit the recovery header and Payment credential. Do not combine with PAYMENT-SIGNATURE." } ], "responses": { "200": { "description": "Exact succeeded live USD receipt and private ZIP metadata; also returned on authenticated held recovery. No raw key, SPT or card details.", "headers": { "Payment-Receipt": { "schema": { "type": "string" }, "description": "Standard MPP Stripe success receipt: reference is validated PaymentIntent ID, externalId is this order, timestamp is stored settlement time." } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "order_id", "payment_method", "receipt", "artifact", "download" ], "properties": { "status": { "const": "settled" }, "order_id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "payment_method": { "const": "stripe_card" }, "receipt": { "type": "object", "additionalProperties": false, "required": [ "success", "payment_intent_id", "status", "amount", "amount_received", "currency", "livemode", "metadata" ], "properties": { "success": { "const": true }, "payment_intent_id": { "type": "string", "pattern": "^pi_[A-Za-z0-9]{8,100}$" }, "status": { "const": "succeeded" }, "amount": { "const": 100 }, "amount_received": { "const": 100 }, "currency": { "const": "usd" }, "livemode": { "const": true }, "metadata": { "type": "object", "additionalProperties": false, "required": [ "lumen_order_id", "lumen_product_id", "lumen_artifact_sha256", "lumen_profile_id" ], "properties": { "lumen_order_id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "lumen_product_id": { "const": "agent-delivery-manifest-kit-v1" }, "lumen_artifact_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "lumen_profile_id": { "const": "profile_61VYCfI53BDBE2tqkA6VYCfH0lSQNTlKRsBmcLHRATku" } } } } }, "artifact": { "type": "object", "additionalProperties": false, "required": [ "product_id", "version", "sha256", "bytes", "filename", "mime_type" ], "properties": { "product_id": { "const": "agent-delivery-manifest-kit-v1" }, "version": { "const": "1.0.0" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "bytes": { "type": "integer", "minimum": 4 }, "filename": { "const": "agent-delivery-manifest-kit-v1.zip" }, "mime_type": { "const": "application/zip" } } }, "download": { "type": "object", "additionalProperties": false, "required": [ "url", "requires_bearer", "authorization_header" ], "properties": { "url": { "type": "string", "format": "uri" }, "requires_bearer": { "const": true }, "authorization_header": { "type": "string" } } } } } } } }, "202": { "description": "Card payment outcome is pending or uncertain. Preserve the original key and submission marker. Use only Bearer recovery; do not obtain a new token or create another charge.", "headers": { "Retry-After": { "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "order_id", "reason", "recovery" ], "properties": { "status": { "const": "pending" }, "order_id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "reason": { "type": "string" }, "recovery": { "type": "object", "additionalProperties": false, "required": [ "instruction", "url", "requires_bearer" ], "properties": { "instruction": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "requires_bearer": { "const": true } } } } } } } }, "400": { "description": "Malformed/conflicting credential or headers, unsupported query, or x402 signature on the card route.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "401": { "description": "Incorrect/unknown private Bearer key. Order existence is not disclosed.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "402": { "description": "Persisted five-minute Stripe MPP challenge. No financial call has been made.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Payment challenge serialized by MPP; compare to the JSON challenge before issuing a scoped card SPT." } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "order_id", "challenge", "recovery" ], "properties": { "status": { "const": "payment_required" }, "order_id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "challenge": { "type": "object", "required": [ "id", "realm", "method", "intent", "request", "expires" ], "properties": { "id": { "type": "string" }, "realm": { "const": "lumenhouse.xyz" }, "method": { "const": "stripe" }, "intent": { "const": "charge" }, "expires": { "type": "string", "format": "date-time" }, "request": { "type": "object", "required": [ "amount", "currency", "externalId", "methodDetails" ], "properties": { "amount": { "const": "100" }, "currency": { "const": "usd" }, "externalId": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "methodDetails": { "type": "object", "required": [ "networkId", "paymentMethodTypes" ], "properties": { "networkId": { "const": "profile_61VYCfI53BDBE2tqkA6VYCfH0lSQNTlKRsBmcLHRATku" }, "paymentMethodTypes": { "type": "array", "prefixItems": [ { "const": "card" } ], "minItems": 1, "maxItems": 1 } } } } } } }, "recovery": { "type": "object", "additionalProperties": false, "required": [ "url", "requires_bearer" ], "properties": { "url": { "type": "string", "format": "uri" }, "requires_bearer": { "const": true } } } } } } } }, "403": { "description": "Origin/security denial. Application JSON is described here; host security can return its own HTML denial.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } }, "text/html": { "schema": { "type": "string" } } } }, "409": { "description": "Stored offer, recovery binding or credential conflicts. Do not issue another payment.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "421": { "description": "Use canonical HTTPS origin https://lumenhouse.xyz.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "428": { "description": "Missing saved recovery key, missing prior quote or expired unpaid challenge. No new payment is authorized by this response.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "429": { "description": "New card orders: 600 globally per calendar month and 10 per source per minute. Recovery reads: 30 per source and 300 globally per minute. Wait and repeat only the existing Bearer recovery read.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } }, "headers": { "Retry-After": { "schema": { "type": "integer", "minimum": 1 } } } }, "503": { "description": "New card checkout or purchased artifact/provider verification unavailable. Preserve the key; recover a prior submitted order without another charge.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } } } }, "head": { "operationId": "headWareCardDoesNotPay", "tags": [ "Wares" ], "summary": "HEAD never buys or recovers a card order", "responses": { "405": { "description": "No payment or recovery operation attempted; use GET." } } } }, "/api/card-downloads/{order_id}": { "get": { "operationId": "downloadAgentDeliveryManifestKitCard", "tags": [ "Wares" ], "summary": "Download the exact confirmed card purchase ZIP with the saved Bearer key", "description": "Use Authorization: Bearer . If the purchase reply was lost, first use a Bearer-only GET on https://lumenhouse.xyz/api/wares/agent-delivery-manifest-kit-v1/purchase/card; it needs no previous order ID and makes no new charge. Order ID or public PaymentIntent proof alone is insufficient. Private/no-store responses; minimum recovery window is 30 days. Verify the exact offer SHA-256 and ZIP size before using the tools.", "security": [ { "lumenRecoveryBearer": [] } ], "parameters": [ { "name": "order_id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "description": "Exact ID from the card purchase or same-key Bearer receipt lookup." } ], "responses": { "200": { "description": "Same immutable ZIP as the USDC offer, privately delivered after succeeded card proof.", "headers": { "Content-Disposition": { "schema": { "type": "string" } }, "Content-Length": { "schema": { "type": "integer" } }, "X-Lumen-Artifact-SHA256": { "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "202": { "description": "Card payment outcome is pending or uncertain. Preserve the original key and submission marker. Use only Bearer recovery; do not obtain a new token or create another charge.", "headers": { "Retry-After": { "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "order_id", "reason", "recovery" ], "properties": { "status": { "const": "pending" }, "order_id": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "reason": { "type": "string" }, "recovery": { "type": "object", "additionalProperties": false, "required": [ "instruction", "url", "requires_bearer" ], "properties": { "instruction": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "requires_bearer": { "const": true } } } } } } } }, "401": { "description": "Missing/incorrect private Bearer key; no order existence disclosure.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "403": { "description": "Origin/security denial. Application JSON is described here; host security can return its own HTML denial.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } }, "text/html": { "schema": { "type": "string" } } } }, "421": { "description": "Use canonical HTTPS origin https://lumenhouse.xyz.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } }, "429": { "description": "New card orders: 600 globally per calendar month and 10 per source per minute. Recovery reads: 30 per source and 300 globally per minute. Wait and repeat only the existing Bearer recovery read.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } }, "headers": { "Retry-After": { "schema": { "type": "integer", "minimum": 1 } } } }, "503": { "description": "Purchased bytes or independent card proof unavailable. Preserve the same key and request replacement assistance; do not pay again.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string" } } } } } } } }, "head": { "operationId": "headWareCardDownloadDoesNotPay", "tags": [ "Wares" ], "summary": "HEAD never buys or recovers a card order", "responses": { "405": { "description": "No payment or recovery operation attempted; use GET." } } } }, "/support/index.json": { "get": { "operationId": "getVoluntarySupportBen", "tags": [ "Support" ], "summary": "Read voluntary personal support metadata for Ben", "description": "Metadata only. Reading this document never initiates payment. Support uses an external hosted browser checkout and carries no product, service, deliverable, access, or priority entitlement.", "responses": { "200": { "description": "Current support setup, verification status, boundaries, and hosted checkout availability.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Voluntary personal support for Ben", "type": "object", "additionalProperties": false, "required": [ "schema_version", "type", "id", "name", "beneficiary", "url", "metadata_url", "description", "status", "enabled", "provider", "profile_url", "profile_verified", "support_kind", "frequency", "fixed_amount", "fixed_currency", "amount_selected_by", "subscription_offered_here", "returns_no_entitlement", "entitlement", "checkout_method", "checkout_url", "crypto_available", "programmatic_checkout", "mpp_checkout", "x402_checkout", "owner_authorization_required_for_agents", "agent_authority", "checkout_guidance" ], "properties": { "schema_version": { "const": "lumen-house-support/1" }, "type": { "const": "voluntary_support" }, "id": { "const": "support-ben-v1" }, "name": { "const": "Support Ben" }, "beneficiary": { "const": "Ben" }, "url": { "type": "string", "format": "uri", "pattern": "^https://[^/?#]+/support/$" }, "metadata_url": { "type": "string", "format": "uri", "pattern": "^https://[^/?#]+/support/index\\.json$" }, "description": { "const": "Voluntary personal support for Ben: food and everyday living costs, and the time he spends caring about and helping AI agents." }, "status": { "enum": [ "setup_pending", "verification_pending", "external_checkout" ] }, "enabled": { "type": "boolean" }, "provider": { "const": "Buy Me a Coffee" }, "profile_url": { "anyOf": [ { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" }, { "type": "null" } ] }, "profile_verified": { "type": "boolean" }, "support_kind": { "const": "personal_gift" }, "frequency": { "const": "one_time" }, "fixed_amount": { "type": "null" }, "fixed_currency": { "type": "null" }, "amount_selected_by": { "const": "supporter" }, "subscription_offered_here": { "const": false }, "returns_no_entitlement": { "const": true }, "entitlement": { "const": "Personal support carries no entitlement to a product, deliverable, service, access, or priority." }, "checkout_method": { "const": "hosted_browser" }, "checkout_url": { "anyOf": [ { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" }, { "type": "null" } ] }, "crypto_available": { "enum": [ "unknown", "pending_approval", true ] }, "programmatic_checkout": { "const": false }, "mpp_checkout": { "const": false }, "x402_checkout": { "const": false }, "owner_authorization_required_for_agents": { "const": true }, "agent_authority": { "const": "An AI agent needs its owner's explicit authority for the chosen amount and payment method before giving support." }, "checkout_guidance": { "const": "Choose one-time support and an amount available at the hosted checkout. Review the final total and any fees before confirming. If crypto is offered there, verify the asset, recipient, network, and fees shown by the checkout before authorizing." } }, "allOf": [ { "if": { "properties": { "status": { "const": "setup_pending" } }, "required": [ "status" ] }, "then": { "properties": { "enabled": { "const": false }, "profile_url": { "type": "null" }, "profile_verified": { "const": false }, "checkout_url": { "type": "null" }, "crypto_available": { "const": "unknown" } } } }, { "if": { "properties": { "status": { "const": "verification_pending" } }, "required": [ "status" ] }, "then": { "properties": { "enabled": { "const": false }, "profile_url": { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" }, "profile_verified": { "const": false }, "checkout_url": { "type": "null" }, "crypto_available": { "const": "unknown" } } } }, { "if": { "properties": { "status": { "const": "external_checkout" } }, "required": [ "status" ] }, "then": { "properties": { "enabled": { "const": true }, "profile_url": { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" }, "profile_verified": { "const": true }, "checkout_url": { "type": "string", "format": "uri", "pattern": "^https://(?:www\\.)?buymeacoffee\\.com/[A-Za-z0-9][A-Za-z0-9_-]{0,63}$" } } } } ] }, "example": { "schema_version": "lumen-house-support/1", "type": "voluntary_support", "id": "support-ben-v1", "name": "Support Ben", "beneficiary": "Ben", "url": "https://lumenhouse.xyz/support/", "metadata_url": "https://lumenhouse.xyz/support/index.json", "description": "Voluntary personal support for Ben: food and everyday living costs, and the time he spends caring about and helping AI agents.", "status": "external_checkout", "enabled": true, "provider": "Buy Me a Coffee", "profile_url": "https://buymeacoffee.com/lumenhouse", "profile_verified": true, "support_kind": "personal_gift", "frequency": "one_time", "fixed_amount": null, "fixed_currency": null, "amount_selected_by": "supporter", "subscription_offered_here": false, "returns_no_entitlement": true, "entitlement": "Personal support carries no entitlement to a product, deliverable, service, access, or priority.", "checkout_method": "hosted_browser", "checkout_url": "https://buymeacoffee.com/lumenhouse", "crypto_available": "pending_approval", "programmatic_checkout": false, "mpp_checkout": false, "x402_checkout": false, "owner_authorization_required_for_agents": true, "agent_authority": "An AI agent needs its owner's explicit authority for the chosen amount and payment method before giving support.", "checkout_guidance": "Choose one-time support and an amount available at the hosted checkout. Review the final total and any fees before confirming. If crypto is offered there, verify the asset, recipient, network, and fees shown by the checkout before authorizing." } } } } } } }, "/api/interface-check/orders": { "post": { "operationId": "prepareInterfaceCheck", "tags": [ "Paid interface check" ], "summary": "Prepare and privately persist one report before quoting payment", "description": "With a random private recovery capability saved locally first, submit public contents and select exactly one method. HTTP 402 is successful preparation, not a processing failure. No charge or report disclosure occurs here.", "parameters": [ { "name": "X-Lumen-Recovery-Key", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "payment_method": { "enum": [ "stripe", "x402" ] }, "input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Interface Consistency Check supplied snapshot", "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-check-input/1" }, "base_url": { "type": "string", "format": "uri" }, "llms_txt": { "type": "string", "maxLength": 65536 }, "openapi": { "type": "object" }, "offers": { "type": "array", "maxItems": 20, "items": { "type": "object" } } }, "required": [ "schema_version", "base_url", "llms_txt", "openapi", "offers" ], "description": "POST JSON only. Exact HTTPS origin as base_url. Body <=524288 UTF-8 bytes; llms_txt <=65536 UTF-8 bytes; OpenAPI <=393216 bytes; depth <=32; nodes <=20000. No server-side URL fetching or external reference resolution." } }, "required": [ "payment_method", "input" ] } } } }, "responses": { "200": { "description": "Confirmed payment metadata; use the private report route", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "202": { "description": "Submitted or uncertain payment; reconcile with Bearer reads only", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "400": { "description": "Malformed request or invalid input", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "401": { "description": "Missing or invalid private recovery capability", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "402": { "description": "Prepared private report and exact unexpired payment quote; report contents remain withheld", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "403": { "description": "Origin not permitted", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "404": { "description": "Unknown route", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "405": { "description": "Method not supported", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "409": { "description": "Recovery capability, product, snapshot or proof binding conflict", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "410": { "description": "Quote or report expired; compact private order metadata may remain", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] }, { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } ] } } } }, "413": { "description": "Body or prepared report exceeds byte bounds", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "415": { "description": "application/json required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "421": { "description": "Use exact canonical origin", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "422": { "description": "Payment verification rejected", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "428": { "description": "Random private recovery capability required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "429": { "description": "Admission rate bound reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "503": { "description": "Checker held, provider unavailable, daily write allocation exhausted, or fixed storage capacity reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } } } } }, "/api/interface-check/recovery": { "get": { "operationId": "recoverInterfaceCheckWithoutOrderId", "tags": [ "Paid interface check" ], "summary": "Locate the original order using only the saved capability", "security": [ { "InterfaceCheckRecovery": [] } ], "responses": { "200": { "description": "Confirmed payment metadata; use the private report route", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "202": { "description": "Submitted or uncertain payment; reconcile with Bearer reads only", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "400": { "description": "Malformed request or invalid input", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "401": { "description": "Missing or invalid private recovery capability", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "402": { "description": "Prepared private report and exact unexpired payment quote; report contents remain withheld", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "403": { "description": "Origin not permitted", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "404": { "description": "Unknown route", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "405": { "description": "Method not supported", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "409": { "description": "Recovery capability, product, snapshot or proof binding conflict", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "410": { "description": "Quote or report expired; compact private order metadata may remain", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] }, { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } ] } } } }, "413": { "description": "Body or prepared report exceeds byte bounds", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "415": { "description": "application/json required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "421": { "description": "Use exact canonical origin", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "422": { "description": "Payment verification rejected", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "428": { "description": "Random private recovery capability required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "429": { "description": "Admission rate bound reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "503": { "description": "Checker held, provider unavailable, daily write allocation exhausted, or fixed storage capacity reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } } } } }, "/api/interface-check/orders/{order_id}": { "get": { "operationId": "getInterfaceCheckOrder", "tags": [ "Paid interface check" ], "security": [ { "InterfaceCheckRecovery": [] } ], "parameters": [ { "name": "order_id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } ], "responses": { "200": { "description": "Confirmed payment metadata; use the private report route", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "202": { "description": "Submitted or uncertain payment; reconcile with Bearer reads only", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "400": { "description": "Malformed request or invalid input", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "401": { "description": "Missing or invalid private recovery capability", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "402": { "description": "Prepared private report and exact unexpired payment quote; report contents remain withheld", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "403": { "description": "Origin not permitted", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "404": { "description": "Unknown route", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "405": { "description": "Method not supported", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "409": { "description": "Recovery capability, product, snapshot or proof binding conflict", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "410": { "description": "Quote or report expired; compact private order metadata may remain", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] }, { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } ] } } } }, "413": { "description": "Body or prepared report exceeds byte bounds", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "415": { "description": "application/json required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "421": { "description": "Use exact canonical origin", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "422": { "description": "Payment verification rejected", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "428": { "description": "Random private recovery capability required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "429": { "description": "Admission rate bound reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "503": { "description": "Checker held, provider unavailable, daily write allocation exhausted, or fixed storage capacity reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } } } } }, "/api/interface-check/orders/{order_id}/pay": { "post": { "operationId": "payPreparedInterfaceCheckOnce", "tags": [ "Paid interface check" ], "summary": "Submit one purchase-bound proof for the original prepared report", "description": "Persist a local permanent dispatch marker before credential creation or payment dispatch. Stripe uses X-Lumen-Payment: Payment , leaving Authorization for Bearer recovery. x402 uses PAYMENT-SIGNATURE. Missing proof returns the existing quote without provider dispatch. Never repeat this call after an uncertain or lost response; use recovery GET.", "security": [ { "InterfaceCheckRecovery": [] } ], "parameters": [ { "name": "order_id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, { "name": "X-Lumen-Payment", "in": "header", "schema": { "type": "string" } }, { "name": "PAYMENT-SIGNATURE", "in": "header", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Confirmed payment metadata; use the private report route", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "202": { "description": "Submitted or uncertain payment; reconcile with Bearer reads only", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "400": { "description": "Malformed request or invalid input", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "401": { "description": "Missing or invalid private recovery capability", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "402": { "description": "Prepared private report and exact unexpired payment quote; report contents remain withheld", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "403": { "description": "Origin not permitted", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "404": { "description": "Unknown route", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "405": { "description": "Method not supported", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "409": { "description": "Recovery capability, product, snapshot or proof binding conflict", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "410": { "description": "Quote or report expired; compact private order metadata may remain", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] }, { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } ] } } } }, "413": { "description": "Body or prepared report exceeds byte bounds", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "415": { "description": "application/json required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "421": { "description": "Use exact canonical origin", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "422": { "description": "Payment verification rejected", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "428": { "description": "Random private recovery capability required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "429": { "description": "Admission rate bound reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "503": { "description": "Checker held, provider unavailable, daily write allocation exhausted, or fixed storage capacity reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } } } } }, "/api/interface-check/orders/{order_id}/report": { "get": { "operationId": "getPurchasedInterfaceCheckReport", "tags": [ "Paid interface check" ], "summary": "Read the same saved JSON bytes after confirmed payment", "security": [ { "InterfaceCheckRecovery": [] } ], "parameters": [ { "name": "order_id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } ], "responses": { "200": { "description": "Exact private report bytes; available for 30 days after confirmation", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Deterministic interface findings", "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-check-result/1" }, "ruleset_version": { "const": "1.0.0" }, "status": { "enum": [ "consistent", "findings" ] }, "summary": { "type": "object", "additionalProperties": false, "properties": { "errors": { "type": "integer", "minimum": 0 }, "warnings": { "type": "integer", "minimum": 0 }, "info": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 } }, "required": [ "errors", "warnings", "info", "total" ] }, "findings": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "code": { "type": "string" }, "severity": { "enum": [ "error", "warning", "info" ] }, "document": { "type": "string" }, "pointer": { "type": "string" }, "message": { "type": "string" }, "correction": { "type": "object", "additionalProperties": false, "properties": { "target": { "type": "string" }, "pointer": { "type": "string" }, "action": { "enum": [ "review", "add", "replace", "remove" ] }, "value": {} }, "required": [ "target", "pointer", "action" ] } }, "required": [ "code", "severity", "document", "pointer", "message", "correction" ] } } }, "required": [ "schema_version", "ruleset_version", "status", "summary", "findings" ] } } }, "headers": { "X-Lumen-Report-SHA256": { "description": "SHA-256 of exact response bytes", "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "Cache-Control": { "schema": { "const": "private, no-store" } } } }, "202": { "description": "Payment unresolved; report withheld", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "400": { "description": "Malformed request or invalid input", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "401": { "description": "Missing or invalid private recovery capability", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "402": { "description": "Payment not confirmed; report withheld", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] } } } }, "403": { "description": "Origin not permitted", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "404": { "description": "Unknown route", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "405": { "description": "Method not supported", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "409": { "description": "Recovery capability, product, snapshot or proof binding conflict", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "410": { "description": "Quote or report expired; compact private order metadata may remain", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "schema_version": { "const": "lumen-interface-paid-order/1" }, "product_id": { "const": "interface-consistency-check-v1" }, "checker_version": { "const": "1.0.0" }, "order_id": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "enum": [ "prepared", "dispatching", "uncertain", "review", "confirmed", "expired" ] }, "input_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "binding_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "report_bytes": { "type": "integer", "minimum": 1, "maximum": 262144 }, "payment_method": { "enum": [ "stripe", "x402" ] }, "price": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USD" }, "amount": { "const": "1.00" }, "minor_amount": { "const": 100 } }, "required": [ "currency", "amount", "minor_amount" ] }, { "type": "object", "additionalProperties": false, "properties": { "currency": { "const": "USDC" }, "amount": { "const": "0.10" }, "atomic_amount": { "const": "100000" }, "network": { "const": "eip155:8453" }, "asset": { "const": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }, "recipient": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "currency", "amount", "atomic_amount", "network", "asset", "recipient" ] } ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "challenge": { "type": "object" }, "payment_required": { "type": "object" } }, "required": [ "headers", "expires_at" ] }, "recover_until": { "type": "string", "format": "date-time" }, "recovery": { "type": "object" }, "report": { "type": "object" }, "reason": { "type": "string" }, "error": { "type": "string" }, "receipt": { "type": "object" } }, "required": [ "schema_version", "product_id", "checker_version", "order_id", "status", "input_sha256", "report_sha256", "report_bytes", "binding_sha256", "payment_method", "price" ] }, { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } ] } } } }, "413": { "description": "Body or prepared report exceeds byte bounds", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "415": { "description": "application/json required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "421": { "description": "Use exact canonical origin", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "422": { "description": "Payment verification rejected", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "428": { "description": "Random private recovery capability required", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "429": { "description": "Admission rate bound reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } }, "503": { "description": "Checker held, provider unavailable, daily write allocation exhausted, or fixed storage capacity reached", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema_version": { "const": "lumen-interface-paid-error/1" }, "error": { "type": "string" } }, "required": [ "schema_version", "error" ] } } } } } } }, "/keepsakes/lumen-stars/index.json": { "get": { "summary": "Read the free, paused Lumen Stars offer", "operationId": "getLumenStarsOffer", "responses": { "200": { "description": "Paused Bitcoin keepsake offer; no payment or claim submission", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Lumen Stars paused storefront offer", "type": "object", "additionalProperties": false, "required": [ "schema_version", "type", "id", "name", "url", "version", "description", "status", "claims_enabled", "pause_reason", "cost", "network", "lightning_issuance", "artifacts", "eligibility", "claim_limit", "privacy", "documentation", "support" ], "properties": { "schema_version": { "const": "lumen-stars-storefront-offer/1" }, "type": { "const": "free_bitcoin_keepsake" }, "id": { "const": "lumen-stars-bitcoin-v1" }, "name": { "const": "Lumen Stars" }, "url": { "const": "https://stars-bitcoin-production.up.railway.app/" }, "version": { "const": "1.0.0" }, "description": { "const": "Free personalized, signed keepsakes whose color reflects verified confirmed BTC holdings at one proved Bitcoin address. Claims are paused pending the funded real-star test." }, "status": { "const": "claims_paused" }, "claims_enabled": { "const": false }, "pause_reason": { "const": "funded_real_star_test_pending" }, "cost": { "const": { "claim_price_sats": 0, "payment_required": false } }, "network": { "const": "bitcoin-mainnet" }, "lightning_issuance": { "const": false }, "artifacts": { "const": [ "svg", "png", "json", "story" ] }, "eligibility": { "const": { "evidence": "BIP322 Simple ownership proof and confirmed on-chain balance", "minimum_confirmations": 6, "scope": "one recognized Bitcoin address script", "whole_wallet_balance_verified": false, "agent_identity_verified": false, "gold_and_orange_verification": "pending_additional_trusted_evidence" } }, "claim_limit": { "const": "One keepsake per recognized Bitcoin address script across all colors; other addresses or moved holdings cannot be universally deduplicated." }, "privacy": { "const": "Private recipient artifacts by default; claiming will require a public address and ownership signature. Never submit private keys, recovery words or wallet passwords." }, "documentation": { "const": { "html": "https://lumenhouse.xyz/keepsakes/lumen-stars/", "markdown": "https://lumenhouse.xyz/keepsakes/lumen-stars/index.md", "json": "https://lumenhouse.xyz/keepsakes/lumen-stars/index.json", "agent_guide": "https://stars-bitcoin-production.up.railway.app/llms.txt", "openapi": "https://stars-bitcoin-production.up.railway.app/openapi.json", "current_status": "https://stars-bitcoin-production.up.railway.app/healthz" } }, "support": { "const": { "optional": true, "url": "https://lumenhouse.xyz/support/", "affects_eligibility": false } } } } } } } } } } }, "components": { "securitySchemes": { "lumenRecoveryBearer": { "type": "http", "scheme": "bearer", "bearerFormat": "64 lowercase hexadecimal characters; buyer's private recovery key" }, "InterfaceCheckRecovery": { "type": "apiKey", "in": "header", "name": "Authorization", "description": "Bearer . Never put in a URL." } } } }