DBC TS SDK Reference

This page is based on the public declaration surface of @meteora-ag/dynamic-bonding-curve-sdk. Use it as the high-level map for the SDK, then open the package types when you need exact parameter shapes.

import {
  DynamicBondingCurveClient,
  ActivationType,
  BaseFeeMode,
  CollectFeeMode,
  MigrationOption,
  SwapMode,
  buildCurveWithMarketCap,
  deriveDbcPoolAddress,
  getDynamicFeeParams,
  getFeeSchedulerParams,
  getRateLimiterParams,
} from "@meteora-ag/dynamic-bonding-curve-sdk";

Dependencies

Package	Version
`@coral-xyz/anchor`	`^0.31.0`
`@solana/web3.js`	`^1.98.0`
`@solana/spl-token`	`^0.4.13`
`bn.js`	`^5.2.1`
`decimal.js`	`^10.5.0`

Program IDs

Program	ID
DBC	`dbcij3LWUppWqq96dh6gJWwBifmcGfLSB5D4DuSMaqN`
DAMM v1	`Eo7WjKq67rjJQSZxS6z3YkapzY3eMj6Xy8X5EQVn5UaB`
DAMM v2	`cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG`
Locker	`LocpQgucEQHbqNABEYvBvwoxCPsSbG91A1QaQhQQqjn`
Dynamic Vault	`24Uqj9JCLxUeoC3hGfh5W3s9FM9uCHDS2SG3LYwBpyTi`
Metaplex metadata	`metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s`

Core Exports

Export	Use
`DynamicBondingCurveClient`	Main SDK client. Exposes `pool`, `partner`, `creator`, `migration`, and `state` services.
`DynamicBondingCurveIdl`	Bundled Anchor IDL JSON for `dynamic_bonding_curve`.
`DynamicBondingCurveTypes`	IDL TypeScript type export.
`DynamicBondingCurveProgram`	Base service class with the connection-backed Anchor program.
`types` exports	IDL account types, SDK parameter types, enums, and quote result types.
`constants` exports	Program IDs, fee constants, curve limits, migration fee config keys, and default parameter structs.
`helpers` exports	Curve builders, PDA helpers, validation helpers, token helpers, instruction helpers, and config math helpers.
`services` exports	Service classes for partner, pool, creator, migration, program, and state flows.
`math` exports	Curve math, swap quote math, fee math, safe math, and pool fee handlers.

Enums

Enum	Values
`ActivationType`	`Slot = 0`, `Timestamp = 1`.
`TokenType`	`SPLToken = 0`, `Token2022 = 1`.
`CollectFeeMode`	`QuoteToken = 0`, `OutputToken = 1`.
`MigratedCollectFeeMode`	`QuoteToken = 0`, `OutputToken = 1`, `Compounding = 2`.
`DammV2DynamicFeeMode`	`Disabled = 0`, `Enabled = 1`.
`DammV2BaseFeeMode`	`FeeTimeSchedulerLinear = 0`, `FeeTimeSchedulerExponential = 1`, `RateLimiter = 2`, `FeeMarketCapSchedulerLinear = 3`, `FeeMarketCapSchedulerExponential = 4`.
`MigrationOption`	`MET_DAMM = 0`, `MET_DAMM_V2 = 1`.
`BaseFeeMode`	`FeeSchedulerLinear = 0`, `FeeSchedulerExponential = 1`, `RateLimiter = 2`.
`MigrationFeeOption`	`FixedBps25 = 0`, `FixedBps30 = 1`, `FixedBps100 = 2`, `FixedBps200 = 3`, `FixedBps400 = 4`, `FixedBps600 = 5`, `Customizable = 6`.
`TokenDecimal`	`SIX = 6`, `SEVEN = 7`, `EIGHT = 8`, `NINE = 9`.
`TradeDirection`	`BaseToQuote = 0`, `QuoteToBase = 1`.
`SwapMode`	`ExactIn = 0`, `PartialFill = 1`, `ExactOut = 2`.
`TokenAuthorityOption`	`CreatorUpdateAuthority = 0`, `Immutable = 1`, `PartnerUpdateAuthority = 2`, `CreatorUpdateAndMintAuthority = 3`, `PartnerUpdateAndMintAuthority = 4`.

Important Constants

Constant	Value
`MAX_CURVE_POINT`	`16`
`FEE_DENOMINATOR`	`1_000_000_000`
`MAX_BASIS_POINT`	`10_000`
`U16_MAX`, `U24_MAX`, `U64_MAX`, `U128_MAX`	Integer bounds used by validation and math helpers.
`MIN_SQRT_PRICE` / `MAX_SQRT_PRICE`	`4295048016` / `79226673521066979257578248091`
`MIN_FEE_BPS` / `MAX_FEE_BPS`	`25` / `9900`
`MIN_FEE_NUMERATOR` / `MAX_FEE_NUMERATOR`	`2_500_000` / `990_000_000`
`MAX_RATE_LIMITER_DURATION_IN_SECONDS`	`43_200`
`MAX_RATE_LIMITER_DURATION_IN_SLOTS`	`108_000`
`DYNAMIC_FEE_FILTER_PERIOD_DEFAULT`, `DYNAMIC_FEE_DECAY_PERIOD_DEFAULT`, `DYNAMIC_FEE_REDUCTION_FACTOR_DEFAULT`	Default dynamic-fee timing and reduction settings.
`BIN_STEP_BPS_DEFAULT`, `BIN_STEP_BPS_U128_DEFAULT`, `MAX_PRICE_CHANGE_BPS_DEFAULT`	Default dynamic-fee bin and price-change settings.
`PROTOCOL_FEE_PERCENT` / `HOST_FEE_PERCENT`	`20` / `20`
`SWAP_BUFFER_PERCENTAGE`	`25`
`MAX_MIGRATION_FEE_PERCENTAGE` / `MAX_CREATOR_MIGRATION_FEE_PERCENTAGE`	`99` / `100`
`MIN_LOCKED_LIQUIDITY_BPS`	`1000`
`SECONDS_PER_DAY`	`86400`
`MAX_LOCK_DURATION_IN_SECONDS`	`63_072_000`
`PROTOCOL_POOL_CREATION_FEE_PERCENT`	`10`
`MIN_POOL_CREATION_FEE` / `MAX_POOL_CREATION_FEE`	`1_000_000` / `100_000_000_000` lamports
`MIN_MIGRATED_POOL_FEE_BPS` / `MAX_MIGRATED_POOL_FEE_BPS`	`10` / `1000`
`DAMM_V1_MIGRATION_FEE_ADDRESS`, `DAMM_V2_MIGRATION_FEE_ADDRESS`	Published migration fee config addresses used by migrated-pool flows.
`DEFAULT_MIGRATED_POOL_FEE_PARAMS`, `DEFAULT_LIQUIDITY_VESTING_INFO_PARAMS`, `DEFAULT_MIGRATED_POOL_MARKET_CAP_FEE_SCHEDULER_PARAMS`	Default config helper structs.

