Skip to main content

Execute Settlement

When you win, you settle in a single Sui programmable transaction block. If any protocol check fails, the transaction aborts and user funds remain safe.

Prepare

Before settlement, confirm you have:
  • Winning auction data and covered .
  • The signed settlement from the coordinator.
  • Liquidity needed to deliver payouts.
  • A Sui wallet with enough gas.

Steps

1
Verify authorization: check coordinator signature, solver address, epoch, and expiry.
2
Build the transaction: use the authorized intents, fills, payouts, and certificate.
3
Deliver payouts: execute your liquidity strategy and provide buy tokens to users.
4
Let contracts handle fees: settlement splits solver and protocol fee shares.
5
Submit and record the digest: return settlement results through the solver API.
Never split a CoW-cross settlement into separate transactions. Both legs must succeed or fail together.

Pre-submit checklist

  • Certificate has not expired.
  • Solver address matches your wallet.
  • Epoch matches current protocol state.
  • Intent IDs, fill amounts, and payouts are correct.
  • User minimums and partial-fill rules are respected.
  • Wallet has enough gas.

Solver API

Review /settle request and response details.

Fee formulas

Understand settlement fee calculations.
Last modified on June 23, 2026