Token Migration

When a token's circulating supply reaches its dexSupplyThresh, it graduates off the bonding curve and its liquidity is migrated to a DEX. The event LaunchedToDEX is emitted to indicate that the token has graduated.

/// @notice emitted when adding liquidity to DEX
/// @param token The address of the token
/// @param pool The address of the pool
/// @param amount The amount of token added
/// @param eth The amount of quote Token added
event LaunchedToDEX(address token, address pool, uint256 amount, uint256 eth);

LaunchedToDEX tells you that the token graduated and gives you liquidity amounts, but it does not tell you which DEX it graduated to — and for two of the four migrator types, pool is not even the final pool address. See the two caveats below.

Knowing which DEX a token will graduate to, ahead of time

You don't need to wait for LaunchedToDEX to know the destination. The destination is decided at launch time and is fully determined by two events emitted in the token-creation transaction:

• TokenDexPreferenceSet.dexId — which DEX protocol (chain-specific mapping).
• TokenMigratorSet.migratorType — which pool version/shape on that DEX (V2, V3, or one of the CL-style migrators).

See Index Token Created Events § TokenDexPreferenceSet for the full dexId-to-DEX table per chain and the dexId + migratorType → destination mapping, with a worked example for Robinhood Chain.

Caveat: pool is not always the real pool address

LaunchedToDEX.pool behaves differently depending on migratorType:

For the two CL-style migrators (V4_UNI_MIGRATOR, PCS_INFINITY_CL_MIGRATOR), read FlapTokenCLPoolCreated.poolId instead — that's the real pool identifier to index:

/// @notice emitted when a new CL pool is created for a token
/// @param token The address of the token
/// @param poolId The ID of the created CL pool
/// @param sqrtPriceX96 The initial sqrt price used to initialize the CL pool
event FlapTokenCLPoolCreated(address token, bytes32 poolId, uint160 sqrtPriceX96);

See Trade Tokens § LaunchedToDEX for more detail on these events.