Creating A Client

import { Connection } from "@solana/web3.js";
import { DynamicBondingCurveClient } from "@meteora-ag/dynamic-bonding-curve-sdk";

const connection = new Connection(process.env.RPC_URL!, "confirmed");
const client = DynamicBondingCurveClient.create(connection, "confirmed");

The client creates service instances for transactions, quotes, and account reads. The returned transactions are unsigned; callers still set blockhashes when needed, sign, simulate, and submit.

Complete Function Index

Client And Program Helpers

Function or method	Returns	Use
`new DynamicBondingCurveClient(connection, commitment)`	`DynamicBondingCurveClient`	Construct a client and its service instances manually.
`DynamicBondingCurveClient.create(connection, commitment?)`	`DynamicBondingCurveClient`	Preferred client factory. Defaults commitment to `confirmed`.
`new DynamicBondingCurveProgram(connection, commitment)`	`DynamicBondingCurveProgram`	Construct the base program service used by concrete services.
`DynamicBondingCurveProgram.getProgram()`	`Program<DynamicBondingCurve>`	Return the underlying Anchor program instance.
`createDbcProgram(connection, commitment?)`	DBC program wrapper	Create an Anchor program for the DBC IDL and program ID.
`createDynamicVaultProgram(connection, commitment?)`	Dynamic Vault program wrapper	Create an Anchor program for Dynamic Vault migration helpers.
`createDammV1Program(connection, commitment?)`	DAMM v1 program wrapper	Create an Anchor program for DAMM v1 migration helpers.
`createDammV2Program(connection, commitment?)`	DAMM v2 program wrapper	Create an Anchor program for DAMM v2 migration helpers.

`PartnerService`

Method	Returns	Use
`createConfig(params)`	`Promise<Transaction>`	Create a `PoolConfig` from `CreateConfigParams`.
`createConfigWithTransferHook(params)`	`Promise<Transaction>`	Create a `ConfigWithTransferHook` from `CreateConfigWithTransferHookParams`.
`createConfigAndPool(params)`	`Promise<Transaction>`	Build one transaction that creates a config and initializes a standard pool.
`createConfigAndPoolWithTransferHook(params)`	`Promise<Transaction>`	Build one transaction that creates a transfer-hook config and initializes a transfer-hook pool.
`createConfigAndPoolWithFirstBuy(params)`	`Promise<{ createConfigTx; createPoolWithFirstBuyTx }>`	Build separate config and pool-with-first-buy transactions for a standard pool.
`createConfigAndPoolWithFirstBuyWithTransferHook(params)`	`Promise<{ createConfigTx; createPoolWithFirstBuyTx }>`	Build separate config and pool-with-first-buy transactions for a transfer-hook pool.
`createPartnerMetadata(params)`	`Promise<Transaction>`	Create partner metadata for a fee claimer.
`claimPartnerTradingFee(params)`	`Promise<Transaction>`	Claim partner trading fees with optional SOL wrapping behavior.
`claimPartnerTradingFeeToReceiver(params)`	`Promise<Transaction>`	Claim standard-pool partner trading fees to an explicit receiver.
`claimPartnerTradingFee2(params)`	`Promise<Transaction>`	Claim transfer-hook pool partner trading fees.
`partnerWithdrawSurplus(params)`	`Promise<Transaction>`	Withdraw partner surplus after migration.
`partnerWithdrawMigrationFee(params)`	`Promise<Transaction>`	Withdraw the partner share of migration fees.
`claimPartnerPoolCreationFee(params)`	`Promise<Transaction>`	Claim the partner share of pool creation fees.

`PoolService`

Method	Returns	Use
`swap(params)`	`Promise<Transaction>`	Build the legacy exact-in swap transaction.
`swap2(params)`	`Promise<Transaction>`	Build the preferred swap transaction for exact-in, partial-fill, and exact-out modes.
`swap2WithTransferHook(params)`	`Promise<Transaction>`	Build the transfer-hook swap transaction for exact-in, partial-fill, and exact-out modes.
`swapQuote(params)`	`SwapQuoteResult`	Quote the legacy exact-in swap path.
`swapQuote2(params)`	`SwapQuote2Result`	Quote `SwapMode.ExactIn`, `PartialFill`, or `ExactOut`.

`CreatorService`

Method	Returns	Use
`createPool(params)`	`Promise<Transaction>`	Create a standard virtual pool from an existing config and base mint.
`createPoolWithTransferHook(params)`	`Promise<Transaction>`	Create a transfer-hook pool from an existing transfer-hook config.
`createPoolWithFirstBuy(params)`	`Promise<Transaction>`	Create a standard pool and include an initial buy.
`createPoolWithFirstBuyWithTransferHook(params)`	`Promise<Transaction>`	Create a transfer-hook pool and include an initial buy.
`createPoolWithPartnerAndCreatorFirstBuy(params)`	`Promise<Transaction>`	Create a standard pool with partner and creator first-buy handling.
`createPoolWithPartnerAndCreatorFirstBuyWithTransferHook(params)`	`Promise<Transaction>`	Create a transfer-hook pool with partner and creator first-buy handling.
`createPoolMetadata(params)`	`Promise<Transaction>`	Create optional metadata for a virtual pool.
`claimCreatorTradingFee(params)`	`Promise<Transaction>`	Claim creator trading fees with optional SOL wrapping behavior.
`claimCreatorTradingFeeToReceiver(params)`	`Promise<Transaction>`	Claim standard-pool creator trading fees to an explicit receiver.
`claimCreatorTradingFee2(params)`	`Promise<Transaction>`	Claim transfer-hook pool creator trading fees.
`creatorWithdrawSurplus(params)`	`Promise<Transaction>`	Withdraw creator surplus after migration.
`transferPoolCreator(params)`	`Promise<Transaction>`	Transfer creator rights to a new creator.
`creatorWithdrawMigrationFee(params)`	`Promise<Transaction>`	Withdraw the creator share of migration fees.

