DBC Program Errors

Understand DBC dynamic_bonding_curve error codes, messages, SDK validation checks, transfer-hook errors, and common causes for integration debugging.

This page lists the Anchor custom errors returned by the dynamic-bonding-curve program.

Anchor custom program errors start at 6000. When a transaction log contains custom program error: 0x1771, convert the hex value to decimal to find the matching code. For example, PoolError::MathOverflow maps to code 6000.

Error Codes

Code	Error	Message	Common cause
6000	MathOverflow	Math operation overflow	Amounts, prices, or liquidity values exceed supported integer bounds.
6001	InvalidFee	Invalid fee setup	Base fee, dynamic fee, or fee scheduler parameters are inconsistent.
6002	ExceededSlippage	Exceeded slippage tolerance	Swap output is below the minimum output, or exact-out input exceeds the maximum input.
6003	ExceedMaxFeeBps	Exceeded max fee bps	Fee numerator is above the program maximum.
6004	InvalidAdmin	Invalid admin	Signer is not an admin for an admin-only instruction.
6005	AmountIsZero	Amount is zero	Swap, claim, or migration amount is zero where a positive amount is required.
6006	TypeCastFailed	Type cast error	Integer conversion failed.
6007	InvalidActivationType	Invalid activation type	Activation type is not slot (0) or timestamp (1).
6008	InvalidQuoteMint	Invalid quote mint	The quote mint is not permissionless and no matching token badge was passed, create_config or create_config_with_transfer_hook was used with a non-zero quote transfer fee or a live transfer fee config authority, or a legacy or transfer-hook pool was initialized on that quote mint.
6009	InvalidCollectFeeMode	Invalid collect fee mode	Collect fee mode is not quote token (0) or output token (1).
6010	InvalidMigrationFeeOption	Invalid migration fee option	Migration fee option is outside the supported range, or custom option is used with the wrong destination.
6011	InvalidInput	Invalid input	Generic parameter validation failure.
6012	NotEnoughLiquidity	Not enough liquidity	Swap or migration needs more liquidity than the curve can provide.
6013	PoolIsCompleted	Pool is completed	Attempted a pre-migration action after the curve completed.
6014	PoolIsIncompleted	Pool is incompleted	Attempted migration or post-completion action before the threshold was reached.
6015	InvalidMigrationOption	Invalid migration option	Migration option is not DAMM v1 (0) or DAMM v2 (1). New configs must use DAMM v2.
6016	InvalidTokenDecimals	Invalid token decimals	Token decimals are outside supported bounds.
6017	InvalidTokenType	Invalid token type	Token type is not SPL Token or Token-2022, or transfer_fee_parameters was passed for an SPL Token base mint.
6018	InvalidFeePercentage	Invalid fee percentage	Partner or creator migration fee split is outside allowed bounds.
6019	InvalidQuoteThreshold	Invalid quote threshold	Migration quote threshold is zero or invalid.
6020	InvalidTokenSupply	Invalid token supply	Pre-migration and post-migration supply values are inconsistent.
6021	InvalidCurve	Invalid curve	Curve points are empty, unsorted, out of price range, or have invalid liquidity.
6022	NotPermitToDoThisAction	Not permit to do this action	Signer is not the expected partner, creator, or authorized actor.
6023	InvalidOwnerAccount	Invalid owner account	Token account owner does not match expected authority.
6024	InvalidConfigAccount	Invalid config account	Config account does not match the pool or instruction.
6025	SurplusHasBeenWithdraw	Surplus has been withdraw	Surplus was already claimed.
6026	LeftoverHasBeenWithdraw	Leftover has been withdraw	Leftover tokens were already claimed.
6027	TotalBaseTokenExceedMaxSupply	Total base token is exceeded max supply	Config or pool creation would exceed allowed base supply.
6028	UnsupportNativeMintToken2022	Unsupport native mint token 2022	Native mint was used with an unsupported Token-2022 path.
6029	InsufficientLiquidityForMigration	Insufficient liquidity for migration	Pool does not have enough liquidity to initialize the destination DAMM pool.
6030	MissingPoolConfigInRemainingAccount	Missing pool config in remaining account	Required config account was not supplied in remaining accounts.
6031	InvalidVestingParameters	Invalid vesting parameters	Vesting schedule is malformed or has invalid totals.
6032	InvalidLeftoverAddress	Invalid leftover address	Leftover receiver is missing or invalid when fixed supply requires it.
6033	InsufficientLiquidity	Liquidity in bonding curve is insufficient	Curve segment cannot support the requested price movement.
6034	InvalidFeeScheduler	Invalid fee scheduler	Scheduler periods, duration, or reduction factor are invalid.
6035	InvalidCreatorTradingFeePercentage	Invalid creator trading fee percentage	Creator trading fee share is outside allowed bounds.
6036	InvalidNewCreator	Invalid new creator	New creator address is invalid or equals the old creator.
6037	InvalidTokenAuthorityOption	Invalid token authority option	Token authority mode is outside supported values.
6038	InvalidAccount	Invalid account for the instruction	Account does not match expected PDA, mint, vault, or owner.
6039	InvalidMigratorFeePercentage	Invalid migrator fee percentage	Migrator fee setting is outside allowed range.
6040	MigrationFeeHasBeenWithdraw	Migration fee has been withdraw	Partner or creator migration fee was already withdrawn.
6041	InvalidBaseFeeMode	Invalid base fee mode	Base fee mode is not linear scheduler, exponential scheduler, or rate limiter.
6042	InvalidFeeRateLimiter	Invalid fee rate limiter	Rate limiter fields are missing or invalid.
6043	FailToValidateSingleSwapInstruction	Fail to validate single swap instruction in rate limiter	Instruction sysvar validation failed for a rate limiter swap.
6044	InvalidMigratedPoolFee	Invalid migrated pool fee params	DAMM v2 graduated-pool fee params are invalid.
6045	UndeterminedError	Undertermined error	Generic fallback error.
6046	RateLimiterNotSupported	Rate limiter not supported	Rate limiter was used in an unsupported context.
6047	AmountLeftIsNotZero	Amount left is not zero	Exact-in path did not consume the expected amount. Use partial fill near curve completion.
6048	NextSqrtPriceIsSmallerThanStartSqrtPrice	Next sqrt price is smaller than start sqrt price	Swap movement would cross below the curve start.
6049	InvalidMinBaseFee	Invalid min base fee	Minimum base fee is below the program requirement.
6050	AccountInvariantViolation	Account invariant violation	CPI account owner, lamports, or data length changed unexpectedly.
6051	InvalidPoolCreationFee	Invalid pool creation fee	Pool creation fee is outside allowed bounds.
6052	PoolCreationFeeHasBeenClaimed	Pool creation fee has been claimed	Pool creation fee was already claimed.
6053	Unauthorized	Not permit to do this action	Signer lacks the required authority.
6054	ZeroPoolCreationFee	Pool creation fee is zero	Attempted to claim a zero pool creation fee.
6055	InvalidMigrationLockedLiquidity	Invalid migration locked liquidity	Liquidity distribution does not satisfy locked-liquidity requirements.
6056	InvalidFeeMarketCapScheduler	Invalid fee market cap scheduler	DAMM v2 market-cap fee scheduler params are invalid.
6057	FirstSwapValidationFailed	Fail to validate first swap with minimum fee	First-swap-with-min-fee transaction context failed validation.
6058	IncorrectATA	Incorrect ATA	Associated token account does not match expected owner or mint.
6059	InsufficientPoolLamports	Pool has insufficient lamports to perform the operation	Pool account cannot pay required lamports for the operation.
6060	InvalidPermission	Invalid permission	Operator permission bits are invalid.
6061	InvalidWithdrawProtocolFeeZapAccounts	Invalid withdraw protocol fee zap accounts	Protocol zap account list is malformed.
6062	MintRestrictedFromZap	SOL,USDC protocol fee cannot be withdrawn via zap	Restricted mint was used with zap.
6063	InvalidZapOutParameters	Invalid zap out parameters	Zap output parameters are invalid.
6064	CpiDisabled	CPI disabled	Protocol zap CPI is disabled by the downstream zap program.
6065	MissingZapOutInstruction	Missing zap out instruction	Required zap instruction was not found.
6066	InvalidZapAccounts	Invalid zap accounts	Zap accounts do not match the expected route.
6067	InvalidCompoundingParameters	Invalid compounding parameters	Compounding migration deposit sqrt price is outside the DAMM v2 price bounds.
6068	InvalidClaimProtocolFeeAccounts	Invalid claim protocol fee accounts	Protocol fee claim account list does not match the selected mint, pool, receiver, or pool type.
6069	InvalidInstructionsSysvar	Invalid instructions sysvar account	Instructions sysvar account is missing or not the canonical sysvar account.
6070	InvalidRemainingAccountsLength	Invalid remaining accounts length	Transfer-hook remaining account slices require more accounts than were provided.
6071	MissingRemainingAccountForTransferHook	Missing remaining account for transfer hook	A base mint has a transfer hook, but required extra accounts were not supplied.
6072	NoTransferHookProgram	No transfer hook program	Transfer-hook accounts were supplied for a mint without an active transfer-hook program.
6073	DuplicatedRemainingAccountTypes	Duplicated remaining account types	TransferHookAccountsInfo contains duplicate slice types.
6074	InvalidTransferHookProgram	Invalid transfer hook program	Transfer-hook program is missing, non-executable, default, or one of the disallowed program IDs.
6075	InvalidPoolAccount	Invalid pool account	Pool account owner, discriminator, or expected account variant is invalid.
6076	PoolTypeMismatch	Pool type does not match instruction	A standard pool was sent to a transfer-hook-only instruction, or a transfer-hook pool was sent to a standard-only instruction.
6077	InvalidRemainingAccountSliceType	Invalid remaining account slice type for this instruction	Transfer-hook remaining account metadata includes a slice type that the instruction does not accept.
6078	DeprecatedBaseFeeMode	Deprecated base fee mode	New config or pool creation used BaseFeeMode::RateLimiter.
6079	CannotCreateTokenBadgeOnSupportedMint	Cannot create token badge on supported mint	A token badge was requested for a quote mint that is already permissionless-supported.
6080	InvalidTokenBadge	Invalid token badge	Token badge account is missing, closed, or does not match the quote mint.
6081	QuoteMintHasNonZeroTransferFee	Quote mint has a non zero transfer fee or a live transfer fee config authority	A legacy config reached migration_damm_v2 while the quote mint’s current transfer fee is non-zero.
6082	DeprecatedMigrationOption	Deprecated migration option	New config or pool creation used MigrationOption::MeteoraDamm.
6083	FeeInverseIsIncorrect	Transfer fee inverse calculation is incorrect	Grossing an amount up for a transfer fee did not round back to the requested net amount.
6084	InvalidTransferFeeParameters	Invalid transfer fee parameters	transfer_fee_basis_points is above 1000, an authority enum is unknown, or 0 basis points is combined with Immutable or RevokeZeroFee.
6085	ExceededInputAmount	Required input amount exceeds the provided amount in	A partial fill reconstructed an input larger than amount_in. This comes from rate-limiter fee inverse rounding, including any input transfer fee.
6086	InvalidFeeClaimer	Invalid fee claimer	fee_claimer is the default pubkey on a Token 2022 partner token-update authority, or on a partner transfer-fee authority.

Program 0.2.2 includes errors through 6086. InvalidQuoteMint is 6008.

TypeScript SDK Validation Helpers

Call these before createConfig2. These helpers return booleans or throw SDK-side errors before the program returns a custom error.

Helper	Related program errors
validateConfigParameters	The config checks, including curve, fee, supply, vesting, migration, and transfer-fee restrictions.
validateTransferFeeParameters	InvalidTokenType, InvalidTransferFeeParameters, InvalidFeeClaimer.
validateMigratedPoolFee	InvalidMigratedPoolFee, InvalidFeeMarketCapScheduler, InvalidCollectFeeMode.
validateCompoundingFeeBps	InvalidMigratedPoolFee.