Install
openclaw skills install x402r-disputeClawHub Security found sensitive or high-impact capabilities. Review the scan results before using.
Pay merchants and file payment disputes on the x402r refundable payments protocol
openclaw skills install x402r-disputeYou help users make escrow payments and file payment disputes on the x402r protocol. The x402r protocol adds refundable payments to HTTP 402 — buyers can request refunds through on-chain arbitration.
npx --yes @x402r/cli config --key <private-key> --arbiter-url https://www.moltarbiter.com/arbiter
Operator, network, and RPC are auto-discovered from the arbiter. The wallet needs Base Sepolia ETH (gas) and USDC (payments).
Test merchant: https://fantastic-optimism-production-602a.up.railway.app/weather
npx --yes @x402r/cli pay <url>
npx --yes @x402r/cli pay <url> --output response.json
Makes an escrow payment. Saves payment info to ~/.x402r/last-payment.json for later dispute.
npx --yes @x402r/cli dispute "reason" --evidence "details"
Creates on-chain refund request + submits evidence in one step. Uses saved payment info from pay. Prints a dashboard link.
Options: -e/--evidence <text>, -f/--file <path>, -p/--payment-json <json>, -n/--nonce <n>, -a/--amount <n>
npx --yes @x402r/cli status
Check dispute status. Tries arbiter API first, falls back to on-chain. Options: --id <compositeKey>, -p/--payment-json, -n/--nonce
npx --yes @x402r/cli show
Show all evidence (payer, merchant, arbiter) for a dispute. Options: -p/--payment-json, -n/--nonce
npx --yes @x402r/cli verify
Replay the arbiter's AI evaluation to verify the commitment hash is deterministic. Options: -p/--payment-json, -n/--nonce
npx --yes @x402r/cli list
List disputes from the arbiter. Options: -r/--receiver <addr>, --offset <n>, --count <n>
npx --yes @x402r/cli pay <merchant-url> — escrow payment, saves statenpx --yes @x402r/cli dispute "reason" --evidence "details" — files disputenpx --yes @x402r/cli status — check arbiter rulingnpx --yes @x402r/cli show — view evidence from all partiesnpx --yes @x402r/cli verify — verify ruling was deterministicpay saves for dispute, dispute saves for status/show/verify.--payment-json and --nonce explicitly.verify requires the arbiter server — no on-chain fallback.