DAMM v2 Instructions

The cp-amm IDL exposes many instructions. Integrators can choose to either use the TypeScript SDK for transaction construction or build through CPI.

Pool Creation

Instruction	TypeScript SDK	Use
`initialize_pool`	`createPool`	Create a permissionless pool from a static config. Honors `CreatePoolWithoutMintValidation` on private configs. Rejects `RateLimiter` configs.
`initialize_pool_with_dynamic_config`	`createCustomPoolWithDynamicConfig`	Create a pool from a dynamic config where the creator supplies pool-specific parameters. Honors `CreatePoolWithoutMintValidation` on private configs. Rejects `RateLimiter`.
`initialize_customizable_pool`	`createCustomPool`	Create a customizable launch pool without a config PDA. Always validates mints (`skip=false`). Rejects `RateLimiter`.

Pool creation initializes the pool, vaults, first position, and Token-2022 position NFT. Pool PDAs sort mints in the seed list, but transaction builders should use the canonical token_a_mint and token_b_mint fields from pool state after creation.

When mint validation is not skipped, pass token badge remaining accounts at index 0 (token A) and index 1 (token B) for mints that are not permissionless-supported. initialize_pool and initialize_pool_with_dynamic_config skip those checks when the private config has CreatePoolWithoutMintValidation. initialize_customizable_pool always validates mints. Token-2022 wrapped SOL is still rejected.

Positions

Instruction	TypeScript SDK	Use
`create_position`	`createPosition`	Mint a Token-2022 position NFT and initialize an empty position.
`close_position`	`closePosition`	Close an empty position account and position NFT.
`split_position`	`splitPosition`	Split liquidity, fees, rewards, and inner vesting by independent percentage fields.
`split_position2`	`splitPosition2`	Split all supported position state by one numerator over `SPLIT_POSITION_DENOMINATOR`. Owner only.
`update_delegate_permission`	`updateDelegatePermission`	NFT holder sets `Position.delegate_permission`. The SDK also SPL-approves the delegate with amount `0`.

The position NFT token account must hold exactly one NFT and match position.nft_mint. The NFT holder can sign every position instruction. A Token-2022 delegate can sign the instructions below when the matching bit in delegate_permission is set. Approve must use amount 0. A non-zero delegated_amount returns DelegatedAmountNonZero (6070).

Bit	`PositionDelegatePermission`	Instructions
`0`	`AddLiquidity`	`add_liquidity`
`1`	`RemoveLiquidity`	`remove_liquidity`, `remove_all_liquidity`. Any token destination.
`2`	`RemoveLiquidityToOwner`	Same remove instructions, only to the NFT holder’s token accounts.
`3`	`ClaimPositionFee`	`claim_position_fee`. Any token destination.
`4`	`ClaimPositionFeeToOwner`	`claim_position_fee`, only to the NFT holder’s token accounts.
`5`	`ClaimReward`	`claim_reward`. Any token destination.
`6`	`ClaimRewardToOwner`	`claim_reward`, only to the NFT holder’s token account.
`7`	`LockPosition`	`lock_position`, `lock_inner_position`, `permanent_lock_position`.

If an unrestricted bit and its ToOwner bit are both set, the unrestricted bit applies. Bits above these eight return InvalidPermission (6054). permission = 0 clears the bitmask and leaves the SPL delegate in place. claim_reward with skip_reward = 1 on a frozen reward vault requires ClaimReward. ClaimRewardToOwner is not enough, because that path clears the pending reward without paying it. close_position, split_position, and split_position2 reject a delegate. On the delegated instructions the signer account is named signer. The TypeScript SDK parameter is still owner. Pass positionNftAccount as the token account that currently holds the NFT.

Liquidity And Locks

Instruction	TypeScript SDK	Use
`add_liquidity`	`addLiquidity`, `createPositionAndAddLiquidity`	Add liquidity to an existing or newly created position.
`remove_liquidity`	`removeLiquidity`	Withdraw a selected amount of unlocked liquidity.
`remove_all_liquidity`	`removeAllLiquidity`, `removeAllLiquidityAndClosePosition`, `mergePosition`	Withdraw all currently unlocked liquidity.
`lock_position`	`lockPosition`	Lock liquidity with an external vesting account.
`lock_inner_position`	`lockPosition({ innerPosition: true })`	Lock liquidity using embedded `Position.inner_vesting`.
`refresh_vesting`	`refreshVesting`	Release available vested liquidity into unlocked liquidity.
`permanent_lock_position`	`permanentLockPosition`	Move unlocked liquidity into permanent lock.

