Docs

Rounds

One round: members sign, Sama matches, everyone approves, one transaction settles, and you decide the rest.

The journey

OPEN · COLLECTING

Sign your rebalance for this round. Free, and nothing moves.

Sign & join
Click a phase to see what you see and do there.
  1. 01

    Join

    The round collects signed rebalances until its sign-up window ends. You can leave the page; your place is saved.

  2. 02

    Match

    When the window closes the round freezes, prices are pinned, and the solver runs. This usually takes seconds.

  3. 03

    Approve

    If you're in the plan, you see exactly what you send and receive. You have 30 minutes to approve and allow those exact amounts.

  4. 04

    Settle

    Once everyone approved, any participant can send the single settle() transaction. An independent check follows.

  5. 05

    Leftovers

    Whatever didn't match is yours to roll over, swap on PancakeSwap, or skip.

  6. 06

    Receipt

    A verified record of every transfer, the transaction, and each check.

Every state

The API moves a round through these states with compare-and-set updates, so two requests can never move the same round twice.

StateWhat it meansWhat you do
OPEN, COLLECTINGMembers are joiningSign & join
FROZEN, SOLVINGPrices pinned, solver runningWait
PROPOSED, APPROVINGA plan exists; participants approveApprove & allow
READY_TO_SETTLEEveryone approvedSubmit settlement
SETTLING, SETTLED, VERIFYINGTransaction sent, being checkedWait
COMPLETESettled and verifiedDecide leftovers, open receipt
NO_CROSSNobody was heading the other way. Nothing movedDecide leftovers
INSUFFICIENT_PARTICIPANTSFewer members than the Circle needs. Nothing movedInvite people, wait for the next round
EXPIREDNobody joined in timeStart a new round
PLAN_STALE, PLAN_REJECTEDApproval window passed, or someone didn't approve. Nothing movedBack to the Circle
SETTLEMENT_REVERTEDThe chain cancelled the transaction; every token stayed putSee the reason
VERIFICATION_FAILEDThe result didn't match the plan; the team is alertedCheck the receipt

Round prices

Each round uses one price snapshot, pinned to one block, for every member. Stock prices come from Binance; for tier A assets they are cross-checked against a 30-minute on-chain PancakeSwap TWAP and must agree within 1% while the market is open (3% when closed). An asset that fails a check is left out of the round with a reason you can see; it is never silently priced.