> ## Documentation Index > Fetch the complete documentation index at: https://continuum-ec12e897.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Error catalog > Every error code, by program, with the reason and how to recover. 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. | ## 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: ```typescript theme={null} 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: ```typescript theme={null} // 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`" → Oracle is `Paused` or stale beyond threshold. Likely the keeper is down or restarting. Wait 30 seconds, retry. If persistent, check the [Discord #status channel](https://discord.gg/continuum). ### "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). ## See also Common questions including error symptoms. What terms in error names mean.