Add and remove liquidity update pool rewards, position rewards, fees, reserves, and liquidity before transferring tokens.

Swaps

Instruction	TypeScript SDK	Use
`swap`	`swap`	Legacy exact-in swap path.
`swap2`	`swap2`	Current exact-in, partial-fill, and exact-out swap path.

Swap Modes

swap2 accepts SwapMode:

Mode	Parameter meaning
`ExactIn`	`amount_0` is input amount; `amount_1` is minimum output
`PartialFill`	`amount_0` is input amount; `amount_1` is minimum output; execution may stop at pool bounds
`ExactOut`	`amount_0` is desired output; `amount_1` is maximum input

New integrations should prefer swap2 and SDK getQuote2 because they share exact-in, partial-fill, and exact-out semantics.

Fees And Rewards

Instruction	TypeScript SDK	Use
`claim_position_fee`	`claimPositionFee`, `claimPositionFee2`	Claim pending LP fees from a position.
`initialize_reward`	`initializeReward`, `initializeAndFundReward`	Initialize one of the two reward slots.
`fund_reward`	`fundReward`, `initializeAndFundReward`	Fund reward emissions.
`claim_reward`	`claimReward`	Claim pending liquidity mining rewards.
`withdraw_ineligible_reward`	`withdrawIneligibleReward`	Withdraw undistributable rewards after campaign constraints allow it.
`withdraw_dead_liquidity_reward`	`withdrawDeadLiquidityReward`	Funder withdraws the `DEAD_LIQUIDITY` reward share on a compounding pool.
`update_reward_duration`	`updateRewardDuration`	Update reward campaign duration.
`update_reward_funder`	`updateRewardFunder`	Update the funder authority for a reward slot.

Reward index 0 and 1 are the only supported reward slots. reward_per_token_stored, fee_a_per_liquidity, and fee_b_per_liquidity wrap when a growth step does not fit. A pending reward or fee above u64::MAX is clamped. add_liquidity, remove_liquidity, remove_all_liquidity, claim_reward, split_position, split_position2, fund_reward, withdraw_ineligible_reward, withdraw_dead_liquidity_reward, and swap stay available after that wrap. withdraw_dead_liquidity_reward and claim_protocol_fee2 wrap the dead-liquidity checkpoint quotient to a u64.

Config And Operator Instructions

Instruction	Use
`create_config`	Operator creates a static config. `permission` is the trailing `u128` on `StaticConfigParameters`. Non-zero permission is allowed only on private configs (non-default `pool_creator_authority`). Rejects `RateLimiter`.
`create_dynamic_config`	Operator creates a dynamic config. `permission` is the trailing `u128` on `DynamicConfigParameters`. Same private-config permission rule.
`create_token_badge`	Operator creates a token badge PDA for a mint that is not permissionless-supported.
`close_token_badge`	Operator closes a token badge and returns rent. Existing pools that already use the mint keep working.
`claim_protocol_fee2`	Protocol fee authority claims one pool token per call. On a compounding pool it first settles the `DEAD_LIQUIDITY` share of claimable token B fees into `protocol_b_fee`. The compounded share stays in the reserve. `PoolMetrics.total_protocol_b_fee` is not increased by that settlement. Replaces the removed `claim_protocol_fee` and `zap_protocol_fee` instructions.

permission is set at config creation and is immutable. There is no instruction to update Config.permission. Public configs (default pool_creator_authority) must use permission = 0. The only defined bit today is CreatePoolWithoutMintValidation (1 << 0). InvalidConfigPermission (6072) is returned when a public config is given a non-zero permission, or when permission bits are outside the defined ConfigPermission range.

Token-2022 wrapped SOL is rejected during mint validation even when CreatePoolWithoutMintValidation is set. Use the standard wrapped SOL mint.

claim_protocol_fee and zap_protocol_fee are removed. Use claim_protocol_fee2.

Program

TypeScript SDK

Rust Integration

Go Integration

API Reference

Pool Creation

Positions

Liquidity And Locks

Swaps

Swap Modes

Fees And Rewards

Config And Operator Instructions

​Pool Creation

​Positions

​Liquidity And Locks

​Swaps

​Swap Modes

​Fees And Rewards

​Config And Operator Instructions

Pool Creation

Positions

Liquidity And Locks

Swaps

Swap Modes

Fees And Rewards

Config And Operator Instructions