> ## Documentation Index
> Fetch the complete documentation index at: https://docs.continuum.markets/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. |
| 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:

```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`"

→ 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](https://discord.gg/U5hPCB8ufJ), 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).

## See also

<CardGroup cols={2}>
  <Card title="FAQ" icon="circle-question" href="/reference/faq">
    Common questions including error symptoms.
  </Card>

  <Card title="Glossary" icon="book" href="/reference/glossary">
    What terms in error names mean.
  </Card>
</CardGroup>