Error catalog

Anchor maps program errors to numeric codes starting at 6000 per program. The same numeric code can mean different things in different programs - always pair the code with the program ID.

mint-redeem

Program ID (devnet): 5MBjhNUUguLTPNR5WG6YBUUw7vUcxQ14ARw3NsS3rKu4

Code	Name	Cause	How to fix
6000	`MarketNotActive`	`Market.is_active = false`	Wait - operator may pause a market for maintenance.
6001	`InvalidAmount`	Zero or negative amount	Pass a positive `BN`.
6002	`InsufficientCollateral`	Vault can’t cover the redeem (rare; would imply solvency bug)	Report immediately.
6003	`InvalidOracle`	Oracle account passed doesn’t match `market.oracle_address`	Use `market.oracle_address` always.
6004	`UnsupportedOracleType`	Bad `oracle_type` enum value	Pick from `Pyth` / `Hermes` / `Switchboard` / `Manual`.
6005	`OraclePriceUnavailable`	Oracle paused or no fresh observation	Wait for keeper to push observations.
6006	`MathOverflow`	Should be unreachable	Report.
6007	`SymbolTooLong`	Symbol > 16 chars	Pick a shorter symbol.
6008	`FeeTooHigh`	Fee bps > 1000 (10%)	Lower the fee.
6009	`MintNotAllowedInStress`	Risk state is `Stress`	Wait for recovery, or trade on the native book instead.
6010	`RedeemNotAllowedInStress`	Reserved (redeem in Stress is currently allowed)	Should not occur.
6011	`ExceedsStressMintCap`	`ProxyMode`/`Recovery` size throttle hit	Reduce mint size, retry.
6012	`TwapNotAvailable`	TWAP buffer not yet populated	Wait ~75s after market init.
6013	`AlreadyEnabled`	Multi-collateral already on	Skip the call.
6014	`MultiCollateralNotEnabled`	Tried to add collateral type without enabling	Call `enable_multi_collateral` first.
6015	`MaxCollateralTypesExceeded`	More than 5 collateral types	Hard cap.
6016	`InvalidWeight`	Multi-collateral weight not in [1, 10000] bps	Use 1–10000.
6017	`CollateralAlreadyExists`	Duplicate collateral mint	Update via `update_collateral_vault`.
6018	`CollateralNotFound`	Unknown collateral type	Add via `add_collateral_vault`.
6019	`BelowMinimum`	Mint < 10 cUSDC	Mint at least `10_000_000` lamports.
6020	`UnauthorizedKeeper`	Signer ≠ `market.keeper_authority`	Use the keeper’s keypair.
6021	`Unauthorized`	Signer ≠ `market.authority`	Admin-only call.
6022	`InsufficientLiquidCollateral`	Yield deployed; recall first	Yield is off by default; report if you see this.
6023	`ExceedsYieldCeiling`	Deployment > `yield_ceiling_bps`	Operator config issue.
6024	`YieldManagementDisabled`	`yield_enabled = false`	Yield is off by design on devnet.
6025	`RecallExceedsDeployed`	Recall > deployed balance	Operator config issue.
6026	`SingleSideMintStressFloor`	`keeper_mint_single` would leave the vault under-collateralized under an adverse ±20% NAV shock	Keeper-only. The single-side mint is blocked because it would skew the book past the solvency floor; the keeper closes the gap from the other side instead. Not user-facing.
6027	`GammaMustRatchetDown`	`set_s_gamma_index` was called with a value above the current γ	Keeper-only. The short-leg volatility-decay scalar can only ratchet down (never raised to restore short claims); it’s also floored at `0.5`. Not user-facing.
6028	`MarketNotEmpty`	`close_market_admin` on a market that still has outstanding L/S supply or collateral	Admin-only. Closing would brick redemptions of live tokens, so the market must be fully wound down (`total_l_supply == total_s_supply == total_collateral == deployed_to_yield == 0`) first.

oracle

Program ID (devnet): 5vxiCrDpFnQ2W5QtgZBC66K2XTC19bjVBjinGYYBsadC

Code	Name	Cause	How to fix
6000	`OraclePaused`	`is_paused = true`	Admin emergency pause. Wait for unpause.
6001	`InvalidPythAccount`	Wrong Pyth account passed	Use the configured `oracle_config.pyth_oracle`.
6002	`PriceUnavailable`	No fresh observation	Wait for keeper to push.
6003	`ConfidenceTooHigh`	Confidence > `max_confidence_interval`	Wait for confidence to narrow; transient.
6004	`PriceStale`	Last update older than `max_staleness`	Keeper outage; ProxyMode imminent.
6005	`PriceMovementTooLarge`	New observation > 20% from prior	Pyth glitch or extreme move; observation rejected.
6006	`TwapNotReady`	TWAP buffer not populated	Wait.
6007	`InvalidTwapWindow`	TWAP window < 1s or > 24h	Operator config.
6008	`MarketStateRestriction`	Operation not allowed in current state	Risk-state-gated.
6009	`UnauthorizedKeeper`	Signer ≠ `oracle_config.keeper_authority`	Use the keeper’s keypair.
6010	`UnauthorizedAdmin`	Signer ≠ `oracle_config.admin_authority`	Admin-only call.
6011	`InvalidRegisteredFeed`	Feed not in `OracleFeed` registry	Register feed first.
6012	`InactiveOracleFeed`	Feed exists but `is_active = false`	Activate or pick another feed.
6013	`MathOverflow`	Should be unreachable	Report.

clp

Program ID (devnet): 8xauDRjw9XRyk4FE3hW1JKjD8nC87gfr59Xig1dJqLES