`MigrationService`

Method	Returns	Use
`createLocker(params)`	`Promise<Transaction>`	Create a locker escrow when locked vesting is configured.
`withdrawLeftover(params)`	`Promise<Transaction>`	Withdraw leftover base tokens after migration.
`createDammV1MigrationMetadata(params)`	`Promise<Transaction>`	Create DAMM v1 migration metadata.
`migrateToDammV1(params)`	`Promise<Transaction>`	Migrate a completed DBC pool to DAMM v1.
`lockDammV1LpToken(params)`	`Promise<Transaction>`	Lock DAMM v1 LP allocation.
`claimDammV1LpToken(params)`	`Promise<Transaction>`	Claim locked DAMM v1 LP allocation.
`migrateToDammV2(params)`	`Promise<MigrateToDammV2Response>`	Migrate a completed DBC pool to DAMM v2 and return position NFT keypairs with the transaction.

`StateService`

Method	Returns	Use
`getPoolConfig(configAddress)`	`Promise<PoolConfig or null>`	Fetch one standard or transfer-hook config. Transfer-hook configs return the embedded `PoolConfig`.
`getPoolConfigs()`	`Promise<ProgramAccount<PoolConfig>[]>`	Fetch all standard and transfer-hook configs.
`getPoolConfigsByOwner(owner)`	`Promise<ProgramAccount<PoolConfig>[]>`	Fetch standard and transfer-hook configs by partner owner or fee claimer.
`getPool(poolAddress)`	`Promise<VirtualPool or null>`	Fetch one standard or transfer-hook pool account.
`getPools()`	`Promise<ProgramAccount<VirtualPool>[]>`	Fetch all standard and transfer-hook pool accounts.
`getPoolsByConfig(configAddress)`	`Promise<ProgramAccount<VirtualPool>[]>`	Fetch standard and transfer-hook pools created from one config.
`getPoolsByCreator(creatorAddress)`	`Promise<ProgramAccount<VirtualPool>[]>`	Fetch standard and transfer-hook pools by creator.
`getPoolByBaseMint(baseMint)`	`Promise<ProgramAccount<VirtualPool> or null>`	Resolve a standard or transfer-hook pool by base mint.
`getPoolMigrationQuoteThreshold(poolAddress)`	`Promise<BN>`	Read the migration quote threshold for a pool.
`getPoolQuoteTokenCurveProgress(poolAddress)`	`Promise<number>`	Calculate quote-side curve progress.
`getPoolBaseTokenCurveProgress(poolAddress)`	`Promise<number>`	Calculate base-side curve progress.
`getPoolMetadata(pool)`	`Promise<VirtualPoolMetadata[]>`	Fetch optional pool metadata accounts.
`getPartnerMetadata(feeClaimer)`	`Promise<PartnerMetadata[]>`	Fetch optional partner metadata accounts.
`getPoolFeeMetrics(poolAddress)`	Fee metrics object	Read lifetime fee metrics for one pool.
`getPoolFeeBreakdown(poolAddress)`	Fee breakdown object	Read current claimable fee breakdown for partner and creator.
`getPoolsFeesByConfig(configAddress)`	Aggregated fee metrics	Aggregate fee metrics across pools for one config.
`getPoolsFeesByCreator(creatorAddress)`	Aggregated fee metrics	Aggregate fee metrics across pools for one creator.
`getDammV1MigrationMetadata(poolAddress)`	`Promise<MeteoraDammMigrationMetadata>`	Fetch DAMM v1 migration metadata.

Curve Builder Helpers

All curve builders return ConfigParameters.

Function	Params type	Extra fields beyond `BuildCurveBaseParams`	Use
`buildCurve`	`BuildCurveParams`	`percentageSupplyOnMigration`, `migrationQuoteThreshold`	Build a config from target migration amount and supply percentage.
`buildCurveWithMarketCap`	`BuildCurveWithMarketCapParams`	`initialMarketCap`, `migrationMarketCap`	Build a config from market-cap targets.
`buildCurveWithTwoSegments`	`BuildCurveWithTwoSegmentsParams`	`initialMarketCap`, `migrationMarketCap`, `percentageSupplyOnMigration`	Build a two-segment curve.
`buildCurveWithMidPrice`	`BuildCurveWithMidPriceParams`	`initialMarketCap`, `migrationMarketCap`, `midPrice`, `percentageSupplyOnMigration`	Build a two-segment curve with a specified midpoint.
`buildCurveWithLiquidityWeights`	`BuildCurveWithLiquidityWeightsParams`	`initialMarketCap`, `migrationMarketCap`, `liquidityWeights`	Shape curve liquidity distribution with weights.
`buildCurveWithCustomSqrtPrices`	`BuildCurveWithCustomSqrtPricesParams`	`sqrtPrices`, optional `liquidityWeights`	Build a curve with explicit square-root price checkpoints.

Config, Curve, And Account Helpers

