Guarantees

File, dispute and resolve a claim

The claim lifecycle for bonds: file, challenge window, dispute, arbiter.

Claim bonds pay after a claim that nobody disputes, or that the arbiter approves. All actions are on the bond's certificate page.

  1. 01
    File
    Beneficiary: amount + evidence
  2. 02
    Challenge window
    Principal or owner may dispute
  3. 03
    Execute
    Undisputed: anyone, after the window
  4. 04
    Resolve
    Disputed: arbiter decides within 7 days

File a claim#

The beneficiary files with an amount and evidence: a link or file reference. Only its hash (bytes32) is stored onchain, so keep the original. This calls fileClaim(id, amount, evidence).

  • The amount must be more than zero and no more than the cover remaining, or the call reverts with ExceedsCap().
  • Only one claim can be open at a time (BadParams() otherwise).
  • Claims can only be filed before expiry (TooLate() after).
  • After a rejection, the beneficiary must wait one challenge window before filing again (TooEarly()).

Dispute a claim#

The principal or the vault owner can dispute during the challenge window with disputeClaim(id). After the window, the claim can no longer be disputed (TooLate()). The dispute time is recorded; it starts the arbiter's 7-day clock.

Execute a claim#

Anyone can call executeClaim(id, up, lo), and the keeper does it automatically:

  • an undisputed claim, once the challenge window has passed;
  • a disputed claim the arbiter left unresolved for more than 7 days (RESOLVE_WINDOW). The default outcome is to pay.

The vault pays the claim through the payout waterfall.

Resolve a disputed claim#

The arbiter calls resolveClaim(id, approve, up, lo) within 7 days of the dispute (TooLate() after):

  • Approve: the vault pays the claim.
  • Reject: the claim is closed and the cover stays intact. The beneficiary may file a new claim after one challenge window, before expiry.

Who can do what#

ActionBeneficiaryPrincipalOwnerArbiterAnyone
FileYes
Dispute (within window)YesYes
Execute (undisputed, after window)YesYesYesYesYes
Execute (disputed, after 7 days unresolved)YesYesYesYesYes
Resolve (disputed, within 7 days)Yes
Release the bond early (no open claim)Yes

Timeline example#

With a 48-hour challenge window:

TimeEvent
Day 0Beneficiary files a 500 MUSD claim.
Day 1Principal disputes. The arbiter has until day 8.
Day 3Arbiter rejects. Cover is intact.
Day 5Earliest the beneficiary can file again (one window after the rejection).

If the arbiter had done nothing, anyone could execute the claim after day 8 and it would pay.

Choose the arbiter carefully

A disputed claim depends on the arbiter, and an absent arbiter means the claim pays by default. The arbiter cannot be the vault owner, the beneficiary or the principal. Pick someone both sides trust, and agree on it before the bond is created.

Last updated 16 November 2026Suggest an edit on GitHub