Code	Name	Cause	How to fix
6000	`Unauthorized`	Signer mismatch	Match the relevant authority.
6001	`WithdrawalLocked`	Lockup not yet expired	Wait.
6002	`InvalidAmount`	Zero or negative	Pass a positive `BN`.
6003	`InsufficientShares`	LP-share path (legacy)	Should not occur in MVP.
6004	`InsufficientFunds`	Vault can’t cover request	Recall capital from positions first.
6005	`InsufficientLiquidFunds`	Funds deployed; recall first	Recall from the yield venue / sweep the books, then retry.
6006	`OICapExceeded`	New OI > `oi_cap`	Operator: raise the cap. User: smaller mint.
6007	`MathOverflow`	Should be unreachable	Report.
6008	`InsufficientBuffer`	Protocol buffer can’t absorb loss	Operator action.
6009	`HardBoundBreach`	q or drawdown past hard bound	Wait for renormalization.
6010	`YieldStrategyDisabled`	Yield off	By design.
6011	`ExceedsMaxDeployment`	Per-state deployment cap exceeded	Operator config.
6012	`MaxDeploymentsExceeded`	Deployment array full	Operator config.
6013	`DeploymentNotFound`	Unknown protocol	Operator config.
6014	`InsufficientDeployment`	Recall > deployed	Operator config.
6015	`DeploymentTooHigh`	% > config	Operator config.
6016	`OracleReadError`	Bound oracle unreadable	Oracle config bug; report.
6017	`InvalidPool`	Pool pubkey mismatch	Pass the market’s `Pool` PDA (`[b"pool", market, side]`).
6018	`PoolNotConfigured`	Pool not yet bootstrapped	Operator: run `init-clmm-pools.ts`.
6019	`AdminWithdrawCapExceeded`	24h $100K cap hit	Wait for window roll.
6020	`InvalidPosition`	Legacy (v1 LP position mismatch)	Should not occur in v2.
6021	`InvalidAccountData`	Account data too small	Wrong account passed.

registry

Program ID (devnet): REGnHqnJMxLoRAKX5RqPd9VJGcZBNgmg4xs5bVGGTap

Code	Name	Cause	How to fix
6000	`SymbolTooLong`	Symbol > 16 chars	Use a shorter symbol.

faucet

Program ID (devnet): 9tUeQAPEtVSB68NSfvFAqfwaB74GuVxm6Zbp1hrMiNKY

Code	Name	Cause	How to fix
6000	`CooldownNotElapsed`	Drip too soon after prior	Wait, or use a fresh wallet.

How errors surface in clients

Anchor wraps program errors in transaction-level errors. The shape varies by SDK:

try {
  await program.methods.mintPaired(amount).accounts({...}).rpc();
} catch (e) {
  // Anchor IDL-aware error
  if (e.error?.errorCode?.code === "MintNotAllowedInStress") {
    // ...
  }

  // Or numeric
  if (e.error?.errorCode?.number === 6009) {
    // ...
  }

  // Logs are also useful
  console.error(e.logs);
}

For raw web3.js error inspection:

// Look at logs in tx simulation
const sim = await connection.simulateTransaction(tx);
console.log(sim.value.logs);
// Lines like "Program log: AnchorError thrown in programs/mint-redeem/src/lib.rs:..."

Common error sequences

”User mint failed with `OraclePriceUnavailable`”

→ The oracle is Paused or its price is stale. If the underlying market is closed (nights and weekends for equities), this is expected: mint and redeem pause until it reopens, and the books keep trading. Otherwise the keeper is probably down or restarting. Wait 30 seconds and retry. If it persists, check #announcements on Discord, where the team posts outages, or ask in #help.

”Mint failed with `MintNotAllowedInStress`”

→ Risk state is Stress. The keeper is detecting wide confidence or extended staleness. Check market.risk_state; surface to the user as “minting paused, redeem still works”.

”Mint failed with `OICapExceeded`”

→ The market has hit its cap. Either reduce your mint size (under-cap) or wait for OI to drop via redemptions.

”Mint failed with `BelowMinimum`”

→ Trying to mint less than 10 cUSDC. Bump up.

”All instructions fail with `Unauthorized`”

→ Wrong signer. Verify your keypair matches the expected authority for the instruction. For privileged ops, your pubkey must be market.keeper_authority (for keeper_*_single) or market.authority (for admin ops).

FAQ

Common questions including error symptoms.

Glossary

What terms in error names mean.

Programs

Reference

mint-redeem

oracle

clp

registry

faucet

How errors surface in clients

Common error sequences

”User mint failed with `OraclePriceUnavailable`”

”Mint failed with `MintNotAllowedInStress`”

”Mint failed with `OICapExceeded`”

”Mint failed with `BelowMinimum`”

”All instructions fail with `Unauthorized`”

See also

FAQ

Glossary

​mint-redeem

​oracle

​clp

​registry

​faucet

​How errors surface in clients

​Common error sequences

​”User mint failed with OraclePriceUnavailable”

​”Mint failed with MintNotAllowedInStress”

​”Mint failed with OICapExceeded”

​”Mint failed with BelowMinimum”

​”All instructions fail with Unauthorized”

​See also

FAQ

Glossary

mint-redeem

oracle

clp

registry

faucet

How errors surface in clients

Common error sequences

”User mint failed with `OraclePriceUnavailable`”

”Mint failed with `MintNotAllowedInStress`”

”Mint failed with `OICapExceeded`”

”Mint failed with `BelowMinimum`”

”All instructions fail with `Unauthorized`”

See also