LaunchLab GlobalConfig

GlobalConfig is the protocol-level configuration account. There can be many of them — keyed by (curve_type, index) — and every launch picks exactly one at Initialize time. The values on the chosen GlobalConfig then become hard limits for that launch’s parameters. For platform-level customization (per-platform fee rate, allowed curve shapes, NFT splits at graduation), see products/launchlab/platform-config.

What it is

A GlobalConfig is a singleton-per-(curve_type, index) PDA that fixes the protocol-side rules every launch must obey:

The kind of bonding curve allowed (curve_type).
The trade fee rate the curve charges on every buy and sell.
The migration fee charged at graduation.
Floors on supply, lock rate, sell rate, and migrate rate.
The quote mint (typically wrapped SOL or USDC) — the asset users buy with.
Three protocol-side wallets: the protocol-fee owner, the migrate-fee owner, and the two migration-control wallets that authorize graduation to AMM v4 / CPMM.
An optional flag (requires_platform_auth) that gates which platforms may use this config.

GlobalConfig accounts are created and updated by the LaunchLab program admin (the hardcoded admin pubkey shared across Anchor-based Raydium programs — see reference/program-addresses).

Layout

// states/config.rs
pub const GLOBAL_CONFIG_SEED: &str = "global_config";

#[account]
pub struct GlobalConfig {
    pub epoch:                   u64,         // recent_epoch tracker
    pub curve_type:              u8,          // 0 = ConstantProduct, 1 = FixedPrice, 2 = LinearPrice
    pub index:                   u16,         // discriminator within a curve_type
    pub migrate_fee:             u64,         // SOL paid on graduation
    pub trade_fee_rate:          u64,         // 1/1_000_000 of volume
    pub max_share_fee_rate:      u64,         // 100 bps cap on platform share fee
    pub min_base_supply:         u64,         // floor on Initialize supply (no decimals)
    pub max_lock_rate:           u64,         // ceiling on vesting locked / supply
    pub min_base_sell_rate:      u64,         // floor on base_supply_graduation / supply
    pub min_base_migrate_rate:   u64,         // floor on tokens that seed the post-graduation pool
    pub min_quote_fund_raising:  u64,         // floor on quote_reserve_target (with decimals)
    pub quote_mint:              Pubkey,
    pub protocol_fee_owner:      Pubkey,      // claims protocol fees via CollectFee
    pub migrate_fee_owner:       Pubkey,      // claims migration fees via CollectMigrateFee
    pub migrate_to_amm_wallet:   Pubkey,      // can sign MigrateToAmm
    pub migrate_to_cpswap_wallet:Pubkey,      // can sign MigrateToCpswap
    pub requires_platform_auth:  u8,          // 0/1 flag
    pub padding_alignment:       [u8; 7],
    pub padding:                 [u64; 15],
}

PDA derivation:

const [globalConfig] = PublicKey.findProgramAddressSync(
  [
    Buffer.from("global_config"),
    Buffer.from(quoteMint.toBytes()),
    Buffer.from([curveType]),
    u16ToBytes(index),
  ],
  LAUNCHLAB_PROGRAM_ID,
);

(Verify the exact seed order from the on-chain account before signing — the program’s create_config instruction is the source of truth.)

Field semantics

`curve_type` and `index`

Together these key a GlobalConfig uniquely. There is one GlobalConfig per (curve_type, index) pair:

curve_type = 0 — Constant-product virtual-reserve curve. Default and most-used.
curve_type = 1 — Fixed-price curve.
curve_type = 2 — Linear-price curve.

index is a u16 that lets the admin publish multiple configurations per curve type (e.g., one with a tighter fee, one with a higher minimum quote raise). At Initialize the launch supplies a (curve_type, index) pair and the program loads the matching GlobalConfig.

Fees

trade_fee_rate — denominated in 1/1_000_000 of trade volume. Applied to every buy and sell on the curve. The protocol_fee_owner claims its share via CollectFee.
migrate_fee — a flat fee in lamports (or quote units, depending on configuration) charged once at graduation. Claimed by migrate_fee_owner via CollectMigrateFee.
max_share_fee_rate — initialized to 10_000 (100 bps). Caps the platform’s share fee rate from the binding PlatformConfig (see platform-config). The program enforces trade_fee_rate + max_share_fee_rate < RATE_DENOMINATOR_VALUE.

Supply and rate floors

These floors bound what curve-shape parameters a launch can pick at Initialize. If the creator’s CurveParams violate any of them, Initialize reverts with InvalidInput.

min_base_supply — the minimum supply (no decimals) the curve can declare. Defaults to 10_000_000.
max_lock_rate — denominated in 1/1_000_000; default 300_000 (30%). Bounds vesting via total_locked_amount <= supply * max_lock_rate / 1_000_000.
min_base_sell_rate — denominated in 1/1_000_000; default 200_000 (20%). Bounds base_supply_graduation / supply from below.
min_base_migrate_rate — denominated in 1/1_000_000; default 200_000 (20%). Bounds the number of tokens left over to seed the post-graduation pool.
min_quote_fund_raising — minimum quote_reserve_target a launch may declare (with decimals). Defaults to 30_000_000_000 units of the quote mint.

Quote mint and protocol wallets

quote_mint — the asset users buy with. Most launches use wrapped SOL (So111…112) or USDC (EPjF…Dt1v). One GlobalConfig is bound to one quote mint; launches that need a different quote target a different (curve_type, index).
protocol_fee_owner — pubkey that signs CollectFee and claims the accrued protocol fees on every launch bound to this config. Stored on-chain; admin can rotate it via UpdateConfig.
migrate_fee_owner — pubkey that signs CollectMigrateFee.

