code402 / tools / dip-file-dispute
$0.002 per call · 20 free calls/day · no signup · pay with card credits or a signed USDC voucher (x402)
Deterministic 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.
curl -X POST https://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 key needed for the free tier. When the free quota is used up, the API replies HTTP 402 with the exact price — agents sign the x402 voucher and retry; humans buy card credits. Every paid response carries a signed receipt you can verify offline.
| Field | Type | Meaning |
|---|---|---|
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 |
Top-level fields: ok, standard, dispute_id, verdict, upheld, remedy, remedy_detail, receipt_digest. Paid responses also carry a signed XDR-1 receipt.
Machine-readable catalog: llms-full.txt · MCP manifest · OpenAPI. Operated by JUANA LIMITED (UK Co. No. 14043409). Non-custodial: USDC settles payer→seller directly on Base.