Documentation
A one-page summary of the Bron Intents protocol. Read the linked docs for the complete on-chain
reference.
Order lifecycle
1
Create order — User creates an order with base/quote assets, amounts, max price, auction duration and destination address.
2
Solver reacts — Solvers propose prices during the auction; the best price is automatically selected.
3
User sends funds — User sends the base amount to the solver address on the base network.
4
User sets tx hash — User records their base-network tx hash on the order.
5
Oracles verify user tx — Oracles check amount, sender and receiver; a quorum decides if the user tx was proper.
6
Decision on user tx — If valid the order proceeds; otherwise it is cancelled and finished.
7
Solver sends funds — Solver sends the quote amount to the user address on the quote network.
8
Solver sets tx hash — Solver records their quote-network tx hash on the order.
9
Oracles verify solver tx — A quorum checks the solver tx on the quote network.
10
Decision on solver tx — If valid the order finishes; otherwise the solver is liquidated.
11
Order finished — Settlement is complete.
On-chain status codes
Emitted via OrderStatusChanged(orderId, status).
Code
Status
0
NOT_EXIST — Order does not exist
1
USER_INITIATED — Order created, auction has not started
2
AUCTION_IN_PROGRESS — A solver has reacted; better quotes still possible
4
WAIT_FOR_ORACLE_CONFIRM_USER_TX — Oracles verifying the user transaction
5
WAIT_FOR_SOLVER_TX — Waiting for the solver to settle on the quote network
6
WAIT_FOR_ORACLE_CONFIRM_SOLVER_TX — Oracles verifying the solver transaction
7
COMPLETED — Terminal — settlement complete
8
LIQUIDATED — Terminal — solver liquidated, resolved by backup solver
9
CANCELLED — Terminal — cancelled by broadcaster or user-side timeout
10
TO_BE_LIQUIDATED — Intermediate — awaiting backup solver during liquidation
11
DECIDE_BY_DAO — Edge case (e.g. all oracles offline) — DAO arbitration required