{"openapi":"3.1.0","info":{"title":"DLL Execution API","description":"Read-only Base Mainnet transaction-hash analysis, unsigned candidate Preflight and observed Execution Outcome Verification API. It never signs or executes transactions.","version":"0.1.0","x-guidance":"Only POST /v1/benchmark/transactions is a paid discovery resource. Prove wallet identity with SIWX first; the first 3 valid analyses are free. Afterwards use x402 V2 upto on Base Mainnet USDC. Only delivered valid analyses incur charges; actual settlement can be below the authorization maximum."},"components":{"schemas":{},"securitySchemes":{"inquiryAccessToken":{"type":"http","scheme":"bearer","description":"One-time opaque token returned when this inquiry was created."},"siwx":{"type":"apiKey","in":"header","name":"SIGN-IN-WITH-X","description":"EIP-191 wallet identity proof; this is not a DLL API key."}}},"paths":{"/":{"get":{"summary":"Agent capability selection entry","tags":["discovery"],"responses":{"200":{"description":"Default Response"}},"security":[]}},"/llms.txt":{"get":{"summary":"Allowlisted public contract and documentation index","tags":["discovery"],"responses":{"200":{"description":"Default Response"}},"security":[]}},"/health":{"get":{"summary":"Service health","tags":["system"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["ok"]},"service":{"type":"string","enum":["DLL Execution"]},"version":{"type":"string"}},"required":["status","service","version"],"additionalProperties":false}}}}},"security":[]}},"/capabilities":{"get":{"summary":"Machine-readable service capabilities","tags":["discovery"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string","enum":["DLL Execution"]},"current_chain":{"type":"string","enum":["Base"]},"mode":{"type":"string","enum":["read-only_analysis"]},"supported_inputs":{"type":"array","items":{"type":"string","enum":["transaction_hash","transaction_hashes","unsigned_transaction_candidate","transaction_hash_with_optional_expectation"]}},"current_capabilities":{"type":"array","items":{"type":"string","enum":["service_health","capability_discovery","openapi_schema","base_transaction_read","batch_transaction_cost_analysis","base_execution_cost_benchmark","base_benchmark_collector","pricing_metadata","payment_metadata","execution_preflight","execution_verification"]}},"explicit_non_capabilities":{"type":"array","items":{"type":"string","enum":["transaction_execution","transaction_signing","private_key_storage","fund_custody","asset_control","gas_sponsorship","paymaster","relayer","automatic_routing","automatic_execution","wallet_history","time_range_scanning","indexer"]}},"execution_preflight":{"type":"object","properties":{"name":{"type":"string","enum":["execution_preflight"]},"method":{"type":"string","enum":["POST"]},"path":{"type":"string","enum":["/v2/execution/preflight"]},"chain":{"type":"string","enum":["Base Mainnet"]},"chain_id":{"type":"string","enum":["8453"]},"input":{"type":"string","enum":["unsigned_transaction_candidate"]},"read_only":{"type":"boolean","enum":[true]},"paid":{"type":"boolean","enum":[false]},"x402_required":{"type":"boolean","enum":[false]},"outputs":{"type":"array","items":{"type":"string","enum":["simulation","l2_execution_cost_estimate","policy","judgment","evidence"]}},"judgment_states":{"type":"array","items":{"type":"string","enum":["PASS","CAUTION","BLOCK","INDETERMINATE"]}},"limitations":{"type":"array","items":{"type":"string","enum":["No signing, broadcasting, custody or autonomous execution.","No profitability or investment judgment.","L1 data fee and total transaction cost are unavailable, not zero.","Ordinary successful assessments remain CAUTION because total cost is incomplete.","Simulation does not guarantee future transaction success or prove ownership of from."]}}},"required":["name","method","path","chain","chain_id","input","read_only","paid","x402_required","outputs","judgment_states","limitations"],"additionalProperties":false},"execution_verification":{"type":"object","properties":{"name":{"type":"string","enum":["execution_verification"]},"method":{"type":"string","enum":["POST"]},"path":{"type":"string","enum":["/v2/execution/verify"]},"chain":{"type":"string","enum":["Base Mainnet"]},"chain_id":{"type":"string","enum":["8453"]},"input":{"type":"string","enum":["transaction_hash_with_optional_expectation"]},"read_only":{"type":"boolean","enum":[true]},"paid":{"type":"boolean","enum":[false]},"x402_required":{"type":"boolean","enum":[false]},"outputs":{"type":"array","items":{"type":"string","enum":["observed_outcome","verification","realized_l2_execution_cost","evidence"]}},"verification_states":{"type":"array","items":{"type":"string","enum":["VERIFIED","CONTRADICTED","INDETERMINATE"]}},"limitations":{"type":"array","items":{"type":"string","enum":["No signing, broadcasting, custody or execution authorization.","Verification applies only to explicit checks, not actor identity, causality or economic value.","Canonicality and inclusion do not establish finality.","L1 fee is available only when observed; total execution cost remains unavailable.","No persistent transaction history or assessment linkage."]}}},"required":["name","method","path","chain","chain_id","input","read_only","paid","x402_required","outputs","verification_states","limitations"],"additionalProperties":false},"commercial":{"type":"object","properties":{"pricing_available":{"type":"boolean","enum":[true]},"payment_metadata_available":{"type":"boolean","enum":[true]},"payment_enforcement":{"type":"boolean"},"payment_status":{"type":"string","enum":["planned","test_only","live"]},"x402_supported":{"type":"boolean"},"x402_scheme":{"type":"string","enum":["upto"]},"payment_network_id":{"type":"string","enum":["eip155:84532","eip155:8453"]},"mainnet_implementation_supported":{"type":"boolean","enum":[true]},"mainnet_payment_enforcement":{"type":"boolean"},"billing_unit":{"type":"string","enum":["valid_analysis"]},"free_trial_valid_analyses":{"type":"number","enum":[3]}},"required":["pricing_available","payment_metadata_available","payment_enforcement","payment_status","x402_supported","x402_scheme","payment_network_id","mainnet_implementation_supported","mainnet_payment_enforcement","billing_unit","free_trial_valid_analyses"],"additionalProperties":false}},"required":["service","current_chain","mode","supported_inputs","current_capabilities","explicit_non_capabilities","commercial"],"additionalProperties":false}}}}},"security":[]}},"/pricing":{"get":{"summary":"Machine-readable pricing metadata","tags":["commercial"],"description":"$0.005 USD per successfully delivered valid analysis. The first 3 valid analyses per payment identity are free. Failed or unavailable results are not charged and do not consume the free allowance. This instance enforces x402 V2 upto with Base Mainnet USDC for benchmark analysis.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string","enum":["DLL Execution"]},"product":{"type":"string","enum":["base_execution_analysis_benchmark"]},"currency":{"type":"string","enum":["USD"]},"billing_unit":{"type":"string","enum":["valid_analysis"]},"unit_price":{"type":"string","enum":["0.005"]},"free_trial":{"type":"object","properties":{"enabled":{"type":"boolean","enum":[true]},"valid_analyses":{"type":"number","enum":[3]},"identity_basis":{"type":"string","enum":["payment_identity"]},"wallet_identity_supported":{"type":"boolean","enum":[true]}},"required":["enabled","valid_analyses","identity_basis","wallet_identity_supported"],"additionalProperties":false},"billing_rules":{"type":"object","properties":{"charge_only_on_valid_result":{"type":"boolean","enum":[true]},"failed_results_charged":{"type":"boolean","enum":[false]},"free_allowance_consumed_only_on_valid_result":{"type":"boolean","enum":[true]},"non_chargeable_results":{"type":"array","items":{"type":"string","enum":["not_found","unavailable","RPC_UNAVAILABLE","RPC_RATE_LIMITED","RPC_TIMEOUT","MALFORMED_PROVIDER_RESPONSE","other_invalid_or_undelivered_result"]}}},"required":["charge_only_on_valid_result","failed_results_charged","free_allowance_consumed_only_on_valid_result","non_chargeable_results"],"additionalProperties":false},"supported_payment_methods":{"type":"array","items":{"type":"object","properties":{"protocol":{"type":"string","enum":["x402"]},"asset":{"type":"string","enum":["USDC"]},"network":{"type":"string","enum":["Base","Base Sepolia"]},"mode":{"type":"string","enum":["per_request"]},"status":{"type":"string","enum":["planned","test_only","live"]},"enforcement":{"type":"boolean"}},"required":["protocol","asset","network","mode","status","enforcement"],"additionalProperties":false}}},"required":["service","product","currency","billing_unit","unit_price","free_trial","billing_rules","supported_payment_methods"],"additionalProperties":false}}}}},"security":[]}},"/payment":{"get":{"summary":"Machine-readable payment capability metadata","tags":["commercial"],"description":"$0.005 USD per successfully delivered valid analysis. The first 3 valid analyses per payment identity are free. Failed or unavailable results are not charged and do not consume the free allowance. This instance enforces x402 V2 upto with Base Mainnet USDC for benchmark analysis.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string","enum":["DLL Execution"]},"product":{"type":"string","enum":["base_execution_analysis_benchmark"]},"status":{"type":"string","enum":["planned","test_only","live"]},"enforcement_status":{"type":"string","enum":["not_yet_enforced","test_only","live"]},"payment_enforcement":{"type":"boolean"},"x402_supported":{"type":"boolean"},"implementation_supported_networks":{"type":"array","items":{"type":"string","enum":["eip155:84532","eip155:8453"]}},"mainnet_implementation_supported":{"type":"boolean","enum":[true]},"environment":{"type":"string","enum":["development","test","production"]},"scheme":{"type":"string","enum":["upto"]},"network_id":{"type":"string","enum":["eip155:84532","eip155:8453"]},"mainnet_payment_enforcement":{"type":"boolean"},"protocol":{"type":"string","enum":["x402"]},"asset":{"type":"string","enum":["USDC"]},"network":{"type":"string","enum":["Base","Base Sepolia"]},"settlement_mode":{"type":"string","enum":["per_request"]},"billing":{"type":"object","properties":{"unit":{"type":"string","enum":["valid_analysis"]},"currency":{"type":"string","enum":["USD"]},"unit_price":{"type":"string","enum":["0.005"]}},"required":["unit","currency","unit_price"],"additionalProperties":false},"free_trial":{"type":"object","properties":{"enabled":{"type":"boolean","enum":[true]},"valid_analyses":{"type":"number","enum":[3]},"identity_basis":{"type":"string","enum":["payment_identity"]},"wallet_identity_supported":{"type":"boolean","enum":[true]}},"required":["enabled","valid_analyses","identity_basis","wallet_identity_supported"],"additionalProperties":false},"charge_semantics":{"type":"object","properties":{"charge_only_on_valid_result":{"type":"boolean","enum":[true]},"failed_results_charged":{"type":"boolean","enum":[false]},"free_allowance_consumed_only_on_valid_result":{"type":"boolean","enum":[true]},"non_chargeable_results":{"type":"array","items":{"type":"string","enum":["not_found","unavailable","RPC_UNAVAILABLE","RPC_RATE_LIMITED","RPC_TIMEOUT","MALFORMED_PROVIDER_RESPONSE","other_invalid_or_undelivered_result"]}}},"required":["charge_only_on_valid_result","failed_results_charged","free_allowance_consumed_only_on_valid_result","non_chargeable_results"],"additionalProperties":false},"identity":{"type":"object","properties":{"basis":{"type":"string","enum":["payment_identity"]},"wallet_identity_supported":{"type":"boolean","enum":[true]},"traditional_account_required":{"type":"boolean","enum":[false]},"permanently_bound_to_wallet_identity":{"type":"boolean","enum":[false]}},"required":["basis","wallet_identity_supported","traditional_account_required","permanently_bound_to_wallet_identity"],"additionalProperties":false},"prepaid_balance_supported":{"type":"boolean","enum":[false]},"human_payment":{"type":"object","properties":{"supported":{"type":"boolean","enum":[false]},"status":{"type":"string","enum":["future"]}},"required":["supported","status"],"additionalProperties":false}},"required":["service","product","status","enforcement_status","payment_enforcement","x402_supported","implementation_supported_networks","mainnet_implementation_supported","environment","scheme","network_id","mainnet_payment_enforcement","protocol","asset","network","settlement_mode","billing","free_trial","charge_semantics","identity","prepaid_balance_supported","human_payment"],"additionalProperties":false}}}}},"security":[]}},"/v1/transactions/{transactionHash}":{"get":{"summary":"Read a Base Mainnet transaction","tags":["transactions"],"description":"Read-only analysis of one Base Mainnet transaction hash. This endpoint never signs or executes transactions.","parameters":[{"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"in":"path","name":"transactionHash","required":true,"description":"A 0x-prefixed 32-byte Base Mainnet transaction hash."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"object","properties":{"chain_id":{"type":"string","enum":["8453"]},"name":{"type":"string","enum":["Base Mainnet"]}},"required":["chain_id","name"],"additionalProperties":false},"transaction":{"type":"object","properties":{"chain_id":{"type":"string","enum":["8453"]},"transaction_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"A 0x-prefixed 32-byte Base Mainnet transaction hash."},"block_number":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"from":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"to":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},{"type":"null"}]},"transaction_status":{"type":"string","enum":["success","failed"]},"transaction_type":{"type":"string","enum":["legacy","access_list","eip1559","blob","unknown"]},"gas_limit":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"gas_used":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"effective_gas_price":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"value":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"nonce":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"input":{"type":"string","pattern":"^0x(?:[0-9a-fA-F]{2})*$"},"timestamp":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"}},"required":["chain_id","transaction_hash","block_number","from","to","transaction_status","transaction_type","gas_limit","gas_used","effective_gas_price","value","nonce","input","timestamp"],"additionalProperties":false},"execution_cost":{"type":"object","properties":{"execution_fee_wei":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"execution_fee_eth":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"}},"required":["execution_fee_wei","execution_fee_eth"],"additionalProperties":false},"l1_data_cost":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","enum":["available"]},"amount_wei":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"amount_eth":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"source":{"type":"string","enum":["transaction_receipt.l1Fee"]}},"required":["status","amount_wei","amount_eth","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["unavailable"]},"amount_wei":{"type":"null"},"amount_eth":{"type":"null"},"reason":{"type":"string"},"source":{"type":"null"}},"required":["status","amount_wei","amount_eth","reason","source"],"additionalProperties":false}]},"total_transaction_cost":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","enum":["available"]},"amount_wei":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"amount_eth":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"}},"required":["status","amount_wei","amount_eth"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["unavailable"]},"amount_wei":{"type":"null"},"amount_eth":{"type":"null"},"reason":{"type":"string"}},"required":["status","amount_wei","amount_eth","reason"],"additionalProperties":false}]},"metadata":{"type":"object","properties":{"read_only":{"type":"boolean","enum":[true]},"block_timestamp_source":{"type":"string","enum":["block"]},"fee_calculation":{"type":"string","enum":["gas_used * effective_gas_price"]}},"required":["read_only","block_timestamp_source","fee_calculation"],"additionalProperties":false}},"required":["chain","transaction","execution_cost","l1_data_cost","total_transaction_cost","metadata"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"security":[]}},"/v1/analysis/transactions":{"post":{"summary":"Analyze a batch of Base Mainnet transactions","tags":["analysis"],"description":"Read-only cost analysis for 1–100 transaction hashes. Results are partial: one failed item does not fail the batch. Failed transactions retain their real execution cost. When an aggregate status is partial, its known total is only the known subset and is not the complete batch total. This endpoint never signs or executes transactions.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"transaction_hashes":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"A 0x-prefixed 32-byte Base Mainnet transaction hash."},"description":"Between 1 and 100 Base Mainnet transaction hashes."}},"required":["transaction_hashes"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"summary":{"type":"object","properties":{"requested_transactions":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"unique_transactions":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"analyzed_transactions":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"successful_transactions":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"failed_transactions":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"unavailable_transactions":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"execution_cost":{"type":"object","properties":{"total_wei":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"total_eth":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"average_wei":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"average_eth":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},{"type":"null"}]},"average_rounding":{"type":"string","enum":["floor_to_integer_wei"]}},"required":["total_wei","total_eth","average_wei","average_eth","average_rounding"],"additionalProperties":false},"l1_data_cost":{"type":"object","properties":{"status":{"type":"string","enum":["available","partial","unavailable"]},"known_transactions":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"unknown_transactions":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"known_total_wei":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"known_total_eth":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},{"type":"null"}]}},"required":["status","known_transactions","unknown_transactions","known_total_wei","known_total_eth"],"additionalProperties":false},"total_transaction_cost":{"type":"object","properties":{"status":{"type":"string","enum":["available","partial","unavailable"]},"known_transactions":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"unknown_transactions":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"known_total_wei":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"known_total_eth":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},{"type":"null"}]}},"required":["status","known_transactions","unknown_transactions","known_total_wei","known_total_eth"],"additionalProperties":false},"failed_transaction_waste":{"type":"object","properties":{"transaction_count":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"known_execution_waste":{"type":"object","properties":{"amount_wei":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"amount_eth":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"}},"required":["amount_wei","amount_eth"],"additionalProperties":false},"known_total_waste":{"type":"object","properties":{"status":{"type":"string","enum":["available","partial","unavailable"]},"known_transactions":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"unknown_transactions":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"known_total_wei":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"known_total_eth":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},{"type":"null"}]}},"required":["status","known_transactions","unknown_transactions","known_total_wei","known_total_eth"],"additionalProperties":false}},"required":["transaction_count","known_execution_waste","known_total_waste"],"additionalProperties":false}},"required":["requested_transactions","unique_transactions","analyzed_transactions","successful_transactions","failed_transactions","unavailable_transactions","execution_cost","l1_data_cost","total_transaction_cost","failed_transaction_waste"],"additionalProperties":false},"results":{"type":"array","items":{"type":"object","properties":{"transaction_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"A 0x-prefixed 32-byte Base Mainnet transaction hash."},"status":{"type":"string","enum":["analyzed","not_found","unavailable","invalid_response"]},"transaction":{"anyOf":[{"type":"object","properties":{"chain_id":{"type":"string","enum":["8453"]},"transaction_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"A 0x-prefixed 32-byte Base Mainnet transaction hash."},"block_number":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"from":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"to":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},{"type":"null"}]},"transaction_status":{"type":"string","enum":["success","failed"]},"transaction_type":{"type":"string","enum":["legacy","access_list","eip1559","blob","unknown"]},"gas_limit":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"gas_used":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"effective_gas_price":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"value":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"nonce":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"input":{"type":"string","pattern":"^0x(?:[0-9a-fA-F]{2})*$"},"timestamp":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"}},"required":["chain_id","transaction_hash","block_number","from","to","transaction_status","transaction_type","gas_limit","gas_used","effective_gas_price","value","nonce","input","timestamp"],"additionalProperties":false},{"type":"null"}]},"transaction_status":{"anyOf":[{"type":"string","enum":["success","failed"]},{"type":"null"}]},"execution_cost":{"anyOf":[{"type":"object","properties":{"execution_fee_wei":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"execution_fee_eth":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"}},"required":["execution_fee_wei","execution_fee_eth"],"additionalProperties":false},{"type":"null"}]},"l1_data_cost":{"anyOf":[{"oneOf":[{"type":"object","properties":{"status":{"type":"string","enum":["available"]},"amount_wei":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"amount_eth":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"source":{"type":"string","enum":["transaction_receipt.l1Fee"]}},"required":["status","amount_wei","amount_eth","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["unavailable"]},"amount_wei":{"type":"null"},"amount_eth":{"type":"null"},"reason":{"type":"string"},"source":{"type":"null"}},"required":["status","amount_wei","amount_eth","reason","source"],"additionalProperties":false}]},{"type":"null"}]},"total_transaction_cost":{"anyOf":[{"oneOf":[{"type":"object","properties":{"status":{"type":"string","enum":["available"]},"amount_wei":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"amount_eth":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"}},"required":["status","amount_wei","amount_eth"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["unavailable"]},"amount_wei":{"type":"null"},"amount_eth":{"type":"null"},"reason":{"type":"string"}},"required":["status","amount_wei","amount_eth","reason"],"additionalProperties":false}]},{"type":"null"}]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"}},"required":["code"],"additionalProperties":false},{"type":"null"}]}},"required":["transaction_hash","status","transaction","transaction_status","execution_cost","l1_data_cost","total_transaction_cost","error"],"additionalProperties":false}},"metadata":{"type":"object","properties":{"chain":{"type":"string","enum":["Base Mainnet"]},"chain_id":{"type":"string","enum":["8453"]},"read_only":{"type":"boolean","enum":[true]},"pricing_currency":{"type":"string","enum":["native_eth_only"]},"total_cost_may_be_partial":{"type":"boolean","enum":[true]},"usd_conversion":{"type":"boolean","enum":[false]},"optimization_performed":{"type":"boolean","enum":[false]},"result_order":{"type":"string","enum":["first_occurrence_of_each_unique_hash"]}},"required":["chain","chain_id","read_only","pricing_currency","total_cost_may_be_partial","usd_conversion","optimization_performed","result_order"],"additionalProperties":false}},"required":["summary","results","metadata"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"security":[]}},"/v2/execution/preflight":{"post":{"summary":"Evaluate one unsigned Base Mainnet candidate without execution","tags":["preflight"],"description":"Limited free V0.2.1 trial, enabled explicitly: Base Mainnet only (8453); no signing, broadcasting, custody or nonce management. Evidence-based PASS/CAUTION/BLOCK/INDETERMINATE does not imply profit or strategic value. L2 gas-fee estimate only: L1 and complete transaction cost are unavailable, normally yielding CAUTION. Infrastructure gaps produce a 200 INDETERMINATE assessment, not a successful simulation. No Preflight SIWX/x402/Benchmark pricing integration. max_execution_cost_wei constrains an estimated L2 fee, not complete cost or guaranteed spending. Request body limit 160 KiB; calldata limit 64 KiB. Admission may reject requests with machine-readable errors; honor Retry-After when supplied and use bounded retries only for retryable failures. A repeat call is a new assessment, not idempotent-result replay.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"candidate":{"type":"object","properties":{"chain_id":{"type":"string","enum":["8453"]},"from":{"type":"string","minLength":42,"maxLength":42},"to":{"type":"string","minLength":42,"maxLength":42},"value":{"type":"string","maxLength":78,"pattern":"^(0|[1-9][0-9]*)$"},"data":{"type":"string","maxLength":131074,"pattern":"^0x(?:[0-9a-fA-F]{2})*$"}},"required":["chain_id","from","to","value","data"],"additionalProperties":false},"constraints":{"type":"object","properties":{"max_execution_cost_wei":{"type":"string","maxLength":78,"pattern":"^(0|[1-9][0-9]*)$"},"allowed_to":{"maxItems":100,"type":"array","items":{"type":"string","minLength":42,"maxLength":42}},"denied_to":{"maxItems":100,"type":"array","items":{"type":"string","minLength":42,"maxLength":42}}},"additionalProperties":false}},"required":["candidate"],"additionalProperties":false},"examples":{"illustrative":{"summary":"Public request example; consult the guide before calling","value":{"candidate":{"chain_id":"8453","from":"0x1111111111111111111111111111111111111111","to":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","value":"0","data":"0x70a082310000000000000000000000001111111111111111111111111111111111111111"}}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"object","properties":{"chain_id":{"type":"string","enum":["8453"]},"name":{"type":"string","enum":["Base Mainnet"]}},"required":["chain_id","name"],"additionalProperties":false},"candidate":{"type":"object","properties":{"chain_id":{"type":"string","enum":["8453"]},"from":{"type":"string","pattern":"^0x[0-9a-f]{40}$"},"to":{"type":"string","pattern":"^0x[0-9a-f]{40}$"},"value":{"type":"string","maxLength":78,"pattern":"^(0|[1-9][0-9]*)$"},"data":{"type":"string","maxLength":131074,"pattern":"^0x(?:[0-9a-f]{2})*$"}},"required":["chain_id","from","to","value","data"],"additionalProperties":false},"simulation":{"type":"object","properties":{"status":{"type":"string","enum":["success","reverted","unavailable"]},"can_execute_at_snapshot":{"type":"string","enum":["likely_success","likely_failure","unknown"]},"return_data":{"anyOf":[{"type":"string","maxLength":8194,"pattern":"^0x(?:[0-9a-f]{2})*$"},{"type":"null"}]},"truncated":{"type":"boolean"},"revert":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["error","panic","custom","unknown"]},"selector":{"type":["string","null"]},"message":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}]},"panic_code":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]}},"required":["kind","selector","message","panic_code"],"additionalProperties":false},{"type":"null"}]},"error_code":{"type":["string","null"]},"evidence_refs":{"type":"array","items":{"type":"string"}}},"required":["status","can_execute_at_snapshot","return_data","truncated","revert","error_code","evidence_refs"],"additionalProperties":false},"cost_estimate":{"type":"object","properties":{"status":{"type":"string","enum":["partial","unavailable"]},"estimated_gas":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"execution_cost":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","enum":["available"]},"estimated_fee_wei":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"estimated_fee_eth":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"gas_price_wei":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"fee_basis":{"type":"string","enum":["provider_gas_price_quote"]},"evidence_refs":{"type":"array","items":{"type":"string"}}},"required":["status","estimated_fee_wei","estimated_fee_eth","gas_price_wei","fee_basis","evidence_refs"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["unavailable"]},"estimated_fee_wei":{"type":"null"},"estimated_fee_eth":{"type":"null"},"gas_price_wei":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"reason_code":{"type":"string"},"evidence_refs":{"type":"array","items":{"type":"string"}}},"required":["status","estimated_fee_wei","estimated_fee_eth","gas_price_wei","reason_code","evidence_refs"],"additionalProperties":false}]},"l1_data_cost":{"type":"object","properties":{"status":{"type":"string","enum":["unavailable"]},"estimated_amount_wei":{"type":"null"},"estimated_amount_eth":{"type":"null"},"reason_code":{"type":"string"},"source":{"type":"null"}},"required":["status","estimated_amount_wei","estimated_amount_eth","reason_code","source"],"additionalProperties":false},"total_transaction_cost":{"type":"object","properties":{"status":{"type":"string","enum":["unavailable"]},"estimated_amount_wei":{"type":"null"},"estimated_amount_eth":{"type":"null"},"reason_code":{"type":"string"}},"required":["status","estimated_amount_wei","estimated_amount_eth","reason_code"],"additionalProperties":false}},"required":["status","estimated_gas","execution_cost","l1_data_cost","total_transaction_cost"],"additionalProperties":false},"historical_context":{"type":"object","properties":{"status":{"type":"string","enum":["unavailable"]},"reason_code":{"type":"string","enum":["NO_DEFENSIBLE_CANDIDATE_COHORT"]},"message":{"type":"string"}},"required":["status","reason_code","message"],"additionalProperties":false},"policy":{"type":"object","properties":{"status":{"type":"string","enum":["allowed","denied","unknown","not_configured"]},"checks":{"type":"array","items":{"type":"object","properties":{"rule":{"type":"string","enum":["allowed_to","denied_to","max_execution_cost_wei"]},"outcome":{"type":"string","enum":["allowed","denied","unknown"]},"reason_code":{"type":"string"},"observed":{"type":["string","null"]},"constraint":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"evidence_refs":{"type":"array","items":{"type":"string"}}},"required":["rule","outcome","reason_code","observed","constraint","evidence_refs"],"additionalProperties":false}}},"required":["status","checks"],"additionalProperties":false},"judgment":{"type":"object","properties":{"state":{"type":"string","enum":["PASS","CAUTION","BLOCK","INDETERMINATE"]},"reasons":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"evidence_refs":{"type":"array","items":{"type":"string"}}},"required":["code","message","evidence_refs"],"additionalProperties":false}},"economic_profitability":{"type":"string","enum":["not_evaluated"]},"strategic_desirability":{"type":"string","enum":["not_evaluated"]}},"required":["state","reasons","economic_profitability","strategic_desirability"],"additionalProperties":false},"evidence":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"kind":{"type":"string","enum":["simulation"]},"snapshot_ref":{"type":["string","null"]},"status":{"type":"string","enum":["success","reverted","unavailable"]},"error_code":{"type":["string","null"]}},"required":["id","source","kind","snapshot_ref","status","error_code"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"kind":{"type":"string","enum":["gas_estimate"]},"snapshot_ref":{"type":["string","null"]},"gas_ceiling":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"estimated_gas":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"error_code":{"type":["string","null"]}},"required":["id","source","kind","snapshot_ref","gas_ceiling","estimated_gas","error_code"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"kind":{"type":"string","enum":["fee_quote"]},"observed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"gas_price_wei":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"state_binding":{"type":"string","enum":["not_pinned"]},"error_code":{"type":["string","null"]}},"required":["id","source","kind","observed_at","gas_price_wei","state_binding","error_code"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"kind":{"type":"string","enum":["coverage"]},"l1_estimate":{"type":"string","enum":["unavailable"]},"total_estimate":{"type":"string","enum":["unavailable"]}},"required":["id","source","kind","l1_estimate","total_estimate"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"kind":{"type":"string","enum":["policy_check"]},"rule":{"type":"string","enum":["allowed_to","denied_to","max_execution_cost_wei"]},"outcome":{"type":"string","enum":["allowed","denied","unknown"]}},"required":["id","source","kind","rule","outcome"],"additionalProperties":false}]}},"metadata":{"type":"object","properties":{"schema_version":{"type":"string","enum":["execution_preflight_v0.2.1"]},"methodology_version":{"type":"string","enum":["preflight_v1"]},"judgment_version":{"type":"string","enum":["judgment_v1"]},"policy_version":{"type":"string","enum":["policy_v1"]},"input_digest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"observed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"snapshot":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","enum":["snapshot-1"]},"block_number":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"block_hash":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"block_timestamp":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"selection":{"type":"string","enum":["latest_observed"]},"pinning":{"type":"string","enum":["call_hash_estimate_number_hash_rechecked"]}},"required":["id","block_number","block_hash","block_timestamp","selection","pinning"],"additionalProperties":false},{"type":"null"}]},"read_only":{"type":"boolean","enum":[true]},"native_currency":{"type":"string","enum":["ETH"]},"transaction_signed":{"type":"boolean","enum":[false]},"transaction_broadcast":{"type":"boolean","enum":[false]},"payment_integrated":{"type":"boolean","enum":[false]},"limitations":{"type":"array","items":{"type":"string"}}},"required":["schema_version","methodology_version","judgment_version","policy_version","input_digest","observed_at","snapshot","read_only","native_currency","transaction_signed","transaction_broadcast","payment_integrated","limitations"],"additionalProperties":false}},"required":["chain","candidate","simulation","cost_estimate","historical_context","policy","judgment","evidence","metadata"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false},"examples":{"illustrative":{"summary":"Illustrative invalid-request response; no assessment was performed","value":{"error":{"code":"INVALID_PREFLIGHT_REQUEST","message":"Provide one Base Mainnet unsigned candidate and supported deterministic constraints.","status_code":400}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"413":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"operationId":"preflightTransaction","externalDocs":{"description":"Canonical public guide","url":"https://github.com/dllio/dll-execution-docs/blob/main/PREFLIGHT.md"},"security":[]}},"/v2/execution/verify":{"post":{"summary":"Verify an observed Base Mainnet transaction against explicit narrow expectations","tags":["verification"],"description":"Limited free read-only trial. Does not sign, broadcast, authorize or execute. Base Mainnet 8453 only. Defaults: expected chain 8453 and inclusion included; receipt status is checked only when explicitly supplied. VERIFIED applies only to the listed checks, not finality, ownership, application intent or profitability. Missing required evidence is INDETERMINATE. Not-found/pending and provider-unavailable observations are distinct in a 200 assessment; configured provider missing returns 503. Receipt execution fee is gas_used × effective_gas_price, not complete transaction cost. L1 fee is available only if observed; total cost remains unavailable. No payment, SIWX or Benchmark quota. New calls may observe different chain state.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"transaction_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"expectation":{"type":"object","properties":{"chain_id":{"default":"8453","type":"string","enum":["8453"]},"candidate":{"type":"object","properties":{"chain_id":{"type":"string","enum":["8453"]},"from":{"type":"string","minLength":42,"maxLength":42},"to":{"type":"string","minLength":42,"maxLength":42},"value":{"type":"string","maxLength":78,"pattern":"^(0|[1-9][0-9]*)$"},"data":{"type":"string","maxLength":131074,"pattern":"^0x(?:[0-9a-fA-F]{2})*$"}},"required":["chain_id","from","to","value","data"],"additionalProperties":false},"inclusion":{"default":"included","type":"string","enum":["included","pending"]},"receipt_status":{"type":"string","enum":["success","reverted"]}},"additionalProperties":false}},"required":["transaction_hash"],"additionalProperties":false},"examples":{"illustrative":{"summary":"Public request example; consult the guide before calling","value":{"transaction_hash":"0x1212121212121212121212121212121212121212121212121212121212121212","expectation":{"chain_id":"8453","inclusion":"included","receipt_status":"success"}}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"object","properties":{"chain_id":{"type":"string","enum":["8453"]},"name":{"type":"string","enum":["Base Mainnet"]}},"required":["chain_id","name"],"additionalProperties":false},"transaction_hash":{"type":"string","pattern":"^0x[a-f0-9]{64}$"},"expectation":{"type":"object","properties":{"chain_id":{"default":"8453","type":"string","enum":["8453"]},"candidate":{"type":"object","properties":{"chain_id":{"type":"string","enum":["8453"]},"from":{"type":"string","pattern":"^0x[0-9a-f]{40}$"},"to":{"type":"string","pattern":"^0x[0-9a-f]{40}$"},"value":{"type":"string","maxLength":78,"pattern":"^(0|[1-9][0-9]*)$"},"data":{"type":"string","maxLength":131074,"pattern":"^0x(?:[0-9a-f]{2})*$"}},"required":["chain_id","from","to","value","data"],"additionalProperties":false},"inclusion":{"default":"included","type":"string","enum":["included","pending"]},"receipt_status":{"type":"string","enum":["success","reverted"]}},"required":["chain_id","inclusion"],"additionalProperties":false},"outcome":{"type":"object","properties":{"version":{"type":"string","enum":["execution_outcome_v1"]},"id":{"type":"string","enum":["outcome-1"]},"observedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"chain":{"anyOf":[{"type":"object","properties":{"family":{"type":"string","maxLength":64,"pattern":"^[a-zA-Z0-9][a-zA-Z0-9_.:-]*$"},"id":{"type":"string","maxLength":64,"pattern":"^[a-zA-Z0-9][a-zA-Z0-9_.:-]*$"}},"required":["family","id"],"additionalProperties":false},{"type":"null"}]},"transactionHash":{"type":"string","pattern":"^0x[a-f0-9]{64}$"},"inclusion":{"type":"string","enum":["included","pending","not_found","unknown"]},"integrity":{"type":"string","enum":["coherent","inconsistent","unknown"]},"block":{"type":"object","properties":{"number":{"anyOf":[{"type":"string","maxLength":78,"pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"hash":{"anyOf":[{"type":"string","pattern":"^0x[a-f0-9]{64}$"},{"type":"null"}]}},"required":["number","hash"],"additionalProperties":false},"canonicality":{"type":"string","enum":["checked","unknown","unavailable"]},"finality":{"type":"string","enum":["unknown","unavailable"]},"transaction":{"type":"object","properties":{"availability":{"type":"string","enum":["available","unavailable"]},"from":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{40}$"},{"type":"null"}]},"to":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{40}$"},{"type":"null"}]},"toKnown":{"type":"boolean"},"value":{"anyOf":[{"type":"string","maxLength":78,"pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"data":{"anyOf":[{"type":"string","maxLength":131074,"pattern":"^0x(?:[0-9a-f]{2})*$"},{"type":"null"}]},"completeness":{"type":"string","enum":["complete","partial","unavailable"]}},"required":["availability","from","to","toKnown","value","data","completeness"],"additionalProperties":false},"receipt":{"type":"object","properties":{"availability":{"type":"string","enum":["available","unavailable"]},"status":{"anyOf":[{"type":"string","enum":["success","reverted"]},{"type":"null"}]},"gasUsed":{"anyOf":[{"type":"string","maxLength":78,"pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"effectiveGasPrice":{"anyOf":[{"type":"string","maxLength":78,"pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"l1DataFeeWei":{"anyOf":[{"type":"string","maxLength":78,"pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]}},"required":["availability","status","gasUsed","effectiveGasPrice","l1DataFeeWei"],"additionalProperties":false},"realizedL2FeeWei":{"anyOf":[{"type":"string","maxLength":156,"pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"costCompleteness":{"type":"string","enum":["partial","unavailable"]},"totalExecutionCost":{"type":"string","enum":["unavailable"]},"provenance":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":64,"pattern":"^[a-zA-Z0-9][a-zA-Z0-9_.:-]*$"},"observation":{"type":"object","properties":{"version":{"type":"string","enum":["provider_provenance_v1"]},"capability":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","maxLength":64,"pattern":"^[a-zA-Z0-9][a-zA-Z0-9_.:-]*$"},"contractVersion":{"type":"string","enum":["provider_capabilities_v1"]},"adapterVersion":{"type":"string","maxLength":64,"pattern":"^[a-zA-Z0-9][a-zA-Z0-9_.:-]*$"}},"required":["id","contractVersion","adapterVersion"],"additionalProperties":false},{"type":"null"}]},"chain":{"anyOf":[{"type":"object","properties":{"family":{"type":"string","maxLength":64,"pattern":"^[a-zA-Z0-9][a-zA-Z0-9_.:-]*$"},"id":{"type":"string","maxLength":64,"pattern":"^[a-zA-Z0-9][a-zA-Z0-9_.:-]*$"},"source":{"type":"string","enum":["adapter_declaration"]}},"required":["family","id","source"],"additionalProperties":false},{"type":"null"}]},"observation":{"type":"string","enum":["chain_identity","snapshot","transaction_read","receipt_read","simulation","gas_estimation","gas_price","canonicality_check"]},"observedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"timeBasis":{"type":"string","enum":["assessment_started","observation_completed"]},"declaredStateBinding":{"type":"string","enum":["hash_pinned","height_bound","latest_only","independently_observed","unavailable","unknown"]},"stateBinding":{"type":"string","enum":["hash_pinned","height_bound","latest_only","independently_observed","unavailable","unknown"]},"block":{"anyOf":[{"type":"object","properties":{"blockNumber":{"type":"string","maxLength":78,"pattern":"^(0|[1-9][0-9]*)$"},"blockHash":{"anyOf":[{"type":"string","maxLength":128,"pattern":"^[a-zA-Z0-9][a-zA-Z0-9_-]*$"},{"type":"null"}]}},"required":["blockNumber","blockHash"],"additionalProperties":false},{"type":"null"}]},"availability":{"type":"string","enum":["available","unavailable"]},"completeness":{"type":"string","enum":["complete","partial","unknown"]},"unavailableReason":{"anyOf":[{"type":"string","enum":["unsupported","state_unavailable","malformed","timeout","rate_limited","reverted","unavailable","not_observed","unknown"]},{"type":"null"}]},"canonicality":{"type":"string","enum":["checked","unavailable","unknown","not_applicable"]},"finality":{"type":"string","enum":["unknown","safe","finalized"]}},"required":["version","capability","chain","observation","observedAt","timeBasis","declaredStateBinding","stateBinding","block","availability","completeness","unavailableReason","canonicality","finality"],"additionalProperties":false}},"required":["id","observation"],"additionalProperties":false}}},"required":["version","id","observedAt","chain","transactionHash","inclusion","integrity","block","canonicality","finality","transaction","receipt","realizedL2FeeWei","costCompleteness","totalExecutionCost","provenance"],"additionalProperties":false},"verification":{"type":"object","properties":{"version":{"type":"string","enum":["execution_verification_result_v1"]},"methodology":{"type":"string","enum":["execution_verification_v1"]},"state":{"type":"string","enum":["VERIFIED","CONTRADICTED","INDETERMINATE"]},"completeness":{"type":"string","enum":["complete","partial","unavailable"]},"outcomeRef":{"type":"string","enum":["outcome-1"]},"checks":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":64,"pattern":"^[a-zA-Z0-9][a-zA-Z0-9_.:-]*$"},"dimension":{"type":"string","enum":["chain","from","to","value","data","inclusion","receipt_status"]},"state":{"type":"string","enum":["VERIFIED","CONTRADICTED","INDETERMINATE"]},"reasonCode":{"type":"string","enum":["CHAIN_MATCH","CHAIN_MISMATCH","CHAIN_UNAVAILABLE","CANDIDATE_FROM_MATCH","CANDIDATE_FROM_MISMATCH","CANDIDATE_TO_MATCH","CANDIDATE_TO_MISMATCH","CANDIDATE_VALUE_MATCH","CANDIDATE_VALUE_MISMATCH","CANDIDATE_DATA_MATCH","CANDIDATE_DATA_MISMATCH","CANDIDATE_FIELD_UNAVAILABLE","INCLUSION_MATCH","INCLUSION_MISMATCH","INCLUSION_UNAVAILABLE","RECEIPT_STATUS_MATCH","RECEIPT_STATUS_MISMATCH","RECEIPT_UNAVAILABLE","OUTCOME_INCONSISTENT","CANONICALITY_UNAVAILABLE"]},"evidenceRefs":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"string","maxLength":64,"pattern":"^[a-zA-Z0-9][a-zA-Z0-9_.:-]*$"}}},"required":["id","dimension","state","reasonCode","evidenceRefs"],"additionalProperties":false}},"reasonCodes":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"string","enum":["CHAIN_MATCH","CHAIN_MISMATCH","CHAIN_UNAVAILABLE","CANDIDATE_FROM_MATCH","CANDIDATE_FROM_MISMATCH","CANDIDATE_TO_MATCH","CANDIDATE_TO_MISMATCH","CANDIDATE_VALUE_MATCH","CANDIDATE_VALUE_MISMATCH","CANDIDATE_DATA_MATCH","CANDIDATE_DATA_MISMATCH","CANDIDATE_FIELD_UNAVAILABLE","INCLUSION_MATCH","INCLUSION_MISMATCH","INCLUSION_UNAVAILABLE","RECEIPT_STATUS_MATCH","RECEIPT_STATUS_MISMATCH","RECEIPT_UNAVAILABLE","OUTCOME_INCONSISTENT","CANONICALITY_UNAVAILABLE"]}},"evidence":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":64,"pattern":"^[a-zA-Z0-9][a-zA-Z0-9_.:-]*$"},"kind":{"type":"string","enum":["expectation","candidate","outcome","transaction","receipt","block","cost","provenance","check","preflight"]},"availability":{"type":"string","enum":["available","unavailable"]},"refs":{"maxItems":12,"type":"array","items":{"type":"string","maxLength":64,"pattern":"^[a-zA-Z0-9][a-zA-Z0-9_.:-]*$"}}},"required":["id","kind","availability","refs"],"additionalProperties":false}}},"required":["version","methodology","state","completeness","outcomeRef","checks","reasonCodes","evidence"],"additionalProperties":false},"realized_cost":{"type":"object","properties":{"gas_used":{"anyOf":[{"type":"string","maxLength":78,"pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"effective_gas_price_wei":{"anyOf":[{"type":"string","maxLength":78,"pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"realized_l2_execution_fee_wei":{"anyOf":[{"type":"string","maxLength":156,"pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"l1_data_fee_wei":{"anyOf":[{"type":"string","maxLength":78,"pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"l1_data_fee_status":{"type":"string","enum":["available","unavailable"]},"total_execution_cost_wei":{"type":"null"},"total_execution_cost_status":{"type":"string","enum":["unavailable"]},"completeness":{"type":"string","enum":["partial","unavailable"]},"currency":{"type":"string","enum":["ETH"]},"unit":{"type":"string","enum":["wei"]},"basis":{"type":"string","enum":["observed_receipt"]}},"required":["gas_used","effective_gas_price_wei","realized_l2_execution_fee_wei","l1_data_fee_wei","l1_data_fee_status","total_execution_cost_wei","total_execution_cost_status","completeness","currency","unit","basis"],"additionalProperties":false},"observation_errors":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"observation":{"type":"string","enum":["chain","transaction","receipt","block","canonicality"]},"error_code":{"type":"string","enum":["RPC_TIMEOUT","RPC_RATE_LIMITED","RPC_UNAVAILABLE","MALFORMED_PROVIDER_RESPONSE","PREFLIGHT_CAPABILITY_UNAVAILABLE","PREFLIGHT_STATE_UNAVAILABLE"]}},"required":["observation","error_code"],"additionalProperties":false}},"metadata":{"type":"object","properties":{"schema_version":{"type":"string","enum":["execution_verification_api_v0.1"]},"methodology_version":{"type":"string","enum":["execution_verification_v1"]},"observed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"finality":{"type":"string","enum":["unknown","unavailable"]},"executes_transaction":{"type":"boolean","enum":[false]},"authorizes_transaction":{"type":"boolean","enum":[false]}},"required":["schema_version","methodology_version","observed_at","finality","executes_transaction","authorizes_transaction"],"additionalProperties":false}},"required":["chain","transaction_hash","expectation","outcome","verification","realized_cost","observation_errors","metadata"],"additionalProperties":false},"examples":{"illustrative":{"summary":"Synthetic unavailable-evidence assessment; HTTP 200 is not VERIFIED","value":{"chain":{"chain_id":"8453","name":"Base Mainnet"},"transaction_hash":"0x1212121212121212121212121212121212121212121212121212121212121212","expectation":{"chain_id":"8453","inclusion":"included","receipt_status":"success"},"outcome":{"version":"execution_outcome_v1","id":"outcome-1","observedAt":"2026-01-01T00:00:00.000Z","chain":{"family":"evm","id":"8453"},"transactionHash":"0x1212121212121212121212121212121212121212121212121212121212121212","inclusion":"unknown","integrity":"coherent","block":{"number":null,"hash":null},"canonicality":"unknown","finality":"unknown","transaction":{"availability":"unavailable","from":null,"to":null,"toKnown":false,"value":null,"data":null,"completeness":"unavailable"},"receipt":{"availability":"unavailable","status":null,"gasUsed":null,"effectiveGasPrice":null,"l1DataFeeWei":null},"realizedL2FeeWei":null,"costCompleteness":"unavailable","totalExecutionCost":"unavailable","provenance":[{"id":"provenance-chain","observation":{"version":"provider_provenance_v1","capability":null,"chain":null,"observation":"chain_identity","observedAt":"2026-01-01T00:00:00.000Z","timeBasis":"observation_completed","declaredStateBinding":"unknown","stateBinding":"unknown","block":null,"availability":"available","completeness":"complete","unavailableReason":null,"canonicality":"unknown","finality":"unknown"}},{"id":"provenance-transaction","observation":{"version":"provider_provenance_v1","capability":null,"chain":null,"observation":"transaction_read","observedAt":"2026-01-01T00:00:00.000Z","timeBasis":"observation_completed","declaredStateBinding":"unknown","stateBinding":"unavailable","block":null,"availability":"unavailable","completeness":"unknown","unavailableReason":"unavailable","canonicality":"unknown","finality":"unknown"}},{"id":"provenance-receipt","observation":{"version":"provider_provenance_v1","capability":null,"chain":null,"observation":"receipt_read","observedAt":"2026-01-01T00:00:00.000Z","timeBasis":"observation_completed","declaredStateBinding":"unknown","stateBinding":"unavailable","block":null,"availability":"unavailable","completeness":"unknown","unavailableReason":"not_observed","canonicality":"unknown","finality":"unknown"}},{"id":"provenance-block","observation":{"version":"provider_provenance_v1","capability":null,"chain":null,"observation":"snapshot","observedAt":"2026-01-01T00:00:00.000Z","timeBasis":"observation_completed","declaredStateBinding":"unknown","stateBinding":"unavailable","block":null,"availability":"unavailable","completeness":"unknown","unavailableReason":"not_observed","canonicality":"unknown","finality":"unknown"}},{"id":"provenance-canonicality","observation":{"version":"provider_provenance_v1","capability":null,"chain":null,"observation":"canonicality_check","observedAt":"2026-01-01T00:00:00.000Z","timeBasis":"observation_completed","declaredStateBinding":"unknown","stateBinding":"unavailable","block":null,"availability":"unavailable","completeness":"unknown","unavailableReason":"not_observed","canonicality":"unknown","finality":"unknown"}}]},"verification":{"version":"execution_verification_result_v1","methodology":"execution_verification_v1","state":"INDETERMINATE","completeness":"partial","outcomeRef":"outcome-1","checks":[{"id":"check-1","dimension":"chain","state":"VERIFIED","reasonCode":"CHAIN_MATCH","evidenceRefs":["expectation-1","outcome-1"]},{"id":"check-2","dimension":"inclusion","state":"INDETERMINATE","reasonCode":"INCLUSION_UNAVAILABLE","evidenceRefs":["expectation-1","outcome-1"]},{"id":"check-3","dimension":"receipt_status","state":"INDETERMINATE","reasonCode":"RECEIPT_UNAVAILABLE","evidenceRefs":["expectation-1","receipt-1"]}],"reasonCodes":["CHAIN_MATCH","INCLUSION_UNAVAILABLE","RECEIPT_UNAVAILABLE"],"evidence":[{"id":"expectation-1","kind":"expectation","availability":"available","refs":[]},{"id":"provenance-chain","kind":"provenance","availability":"available","refs":[]},{"id":"provenance-transaction","kind":"provenance","availability":"unavailable","refs":[]},{"id":"provenance-receipt","kind":"provenance","availability":"unavailable","refs":[]},{"id":"provenance-block","kind":"provenance","availability":"unavailable","refs":[]},{"id":"provenance-canonicality","kind":"provenance","availability":"unavailable","refs":[]},{"id":"outcome-1","kind":"outcome","availability":"available","refs":["provenance-chain"]},{"id":"transaction-1","kind":"transaction","availability":"unavailable","refs":["outcome-1","provenance-transaction"]},{"id":"receipt-1","kind":"receipt","availability":"unavailable","refs":["outcome-1","provenance-receipt"]},{"id":"block-1","kind":"block","availability":"unavailable","refs":["outcome-1","provenance-block","provenance-canonicality"]},{"id":"cost-1","kind":"cost","availability":"unavailable","refs":["receipt-1"]},{"id":"check-1","kind":"check","availability":"available","refs":["expectation-1","outcome-1"]},{"id":"check-2","kind":"check","availability":"unavailable","refs":["expectation-1","outcome-1"]},{"id":"check-3","kind":"check","availability":"unavailable","refs":["expectation-1","receipt-1"]}]},"realized_cost":{"gas_used":null,"effective_gas_price_wei":null,"realized_l2_execution_fee_wei":null,"l1_data_fee_wei":null,"l1_data_fee_status":"unavailable","total_execution_cost_wei":null,"total_execution_cost_status":"unavailable","completeness":"unavailable","currency":"ETH","unit":"wei","basis":"observed_receipt"},"observation_errors":[{"observation":"transaction","error_code":"RPC_UNAVAILABLE"}],"metadata":{"schema_version":"execution_verification_api_v0.1","methodology_version":"execution_verification_v1","observed_at":"2026-01-01T00:00:00.000Z","finality":"unknown","executes_transaction":false,"authorizes_transaction":false}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"413":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"operationId":"verifyTransaction","externalDocs":{"description":"Canonical public guide","url":"https://github.com/dllio/dll-execution-docs/blob/main/VERIFICATION.md"},"security":[]}},"/v1/benchmark/transactions":{"post":{"summary":"Benchmark Base Mainnet transaction costs","tags":["benchmark"],"description":"Analyzes 1–100 Base Mainnet hashes. A verified Base SIWX wallet and Idempotency-Key are required. The first 3 valid benchmark analyses per wallet are free; further valid analyses use x402 V2 upto authorization in Base USDC. Only benchmark_status=available items without errors count as valid. Actual settlement is based on valid items, not requested hashes. PAYMENT_UNAVAILABLE and PAYMENT_FAILED_SAFE_TO_RETRY permit retry with the same key; PAYMENT_PENDING means retry the same key only to reconcile, never submit a second settlement. Successful paid responses contain PAYMENT_SETTLED.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"transaction_hashes":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"A 0x-prefixed 32-byte Base Mainnet transaction hash."}},"window":{"default":"24h","type":"string","enum":["1h","24h","7d"]}},"required":["transaction_hashes"]},"examples":{"illustrative":{"summary":"Public request example; consult the guide before calling","value":{"transaction_hashes":["0x6e0d0dc8cb8ee700ff723784444d2c02c2e5c17aeaef9b34136613cfee9cb01d"],"window":"24h"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"requested_transactions":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"unique_transactions":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"results":{"type":"array","items":{"type":"object","properties":{"transaction_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"A 0x-prefixed 32-byte Base Mainnet transaction hash."},"analysis_status":{"type":"string","enum":["analyzed","not_found","unavailable","invalid_response"]},"benchmark_status":{"type":"string","enum":["available","insufficient_data","unavailable"]},"persistence_status":{"type":"string","enum":["inserted","duplicate","failed","not_applicable"]},"coarse_transaction_type":{"anyOf":[{"type":"string","enum":["native_transfer","contract_call","contract_creation","unknown"]},{"type":"null"}]},"gas_used_bucket":{"anyOf":[{"type":"string","enum":["gas_0_50k","gas_50k_100k","gas_100k_200k","gas_200k_500k","gas_500k_1m","gas_1m_plus"]},{"type":"null"}]},"benchmark_window":{"type":"string","enum":["1h","24h","7d"]},"cohort_sample_count":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"execution_cost_benchmark":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["available","insufficient_data","unavailable"]},"sample_count":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"p25_wei":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"p50_wei":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"p75_wei":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"p90_wei":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"percentile_position":{"type":"string","enum":["below_p25","p25_to_p50","p50_to_p75","p75_to_p90","above_p90","insufficient_data","unavailable"]},"deviation_from_p50_percent":{"anyOf":[{"type":"string","pattern":"^-?(0|[1-9][0-9]*)\\.[0-9]{2}$"},{"type":"null"}]}},"required":["status","sample_count","p25_wei","p50_wei","p75_wei","p90_wei","percentile_position","deviation_from_p50_percent"],"additionalProperties":false},{"type":"null"}]},"total_cost_benchmark":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["available","insufficient_data","unavailable"]},"sample_count":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"p25_wei":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"p50_wei":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"p75_wei":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"p90_wei":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"percentile_position":{"type":"string","enum":["below_p25","p25_to_p50","p50_to_p75","p75_to_p90","above_p90","insufficient_data","unavailable"]},"deviation_from_p50_percent":{"anyOf":[{"type":"string","pattern":"^-?(0|[1-9][0-9]*)\\.[0-9]{2}$"},{"type":"null"}]}},"required":["status","sample_count","p25_wei","p50_wei","p75_wei","p90_wei","percentile_position","deviation_from_p50_percent"],"additionalProperties":false},{"type":"null"}]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"}},"required":["code"],"additionalProperties":false},{"type":"null"}]}},"required":["transaction_hash","analysis_status","benchmark_status","persistence_status","coarse_transaction_type","gas_used_bucket","benchmark_window","cohort_sample_count","execution_cost_benchmark","total_cost_benchmark","error"],"additionalProperties":false}},"metadata":{"type":"object","properties":{"chain":{"type":"string","enum":["Base Mainnet"]},"chain_id":{"type":"string","enum":["8453"]},"read_only":{"type":"boolean","enum":[true]},"pricing_currency":{"type":"string","enum":["native_eth_only"]},"minimum_sample_count":{"type":"string","enum":["20"]},"percentile_algorithm":{"type":"string","enum":["nearest_rank"]},"recommendation_provided":{"type":"boolean","enum":[false]}},"required":["chain","chain_id","read_only","pricing_currency","minimum_sample_count","percentile_algorithm","recommendation_provided"],"additionalProperties":false},"billing":{"type":"object","properties":{"status":{"type":"string","enum":["free","settled"]},"payment_code":{"type":"string","enum":["PAYMENT_NOT_REQUIRED","PAYMENT_SETTLED"]},"payment_state":{"type":"string","enum":["not_required","settled"]},"valid_analysis_count":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"free_valid_analysis_count":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"paid_valid_analysis_count":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"unit_price_usdc_atomic":{"type":"string","enum":["5000"]},"actual_settled_usdc_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"network":{"type":"string","enum":["eip155:84532","eip155:8453"]},"settlement_reference":{"type":["string","null"]}},"required":["status","payment_code","payment_state","valid_analysis_count","free_valid_analysis_count","paid_valid_analysis_count","unit_price_usdc_atomic","actual_settled_usdc_atomic","network","settlement_reference"],"additionalProperties":false}},"required":["requested_transactions","unique_transactions","results","metadata"],"additionalProperties":false},"examples":{"illustrative":{"summary":"Illustrative historical cost comparison, not live market data","value":{"requested_transactions":"1","unique_transactions":"1","results":[{"transaction_hash":"0x6e0d0dc8cb8ee700ff723784444d2c02c2e5c17aeaef9b34136613cfee9cb01d","analysis_status":"analyzed","benchmark_status":"available","persistence_status":"duplicate","coarse_transaction_type":"contract_call","gas_used_bucket":"gas_100k_200k","benchmark_window":"24h","cohort_sample_count":"20","execution_cost_benchmark":{"status":"available","sample_count":"20","p25_wei":"1000000000000","p50_wei":"2000000000000","p75_wei":"3000000000000","p90_wei":"4000000000000","percentile_position":"p50_to_p75","deviation_from_p50_percent":"0.00"},"total_cost_benchmark":null,"error":null}],"metadata":{"chain":"Base Mainnet","chain_id":"8453","read_only":true,"pricing_currency":"native_eth_only","minimum_sample_count":"20","percentile_algorithm":"nearest_rank","recommendation_provided":false},"billing":{"status":"settled","payment_code":"PAYMENT_SETTLED","payment_state":"settled","valid_analysis_count":"1","free_valid_analysis_count":"0","paid_valid_analysis_count":"1","unit_price_usdc_atomic":"5000","actual_settled_usdc_atomic":"5000","network":"eip155:8453","settlement_reference":null}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"402":{"description":"Read the base64-encoded x402 V2 PAYMENT-REQUIRED header; the JSON body is empty. Anonymous discovery includes a non-empty upto quote and Bazaar metadata. X-DLL-Benchmark-Stage=identity requires SIWX first, not payment; remaining free allowance may return HTTP 200 PAYMENT_NOT_REQUIRED without authorization. Stage=payment follows verified identity and requests a maximum of N × 5000 atomic USDC, not the final charge. Empty discovery probes describe the one-item example only and never execute it. Keep the same wallet, Idempotency-Key and exact body; sign fresh SIWX challenges, including the challenge binding to the exact payment envelope. PAYMENT_PENDING is HTTP 503: reconciliation only, not a new payment authorization. Synthetic examples are expired and cannot authenticate.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded JSON challenge. Decode before choosing identity or payment handling.","schema":{"type":"string","format":"byte"},"examples":{"anonymous_quote":{"summary":"Expired synthetic one-item discovery cap; identify first, not a charge","value":"eyJ4NDAyVmVyc2lvbiI6MiwiZXJyb3IiOiJQYXltZW50IHJlcXVpcmVkIiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cHM6Ly9leGVjdXRpb24uZGxsLmlvL3YxL2JlbmNobWFyay90cmFuc2FjdGlvbnMiLCJkZXNjcmlwdGlvbiI6IkJhc2UgTWFpbm5ldCBleGVjdXRpb24tZmVlIGFuYWx5c2lzIGZvciBvYnNlcnZlZCB0cmFuc2FjdGlvbnM6IGhpc3RvcmljYWwgcGVyY2VudGlsZXMgYW5kIGNvc3QgY29udGV4dCwgbm90IHJvdXRlIG9yIHByb2ZpdGFiaWxpdHkgYWR2aWNlLiBQT1NUIEpTT047IHByZXNlcnZlIElkZW1wb3RlbmN5LUtleS4gU0lXWCBmaXJzdCwgdGhlbiB4NDAyIHYyIHVwdG8gd2hlbiBwYWlkOiAkMC4wMDUgcGVyIGRlbGl2ZXJlZCB2YWxpZCBhbmFseXNpczsgZmlyc3QgMyBwZXIgdmVyaWZpZWQgd2FsbGV0IGZyZWUuIEZvciBOIHJlcXVlc3RlZCBoYXNoZXMsIHRoZSBwYWlkIGNhcCBpcyBOKjUwMDAgYXRvbWljIFVTREMsIG5vdCBzZXR0bGVtZW50LiBJbnNwZWN0IFgtRExMLUJlbmNobWFyay1TdGFnZTsgZ3VpZGU6IGh0dHBzOi8vZ2l0aHViLmNvbS9kbGxpby9kbGwtZXhlY3V0aW9uLWRvY3MvYmxvYi9tYWluL0JFTkNITUFSSy5tZC4iLCJtaW1lVHlwZSI6ImFwcGxpY2F0aW9uL2pzb24iLCJzZXJ2aWNlTmFtZSI6IkRMTCBFeGVjdXRpb24iLCJ0YWdzIjpbImJhc2UiLCJ0cmFuc2FjdGlvbiIsImV4ZWN1dGlvbi1jb3N0IiwiZ2FzIiwiYmVuY2htYXJrIl19LCJhY2NlcHRzIjpbeyJzY2hlbWUiOiJ1cHRvIiwibmV0d29yayI6ImVpcDE1NTo4NDUzIiwiYW1vdW50IjoiNTAwMCIsImFzc2V0IjoiMHg4MzM1ODlmQ0Q2ZURiNkUwOGY0YzdDMzJENGY3MWI1NGJkQTAyOTEzIiwicGF5VG8iOiIweDI1YTg1NTczRjRlZDU0NWY3YkQ2MWI4NThkZmQ4NzA2MUVBMDAxYTQiLCJtYXhUaW1lb3V0U2Vjb25kcyI6MzAwLCJleHRyYSI6eyJhc3NldFRyYW5zZmVyTWV0aG9kIjoicGVybWl0MiIsImZhY2lsaXRhdG9yQWRkcmVzcyI6IjB4MzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMyJ9fV0sImV4dGVuc2lvbnMiOnsic2lnbi1pbi13aXRoLXgiOnsiaW5mbyI6eyJkb21haW4iOiJleGVjdXRpb24uZGxsLmlvIiwidXJpIjoiaHR0cHM6Ly9leGVjdXRpb24uZGxsLmlvL3YxL2JlbmNobWFyay90cmFuc2FjdGlvbnMiLCJ2ZXJzaW9uIjoiMSIsIm5vbmNlIjoiMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDEiLCJpc3N1ZWRBdCI6IjIwMjYtMDEtMDFUMDA6MDA6MDAuMDAwWiIsInJlc291cmNlcyI6WyJodHRwczovL2V4ZWN1dGlvbi5kbGwuaW8vdjEvYmVuY2htYXJrL3RyYW5zYWN0aW9ucyJdLCJleHBpcmF0aW9uVGltZSI6IjIwMjYtMDEtMDFUMDA6MDU6MDAuMDAwWiJ9LCJzdXBwb3J0ZWRDaGFpbnMiOlt7ImNoYWluSWQiOiJlaXAxNTU6ODQ1MyIsInR5cGUiOiJlaXAxOTEifV0sInNjaGVtYSI6eyIkc2NoZW1hIjoiaHR0cHM6Ly9qc29uLXNjaGVtYS5vcmcvZHJhZnQvMjAyMC0xMi9zY2hlbWEiLCJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJkb21haW4iOnsidHlwZSI6InN0cmluZyJ9LCJhZGRyZXNzIjp7InR5cGUiOiJzdHJpbmcifSwic3RhdGVtZW50Ijp7InR5cGUiOiJzdHJpbmcifSwidXJpIjp7InR5cGUiOiJzdHJpbmciLCJmb3JtYXQiOiJ1cmkifSwidmVyc2lvbiI6eyJ0eXBlIjoic3RyaW5nIn0sImNoYWluSWQiOnsidHlwZSI6InN0cmluZyJ9LCJ0eXBlIjp7InR5cGUiOiJzdHJpbmcifSwibm9uY2UiOnsidHlwZSI6InN0cmluZyJ9LCJpc3N1ZWRBdCI6eyJ0eXBlIjoic3RyaW5nIiwiZm9ybWF0IjoiZGF0ZS10aW1lIn0sImV4cGlyYXRpb25UaW1lIjp7InR5cGUiOiJzdHJpbmciLCJmb3JtYXQiOiJkYXRlLXRpbWUifSwibm90QmVmb3JlIjp7InR5cGUiOiJzdHJpbmciLCJmb3JtYXQiOiJkYXRlLXRpbWUifSwicmVxdWVzdElkIjp7InR5cGUiOiJzdHJpbmcifSwicmVzb3VyY2VzIjp7InR5cGUiOiJhcnJheSIsIml0ZW1zIjp7InR5cGUiOiJzdHJpbmciLCJmb3JtYXQiOiJ1cmkifX0sInNpZ25hdHVyZSI6eyJ0eXBlIjoic3RyaW5nIn19LCJyZXF1aXJlZCI6WyJkb21haW4iLCJhZGRyZXNzIiwidXJpIiwidmVyc2lvbiIsImNoYWluSWQiLCJ0eXBlIiwibm9uY2UiLCJpc3N1ZWRBdCIsInNpZ25hdHVyZSJdfX0sImJhemFhciI6eyJpbmZvIjp7ImlucHV0Ijp7InR5cGUiOiJodHRwIiwiYm9keVR5cGUiOiJqc29uIiwiYm9keSI6eyJ0cmFuc2FjdGlvbl9oYXNoZXMiOlsiMHg2ZTBkMGRjOGNiOGVlNzAwZmY3MjM3ODQ0NDRkMmMwMmMyZTVjMTdhZWFlZjliMzQxMzY2MTNjZmVlOWNiMDFkIl0sIndpbmRvdyI6IjI0aCJ9LCJtZXRob2QiOiJQT1NUIn0sIm91dHB1dCI6eyJ0eXBlIjoianNvbiIsImV4YW1wbGUiOnsicmVxdWVzdGVkX3RyYW5zYWN0aW9ucyI6IjEiLCJ1bmlxdWVfdHJhbnNhY3Rpb25zIjoiMSIsInJlc3VsdHMiOlt7InRyYW5zYWN0aW9uX2hhc2giOiIweDZlMGQwZGM4Y2I4ZWU3MDBmZjcyMzc4NDQ0NGQyYzAyYzJlNWMxN2FlYWVmOWIzNDEzNjYxM2NmZWU5Y2IwMWQiLCJhbmFseXNpc19zdGF0dXMiOiJhbmFseXplZCIsImJlbmNobWFya19zdGF0dXMiOiJhdmFpbGFibGUiLCJwZXJzaXN0ZW5jZV9zdGF0dXMiOiJkdXBsaWNhdGUiLCJjb2Fyc2VfdHJhbnNhY3Rpb25fdHlwZSI6ImNvbnRyYWN0X2NhbGwiLCJnYXNfdXNlZF9idWNrZXQiOiJnYXNfMTAwa18yMDBrIiwiYmVuY2htYXJrX3dpbmRvdyI6IjI0aCIsImNvaG9ydF9zYW1wbGVfY291bnQiOiIyMCIsImV4ZWN1dGlvbl9jb3N0X2JlbmNobWFyayI6eyJzdGF0dXMiOiJhdmFpbGFibGUiLCJzYW1wbGVfY291bnQiOiIyMCIsInAyNV93ZWkiOiIxMDAwMDAwMDAwMDAwIiwicDUwX3dlaSI6IjIwMDAwMDAwMDAwMDAiLCJwNzVfd2VpIjoiMzAwMDAwMDAwMDAwMCIsInA5MF93ZWkiOiI0MDAwMDAwMDAwMDAwIiwicGVyY2VudGlsZV9wb3NpdGlvbiI6InA1MF90b19wNzUiLCJkZXZpYXRpb25fZnJvbV9wNTBfcGVyY2VudCI6IjAuMDAifSwidG90YWxfY29zdF9iZW5jaG1hcmsiOm51bGwsImVycm9yIjpudWxsfV0sIm1ldGFkYXRhIjp7ImNoYWluIjoiQmFzZSBNYWlubmV0IiwiY2hhaW5faWQiOiI4NDUzIiwicmVhZF9vbmx5Ijp0cnVlLCJwcmljaW5nX2N1cnJlbmN5IjoibmF0aXZlX2V0aF9vbmx5IiwibWluaW11bV9zYW1wbGVfY291bnQiOiIyMCIsInBlcmNlbnRpbGVfYWxnb3JpdGhtIjoibmVhcmVzdF9yYW5rIiwicmVjb21tZW5kYXRpb25fcHJvdmlkZWQiOmZhbHNlfSwiYmlsbGluZyI6eyJzdGF0dXMiOiJzZXR0bGVkIiwicGF5bWVudF9jb2RlIjoiUEFZTUVOVF9TRVRUTEVEIiwicGF5bWVudF9zdGF0ZSI6InNldHRsZWQiLCJ2YWxpZF9hbmFseXNpc19jb3VudCI6IjEiLCJmcmVlX3ZhbGlkX2FuYWx5c2lzX2NvdW50IjoiMCIsInBhaWRfdmFsaWRfYW5hbHlzaXNfY291bnQiOiIxIiwidW5pdF9wcmljZV91c2RjX2F0b21pYyI6IjUwMDAiLCJhY3R1YWxfc2V0dGxlZF91c2RjX2F0b21pYyI6IjUwMDAiLCJuZXR3b3JrIjoiZWlwMTU1Ojg0NTMiLCJzZXR0bGVtZW50X3JlZmVyZW5jZSI6bnVsbH19fX0sInNjaGVtYSI6eyIkc2NoZW1hIjoiaHR0cHM6Ly9qc29uLXNjaGVtYS5vcmcvZHJhZnQvMjAyMC0xMi9zY2hlbWEiLCJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJpbnB1dCI6eyJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJ0eXBlIjp7InR5cGUiOiJzdHJpbmciLCJjb25zdCI6Imh0dHAifSwibWV0aG9kIjp7InR5cGUiOiJzdHJpbmciLCJlbnVtIjpbIlBPU1QiXX0sImJvZHlUeXBlIjp7InR5cGUiOiJzdHJpbmciLCJlbnVtIjpbImpzb24iLCJmb3JtLWRhdGEiLCJ0ZXh0Il19LCJib2R5Ijp7InR5cGUiOiJvYmplY3QiLCJwcm9wZXJ0aWVzIjp7InRyYW5zYWN0aW9uX2hhc2hlcyI6eyJ0eXBlIjoiYXJyYXkiLCJkZXNjcmlwdGlvbiI6Ik9uZSB0byAxMDAgY29uZmlybWVkIEJhc2UgTWFpbm5ldCB0cmFuc2FjdGlvbiBoYXNoZXMuIiwibWluSXRlbXMiOjEsIm1heEl0ZW1zIjoxMDAsIml0ZW1zIjp7InR5cGUiOiJzdHJpbmciLCJwYXR0ZXJuIjoiXjB4WzAtOWEtZkEtRl17NjR9JCJ9fSwid2luZG93Ijp7InR5cGUiOiJzdHJpbmciLCJlbnVtIjpbIjFoIiwiMjRoIiwiN2QiXX19LCJyZXF1aXJlZCI6WyJ0cmFuc2FjdGlvbl9oYXNoZXMiXSwiYWRkaXRpb25hbFByb3BlcnRpZXMiOmZhbHNlfX0sInJlcXVpcmVkIjpbInR5cGUiLCJtZXRob2QiLCJib2R5VHlwZSIsImJvZHkiXSwiYWRkaXRpb25hbFByb3BlcnRpZXMiOmZhbHNlfSwib3V0cHV0Ijp7InR5cGUiOiJvYmplY3QiLCJwcm9wZXJ0aWVzIjp7InR5cGUiOnsidHlwZSI6InN0cmluZyJ9LCJleGFtcGxlIjp7InR5cGUiOiJvYmplY3QiLCJwcm9wZXJ0aWVzIjp7InJlcXVlc3RlZF90cmFuc2FjdGlvbnMiOnsidHlwZSI6InN0cmluZyIsInBhdHRlcm4iOiJeWzAtOV0rJCJ9LCJ1bmlxdWVfdHJhbnNhY3Rpb25zIjp7InR5cGUiOiJzdHJpbmciLCJwYXR0ZXJuIjoiXlswLTldKyQifSwicmVzdWx0cyI6eyJ0eXBlIjoiYXJyYXkiLCJpdGVtcyI6eyJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJ0cmFuc2FjdGlvbl9oYXNoIjp7InR5cGUiOiJzdHJpbmciLCJwYXR0ZXJuIjoiXjB4WzAtOWEtZkEtRl17NjR9JCJ9LCJhbmFseXNpc19zdGF0dXMiOnsidHlwZSI6InN0cmluZyIsImVudW0iOlsiYW5hbHl6ZWQiLCJub3RfZm91bmQiLCJ1bmF2YWlsYWJsZSIsImludmFsaWRfcmVzcG9uc2UiXX0sImJlbmNobWFya19zdGF0dXMiOnsidHlwZSI6InN0cmluZyIsImVudW0iOlsiYXZhaWxhYmxlIiwiaW5zdWZmaWNpZW50X2RhdGEiLCJ1bmF2YWlsYWJsZSJdfSwiZXhlY3V0aW9uX2Nvc3RfYmVuY2htYXJrIjp7InR5cGUiOlsib2JqZWN0IiwibnVsbCJdfSwidG90YWxfY29zdF9iZW5jaG1hcmsiOnsidHlwZSI6WyJvYmplY3QiLCJudWxsIl19LCJlcnJvciI6eyJ0eXBlIjpbIm9iamVjdCIsIm51bGwiXX19LCJyZXF1aXJlZCI6WyJ0cmFuc2FjdGlvbl9oYXNoIiwiYW5hbHlzaXNfc3RhdHVzIiwiYmVuY2htYXJrX3N0YXR1cyJdfX0sIm1ldGFkYXRhIjp7InR5cGUiOiJvYmplY3QifSwiYmlsbGluZyI6eyJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJzdGF0dXMiOnsidHlwZSI6InN0cmluZyIsImVudW0iOlsiZnJlZSIsInNldHRsZWQiXX0sInZhbGlkX2FuYWx5c2lzX2NvdW50Ijp7InR5cGUiOiJzdHJpbmciLCJwYXR0ZXJuIjoiXlswLTldKyQifSwiYWN0dWFsX3NldHRsZWRfdXNkY19hdG9taWMiOnsidHlwZSI6InN0cmluZyIsInBhdHRlcm4iOiJeWzAtOV0rJCJ9fSwicmVxdWlyZWQiOlsic3RhdHVzIiwidmFsaWRfYW5hbHlzaXNfY291bnQiLCJhY3R1YWxfc2V0dGxlZF91c2RjX2F0b21pYyJdfX0sInJlcXVpcmVkIjpbInJlcXVlc3RlZF90cmFuc2FjdGlvbnMiLCJ1bmlxdWVfdHJhbnNhY3Rpb25zIiwicmVzdWx0cyIsIm1ldGFkYXRhIiwiYmlsbGluZyJdfX0sInJlcXVpcmVkIjpbInR5cGUiXX19LCJyZXF1aXJlZCI6WyJpbnB1dCJdfX19fQ=="},"paid_upto":{"summary":"Expired synthetic one-item post-identity 5000-atomic-USDC Permit2 cap; placeholder binding, never authenticate or pay this example","value":"eyJ4NDAyVmVyc2lvbiI6MiwiZXJyb3IiOiJQYXltZW50IHJlcXVpcmVkIiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cHM6Ly9leGVjdXRpb24uZGxsLmlvL3YxL2JlbmNobWFyay90cmFuc2FjdGlvbnMiLCJkZXNjcmlwdGlvbiI6IkJhc2UgTWFpbm5ldCBleGVjdXRpb24tZmVlIGFuYWx5c2lzIGZvciBvYnNlcnZlZCB0cmFuc2FjdGlvbnM6IGhpc3RvcmljYWwgcGVyY2VudGlsZXMgYW5kIGNvc3QgY29udGV4dCwgbm90IHJvdXRlIG9yIHByb2ZpdGFiaWxpdHkgYWR2aWNlLiBQT1NUIEpTT047IHByZXNlcnZlIElkZW1wb3RlbmN5LUtleS4gU0lXWCBmaXJzdCwgdGhlbiB4NDAyIHYyIHVwdG8gd2hlbiBwYWlkOiAkMC4wMDUgcGVyIGRlbGl2ZXJlZCB2YWxpZCBhbmFseXNpczsgZmlyc3QgMyBwZXIgdmVyaWZpZWQgd2FsbGV0IGZyZWUuIEZvciBOIHJlcXVlc3RlZCBoYXNoZXMsIHRoZSBwYWlkIGNhcCBpcyBOKjUwMDAgYXRvbWljIFVTREMsIG5vdCBzZXR0bGVtZW50LiBJbnNwZWN0IFgtRExMLUJlbmNobWFyay1TdGFnZTsgZ3VpZGU6IGh0dHBzOi8vZ2l0aHViLmNvbS9kbGxpby9kbGwtZXhlY3V0aW9uLWRvY3MvYmxvYi9tYWluL0JFTkNITUFSSy5tZC4iLCJtaW1lVHlwZSI6ImFwcGxpY2F0aW9uL2pzb24iLCJzZXJ2aWNlTmFtZSI6IkRMTCBFeGVjdXRpb24iLCJ0YWdzIjpbImJhc2UiLCJ0cmFuc2FjdGlvbiIsImV4ZWN1dGlvbi1jb3N0IiwiZ2FzIiwiYmVuY2htYXJrIl19LCJhY2NlcHRzIjpbeyJzY2hlbWUiOiJ1cHRvIiwibmV0d29yayI6ImVpcDE1NTo4NDUzIiwiYW1vdW50IjoiNTAwMCIsImFzc2V0IjoiMHg4MzM1ODlmQ0Q2ZURiNkUwOGY0YzdDMzJENGY3MWI1NGJkQTAyOTEzIiwicGF5VG8iOiIweDI1YTg1NTczRjRlZDU0NWY3YkQ2MWI4NThkZmQ4NzA2MUVBMDAxYTQiLCJtYXhUaW1lb3V0U2Vjb25kcyI6MzAwLCJleHRyYSI6eyJhc3NldFRyYW5zZmVyTWV0aG9kIjoicGVybWl0MiIsImZhY2lsaXRhdG9yQWRkcmVzcyI6IjB4MzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMyJ9fV0sImV4dGVuc2lvbnMiOnsic2lnbi1pbi13aXRoLXgiOnsiaW5mbyI6eyJkb21haW4iOiJleGVjdXRpb24uZGxsLmlvIiwidXJpIjoiaHR0cHM6Ly9leGVjdXRpb24uZGxsLmlvL3YxL2JlbmNobWFyay90cmFuc2FjdGlvbnMiLCJ2ZXJzaW9uIjoiMSIsIm5vbmNlIjoiMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDEiLCJpc3N1ZWRBdCI6IjIwMjYtMDEtMDFUMDA6MDA6MDAuMDAwWiIsInJlc291cmNlcyI6WyJodHRwczovL2V4ZWN1dGlvbi5kbGwuaW8vdjEvYmVuY2htYXJrL3RyYW5zYWN0aW9ucyIsInVybjpkbGw6YmVuY2htYXJrOjAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAiXSwiZXhwaXJhdGlvblRpbWUiOiIyMDI2LTAxLTAxVDAwOjA1OjAwLjAwMFoiLCJzdGF0ZW1lbnQiOiJJZGVudGlmeSB0aGlzIHdhbGxldCBhbmQgYXNzb2NpYXRlIHRoaXMgcmVxdWVzdCB3aXRoIHRoZSBsaXN0ZWQgcmVzb3VyY2UuIFBheW1lbnQgYXV0aG9yaXphdGlvbiBpcyBzZXBhcmF0ZS4ifSwic3VwcG9ydGVkQ2hhaW5zIjpbeyJjaGFpbklkIjoiZWlwMTU1Ojg0NTMiLCJ0eXBlIjoiZWlwMTkxIn1dLCJzY2hlbWEiOnsiJHNjaGVtYSI6Imh0dHBzOi8vanNvbi1zY2hlbWEub3JnL2RyYWZ0LzIwMjAtMTIvc2NoZW1hIiwidHlwZSI6Im9iamVjdCIsInByb3BlcnRpZXMiOnsiZG9tYWluIjp7InR5cGUiOiJzdHJpbmcifSwiYWRkcmVzcyI6eyJ0eXBlIjoic3RyaW5nIn0sInN0YXRlbWVudCI6eyJ0eXBlIjoic3RyaW5nIn0sInVyaSI6eyJ0eXBlIjoic3RyaW5nIiwiZm9ybWF0IjoidXJpIn0sInZlcnNpb24iOnsidHlwZSI6InN0cmluZyJ9LCJjaGFpbklkIjp7InR5cGUiOiJzdHJpbmcifSwidHlwZSI6eyJ0eXBlIjoic3RyaW5nIn0sIm5vbmNlIjp7InR5cGUiOiJzdHJpbmcifSwiaXNzdWVkQXQiOnsidHlwZSI6InN0cmluZyIsImZvcm1hdCI6ImRhdGUtdGltZSJ9LCJleHBpcmF0aW9uVGltZSI6eyJ0eXBlIjoic3RyaW5nIiwiZm9ybWF0IjoiZGF0ZS10aW1lIn0sIm5vdEJlZm9yZSI6eyJ0eXBlIjoic3RyaW5nIiwiZm9ybWF0IjoiZGF0ZS10aW1lIn0sInJlcXVlc3RJZCI6eyJ0eXBlIjoic3RyaW5nIn0sInJlc291cmNlcyI6eyJ0eXBlIjoiYXJyYXkiLCJpdGVtcyI6eyJ0eXBlIjoic3RyaW5nIiwiZm9ybWF0IjoidXJpIn19LCJzaWduYXR1cmUiOnsidHlwZSI6InN0cmluZyJ9fSwicmVxdWlyZWQiOlsiZG9tYWluIiwiYWRkcmVzcyIsInVyaSIsInZlcnNpb24iLCJjaGFpbklkIiwidHlwZSIsIm5vbmNlIiwiaXNzdWVkQXQiLCJzaWduYXR1cmUiXX19LCJiYXphYXIiOnsiaW5mbyI6eyJpbnB1dCI6eyJ0eXBlIjoiaHR0cCIsImJvZHlUeXBlIjoianNvbiIsImJvZHkiOnsidHJhbnNhY3Rpb25faGFzaGVzIjpbIjB4NmUwZDBkYzhjYjhlZTcwMGZmNzIzNzg0NDQ0ZDJjMDJjMmU1YzE3YWVhZWY5YjM0MTM2NjEzY2ZlZTljYjAxZCJdLCJ3aW5kb3ciOiIyNGgifSwibWV0aG9kIjoiUE9TVCJ9LCJvdXRwdXQiOnsidHlwZSI6Impzb24iLCJleGFtcGxlIjp7InJlcXVlc3RlZF90cmFuc2FjdGlvbnMiOiIxIiwidW5pcXVlX3RyYW5zYWN0aW9ucyI6IjEiLCJyZXN1bHRzIjpbeyJ0cmFuc2FjdGlvbl9oYXNoIjoiMHg2ZTBkMGRjOGNiOGVlNzAwZmY3MjM3ODQ0NDRkMmMwMmMyZTVjMTdhZWFlZjliMzQxMzY2MTNjZmVlOWNiMDFkIiwiYW5hbHlzaXNfc3RhdHVzIjoiYW5hbHl6ZWQiLCJiZW5jaG1hcmtfc3RhdHVzIjoiYXZhaWxhYmxlIiwicGVyc2lzdGVuY2Vfc3RhdHVzIjoiZHVwbGljYXRlIiwiY29hcnNlX3RyYW5zYWN0aW9uX3R5cGUiOiJjb250cmFjdF9jYWxsIiwiZ2FzX3VzZWRfYnVja2V0IjoiZ2FzXzEwMGtfMjAwayIsImJlbmNobWFya193aW5kb3ciOiIyNGgiLCJjb2hvcnRfc2FtcGxlX2NvdW50IjoiMjAiLCJleGVjdXRpb25fY29zdF9iZW5jaG1hcmsiOnsic3RhdHVzIjoiYXZhaWxhYmxlIiwic2FtcGxlX2NvdW50IjoiMjAiLCJwMjVfd2VpIjoiMTAwMDAwMDAwMDAwMCIsInA1MF93ZWkiOiIyMDAwMDAwMDAwMDAwIiwicDc1X3dlaSI6IjMwMDAwMDAwMDAwMDAiLCJwOTBfd2VpIjoiNDAwMDAwMDAwMDAwMCIsInBlcmNlbnRpbGVfcG9zaXRpb24iOiJwNTBfdG9fcDc1IiwiZGV2aWF0aW9uX2Zyb21fcDUwX3BlcmNlbnQiOiIwLjAwIn0sInRvdGFsX2Nvc3RfYmVuY2htYXJrIjpudWxsLCJlcnJvciI6bnVsbH1dLCJtZXRhZGF0YSI6eyJjaGFpbiI6IkJhc2UgTWFpbm5ldCIsImNoYWluX2lkIjoiODQ1MyIsInJlYWRfb25seSI6dHJ1ZSwicHJpY2luZ19jdXJyZW5jeSI6Im5hdGl2ZV9ldGhfb25seSIsIm1pbmltdW1fc2FtcGxlX2NvdW50IjoiMjAiLCJwZXJjZW50aWxlX2FsZ29yaXRobSI6Im5lYXJlc3RfcmFuayIsInJlY29tbWVuZGF0aW9uX3Byb3ZpZGVkIjpmYWxzZX0sImJpbGxpbmciOnsic3RhdHVzIjoic2V0dGxlZCIsInBheW1lbnRfY29kZSI6IlBBWU1FTlRfU0VUVExFRCIsInBheW1lbnRfc3RhdGUiOiJzZXR0bGVkIiwidmFsaWRfYW5hbHlzaXNfY291bnQiOiIxIiwiZnJlZV92YWxpZF9hbmFseXNpc19jb3VudCI6IjAiLCJwYWlkX3ZhbGlkX2FuYWx5c2lzX2NvdW50IjoiMSIsInVuaXRfcHJpY2VfdXNkY19hdG9taWMiOiI1MDAwIiwiYWN0dWFsX3NldHRsZWRfdXNkY19hdG9taWMiOiI1MDAwIiwibmV0d29yayI6ImVpcDE1NTo4NDUzIiwic2V0dGxlbWVudF9yZWZlcmVuY2UiOm51bGx9fX19LCJzY2hlbWEiOnsiJHNjaGVtYSI6Imh0dHBzOi8vanNvbi1zY2hlbWEub3JnL2RyYWZ0LzIwMjAtMTIvc2NoZW1hIiwidHlwZSI6Im9iamVjdCIsInByb3BlcnRpZXMiOnsiaW5wdXQiOnsidHlwZSI6Im9iamVjdCIsInByb3BlcnRpZXMiOnsidHlwZSI6eyJ0eXBlIjoic3RyaW5nIiwiY29uc3QiOiJodHRwIn0sIm1ldGhvZCI6eyJ0eXBlIjoic3RyaW5nIiwiZW51bSI6WyJQT1NUIl19LCJib2R5VHlwZSI6eyJ0eXBlIjoic3RyaW5nIiwiZW51bSI6WyJqc29uIiwiZm9ybS1kYXRhIiwidGV4dCJdfSwiYm9keSI6eyJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJ0cmFuc2FjdGlvbl9oYXNoZXMiOnsidHlwZSI6ImFycmF5IiwiZGVzY3JpcHRpb24iOiJPbmUgdG8gMTAwIGNvbmZpcm1lZCBCYXNlIE1haW5uZXQgdHJhbnNhY3Rpb24gaGFzaGVzLiIsIm1pbkl0ZW1zIjoxLCJtYXhJdGVtcyI6MTAwLCJpdGVtcyI6eyJ0eXBlIjoic3RyaW5nIiwicGF0dGVybiI6Il4weFswLTlhLWZBLUZdezY0fSQifX0sIndpbmRvdyI6eyJ0eXBlIjoic3RyaW5nIiwiZW51bSI6WyIxaCIsIjI0aCIsIjdkIl19fSwicmVxdWlyZWQiOlsidHJhbnNhY3Rpb25faGFzaGVzIl0sImFkZGl0aW9uYWxQcm9wZXJ0aWVzIjpmYWxzZX19LCJyZXF1aXJlZCI6WyJ0eXBlIiwibWV0aG9kIiwiYm9keVR5cGUiLCJib2R5Il0sImFkZGl0aW9uYWxQcm9wZXJ0aWVzIjpmYWxzZX0sIm91dHB1dCI6eyJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJ0eXBlIjp7InR5cGUiOiJzdHJpbmcifSwiZXhhbXBsZSI6eyJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJyZXF1ZXN0ZWRfdHJhbnNhY3Rpb25zIjp7InR5cGUiOiJzdHJpbmciLCJwYXR0ZXJuIjoiXlswLTldKyQifSwidW5pcXVlX3RyYW5zYWN0aW9ucyI6eyJ0eXBlIjoic3RyaW5nIiwicGF0dGVybiI6Il5bMC05XSskIn0sInJlc3VsdHMiOnsidHlwZSI6ImFycmF5IiwiaXRlbXMiOnsidHlwZSI6Im9iamVjdCIsInByb3BlcnRpZXMiOnsidHJhbnNhY3Rpb25faGFzaCI6eyJ0eXBlIjoic3RyaW5nIiwicGF0dGVybiI6Il4weFswLTlhLWZBLUZdezY0fSQifSwiYW5hbHlzaXNfc3RhdHVzIjp7InR5cGUiOiJzdHJpbmciLCJlbnVtIjpbImFuYWx5emVkIiwibm90X2ZvdW5kIiwidW5hdmFpbGFibGUiLCJpbnZhbGlkX3Jlc3BvbnNlIl19LCJiZW5jaG1hcmtfc3RhdHVzIjp7InR5cGUiOiJzdHJpbmciLCJlbnVtIjpbImF2YWlsYWJsZSIsImluc3VmZmljaWVudF9kYXRhIiwidW5hdmFpbGFibGUiXX0sImV4ZWN1dGlvbl9jb3N0X2JlbmNobWFyayI6eyJ0eXBlIjpbIm9iamVjdCIsIm51bGwiXX0sInRvdGFsX2Nvc3RfYmVuY2htYXJrIjp7InR5cGUiOlsib2JqZWN0IiwibnVsbCJdfSwiZXJyb3IiOnsidHlwZSI6WyJvYmplY3QiLCJudWxsIl19fSwicmVxdWlyZWQiOlsidHJhbnNhY3Rpb25faGFzaCIsImFuYWx5c2lzX3N0YXR1cyIsImJlbmNobWFya19zdGF0dXMiXX19LCJtZXRhZGF0YSI6eyJ0eXBlIjoib2JqZWN0In0sImJpbGxpbmciOnsidHlwZSI6Im9iamVjdCIsInByb3BlcnRpZXMiOnsic3RhdHVzIjp7InR5cGUiOiJzdHJpbmciLCJlbnVtIjpbImZyZWUiLCJzZXR0bGVkIl19LCJ2YWxpZF9hbmFseXNpc19jb3VudCI6eyJ0eXBlIjoic3RyaW5nIiwicGF0dGVybiI6Il5bMC05XSskIn0sImFjdHVhbF9zZXR0bGVkX3VzZGNfYXRvbWljIjp7InR5cGUiOiJzdHJpbmciLCJwYXR0ZXJuIjoiXlswLTldKyQifX0sInJlcXVpcmVkIjpbInN0YXR1cyIsInZhbGlkX2FuYWx5c2lzX2NvdW50IiwiYWN0dWFsX3NldHRsZWRfdXNkY19hdG9taWMiXX19LCJyZXF1aXJlZCI6WyJyZXF1ZXN0ZWRfdHJhbnNhY3Rpb25zIiwidW5pcXVlX3RyYW5zYWN0aW9ucyIsInJlc3VsdHMiLCJtZXRhZGF0YSIsImJpbGxpbmciXX19LCJyZXF1aXJlZCI6WyJ0eXBlIl19fSwicmVxdWlyZWQiOlsiaW5wdXQiXX19fX0="}}},"X-DLL-Benchmark-Stage":{"description":"Identity negotiation versus post-identity payment authorization. Non-empty accepts alone does not mean a free-eligible wallet must pay.","schema":{"type":"string","enum":["identity","payment"]}},"Cache-Control":{"schema":{"type":"string"},"example":"no-store"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false},"examples":{"empty_body":{"summary":"Challenge is in the header, not this body","value":{}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Service/payment unavailable or pending. Inspect error.code. For PAYMENT_PENDING retry only the same wallet, Idempotency-Key and exact body to reconcile; do not submit a second settlement.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string"},"payment_state":{"type":"string"}},"required":["code","message","status_code"],"additionalProperties":false}},"required":["error"],"additionalProperties":false},"examples":{"illustrative":{"summary":"Synthetic pending settlement; reconciliation only","value":{"error":{"code":"PAYMENT_PENDING","message":"Settlement is unconfirmed. Retry this Idempotency-Key to reconcile; no new settlement will be submitted.","status_code":503,"retryable":true,"retry_after_seconds":5,"idempotency_key":"synthetic-benchmark-reconciliation","payment_state":"settlement_pending"}}}}}}}},"operationId":"benchmarkTransactions","externalDocs":{"description":"Canonical public guide","url":"https://github.com/dllio/dll-execution-docs/blob/main/BENCHMARK.md"},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128},"description":"Required for Benchmark execution/replay. Catalog-only anonymous probes may omit it but cannot authenticate or execute. Keep the same key, wallet identity and exact request body when reconciling or retrying; do not create a second settlement for PAYMENT_PENDING."},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string","format":"byte"},"description":"Official x402 v2 encoded Permit2 authorization, only after verified identity and independent spending approval. Not required for a fully free batch. Preserve the same envelope across fresh SIWX identity challenges; never create another authorization for PAYMENT_PENDING."}],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"dynamic","currency":"USD","min":"0.005","max":"0.500"},"x-billing-unit":"valid_analysis","x-unit-price-usd":"0.005","x-max-transactions-per-request":100,"x-free-valid-analyses-per-verified-wallet":3,"x-charge-semantics":"Only successfully delivered valid benchmark analyses are charged. Failed or invalid analyses neither incur a charge nor consume free quota. Actual upto settlement may be lower than the maximum authorization.","scheme":"upto","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x25a85573F4ed545f7bD61b858dfd87061EA001a4"},"security":[{"siwx":[]}]}},"/v1/inquiries":{"post":{"summary":"Submit an Agent inquiry or capability request","tags":["feedback"],"description":"Returns an opaque access token once. Poll status_url with Authorization: Bearer <access_token>. A rejected callback does not prevent polling.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","enum":["question","bug","feature_request","pricing","payment","integration","missing_capability","other"]},"requested_capability":{"type":"string","minLength":1,"maxLength":64},"message":{"type":"string","minLength":1,"maxLength":3000},"endpoint":{"type":"string","minLength":1,"maxLength":128},"callback_url":{"type":"string","minLength":1,"maxLength":512}},"required":["category","message"],"additionalProperties":false}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"inquiry_id":{"type":"string"},"access_token":{"type":"string"},"status":{"type":"string","enum":["received","reviewing","planned","building","available","declined"]},"message":{"type":"string"},"status_url":{"type":"string"},"callback_status":{"type":"string"},"created_at":{"type":"string"}},"required":["inquiry_id","access_token","status","message","status_url","callback_status","created_at"],"additionalProperties":false}}}}},"security":[]}},"/v1/inquiries/{id}":{"get":{"summary":"Poll inquiry status using the creation access token","tags":["feedback"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"inquiry_id":{"type":"string"},"status":{"type":"string","enum":["received","reviewing","planned","building","available","declined"]},"category":{"type":"string","enum":["question","bug","feature_request","pricing","payment","integration","missing_capability","other"]},"requested_capability":{"type":["string","null"]},"resolution_message":{"type":["string","null"]},"capability":{"type":["string","null"]},"docs_url":{"type":["string","null"]},"available_since":{"type":["string","null"]},"notification_status":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["inquiry_id","status","category","requested_capability","resolution_message","capability","docs_url","available_since","notification_status","created_at","updated_at"],"additionalProperties":false}}}}},"security":[{"inquiryAccessToken":[]}]}},"/openapi.json":{"get":{"summary":"OpenAPI document","tags":["discovery"],"responses":{"200":{"description":"Default Response"}},"security":[]}},"/.well-known/x402":{"get":{"summary":"x402 discovery compatibility manifest","tags":["discovery"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"number","enum":[1]},"resources":{"type":"array","items":{"type":"string","format":"uri"}}},"required":["version","resources"],"additionalProperties":false}}}}},"security":[]}}},"servers":[{"url":"https://execution.dll.io","description":"Configured public service origin"}],"tags":[{"name":"system","description":"Service state"},{"name":"discovery","description":"Machine-readable service discovery"},{"name":"commercial","description":"Machine-readable pricing and payment metadata"},{"name":"transactions","description":"Read-only Base Mainnet transaction data"},{"name":"analysis","description":"Read-only aggregate transaction cost analysis"},{"name":"benchmark","description":"Anonymous Base execution-cost benchmarks"},{"name":"feedback","description":"Agent inquiry and capability feedback"},{"name":"preflight","description":"Unsigned Base candidate assessment; no payment integration"},{"name":"verification","description":"Read-only observed execution verification; no payment integration"}],"externalDocs":{"description":"Public integration guides and capability selection","url":"https://github.com/dllio/dll-execution-docs"},"x-mcp":{"url":"https://execution.dll.io/mcp","transport":"streamable-http","version":"0.1.0","tools":["preflight_transaction","verify_transaction"]}}