Migration wallets

The two graduation paths require different signers:

migrate_to_amm_wallet — must sign MigrateToAmm. Used for launches whose migrate_type = 0 (graduate to AMM v4 + OpenBook).
migrate_to_cpswap_wallet — must sign MigrateToCpswap. Used for migrate_type = 1 (graduate to CPMM). Token-2022 launches always take this path.

These are typically held by the Raydium-operated graduation crank, so graduation lands shortly after the curve hits the threshold rather than waiting for the creator to call it.

`requires_platform_auth`

A u8 flag (0 = anyone may use this config; non-zero = only platforms with a valid PlatformGlobalAccess PDA may launch against it). When set, every Initialize against this GlobalConfig must include a matching PlatformGlobalAccess account proving the platform has been pre-authorized via CreatePlatformGlobalAccess (an admin-only instruction). See platform-config for the platform-side mechanics.

Defaults at initialization

When CreateConfig is called, the program seeds many fields with hardcoded defaults:

self.max_share_fee_rate     = 10_000;                  // 100 bps
self.min_base_supply        = 10_000_000;              // no decimals
self.max_lock_rate          = 300_000;                 // 30%
self.min_base_migrate_rate  = 200_000;                 // 20%
self.min_base_sell_rate     = 200_000;                 // 20%
self.min_quote_fund_raising = 30_000_000_000;
self.requires_platform_auth = 0;

The admin sets curve_type, index, migrate_fee, trade_fee_rate, quote_mint, and the four wallet pubkeys explicitly at create time; subsequent values can be tuned via UpdateConfig.

How a launch picks a `GlobalConfig`

At Initialize, the creator passes:

(curve_type, index) to select which GlobalConfig PDA to load.
CurveParams describing the curve shape (supply, total_base_sell, total_quote_fund_raising, migrate_type).
VestingParams describing locked supply.
MintParams for the base mint.

The program enforces:

curve_type matches global_config.curve_type.
supply >= global_config.min_base_supply.
total_locked_amount <= supply * max_lock_rate / 1_000_000.
total_base_sell >= supply * min_base_sell_rate / 1_000_000.
(supply − total_base_sell − total_locked_amount) >= supply * min_base_migrate_rate / 1_000_000 — i.e., enough tokens left over to seed the post-graduation pool.
total_quote_fund_raising >= min_quote_fund_raising.
If requires_platform_auth != 0, a valid PlatformGlobalAccess PDA is included.

After Initialize, the launch’s PoolState stores the global_config pubkey directly, so the binding is permanent.

Update path

UpdateConfig is admin-only and takes a (param: u8, value: u64) pair. Each param value selects which field to mutate:

`param`	Field changed
0	`migrate_fee`
1	`trade_fee_rate`
2	`max_share_fee_rate`
3	`min_base_supply`
4	`max_lock_rate`
5	`min_base_sell_rate`
6	`min_base_migrate_rate`
7	`min_quote_fund_raising`

Wallet rotations (protocol_fee_owner, migrate_fee_owner, migrate_to_amm_wallet, migrate_to_cpswap_wallet) take a separate Pubkey argument shape; check the update_config source for the exact dispatch table before composing an admin transaction. requires_platform_auth is toggled via set_requires_platform_auth(bool).

Reading a `GlobalConfig` from a client

import { Raydium } from "@raydium-io/raydium-sdk-v2";

// Fetch by PDA derivation:
const [configPda] = PublicKey.findProgramAddressSync(
  [
    Buffer.from("global_config"),
    quoteMint.toBytes(),
    Buffer.from([curveType]),
    u16ToBytes(index),
  ],
  LAUNCHLAB_PROGRAM_ID,
);

const config = await raydium.launchpad.getGlobalConfig(configPda);
console.log(config.tradeFeeRate, config.minQuoteFundRaising);

For a UI listing all available configs, walk the SDK’s getAllGlobalConfigs helper or query the LaunchLab API endpoint that mirrors them; the on-chain account count is small (single digits in practice).

Pointers

products/launchlab/platform-config — per-platform overlay that constrains curve shape further.
products/launchlab/accounts — full account graph for a launch.
products/launchlab/instructions — Initialize and update instructions.
reference/program-addresses — admin pubkey, program ID, shared authorities.

Sources:

raydium-launch/programs/launchpad/src/states/config.rs — GlobalConfig struct and initialize.
raydium-launch/programs/launchpad/src/lib.rs — create_config, update_config.

LaunchLab

Token launch flow

Tips & Gotchas

What it is

Layout

Field semantics

`curve_type` and `index`

Fees

Supply and rate floors

Quote mint and protocol wallets

Migration wallets

`requires_platform_auth`

Defaults at initialization

How a launch picks a `GlobalConfig`

Update path

Reading a `GlobalConfig` from a client

Pointers

LaunchLab

Token launch flow

Tips & Gotchas

Documentation Index

​What it is

​Layout

​Field semantics

​curve_type and index

​Fees

​Supply and rate floors

​Quote mint and protocol wallets

​Migration wallets

​requires_platform_auth

​Defaults at initialization

​How a launch picks a GlobalConfig

​Update path

​Reading a GlobalConfig from a client

​Pointers

What it is

Layout

Field semantics

`curve_type` and `index`

Fees

Supply and rate floors

Quote mint and protocol wallets

Migration wallets

`requires_platform_auth`

Defaults at initialization

How a launch picks a `GlobalConfig`

Update path

Reading a `GlobalConfig` from a client

Pointers