{"openapi":"3.1.0","info":{"title":"Trillsverse Gate Machine API","version":"0.1.0","description":"Public machine discovery, MCP, provenance, and x402-paid Trilligence resources."},"servers":[{"url":"https://trillsverse.com"}],"externalDocs":{"description":"Trillsverse machine economy","url":"https://trillsverse.com/.well-known/agent-economy.json"},"paths":{"/.well-known/agent-economy.json":{"get":{"operationId":"getMachineEconomyManifest","summary":"Discover Trillsverse machine resources and payment state","responses":{"200":{"description":"Machine economy manifest","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/economy/resources":{"get":{"operationId":"listMachineResources","summary":"List machine resources","responses":{"200":{"description":"Resource list","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/economy/pricing":{"get":{"operationId":"getMachinePricing","summary":"List current machine-resource pricing","responses":{"200":{"description":"Pricing","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/economy/settlements":{"get":{"operationId":"getPublicSettlementSummary","summary":"Read the public-safe x402 settlement summary","description":"Returns successful retained x402 settlements only. Private observer diagnostics remain protected.","responses":{"200":{"description":"Successful settlement summary","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/economy/quote/{resourceId}":{"get":{"operationId":"quoteMachineResource","summary":"Create a short-lived resource quote","parameters":[{"name":"resourceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Quote","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Resource not found"}}}},"/api/health":{"get":{"operationId":"getGateHealth","summary":"Get Gate health and deployed commit","responses":{"200":{"description":"Healthy runtime"}}}},"/api/release/status":{"get":{"operationId":"getReleaseStatus","summary":"Get production release receipt","responses":{"200":{"description":"Release status"}}}},"/api/mcp/health":{"get":{"operationId":"getMcpHealth","summary":"Get MCP health and version","responses":{"200":{"description":"MCP status"}}}},"/mcp":{"post":{"operationId":"callTrillsverseMcp","summary":"Call the Trillsverse MCP Streamable HTTP endpoint","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"MCP response"},"400":{"description":"Invalid MCP request"}}}},"/api/economy/resource/trilligence.context.bundle":{"get":{"operationId":"get_trilligence_context_bundle","summary":"Trilligence context bundle","description":"One-request context pack containing canonical Trillsverse machine surfaces, callable actions, provenance surfaces, and owned-publication anchors.","x-trilligence-resource-id":"trilligence.context.bundle","x-payment-info":{"protocol":"x402","version":2,"priceUsd":0.01,"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Paid resource after verified settlement","content":{"application/json":{"schema":{"type":"object","required":["protocol","resourceId","generatedAt","machineEntry","canon","gate"]},"example":{"protocol":"trilligence-machine-economy/v0.1","resourceId":"trilligence.context.bundle","generatedAt":"2026-09-27T00:00:00.000Z"}}}},"400":{"description":"Invalid product input"},"402":{"description":"x402 Payment Required"},"405":{"description":"Method not allowed for this product"},"502":{"description":"Product execution or payment facilitator failure"},"503":{"description":"Settlement not confirmed"}}}},"/api/economy/resource/trilligence.identity.graph":{"get":{"operationId":"get_trilligence_identity_graph","summary":"Canonical identity graph","description":"Canonical machine-resolution graph for John Brajer, John B, John Braj, Lultrills, Ace Brajer, and Kasano with roles, relationships, provenance, owned surfaces, and live surface probes.","x-trilligence-resource-id":"trilligence.identity.graph","x-payment-info":{"protocol":"x402","version":2,"priceUsd":0.01,"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Paid resource after verified settlement","content":{"application/json":{"schema":{"type":"object","required":["protocol","resourceId","generatedAt","authority","entities","edges","provenance"]},"example":{"protocol":"trilligence-machine-economy/v0.1","resourceId":"trilligence.identity.graph","generatedAt":"2026-09-27T00:00:00.000Z","entities":[],"edges":[]}}}},"400":{"description":"Invalid product input"},"402":{"description":"x402 Payment Required"},"405":{"description":"Method not allowed for this product"},"502":{"description":"Product execution or payment facilitator failure"},"503":{"description":"Settlement not confirmed"}}}},"/api/economy/resource/trilligence.web.metadata":{"get":{"operationId":"get_trilligence_web_metadata","summary":"Web Metadata","description":"Inspect public web metadata, canonical/social tags, selected headers, and machine-discovery links.","x-trilligence-resource-id":"trilligence.web.metadata","x-payment-info":{"protocol":"x402","version":2,"priceUsd":0.005,"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"},"example":"https://example.com"}],"responses":{"200":{"description":"Paid resource after verified settlement","content":{"application/json":{"schema":{"type":"object","required":["resourceId","productVersion","generatedAt","requestedUrl","finalUrl","status"]},"example":{"resourceId":"trilligence.web.metadata","productVersion":"1.0.0","generatedAt":"2026-09-28T00:00:00.000Z","requestedUrl":"https://example.com","finalUrl":"https://example.com/","status":200}}}},"400":{"description":"Invalid product input"},"402":{"description":"x402 Payment Required"},"405":{"description":"Method not allowed for this product"},"502":{"description":"Product execution or payment facilitator failure"},"503":{"description":"Settlement not confirmed"}}}},"/api/economy/resource/trilligence.redirect.trace":{"get":{"operationId":"get_trilligence_redirect_trace","summary":"Redirect Trace","description":"Trace a public URL redirect chain, final destination, loops, and HTTPS downgrade signals.","x-trilligence-resource-id":"trilligence.redirect.trace","x-payment-info":{"protocol":"x402","version":2,"priceUsd":0.01,"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"},"example":"https://example.com"}],"responses":{"200":{"description":"Paid resource after verified settlement","content":{"application/json":{"schema":{"type":"object","required":["resourceId","productVersion","generatedAt","requestedUrl","hops","finalUrl"]},"example":{"resourceId":"trilligence.redirect.trace","productVersion":"1.0.0","generatedAt":"2026-09-28T00:00:00.000Z","requestedUrl":"http://example.com","hops":[],"finalUrl":"https://example.com/"}}}},"400":{"description":"Invalid product input"},"402":{"description":"x402 Payment Required"},"405":{"description":"Method not allowed for this product"},"502":{"description":"Product execution or payment facilitator failure"},"503":{"description":"Settlement not confirmed"}}}},"/api/economy/resource/trilligence.url.evidence":{"get":{"operationId":"get_trilligence_url_evidence","summary":"URL Evidence","description":"Retrieve bounded public URL evidence with status, selected headers, excerpt, digest, redirects, and provenance.","x-trilligence-resource-id":"trilligence.url.evidence","x-payment-info":{"protocol":"x402","version":2,"priceUsd":0.02,"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"},"example":"https://example.com"}],"responses":{"200":{"description":"Paid resource after verified settlement","content":{"application/json":{"schema":{"type":"object","required":["resourceId","productVersion","generatedAt","requestedUrl","finalUrl","sha256"]},"example":{"resourceId":"trilligence.url.evidence","productVersion":"1.0.0","generatedAt":"2026-09-28T00:00:00.000Z","requestedUrl":"https://example.com","finalUrl":"https://example.com/","sha256":"sha256-placeholder"}}}},"400":{"description":"Invalid product input"},"402":{"description":"x402 Payment Required"},"405":{"description":"Method not allowed for this product"},"502":{"description":"Product execution or payment facilitator failure"},"503":{"description":"Settlement not confirmed"}}}},"/api/economy/resource/trilligence.dns.inventory":{"get":{"operationId":"get_trilligence_dns_inventory","summary":"DNS Inventory","description":"Resolve public DNS records and summarize MX, SPF, DMARC, CAA, and core host records.","x-trilligence-resource-id":"trilligence.dns.inventory","x-payment-info":{"protocol":"x402","version":2,"priceUsd":0.02,"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":253},"example":"example.com"}],"responses":{"200":{"description":"Paid resource after verified settlement","content":{"application/json":{"schema":{"type":"object","required":["resourceId","productVersion","generatedAt","domain","records"]},"example":{"resourceId":"trilligence.dns.inventory","productVersion":"1.0.0","generatedAt":"2026-09-28T00:00:00.000Z","domain":"example.com","records":{}}}}},"400":{"description":"Invalid product input"},"402":{"description":"x402 Payment Required"},"405":{"description":"Method not allowed for this product"},"502":{"description":"Product execution or payment facilitator failure"},"503":{"description":"Settlement not confirmed"}}}},"/api/economy/resource/trilligence.npm.health":{"get":{"operationId":"get_trilligence_npm_health","summary":"NPM Package Health","description":"Inspect public NPM package metadata, release cadence, deprecation, license, and maintenance signals without installing code.","x-trilligence-resource-id":"trilligence.npm.health","x-payment-info":{"protocol":"x402","version":2,"priceUsd":0.02,"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"package","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":214},"example":"express"}],"responses":{"200":{"description":"Paid resource after verified settlement","content":{"application/json":{"schema":{"type":"object","required":["resourceId","productVersion","generatedAt","package","latestVersion","flags"]},"example":{"resourceId":"trilligence.npm.health","productVersion":"1.0.0","generatedAt":"2026-09-28T00:00:00.000Z","package":"express","latestVersion":"5.0.0","flags":[]}}}},"400":{"description":"Invalid product input"},"402":{"description":"x402 Payment Required"},"405":{"description":"Method not allowed for this product"},"502":{"description":"Product execution or payment facilitator failure"},"503":{"description":"Settlement not confirmed"}}}},"/api/economy/resource/trilligence.base.wallet.preflight":{"get":{"operationId":"get_trilligence_base_wallet_preflight","summary":"Base Wallet Preflight","description":"Read Base mainnet wallet readiness signals including ETH, USDC, nonce, and deployed-code presence without signing or mutation.","x-trilligence-resource-id":"trilligence.base.wallet.preflight","x-payment-info":{"protocol":"x402","version":2,"priceUsd":0.01,"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"example":"0x1111111111111111111111111111111111111111"}],"responses":{"200":{"description":"Paid resource after verified settlement","content":{"application/json":{"schema":{"type":"object","required":["resourceId","productVersion","generatedAt","address","network","readiness"]},"example":{"resourceId":"trilligence.base.wallet.preflight","productVersion":"1.0.0","generatedAt":"2026-09-28T00:00:00.000Z","address":"0x1111111111111111111111111111111111111111","network":"eip155:8453","readiness":{}}}}},"400":{"description":"Invalid product input"},"402":{"description":"x402 Payment Required"},"405":{"description":"Method not allowed for this product"},"502":{"description":"Product execution or payment facilitator failure"},"503":{"description":"Settlement not confirmed"}}}},"/api/economy/resource/trilligence.csv.dedupe":{"post":{"operationId":"post_trilligence_csv_dedupe","summary":"CSV Dedupe","description":"Deterministically deduplicate bounded CSV or row data with caller-selected keys and normalization rules.","x-trilligence-resource-id":"trilligence.csv.dedupe","x-payment-info":{"protocol":"x402","version":2,"priceUsd":0.1,"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"csv":{"type":"string"},"rows":{"type":"array","items":{"type":"object"}},"keyColumns":{"type":"array","items":{"type":"string"}},"caseSensitive":{"type":"boolean"},"trimWhitespace":{"type":"boolean"},"preserve":{"type":"string","enum":["first","last"]}},"additionalProperties":false,"anyOf":[{"required":["csv"]},{"required":["rows"]}]},"example":{"rows":[{"id":"1"},{"id":"1"}],"keyColumns":["id"]}}}},"responses":{"200":{"description":"Paid resource after verified settlement","content":{"application/json":{"schema":{"type":"object","required":["resourceId","productVersion","generatedAt","originalRowCount","outputRowCount","rows"]},"example":{"resourceId":"trilligence.csv.dedupe","productVersion":"1.0.0","generatedAt":"2026-09-28T00:00:00.000Z","originalRowCount":2,"outputRowCount":1,"rows":[]}}}},"400":{"description":"Invalid product input"},"402":{"description":"x402 Payment Required"},"405":{"description":"Method not allowed for this product"},"502":{"description":"Product execution or payment facilitator failure"},"503":{"description":"Settlement not confirmed"}}}},"/api/economy/resource/trilligence.site.preflight":{"get":{"operationId":"get_trilligence_site_preflight","summary":"Site Preflight","description":"Decision-ready public site preflight covering metadata, redirects, robots, sitemap, llms, OpenAPI, x402, MCP, and selected policy headers.","x-trilligence-resource-id":"trilligence.site.preflight","x-payment-info":{"protocol":"x402","version":2,"priceUsd":0.05,"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"},"example":"https://example.com"}],"responses":{"200":{"description":"Paid resource after verified settlement","content":{"application/json":{"schema":{"type":"object","required":["resourceId","productVersion","generatedAt","url","checks","readiness"]},"example":{"resourceId":"trilligence.site.preflight","productVersion":"1.0.0","generatedAt":"2026-09-28T00:00:00.000Z","url":"https://example.com","checks":{},"readiness":{}}}}},"400":{"description":"Invalid product input"},"402":{"description":"x402 Payment Required"},"405":{"description":"Method not allowed for this product"},"502":{"description":"Product execution or payment facilitator failure"},"503":{"description":"Settlement not confirmed"}}}},"/api/economy/resource/trilligence.domain.due-diligence":{"get":{"operationId":"get_trilligence_domain_due_diligence","summary":"Domain Due Diligence","description":"Public domain due-diligence bundle combining site, DNS, TLS, email-security, and deterministic consistency flags.","x-trilligence-resource-id":"trilligence.domain.due-diligence","x-payment-info":{"protocol":"x402","version":2,"priceUsd":0.1,"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":253},"example":"example.com"}],"responses":{"200":{"description":"Paid resource after verified settlement","content":{"application/json":{"schema":{"type":"object","required":["resourceId","productVersion","generatedAt","domain","checks","flags"]},"example":{"resourceId":"trilligence.domain.due-diligence","productVersion":"1.0.0","generatedAt":"2026-09-28T00:00:00.000Z","domain":"example.com","checks":{},"flags":[]}}}},"400":{"description":"Invalid product input"},"402":{"description":"x402 Payment Required"},"405":{"description":"Method not allowed for this product"},"502":{"description":"Product execution or payment facilitator failure"},"503":{"description":"Settlement not confirmed"}}}},"/api/economy/resource/trilligence.package.decision-pack":{"get":{"operationId":"get_trilligence_package_decision_pack","summary":"Package Decision Pack","description":"Decision-ready public NPM package assessment combining package health, repository metadata, release cadence, license, and maintenance flags.","x-trilligence-resource-id":"trilligence.package.decision-pack","x-payment-info":{"protocol":"x402","version":2,"priceUsd":0.05,"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"package","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":214},"example":"express"}],"responses":{"200":{"description":"Paid resource after verified settlement","content":{"application/json":{"schema":{"type":"object","required":["resourceId","productVersion","generatedAt","package","assessment","flags"]},"example":{"resourceId":"trilligence.package.decision-pack","productVersion":"1.0.0","generatedAt":"2026-09-28T00:00:00.000Z","package":"express","assessment":{},"flags":[]}}}},"400":{"description":"Invalid product input"},"402":{"description":"x402 Payment Required"},"405":{"description":"Method not allowed for this product"},"502":{"description":"Product execution or payment facilitator failure"},"503":{"description":"Settlement not confirmed"}}}}}}