Function	Use
`getFirstKey`	Return the first ordered key buffer used by sorted PDA seeds.
`getSecondKey`	Return the second ordered key buffer used by sorted PDA seeds.
`getAccountData`	Fetch and decode one Anchor account by account type.
`getAccountCreationTimestamp`	Return the block-time timestamp of the newest fetched signature for one account.
`getAccountCreationTimestamps`	Batch `getAccountCreationTimestamp` over multiple accounts.
`getTotalTokenSupply`	Add circulating supply and locked vesting supply.
`getPriceFromSqrtPrice`	Convert a square-root price into UI price with base and quote decimals.
`getSqrtPriceFromPrice`	Convert UI price into a square-root price.
`createSqrtPrices`	Build square-root price checkpoints from UI price inputs.
`getSqrtPriceFromMarketCap`	Convert market cap and supply inputs into a square-root price.
`getBaseTokenForSwap`	Compute base-token movement for a swap against the curve.
`getMigrationQuoteAmountFromMigrationQuoteThreshold`	Convert a migration quote threshold into a migration quote amount.
`getMigrationQuoteThresholdFromMigrationQuoteAmount`	Convert a migration quote amount into a migration quote threshold.
`getProtocolMigrationFee`	Resolve protocol migration fee settings for a migration option and fee option.
`getMigrationBaseToken`	Calculate base tokens reserved for migration.
`getTotalVestingAmount`	Calculate total locked vesting amount from vesting params.
`getLiquidity`	Calculate liquidity from base amount and square-root price range.
`getFirstCurve`	Build the first curve segment from supply and price targets.
`getTotalSupplyFromCurve`	Sum total supply represented by curve checkpoints.
`getMigrationThresholdPrice`	Calculate the price at the migration threshold.
`getCurveBreakdown`	Return per-segment curve supply and quote breakdown.
`getSwapAmountWithBuffer`	Add SDK swap buffer percentage to a swap amount.
`getPercentageSupplyOnMigration`	Calculate migration supply percentage from curve parameters.
`calculateAdjustedPercentageSupplyOnMigration`	Adjust migration supply percentage for locked vesting and leftovers.
`getMigrationQuoteAmount`	Calculate quote amount needed for migration.
`getFeeSchedulerParams`	Convert scheduler inputs into DBC base-fee params.
`calculateFeeSchedulerEndingBaseFeeBps`	Calculate ending scheduler fee bps from starting fee and reduction inputs.
`getRateLimiterParams`	Convert rate-limiter inputs into DBC base-fee params.
`getDynamicFeeParams`	Build dynamic-fee params from base fee and optional price-change limit.
`getStartingBaseFeeBpsFromBaseFeeParams`	Recover starting base-fee bps from base-fee params.
`computeSqrtPriceStepBps`	Calculate bps step between two square-root prices.
`getMigratedPoolMarketCapFeeSchedulerParams`	Build DAMM v2 market-cap fee scheduler params for migrated pools using `priceMultiple`.
`getLockedVestingParams`	Convert locked vesting inputs into program vesting params.
`getLiquidityVestingInfoParams`	Convert migrated-liquidity vesting inputs into program vesting params.
`getTwoCurve`	Build a two-segment curve from target inputs.
`checkRateLimiterApplied`	Check whether rate limiter behavior applies at a point.
`getBaseFeeParams`	Normalize base-fee helper inputs into program params.
`getQuoteReserveFromNextSqrtPrice`	Calculate quote reserve from the next square-root price.
`getTokenomics`	Calculate tokenomics breakdown for a configured curve.
`getMigratedPoolFeeParams`	Build migrated-pool fee params from migration and fee config inputs.
`getCurrentPoint`	Return current slot or timestamp based on activation type.
`prepareSwapAmountParam`	Prepare swap amount fields for swap instruction params.
`getVestingLockedLiquidityBpsAtNSeconds`	Calculate locked-liquidity bps at an elapsed time.
`calculateLockedLiquidityBpsAtTime`	Calculate locked-liquidity bps at a concrete timestamp.

PDA Helpers

Function	Use
`deriveDbcEventAuthority`	Derive the DBC event authority PDA.
`deriveDammV1EventAuthority`	Derive the DAMM v1 event authority PDA.
`deriveDammV2EventAuthority`	Derive the DAMM v2 event authority PDA.
`deriveLockerEventAuthority`	Derive the locker event authority PDA.
`deriveDbcPoolAuthority`	Derive the DBC pool authority PDA.
`deriveDammV1PoolAuthority`	Derive the DAMM v1 pool authority PDA.
`deriveDammV2PoolAuthority`	Derive the DAMM v2 pool authority PDA.
`deriveDbcPoolAddress`	Derive a DBC virtual pool address from quote mint, base mint, and config.
`deriveDammV1PoolAddress`	Derive a migrated DAMM v1 pool address.
`deriveDammV2PoolAddress`	Derive a migrated DAMM v2 pool address.
`deriveMintMetadata`	Derive Metaplex metadata PDA for a mint.
`derivePartnerMetadata`	Derive partner metadata PDA from fee claimer.
`deriveDbcPoolMetadata`	Derive DBC pool metadata PDA.
`deriveDammV1MigrationMetadataAddress`	Derive DAMM v1 migration metadata PDA.
`deriveDammV2MigrationMetadataAddress`	Derive DAMM v2 migration metadata PDA.
`deriveDbcTokenVaultAddress`	Derive a DBC token vault PDA.
`deriveDammV1VaultLPAddress`	Derive a DAMM v1 vault LP address.
`deriveDammV2TokenVaultAddress`	Derive a DAMM v2 token vault address.
`deriveVaultAddress`	Derive a Dynamic Vault address.
`deriveVaultPdas`	Derive Dynamic Vault, token vault, and LP mint PDAs together.
`deriveTokenVaultKey`	Derive a Dynamic Vault token vault PDA.
`deriveVaultLpMintAddress`	Derive a Dynamic Vault LP mint PDA.
`deriveDammV1LpMintAddress`	Derive DAMM v1 LP mint PDA.
`derivePositionAddress`	Derive DAMM v2 position PDA from a position NFT mint.
`derivePositionNftAccount`	Derive the canonical position NFT token account.
`deriveDammV1LockEscrowAddress`	Derive DAMM v1 lock escrow PDA.
`deriveDammV2LockEscrowAddress`	Derive DAMM v2 lock escrow PDA.
`deriveEscrow`	Derive locker escrow PDA.
`deriveDammV1ProtocolFeeAddress`	Derive DAMM v1 protocol fee PDA.
`deriveBaseKeyForLocker`	Derive base key used for locker escrow seeds.

