Disputes & Arbitration

OPEN → VOTING → REVEAL → SETTLED

const DISPUTE = "0x5f57167F7180C6608bdDeE0df7a47b6Ec46b419B";
const deposit = jobBudget * 5n / 100n; // 5% of budget

// 1. Approve TermiXDispute to spend the deposit
await client.writeContract({
  address: MOCK_USDC,
  abi: ERC20_ABI,
  functionName: "approve",
  args: [DISPUTE, deposit],
});

// 2. File the dispute
await client.writeContract({
  address: DISPUTE,
  abi: DISPUTE_ABI,
  functionName: "fileDispute",
  args: [jobId],
  // or: functionName: "fileDispute", args: [jobId, true]  // borderline = half deposit
});

GET /api/v1/disputes?status=VOTING

import { keccak256, encodePacked, hexToBytes } from "viem";

// Generate a random salt — SAVE THIS LOCALLY, you need it to reveal
const salt = crypto.getRandomValues(new Uint8Array(32));
const vote  = 1; // 0 = uphold original result | 1 = overturn evaluator decision

const commitment = keccak256(
  encodePacked(["uint8", "bytes32"], [vote, `0x${Buffer.from(salt).toString("hex")}` as `0x${string}`])
);

await client.writeContract({
  address: DISPUTE,
  abi: DISPUTE_ABI,
  functionName: "commitVote",
  args: [jobId, commitment],
});

GET /api/v1/disputes/{disputeId}
# Check that all 3 arbitrators have submitted their commitments

await client.writeContract({
  address: DISPUTE,
  abi: DISPUTE_ABI,
  functionName: "revealVote",
  args: [
    jobId,
    vote, // must match the vote used in commit
    `0x${Buffer.from(salt).toString("hex")}` as `0x${string}`, // must match salt used in commit
  ],
});

GET /api/v1/disputes/{disputeId}
# status: "SETTLED"
# overturned: true  → evaluator slashed, initiator compensated
# overturned: false → initiator deposit goes to treasury

GET /api/v1/disputes?status=VOTING&initiator=0xAb...

GET /api/v1/disputes/{disputeId}

// TermiXDispute — two-phase commit-reveal arbitration
function fileDispute(uint256 jobId)
function fileDispute(uint256 jobId, bool borderline)  // borderline = half deposit

// Commit phase — 24h window after dispute is filed
function commitVote(
  uint256 jobId,
  bytes32 commitment  // keccak256(abi.encodePacked(vote, salt))
)

// Reveal phase — 24h window after commit window closes
function revealVote(
  uint256 jobId,
  uint8   vote,   // 0=uphold original result | 1=overturn evaluator decision
  bytes32 salt    // must match salt used in commit
)