DAMM v1 Changelog

​

Release summary

​

What We Shipped

• Version 1 vaults price LP shares with vault.total_lp_supply
• SDK 2.0.0 quotes pool LP with pool.lpMintSupply (program 0.5.6) and vault LP with vault.totalLpSupply (program 0.5.7)

​

Program: meteora-dynamic-amm 0.5.7

​

Fixed

• Version 1 vaults price LP shares with vault.total_lp_supply. The pool reads vault.total_lp_supply for version 1 vaults and lp_mint.supply for legacy (version 0) vaults.

​

Changed

• libs/mercurial-vault uses the new vault layout: the last strategy slot (MAX_STRATEGY 30 → 29) now holds version, total_lp_supply and _padding0. Account size and the offsets of later fields are unchanged.
• swap, add_balance_liquidity, add_imbalance_liquidity, remove_liquidity_single_side, lock, claim_fee, bootstrap_liquidity, get_pool_info and permissionless pool initialization read the vault LP supply with VaultUtils::get_vault_lp_supply instead of *_vault_lp_mint.supply (program 0.5.6).

​

Added

• New error InvalidVaultLpSupplyAccounting, returned when a version 1 vault has total_lp_supply lower than its LP mint supply.

​

TypeScript SDK: @meteora-ag/dynamic-amm-sdk 2.0.0

​

Added

• getVaultLpSupply to get the vault LP supply used for share pricing

​

Changed

• Sync IDL with DAMM v1 program 0.5.7
• Bump @coral-xyz/anchor and @coral-xyz/borsh to 0.31.1
• Quotes price pool LP with pool.lpMintSupply (program 0.5.6) and vault LP with vault.totalLpSupply for version 1 vaults (program 0.5.7)
• getLpSupply and poolState.lpSupply return pool.lpMintSupply (program 0.5.6)

​

Removed

• moveLockedLP, the program has no move_locked_lp endpoint

​

Fixed

• Stable pool single side withdraw passes the requested out amount as minimum_out_amount instead of 0
• Swap quotes charge a minimum trading and protocol fee of 1 token, as the program does
• Balanced deposit quotes round token amounts up, as the program does

​

Breaking Changes

• AmmIdl is the Anchor 0.30+ IDL JSON and Amm is its type. Load it with @coral-xyz/anchor 0.30 or later: new Program({ ...AmmIdl, address }, provider)
• calculateSwapQuote and calculatePoolInfo callers must pass vaultALpSupply and vaultBLpSupply from getVaultLpSupply
• calculatePoolInfo, StableSwap.computeImbalanceDeposit, and StableSwap.computeWithdrawOne take pool lpSupply from pool.lpMintSupply (getLpSupply / poolState.lpSupply)

​

Rust quote: dynamic-amm-quote 0.0.6

​

Changed

• compute_quote prices vault LP with Vault::get_lp_supply (program 0.5.7)
• Vault state uses the 0.5.7 layout with version and total_lp_supply, Pool state adds lp_mint_supply
• rust-client deposit and pool info use the same LP supplies as the program
• PoolError includes the program errors up to InvalidVaultLpSupplyAccounting (6065)

​

Release summary

​

What We Shipped

• Pools price LP shares with pool.lp_mint_supply
• Withdrawals reject LP accounts that the user does not own

​

What To Do

​

Program: meteora-dynamic-amm 0.5.6

​

Fixed

• LP shares are priced with pool.lp_mint_supply, which changes only when the program mints or burns LP.
• remove_balance_liquidity and remove_liquidity_single_side require user_pool_lp.owner == user before burning LP.

​

Changed

• add_balance_liquidity, add_imbalance_liquidity, remove_balance_liquidity, remove_liquidity_single_side, lock, claim_fee and get_pool_info use pool.lp_mint_supply instead of lp_mint.supply.
• Pool initialization, bootstrap_liquidity, add liquidity, remove liquidity and claim_fee update pool.lp_mint_supply by the amount of LP minted or burned.
• bootstrap_liquidity additionally requires pool.lp_mint_supply == 0, so a pool whose LP was burned to zero outside the program can not be re-bootstrapped.

​

Added

• New error LpMintSupplyAccountingNotPatched, returned when pool.lp_mint_supply is lower than lp_mint.supply.
• New error InvalidLpOwner, returned when user_pool_lp is not owned by user in remove_balance_liquidity or remove_liquidity_single_side.

​

Breaking Changes

• Every existing pool must have pool.lp_mint_supply set before this version is deployed. Liquidity operations on a pool where pool.lp_mint_supply < lp_mint.supply fail with LpMintSupplyAccountingNotPatched.
• remove_balance_liquidity and remove_liquidity_single_side no longer accept an LP account that user only controls as a delegate; the LP account owner must sign as user.
• Off-chain integrations that compute LP value or quote add/remove liquidity must read pool.lp_mint_supply instead of the LP mint supply.

​

Release summary

​

What We Shipped

• Zap Protocol Fee Support

​

Program: meteora-dynamic-amm 0.5.3

​

Changed

• Upgrade to anchor 0.31.1
• Add new endpoint create_operator_account and close_operator_account that allows admin to manage different operator accounts
• Add new account Operator, that would stores whitelisted_address as well as their operational permissions
• Add new endpoint zap_protocol_fee that allow operator to claim protocol fees and zap out to SOL/USDC or other token in pool and send to treasury address

​

Breaking Changes

• withdraw_protocol_fees can only be performed by an operator. The endpoint now requires max_amount_a and max_amount_b as arguments. The accounts passed in have also been changed.

​

Fixed

• Fixed initialization of stable swap error with AmountNotPeg due to the precision loss of the underlying vault exchange rate.