Error Codes

Each table mirrors the Rust #[error_code] enum exactly. For kimia-perp, codes are explicitly pinned at the start of each bucket; Anchor auto-increments within a bucket, so a code number not listed here is not used.

kimia-perp

Defined in Perp-engine/programs/kimia-perp/src/errors.rs.

Oracle

Code	Name	Meaning
6000	StaleOracle	Price older than `oracle_staleness_threshold`
6001	OracleConfidenceTooWide	Confidence exceeds `oracle_confidence_max_bps`
6002	InvalidOraclePrice	Price ≤ 0 or account misowned

Market

Code	Name
6010	MarketNotActive
6011	MarketNotPaused
6012	MarketAlreadyExists

Margin

Code	Name
6020	InsufficientMargin
6021	WithdrawalExceedsMargin
6022	ExceedsMaxLeverage

Position

Code	Name
6030	NoPosition
6031	CloseExceedsPosition
6032	ZeroSize
6033	InvalidDirection

Funding

Code	Name
6040	FundingTooEarly
6041	FundingAlreadySettled

Liquidation

Code	Name
6050	NotLiquidatable
6051	LiquidationTooLarge

Deposit / Withdraw

Code	Name
6060	ZeroDeposit
6061	InsufficientCollateral

Math / Auth

Code	Name
6070	MathOverflow
6080	Unauthorized
6081	InvalidDelegate

Slippage / Insurance

Code	Name
6090	SlippageExceeded
6100	InsuranceInsufficient

Orderbook

Code	Name
6110	OrderbookFull
6111	OrderNotFound
6112	OrderWouldCross
6113	OrderPriceOutOfRange
6114	MissingCounterparty
6115	InvalidTickSize
6116	InsufficientFreeCollateral
6117	MarketOrderSlippage

Spot pool

Code	Name
6130	SpotPoolPaused
6131	SpotPoolInsufficientLiquidity
6132	SpotSwapSlippageExceeded
6133	SpotSwapZeroAmount

delta-vault

Defined in Programs/programs/delta-vault/src/errors.rs. Codes auto-increment from 6000 in the order shown.

Name	Meaning
`VaultNotActive`	Vault is not in Active state
`VaultNotPaused`	Vault is not in Paused state
`ZeroDeposit`	Deposit amount must be greater than zero
`InsufficientShares`	Insufficient shares for withdrawal
`StaleOracle`	Oracle price is stale (age > 30 s)
`OracleConfidenceTooWide`	Oracle price confidence too wide (> 1%)
`MathOverflow`	Math overflow
`Unauthorized`	Not vault authority
`ZeroInsuranceSeed`	Insurance fund seed amount must be greater than zero
`InsufficientLiquidity`	Insufficient pool liquidity for withdrawal
`DeltaExceedsThreshold`	Delta exceeds rebalance threshold
`InvalidParameter`	Invalid parameter value
`NavCorrupted`	NAV invariant violated. Call `admin_resync_nav`
`PerpsUserAccountAlreadyInit`	Perps user account already initialized
`PerpsUserAccountNotInit`	Call `init_perps_user_account` first
`PerpsMarketMismatch`	Provided market does not match `vault.perps_market`
`PerpsMarketIndexMismatch`	Perps market index mismatch
`PerpsUserAccountMismatch`	Perps user account PDA mismatch
`NoHedgePosition`	No hedge position open to close
`SpotPoolMismatch`	Spot pool does not match `vault.spot_pool`
`WsolVaultMismatch`	wSOL vault does not match `vault.wsol_vault`
`InsufficientWsol`	Insufficient wSOL balance for withdrawal
`VaultNotMigrated`	Spot leg not configured; call `admin_setup_spot_leg` first
`SpotLegAlreadySetup`	Spot leg already configured

split-engine

Defined in Programs/programs/split-engine/src/errors.rs.

Name	Meaning
`NotMatured`	Market has not reached maturity
`AlreadyMatured`	Market has already matured
`ZeroDeposit`	Deposit amount must be greater than zero
`SupplyInvariantViolated`	PT/YT supply invariant violated
`NoYieldToClaim`	No yield to claim
`MathOverflow`	Math overflow

yield-amm

Defined in Programs/programs/yield-amm/src/errors.rs.

Name	Meaning
`SwapDisabledNearMaturity`	Pool is near maturity (t < 0.001)
`SlippageExceeded`	Output less than minimum
`InsufficientLiquidity`	Insufficient liquidity in pool
`EmptyPool`	Pool is empty
`MathOverflow`	Math overflow
`InvalidPoolConfig`	Invalid pool configuration
`ZeroAmount`	Zero amount
`MaturityInPast`	Maturity must be in the future
`InvalidDuration`	Invalid duration
`AlreadyMatured`	Pool already matured
`InvariantViolated`	Invariant violated after swap

intent-router

Defined in Programs/programs/intent-router/src/errors.rs.

Name	Meaning
`InvalidSessionState`	Step must follow Created → Step1 → Step2 → Step3
`TargetRateNotAchievable`	Target rate not achievable at current market prices
`SessionCompleted`	Session already completed
`NotSessionOwner`	Not session owner
`MathOverflow`	Math overflow
`ZeroAmount`	Zero amount
`NoSharesReceived`	No vault shares received from deposit
`NoTokensReceived`	No PT/YT received from split
`SlippageExceeded`	Slippage exceeded on swap
`PtBalanceMismatch`	PT balance after swap doesn’t match claimed `pt_sold`
`UnderlyingBalanceInsufficient`	User underlying balance < claimed `underlying_received`
`TargetRateNotAchieved`	Achieved fixed rate below session target
`NoSwapPerformed`	Swap reported zero PT sold or zero underlying received
`NegativeDiscount`	Underlying received exceeds PT face value
`InvalidDuration`	Session duration must be greater than zero

Integrate

Guides

Reference

kimia-perp

Oracle

Market

Margin

Position

Funding

Liquidation

Deposit / Withdraw

Math / Auth

Slippage / Insurance

Orderbook

Spot pool

delta-vault

split-engine

yield-amm

intent-router

​kimia-perp

​Oracle

​Market

​Margin

​Position

​Funding

​Liquidation

​Deposit / Withdraw

​Math / Auth

​Slippage / Insurance

​Orderbook

​Spot pool

​delta-vault

​split-engine

​yield-amm

​intent-router

kimia-perp

Oracle

Market

Margin

Position

Funding

Liquidation

Deposit / Withdraw

Math / Auth

Slippage / Insurance

Orderbook

Spot pool

delta-vault

split-engine

yield-amm

intent-router