{"openapi":"3.1.0","info":{"title":"Receipt Lens","version":"1.0.1","description":"Base native-USDC receipt evidence for 0.05 USDC per report. All block numbers, confirmations, token amounts, transfer log indexes and fee quantities are exact decimal strings. decimals is a JSON integer; verdict flags are booleans."},"servers":[{"url":"https://receipt-lens-8af7.beatrise-jansevska.chatgpt.site"}],"components":{"securitySchemes":{"X402":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 v2 authorization of the exact quoted Base native-USDC payment. Read the unpaid 402 quote first."}}},"paths":{"/v1/usdc-receipt":{"get":{"operationId":"checkUSDCReceipt","summary":"Compare one public Base native-USDC receipt with an exact expected recipient and amount.","description":"Response integer quantities are decimal strings to preserve precision. Read the free /sample for a real example. Invalid paid inputs and unavailable evidence are never settled.","security":[{"X402":[]}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USDC","amount":"0.05"},"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x42e68FF1c1C6848Dda785bbd5c5785841AAA3c1a"},"parameters":[{"name":"tx","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"Public Base transaction hash, including 0x."},"example":"0xfe0c6ac687c1741f617e58021aa6efc3b584aaae8536fef75a6de2f897d11ce1"},{"name":"recipient","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Expected public recipient address, including 0x."},"example":"0xf200174de10c26ce7670aaf41d69a8979fe5629d"},{"name":"amount","in":"query","required":true,"schema":{"type":"string","pattern":"^[1-9][0-9]{0,77}$","maxLength":78,"description":"Positive exact integer micro-USDC text, at most 2^256-1. One USDC is 1000000 micro-USDC."},"example":"20000"}],"responses":{"200":{"description":"Computed receipt evidence. Integer quantities are strings; decimals is an integer. The report is returned after successful settlement.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["transaction_failed","expected_payment_observed","recipient_amount_mismatch"]},"chainId":{"type":"string","const":"8453","description":"Base chain ID as an exact integer string."},"asset":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","const":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"decimals":{"type":"integer","const":6,"description":"USDC decimal precision. This field is a JSON integer."},"transactionHash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"blockHash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"blockNumber":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","description":"Receipt block number. Exact non-negative base-10 integer string; parse with BigInt, not Number."},"observedHeadBlock":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","description":"Head block seen by the same RPC observation. Exact non-negative base-10 integer string; parse with BigInt, not Number."},"observedConfirmations":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","description":"Observed head minus receipt block plus one. Exact non-negative base-10 integer string; parse with BigInt, not Number."},"expectedRecipient":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"expectedAmountMicroUSDC":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","description":"Expected amount in micro-USDC. Exact non-negative base-10 integer string; parse with BigInt, not Number."},"observedAmountToRecipientMicroUSDC":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","description":"Sum of matching native-USDC Transfer amounts to the expected recipient, in micro-USDC. Exact non-negative base-10 integer string; parse with BigInt, not Number."},"expectedPaymentObserved":{"type":"boolean"},"transfers":{"type":"array","maxItems":500,"items":{"type":"object","properties":{"from":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"to":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"amountMicroUSDC":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","description":"Transfer amount in micro-USDC. Exact non-negative base-10 integer string; parse with BigInt, not Number."},"logIndex":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","description":"Transfer position in the transaction receipt. Exact non-negative base-10 integer string; parse with BigInt, not Number."}},"required":["from","to","amountMicroUSDC","logIndex"],"additionalProperties":false}},"fees":{"type":"object","properties":{"gasUsed":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","description":"Execution gas used. Exact non-negative base-10 integer string; parse with BigInt, not Number."},"effectiveGasPriceWei":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","description":"Effective execution gas price, in wei. Exact non-negative base-10 integer string; parse with BigInt, not Number."},"executionFeeWei":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","description":"Execution gas used times effective gas price, in wei. Exact non-negative base-10 integer string; parse with BigInt, not Number."},"l1FeeWei":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$","description":"Separately reported L1 fee, in wei. Exact non-negative base-10 integer string; parse with BigInt, not Number."},{"type":"null"}],"description":"Exact integer string when supplied by RPC, otherwise null. Never inferred."}},"required":["gasUsed","effectiveGasPriceWei","executionFeeWei","l1FeeWei"],"additionalProperties":false},"limitations":{"type":"array","items":{"type":"string"}},"checkedAt":{"type":"string","format":"date-time"},"source":{"type":"string","format":"uri"},"evidenceHashSHA256":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"required":["status","chainId","asset","decimals","transactionHash","blockHash","blockNumber","observedHeadBlock","observedConfirmations","expectedRecipient","expectedAmountMicroUSDC","observedAmountToRecipientMicroUSDC","expectedPaymentObserved","transfers","fees","limitations","checkedAt","source","evidenceHashSHA256"],"additionalProperties":false}}}},"400":{"description":"Invalid input; no charge."},"402":{"description":"x402 v2 quote or rejected payment. PAYMENT-REQUIRED carries the Base native-USDC atomic amount and Bazaar input/output schemas."},"404":{"description":"Receipt missing; no charge."},"409":{"description":"Fewer than three observed confirmations; no charge."},"503":{"description":"Evidence unavailable or malformed; no charge."}}}}}}