| name | solana-cpmm-migration |
| description | Configure and verify doppler-sol initializer migrations into CPMM pools, including migrator payloads, state PDAs, migrated pool hook config, recipient distribution, and remaining-account order. |
| license | MIT |
| metadata | {"author":"doppler","version":"1.0"} |
Consumer Source of Truth: Use the published @whetstone-research/doppler-sdk Solana helpers and generated IDLs for addresses, payloads, and account decoding.
Solana CPMM Migration
When to use
- You are integrating a Solana launch that migrates into a CPMM pool.
- You need to build or decode CPMM migrator payloads from a client.
- You are debugging launch vault handoff, recipient distribution, or CPMM pool initialization from transaction/account state.
Mental model
The CPMM migrator is an external program invoked by the Initializer. It registers per-launch migration parameters during launch initialization, then consumes launch vault balances during migration and creates the destination CPMM pool.
Core workflow
- Derive the
CpmmMigratorState PDA with SDK helpers from the launch address.
- Encode
register_launch payload with SDK or IDL builders and pass it as initializer migrator_init_payload.
- Encode
migrate payload with SDK or IDL builders and store it as initializer migrator_migrate_payload.
- Include CPMM migrator accounts as remaining accounts to
initialize_launch and migrate_launch.
- At migration, verify min raise, optional price floor, token partitions, recipient accounts, and CPMM pool creation.
Quick facts
| Item | Detail |
|---|
| Program | CPMM migrator |
| Migrator state PDA | [b"state", launch] |
| Migration authority PDA | [b"migration_authority"] |
| Init instruction | register_launch |
| Migration instruction | migrate |
| Recipient capacity | 2 recipients |
| Destination | CPMM pool and position |
Failure modes
- Register and migrate payloads disagree on launch supply partitions.
- Recipient ATAs are missing, out of order, or extra.
base_for_liquidity or base_for_distribution does not match launch state.- Minimum quote raise or migration price floor is not met.
- CPMM pool mints are passed in non-canonical order.
- Remaining accounts omit CPMM, token, ATA, protocol fee, hook, or recipient accounts required by the migrator path.
References
Related skills
