Skip to main content
DBC migration is the handoff from launch trading to long-term Meteora liquidity. During the bonding curve phase, traders buy and sell against a DBC virtual pool. When the quote reserve reaches the configured migration threshold, normal curve trading stops and the pool becomes eligible to create a DAMM pool.
For Token 2022 transfer-hook pools, curve completion also revokes the base mint’s transfer-hook program id and transfer-hook authority. DBC does this before DAMM v2 migration so the graduated mint can use DAMM v2 without relying on transfer-hook remaining accounts.

​
Migration Progress

The program tracks migration as a sequence of states. Some launches move from curve completion directly into the migration-ready state. Others need the locker step first, especially when base-token locked vesting is configured.

​
Migration Targets

New DBC configs and new pools must use DAMM v2. DAMM v1 remains available only for existing pools that were already configured with that target. DAMM v2 is the path for Token 2022 launches, transfer-hook launches, and quote mints that needed a DBC token badge. Transfer-hook launches use DAMM v2. The hook is active only during the DBC bonding-curve phase and is revoked when the curve completes. A DBC token badge is valid only inside DBC. DAMM v2 configs used by DBC include the CreatePoolWithoutMintValidation permission so a quote mint that is not permissionless-supported by DAMM v2 can still migrate. DBC still requires the quote mint transfer fee to be zero at migration time.
DAMM v1 migration is deprecated for new configs and new pools. Existing DAMM v1 pools can still graduate. Token 2022 launches must use DAMM v2.

​
What Migrates

At migration, DBC uses:
  • The configured quote threshold from the bonding phase.
  • The base token amount allocated for the migrated pool.
  • The migration price discovered by the curve.
  • The configured partner and creator liquidity distribution.
The goal is to start the DAMM pool around the price discovered during the launch, rather than forcing teams to choose a separate post-launch price manually.

​
Liquidity Ownership

DBC can split migrated liquidity between partner and creator buckets. Each bucket can include: The full distribution across partner unlocked liquidity, partner permanent locked liquidity, partner vesting liquidity, creator unlocked liquidity, creator permanent locked liquidity, and creator vesting liquidity must add up to 100%.
DBC requires at least 10% of liquidity to remain locked at day 1 after migration. Vesting lock durations are capped at 2 years.

​
DAMM v1 Liquidity

For DAMM v1 migration, liquidity is represented through LP tokens. After the DAMM v1 pool is created, partner and creator LP-token claims can become available according to the configured distribution. If LP tokens need to be locked, the lock step happens after the migrated pool exists. This path is simpler, but it is also less configurable than DAMM v2.

​
DAMM v2 Liquidity

For DAMM v2 migration, DBC creates position NFTs for the migrated liquidity. The migration flow:
  1. Creates the DAMM v2 pool.
  2. Creates migrated liquidity positions.
  3. Applies configured permanent locks or vesting locks.
  4. Transfers position ownership to the partner or creator owner.
This means DAMM v2 migration is not just a pool creation step. It also finalizes who controls the migrated positions and how much of that liquidity is locked.

​
Protocol Liquidity Migration Fee

DBC applies a fixed 0.2% protocol liquidity migration fee during migration. This fee is tracked as protocol migration base and quote amounts. In product terms, it reduces the amount of base and quote liquidity that enters the migrated pool and becomes part of protocol-claimable balances.
This protocol liquidity migration fee is separate from the configurable partner and creator migration fee.

​
Leftover After Migration

For fixed-supply launches, some base tokens may remain in the virtual pool after migration accounting. Those unused tokens are called leftover and can be withdrawn to the configured leftover receiver after the migrated pool reaches the created state. Leftover is covered in more detail in DBC Surplus and Leftover.

​
Mainnet Migration Keepers

Meteora operates migration keepers on mainnet to help eligible DBC pools graduate automatically. Both keepers migrate eligible pools when the bonding curve is complete and the quote-side threshold matches one of these quote mints: Both keepers also migrate Stock Token quote pairs when the threshold is at least 750 USD equivalent in the quote token. Both keepers also migrate a completed pool when the quote token is Jupiter Verified, has a Jupiter Organic Score greater than 50, and the token’s notional value is greater than 750 USD.
Migration keepers run on mainnet. For testing or manual flows, use the manual migrator, which supports mainnet and devnet.