Token, Instruction, And Utility Helpers

Function	Use
`getOrCreateATAInstruction`	Resolve an ATA and return an idempotent creation instruction when needed.
`unwrapSOLInstruction`	Build a wrapped SOL close-account instruction.
`wrapSOLInstruction`	Build native SOL wrapping instructions.
`findAssociatedTokenAddress`	Derive an ATA for mint, owner, and token program.
`getTokenDecimals`	Fetch mint decimals.
`getTokenProgram`	Map `TokenType` to SPL Token or Token-2022 program ID.
`getTokenType`	Read mint ownership and return `TokenType`.
`prepareTokenAccountTx`	Prepare source and destination token accounts for a token transfer or swap.
`cleanUpTokenAccountTx`	Add cleanup instructions for temporary wrapped SOL accounts.
`createInitializePermissionlessDynamicVaultIx`	Build the Dynamic Vault initialize instruction and derived vault addresses.
`createLockEscrowIx`	Build the DAMM v1 lock escrow instruction.
`convertToLamports`	Convert UI decimal amount into lamports for a decimal count.
`fromDecimalToBN`	Convert a `Decimal` value into `BN`.
`convertDecimalToBN`	Convert a decimal value into `BN` using SDK scaling.
`createProgramAccountFilter`	Build a memcmp filter for `getProgramAccounts`.
`isNativeSol`	Check whether a mint is native SOL.
`isDefaultLockedVesting`	Check whether locked vesting params are the SDK default.
`bpsToFeeNumerator`	Convert basis points into fee numerator.
`feeNumeratorToBps`	Convert fee numerator into basis points.

Validation Helpers

Function	Use
`validatePoolFees`	Validate full pool-fee config.
`validateFeeScheduler`	Validate time scheduler base-fee inputs.
`validateFeeRateLimiter`	Validate rate-limiter base-fee inputs.
`validateDynamicFee`	Validate dynamic-fee inputs.
`validateCollectFeeMode`	Validate DBC collect-fee mode.
`validateMigrationAndTokenType`	Validate migration option and token type compatibility.
`validateActivationType`	Validate activation type.
`validateMigrationFeeOption`	Validate migration fee option.
`validateTokenDecimals`	Validate supported base-token decimals.
`validateLPPercentages`	Validate migrated-liquidity percentage split.
`validateCurve`	Validate curve checkpoint count, ordering, and bounds.
`validateTokenSupply`	Validate token supply against curve and vesting requirements.
`validateTokenAuthorityOptions`	Validate mint update-authority and mint-authority option.
`hasMintAuthority`	Check whether a token authority option assigns mint authority.
`validateTransferHookProgram`	Validate that a transfer-hook program id is not default, DBC, SPL Token, or Token 2022.
`validateTransferHookProgramExecutable`	Validate that a transfer-hook program id resolves to an executable account.
`validatePoolCreationFee`	Validate pool creation fee bounds.
`validateLiquidityVestingInfo`	Validate migrated-liquidity vesting schedule.
`validateMinimumLockedLiquidity`	Validate minimum locked liquidity requirements.
`validateMigratedCollectFeeMode`	Validate migrated-pool collect-fee mode.
`validateCompoundingFeeBps`	Validate DAMM v2 compounding fee bps.
`validateMigratedPoolFee`	Validate migrated-pool fee config.
`validateConfigParameters`	Validate complete `ConfigParameters` before config creation.
`validateBaseTokenType`	Validate base mint owner against expected token type.
`validateBalance`	Validate token or SOL balance before building a transaction.
`validateSwapAmount`	Validate nonzero swap amount.
`validateMigratedPoolBaseFeeMode`	Validate DAMM v2 migrated-pool base-fee mode.
`validateMarketCapFeeSchedulerRequiresPoolFeeBps`	Validate market-cap scheduler requirements for migrated-pool fees.
`validateMigrationFee`	Validate custom migration fee percentages.

Swap Quote Math

Function	Use
`getSwapResult`	Execute shared swap quote simulation across the curve.
`swapQuote`	Legacy exact-in quote entry point.
`getSwapResultFromExactInput`	Simulate exact-input swap movement.
`getSwapResultFromPartialInput`	Simulate partial-fill swap movement.
`calculateBaseToQuoteFromAmountIn`	Calculate base-to-quote exact-input movement.
`calculateQuoteToBaseFromAmountIn`	Calculate quote-to-base exact-input movement.
`getSwapResultFromExactOutput`	Simulate exact-output swap movement.
`calculateBaseToQuoteFromAmountOut`	Calculate base-to-quote exact-output movement.
`calculateQuoteToBaseFromAmountOut`	Calculate quote-to-base exact-output movement.
`swapQuoteExactIn`	Preferred exact-in quote helper for `swap2`.
`swapQuotePartialFill`	Preferred partial-fill quote helper for `swap2`.
`swapQuoteExactOut`	Preferred exact-out quote helper for `swap2`.

Curve Math

Function	Use
`getInitialLiquidityFromDeltaQuote`	Calculate initial liquidity from quote amount and square-root price range.
`getInitialLiquidityFromDeltaBase`	Calculate initial liquidity from base amount and square-root price range.
`getDeltaAmountBaseUnsigned`	Calculate unsigned base delta for a liquidity and price range.
`getDeltaAmountBaseUnsigned256`	Calculate unsigned base delta with 256-bit intermediate handling.
`getDeltaAmountBaseUnsignedUnchecked`	Calculate unsigned base delta without public bounds checks.
`getDeltaAmountQuoteUnsigned`	Calculate unsigned quote delta for a liquidity and price range.
`getDeltaAmountQuoteUnsigned256`	Calculate unsigned quote delta with 256-bit intermediate handling.
`getDeltaAmountQuoteUnsignedUnchecked`	Calculate unsigned quote delta without public bounds checks.
`getNextSqrtPriceFromInput`	Calculate next square-root price from input amount.
`getNextSqrtPriceFromOutput`	Calculate next square-root price from output amount.
`getNextSqrtPriceFromQuoteAmountOutRoundingDown`	Calculate next price for quote output with rounding down.
`getNextSqrtPriceFromBaseAmountOutRoundingUp`	Calculate next price for base output with rounding up.
`getNextSqrtPriceFromBaseAmountInRoundingUp`	Calculate next price for base input with rounding up.
`getNextSqrtPriceFromQuoteAmountInRoundingDown`	Calculate next price for quote input with rounding down.

