How do I install the X402r Dispute skill?

Run npx skillmds add modbender/x402r-dispute in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the X402r Dispute skill do?

Pay merchants and file payment disputes on the x402r refundable payments protocol It is listed under Coding & Dev Tools on SkillMD.

Is X402r Dispute safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with X402r Dispute?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is X402r Dispute free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published X402r Dispute?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

X402r Dispute by modbender — Agent Skill

Name: X402r Dispute
Rating: 4.5 (4 reviews)
Author: modbender

File contents

x402r CLI

You 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.

Setup

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

Commands

pay

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.

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>

status

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

show

npx --yes @x402r/cli show

Show all evidence (payer, merchant, arbiter) for a dispute. Options: -p/--payment-json, -n/--nonce

verify

npx --yes @x402r/cli verify

Replay the arbiter's AI evaluation to verify the commitment hash is deterministic. Options: -p/--payment-json, -n/--nonce

list

npx --yes @x402r/cli list

List disputes from the arbiter. Options: -r/--receiver <addr>, --offset <n>, --count <n>

Typical Workflow

npx --yes @x402r/cli pay <merchant-url> — escrow payment, saves state
npx --yes @x402r/cli dispute "reason" --evidence "details" — files dispute
npx --yes @x402r/cli status — check arbiter ruling
npx --yes @x402r/cli show — view evidence from all parties
npx --yes @x402r/cli verify — verify ruling was deterministic

Notes

State chains between commands: pay saves for dispute, dispute saves for status/show/verify.
Without saved state, pass --payment-json and --nonce explicitly.
verify requires the arbiter server — no on-chain fallback.

---name: x402r-disputedescription: Pay merchants and file payment disputes on the x402r refundable payments protocol--- # x402r CLI You 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. ## Setup ```bash 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` ## Commands ### pay ```bash 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. ### dispute ```bash 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>` ### status ```bash 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` ### show ```bash npx --yes @x402r/cli show ``` Show all evidence (payer, merchant, arbiter) for a dispute. Options: `-p/--payment-json`, `-n/--nonce` ### verify ```bash npx --yes @x402r/cli verify ``` Replay the arbiter's AI evaluation to verify the commitment hash is deterministic. Options: `-p/--payment-json`, `-n/--nonce` ### list ```bash npx --yes @x402r/cli list ``` List disputes from the arbiter. Options: `-r/--receiver <addr>`, `--offset <n>`, `--count <n>` ## Typical Workflow 1. `npx --yes @x402r/cli pay <merchant-url>` — escrow payment, saves state 2. `npx --yes @x402r/cli dispute "reason" --evidence "details"` — files dispute 3. `npx --yes @x402r/cli status` — check arbiter ruling 4. `npx --yes @x402r/cli show` — view evidence from all parties 5. `npx --yes @x402r/cli verify` — verify ruling was deterministic ## Notes - State chains between commands: `pay` saves for `dispute`, `dispute` saves for `status`/`show`/`verify`. - Without saved state, pass `--payment-json` and `--nonce` explicitly. - `verify` requires the arbiter server — no on-chain fallback.

Frequently asked questions