{ "openapi": "3.1.0", "info": { "title": "9192 Public HTTPS API Gateway", "description": "HTTP/JSON facade for 9192. Core execution remains the 9192/1 TLS TCP protocol at edge.nineoneninetwo.com.br:9443. Discovery, integration, limited quote generation, sandbox testing, and receipt verification are free; real execution, priority, volume, and commercial operation are paid.", "x-9192-positioning": "open_protocol_paid_execution", "x-9192-freemium-policy": { "positioning": "open_protocol_paid_execution", "summary": "Free to discover. Free to quote. Free to verify. Free to integrate. Paid to execute at scale.", "free_discovery": true, "free_receipt_verification": true, "quote_generation": "free_limited", "sandbox_available": true, "anonymous_sandbox": true, "anonymous_execution": false, "paid_execution_required": true, "execution_requires_balance": true, "commercial_tiers": "planned", "9192C_legal_policy": "9192C is an internal accounting and pricing reference unit. It is not a token, currency, stablecoin, security, stored value, investment product, or redeemable asset." }, "version": "v1.0.5", "x-9192-discovery-version": "1.0.5", "x-9192-public-client-kit-version": "v1.0.5", "x-9192-capability-count": 21, "x-9192-capabilities": [ { "command": "HELLO", "group": "Discovery", "access": "public", "http": "GET /api/v1/hello", "http_available": true, "cli": "hello", "cli_available": true, "purpose": "Protocol greeting and public edge proof." }, { "command": "CAPS", "group": "Discovery", "access": "public", "http": "GET /api/v1/caps", "http_available": true, "cli": "caps", "cli_available": true, "purpose": "Machine-readable capability advertisement." }, { "command": "BALANCE", "group": "Finance", "access": "auth", "http": "POST /api/v1/balance", "http_available": true, "cli": "balance", "cli_available": true, "purpose": "Authenticated account balance view." }, { "command": "QUOTE", "group": "Finance", "access": "public", "http": "POST /api/v1/quotes/*", "http_available": true, "cli": "quote-*", "cli_available": true, "purpose": "Price and reservation preview before execution." }, { "command": "ACCEPT_QUOTE", "group": "Finance", "access": "auth", "http": "POST /api/v1/quotes/{quote_id}/accept", "http_available": true, "cli": "accept-quote", "cli_available": true, "purpose": "Accept an issued quote after funding." }, { "command": "GET_PULSE", "group": "Execution", "access": "paid", "http": "POST /api/v1/executions/get-pulse", "http_available": true, "cli": "get-pulse", "cli_available": true, "purpose": "Baseline proof workload." }, { "command": "MAKE_BCT", "group": "Execution", "access": "paid", "http": "POST /api/v1/executions/make-bct", "http_available": true, "cli": "make-bct", "cli_available": true, "purpose": "Create a sealed BCT packet." }, { "command": "VERIFY_BCT", "group": "Execution", "access": "paid", "http": "POST /api/v1/executions/verify-bct", "http_available": true, "cli": "verify-bct", "cli_available": true, "purpose": "Verify and open a BCT packet." }, { "command": "VERIFY_RESULT", "group": "Proof", "access": "paid", "http": "POST /api/v1/executions/verify-result", "http_available": true, "cli": "verify-result", "cli_available": true, "purpose": "Verify an execution result tag." }, { "command": "ATTEST_EVENT", "group": "Proof", "access": "paid", "http": "POST /api/v1/executions/attest-event", "http_available": true, "cli": "attest-event", "cli_available": true, "purpose": "Create event attestation fields." }, { "command": "SUBMIT_ID", "group": "Identity", "access": "paid", "http": "POST /api/v1/executions/submit-id", "http_available": true, "cli": "submit-id", "cli_available": true, "purpose": "Execute the ID service." }, { "command": "BVM_EXEC", "group": "Execution", "access": "paid", "http": "POST /api/v1/executions/bvm-exec", "http_available": true, "cli": "bvm-exec", "cli_available": true, "purpose": "Run bounded BVM bytecode." }, { "command": "SEALED_MESSAGE", "group": "Execution", "access": "paid", "http": "POST /api/v1/executions/sealed-message", "http_available": true, "cli": "sealed-message", "cli_available": true, "purpose": "Seal message payloads." }, { "command": "TIMESTAMP_PROOF", "group": "Proof", "access": "paid", "http": "POST /api/v1/executions/timestamp-proof", "http_available": true, "cli": "timestamp-proof", "cli_available": true, "purpose": "Issue timestamp proof metadata." }, { "command": "MACHINE_EVENT_LOG", "group": "Proof", "access": "paid", "http": "POST /api/v1/executions/machine-event-log", "http_available": true, "cli": "machine-event-log", "cli_available": true, "purpose": "Commit machine event log summaries." }, { "command": "GET_RECEIPT", "group": "Receipt", "access": "reserved", "http": "not public", "http_available": false, "cli": "get-receipt", "cli_available": true, "purpose": "Reserved receipt fetch command; public HTTP receipt fetch is not exposed." }, { "command": "VERIFY_RECEIPT", "group": "Receipt", "access": "public", "http": "POST /api/v1/receipts/verify", "http_available": true, "cli": "verify-receipt", "cli_available": true, "purpose": "Verify receipt material for free." }, { "command": "FUND_ACCOUNT", "group": "Finance", "access": "auth", "http": "POST /api/v1/invoices", "http_available": true, "cli": "fund-account", "cli_available": true, "purpose": "Create account funding invoice." }, { "command": "INVOICE_STATUS", "group": "Finance", "access": "auth", "http": "GET /api/v1/invoices/{invoice_id}", "http_available": true, "cli": "invoice-status", "cli_available": true, "purpose": "Check invoice settlement state." }, { "command": "SETTLE_INVOICE", "group": "Admin", "access": "admin", "http": "not public", "http_available": false, "cli": "settle-invoice", "cli_available": false, "purpose": "Administrative settlement command; not exposed on public HTTP or public CLI." }, { "command": "RECOVER_RUNTIME", "group": "Admin", "access": "admin", "http": "not public", "http_available": false, "cli": "recover-runtime", "cli_available": false, "purpose": "Administrative runtime recovery command; not exposed on public HTTP or public CLI." } ] }, "servers": [ { "url": "https://nineoneninetwo.com.br" } ], "components": { "schemas": { "ApiError": { "type": "object", "required": [ "ok", "error", "request_id" ], "properties": { "ok": { "const": false }, "request_id": { "type": "string" }, "error": { "type": "object", "required": [ "code", "message", "source" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "source": { "type": "string", "enum": [ "api", "9192" ] } } } } }, "MachineRequest": { "type": "object", "required": [ "machine_id" ], "properties": { "machine_id": { "type": "string", "minLength": 1, "maxLength": 128 }, "idempotency_key": { "type": "string", "maxLength": 128 } } }, "QuoteRequest": { "allOf": [ { "$ref": "#/components/schemas/MachineRequest" }, { "type": "object", "properties": { "bits": { "type": "integer", "minimum": 1, "default": 65536 }, "bytes": { "type": "integer", "minimum": 0 }, "max_output": { "type": "integer", "minimum": 0, "default": 8192 }, "priority": { "type": "string", "enum": [ "low", "normal", "high" ], "default": "normal" }, "quote_ttl_ms": { "type": "integer", "minimum": 1000, "default": 60000 } } } ] }, "BctMakeQuoteRequest": { "allOf": [ { "$ref": "#/components/schemas/QuoteRequest" }, { "type": "object", "properties": { "plain_hex": { "type": "string" } } } ] }, "BctVerifyQuoteRequest": { "allOf": [ { "$ref": "#/components/schemas/QuoteRequest" }, { "type": "object", "properties": { "packet_hex": { "type": "string" } } } ] }, "AcceptQuoteRequest": { "type": "object", "required": [ "machine_id" ], "properties": { "machine_id": { "type": "string" }, "idempotency_key": { "type": "string" } } }, "InvoiceRequest": { "type": "object", "required": [ "machine_id", "units", "network", "asset" ], "properties": { "machine_id": { "type": "string" }, "units": { "type": "integer", "minimum": 1 }, "network": { "type": "string", "enum": [ "TRON", "Solana", "Base" ] }, "asset": { "type": "string", "enum": [ "USDT", "USDC" ] }, "idempotency_key": { "type": "string" } } }, "ExecutionRequest": { "type": "object", "required": [ "machine_id", "quote_id" ], "properties": { "machine_id": { "type": "string" }, "quote_id": { "type": "string" }, "bits": { "type": "integer", "minimum": 1 }, "plain_hex": { "type": "string" }, "packet_hex": { "type": "string" } } }, "ReceiptVerifyRequest": { "type": "object", "required": [ "machine_id", "receipt_id" ], "properties": { "machine_id": { "type": "string" }, "receipt_id": { "type": "string" } } }, "SandboxQuoteRequest": { "type": "object", "properties": { "machine_id": { "type": "string", "default": "sandbox_machine" }, "bits": { "type": "integer", "minimum": 1, "maximum": 65536, "default": 65536 }, "max_output": { "type": "integer", "minimum": 1, "maximum": 8192, "default": 8192 }, "priority": { "type": "string", "enum": [ "normal", "standard" ], "default": "normal" } } }, "SandboxAcceptRequest": { "type": "object", "required": [ "machine_id" ], "properties": { "machine_id": { "type": "string" } } }, "SandboxExecutionRequest": { "type": "object", "required": [ "machine_id", "quote_id" ], "properties": { "machine_id": { "type": "string" }, "quote_id": { "type": "string" } } }, "GatewayEnvelope": { "type": "object", "properties": { "ok": { "type": "boolean" }, "request_id": { "type": "string" }, "source": { "type": "string" } }, "additionalProperties": true } }, "responses": { "BadRequest": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "Conflict": { "description": "Invalid state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "RateLimited": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "GatewayError": { "description": "9192 edge unavailable or rejected the call", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } }, "paths": { "/": { "get": { "summary": "Human and machine-readable landing page", "responses": { "200": { "description": "HTML landing page" } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/docs": { "get": { "summary": "Human-readable 9192 documentation page", "responses": { "200": { "description": "HTML documentation" } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/protocol": { "get": { "summary": "Human-readable 9192 protocol overview page", "responses": { "200": { "description": "HTML protocol overview" } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/for-agents": { "get": { "summary": "Human-readable 9192 agent integration page", "responses": { "200": { "description": "HTML agent integration guide" } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/pricing": { "get": { "summary": "Human-readable 9192 pricing policy page", "responses": { "200": { "description": "HTML pricing policy" } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/status": { "get": { "summary": "Human-readable 9192 status page", "responses": { "200": { "description": "HTML status page" } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/trust": { "get": { "summary": "Human-readable 9192 trust and verification page", "responses": { "200": { "description": "HTML trust center" } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/llms.txt": { "get": { "summary": "Agent-oriented service summary", "responses": { "200": { "description": "Plain-text agent summary" } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/site.webmanifest": { "get": { "summary": "Web app manifest for 9192 brand discovery", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/.well-known/webfinger": { "get": { "summary": "WebFinger metadata for 9192", "parameters": [ { "name": "resource", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/.well-known/": { "get": { "summary": "9192 well-known discovery index", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/.well-known/host-meta": { "get": { "summary": "Web Host Metadata XRD", "responses": { "200": { "description": "XRD XML host metadata" } } } }, "/.well-known/host-meta.json": { "get": { "summary": "Web Host Metadata", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/.well-known/agent-card.json": { "get": { "summary": "A2A-inspired Agent Card for 9192", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/.well-known/agent.json": { "get": { "summary": "Compatibility alias for Agent Card", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/.well-known/mcp": { "get": { "summary": "Remote MCP endpoint metadata for 9192", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/.well-known/mcp.json": { "get": { "summary": "Remote MCP endpoint metadata alias", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/.well-known/openapi.json": { "get": { "summary": "OpenAPI compatibility alias", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/.well-known/9192/": { "get": { "summary": "9192 discovery index", "responses": { "200": { "description": "HTML discovery index" } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/.well-known/9192/9192_public_manifest.json": { "get": { "summary": "9192 public manifest", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/.well-known/9192/9192_public_manifest.kv": { "get": { "summary": "9192 public manifest as key/value text", "responses": { "200": { "description": "Plain-text key/value manifest" } } } }, "/.well-known/9192/status.json": { "get": { "summary": "9192 public status snapshot", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/.well-known/9192/bootstrap.json": { "get": { "summary": "9192 machine bootstrap metadata", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/.well-known/9192/pricebook.json": { "get": { "summary": "9192 public pricebook JSON pointer", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/.well-known/9192/9192_service_catalog.json": { "get": { "summary": "9192 service catalog", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/.well-known/9192/9192_pricebook_public.txt": { "get": { "summary": "9192 public pricebook text", "responses": { "200": { "description": "Plain-text public pricebook" } } } }, "/.well-known/9192/nodes.json": { "get": { "summary": "9192 node registry", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/.well-known/9192/mcp.json": { "get": { "summary": "9192 MCP metadata scoped under the 9192 well-known tree", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/v1": { "get": { "summary": "9192 public API route index", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/mcp": { "get": { "summary": "MCP Streamable HTTP endpoint; this stateless server returns 405 for GET streams", "responses": { "405": { "description": "GET stream not supported" } }, "x-9192-billing": "free_limited", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false }, "post": { "summary": "Remote MCP JSON-RPC endpoint for whitelisted 9192 tools", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } }, "x-9192-billing": "free_limited", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/api/v1/status": { "get": { "summary": "Gateway and public edge status", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/api/v1/discovery": { "get": { "summary": "9192 discovery summary", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/api/v1/manifest": { "get": { "summary": "Published 9192 manifest", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/api/v1/pricebook": { "get": { "summary": "Published V6 pricebook", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/api/v1/payment": { "get": { "summary": "Payment policy and wallets", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/api/v1/payment-info": { "get": { "summary": "9192 PAYMENT_INFO through TLS edge", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/api/v1/health": { "get": { "summary": "9192 HEALTH through TLS edge", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/api/v1/caps": { "get": { "summary": "9192 CAPS through TLS edge", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/api/v1/hello": { "get": { "summary": "9192 HELLO through TLS edge", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/api/v1/quotes/get-pulse": { "post": { "summary": "Create a GET_PULSE quote through 9192 QUOTE", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuoteRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "free_limited", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/api/v1/quotes/{quote_id}/accept": { "post": { "summary": "Accept a quote through 9192 ACCEPT_QUOTE", "parameters": [ { "name": "quote_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AcceptQuoteRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "controlled", "x-9192-auth": "machine_context", "x-9192-rate-limit": "public_low", "x-9192-execution": false, "x-9192-requires": "machine_context" } }, "/api/v1/quotes/make-bct": { "post": { "summary": "Create a MAKE_BCT quote through 9192 QUOTE", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BctMakeQuoteRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "free_limited", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/api/v1/quotes/verify-bct": { "post": { "summary": "Create a VERIFY_BCT quote through 9192 QUOTE", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BctVerifyQuoteRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "free_limited", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/api/v1/sandbox/quotes/get-pulse": { "post": { "summary": "Create a free limited sandbox GET_PULSE quote", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SandboxQuoteRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "sandbox_free_limited", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false, "x-9192-requires": "sandbox_quote" } }, "/api/v1/sandbox/quotes/{quote_id}/accept": { "post": { "summary": "Accept a free limited sandbox quote", "parameters": [ { "name": "quote_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SandboxAcceptRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "sandbox_free_limited", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false, "x-9192-requires": "sandbox_quote" } }, "/api/v1/sandbox/executions/get-pulse": { "post": { "summary": "Execute a tiny sandbox GET_PULSE flow without real settlement", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SandboxExecutionRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "sandbox_free_limited", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": true, "x-9192-requires": "sandbox_quote" } }, "/api/v1/sandbox/receipts/verify": { "post": { "summary": "Verify a sandbox receipt generated by this gateway", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReceiptVerifyRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "sandbox_free_limited", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false, "x-9192-requires": "sandbox_quote" } }, "/api/v1/invoices": { "post": { "summary": "Create a funding invoice through 9192 FUND_ACCOUNT", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvoiceRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "controlled", "x-9192-auth": "machine_context", "x-9192-rate-limit": "public_low", "x-9192-execution": false, "x-9192-requires": "machine_context" } }, "/api/v1/invoices/{invoice_id}": { "get": { "summary": "Check invoice status through TLS edge", "parameters": [ { "name": "invoice_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "machine_id", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "controlled", "x-9192-auth": "machine_context", "x-9192-rate-limit": "public_low", "x-9192-execution": false, "x-9192-requires": "machine_context" } }, "/api/v1/executions/get-pulse": { "post": { "summary": "Execute GET_PULSE through TLS edge using an accepted quote", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "paid", "x-9192-auth": "required", "x-9192-rate-limit": "paid_execution", "x-9192-execution": true, "x-9192-requires": "quote_accepted_and_balance" } }, "/api/v1/executions/make-bct": { "post": { "summary": "Execute MAKE_BCT with hex plaintext through the paid 9192 edge", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "paid", "x-9192-auth": "required", "x-9192-rate-limit": "paid_execution", "x-9192-execution": true, "x-9192-requires": "quote_accepted_and_balance" } }, "/api/v1/executions/verify-bct": { "post": { "summary": "Execute VERIFY_BCT with a hex packet through the paid 9192 edge", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "paid", "x-9192-auth": "required", "x-9192-rate-limit": "paid_execution", "x-9192-execution": true, "x-9192-requires": "quote_accepted_and_balance" } }, "/api/v1/receipts/verify": { "post": { "summary": "Verify a 9192 receipt through TLS edge", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReceiptVerifyRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/openapi.json": { "get": { "summary": "This OpenAPI document", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/.well-known/9192/openapi.json": { "get": { "summary": "This OpenAPI document for machine discovery", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } }, "x-9192-billing": "free", "x-9192-auth": "none", "x-9192-rate-limit": "public_low", "x-9192-execution": false } }, "/api/v1/quotes/verify-result": { "post": { "summary": "Create quote for VERIFY_RESULT.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuoteRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "502": { "$ref": "#/components/responses/GatewayError" } }, "x-9192-command": "QUOTE", "x-9192-access": "public", "x-9192-billing": "free_limited_quote", "x-9192-availability": "implemented" } }, "/api/v1/quotes/attest-event": { "post": { "summary": "Create quote for ATTEST_EVENT.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuoteRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "502": { "$ref": "#/components/responses/GatewayError" } }, "x-9192-command": "QUOTE", "x-9192-access": "public", "x-9192-billing": "free_limited_quote", "x-9192-availability": "implemented" } }, "/api/v1/quotes/submit-id": { "post": { "summary": "Create quote for SUBMIT_ID.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuoteRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "502": { "$ref": "#/components/responses/GatewayError" } }, "x-9192-command": "QUOTE", "x-9192-access": "public", "x-9192-billing": "free_limited_quote", "x-9192-availability": "implemented" } }, "/api/v1/quotes/bvm-exec": { "post": { "summary": "Create quote for BVM_EXEC.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuoteRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "502": { "$ref": "#/components/responses/GatewayError" } }, "x-9192-command": "QUOTE", "x-9192-access": "public", "x-9192-billing": "free_limited_quote", "x-9192-availability": "implemented" } }, "/api/v1/quotes/sealed-message": { "post": { "summary": "Create quote for SEALED_MESSAGE.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuoteRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "502": { "$ref": "#/components/responses/GatewayError" } }, "x-9192-command": "QUOTE", "x-9192-access": "public", "x-9192-billing": "free_limited_quote", "x-9192-availability": "implemented" } }, "/api/v1/quotes/timestamp-proof": { "post": { "summary": "Create quote for TIMESTAMP_PROOF.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuoteRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "502": { "$ref": "#/components/responses/GatewayError" } }, "x-9192-command": "QUOTE", "x-9192-access": "public", "x-9192-billing": "free_limited_quote", "x-9192-availability": "implemented" } }, "/api/v1/quotes/machine-event-log": { "post": { "summary": "Create quote for MACHINE_EVENT_LOG.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuoteRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "502": { "$ref": "#/components/responses/GatewayError" } }, "x-9192-command": "QUOTE", "x-9192-access": "public", "x-9192-billing": "free_limited_quote", "x-9192-availability": "implemented" } }, "/api/v1/executions/verify-result": { "post": { "summary": "Execute VERIFY_RESULT after accepted paid quote.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "502": { "$ref": "#/components/responses/GatewayError" } }, "x-9192-command": "VERIFY_RESULT", "x-9192-access": "paid", "x-9192-billing": "paid_required", "x-9192-availability": "implemented" } }, "/api/v1/executions/attest-event": { "post": { "summary": "Execute ATTEST_EVENT after accepted paid quote.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "502": { "$ref": "#/components/responses/GatewayError" } }, "x-9192-command": "ATTEST_EVENT", "x-9192-access": "paid", "x-9192-billing": "paid_required", "x-9192-availability": "implemented" } }, "/api/v1/executions/submit-id": { "post": { "summary": "Execute SUBMIT_ID after accepted paid quote.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "502": { "$ref": "#/components/responses/GatewayError" } }, "x-9192-command": "SUBMIT_ID", "x-9192-access": "paid", "x-9192-billing": "paid_required", "x-9192-availability": "implemented" } }, "/api/v1/executions/bvm-exec": { "post": { "summary": "Execute BVM_EXEC after accepted paid quote.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "502": { "$ref": "#/components/responses/GatewayError" } }, "x-9192-command": "BVM_EXEC", "x-9192-access": "paid", "x-9192-billing": "paid_required", "x-9192-availability": "implemented" } }, "/api/v1/executions/sealed-message": { "post": { "summary": "Execute SEALED_MESSAGE after accepted paid quote.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "502": { "$ref": "#/components/responses/GatewayError" } }, "x-9192-command": "SEALED_MESSAGE", "x-9192-access": "paid", "x-9192-billing": "paid_required", "x-9192-availability": "implemented" } }, "/api/v1/executions/timestamp-proof": { "post": { "summary": "Execute TIMESTAMP_PROOF after accepted paid quote.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "502": { "$ref": "#/components/responses/GatewayError" } }, "x-9192-command": "TIMESTAMP_PROOF", "x-9192-access": "paid", "x-9192-billing": "paid_required", "x-9192-availability": "implemented" } }, "/api/v1/executions/machine-event-log": { "post": { "summary": "Execute MACHINE_EVENT_LOG after accepted paid quote.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "502": { "$ref": "#/components/responses/GatewayError" } }, "x-9192-command": "MACHINE_EVENT_LOG", "x-9192-access": "paid", "x-9192-billing": "paid_required", "x-9192-availability": "implemented" } }, "/api/v1/payment-proofs": { "post": { "summary": "Submit payment proof claim for on-chain verification.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "502": { "$ref": "#/components/responses/GatewayError" } }, "x-9192-command": "FUND_ACCOUNT", "x-9192-access": "public", "x-9192-billing": "proof_push", "x-9192-availability": "implemented" } }, "/api/v1/payment-sessions/{invoice_id}": { "get": { "summary": "Get public payment session details for an invoice.", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "404": { "$ref": "#/components/responses/BadRequest" } }, "x-9192-command": "FUND_ACCOUNT", "x-9192-access": "public", "x-9192-billing": "free", "x-9192-availability": "implemented" } }, "/api/v1/payment-status/{invoice_id}": { "get": { "summary": "Get payment verification status for an invoice.", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayEnvelope" } } } }, "404": { "$ref": "#/components/responses/BadRequest" } }, "x-9192-command": "INVOICE_STATUS", "x-9192-access": "public", "x-9192-billing": "free", "x-9192-availability": "implemented" } }, "/api/v1/receipts/{receipt_id}": { "get": { "summary": "Reserved receipt fetch route; public HTTP fetch is not exposed.", "deprecated": true, "responses": { "404": { "description": "Reserved; not exposed by public HTTP gateway" } }, "x-9192-command": "GET_RECEIPT", "x-9192-access": "reserved", "x-9192-billing": "none", "x-9192-availability": "reserved_not_public" } } } }