Fee Math

Function	Use
`toNumerator`	Convert bps to fee numerator for a denominator.
`getFeeMode`	Resolve fee collection behavior from collect-fee mode, direction, and referral state.
`getTotalFeeNumeratorFromIncludedFeeAmount`	Infer total fee numerator from an amount that already includes fee.
`getTotalFeeNumeratorFromExcludedFeeAmount`	Infer total fee numerator from an amount before fee.
`getTotalFeeNumerator`	Combine base fee, dynamic fee, and fee mode into total fee numerator.
`getFeeOnAmount`	Calculate fee charged on an amount.
`getExcludedFeeAmount`	Calculate fee amount excluded from input.
`getIncludedFeeAmount`	Calculate fee amount included in output.
`splitFees`	Split total fee into protocol, partner, creator, and referral components.

Pool Fee Math

Function or class	Use
`new FeeRateLimiter(...)`	Create a base-fee handler for rate-limiter mode.
`FeeRateLimiter.validate`	Validate the rate-limiter handler against collect-fee and activation settings.
`FeeRateLimiter.getMinBaseFeeNumerator`	Return the minimum base-fee numerator for the rate limiter.
`FeeRateLimiter.getBaseFeeNumeratorFromIncludedFeeAmount`	Calculate base fee from an amount that includes fee.
`FeeRateLimiter.getBaseFeeNumeratorFromExcludedFeeAmount`	Calculate base fee from an amount before fee.
`new FeeScheduler(...)`	Create a base-fee handler for linear or exponential scheduler mode.
`FeeScheduler.validate`	Validate the scheduler handler.
`FeeScheduler.getMinBaseFeeNumerator`	Return the scheduler minimum base-fee numerator.
`FeeScheduler.getBaseFeeNumeratorFromIncludedFeeAmount`	Calculate scheduled base fee for an included-fee amount.
`FeeScheduler.getBaseFeeNumeratorFromExcludedFeeAmount`	Calculate scheduled base fee for an excluded-fee amount.
`getBaseFeeHandler`	Instantiate the correct base-fee handler from base-fee mode.
`isDynamicFeeEnabled`	Check whether dynamic fee config is active.
`getVariableFeeNumerator`	Calculate variable dynamic-fee numerator from volatility state.
`getFeeSchedulerMaxBaseFeeNumerator`	Return max base-fee numerator for scheduler mode.
`getFeeSchedulerMinBaseFeeNumerator`	Return min base-fee numerator for scheduler mode.
`getBaseFeeNumeratorByPeriod`	Calculate scheduler base-fee numerator for a period.
`getFeeNumeratorOnLinearFeeScheduler`	Calculate linear scheduler fee numerator.
`getFeeNumeratorOnExponentialFeeScheduler`	Calculate exponential scheduler fee numerator.
`getBaseFeeNumerator`	Calculate active base-fee numerator for scheduler mode.
`isRateLimiterApplied`	Check if rate limiter applies at the current point and trade direction.
`isZeroRateLimiter`	Check whether rate-limiter config is effectively zero.
`isNonZeroRateLimiter`	Check whether rate-limiter config is nonzero.
`getMaxIndex`	Calculate max rate-limiter fee index.
`getMaxOutAmountWithMinBaseFee`	Calculate max output amount that can use min base fee.
`getCheckedAmounts`	Calculate bounded amount slices for rate-limiter fee math.
`getFeeNumeratorFromExcludedAmount`	Calculate rate-limiter fee numerator from excluded amount.
`getRateLimiterExcludedFeeAmount`	Calculate excluded fee amount under rate-limiter math.
`getFeeNumeratorFromIncludedAmount`	Calculate rate-limiter fee numerator from included amount.
`getRateLimiterMinBaseFeeNumerator`	Calculate rate-limiter minimum base-fee numerator.

Math Utilities

Function or class method	Use
`SafeMath.add`	Add two `BN` values.
`SafeMath.sub`	Subtract two `BN` values and throw on underflow.
`SafeMath.mul`	Multiply two `BN` values.
`SafeMath.div`	Divide two `BN` values and throw on division by zero.
`SafeMath.mod`	Modulo two `BN` values and throw on division by zero.
`SafeMath.shl`	Left shift a `BN`.
`SafeMath.shr`	Right shift a `BN`.
`pow`	Compute scaled exponentiation for `BN` values.
`mulDiv`	Multiply then divide with configured rounding.
`mulShr`	Multiply then right shift by an offset.
`sqrt`	Integer square root for `BN`.

Core Types

