| name | solana-launch-initializer |
| description | Canonical reference for doppler-sol launch creation, bonding-curve trading, hook configuration, cosigner-gated launch payloads, migration handoff, authorized no-migrator launches, launch fee state, and initializer PDA semantics. |
| 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 launch addresses, instructions, and account decoding.
Solana Launch Initializer
When to use
- You are creating, inspecting, or supporting a Solana Doppler launch.
- You need the Solana equivalent of the Airlock launch lifecycle.
- You need launch PDA lookup, launch phases, curve swap behavior, cosigner hook gating, or authorized no-migrator semantics.
Mental model
The Initializer is the Solana launch entrypoint. It creates the base mint, launch vaults, launch state, launch fee state, optional hook configuration, and optional migrator configuration.
Do not map it one-to-one to EVM Airlock modules. Solana uses one initializer program with external CPI hooks and migrators.
Core workflow
- Create or fetch the global
InitConfig address with SDK helpers.
- Ensure intended migrator and hook programs are allowlisted, unless using
Pubkey::default() for none.
- Derive launch, launch authority, and launch fee state addresses from
(namespace, launch_id) with SDK helpers.
- Call
initialize_launch with base supply partitions, curve parameters, trading flags, hook config, payload commitment hashes, fee beneficiaries, and migrator config.
- Trade through
curve_swap_exact_in or preview with preview_swap_exact_in.
- If a migrator is configured, call
migrate_launch after conditions are met.
- If no migrator is configured, confirm the launch has an authority and treat the initializer curve as the terminal venue.
Quick facts
| Item | Detail |
|---|
| Program | Initializer |
| Config PDA | [b"config"] |
| Launch PDA | [b"launch", namespace, launch_id] |
| Launch authority PDA | [b"launch_authority", launch] |
| Launch fee state PDA | [b"launch_fee_state", launch] |
| Trading phase | PHASE_TRADING = 0 |
| Migrated phase | PHASE_MIGRATED = 1 |
| Abort phase | PHASE_ABORTED = 2 |
| Buy direction | TRADE_DIRECTION_BUY = 0 |
| Sell direction | TRADE_DIRECTION_SELL = 1 |
| Supported curve | XYK with virtual reserves |
| Payload buffer | PayloadBuf, max 256 bytes |
| Empty cosigner hook payload | signature-required gate until migration |
| Expiring cosigner hook payload | 42 bytes; version, expiry mode, expiry value, cosigner hint |
Failure modes
- Looking up a launch by asset mint instead of
(namespace, launch_id).
- Treating
Pubkey::default() as an allowlisted real program instead of the "none" hook/migrator marker.
- Forgetting reserved base: curve trading excludes
base_for_distribution + base_for_liquidity.
- Passing migrator payloads or nonzero
base_for_liquidity for a no-migrator launch.
- Passing nonzero hook or migrator remaining-account commitment hashes when the corresponding path is disabled.
- Using an expiring cosigner hook payload without committing the matching
[namespace, cosigner_config, cosigner] remaining-account hash.
- Creating a permissionless launch without a migrator; permissionless launches require a migrator and non-empty migrate payload.
- Assuming no-migrator is the same as EVM
NoOpMigrator; it is different by design.
- Omitting hook or migrator remaining accounts required by the configured external program.
References
Related skills
