DAMM v2 Program Accounts

This page summarizes the cp-amm account model. For exact layouts, use the published IDL and generated TypeScript types exported by @meteora-ag/cp-amm-sdk.

PDA Map

Pool and customizable pool PDAs sort the two mint public keys lexicographically in the seed list.

Account	SDK helper	Seeds
Pool authority	`derivePoolAuthority()`	`pool_authority`
Static or dynamic config	`deriveConfigAddress(index)`	`config`, little-endian `u64` index
Config-based pool	`derivePoolAddress(config, tokenAMint, tokenBMint)`	`pool`, config, sorted mints
Customizable pool	`deriveCustomizablePoolAddress(tokenAMint, tokenBMint)`	`cpool`, sorted mints
Position	`derivePositionAddress(positionNft)`	`position`, position NFT mint
Token vault	`deriveTokenVaultAddress(tokenMint, pool)`	`token_vault`, mint, pool
Reward vault	`deriveRewardVaultAddress(pool, rewardIndex)`	`reward_vault`, pool, reward index
Token badge	`deriveTokenBadgeAddress(tokenMint)`	`token_badge`, mint
Position NFT token account	`derivePositionNftAccount(positionNftMint)`	`position_nft_account`, position NFT mint
Claim fee operator	`deriveClaimFeeOperatorAddress(operator)`	`cf_operator`, operator
Operator	`deriveOperatorAddress(whitelistedAddress)`	`operator`, whitelisted address
Event authority	generated clients	`__event_authority`

Constants

Constant	Value	Use
`MIN_SQRT_PRICE`	`4295048016`	Lower square-root price bound.
`MAX_SQRT_PRICE`	`79226673521066979257578248091`	Upper square-root price bound.
`NUM_REWARDS`	`2`	Reward slots per pool and position.
`FEE_DENOMINATOR`	`1_000_000_000`	Fee numerator denominator.
`MAX_FEE_BPS_V0`	`5000`	Legacy pool-version max fee, 50%.
`MAX_FEE_BPS_V1`	`9900`	Current pool-version max fee, 99%.
`CURRENT_POOL_VERSION`	`1`	Current fee version for new pools.
`SPLIT_POSITION_DENOMINATOR`	`1_000_000_000`	Numerator denominator for `split_position2`.
`MIN_REWARD_DURATION`	`86400`	Minimum reward campaign duration, 1 day.
`MAX_REWARD_DURATION`	`31536000`	Maximum reward campaign duration, 1 year.

Enums

Enum	Values
`CollectFeeMode`	`0` BothToken, `1` OnlyB, `2` Compounding
`PoolStatus`	`0` Enable, `1` Disable
`PoolType`	`0` Permissionless, `1` Customizable
`LayoutVersion`	`0` V0, `1` V1
`ActivationType`	`0` Slot, `1` Timestamp
`BaseFeeMode`	Time scheduler linear, time scheduler exponential, rate limiter (deprecated for new configs and new pools), market-cap scheduler linear, market-cap scheduler exponential
`SwapMode`	`0` ExactIn, `1` PartialFill, `2` ExactOut
`ConfigPermission`	`0` `CreatePoolWithoutMintValidation`
`OperatorPermission`	Config, token badge, pool status, reward, pool fee, protocol fee, zap, and layout-fix permissions

Config

Field	Meaning
`vault_config_key`	Alpha-vault key that may buy before activation when configured
`pool_creator_authority`	If non-default, only this authority can create pools with the config
`pool_fees`	Base fee, dynamic fee config, protocol/referral fee percents, compounding fee bps
`activation_type`	`0` slot, `1` timestamp
`collect_fee_mode`	`0` BothToken, `1` OnlyB, `2` Compounding
`config_type`	`0` static, `1` dynamic
`index`	Config index used in PDA derivation
`sqrt_min_price`, `sqrt_max_price`	Price bounds for concentrated modes
`permission`	`u128` bitmask. Only private configs, meaning those with a non-default `pool_creator_authority`, can hold a non-zero value. The only defined bit today is `CreatePoolWithoutMintValidation` (`1 << 0`). Pre-existing configs decode as `0`.

Use fetchConfigState, getStaticConfigs, or getAllConfigs to read configs from TypeScript. Use isConfigPermissionAllow with ConfigPermission.CreatePoolWithoutMintValidation to detect configs that skip permissionless mint and token-badge checks.

PoolFeesConfig

Field	Meaning
`base_fee`	Encoded base fee mode and mode-specific parameters
`dynamic_fee`	Optional volatility-responsive fee config
`protocol_fee_percent`	Protocol share of trading fees
`referral_fee_percent`	Referral share of protocol fee when referral is present
`compounding_fee_bps`	Fee share that compounds into reserves for compounding pools

Pool