Type group	Types
Program and IDL	`DynamicCurveProgram`, `DynamicBondingCurveTypes`, `DynamicBondingCurveIdl`.
Account states	`PoolConfig`, `ConfigWithTransferHook`, `VirtualPool`, `TransferHookPool`, `MeteoraDammMigrationMetadata`, `LockEscrow`, `PartnerMetadata`, `VirtualPoolMetadata`.
Config structs	`ConfigParameters`, `PoolFeeParameters`, `DynamicFeeParameters`, `LiquidityDistributionParameters`, `LockedVestingParameters`, `LiquidityVestingInfoParameters`, `MigratedPoolMarketCapFeeSchedulerParameters`, `TransferHookAccountsInfo`.
Builder config inputs	`TokenConfig`, `FeeConfig`, `BaseFeeParams`, `FeeSchedulerParams`, `RateLimiterParams`, `MigrationConfig`, `MigrationFee`, `MigratedPoolFeeConfig`, `MigratedPoolMarketCapFeeSchedulerParams`, `LiquidityDistributionConfig`, `LockedVestingParams`.
Curve builder params	`BuildCurveBaseParams`, `BuildCurveParams`, `BuildCurveWithMarketCapParams`, `BuildCurveWithTwoSegmentsParams`, `BuildCurveWithMidPriceParams`, `BuildCurveWithLiquidityWeightsParams`, `BuildCurveWithCustomSqrtPricesParams`.
Pool and swap params	`CreatePoolParams`, `CreatePoolWithTransferHookParams`, `CreateConfigAndPoolParams`, `CreateConfigAndPoolWithFirstBuyParams`, `CreateConfigAndPoolWithTransferHookParams`, `CreateConfigAndPoolWithFirstBuyWithTransferHookParams`, `CreatePoolWithFirstBuyParams`, `CreatePoolWithFirstBuyWithTransferHookParams`, `CreatePoolWithPartnerAndCreatorFirstBuyParams`, `CreatePoolWithPartnerAndCreatorFirstBuyWithTransferHookParams`, `FirstBuyWithTransferHookParams`, `PartnerFirstBuyWithTransferHookParams`, `CreatorFirstBuyWithTransferHookParams`, `SwapParams`, `Swap2Params`, `SwapQuoteParams`, `SwapQuote2Params`.
Migration params	`MigrateToDammV1Params`, `MigrateToDammV2Params`, `MigrateToDammV2Response`, `DammLpTokenParams`, `CreateLockerParams`, `CreateDammV1MigrationMetadataParams`.
Claim and withdraw params	`ClaimPartnerTradingFeeParams`, `ClaimPartnerTradingFeeToReceiverParams`, `ClaimCreatorTradingFeeParams`, `ClaimCreatorTradingFeeToReceiverParams`, `PartnerWithdrawSurplusParams`, `CreatorWithdrawSurplusParams`, `WithdrawMigrationFeeParams`, `ClaimPartnerPoolCreationFeeParams`.
Quote and fee results	`SwapResult`, `SwapResult2`, `SwapQuoteResult`, `SwapQuote2Result`, `VolatilityTracker`, `MigratedPoolFee`.

Config Creation Types

client.partner.createConfig accepts CreateConfigParams. The type combines the accounts required by the create_config instruction with the SDK’s computed ConfigParameters. client.partner.createConfigWithTransferHook accepts CreateConfigWithTransferHookParams, which adds transferHookProgram.

Account field	Type	Use
`config`	`PublicKey`	Config account address to initialize.
`feeClaimer`	`PublicKey`	Partner authority that can claim partner fees.
`leftoverReceiver`	`PublicKey`	Receiver for leftover base tokens after migration.
`quoteMint`	`PublicKey`	Quote token mint used by pools created from the config.
`payer`	`PublicKey`	Transaction fee payer and account initializer.
`transferHookProgram`	`PublicKey`	Transfer-hook program for `createConfigWithTransferHook`; it must be executable and cannot be DBC, SPL Token, Token 2022, or the default pubkey.

ConfigParameters is usually produced by one of the curve builders. Pass the returned object directly into createConfig, createConfigWithTransferHook, createConfigAndPool, or createConfigAndPoolWithFirstBuy.

Field	Meaning
`poolFees`	Base-fee and optional dynamic-fee parameters for DBC swaps.
`collectFeeMode`	Whether trading fees are collected in quote token or output token.
`migrationOption`	Destination AMM family, currently DAMM v1 or DAMM v2.
`activationType`	Activation point unit, either slot or timestamp.
`tokenType`	SPL Token or Token-2022 base mint handling.
`tokenDecimal`	Base token decimal enum encoded into the config.
`partnerLiquidityPercentage`, `creatorLiquidityPercentage`	Migrated-pool liquidity share for partner and creator.
`partnerPermanentLockedLiquidityPercentage`, `creatorPermanentLockedLiquidityPercentage`	Migrated-pool liquidity share permanently locked for each party.
`migrationQuoteThreshold`	Quote amount threshold that completes the bonding curve.
`sqrtStartPrice`	Initial square-root price for the virtual curve.
`lockedVesting`	Locked base-token vesting schedule after migration.
`migrationFeeOption`, `migrationFee`	Fixed or customizable migration fee settings.
`tokenSupply`	Total base-token supply for the launch.
`creatorTradingFeePercentage`	Creator share of trading fees.
`tokenAuthorityOption`	Base mint update-authority and mint-authority behavior. Mint-authority options are only valid for transfer-hook configs.
`migratedPoolFee`	Fee settings applied to the migrated DAMM pool.
`poolCreationFee`	Pool creation fee in lamports.
`partnerLiquidityVestingInfo`, `creatorLiquidityVestingInfo`	Optional vesting schedule for migrated liquidity shares.
`migratedPoolBaseFeeMode`	Optional DAMM v2 base-fee mode for graduated pools.
`migratedPoolMarketCapFeeSchedulerParams`	Optional market-cap fee scheduler for DAMM v2 migration. Current helper inputs use `priceMultiple`.
`enableFirstSwapWithMinFee`	Allows the first eligible swap to use the configured minimum-fee path.
`compoundingFeeBps`	DAMM v2 compounding fee bps when migrated collect-fee mode is compounding.
`curve`	Up to `MAX_CURVE_POINT` curve checkpoints.

Builder Input Groups

All curve builders share BuildCurveBaseParams, then add builder-specific target fields.

Group	Fields
`token`	`tokenType`, `tokenBaseDecimal`, `tokenQuoteDecimal`, `tokenAuthorityOption`, `totalTokenSupply`, `leftover`.
`fee`	`baseFeeParams`, `dynamicFeeEnabled`, `collectFeeMode`, `creatorTradingFeePercentage`, `poolCreationFee`, `enableFirstSwapWithMinFee`.
`migration`	`migrationOption`, `migrationFeeOption`, `migrationFee`, optional `migratedPoolFee`.
`liquidityDistribution`	Partner and creator migrated-liquidity percentages, permanent-lock percentages, and optional vesting info for each side.
`lockedVesting`	`totalLockedVestingAmount`, `numberOfVestingPeriod`, `cliffUnlockAmount`, `totalVestingDuration`, `cliffDurationFromMigrationTime`.
`activationType`	Slot-based or timestamp-based activation.

