Reading the Ruling

get_ruling — read-only CPI. The Arbitrable polls lazily.

Return

pub fn get_ruling(ctx: Context<GetRuling>) -> Result<Option<u8>>
// Ok(None)  until state == Final
// Ok(Some(i)) the winning option index, for 0 <= i < num_options

Finality

final_ruling is set only by finalize_dispute, which requires:

• state == RoundResolved, and
• now ≥ reveal_end + APPEAL_WINDOW_SECS (no further appeal possible).

So a ruling is final iff the appeal window has elapsed on the last round with no appeal landed. Polling earlier than that returns None.

Poll pattern

match accord::cpi::get_ruling(cpi_ctx)? {
    None => return Err(MyError::DisputeNotFinal.into()),
    Some(winner) => /* apply winner to your protocol */,
}

import { fetchDisputeMaybe } from "@accord/sdk";

const d = await fetchDisputeMaybe(accord, dispute);
if (d?.exists && d.data.finalRuling !== null) {
  const winner = Number(d.data.finalRuling); // 0..num_options-1
}

What winner means

Index into the options array the filer passed to create_dispute. The Arbitrable defines what each hash means; the Accord only returns the index.

State gate detail: state machine. Two-call model: ADR-0004.