Filing a Dispute¶

The Arbitrable's only write into the Accord. create_dispute custodies the round-0 fee and opens a Dispute PDA.

Args¶

Arg	Type	Notes
`options`	`Vec<[u8; 32]>`	2..=`MAX_OPTIONS` (32). Option label hashes.
`evidence_hash`	`[u8; 32]`	ADR-0006 commitment.
`nonce`	`u64`	Caller-chosen; PDA uniqueness (`["dispute", filer, nonce]`).
`fee`	`u64`	Must equal `jurors_per_dispute · fee_per_juror`.

Gates¶

Gate	Error
`!pause_state.paused`	`ProgramPaused`
`2 ≤ options.len() ≤ 32`	`InvalidOptions`
`fee == jurors_per_dispute · fee_per_juror`	`FeeMismatch`
`subaccord.staker_count ≥ jurors_per_dispute`	`InsufficientJurors`

Fee¶

fee = jurors_per_dispute × fee_per_juror      // moves filer ATA → vault

The fee is authoritative on-chain: the filer signs the exact charge. Appeal-round fees are paid by the appellant (appeals).

let required_fee = (subaccord.jurors_per_dispute as u64) * subaccord.fee_per_juror;
accord::cpi::create_dispute(
    cpi_ctx,
    vec![option_a_hash, option_b_hash],
    evidence_hash,
    nonce,
    required_fee,
)?;
// dispute PDA = ["dispute", filer, nonce]

import { createDispute, findDisputePda } from "@accord/sdk";

const { instruction, dispute } = await createDispute(
  accord.adapter,
  accord.PROGRAM_ID,
  {
    subaccord,
    filer: payer.address,
    options: [hA, hB],
    evidenceHash,
    fee: requiredFee,
  },
);

State after: Created. Next crank step: post_snapshot. Why party-agnostic: ADR-0004.