DIP-1 Deterministic Dispute Adjudication
dip-file-disputeDeterministic machine-to-machine dispute resolution against signed XDR-1 execution receipts (DIP-1). Evaluates verifiable claims (NOT_DELIVERED, TIMEOUT_UNDELIVERED, OUTPUT_MISMATCH, SCHEMA) and issues non-custodial remedies.
Quickstart & Execution
curl -X POST https://api.code402.dev/v1/tools/dip-file-dispute/call \
-H "content-type: application/json" \
-d '{"dispute_id":"disp-101","receipt":{"v":"XDR-1","tool":"iban-check","payer":"0x1111111111111111111111111111111111111111","recipient":"0xc59c85e661d34084a7769f955d17fd38254a6235","amount":"999","ts":1700000000,"input_hash":"0x01","output_hash":"0x02","nonce":"0x01","signature":"0x01"},"claim":"NOT_DELIVERED"}'
No API key needed for the free daily tier. When daily quota exhausts, the endpoint replies with HTTP 402 Payment Required specifying the exact USDC amount. Machines sign an EIP-3009 transfer on Base L2; human engineers buy card credits. Every paid execution returns a cryptographically signed XDR-1 receipt for zero-knowledge audit trails.
Input Parameters
| Field | Type | Meaning & Constraints |
|---|---|---|
dispute_id (REQUIRED) | string | Unique dispute reference identifier |
receipt (REQUIRED) | object | Signed XDR-1 execution receipt being contested |
claim (REQUIRED) | string | Claim type: 'NOT_DELIVERED', 'TIMEOUT_UNDELIVERED', 'OUTPUT_MISMATCH', or 'SCHEMA' |
claimed_input | string | Original input payload or string for hash verification |
delivered_output | object | Delivered output payload received from seller |
refund_threshold_minor | string | USDC minor units threshold above which REFUND_ORDER_QUEUED is staged |
Response Format
Deterministic JSON payload fields: ok, standard, dispute_id, verdict, upheld, remedy, remedy_detail, receipt_digest. Paid responses also carry an offline-verifiable receipt object (XDR-1, secp256k1 signature recoverable to the authorized signer).
Related Conformance Tools
aci-trust-lookup pod-verify-delivery csp-commitment-create iso20022-validate iso20022-to-x402-intent iban-check lei-check vat-mod97-check company-number-format swift-bic-check aba-routing-check ein-format-check ifsc-check abn-check gstin-check cnpj-check uscc-check japan-corp-check kra-pin-check rfc-check iso4217-currency-check upi-vpa-check pan-format-check uae-trn-check isin-check sedol-check isbn-check ean13-check luhn-check e164-check pre-disbursement-guard vendor-onboarding-pack rent-deposit-guard rental-listing-risk rental-verdict india-supplier-check china-supplier-check japan-supplier-check latam-supplier-check gulf-supplier-check africa-supplier-check settlement-history-check balance-check erc20-balance tx-activity block-info ofac-sdn-check simulate-spend-sentinel create-ap2-pilot create-b2b-invoice get-b2b-invoice calculate-fx-savings fx-spot-price-oracle quote-3rd-party-insurance bind-insurance-policy list-approved-insurers batch-validate context-distill crypto-ticker instant-json-schema-verifier clean-markdown-scraper