{"openapi":"3.1.0","info":{"title":"Evidenode","version":"1.0","description":"Base token evidence for execution logs. Experimental. Fixed-block observations, not a safety guarantee.","contact":{"email":"t@ineeza.com"}},"servers":[{"url":"https://www.evidenode.com"}],"paths":{"/v1/token-evidence":{"post":{"operationId":"getTokenEvidence","summary":"Purchase fixed-block Base token evidence","description":"Price: 0.02 USDC per successful request via x402 v2. First request returns 402 and PAYMENT-REQUIRED. An x402 buyer signs payment, retries with PAYMENT-SIGNATURE, and receives JSON plus PAYMENT-RESPONSE after settlement. Validation and analysis errors are not settled. Receipts are public for 30 days. A storage failure after settlement still returns purchased JSON with X-Evidenode-Receipt: unavailable. Do not automatically retry a signed payment on ambiguous network failures.","x-x402":{"version":2,"network":"eip155:8453","price":"0.02","currency":"USDC","enabled":false},"parameters":[{"in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"},"description":"Base64 x402 v2 signed payment created by an official buyer SDK. Never provide private keys to Evidenode."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["address"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Base contract address; mixed-case addresses require a valid EIP-55 checksum.","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}}}}}},"responses":{"200":{"description":"Settled purchase; fixed-block evidence","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"Base64 settlement response, including transaction hash"},"X-Evidenode-Receipt":{"schema":{"type":"string","enum":["stored","unavailable"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenEvidence"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Payment required, invalid or settlement failed","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64 x402 v2 requirements; this header is authoritative for network, asset, amount and recipient"}}},"404":{"description":"No contract code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Insufficient ERC-20 observations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Request limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"Provider failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Service or payments unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"504":{"description":"Provider timeout","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/sample":{"get":{"operationId":"getHistoricalSample","summary":"Free historical USDC snapshot; not a live analysis","responses":{"200":{"description":"Historical sample","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenEvidence"}}}}}}},"/v1/receipts/{receiptId}":{"get":{"operationId":"getReceipt","summary":"Retrieve a public purchased receipt","parameters":[{"in":"path","name":"receiptId","required":true,"schema":{"type":"string","pattern":"^ev_[a-f0-9]{64}$"}}],"responses":{"200":{"description":"Stored evidence","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenEvidence"}}}},"404":{"description":"Receipt missing or expired"},"503":{"description":"Storage unavailable"}}}}},"components":{"schemas":{"TokenEvidence":{"type":"object","properties":{"schemaVersion":{"type":"string","const":"1.0"},"receiptId":{"type":"string","pattern":"^ev_[a-f0-9]{64}$"},"chain":{"type":"object","properties":{"name":{"type":"string","const":"base"},"chainId":{"type":"number","const":8453}},"required":["name","chainId"],"additionalProperties":false},"subject":{"type":"object","properties":{"type":{"type":"string","const":"erc20_contract"},"address":{"type":"string"},"name":{"type":["string","null"]},"symbol":{"type":["string","null"]},"decimals":{"anyOf":[{"type":"integer","minimum":0,"maximum":255},{"type":"null"}]},"totalSupply":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]}},"required":["type","address","name","symbol","decimals","totalSupply"],"additionalProperties":false},"assessment":{"type":"object","properties":{"status":{"type":"string","enum":["low_risk_signals","caution","high_risk_signals","insufficient_data"]},"summary":{"type":"string"},"rulesetVersion":{"type":"string","const":"1.0"}},"required":["status","summary","rulesetVersion"],"additionalProperties":false},"findings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"severity":{"type":"string","enum":["info","low","medium","high","critical"]},"status":{"type":"string","enum":["pass","warning","fail","unknown"]},"title":{"type":"string"},"description":{"type":"string"},"evidence":{"minItems":1,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["rpc_call","storage_slot","bytecode","contract_call"]},"method":{"type":"string"},"value":{"description":"Raw JSON RPC observation"},"blockNumber":{"type":"string","pattern":"^\\d+$"}},"required":["type","method","value","blockNumber"],"additionalProperties":false}}},"required":["id","severity","status","title","description","evidence"],"additionalProperties":false}},"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))$"},"blockNumber":{"type":"string","pattern":"^\\d+$"},"limitations":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","receiptId","chain","subject","assessment","findings","observedAt","blockNumber","limitations"],"additionalProperties":false},"ApiError":{"type":"object","properties":{"schemaVersion":{"type":"string","const":"1.0"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"description":"Raw JSON RPC observation"}},"required":["code","message"],"additionalProperties":false}},"required":["schemaVersion","error"],"additionalProperties":false}}}}