Explanation
Forks and resolution in Trading
A pair closes when its market can no longer be traded safely, but it never traps a position. This page explains which events close it and what a holder does next.
What closes a pair
Swaps, initialization, and added liquidity close permanently at question end, when the universe forks, or when the SecurityPoolForker exposes a final outcome. They are also blocked while the SecurityPool is not operational or is awaiting fork continuation. LP removal deliberately has none of those guards. tradingStatus() reports which condition applies.
After a fork
- LP → Parent pair:
removeLiquidity() - Parent pair → LP: parent Yes + No
- LP → ShareToken:
migrate(fromId, chosen outcomes) - ShareToken → LP: selected child shares
- Wait until migration and any Collateral Repair Auction return the child pool to Operational
- LP → Factory:
createPair(exact child pool) - Factory → LP: isolated child pair
A fork does not select a branch or migrate LP. A child pair can be initialized only if the child SecurityPool is back to Operational before the question's end date, which requires a fork caused by another question: pairs refuse initialization and swaps once the question has ended, and a fork caused by disputing this question always comes after its end date. Parent and child pools may share one ShareToken contract, but they have different universe-specific token IDs and different pair addresses. Handle a universe fork gives the step-by-step procedure.
After resolution
- Pair → Forker:
getQuestionOutcome(pool) - Forker → Pair: current Yes / No / Invalid outcome
- Pair → Pair: swaps and additions closed
- Holder → Pair:
removeLiquidityremains available - Pair → Holder: raw Yes + No
- Holder → SecurityPool:
redeemShares()for the winning token - SecurityPool → Holder: current collateral value
If the question resolves Invalid, the Invalid shares held in the wallet are the settlement insurance. Fee growth in the pair's Yes and No reserves creates no redemption value on an Invalid result. Handle resolution gives the procedure.