{"openapi":"3.1.0","info":{"title":"Pacta on-chain pre-execution checks","version":"0.2.0","contact":{"name":"Pacta by Fractal Neurons","url":"https://pacta.fractalneurons.com"},"x-guidance":"Agents: the discovery, lookup, preflight and control-plane routes are free (no key, no wallet). The /v1/x402/* routes are always paid with x402 (USDC on Base, exact scheme): call without a payment header to get the 402 requirements (JSON body + PAYMENT-REQUIRED header), then repeat the same POST with X-PAYMENT (x402 v1) or PAYMENT-SIGNATURE (x402 v2). Nothing is settled unless the product was produced; every settlement is re-checked on Base before the result is returned. Free tier: /v1/check/preflight and the MCP pacta_check_preflight tool share 50 free calls per caller per UTC day (X-Meter-Limit / X-Meter-Remaining / X-Meter-Reset), then $0.01 a call over the same x402 flow (never a dead-end 429). Humans can pay a fixed-price order in USDC on Base and unlock it at /v1/orders/verify.","description":"Pacta by Fractal Neurons: read-only, block-pinned EVM control-plane checks for agents (Ethereum, Base), plus one opt-in write route (POST /v1/requests: coverage / feature requests). Pricing mode: free_launch (free, no key)."},"servers":[{"url":"https://api.pacta.wtf","description":"pacta.wtf API custom domain"},{"url":"https://pacta.fractalneurons.com","description":"Primary custom-domain x402 & MCP edge"},{"url":"https://pacta-x402.pacta.workers.dev","description":"Direct Cloudflare Workers origin"}],"paths":{"/v1/check/preflight":{"get":{"operationId":"check_preflight","summary":"One-call pre-execution safety check of a contract before an agent interacts with it","description":"One-call pre-execution safety check of a contract before an agent interacts with it: verdict (immutable / timelock / zero-delay timelock / multisig / EOA admin / unclassified / undeployed), 0-100 risk score, proxy + implementation, controller kind, zero-delay upgradeability and pause / blacklist / upgrade capabilities, pinned to a block.","parameters":[{"name":"chain","in":"query","required":false,"description":"EVM chain","schema":{"type":"string","enum":["ethereum","base"],"default":"ethereum"}},{"name":"address","in":"query","required":true,"description":"0x-prefixed 20-byte address (EIP-55 checksum enforced when mixed-case)","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},{"name":"block","in":"query","required":false,"description":"Block to pin: \"latest\" (default), a decimal block number or 0x-hex","schema":{"type":"string","pattern":"^(latest|0x[0-9a-fA-F]{1,14}|0|[1-9][0-9]{0,15})$","default":"latest"}},{"name":"caller_agent","in":"query","required":false,"description":"Optional identifier of the calling AI agent, IDE, or framework (e.g. 'claude-code', 'cursor', 'windsurf', 'coinbase-agentkit', 'elizaos', 'langchain', 'chatgpt', 'gemini', 'openclaw', 'custom-agent'). Omitted or invalid values never block a call (inferred from known client headers or 'unspecified'). Lowercase slug only; never include personal names, emails, or secrets. Optional over REST and MCP.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9._/-]{1,47}$","maxLength":48}},{"name":"requester_role","in":"query","required":false,"description":"Optional: high-level role category of the requester or system running this check (closed enum; no personal data). Optional over REST and MCP.","schema":{"type":"string","enum":["autonomous_agent","defi_developer","risk_curator_analyst","security_researcher","protocol_team","institutional_allocator","individual_user"]}},{"name":"caller_purpose","in":"query","required":false,"description":"Optional: operational workflow context for this pre-execution check (closed enum). Optional over REST and MCP.","schema":{"type":"string","enum":["pre_trade_safety","collateral_due_diligence","yield_allocation","security_audit","governance_monitoring","integration_testing","general_research"]}}],"responses":{"200":{"description":"Result (free_launch: X-Meter-* headers and upgrade_x402; 50 free calls per caller per UTC day)","content":{"application/json":{"schema":{"type":"object","required":["schema","chain","chainId","address","pinnedBlock","verdict","riskScore","isContract","isProxy","implementation","hasAdminSlot","canUpgradeZeroDelay","capabilities","paused","controller","summary"],"properties":{"schema":{"const":"pacta.preflight_check.v1"},"chain":{"type":"string","enum":["ethereum","base"]},"chainId":{"type":"integer"},"address":{"type":"string"},"pinnedBlock":{"type":"integer"},"pinnedBlockHash":{"type":"string"},"blockTimestamp":{"type":"integer"},"verdict":{"type":"string","enum":["IMMUTABLE_NO_ADMIN","TIMELOCK_PROTECTED","ZERO_DELAY_TIMELOCK_RISK","MULTISIG_NO_TIMELOCK","INSTANT_EOA_ADMIN_RISK","UNDEPLOYED_OR_EOA","UNCLASSIFIED_CONTRACT_CONTROLLER"]},"riskScore":{"type":["integer","null"],"minimum":0,"maximum":100},"isContract":{"type":"boolean"},"isProxy":{"type":"boolean"},"proxyType":{"type":["string","null"],"enum":["eip1967","eip1967_beacon","eip1822",null]},"implementation":{"type":["string","null"]},"beacon":{"type":["string","null"]},"hasAdminSlot":{"type":"boolean"},"canUpgradeZeroDelay":{"type":["boolean","null"]},"capabilities":{"type":"object","properties":{"pause":{"type":"boolean"},"blacklist":{"type":"boolean"},"upgrade":{"type":"boolean"}}},"paused":{"type":["boolean","null"]},"controller":{"type":"object","properties":{"address":{"type":["string","null"]},"kind":{"type":"string","enum":["none","eoa","multisig_safe","timelock","contract","access_control_enumerable","access_control"]},"roleAdminCount":{"type":"integer"},"beacon":{"type":"string"},"proxyAdmin":{"type":"string"},"source":{"type":["string","null"]},"safeThreshold":{"type":["integer","null"]},"timelockDelaySec":{"type":["integer","null"]}}},"summary":{"type":"string"},"source":{"type":"string","enum":["live_rpc"],"description":"live_rpc: read at pinnedBlock. (An RPC outage on an indexed target returns schema pacta.preflight_catalog_fallback.v1 with source pinned_catalog_fallback instead of a 502.)"},"catalogMatch":{"type":"object","description":"Present when (chain, address) is an indexed protocol contract, controller, surface or related contract: the verified, block-pinned Pacta record (slug, url, classification, Base EAS UIDs, pinnedBlock, whatDiffers)."},"assessment":{"type":"object","required":["coverage","confidence","method","limits"],"description":"Confidence framing for riskScore","properties":{"coverage":{"type":"string","enum":["indexed_verified","unindexed_bytecode_heuristic"]},"confidence":{"type":"string","enum":["high","medium","low"]},"method":{"type":"string"},"limits":{"type":"array","items":{"type":"string"}}}},"activeGovernanceDiscussions":{"type":"array","maxItems":5,"description":"Optional: present only when the address is indexed in the Pacta forum digest (read-only Discourse summary); newest lastPostedAt first","items":{"type":"object","required":["forum","topicId","title","url","lastPostedAt"],"properties":{"forum":{"type":"string"},"topicId":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"},"lastPostedAt":{"type":"string"}}}}}}}},"headers":{"X-Meter-Limit":{"description":"Free calls per caller per UTC day","schema":{"type":"integer"}},"X-Meter-Remaining":{"description":"Free calls left today","schema":{"type":"integer"}},"X-Meter-Reset":{"description":"Unix seconds of the next UTC midnight (quota reset)","schema":{"type":"integer"}}}},"400":{"description":"Invalid input (with usage)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required: in x402_paid mode, or in free_launch after the 50 free calls of the UTC day ($0.01 a call, USDC on Base; same body + PAYMENT-REQUIRED header as /v1/x402/*)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}},"headers":{"X-Meter-Limit":{"description":"Free calls per caller per UTC day","schema":{"type":"integer"}},"X-Meter-Remaining":{"description":"Free calls left today","schema":{"type":"integer"}},"X-Meter-Reset":{"description":"Unix seconds of the next UTC midnight (quota reset)","schema":{"type":"integer"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or feed unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"check_preflight_post","summary":"One-call pre-execution safety check of a contract before an agent interacts with it","description":"One-call pre-execution safety check of a contract before an agent interacts with it: verdict (immutable / timelock / zero-delay timelock / multisig / EOA admin / unclassified / undeployed), 0-100 risk score, proxy + implementation, controller kind, zero-delay upgradeability and pause / blacklist / upgrade capabilities, pinned to a block. Same parameters as a JSON body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string","enum":["ethereum","base"],"default":"ethereum","description":"EVM chain"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"0x-prefixed 20-byte address (EIP-55 checksum enforced when mixed-case)"},"block":{"type":"string","pattern":"^(latest|0x[0-9a-fA-F]{1,14}|0|[1-9][0-9]{0,15})$","default":"latest","description":"Block to pin: \"latest\" (default), a decimal block number or 0x-hex"},"caller_agent":{"type":"string","pattern":"^[a-z0-9][a-z0-9._/-]{1,47}$","maxLength":48,"description":"Optional identifier of the calling AI agent, IDE, or framework (e.g. 'claude-code', 'cursor', 'windsurf', 'coinbase-agentkit', 'elizaos', 'langchain', 'chatgpt', 'gemini', 'openclaw', 'custom-agent'). Omitted or invalid values never block a call (inferred from known client headers or 'unspecified'). Lowercase slug only; never include personal names, emails, or secrets."},"requester_role":{"type":"string","enum":["autonomous_agent","defi_developer","risk_curator_analyst","security_researcher","protocol_team","institutional_allocator","individual_user"],"description":"Optional: high-level role category of the requester or system running this check (closed enum; no personal data)."},"caller_purpose":{"type":"string","enum":["pre_trade_safety","collateral_due_diligence","yield_allocation","security_audit","governance_monitoring","integration_testing","general_research"],"description":"Optional: operational workflow context for this pre-execution check (closed enum)."}},"additionalProperties":false,"required":["address"]}}}},"responses":{"200":{"description":"Result (free_launch: X-Meter-* headers and upgrade_x402; 50 free calls per caller per UTC day)","content":{"application/json":{"schema":{"type":"object","required":["schema","chain","chainId","address","pinnedBlock","verdict","riskScore","isContract","isProxy","implementation","hasAdminSlot","canUpgradeZeroDelay","capabilities","paused","controller","summary"],"properties":{"schema":{"const":"pacta.preflight_check.v1"},"chain":{"type":"string","enum":["ethereum","base"]},"chainId":{"type":"integer"},"address":{"type":"string"},"pinnedBlock":{"type":"integer"},"pinnedBlockHash":{"type":"string"},"blockTimestamp":{"type":"integer"},"verdict":{"type":"string","enum":["IMMUTABLE_NO_ADMIN","TIMELOCK_PROTECTED","ZERO_DELAY_TIMELOCK_RISK","MULTISIG_NO_TIMELOCK","INSTANT_EOA_ADMIN_RISK","UNDEPLOYED_OR_EOA","UNCLASSIFIED_CONTRACT_CONTROLLER"]},"riskScore":{"type":["integer","null"],"minimum":0,"maximum":100},"isContract":{"type":"boolean"},"isProxy":{"type":"boolean"},"proxyType":{"type":["string","null"],"enum":["eip1967","eip1967_beacon","eip1822",null]},"implementation":{"type":["string","null"]},"beacon":{"type":["string","null"]},"hasAdminSlot":{"type":"boolean"},"canUpgradeZeroDelay":{"type":["boolean","null"]},"capabilities":{"type":"object","properties":{"pause":{"type":"boolean"},"blacklist":{"type":"boolean"},"upgrade":{"type":"boolean"}}},"paused":{"type":["boolean","null"]},"controller":{"type":"object","properties":{"address":{"type":["string","null"]},"kind":{"type":"string","enum":["none","eoa","multisig_safe","timelock","contract","access_control_enumerable","access_control"]},"roleAdminCount":{"type":"integer"},"beacon":{"type":"string"},"proxyAdmin":{"type":"string"},"source":{"type":["string","null"]},"safeThreshold":{"type":["integer","null"]},"timelockDelaySec":{"type":["integer","null"]}}},"summary":{"type":"string"},"source":{"type":"string","enum":["live_rpc"],"description":"live_rpc: read at pinnedBlock. (An RPC outage on an indexed target returns schema pacta.preflight_catalog_fallback.v1 with source pinned_catalog_fallback instead of a 502.)"},"catalogMatch":{"type":"object","description":"Present when (chain, address) is an indexed protocol contract, controller, surface or related contract: the verified, block-pinned Pacta record (slug, url, classification, Base EAS UIDs, pinnedBlock, whatDiffers)."},"assessment":{"type":"object","required":["coverage","confidence","method","limits"],"description":"Confidence framing for riskScore","properties":{"coverage":{"type":"string","enum":["indexed_verified","unindexed_bytecode_heuristic"]},"confidence":{"type":"string","enum":["high","medium","low"]},"method":{"type":"string"},"limits":{"type":"array","items":{"type":"string"}}}},"activeGovernanceDiscussions":{"type":"array","maxItems":5,"description":"Optional: present only when the address is indexed in the Pacta forum digest (read-only Discourse summary); newest lastPostedAt first","items":{"type":"object","required":["forum","topicId","title","url","lastPostedAt"],"properties":{"forum":{"type":"string"},"topicId":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"},"lastPostedAt":{"type":"string"}}}}}}}},"headers":{"X-Meter-Limit":{"description":"Free calls per caller per UTC day","schema":{"type":"integer"}},"X-Meter-Remaining":{"description":"Free calls left today","schema":{"type":"integer"}},"X-Meter-Reset":{"description":"Unix seconds of the next UTC midnight (quota reset)","schema":{"type":"integer"}}}},"400":{"description":"Invalid input (with usage)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required: in x402_paid mode, or in free_launch after the 50 free calls of the UTC day ($0.01 a call, USDC on Base; same body + PAYMENT-REQUIRED header as /v1/x402/*)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}},"headers":{"X-Meter-Limit":{"description":"Free calls per caller per UTC day","schema":{"type":"integer"}},"X-Meter-Remaining":{"description":"Free calls left today","schema":{"type":"integer"}},"X-Meter-Reset":{"description":"Unix seconds of the next UTC midnight (quota reset)","schema":{"type":"integer"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or feed unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/scan/control-plane":{"get":{"operationId":"scan_control_plane","summary":"Live control-plane scan of an EVM contract","description":"Live control-plane scan of an EVM contract: EIP-1967 implementation/admin/beacon, owner(), Safe threshold/owners/guard, timelock delay, code size and deterministic risk flags at the latest (or a given) block.","parameters":[{"name":"chain","in":"query","required":false,"description":"EVM chain","schema":{"type":"string","enum":["ethereum","base"],"default":"ethereum"}},{"name":"address","in":"query","required":true,"description":"0x-prefixed 20-byte address (EIP-55 checksum enforced when mixed-case)","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},{"name":"block","in":"query","required":false,"description":"Block to pin: \"latest\" (default), a decimal block number or 0x-hex","schema":{"type":"string","pattern":"^(latest|0x[0-9a-fA-F]{1,14}|0|[1-9][0-9]{0,15})$","default":"latest"}},{"name":"caller_agent","in":"query","required":false,"description":"Optional identifier of the calling AI agent, IDE, or framework (e.g. 'claude-code', 'cursor', 'windsurf', 'coinbase-agentkit', 'elizaos', 'langchain', 'chatgpt', 'gemini', 'openclaw', 'custom-agent'). Omitted or invalid values never block a call (inferred from known client headers or 'unspecified'). Lowercase slug only; never include personal names, emails, or secrets. Optional over REST and MCP.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9._/-]{1,47}$","maxLength":48}},{"name":"requester_role","in":"query","required":false,"description":"Optional: high-level role category of the requester or system running this check (closed enum; no personal data). Optional over REST and MCP.","schema":{"type":"string","enum":["autonomous_agent","defi_developer","risk_curator_analyst","security_researcher","protocol_team","institutional_allocator","individual_user"]}},{"name":"caller_purpose","in":"query","required":false,"description":"Optional: operational workflow context for this pre-execution check (closed enum). Optional over REST and MCP.","schema":{"type":"string","enum":["pre_trade_safety","collateral_due_diligence","yield_allocation","security_audit","governance_monitoring","integration_testing","general_research"]}}],"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","required":["chain","address","block","codeBytes","eip1967","owner","riskFlags","summary"],"properties":{"chain":{"type":"string"},"address":{"type":"string"},"block":{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},"codeBytes":{"type":"integer"},"eip1967":{"type":"object","properties":{"implementation":{"type":["string","null"]},"admin":{"type":["string","null"]},"beacon":{"type":["string","null"]}}},"owner":{"type":["string","null"]},"safe":{"type":"object"},"proxyAdmin":{"type":"object"},"upgradeAuthority":{"type":["object","null"]},"ownerPrincipal":{"type":["object","null"]},"probedStatus":{"type":"object"},"riskFlags":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"}}}}}},"400":{"description":"Invalid input (with usage)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required (only when pricingMode is x402_paid)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or feed unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"scan_control_plane_post","summary":"Live control-plane scan of an EVM contract","description":"Live control-plane scan of an EVM contract: EIP-1967 implementation/admin/beacon, owner(), Safe threshold/owners/guard, timelock delay, code size and deterministic risk flags at the latest (or a given) block. Same parameters as a JSON body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string","enum":["ethereum","base"],"default":"ethereum","description":"EVM chain"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"0x-prefixed 20-byte address (EIP-55 checksum enforced when mixed-case)"},"block":{"type":"string","pattern":"^(latest|0x[0-9a-fA-F]{1,14}|0|[1-9][0-9]{0,15})$","default":"latest","description":"Block to pin: \"latest\" (default), a decimal block number or 0x-hex"},"caller_agent":{"type":"string","pattern":"^[a-z0-9][a-z0-9._/-]{1,47}$","maxLength":48,"description":"Optional identifier of the calling AI agent, IDE, or framework (e.g. 'claude-code', 'cursor', 'windsurf', 'coinbase-agentkit', 'elizaos', 'langchain', 'chatgpt', 'gemini', 'openclaw', 'custom-agent'). Omitted or invalid values never block a call (inferred from known client headers or 'unspecified'). Lowercase slug only; never include personal names, emails, or secrets."},"requester_role":{"type":"string","enum":["autonomous_agent","defi_developer","risk_curator_analyst","security_researcher","protocol_team","institutional_allocator","individual_user"],"description":"Optional: high-level role category of the requester or system running this check (closed enum; no personal data)."},"caller_purpose":{"type":"string","enum":["pre_trade_safety","collateral_due_diligence","yield_allocation","security_audit","governance_monitoring","integration_testing","general_research"],"description":"Optional: operational workflow context for this pre-execution check (closed enum)."}},"additionalProperties":false,"required":["address"]}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","required":["chain","address","block","codeBytes","eip1967","owner","riskFlags","summary"],"properties":{"chain":{"type":"string"},"address":{"type":"string"},"block":{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},"codeBytes":{"type":"integer"},"eip1967":{"type":"object","properties":{"implementation":{"type":["string","null"]},"admin":{"type":["string","null"]},"beacon":{"type":["string","null"]}}},"owner":{"type":["string","null"]},"safe":{"type":"object"},"proxyAdmin":{"type":"object"},"upgradeAuthority":{"type":["object","null"]},"ownerPrincipal":{"type":["object","null"]},"probedStatus":{"type":"object"},"riskFlags":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"}}}}}},"400":{"description":"Invalid input (with usage)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required (only when pricingMode is x402_paid)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or feed unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/scan/timelock-op":{"get":{"operationId":"scan_timelock_op","summary":"Live OpenZeppelin TimelockController operation state","description":"Live OpenZeppelin TimelockController operation state: isOperation/Pending/Ready/Done, getTimestamp (ETA), getMinDelay at the latest block.","parameters":[{"name":"chain","in":"query","required":false,"description":"EVM chain","schema":{"type":"string","enum":["ethereum","base"],"default":"ethereum"}},{"name":"timelock","in":"query","required":true,"description":"OpenZeppelin TimelockController address","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},{"name":"opId","in":"query","required":false,"description":"bytes32 operation id (hashOperation / CallScheduled id); or give target + value + data (+ predecessor + salt)","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}},{"name":"target","in":"query","required":false,"description":"Scheduled call target (to compute opId)","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},{"name":"value","in":"query","required":false,"description":"Call value in wei (default 0)","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,77})$"}},{"name":"data","in":"query","required":false,"description":"Calldata (default 0x)","schema":{"type":"string","pattern":"^0x([0-9a-fA-F]{2})*$"}},{"name":"predecessor","in":"query","required":false,"description":"bytes32 predecessor (default 0x00..00)","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}},{"name":"salt","in":"query","required":false,"description":"bytes32 salt (default 0x00..00)","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}},{"name":"caller_agent","in":"query","required":false,"description":"Optional identifier of the calling AI agent, IDE, or framework (e.g. 'claude-code', 'cursor', 'windsurf', 'coinbase-agentkit', 'elizaos', 'langchain', 'chatgpt', 'gemini', 'openclaw', 'custom-agent'). Omitted or invalid values never block a call (inferred from known client headers or 'unspecified'). Lowercase slug only; never include personal names, emails, or secrets. Optional over REST and MCP.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9._/-]{1,47}$","maxLength":48}},{"name":"requester_role","in":"query","required":false,"description":"Optional: high-level role category of the requester or system running this check (closed enum; no personal data). Optional over REST and MCP.","schema":{"type":"string","enum":["autonomous_agent","defi_developer","risk_curator_analyst","security_researcher","protocol_team","institutional_allocator","individual_user"]}},{"name":"caller_purpose","in":"query","required":false,"description":"Optional: operational workflow context for this pre-execution check (closed enum). Optional over REST and MCP.","schema":{"type":"string","enum":["pre_trade_safety","collateral_due_diligence","yield_allocation","security_audit","governance_monitoring","integration_testing","general_research"]}}],"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","required":["chain","timelock","opId","block","state","timestamp","status","minDelaySeconds"],"properties":{"chain":{"type":"string"},"timelock":{"type":"string"},"opId":{"type":"string"},"block":{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},"state":{"type":"object","properties":{"isOperation":{"type":["boolean","null"]},"isOperationPending":{"type":["boolean","null"]},"isOperationReady":{"type":["boolean","null"]},"isOperationDone":{"type":["boolean","null"]}}},"timestamp":{"type":"integer"},"etaIso":{"type":["string","null"]},"minDelaySeconds":{"type":"integer"},"status":{"type":"string","enum":["unset","pending","ready","done"]},"secondsUntilReady":{"type":"integer"}}}}}},"400":{"description":"Invalid input (with usage)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required (only when pricingMode is x402_paid)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or feed unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"scan_timelock_op_post","summary":"Live OpenZeppelin TimelockController operation state","description":"Live OpenZeppelin TimelockController operation state: isOperation/Pending/Ready/Done, getTimestamp (ETA), getMinDelay at the latest block. Same parameters as a JSON body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string","enum":["ethereum","base"],"default":"ethereum","description":"EVM chain"},"timelock":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"OpenZeppelin TimelockController address"},"opId":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"bytes32 operation id (hashOperation / CallScheduled id); or give target + value + data (+ predecessor + salt)"},"target":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Scheduled call target (to compute opId)"},"value":{"type":"string","pattern":"^(0|[1-9][0-9]{0,77})$","description":"Call value in wei (default 0)"},"data":{"type":"string","pattern":"^0x([0-9a-fA-F]{2})*$","description":"Calldata (default 0x)"},"predecessor":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"bytes32 predecessor (default 0x00..00)"},"salt":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"bytes32 salt (default 0x00..00)"},"caller_agent":{"type":"string","pattern":"^[a-z0-9][a-z0-9._/-]{1,47}$","maxLength":48,"description":"Optional identifier of the calling AI agent, IDE, or framework (e.g. 'claude-code', 'cursor', 'windsurf', 'coinbase-agentkit', 'elizaos', 'langchain', 'chatgpt', 'gemini', 'openclaw', 'custom-agent'). Omitted or invalid values never block a call (inferred from known client headers or 'unspecified'). Lowercase slug only; never include personal names, emails, or secrets."},"requester_role":{"type":"string","enum":["autonomous_agent","defi_developer","risk_curator_analyst","security_researcher","protocol_team","institutional_allocator","individual_user"],"description":"Optional: high-level role category of the requester or system running this check (closed enum; no personal data)."},"caller_purpose":{"type":"string","enum":["pre_trade_safety","collateral_due_diligence","yield_allocation","security_audit","governance_monitoring","integration_testing","general_research"],"description":"Optional: operational workflow context for this pre-execution check (closed enum)."}},"additionalProperties":false,"required":["timelock"]}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","required":["chain","timelock","opId","block","state","timestamp","status","minDelaySeconds"],"properties":{"chain":{"type":"string"},"timelock":{"type":"string"},"opId":{"type":"string"},"block":{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},"state":{"type":"object","properties":{"isOperation":{"type":["boolean","null"]},"isOperationPending":{"type":["boolean","null"]},"isOperationReady":{"type":["boolean","null"]},"isOperationDone":{"type":["boolean","null"]}}},"timestamp":{"type":"integer"},"etaIso":{"type":["string","null"]},"minDelaySeconds":{"type":"integer"},"status":{"type":"string","enum":["unset","pending","ready","done"]},"secondsUntilReady":{"type":"integer"}}}}}},"400":{"description":"Invalid input (with usage)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required (only when pricingMode is x402_paid)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or feed unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/scan/proposal-diff":{"get":{"operationId":"scan_proposal_diff","summary":"Re-runs the pinned contract reads of a Pacta-tracked governance proposal (Aave, Euler, Morpho, Sky) at the live block an","description":"Re-runs the pinned contract reads of a Pacta-tracked governance proposal (Aave, Euler, Morpho, Sky) at the live block and returns pinned-vs-live diffs.","parameters":[{"name":"forum","in":"query","required":true,"description":"Governance forum","schema":{"type":"string","enum":["aave","euler","morpho","sky"]}},{"name":"topicId","in":"query","required":true,"description":"Forum topic id; the proposal must be listed in https://pacta.wtf/api/v1/proposals.json as <forum>-<topicId>","schema":{"type":"string","pattern":"^[1-9][0-9]{0,9}$"}},{"name":"caller_agent","in":"query","required":false,"description":"Optional identifier of the calling AI agent, IDE, or framework (e.g. 'claude-code', 'cursor', 'windsurf', 'coinbase-agentkit', 'elizaos', 'langchain', 'chatgpt', 'gemini', 'openclaw', 'custom-agent'). Omitted or invalid values never block a call (inferred from known client headers or 'unspecified'). Lowercase slug only; never include personal names, emails, or secrets. Optional over REST and MCP.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9._/-]{1,47}$","maxLength":48}},{"name":"requester_role","in":"query","required":false,"description":"Optional: high-level role category of the requester or system running this check (closed enum; no personal data). Optional over REST and MCP.","schema":{"type":"string","enum":["autonomous_agent","defi_developer","risk_curator_analyst","security_researcher","protocol_team","institutional_allocator","individual_user"]}},{"name":"caller_purpose","in":"query","required":false,"description":"Optional: operational workflow context for this pre-execution check (closed enum). Optional over REST and MCP.","schema":{"type":"string","enum":["pre_trade_safety","collateral_due_diligence","yield_allocation","security_audit","governance_monitoring","integration_testing","general_research"]}}],"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","required":["proposalId","chain","pinnedBlock","liveBlock","reads","summary"],"properties":{"proposalId":{"type":"string"},"forum":{"type":["string","null"]},"topicId":{"type":["integer","null"]},"title":{"type":"string"},"chain":{"type":"string"},"chainId":{"type":"integer"},"pinnedBlock":{"type":"object","properties":{"number":{"type":"integer"},"hash":{"type":"string"},"check":{"type":"string","enum":["canonical","hash_mismatch","block_not_found","ahead_of_live_head"]}}},"liveBlock":{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},"reads":{"type":"array","items":{"type":"object","required":["target","signature","pinned","live","changed"],"properties":{"command":{"type":"string"},"target":{"type":"string"},"signature":{"type":"string"},"args":{"type":"array"},"returns":{"type":"array"},"pinned":{"type":"object","required":["status"],"properties":{"status":{"type":"string","enum":["ok","reverted","state_unavailable","not_read"]},"raw":{"type":"string"},"decoded":{}}},"live":{"type":"object","required":["status"],"properties":{"status":{"type":"string","enum":["ok","reverted","state_unavailable","not_read"]},"raw":{"type":"string"},"decoded":{}}},"changed":{"type":["boolean","null"]}}}},"skipped":{"type":"array","items":{"type":"object","properties":{"command":{"type":["string","null"]},"reason":{"type":"string"}}}},"summary":{"type":"object","properties":{"reads":{"type":"integer"},"changed":{"type":"integer"},"unchanged":{"type":"integer"},"unknown":{"type":"integer"},"skipped":{"type":"integer"},"headline":{"type":"string"}}}}}}}},"400":{"description":"Invalid input (with usage)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required (only when pricingMode is x402_paid)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or feed unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"scan_proposal_diff_post","summary":"Re-runs the pinned contract reads of a Pacta-tracked governance proposal (Aave, Euler, Morpho, Sky) at the live block an","description":"Re-runs the pinned contract reads of a Pacta-tracked governance proposal (Aave, Euler, Morpho, Sky) at the live block and returns pinned-vs-live diffs. Same parameters as a JSON body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"forum":{"type":"string","enum":["aave","euler","morpho","sky"],"description":"Governance forum"},"topicId":{"type":"string","pattern":"^[1-9][0-9]{0,9}$","description":"Forum topic id; the proposal must be listed in https://pacta.wtf/api/v1/proposals.json as <forum>-<topicId>"},"caller_agent":{"type":"string","pattern":"^[a-z0-9][a-z0-9._/-]{1,47}$","maxLength":48,"description":"Optional identifier of the calling AI agent, IDE, or framework (e.g. 'claude-code', 'cursor', 'windsurf', 'coinbase-agentkit', 'elizaos', 'langchain', 'chatgpt', 'gemini', 'openclaw', 'custom-agent'). Omitted or invalid values never block a call (inferred from known client headers or 'unspecified'). Lowercase slug only; never include personal names, emails, or secrets."},"requester_role":{"type":"string","enum":["autonomous_agent","defi_developer","risk_curator_analyst","security_researcher","protocol_team","institutional_allocator","individual_user"],"description":"Optional: high-level role category of the requester or system running this check (closed enum; no personal data)."},"caller_purpose":{"type":"string","enum":["pre_trade_safety","collateral_due_diligence","yield_allocation","security_audit","governance_monitoring","integration_testing","general_research"],"description":"Optional: operational workflow context for this pre-execution check (closed enum)."}},"additionalProperties":false,"required":["forum","topicId"]}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","required":["proposalId","chain","pinnedBlock","liveBlock","reads","summary"],"properties":{"proposalId":{"type":"string"},"forum":{"type":["string","null"]},"topicId":{"type":["integer","null"]},"title":{"type":"string"},"chain":{"type":"string"},"chainId":{"type":"integer"},"pinnedBlock":{"type":"object","properties":{"number":{"type":"integer"},"hash":{"type":"string"},"check":{"type":"string","enum":["canonical","hash_mismatch","block_not_found","ahead_of_live_head"]}}},"liveBlock":{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},"reads":{"type":"array","items":{"type":"object","required":["target","signature","pinned","live","changed"],"properties":{"command":{"type":"string"},"target":{"type":"string"},"signature":{"type":"string"},"args":{"type":"array"},"returns":{"type":"array"},"pinned":{"type":"object","required":["status"],"properties":{"status":{"type":"string","enum":["ok","reverted","state_unavailable","not_read"]},"raw":{"type":"string"},"decoded":{}}},"live":{"type":"object","required":["status"],"properties":{"status":{"type":"string","enum":["ok","reverted","state_unavailable","not_read"]},"raw":{"type":"string"},"decoded":{}}},"changed":{"type":["boolean","null"]}}}},"skipped":{"type":"array","items":{"type":"object","properties":{"command":{"type":["string","null"]},"reason":{"type":"string"}}}},"summary":{"type":"object","properties":{"reads":{"type":"integer"},"changed":{"type":"integer"},"unchanged":{"type":"integer"},"unknown":{"type":"integer"},"skipped":{"type":"integer"},"headline":{"type":"string"}}}}}}}},"400":{"description":"Invalid input (with usage)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required (only when pricingMode is x402_paid)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or feed unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/briefs/live-timelocks":{"get":{"operationId":"briefs_live_timelocks","summary":"Live state of the public pending timelock operations tracked in https","description":"Live state of the public pending timelock operations tracked in https://pacta.wtf/api/v1/radar.json, each re-checked at the latest block (getTimestamp, isOperationPending, isOperationDone).","parameters":[{"name":"protocol","in":"query","required":false,"description":"Optional case-insensitive protocol filter (radar.json item protocol)","schema":{"type":"string"}},{"name":"caller_agent","in":"query","required":false,"description":"Optional identifier of the calling AI agent, IDE, or framework (e.g. 'claude-code', 'cursor', 'windsurf', 'coinbase-agentkit', 'elizaos', 'langchain', 'chatgpt', 'gemini', 'openclaw', 'custom-agent'). Omitted or invalid values never block a call (inferred from known client headers or 'unspecified'). Lowercase slug only; never include personal names, emails, or secrets. Optional over REST and MCP.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9._/-]{1,47}$","maxLength":48}},{"name":"requester_role","in":"query","required":false,"description":"Optional: high-level role category of the requester or system running this check (closed enum; no personal data). Optional over REST and MCP.","schema":{"type":"string","enum":["autonomous_agent","defi_developer","risk_curator_analyst","security_researcher","protocol_team","institutional_allocator","individual_user"]}},{"name":"caller_purpose","in":"query","required":false,"description":"Optional: operational workflow context for this pre-execution check (closed enum). Optional over REST and MCP.","schema":{"type":"string","enum":["pre_trade_safety","collateral_due_diligence","yield_allocation","security_audit","governance_monitoring","integration_testing","general_research"]}}],"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","required":["generatedAt","count","operations"],"properties":{"generatedAt":{"type":"integer"},"count":{"type":"integer"},"truncated":{"type":"boolean"},"radar":{"type":"object"},"skipped":{"type":"array"},"operations":{"type":"array","items":{"type":"object","required":["chain","timelock","opId","live","block"],"properties":{"protocol":{"type":"string"},"title":{"type":"string"},"chain":{"type":"string"},"timelock":{"type":"string"},"opId":{"type":"string"},"feed":{"type":"object"},"live":{"type":"object","properties":{"status":{"type":"string","enum":["unset","pending","ready","done","unprocessable","unknown"]},"timestamp":{"type":["integer","null"]},"etaIso":{"type":["string","null"]},"isOperationPending":{"type":["boolean","null"]},"isOperationDone":{"type":["boolean","null"]},"secondsUntilReady":{"type":"integer"}}},"changedSinceFeed":{"type":["boolean","null"]},"block":{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}}}}},"note":{"type":"string"}}}}}},"400":{"description":"Invalid input (with usage)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required (only when pricingMode is x402_paid)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or feed unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"briefs_live_timelocks_post","summary":"Live state of the public pending timelock operations tracked in https","description":"Live state of the public pending timelock operations tracked in https://pacta.wtf/api/v1/radar.json, each re-checked at the latest block (getTimestamp, isOperationPending, isOperationDone). Same parameters as a JSON body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"protocol":{"type":"string","description":"Optional case-insensitive protocol filter (radar.json item protocol)"},"caller_agent":{"type":"string","pattern":"^[a-z0-9][a-z0-9._/-]{1,47}$","maxLength":48,"description":"Optional identifier of the calling AI agent, IDE, or framework (e.g. 'claude-code', 'cursor', 'windsurf', 'coinbase-agentkit', 'elizaos', 'langchain', 'chatgpt', 'gemini', 'openclaw', 'custom-agent'). Omitted or invalid values never block a call (inferred from known client headers or 'unspecified'). Lowercase slug only; never include personal names, emails, or secrets."},"requester_role":{"type":"string","enum":["autonomous_agent","defi_developer","risk_curator_analyst","security_researcher","protocol_team","institutional_allocator","individual_user"],"description":"Optional: high-level role category of the requester or system running this check (closed enum; no personal data)."},"caller_purpose":{"type":"string","enum":["pre_trade_safety","collateral_due_diligence","yield_allocation","security_audit","governance_monitoring","integration_testing","general_research"],"description":"Optional: operational workflow context for this pre-execution check (closed enum)."}},"additionalProperties":false,"required":[]}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","required":["generatedAt","count","operations"],"properties":{"generatedAt":{"type":"integer"},"count":{"type":"integer"},"truncated":{"type":"boolean"},"radar":{"type":"object"},"skipped":{"type":"array"},"operations":{"type":"array","items":{"type":"object","required":["chain","timelock","opId","live","block"],"properties":{"protocol":{"type":"string"},"title":{"type":"string"},"chain":{"type":"string"},"timelock":{"type":"string"},"opId":{"type":"string"},"feed":{"type":"object"},"live":{"type":"object","properties":{"status":{"type":"string","enum":["unset","pending","ready","done","unprocessable","unknown"]},"timestamp":{"type":["integer","null"]},"etaIso":{"type":["string","null"]},"isOperationPending":{"type":["boolean","null"]},"isOperationDone":{"type":["boolean","null"]},"secondsUntilReady":{"type":"integer"}}},"changedSinceFeed":{"type":["boolean","null"]},"block":{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}}}}},"note":{"type":"string"}}}}}},"400":{"description":"Invalid input (with usage)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required (only when pricingMode is x402_paid)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or feed unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/check/wallet-exposure":{"get":{"operationId":"check_wallet_exposure","summary":"Read-only Multicall3 wallet & Gnosis Safe DeFi control-plane exposure scan across Ethereum and Base","description":"Read-only Multicall3 wallet & Gnosis Safe DeFi control-plane exposure scan across Ethereum and Base: Safe threshold/owners detection, ERC-20 / ERC-4626 / MetaMorpho balanceOf + symbol/decimals verification across 313 indexed protocols, portfolio 0-100 risk score, shortest exit window, position roster, and the #1 highest-urgency adverse control-plane gap breakdown with Base EAS UID.","parameters":[{"name":"address","in":"query","required":true,"description":"Wallet or Gnosis Safe 0x address to scan (read-only Multicall3; never logged in public telemetry)","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},{"name":"chain","in":"query","required":false,"description":"Chains to scan: all (default, Ethereum + Base in parallel), ethereum, or base","schema":{"type":"string","enum":["ethereum","base","all"],"default":"all"}},{"name":"caller_agent","in":"query","required":false,"description":"Optional identifier of the calling AI agent, IDE, or framework (e.g. 'claude-code', 'cursor', 'windsurf', 'coinbase-agentkit', 'elizaos', 'langchain', 'chatgpt', 'gemini', 'openclaw', 'custom-agent'). Omitted or invalid values never block a call (inferred from known client headers or 'unspecified'). Lowercase slug only; never include personal names, emails, or secrets. Optional over REST and MCP.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9._/-]{1,47}$","maxLength":48}},{"name":"requester_role","in":"query","required":false,"description":"Optional: high-level role category of the requester or system running this check (closed enum; no personal data). Optional over REST and MCP.","schema":{"type":"string","enum":["autonomous_agent","defi_developer","risk_curator_analyst","security_researcher","protocol_team","institutional_allocator","individual_user"]}},{"name":"caller_purpose","in":"query","required":false,"description":"Optional: operational workflow context for this pre-execution check (closed enum). Optional over REST and MCP.","schema":{"type":"string","enum":["pre_trade_safety","collateral_due_diligence","yield_allocation","security_audit","governance_monitoring","integration_testing","general_research"]}}],"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","required":["schema","tier","wallet","address","custody","blocks","summary","positions","topAdverseGapPreview"],"properties":{"schema":{"const":"pacta.wallet_exposure.v1"},"tier":{"type":"string","enum":["free_summary","x402_full"]},"wallet":{"type":"string"},"address":{"type":"string"},"custody":{"type":"object","required":["isSafe","chains","threshold","ownerCount"],"properties":{"isSafe":{"type":"boolean"},"chains":{"type":"array","items":{"type":"string"}},"threshold":{"type":["integer","null"]},"ownerCount":{"type":["integer","null"]}}},"blocks":{"type":"object","required":["ethereum","base"],"properties":{"ethereum":{"anyOf":[{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},{"type":"null"}]},"base":{"anyOf":[{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},{"type":"null"}]}}},"summary":{"type":"object","required":["totalPositions","alignedCount","protectiveCount","adverseGapCount","observedCount","portfolioRiskScore","grade","shortestExitWindowSec","headline"],"properties":{"totalPositions":{"type":"integer"},"alignedCount":{"type":"integer"},"protectiveCount":{"type":"integer"},"adverseGapCount":{"type":"integer"},"observedCount":{"type":"integer"},"portfolioRiskScore":{"type":"integer","minimum":0,"maximum":100},"grade":{"type":"string","enum":["A","B","C","D","F"]},"shortestExitWindowSec":{"type":["integer","null"]},"headline":{"type":"string"}}},"positions":{"type":"array","items":{"type":"object","required":["chain","chainId","tokenAddress","symbol","decimals","rawBalance","formattedBalance","slug","protocolName","status","classification","easAttested","scorecardUrl"],"properties":{"chain":{"type":"string","enum":["ethereum","base"]},"chainId":{"type":"integer"},"tokenAddress":{"type":"string"},"symbol":{"type":"string"},"onchainSymbol":{"type":"string"},"decimals":{"type":"integer"},"rawBalance":{"type":"string"},"formattedBalance":{"type":"string"},"slug":{"type":"string"},"protocolName":{"type":"string"},"status":{"type":"string","enum":["ALIGNED","PROTECTIVE","DELTA","OBSERVED"]},"classification":{"type":"string"},"easAttested":{"type":"boolean"},"pinnedBlock":{"type":["integer","null"]},"observedDelaySeconds":{"type":["integer","null"]},"documentedDelaySeconds":{"type":["integer","null"]},"baseEasUids":{"type":"array","items":{"type":"string"}},"scorecardUrl":{"type":"string"}}}},"topAdverseGapPreview":{"type":["object","null"]},"lockedFlaggedPositionsCount":{"type":"integer"}}}}}},"400":{"description":"Invalid input (with usage)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required (only when pricingMode is x402_paid)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or feed unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"check_wallet_exposure_post","summary":"Read-only Multicall3 wallet & Gnosis Safe DeFi control-plane exposure scan across Ethereum and Base","description":"Read-only Multicall3 wallet & Gnosis Safe DeFi control-plane exposure scan across Ethereum and Base: Safe threshold/owners detection, ERC-20 / ERC-4626 / MetaMorpho balanceOf + symbol/decimals verification across 313 indexed protocols, portfolio 0-100 risk score, shortest exit window, position roster, and the #1 highest-urgency adverse control-plane gap breakdown with Base EAS UID. Same parameters as a JSON body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet or Gnosis Safe 0x address to scan (read-only Multicall3; never logged in public telemetry)"},"chain":{"type":"string","enum":["ethereum","base","all"],"default":"all","description":"Chains to scan: all (default, Ethereum + Base in parallel), ethereum, or base"},"caller_agent":{"type":"string","pattern":"^[a-z0-9][a-z0-9._/-]{1,47}$","maxLength":48,"description":"Optional identifier of the calling AI agent, IDE, or framework (e.g. 'claude-code', 'cursor', 'windsurf', 'coinbase-agentkit', 'elizaos', 'langchain', 'chatgpt', 'gemini', 'openclaw', 'custom-agent'). Omitted or invalid values never block a call (inferred from known client headers or 'unspecified'). Lowercase slug only; never include personal names, emails, or secrets."},"requester_role":{"type":"string","enum":["autonomous_agent","defi_developer","risk_curator_analyst","security_researcher","protocol_team","institutional_allocator","individual_user"],"description":"Optional: high-level role category of the requester or system running this check (closed enum; no personal data)."},"caller_purpose":{"type":"string","enum":["pre_trade_safety","collateral_due_diligence","yield_allocation","security_audit","governance_monitoring","integration_testing","general_research"],"description":"Optional: operational workflow context for this pre-execution check (closed enum)."}},"additionalProperties":false,"required":["address"]}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","required":["schema","tier","wallet","address","custody","blocks","summary","positions","topAdverseGapPreview"],"properties":{"schema":{"const":"pacta.wallet_exposure.v1"},"tier":{"type":"string","enum":["free_summary","x402_full"]},"wallet":{"type":"string"},"address":{"type":"string"},"custody":{"type":"object","required":["isSafe","chains","threshold","ownerCount"],"properties":{"isSafe":{"type":"boolean"},"chains":{"type":"array","items":{"type":"string"}},"threshold":{"type":["integer","null"]},"ownerCount":{"type":["integer","null"]}}},"blocks":{"type":"object","required":["ethereum","base"],"properties":{"ethereum":{"anyOf":[{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},{"type":"null"}]},"base":{"anyOf":[{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},{"type":"null"}]}}},"summary":{"type":"object","required":["totalPositions","alignedCount","protectiveCount","adverseGapCount","observedCount","portfolioRiskScore","grade","shortestExitWindowSec","headline"],"properties":{"totalPositions":{"type":"integer"},"alignedCount":{"type":"integer"},"protectiveCount":{"type":"integer"},"adverseGapCount":{"type":"integer"},"observedCount":{"type":"integer"},"portfolioRiskScore":{"type":"integer","minimum":0,"maximum":100},"grade":{"type":"string","enum":["A","B","C","D","F"]},"shortestExitWindowSec":{"type":["integer","null"]},"headline":{"type":"string"}}},"positions":{"type":"array","items":{"type":"object","required":["chain","chainId","tokenAddress","symbol","decimals","rawBalance","formattedBalance","slug","protocolName","status","classification","easAttested","scorecardUrl"],"properties":{"chain":{"type":"string","enum":["ethereum","base"]},"chainId":{"type":"integer"},"tokenAddress":{"type":"string"},"symbol":{"type":"string"},"onchainSymbol":{"type":"string"},"decimals":{"type":"integer"},"rawBalance":{"type":"string"},"formattedBalance":{"type":"string"},"slug":{"type":"string"},"protocolName":{"type":"string"},"status":{"type":"string","enum":["ALIGNED","PROTECTIVE","DELTA","OBSERVED"]},"classification":{"type":"string"},"easAttested":{"type":"boolean"},"pinnedBlock":{"type":["integer","null"]},"observedDelaySeconds":{"type":["integer","null"]},"documentedDelaySeconds":{"type":["integer","null"]},"baseEasUids":{"type":"array","items":{"type":"string"}},"scorecardUrl":{"type":"string"}}}},"topAdverseGapPreview":{"type":["object","null"]},"lockedFlaggedPositionsCount":{"type":"integer"}}}}}},"400":{"description":"Invalid input (with usage)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required (only when pricingMode is x402_paid)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or feed unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/protocols/lookup":{"get":{"operationId":"protocols_lookup","summary":"Free protocol / token lookup (in memory, no RPC; free in every pricing mode)","description":"Resolve a protocol or token name, symbol, slug or 0x address to Pacta's verified record: canonical slug and URL, checksummed primary contract and controller, classification with its evidence basis (eas_attested vs rpc_observed, documentationComparison not_assessed), and preflightArgs {chain, address} ready for /v1/check/preflight. Unknown parameters are rejected (400 invalid_input).","parameters":[{"name":"q","in":"query","required":false,"description":"Name, token symbol, slug or 0x address (<= 80 chars; empty or * lists the catalog). Alias: query.","schema":{"type":"string","maxLength":80}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["ethereum","base","eip155:1","eip155:8453"]}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["protocol","brief","all"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":333}},{"name":"caller_agent","in":"query","required":false,"description":"Optional identifier of the calling AI agent, IDE, or framework (e.g. 'claude-code', 'cursor', 'windsurf', 'coinbase-agentkit', 'elizaos', 'langchain', 'chatgpt', 'gemini', 'openclaw', 'custom-agent'). Omitted or invalid values never block a call (inferred from known client headers or 'unspecified'). Lowercase slug only; never include personal names, emails, or secrets. Optional.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9._/-]{1,47}$","maxLength":48}},{"name":"requester_role","in":"query","required":false,"description":"Optional: high-level role category of the requester or system running this check (closed enum; no personal data). Optional.","schema":{"type":"string","enum":["autonomous_agent","defi_developer","risk_curator_analyst","security_researcher","protocol_team","institutional_allocator","individual_user"]}},{"name":"caller_purpose","in":"query","required":false,"description":"Optional: operational workflow context for this pre-execution check (closed enum). Optional.","schema":{"type":"string","enum":["pre_trade_safety","collateral_due_diligence","yield_allocation","security_audit","governance_monitoring","integration_testing","general_research"]}}],"responses":{"200":{"description":"pacta.protocol_lookup.v1","content":{"application/json":{"schema":{"type":"object","required":["schema","query","totalCatalog","results"],"properties":{"citationFooter":{"type":"string","description":"Present when a protocol matched: the first protocol result's 2-line text (record page with its Base Mainnet EAS UID, or 'RPC-observed baseline; Base Mainnet EAS: not_attested'; then the issuer paths: $0 doc-update queue, $500 Rapid Single-Gap Re-Verification pre-filled for the protocol, $2,500–$5,000 Full Dossier; payment never alters a classification). Every protocol result carries its own citationFooter; MCP also returns it as a second text content block."}}}}}},"400":{"description":"invalid_input (overlong query, bad chain / kind / limit, unknown parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/badges/{slug}.svg":{"get":{"operationId":"control_plane_badge","summary":"Control-plane status badge (SVG) of a published protocol; also HEAD","description":"Three tiers: Aligned · Base EAS (every record an EAS-attested aligned baseline), Parameter Delta (EAS-attested, documentation differs), RPC-Observed (RPC-pinned only; documentation not assessed). 5-minute cache, CORS *.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}}],"responses":{"200":{"description":"image/svg+xml","content":{"image/svg+xml":{"schema":{"type":"string"}}}},"404":{"description":"Unknown slug","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/x-feed":{"get":{"operationId":"x_feed","summary":"Pacta findings ready to post on X (pacta.x_feed.v1); also HEAD","description":"One item per published protocol (adverse_delta, protective_delta, aligned_baseline, rpc_observed) plus active radar timelock operations (radar_timelock), in posting priority order. mainPostText (<= 270 chars) has no links or bare domains; replyPostText carries the receipt page and the Base EAS attestation. feedId is stable. Static data, free, 5-minute cache, CORS *.","parameters":[{"name":"kind","in":"query","schema":{"type":"string","description":"Comma list of: adverse_delta, protective_delta, radar_timelock, aligned_baseline, rpc_observed"}},{"name":"slug","in":"query","schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"pacta.x_feed.v1","content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"type":"string"},"total":{"type":"integer"},"count":{"type":"integer"},"items":{"type":"array"}}}}}},"400":{"description":"invalid_input (unknown kind, bad slug or limit, unknown or repeated parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/requests":{"post":{"operationId":"submit_request","summary":"Opt-in coverage / feature request (free in every pricing mode; 5 per hour per caller)","description":"Queue a coverage or feature request (same arguments as the pacta_submit_request MCP tool). An identical request_type + target_subject upvotes the existing request and returns the same request_id. Never opens a GitHub issue and never charges. contact_handle is optional, only with the user's explicit consent, and is stored privately (never returned by any route).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","additionalProperties":false,"required":["request_type","target_subject","requested_capability","urgency_track"],"properties":{"caller_agent":{"type":"string","pattern":"^[a-z0-9][a-z0-9._/-]{1,47}$","maxLength":48,"description":"Optional identifier of the calling AI agent, IDE, or framework (e.g. 'claude-code', 'cursor', 'windsurf', 'coinbase-agentkit', 'elizaos', 'langchain', 'chatgpt', 'gemini', 'openclaw', 'custom-agent'). Omitted or invalid values never block a call (inferred from known client headers or 'unspecified'). Lowercase slug only; never include personal names, emails, or secrets."},"requester_role":{"type":"string","enum":["autonomous_agent","defi_developer","risk_curator_analyst","security_researcher","protocol_team","institutional_allocator","individual_user"],"description":"Optional: high-level role category of the requester or system running this check (closed enum; no personal data)."},"caller_purpose":{"type":"string","enum":["pre_trade_safety","collateral_due_diligence","yield_allocation","security_audit","governance_monitoring","integration_testing","general_research"],"description":"Optional: operational workflow context for this pre-execution check (closed enum)."},"request_type":{"type":"string","enum":["missing_protocol","unsupported_chain","missing_check_surface","doc_or_data_discrepancy","mcp_or_api_feature"],"description":"What is missing: a protocol, a chain, a check surface, a doc/data discrepancy, or an MCP/API feature."},"target_subject":{"type":"string","minLength":2,"maxLength":120,"description":"Protocol / token slug, chain name, or chain:0xAddress the request is about (e.g. 'pendle-v2', 'arbitrum', 'base:0x...')."},"requested_capability":{"type":"string","minLength":5,"maxLength":280,"description":"One sentence: the specific data, check or feature needed. No secrets, keys or personal data."},"urgency_track":{"type":"string","enum":["community_queue_free","active_due_diligence","issuer_24h_clearance_5k","api_high_volume_sla"],"description":"community_queue_free (default, free), active_due_diligence, issuer_24h_clearance_5k (paid issuer clearance), api_high_volume_sla."},"forum_proposal_url":{"type":"string","format":"uri","maxLength":200,"pattern":"^https://","description":"Optional https:// link to the governance forum proposal this request concerns."},"contact_handle":{"type":"string","maxLength":120,"description":"Optional work email, Telegram @handle, or GitHub handle ONLY if the human user explicitly asks for follow-up or an invoice. NEVER guess or populate without explicit user consent; never pass keys or secrets."}}}}}},"responses":{"200":{"description":"pacta.demand_receipt.v1","content":{"application/json":{"schema":{"type":"object","required":["request_id","status","demand_votes","fast_track_url"],"properties":{"schema":{"const":"pacta.demand_receipt.v1"},"request_id":{"type":"string","pattern":"^REQ-2026-[0-9a-f]{8}$"},"status":{"enum":["queued","upvoted_existing"]},"demand_votes":{"type":"integer","minimum":1},"request_type":{"enum":["missing_protocol","unsupported_chain","missing_check_surface","doc_or_data_discrepancy","mcp_or_api_feature"]},"target_subject":{"type":"string"},"urgency_track":{"enum":["community_queue_free","active_due_diligence","issuer_24h_clearance_5k","api_high_volume_sla"]},"fast_track_url":{"type":"string"},"has_contact_opt_in":{"type":"boolean"},"persisted":{"type":"boolean"},"note":{"type":"string"}}}}}},"400":{"description":"invalid_request: missing / invalid field, secret, key, HTML, personal data or placeholder contact","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Body over 4096 bytes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Not application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"More than 5 requests per hour from this caller (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/sample/preflight":{"get":{"operationId":"sample_preflight","summary":"Fixed sample preflight response (no RPC)","responses":{"200":{"description":"Sample","content":{"application/json":{"schema":{"type":"object","required":["schema","chain","chainId","address","pinnedBlock","verdict","riskScore","isContract","isProxy","implementation","hasAdminSlot","canUpgradeZeroDelay","capabilities","paused","controller","summary"],"properties":{"schema":{"const":"pacta.preflight_check.v1"},"chain":{"type":"string","enum":["ethereum","base"]},"chainId":{"type":"integer"},"address":{"type":"string"},"pinnedBlock":{"type":"integer"},"pinnedBlockHash":{"type":"string"},"blockTimestamp":{"type":"integer"},"verdict":{"type":"string","enum":["IMMUTABLE_NO_ADMIN","TIMELOCK_PROTECTED","ZERO_DELAY_TIMELOCK_RISK","MULTISIG_NO_TIMELOCK","INSTANT_EOA_ADMIN_RISK","UNDEPLOYED_OR_EOA","UNCLASSIFIED_CONTRACT_CONTROLLER"]},"riskScore":{"type":["integer","null"],"minimum":0,"maximum":100},"isContract":{"type":"boolean"},"isProxy":{"type":"boolean"},"proxyType":{"type":["string","null"],"enum":["eip1967","eip1967_beacon","eip1822",null]},"implementation":{"type":["string","null"]},"beacon":{"type":["string","null"]},"hasAdminSlot":{"type":"boolean"},"canUpgradeZeroDelay":{"type":["boolean","null"]},"capabilities":{"type":"object","properties":{"pause":{"type":"boolean"},"blacklist":{"type":"boolean"},"upgrade":{"type":"boolean"}}},"paused":{"type":["boolean","null"]},"controller":{"type":"object","properties":{"address":{"type":["string","null"]},"kind":{"type":"string","enum":["none","eoa","multisig_safe","timelock","contract","access_control_enumerable","access_control"]},"roleAdminCount":{"type":"integer"},"beacon":{"type":"string"},"proxyAdmin":{"type":"string"},"source":{"type":["string","null"]},"safeThreshold":{"type":["integer","null"]},"timelockDelaySec":{"type":["integer","null"]}}},"summary":{"type":"string"},"source":{"type":"string","enum":["live_rpc"],"description":"live_rpc: read at pinnedBlock. (An RPC outage on an indexed target returns schema pacta.preflight_catalog_fallback.v1 with source pinned_catalog_fallback instead of a 502.)"},"catalogMatch":{"type":"object","description":"Present when (chain, address) is an indexed protocol contract, controller, surface or related contract: the verified, block-pinned Pacta record (slug, url, classification, Base EAS UIDs, pinnedBlock, whatDiffers)."},"assessment":{"type":"object","required":["coverage","confidence","method","limits"],"description":"Confidence framing for riskScore","properties":{"coverage":{"type":"string","enum":["indexed_verified","unindexed_bytecode_heuristic"]},"confidence":{"type":"string","enum":["high","medium","low"]},"method":{"type":"string"},"limits":{"type":"array","items":{"type":"string"}}}},"activeGovernanceDiscussions":{"type":"array","maxItems":5,"description":"Optional: present only when the address is indexed in the Pacta forum digest (read-only Discourse summary); newest lastPostedAt first","items":{"type":"object","required":["forum","topicId","title","url","lastPostedAt"],"properties":{"forum":{"type":"string"},"topicId":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string"},"lastPostedAt":{"type":"string"}}}}}}}}}}}},"/v1/sample/control-plane":{"get":{"operationId":"sample_control_plane","summary":"Live control-plane scan of a fixed public contract","responses":{"200":{"description":"Scan","content":{"application/json":{"schema":{"type":"object","required":["chain","address","block","codeBytes","eip1967","owner","riskFlags","summary"],"properties":{"chain":{"type":"string"},"address":{"type":"string"},"block":{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},"codeBytes":{"type":"integer"},"eip1967":{"type":"object","properties":{"implementation":{"type":["string","null"]},"admin":{"type":["string","null"]},"beacon":{"type":["string","null"]}}},"owner":{"type":["string","null"]},"safe":{"type":"object"},"proxyAdmin":{"type":"object"},"upgradeAuthority":{"type":["object","null"]},"ownerPrincipal":{"type":["object","null"]},"probedStatus":{"type":"object"},"riskFlags":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"}}}}}},"502":{"description":"Upstream unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/telemetry/funnel":{"get":{"operationId":"telemetry_funnel","summary":"Per-isolate, privacy-safe usage counters","responses":{"200":{"description":"Counters","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/telemetry/summary":{"get":{"operationId":"telemetry_summary","summary":"30-day aggregate of observed client metadata (KV-backed when bound); not verified humans, not revenue","responses":{"200":{"description":"Summary (Cache-Control: no-store)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TelemetrySummary"}}}}}}},"/v1/telemetry/beacon":{"post":{"operationId":"telemetry_beacon","summary":"Site analytics beacon (navigator.sendBeacon, text/plain JSON, <= 2048 bytes)","requestBody":{"required":true,"content":{"text/plain":{"schema":{"$ref":"#/components/schemas/TelemetryBeacon"}},"application/json":{"schema":{"$ref":"#/components/schemas/TelemetryBeacon"}}}},"responses":{"204":{"description":"Counted (no body, no cookie)"},"400":{"description":"bad_beacon: unknown key, bad value, bad content type or over 2048 bytes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"More than 60 beacons per minute from this caller","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/x402/verdict":{"post":{"operationId":"x402_verdict","summary":"Fast contract / token control-plane safety verdict","description":"Fast contract / token control-plane safety verdict: verdict, riskScore 0-100 and grade A-F, a one-line verdict, upgrade / owner / pause / blacklist / mint capability flags, the controller (EOA, Safe threshold, timelock delay), the indexed Pacta record when there is one, and a shareable scan URL. One pinned block; Ethereum and Base. Always paid (every pricing mode): $0.02 USDC on Base to 0x4348DF1BEFAffcbA248B5118B1b782B1B2bdEd14. Without a payment header (or with a GET) the route answers 402 with the requirements; pay with X-PAYMENT (x402 v1) or PAYMENT-SIGNATURE (x402 v2) and POST the same JSON body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","maxLength":80,"description":"Published protocol slug (https://pacta.wtf/api/v1/lookup.json); or give chain + address"},"chain":{"type":"string","enum":["ethereum","base"]},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"target":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Alias of address (accepted so one shared directory example body fits every route); must equal address when both are given"},"calldata":{"type":"string","pattern":"^0x([0-9a-fA-F]{2})*$","maxLength":3002,"description":"Accepted and ignored on this route (shared directory example body)"},"qa_test":{"type":"boolean","description":"Internal QA / smoke test: counted as an internal canary, never as external revenue"}}},"example":{"chain":"ethereum","address":"0xA35b1B31Ce002FBF2058D22F30f95D405200A15b"}}}},"responses":{"200":{"description":"Result + receipt (X-PAYMENT-RESPONSE / PAYMENT-RESPONSE headers)","content":{"application/json":{"schema":{"type":"object","required":["schema","chain","chainId","address","block","verdict","riskScore","grade","oneLineVerdict","capabilities","controllerSummary","indexedProtocol","shareUrl"],"properties":{"schema":{"const":"pacta.x402_verdict.v1"},"chain":{"type":"string","enum":["ethereum","base"]},"chainId":{"type":"integer"},"address":{"type":"string"},"block":{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},"verdict":{"type":"string","enum":["IMMUTABLE_NO_ADMIN","TIMELOCK_PROTECTED","ZERO_DELAY_TIMELOCK_RISK","MULTISIG_NO_TIMELOCK","INSTANT_EOA_ADMIN_RISK","UNDEPLOYED_OR_EOA","UNCLASSIFIED_CONTRACT_CONTROLLER"]},"riskScore":{"type":["integer","null"],"minimum":0,"maximum":100},"grade":{"type":"string","enum":["A","B","C","D","F"]},"oneLineVerdict":{"type":"string"},"capabilities":{"type":"object","required":["upgradeable","hasOwnerOrAdmin","pause","blacklist","mint"],"properties":{"upgradeable":{"type":"boolean"},"hasOwnerOrAdmin":{"type":"boolean"},"pause":{"type":"boolean"},"blacklist":{"type":"boolean"},"mint":{"type":"boolean"}}},"controllerSummary":{"type":"object","required":["kind"],"properties":{"kind":{"type":"string","enum":["none","eoa","multisig_safe","timelock","contract","access_control_enumerable","access_control"]},"address":{"type":["string","null"]},"safeThreshold":{"type":["integer","null"]},"safeOwnerCount":{"type":["integer","null"]},"timelockDelaySec":{"type":["integer","null"]}}},"indexedProtocol":{"type":["object","null"]},"shareUrl":{"type":"string"},"supportedChains":{"type":"array","items":{"type":"string"}},"method":{"type":"string"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input (with an example)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required: v1 JSON body (network base) + base64 x402 v2 PaymentRequired in the PAYMENT-REQUIRED header (network eip155:8453)","headers":{"PAYMENT-REQUIRED":{"description":"base64 JSON x402 v2 PaymentRequired","schema":{"type":"string"}},"WWW-Authenticate":{"description":"x402 challenge: x402 realm=\"pacta\", network, asset, payTo, amount","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Unknown protocol slug","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"payment_already_used (this payment credential is bound to a different request payload) / payment_in_progress (the same payment is being settled: retry) / tx_already_used (the settlement tx is credited to another order or purchase)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Not application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or facilitator unavailable before settlement (settled: false), or settlement_outcome_unknown (settled: null: the facilitator's settle reply was lost; send the same request with the same payment header again and it is reconciled on Base before any new settle call)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"payments_disabled / ledger_unavailable (nothing charged) / settled_not_recorded or settlement_unconfirmed (settled: send the same request with the same payment header again; it resumes without a second charge)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/x402/dossier":{"post":{"operationId":"x402_dossier","summary":"Machine-readable protocol control-plane dossier","description":"Machine-readable protocol control-plane dossier: live EIP-1967 / owner / Safe reads, every controller Safe's signers and threshold, Safe signers shared with other indexed protocols (read live at the same block), and the Base EAS attestation proof. Always paid (every pricing mode): $0.05 USDC on Base to 0x4348DF1BEFAffcbA248B5118B1b782B1B2bdEd14. Without a payment header (or with a GET) the route answers 402 with the requirements; pay with X-PAYMENT (x402 v1) or PAYMENT-SIGNATURE (x402 v2) and POST the same JSON body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","maxLength":80,"description":"Published protocol slug (https://pacta.wtf/api/v1/lookup.json); or give chain + address"},"chain":{"type":"string","enum":["ethereum","base"]},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"target":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Alias of address (accepted so one shared directory example body fits every route); must equal address when both are given"},"calldata":{"type":"string","pattern":"^0x([0-9a-fA-F]{2})*$","maxLength":3002,"description":"Accepted and ignored on this route (shared directory example body)"},"qa_test":{"type":"boolean","description":"Internal QA / smoke test: counted as an internal canary, never as external revenue"}}},"example":{"slug":"aave-v3-gho"}}}},"responses":{"200":{"description":"Result + receipt (X-PAYMENT-RESPONSE / PAYMENT-RESPONSE headers)","content":{"application/json":{"schema":{"type":"object","required":["schema","chain","address","block","indexed","controlPlane","controllers","signerOverlap","easProof","summary"],"properties":{"schema":{"const":"pacta.x402_dossier.v1"},"chain":{"type":"string"},"address":{"type":"string"},"block":{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},"indexed":{"type":"boolean"},"protocol":{"type":["object","null"]},"controlPlane":{"type":"object","required":["chain","address","block","codeBytes","eip1967","owner","riskFlags","summary"],"properties":{"chain":{"type":"string"},"address":{"type":"string"},"block":{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},"codeBytes":{"type":"integer"},"eip1967":{"type":"object","properties":{"implementation":{"type":["string","null"]},"admin":{"type":["string","null"]},"beacon":{"type":["string","null"]}}},"owner":{"type":["string","null"]},"safe":{"type":"object"},"proxyAdmin":{"type":"object"},"upgradeAuthority":{"type":["object","null"]},"ownerPrincipal":{"type":["object","null"]},"probedStatus":{"type":"object"},"riskFlags":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"}}},"controllers":{"type":"array"},"signerOverlap":{"type":"object"},"easProof":{"type":"object"},"summary":{"type":"string"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input (with an example)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required: v1 JSON body (network base) + base64 x402 v2 PaymentRequired in the PAYMENT-REQUIRED header (network eip155:8453)","headers":{"PAYMENT-REQUIRED":{"description":"base64 JSON x402 v2 PaymentRequired","schema":{"type":"string"}},"WWW-Authenticate":{"description":"x402 challenge: x402 realm=\"pacta\", network, asset, payTo, amount","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Unknown protocol slug","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"payment_already_used (this payment credential is bound to a different request payload) / payment_in_progress (the same payment is being settled: retry) / tx_already_used (the settlement tx is credited to another order or purchase)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Not application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or facilitator unavailable before settlement (settled: false), or settlement_outcome_unknown (settled: null: the facilitator's settle reply was lost; send the same request with the same payment header again and it is reconciled on Base before any new settle call)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"payments_disabled / ledger_unavailable (nothing charged) / settled_not_recorded or settlement_unconfirmed (settled: send the same request with the same payment header again; it resumes without a second charge)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}},"get":{"operationId":"x402_dossier_get","summary":"Machine-readable protocol control-plane dossier","description":"Machine-readable protocol control-plane dossier: live EIP-1967 / owner / Safe reads, every controller Safe's signers and threshold, Safe signers shared with other indexed protocols (read live at the same block), and the Base EAS attestation proof. Always paid: $0.05 USDC on Base to 0x4348DF1BEFAffcbA248B5118B1b782B1B2bdEd14. Zero-input GET: every query parameter is optional; with no query it returns the built-in aave-v3-gho dossier. Without a payment header it answers 402 with the requirements.","responses":{"200":{"description":"Result + receipt (X-PAYMENT-RESPONSE / PAYMENT-RESPONSE headers)","content":{"application/json":{"schema":{"type":"object","required":["schema","chain","address","block","indexed","controlPlane","controllers","signerOverlap","easProof","summary"],"properties":{"schema":{"const":"pacta.x402_dossier.v1"},"chain":{"type":"string"},"address":{"type":"string"},"block":{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},"indexed":{"type":"boolean"},"protocol":{"type":["object","null"]},"controlPlane":{"type":"object","required":["chain","address","block","codeBytes","eip1967","owner","riskFlags","summary"],"properties":{"chain":{"type":"string"},"address":{"type":"string"},"block":{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},"codeBytes":{"type":"integer"},"eip1967":{"type":"object","properties":{"implementation":{"type":["string","null"]},"admin":{"type":["string","null"]},"beacon":{"type":["string","null"]}}},"owner":{"type":["string","null"]},"safe":{"type":"object"},"proxyAdmin":{"type":"object"},"upgradeAuthority":{"type":["object","null"]},"ownerPrincipal":{"type":["object","null"]},"probedStatus":{"type":"object"},"riskFlags":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"}}},"controllers":{"type":"array"},"signerOverlap":{"type":"object"},"easProof":{"type":"object"},"summary":{"type":"string"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input (with an example)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required: v1 JSON body (network base) + base64 x402 v2 PaymentRequired in the PAYMENT-REQUIRED header (network eip155:8453)","headers":{"PAYMENT-REQUIRED":{"description":"base64 JSON x402 v2 PaymentRequired","schema":{"type":"string"}},"WWW-Authenticate":{"description":"x402 challenge: x402 realm=\"pacta\", network, asset, payTo, amount","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Unknown protocol slug","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"payment_already_used (this payment credential is bound to a different request payload) / payment_in_progress (the same payment is being settled: retry) / tx_already_used (the settlement tx is credited to another order or purchase)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Not application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or facilitator unavailable before settlement (settled: false), or settlement_outcome_unknown (settled: null: the facilitator's settle reply was lost; send the same request with the same payment header again and it is reconciled on Base before any new settle call)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"payments_disabled / ledger_unavailable (nothing charged) / settled_not_recorded or settlement_unconfirmed (settled: send the same request with the same payment header again; it resumes without a second charge)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"parameters":[{"name":"slug","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","maxLength":80,"description":"Optional protocol slug; omit for built-in Aave V3 / GHO Base-EAS dossier."}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["ethereum","base"]}},{"name":"address","in":"query","required":false,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}]},"x-methods":["GET","POST"]},"/v1/x402/calldata-sim":{"post":{"operationId":"x402_calldata_sim","summary":"Pre-execution calldata check","description":"Pre-execution calldata check: decodes the selector (unwrapping TimelockController schedule / execute (batch), Safe execTransaction and multicall), classifies each action (upgrade, role / ownership, Safe config, delay, pause, funds) and returns a deterministic risk verdict against the live delays of the targets. Always paid (every pricing mode): $0.25 USDC on Base to 0x4348DF1BEFAffcbA248B5118B1b782B1B2bdEd14. Without a payment header (or with a GET) the route answers 402 with the requirements; pay with X-PAYMENT (x402 v1) or PAYMENT-SIGNATURE (x402 v2) and POST the same JSON body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["chain"],"anyOf":[{"required":["address"]},{"required":["target"]}],"properties":{"chain":{"type":"string","enum":["ethereum","base"]},"target":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Alias of target; must equal target when both are given"},"data":{"type":"string","pattern":"^0x([0-9a-fA-F]{2})*$","maxLength":3002,"description":"Calldata to check (default 0x8da5cb5b, owner(), when neither data nor calldata is given)"},"calldata":{"type":"string","pattern":"^0x([0-9a-fA-F]{2})*$","maxLength":3002,"description":"Alias of data; must equal data when both are given"},"timelock":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Optional TimelockController the call is routed through (lowers a rating only when live reads prove it is the authority for that action: the ProxyAdmin owner / admin for upgrades, owner() for UUPS upgrades and for role / pause / config changes)"},"qa_test":{"type":"boolean","description":"Internal QA / smoke test: counted as an internal canary, never as external revenue"}}},"example":{"chain":"ethereum","target":"0x2225DAbFfC7F862c99477381E971E8B1FDaB467e","data":"0x64d623530000000000000000000000000000000000000000000000000000000000015180"}}}},"responses":{"200":{"description":"Result + receipt (X-PAYMENT-RESPONSE / PAYMENT-RESPONSE headers)","content":{"application/json":{"schema":{"type":"object","required":["schema","chain","block","target","actions","verdict"],"properties":{"schema":{"const":"pacta.calldata_sim.v1"},"chain":{"type":"string"},"block":{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},"target":{"type":"string"},"timelock":{"type":["object","null"]},"liveTargets":{"type":"object"},"actions":{"type":"array"},"verdict":{"type":"object","properties":{"level":{"type":"string","enum":["low","medium","high","critical"]},"block":{"type":"boolean"},"mutations":{"type":"object"},"reasons":{"type":"array"}}},"limits":{"type":"array"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input (with an example)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required: v1 JSON body (network base) + base64 x402 v2 PaymentRequired in the PAYMENT-REQUIRED header (network eip155:8453)","headers":{"PAYMENT-REQUIRED":{"description":"base64 JSON x402 v2 PaymentRequired","schema":{"type":"string"}},"WWW-Authenticate":{"description":"x402 challenge: x402 realm=\"pacta\", network, asset, payTo, amount","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Unknown protocol slug","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"payment_already_used (this payment credential is bound to a different request payload) / payment_in_progress (the same payment is being settled: retry) / tx_already_used (the settlement tx is credited to another order or purchase)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Not application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or facilitator unavailable before settlement (settled: false), or settlement_outcome_unknown (settled: null: the facilitator's settle reply was lost; send the same request with the same payment header again and it is reconciled on Base before any new settle call)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"payments_disabled / ledger_unavailable (nothing charged) / settled_not_recorded or settlement_unconfirmed (settled: send the same request with the same payment header again; it resumes without a second charge)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]}}},"/v1/x402/deep-scan":{"post":{"operationId":"x402_deep_scan","summary":"Deep control-plane inspection of one contract","description":"Deep control-plane inspection of one contract: EIP-1967 / beacon / UUPS, owner, Safe signers and guard, TimelockController delay, AccessControl admin members and RolesAuthority authority(), pinned to one block and cross-checked on a second RPC endpoint; returns a structured auditor receipt (sha256 of the findings) and a queued Base EAS attestation ticket. Always paid (every pricing mode): $9.00 USDC on Base to 0x4348DF1BEFAffcbA248B5118B1b782B1B2bdEd14. Without a payment header (or with a GET) the route answers 402 with the requirements; pay with X-PAYMENT (x402 v1) or PAYMENT-SIGNATURE (x402 v2) and POST the same JSON body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["chain"],"anyOf":[{"required":["address"]},{"required":["target"]}],"properties":{"chain":{"type":"string","enum":["ethereum","base"]},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"target":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Alias of address; must equal address when both are given"},"calldata":{"type":"string","pattern":"^0x([0-9a-fA-F]{2})*$","maxLength":3002,"description":"Accepted and ignored on this route (shared directory example body)"},"docs_url":{"type":"string","format":"uri","maxLength":300,"description":"Optional https documentation URL for the EAS docs comparison (recorded, not fetched)"},"qa_test":{"type":"boolean","description":"Internal QA / smoke test: counted as an internal canary, never as external revenue"}}},"example":{"chain":"base","address":"0x35D21Bb4Df6586FE7759b5e57263ffeB3e1fd872"}}}},"responses":{"200":{"description":"Result + receipt (X-PAYMENT-RESPONSE / PAYMENT-RESPONSE headers)","content":{"application/json":{"schema":{"type":"object","required":["schema","chain","address","block","findings","auditorReceipt","easTicket"],"properties":{"schema":{"const":"pacta.deep_scan.v1"},"chain":{"type":"string"},"address":{"type":"string"},"block":{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},"docsUrl":{"type":["string","null"]},"findings":{"type":"object"},"auditorReceipt":{"type":"object"},"easTicket":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input (with an example)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required: v1 JSON body (network base) + base64 x402 v2 PaymentRequired in the PAYMENT-REQUIRED header (network eip155:8453)","headers":{"PAYMENT-REQUIRED":{"description":"base64 JSON x402 v2 PaymentRequired","schema":{"type":"string"}},"WWW-Authenticate":{"description":"x402 challenge: x402 realm=\"pacta\", network, asset, payTo, amount","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Unknown protocol slug","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"payment_already_used (this payment credential is bound to a different request payload) / payment_in_progress (the same payment is being settled: retry) / tx_already_used (the settlement tx is credited to another order or purchase)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Not application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or facilitator unavailable before settlement (settled: false), or settlement_outcome_unknown (settled: null: the facilitator's settle reply was lost; send the same request with the same payment header again and it is reconciled on Base before any new settle call)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"payments_disabled / ledger_unavailable (nothing charged) / settled_not_recorded or settlement_unconfirmed (settled: send the same request with the same payment header again; it resumes without a second charge)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"9.00"},"protocols":[{"x402":{}}]}}},"/v1/x402/wallet-exposure":{"post":{"operationId":"x402_wallet_exposure","summary":"Full multi-position wallet & Gnosis Safe DeFi control-plane exposure graph across Ethereum and Base","description":"Full multi-position wallet & Gnosis Safe DeFi control-plane exposure graph across Ethereum and Base: documented-vs-observed breakdowns across all held parameter_delta and rpc_observed positions, cross-position controller & ecosystem contagion overlap, Safe threshold signing latency vs protocol timelock exit-window warnings, and a SHA-256 auditor receipt. Always paid (every pricing mode): $0.05 USDC on Base to 0x4348DF1BEFAffcbA248B5118B1b782B1B2bdEd14. Without a payment header (or with a GET) the route answers 402 with the requirements; pay with X-PAYMENT (x402 v1) or PAYMENT-SIGNATURE (x402 v2) and POST the same JSON body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"anyOf":[{"required":["address"]},{"required":["wallet"]},{"required":["target"]}],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"wallet":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Alias of address (wallet or Gnosis Safe 0x address to scan); must equal address when both are given"},"target":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Alias of address (accepted so one shared directory example body fits every route); must equal address when both are given"},"chain":{"type":"string","enum":["ethereum","base","all"],"description":"Chains to scan via Multicall3 (default: all = Ethereum + Base in parallel)"},"calldata":{"type":"string","pattern":"^0x([0-9a-fA-F]{2})*$","maxLength":3002,"description":"Accepted and ignored on this route (shared directory example body)"},"qa_test":{"type":"boolean","description":"Internal QA / smoke test: counted as an internal canary, never as external revenue"}}},"example":{"address":"0xcA4E2ff22B69A7284210c47BdeE21Aac1269da09"}}}},"responses":{"200":{"description":"Result + receipt (X-PAYMENT-RESPONSE / PAYMENT-RESPONSE headers)","content":{"application/json":{"schema":{"type":"object","required":["schema","tier","wallet","address","custody","blocks","summary","positions","topAdverseGapPreview","positionDossiers","controllerOverlap","exitWindowWarnings","auditorReceipt"],"properties":{"schema":{"const":"pacta.wallet_exposure.v1"},"tier":{"type":"string","enum":["free_summary","x402_full"]},"wallet":{"type":"string"},"address":{"type":"string"},"custody":{"type":"object","required":["isSafe","chains","threshold","ownerCount"],"properties":{"isSafe":{"type":"boolean"},"chains":{"type":"array","items":{"type":"string"}},"threshold":{"type":["integer","null"]},"ownerCount":{"type":["integer","null"]}}},"blocks":{"type":"object","required":["ethereum","base"],"properties":{"ethereum":{"anyOf":[{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},{"type":"null"}]},"base":{"anyOf":[{"type":"object","required":["number","hash","timestamp"],"properties":{"number":{"type":"integer"},"hash":{"type":"string"},"timestamp":{"type":"integer"}}},{"type":"null"}]}}},"summary":{"type":"object","required":["totalPositions","alignedCount","protectiveCount","adverseGapCount","observedCount","portfolioRiskScore","grade","shortestExitWindowSec","headline"],"properties":{"totalPositions":{"type":"integer"},"alignedCount":{"type":"integer"},"protectiveCount":{"type":"integer"},"adverseGapCount":{"type":"integer"},"observedCount":{"type":"integer"},"portfolioRiskScore":{"type":"integer","minimum":0,"maximum":100},"grade":{"type":"string","enum":["A","B","C","D","F"]},"shortestExitWindowSec":{"type":["integer","null"]},"headline":{"type":"string"}}},"positions":{"type":"array","items":{"type":"object","required":["chain","chainId","tokenAddress","symbol","decimals","rawBalance","formattedBalance","slug","protocolName","status","classification","easAttested","scorecardUrl"],"properties":{"chain":{"type":"string","enum":["ethereum","base"]},"chainId":{"type":"integer"},"tokenAddress":{"type":"string"},"symbol":{"type":"string"},"onchainSymbol":{"type":"string"},"decimals":{"type":"integer"},"rawBalance":{"type":"string"},"formattedBalance":{"type":"string"},"slug":{"type":"string"},"protocolName":{"type":"string"},"status":{"type":"string","enum":["ALIGNED","PROTECTIVE","DELTA","OBSERVED"]},"classification":{"type":"string"},"easAttested":{"type":"boolean"},"pinnedBlock":{"type":["integer","null"]},"observedDelaySeconds":{"type":["integer","null"]},"documentedDelaySeconds":{"type":["integer","null"]},"baseEasUids":{"type":"array","items":{"type":"string"}},"scorecardUrl":{"type":"string"}}}},"topAdverseGapPreview":{"type":["object","null"]},"lockedFlaggedPositionsCount":{"type":"integer"},"positionDossiers":{"type":"array","items":{"type":"object"}},"controllerOverlap":{"type":"object","required":["hasContagionRisk","sharedControllers","sharedEcosystemDependencies","summary"],"properties":{"hasContagionRisk":{"type":"boolean"},"sharedControllers":{"type":"array","items":{"type":"object"}},"sharedEcosystemDependencies":{"type":"array","items":{"type":"object"}},"summary":{"type":"string"}}},"exitWindowWarnings":{"type":"array","items":{"type":"object"}},"auditorReceipt":{"type":"object","required":["resultSha256","generatedAtBlocks"],"properties":{"resultSha256":{"type":"string"},"generatedAtBlocks":{"type":"object"}}},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input (with an example)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required: v1 JSON body (network base) + base64 x402 v2 PaymentRequired in the PAYMENT-REQUIRED header (network eip155:8453)","headers":{"PAYMENT-REQUIRED":{"description":"base64 JSON x402 v2 PaymentRequired","schema":{"type":"string"}},"WWW-Authenticate":{"description":"x402 challenge: x402 realm=\"pacta\", network, asset, payTo, amount","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Unknown protocol slug","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"payment_already_used (this payment credential is bound to a different request payload) / payment_in_progress (the same payment is being settled: retry) / tx_already_used (the settlement tx is credited to another order or purchase)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Not application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream RPC or facilitator unavailable before settlement (settled: false), or settlement_outcome_unknown (settled: null: the facilitator's settle reply was lost; send the same request with the same payment header again and it is reconciled on Base before any new settle call)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"payments_disabled / ledger_unavailable (nothing charged) / settled_not_recorded or settlement_unconfirmed (settled: send the same request with the same payment header again; it resumes without a second charge)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/v1/orders/verify":{"post":{"operationId":"orders_verify","summary":"Verify a Base USDC payment for a self-serve order and unlock it","description":"Send USDC on Base to 0x4348DF1BEFAffcbA248B5118B1b782B1B2bdEd14, then POST the tx hash. Two independent Base RPC operators must return the receipt (status 0x1, a valid tx sender, the same block, depth >= 1) with canonical USDC Transfer logs to the treasury summing to at least the SKU price (fail closed). A tx unlocks one order (same body again = the same receipt; a different body = 409 tx_already_used). instant-scan-19 returns the live report in the response. webhook_or_contact is stored privately and never returned by any route.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["sku","tx_hash"],"properties":{"sku":{"type":"string","enum":["wallet-report-9","instant-scan-19","radar-webhook-49","reverify-seal-99","rapid-500","dossier-2500"]},"tx_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"chain":{"const":"base"},"target_chain":{"type":"string","enum":["ethereum","base"]},"target_address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"protocol_or_docs":{"type":"string","maxLength":300},"webhook_or_contact":{"type":"string","maxLength":300,"description":"Private (KV only); never exposed"},"qa_test":{"type":"boolean"}}}}}},"responses":{"200":{"description":"pacta.order_receipt.v1: the canonical, write-once receipt (byte-identical for every caller of this order)","headers":{"Pacta-Idempotent-Replay":{"description":"true when this order had been recorded before this request","schema":{"type":"string","enum":["true","false"]}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"invalid_order","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_amount / tx_failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"tx_not_found (retry: not mined or not indexed yet)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"tx_already_used / providers_disagree (both providers confirm the same block but differ on the payer or the transfers)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Not application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"425":{"description":"tx_not_confirmed (depth < 1, only one provider has the receipt yet, or the providers have not converged on its status or block: retry)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"order_rpc_unavailable (fewer than two independent Base providers answered, or a receipt without a valid tx sender)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"orders_unavailable (no KV / PACTA_LEDGER_DO binding) / report_unavailable / order_not_recorded / order_not_settled (send the same request again)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-skus":{"wallet-report-9":{"priceUsdc":"9.00","atomic":"9000000","title":"Full Wallet & Safe Control-Plane Exposure Report"},"instant-scan-19":{"priceUsdc":"19.00","atomic":"19000000","title":"Instant live contract / Safe control-plane deep-scan"},"radar-webhook-49":{"priceUsdc":"49.00","atomic":"49000000","title":"30-day timelock & signer-rotation webhook alert feed"},"reverify-seal-99":{"priceUsdc":"99.00","atomic":"99000000","title":"24 h mainnet control-plane seal (intro first-5)"},"rapid-500":{"priceUsdc":"500.00","atomic":"500000000","title":"Multi-contract 24 h SLA re-verification"},"dossier-2500":{"priceUsdc":"2500.00","atomic":"2500000000","title":"Full single-chain protocol control-plane dossier (up to 8 contracts)"}}}},"/v1/orders/public-stats":{"get":{"operationId":"orders_public_stats","summary":"Aggregate settled-order counters (external revenue only; internal canaries apart)","responses":{"200":{"description":"pacta.orders_public_stats.v1 (Cache-Control: no-store)","content":{"application/json":{"schema":{"type":"object","required":["settledExternalOrders","settledExternalUsdc","internalCanaryCount"],"properties":{"settledExternalOrders":{"type":"integer"},"settledExternalUsdc":{"type":"string"},"internalCanaryCount":{"type":"integer"},"x402":{"type":"object"}}}}}}}}},"/health":{"get":{"operationId":"health","summary":"Service status, pricing mode and prices","responses":{"200":{"description":"Status","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"detail":{"type":"string"},"usage":{"type":"object"}}},"TelemetrySummary":{"type":"object","required":["schema","generatedAt","pricingMode","scope","kv","totals","actors","crawlers","programmatic","mcp","routes","contracts","cache","latencyMs","callers","beacon","beaconInternal","callerAttribution","unindexedIntentSignals","submittedRequests","daily","hourly"],"properties":{"schema":{"const":"pacta.telemetry_summary.v1"},"generatedAt":{"type":"string"},"pricingMode":{"type":"string","enum":["free_launch","x402_paid"]},"scope":{"const":"Observed client metadata (User-Agent families, MCP clientInfo, beacon events). Not verified humans, not revenue."},"kv":{"type":"object","required":["bound","lastFlushAt","flushes","flushIntervalSec"],"properties":{"bound":{"type":"boolean"},"lastFlushAt":{"type":["string","null"]},"flushes":{"type":"integer"},"flushIntervalSec":{"type":"integer","minimum":120},"debounceMs":{"const":2500},"highSignalFlushMs":{"const":5000},"flushErrors":{"type":"integer"},"readOk":{"type":"boolean"}}},"totals":{"type":"object","required":["requests","ok200","rateLimited429"],"properties":{"requests":{"type":"integer","minimum":0},"ok200":{"type":"integer","minimum":0},"rateLimited429":{"type":"integer","minimum":0}}},"actors":{"type":"object","required":["human_browser","ai_search_crawler","mcp_client","programmatic_agent","unknown"],"properties":{"human_browser":{"type":"integer","minimum":0},"ai_search_crawler":{"type":"integer","minimum":0},"mcp_client":{"type":"integer","minimum":0},"programmatic_agent":{"type":"integer","minimum":0},"unknown":{"type":"integer","minimum":0}}},"crawlers":{"type":"object","required":["GPTBot","OAI-SearchBot","ChatGPT-User","ClaudeBot","PerplexityBot","Google-Extended","CCBot"],"properties":{"GPTBot":{"type":"integer","minimum":0},"OAI-SearchBot":{"type":"integer","minimum":0},"ChatGPT-User":{"type":"integer","minimum":0},"ClaudeBot":{"type":"integer","minimum":0},"PerplexityBot":{"type":"integer","minimum":0},"Google-Extended":{"type":"integer","minimum":0},"CCBot":{"type":"integer","minimum":0}}},"programmatic":{"type":"object","required":["x402","viem","ethers","python","node","curl","other"],"properties":{"x402":{"type":"integer","minimum":0},"viem":{"type":"integer","minimum":0},"ethers":{"type":"integer","minimum":0},"python":{"type":"integer","minimum":0},"node":{"type":"integer","minimum":0},"curl":{"type":"integer","minimum":0},"other":{"type":"integer","minimum":0}}},"mcp":{"type":"object","required":["initialize","toolsList","clients","tools","byCallerAgent","toolsCallOk","toolsCallAttrRejected","toolsCallUnattributed"],"properties":{"initialize":{"type":"integer"},"byCallerAgent":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":51,"description":"/mcp tools/call only (never REST): valid caller_agent slugs or inferred client slugs (else 'unspecified')"},"toolsCallOk":{"type":"integer","minimum":0,"description":"/mcp tools/call dispatched"},"toolsCallAttrRejected":{"type":"integer","minimum":0,"description":"Legacy counter (always 0 since caller attribution became strictly optional; retained for 30-day KV compatibility)"},"toolsCallUnattributed":{"type":"integer","minimum":0,"description":"/mcp tools/call dispatched with omitted or invalid optional caller attribution fields"},"toolsList":{"type":"integer","minimum":0,"description":"tools/list JSON-RPC requests (registry crawlers and health probes included; not unique users)"},"tools":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"clients":{"type":"object","maxProperties":256,"additionalProperties":{"type":"object","properties":{"initialize":{"type":"integer"},"versions":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256}}}}}},"routes":{"type":"object","additionalProperties":{"type":"object","required":["requests","ok200"],"properties":{"requests":{"type":"integer","minimum":0},"ok200":{"type":"integer","minimum":0}}}},"contracts":{"type":"array","maxItems":256,"items":{"type":"object","required":["key","count"],"properties":{"key":{"type":"string"},"count":{"type":"integer"}}}},"cache":{"type":"object","required":["HIT","MISS","BYPASS"],"properties":{"HIT":{"type":"integer","minimum":0},"MISS":{"type":"integer","minimum":0},"BYPASS":{"type":"integer","minimum":0}}},"latencyMs":{"type":"object","required":["lt50","lt250","lt1000","ge1000"],"properties":{"lt50":{"type":"integer","minimum":0},"lt250":{"type":"integer","minimum":0},"lt1000":{"type":"integer","minimum":0},"ge1000":{"type":"integer","minimum":0}}},"callers":{"type":"object","required":["unique","repeat2","repeat10"],"properties":{"unique":{"type":"integer","minimum":0},"repeat2":{"type":"integer","minimum":0},"repeat10":{"type":"integer","minimum":0}}},"beacon":{"type":"object","required":["events","paths","referrers","utm","targets","notFound","origins","utmMedium","utmCampaign","hosts"],"properties":{"events":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"paths":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"referrers":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"utm":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"targets":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"notFound":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"origins":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"utmMedium":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"utmCampaign":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"hosts":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256}}},"beaconInternal":{"type":"object","required":["events","paths","targets"],"description":"Opt-in Founder / internal QA beacons (?internal=1), strictly excluded from external beacon funnel maps","properties":{"events":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"paths":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"targets":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256}}},"callerAttribution":{"type":"object","required":["byCountry","byContinent","byCallerAgent","byRequesterRole","byCallerPurpose"],"description":"Cloudflare edge country / continent (cf.country, cf.continent) + self-reported MCP caller slug / closed enums; no IP or PII stored","properties":{"byCountry":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":260},"byContinent":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":10},"byCallerAgent":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":51},"byRequesterRole":{"type":"object","required":["autonomous_agent","defi_developer","risk_curator_analyst","security_researcher","protocol_team","institutional_allocator","individual_user"],"properties":{"autonomous_agent":{"type":"integer","minimum":0},"defi_developer":{"type":"integer","minimum":0},"risk_curator_analyst":{"type":"integer","minimum":0},"security_researcher":{"type":"integer","minimum":0},"protocol_team":{"type":"integer","minimum":0},"institutional_allocator":{"type":"integer","minimum":0},"individual_user":{"type":"integer","minimum":0}}},"byCallerPurpose":{"type":"object","required":["pre_trade_safety","collateral_due_diligence","yield_allocation","security_audit","governance_monitoring","integration_testing","general_research"],"properties":{"pre_trade_safety":{"type":"integer","minimum":0},"collateral_due_diligence":{"type":"integer","minimum":0},"yield_allocation":{"type":"integer","minimum":0},"security_audit":{"type":"integer","minimum":0},"governance_monitoring":{"type":"integer","minimum":0},"integration_testing":{"type":"integer","minimum":0},"general_research":{"type":"integer","minimum":0}}},"internalQaCalls":{"type":"integer","minimum":0,"description":"Calls tagged caller_agent=pacta-founder-qa (excluded from external role/purpose & contract demand KPIs)"}}},"unindexedIntentSignals":{"type":"object","required":["totalUnindexedQueries","uniqueTargets","signals","hotSignals"],"description":"Dark-funnel intent radar: unmatched lookups and pre-flights of unindexed addresses; aggregate counts, no IP / header / JWT / PII","properties":{"totalUnindexedQueries":{"type":"integer","minimum":0},"uniqueTargets":{"type":"integer","minimum":0},"signals":{"type":"array","maxItems":100,"items":{"type":"object","required":["kind","chain","target","count","requesterRoles","callerPurposes","firstSeenAt","lastSeenAt"],"properties":{"kind":{"enum":["unindexed_address","unmatched_lookup"]},"chain":{"enum":["ethereum","base","any"]},"target":{"type":"string","maxLength":64},"count":{"type":"integer","minimum":1},"requesterRoles":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"callerPurposes":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"firstSeenAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]}}}},"hotSignals":{"type":"array","maxItems":100}}},"submittedRequests":{"type":"object","required":["totalRequests","totalVotes","items"],"description":"Opt-in demand queue (pacta_submit_request / POST /v1/requests): public fields only, never a contact handle","properties":{"totalRequests":{"type":"integer","minimum":0},"totalVotes":{"type":"integer","minimum":0},"items":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":false,"required":["request_id","request_type","target_subject","requested_capability","demand_votes","urgency_track","requester_role","has_contact_opt_in","first_requested_at","last_requested_at"],"properties":{"request_id":{"type":"string","pattern":"^REQ-2026-[0-9a-f]{8}$"},"request_type":{"enum":["missing_protocol","unsupported_chain","missing_check_surface","doc_or_data_discrepancy","mcp_or_api_feature"]},"target_subject":{"type":"string","maxLength":120},"requested_capability":{"type":"string","maxLength":280},"demand_votes":{"type":"integer","minimum":1},"urgency_track":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"requester_role":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"has_contact_opt_in":{"type":"boolean"},"first_requested_at":{"type":["string","null"]},"last_requested_at":{"type":["string","null"]}}}},"scope":{"type":"string"}}},"daily":{"type":"object","maxProperties":30,"additionalProperties":{"type":"object","required":["requests","actors","beaconEvents","beaconInternalEvents"],"properties":{"requests":{"type":"integer"},"actors":{"type":"object","required":["human_browser","ai_search_crawler","mcp_client","programmatic_agent","unknown"],"properties":{"human_browser":{"type":"integer","minimum":0},"ai_search_crawler":{"type":"integer","minimum":0},"mcp_client":{"type":"integer","minimum":0},"programmatic_agent":{"type":"integer","minimum":0},"unknown":{"type":"integer","minimum":0}}},"beaconEvents":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256},"beaconInternalEvents":{"type":"object","additionalProperties":{"type":"integer","minimum":0},"maxProperties":256}}}},"hourly":{"type":"array","maxItems":48,"items":{"type":"object","required":["hour","requests"],"properties":{"hour":{"type":"string"},"requests":{"type":"integer"}}}},"windows":{"type":"object","required":["authoritative","today","d7","d30"],"properties":{"authoritative":{"type":"boolean"},"today":{"type":"object"},"d7":{"type":"object"},"d30":{"type":"object"}}}}},"TelemetryBeacon":{"type":"object","required":["v","e"],"additionalProperties":false,"properties":{"v":{"const":1},"e":{"type":"string","enum":["page_load","scroll_50","scroll_90","copy_mcp_url","copy_curl","copy_skill_md","live_checker_submit","cta_click","protocol_view","not_found_404"]},"p":{"type":"string","pattern":"^/[A-Za-z0-9/_.~%-]{0,119}$","description":"Path without query or hash"},"r":{"type":"string","maxLength":80,"description":"Referrer host (lowercase host only), \"self\", or empty/absent for direct"},"u":{"type":"string","pattern":"^[a-z0-9_.-]{1,40}$","description":"utm_source"},"t":{"type":"string","pattern":"^(?:[a-z0-9-]{1,60}|(?:ethereum|base):0x[0-9a-fA-F]{40})$","description":"Protocol slug or chain:address"},"m":{"type":"string","enum":["paid","paid_search","cpc","organic"],"description":"utm_medium (closed set)"},"c":{"type":"string","pattern":"^[a-z0-9_-]{1,32}$","description":"utm_campaign (secret-shaped / hex values rejected)"},"h":{"type":"string","enum":["wtf","com"],"description":"Serving host: pacta.wtf (wtf) or pacta.fractalneurons.com (com)"},"i":{"enum":[1,true],"description":"Opt-in Founder / internal QA flag (?internal=1); excluded from external beacon funnel maps"}}},"PaymentRequired":{"type":"object","required":["x402Version","error","accepts"],"properties":{"x402Version":{"const":1},"error":{"type":"string"},"detail":{"type":"string"},"accepts":{"type":"array","items":{"type":"object","required":["scheme","network","maxAmountRequired","resource","payTo","asset"],"properties":{"scheme":{"const":"exact"},"network":{"const":"base"},"maxAmountRequired":{"type":"string"},"resource":{"type":"string"},"payTo":{"type":"string"},"asset":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"}}}},"extensions":{"type":"object"}}}}}}