Field	Meaning
`pool_fees`	Runtime fee state, including base and dynamic fee state
`token_a_mint`, `token_b_mint`	Pool mints
`token_a_vault`, `token_b_vault`	Vault token accounts
`whitelisted_vault`	Pre-activation alpha-vault access
`liquidity`	Total active liquidity
`protocol_a_fee`, `protocol_b_fee`	Accrued protocol fees
`sqrt_min_price`, `sqrt_max_price`, `sqrt_price`	Price bounds and current square-root price
`activation_point`, `activation_type`	Launch activation point and unit
`pool_status`	`0` enabled, `1` disabled
`token_a_flag`, `token_b_flag`	Token program/extension flags
`collect_fee_mode`	Liquidity and fee mode
`pool_type`	Permissionless or customizable
`fee_version`	`0` caps max fee at 50%; `1` caps max fee at 99%
`fee_a_per_liquidity`, `fee_b_per_liquidity`	Fee growth checkpoints as little-endian `U256` bytes
`permanent_lock_liquidity`	Total permanently locked pool liquidity
`creator`	Pool creator
`token_a_amount`, `token_b_amount`	Tracked reserves for layout version `V1`
`layout_version`	`V1` pools track token reserve amounts directly
`reward_infos`	Two pool reward slots

Use fetchPoolState for state and fetchPoolFees when you need decoded pool fee bytes.

PoolMetrics

Field	Meaning
`total_lp_a_fee`, `total_lp_b_fee`	Lifetime LP fees accumulated by token side
`total_protocol_a_fee`, `total_protocol_b_fee`	Lifetime protocol fees accumulated by token side
`total_position`	Count of created positions, updated when position accounts are initialized or reduced

RewardInfo

Field	Meaning
`initialized`	Non-zero when a reward slot is initialized
`reward_token_flag`	Token program flag for the reward mint
`mint`, `vault`, `funder`	Reward mint, reward vault, and funder authority
`reward_duration`, `reward_duration_end`	Campaign duration and end timestamp
`reward_rate`	Emission rate in Q64-scaled reward units
`reward_per_token_stored`	Cumulative reward growth checkpoint as little-endian `U256` bytes
`last_update_time`	Last pool reward update timestamp
`cumulative_seconds_with_empty_liquidity_reward`	Carry-forward accounting when rewards accrue while liquidity is empty

Position

Field	Meaning
`pool`	Pool address
`nft_mint`	Position NFT mint
`fee_a_per_token_checkpoint`, `fee_b_per_token_checkpoint`	Fee checkpoints as little-endian `U256` bytes
`fee_a_pending`, `fee_b_pending`	Claimable pending fees
`unlocked_liquidity`	Withdrawable liquidity
`vested_liquidity`	Liquidity locked by vesting
`permanent_locked_liquidity`	Liquidity that cannot be withdrawn
`reward_infos`	User reward checkpoints and pending rewards for two reward slots
`inner_vesting`	Embedded vesting schedule used by newer lock flows

The position NFT is the ownership handle. A position operation that changes liquidity or claims fees verifies the owner through the NFT token account.

PositionMetrics

Field	Meaning
`total_claimed_a_fee`, `total_claimed_b_fee`	Lifetime claimed fee counters for the position

UserRewardInfo

Field	Meaning
`reward_per_token_checkpoint`	Last synced pool reward growth checkpoint
`reward_pendings`	Claimable pending reward amount
`total_claimed_rewards`	Lifetime claimed rewards for the reward slot

InnerVesting

Field	Meaning
`cliff_point`	Slot or timestamp when cliff unlock begins
`period_frequency`	Slot or timestamp interval between unlock periods
`cliff_unlock_liquidity`	Liquidity released at the cliff
`liquidity_per_period`	Liquidity released per period after the cliff
`total_released_liquidity`	Liquidity already released into unlocked liquidity
`number_of_period`	Number of post-cliff unlock periods

Rewards And Vesting

Each pool has up to two RewardInfo slots. Once initialized, a reward slot remains initialized. Each position has matching UserRewardInfo checkpoints. External Vesting accounts are still supported and are 176 byte zero-copy accounts keyed by position. inner_vesting stores one vesting schedule inside the Position account and lets integrations lock liquidity without creating a separate vesting account. Use the SDK lock and refresh helpers unless you are building low-level instructions.

Token Badges

TokenBadge is a 160 byte account that records an operator-approved Token 2022 mint. Pool creation and reward initialization require this account when the mint is not permissionless-supported, unless the pool is created from a private config with CreatePoolWithoutMintValidation. A badge cannot be created for a mint that is already permissionlessly supported, and it cannot override the native Token 2022 mint rejection. A DBC token badge is not a DAMM v2 token badge. DBC-migrated Stock Tokens use private DAMM v2 configs with CreatePoolWithoutMintValidation instead of a per-mint DAMM v2 badge. See Token 2022 support for the permissionless allowlist, badge review path, and config permission rules.

Program

TypeScript SDK

Rust Integration

Go Integration

API Reference

PDA Map

Constants

Enums

Config

PoolFeesConfig

Pool

PoolMetrics

RewardInfo

Position

PositionMetrics

UserRewardInfo

InnerVesting

Rewards And Vesting

Token Badges

​PDA Map

​Constants

​Enums

​Config

​PoolFeesConfig

​Pool

​PoolMetrics

​RewardInfo

​Position

​PositionMetrics

​UserRewardInfo

​InnerVesting

​Rewards And Vesting

​Token Badges

PDA Map

Constants

Enums

Config

PoolFeesConfig

Pool

PoolMetrics

RewardInfo

Position

PositionMetrics

UserRewardInfo

InnerVesting

Rewards And Vesting

Token Badges