Pool Controls
Understand pauses, administrators, and emergency powers
A trading pause can leave proportional deposits and withdrawals open. A full pool pause blocks them. Before depositing, check the current authorities and whether a range manager can change pricing.
The three trading switches
| Setting | When disabled | Proportional deposits and withdrawals |
|---|---|---|
pool_enabled | Swaps and normal liquidity operations fail | Blocked |
swaps_enabled | All swaps fail | Allowed if the pool is enabled |
Token is_active | Selling that token into the pool fails | Allowed if the pool is enabled |
An inactive token can still be bought as output. Single-token deposits include swaps, so trading switches affect them. Enabled trading still requires sufficient reserves and sell-off capacity.
Who has authority
Read the pool and config accounts for the current role holders:
| Role | Powers |
|---|---|
Pool admin: pool.pool_admin | Set base fees and sell-off policy; toggle swaps and token input status; appoint/configure a manager; transfer or renounce this role |
Protocol admin: config.protocol_admin | Set protocol fee share; fully pause/resume pools; toggle swaps and token input status; collect protocol fees; perform emergency withdrawals; disable an existing manager |
Enabled manager: pool.range_manager | Change virtual balances and weights within configured checks |
The protocol-admin override can disable a manager, but cannot appoint a replacement. See Range Management for update limits.
Admin transfers use an initiate/accept flow. Renouncing pool-admin sets its address to zero and removes that role's powers. It does not remove the protocol admin, disable an existing manager, or remove program-upgrade powers.
A treasury PDA is not a multisig guarantee
A Treasury PDA routes authority through a program; it does not itself prove
a multisig or timelock. Coffer's protocol-admin calls authorize the stored
Treasury.admin signer. Certain emergency pause and token-status calls also
accept the supervisor.
Follow the full chain: pool admin, config protocol admin, Treasury admin/supervisor where applicable, and program upgrade authorities. A PDA address alone does not establish how many people control those permissions.
Sell-off limits and dynamic fees
The pool admin can configure a per-token selling cap and dynamic fee. Exceeding the cap rejects a trade. These controls do not guarantee protection against a depeg or compromised token. See Fees for directions, recipients, and window calculations.
Emergency withdrawals
After disabling a pool, the protocol admin can call debug_withdraw_liquidity
to transfer vault assets to recipient token accounts without burning LP
tokens or reconciling normal reserve accounting.
Recorded balances may then no longer back LP redemption. Operators must
retire the pool operationally: the instruction does not enforce permanent
retirement, and set_pool_enabled can re-enable it. Re-enabling is not proof
that its reserves support normal operation.
Monitor DebugLiquidityWithdrawn and reconcile affected pools before using
them for routing or interpreting their reported balances.
Technical checks for integrators
Check the relevant switches, real reserves, sell-off capacity, and transaction minimums against fresh state. Proportional joins/exits depend on the full pool flag; admin operations have separate checks and are not all blocked by a pause.
Events help invalidate caches, but pool/config accounts determine current permissions. Use a matching program interface.