DBC Developer Guide - Meteora Documentation

Dynamic Bonding Curve (DBC) is Meteora’s token launch primitive for creating a virtual reserve pool, trading through a configured bonding curve, and migrating finished pools to DAMM v2. Existing DAMM v1 pools can still graduate. To learn more about fee behavior, migration design, and formulas, you can read the following documentations.

Learn more about DBC

Overview of DBC, universal curves, launch configurations, fees, surplus, leftover tokens, and migration.

DBC Formulas

Formulas for price, curve progress, reserves, fees, and migration calculations.

Integration

Program Accounts

Account model for pool configs, virtual pools, vaults, metadata, token badges, operators, and migration accounts.

Program Instructions

Instruction families for partners, creators, swaps, migration, fee claims, and operators.

Program Events

Event-CPI payloads for configs, pools, swaps, fee claims, migration, and operator flows.

Program Errors

Anchor custom errors, messages, and common integration causes.

TypeScript SDK

Official TypeScript SDK for config builders, pool creation, quotes, swaps, migration, and state reads.

Transfer Hook SDK

TypeScript SDK methods for Token 2022 transfer-hook configs, pools, swaps, claims, and state reads.

Rust Integration

Rust quote helpers and program-side integration notes for dynamic_bonding_curve.

Go Integration

Go examples for pool reads, swaps, fee claims, and creator transfer flows.

Program IDs

The dynamic_bonding_curve program ID is the same on mainnet and devnet:

Network	Program ID
Mainnet Beta	`dbcij3LWUppWqq96dh6gJWwBifmcGfLSB5D4DuSMaqN`
Devnet	`dbcij3LWUppWqq96dh6gJWwBifmcGfLSB5D4DuSMaqN`

The pool authority PDA used by the program is:

Authority	Address
Pool Authority	`FhVo3mqL8PW5pH5U2CN4XE33DokiyZnUwuGpH2hmHLuM`

DBC Program

Anchor program source for dynamic_bonding_curve.

DBC IDL

Published Anchor IDL used by the TypeScript SDK.

TypeScript SDK

Public SDK for transaction builders, state reads, quotes, curve helpers, PDA helpers, and tests.

Go Examples

Go examples for backend reads, swaps, fee claims, and creator transfer flows.

Migration Keepers

Meteora runs migration keepers on mainnet to migrate eligible DBC pools when the bonding curve is complete and the pool has enough quote-side liquidity.

Keeper
`Asi5DTGEeiso6k7ya6ndDabEZ7DRCgfTpCBLPH5E3aQs`
`DeQ8dPv6ReZNQ45NfiWwS5CchWpB2BVq1QMyNV8L2uSW`

Both keepers migrate when pool_config.migration_quote_threshold matches one of these quote mints:

Quote token	Mint	`migration_quote_threshold`
Wrapped SOL (SOL)	`So11111111111111111111111111111111111111112`	10 SOL
USD Coin (USDC)	`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`	750 USDC
OFFICIAL TRUMP (TRUMP)	`6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN`	100 TRUMP
Jupiter (JUP)	`JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN`	1500 JUP
World Liberty Financial USD (USD1)	`USD1ttGY1N17NEEHLmELoaybftRBUSErhqYiQzvEmuB`	750 USD1
Meteora (MET)	`METvsvVRapdj9cFLzq4Tr43xK4tAjQfwX76z3n6mWQL`	1500 MET
Jupiter USD (JupUSD)	`JuprjznTrTSp2UFa3ZBUFgwdAmtZCq4MQCwysN55USD`	750 JupUSD
Virtual Protocol (VIRTUAL)	`3iQL8BFS2vE7mww4ehAqQHAsbmRNCrPxizWAT2Zfyr9y`	42000 VIRTUAL

Both keepers also migrate Stock Token quote pairs when pool_config.migration_quote_threshold is at least 750 USD equivalent in the quote token.

Migration keepers run on mainnet. The Manual Migrator supports both mainnet and devnet.

DAMM Fee Config Keys

The SDK exposes these arrays as DAMM_V1_MIGRATION_FEE_ADDRESS and DAMM_V2_MIGRATION_FEE_ADDRESS.

DAMM v1 migration and rate limiter mode are deprecated for new configs and new pools. Use DAMM v2 and a scheduler or fixed-fee base fee for new launches. The DAMM v1 config keys below remain for existing pools.

DAMM v1

Option	Fee	Config key
`0`	25 bps	`8f848CEy8eY6PhJ3VcemtBDzPPSD4Vq7aJczLZ3o8MmX`
`1`	30 bps	`HBxB8Lf14Yj8pqeJ8C4qDb5ryHL7xwpuykz31BLNYr7S`
`2`	100 bps	`7v5vBdUQHTNeqk1HnduiXcgbvCyVEZ612HLmYkQoAkik`
`3`	200 bps	`EkvP7d5yKxovj884d2DwmBQbrHUWRLGK6bympzrkXGja`
`4`	400 bps	`9EZYAJrcqNWNQzP2trzZesP7XKMHA1jEomHzbRsdX8R2`
`5`	600 bps	`8cdKo87jZU2R12KY1BUjjRPwyjgdNjLGqSGQyrDshhud`

DAMM v2

Option	Fee	Config key
`0`	25 bps	`7F6dnUcRuyM2TwR8myT1dYypFXpPSxqwKNSFNkxyNESd`
`1`	30 bps	`2nHK1kju6XjphBLbNxpM5XRGFj7p9U8vvNzyZiha1z6k`
`2`	100 bps	`Hv8Lmzmnju6m7kcokVKvwqz7QPmdX9XfKjJsXz8RXcjp`
`3`	200 bps	`2c4cYd4reUYVRAB9kUUkrq55VPyy2FNQ3FDL4o12JXmq`
`4`	400 bps	`AkmQWebAwFvWk55wBoCr5D62C6VVDTzi84NJuD9H7cFD`
`5`	600 bps	`DbCRBj8McvPYHJG1ukj8RE15h2dCNUdTAESG49XpQ44u`
`6`	Customizable	`A8gMrEPJkacWkcb3DGwtJwTe16HktSEfvwtuDh2MCtck`

Commands

Task	Command
Build TypeScript SDK	`cd packages/dynamic-bonding-curve && pnpm install && pnpm run build`
Run TypeScript SDK tests	`cd packages/dynamic-bonding-curve && pnpm test`
Run TypeScript type checks	`cd packages/dynamic-bonding-curve && pnpm run check-types`
Run Rust quote tests	`cd dynamic-bonding-curve && cargo test -p dynamic-bonding-curve-sdk`
Run Go examples	`go run examples/<file-name>.go`
Run program tests	`anchor test` from the `dynamic-bonding-curve` repository

Some SDK tests depend on local validator fixtures and deployed program artifacts. For production integrations, simulate transactions and test on devnet before sending mainnet transactions.

Stay Updated

DBC Changelog

Program, IDL, SDK, quote, migration, and validation changes for integration planning.

Learn more about DBC

DBC Formulas

​Integration

Program Accounts

Program Instructions

Program Events

Program Errors

TypeScript SDK

Transfer Hook SDK

Rust Integration

Go Integration

​Program IDs

DBC Program

DBC IDL

TypeScript SDK

Go Examples

​Migration Keepers

​DAMM Fee Config Keys

​DAMM v1

​DAMM v2

​Commands

​Stay Updated

DBC Changelog

Integration

Program IDs

Migration Keepers

DAMM Fee Config Keys

DAMM v1

DAMM v2

Commands

Stay Updated