Resolution

Market resolution flow

After a market’s closeTime passes, the designated resolver posts the real-world outcome. Arcium’s MPC nodes then decrypt the encrypted bet pool and compute payout ratios. A challenge window follows before the market becomes claimable.

resolveMarket

Posts the real-world outcome and triggers the Arcium MPC reveal circuit. Only the wallet set as resolver at market creation can call this.

TypeScript

const result = await client.actions.resolveMarket({
  payer: resolverPublicKey,
  resolver: resolverPublicKey,
  marketId: 42n,
  outcomeValue: 1, // 0 = NO/Option0, 1 = YES/Option1, 2+ for multi
  onProgress: ({ stage }) => console.log(stage),
});

After this call the market moves to PendingResolution (state 4). The Arcium callback writes revealed pool sizes and the payout ratio. The market does not become Resolved until finalizeResolution is called (or the challenge window elapses undisputed).

Parameters

PublicKey

required

Transaction fee payer.

PublicKey

required

Must match market.resolver on-chain. Any other key throws UnauthorizedResolver (error 6005).

bigint | number

required

Market to resolve. Must be in awaitingResolve phase (past closeTime, not yet revealed).

number

required

Winning outcome index. For YesNo: 0 = NO, 1 = YES. For MultiOutcome: 0-(numOutcomes - 1).

bigint

Arcium computation slot. Random by default.

number

Milliseconds to wait for the MPC callback. Defaults to 60_000.

ProgressCallback

Progress callback. Stages: validating → fetching-state → submitting → awaiting-callback → refetching → done.

Return value

string

Transaction signature.

MarketAccount | null

Market account after the reveal callback ran. Check market.state - it will be 4 (PendingResolution) at this point.

ComputationResult

Arcium callback result.

flagResolution v0.2+

Flags a pending resolution as disputed during the challenge window. Permissionless - anyone can call this if they believe the outcome is wrong.

TypeScript

const flag = await client.actions.flagResolution({
  flagger: walletPublicKey,
  marketId: 42n,
});

PublicKey

required

Caller’s public key (any wallet).

bigint | number

required

A market in PendingResolution (state 4) that has not yet been flagged.

After flagging, the market enters a disputed state. Payouts are blocked until an admin calls adminOverrideResolution.

finalizeResolution v0.2+

Finalizes a pending resolution after the challenge window elapses undisputed. Permissionless - anyone can call this to move the market to Resolved.

TypeScript

const finalize = await client.actions.finalizeResolution({
  caller: walletPublicKey,
  marketId: 42n,
});

PublicKey

required

Any wallet (permissionless).

bigint | number

required

A market in PendingResolution that is not disputed and whose challengePeriod has elapsed.

After this call the market state becomes Resolved and claim_deadline is set, opening the payout window.

adminOverrideResolution v0.2+

Overrides the outcome on a disputed market. Admin-only.

TypeScript

const override = await client.actions.adminOverrideResolution({
  admin: adminPublicKey,
  marketId: 42n,
  outcomeValue: 0, // corrected outcome
});

PublicKey

required

Must match globalState.admin on-chain.

bigint | number

required

A disputed market in PendingResolution.

number

required

Corrected outcome index. The program recomputes payout_ratio from the already-revealed plaintext pools using this value.

After this call the market moves to Resolved and the ResolutionOverriddenEvent is emitted.

Phase gate reference

Action	Required phase	Required state
`resolveMarket`	`awaitingResolve`	Active or Closed, past `closeTime`
`flagResolution`	`pendingResolution`	PendingResolution (4), not disputed
`finalizeResolution`	`awaitingFinalize`	PendingResolution (4), not disputed, window elapsed
`adminOverrideResolution`	`disputed`	PendingResolution (4), disputed

Get started

React

Actions

Reference

Changelog

Market resolution flow

resolveMarket

Parameters

Return value

flagResolution v0.2+

finalizeResolution v0.2+

adminOverrideResolution v0.2+

Phase gate reference

​Market resolution flow

​resolveMarket

​Parameters

​Return value

​flagResolution v0.2+

​finalizeResolution v0.2+

​adminOverrideResolution v0.2+

​Phase gate reference

Market resolution flow

resolveMarket

Parameters

Return value

flagResolution v0.2+

finalizeResolution v0.2+

adminOverrideResolution v0.2+

Phase gate reference