Nested type	Key fields	Notes
`BaseFeeParams`	Fee scheduler or rate limiter params	Use `getFeeSchedulerParams` for linear or exponential fee decay, or `getRateLimiterParams` for rate-limited fees.
`FeeSchedulerParams`	`startingFeeBps`, `endingFeeBps`, `numberOfPeriod`, `totalDuration`	Used with `FeeSchedulerLinear` or `FeeSchedulerExponential`.
`RateLimiterParams`	`baseFeeBps`, `feeIncrementBps`, `referenceAmount`, `maxLimiterDuration`	Uses quote-token decimals and activation type when converted into program params.
`MigrationFee`	`feePercentage`, `creatorFeePercentage`	Required only when `migrationFeeOption` is `Customizable`.
`MigratedPoolFeeConfig`	`collectFeeMode`, `dynamicFee`, `poolFeeBps`, optional `compoundingFeeBps`, optional graduated fee fields	Applies to the migrated DAMM pool, not to the DBC virtual pool.
`MigratedPoolMarketCapFeeSchedulerParams`	`endingBaseFeeBps`, `numberOfPeriod`, `priceMultiple`, `schedulerExpirationDuration`	Applies when using a DAMM v2 migrated-pool market-cap fee scheduler.
`LiquidityVestingInfoParams`	`vestingPercentage`, `bpsPerPeriod`, `numberOfPeriods`, `cliffDurationFromMigrationTime`, `totalDuration`	Optional migrated-liquidity vesting schedule.
`LockedVestingParams`	`totalLockedVestingAmount`, `numberOfVestingPeriod`, `cliffUnlockAmount`, `totalVestingDuration`, `cliffDurationFromMigrationTime`	Base-token vesting locked during migration.

Common Workflows

Create A Config From A Builder

const configParams = buildCurveWithMarketCap({
  token,
  fee,
  migration,
  liquidityDistribution,
  lockedVesting,
  activationType: ActivationType.Timestamp,
  initialMarketCap,
  migrationMarketCap,
});

const tx = await client.partner.createConfig({
  ...configParams,
  config,
  feeClaimer,
  leftoverReceiver,
  quoteMint,
  payer,
});

Create A Pool From An Existing Config

const tx = await client.creator.createPool({
  baseMint,
  config,
  name,
  symbol,
  uri,
  payer,
  poolCreator,
});

For transfer-hook configs, use client.creator.createPoolWithTransferHook.

Quote And Build A `swap2` Transaction

const quote = client.pool.swapQuote2({
  virtualPool,
  config,
  swapBaseForQuote: false,
  hasReferral: false,
  eligibleForFirstSwapWithMinFee: false,
  currentPoint,
  slippageBps,
  swapMode: SwapMode.ExactIn,
  amountIn,
});

const tx = await client.pool.swap2({
  owner,
  pool,
  swapBaseForQuote: false,
  amountIn,
  minimumAmountOut: quote.minimumAmountOut,
  swapMode: SwapMode.ExactIn,
  referralTokenAccount: null,
});

Integration Notes

Gotcha	Guidance
`swap2` modes	Use `SwapMode.ExactIn`, `PartialFill`, or `ExactOut` and pass the matching amount fields.
Rate limiter pools	The SDK adds the instructions sysvar when the current fee mode requires single-swap validation.
First-swap minimum fee	Set `eligibleForFirstSwapWithMinFee` only when quoting a transaction that satisfies the program’s first-swap validation path.
Token-2022 pools	Use SDK builders so the correct token program, metadata, and ATA handling are included.
Transfer-hook pools	Use `createConfigWithTransferHook`, `createPoolWithTransferHook`, `swap2WithTransferHook`, and transfer-hook fee claim methods. Standard swap and claim paths reject transfer-hook pools.
DAMM v2 compounding	`MigratedCollectFeeMode.Compounding` requires `compoundingFeeBps`; non-compounding modes require it to be zero.
Market-cap scheduler	Market-cap scheduler params use `priceMultiple` in current SDK helpers.

Program

TypeScript SDK

Rust Integration

Go Integration

Dependencies

Program IDs

Core Exports

Enums

Important Constants

Creating A Client

Complete Function Index

Client And Program Helpers

`PartnerService`

`PoolService`

`CreatorService`

`MigrationService`

`StateService`

Curve Builder Helpers

Config, Curve, And Account Helpers

PDA Helpers

Token, Instruction, And Utility Helpers

Validation Helpers

Swap Quote Math

Curve Math

Fee Math

Pool Fee Math

Math Utilities

Core Types

Config Creation Types

Builder Input Groups

Common Workflows

Create A Config From A Builder

Create A Pool From An Existing Config

Quote And Build A `swap2` Transaction

Integration Notes

​Dependencies

​Program IDs

​Core Exports

​Enums

​Important Constants

​Creating A Client

​Complete Function Index

​Client And Program Helpers

​PartnerService

​PoolService

​CreatorService

​MigrationService

​StateService

​Curve Builder Helpers

​Config, Curve, And Account Helpers

​PDA Helpers

​Token, Instruction, And Utility Helpers

​Validation Helpers

​Swap Quote Math

​Curve Math

​Fee Math

​Pool Fee Math

​Math Utilities

​Core Types

​Config Creation Types

​Builder Input Groups

​Common Workflows

​Create A Config From A Builder

​Create A Pool From An Existing Config

​Quote And Build A swap2 Transaction

​Integration Notes

Dependencies

Program IDs

Core Exports

Enums

Important Constants

Creating A Client

Complete Function Index

Client And Program Helpers

`PartnerService`

`PoolService`

`CreatorService`

`MigrationService`

`StateService`

Curve Builder Helpers

Config, Curve, And Account Helpers

PDA Helpers

Token, Instruction, And Utility Helpers

Validation Helpers

Swap Quote Math

Curve Math

Fee Math

Pool Fee Math

Math Utilities

Core Types

Config Creation Types

Builder Input Groups

Common Workflows

Create A Config From A Builder

Create A Pool From An Existing Config

Quote And Build A `swap2` Transaction

Integration Notes