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

Position ownership is checked through the position NFT token account. The token account must hold exactly one NFT and be owned by the signer.

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

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. 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