Coffer Docs
Safety & Governance

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

SettingWhen disabledProportional deposits and withdrawals
pool_enabledSwaps and normal liquidity operations failBlocked
swaps_enabledAll swaps failAllowed if the pool is enabled
Token is_activeSelling that token into the pool failsAllowed 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:

RolePowers
Pool admin: pool.pool_adminSet 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_adminSet 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_managerChange 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.

On this page