Comptes LaunchLab

Cette page est traduite automatiquement par IA. La version anglaise fait foi.Voir la version anglaise →

Cette page documente le graphe des comptes par lancement : le PoolState (le compte d’état racine pour un lancement), ses deux coffres, l’autorité PDA, et les références post-graduation qu’il acquiert lors du règlement du lancement.Pour la configuration au niveau du protocole qui encadre chaque lancement, consultez products/launchlab/global-config. Pour la surcouche par plateforme, consultez products/launchlab/platform-config. Pour les comptes de vesting (VestingSchedule sur PoolState, VestingRecord par bénéficiaire), consultez products/launchlab/vesting.

Inventaire des comptes

Compte	Propriétaire	Objectif
`GlobalConfig`	Programme LaunchLab	Règles au niveau du protocole : frais, planchers d’approvisionnement, portefeuilles de migration. Un par `(curve_type, index)`.
`PlatformConfig`	Programme LaunchLab	Surcouche par plateforme : branding, frais de plateforme, répartition NFT à la graduation, liste blanche de forme de courbe.
`PoolState`	Programme LaunchLab	État racine par lancement : mints, coffres, paramètres de courbe, compteurs vendus, compteurs de frais, calendrier de vesting, statut de graduation.
`authority`	Programme LaunchLab	PDA unique à la graine `[b"vault_auth_seed"]` qui possède les coffres sur tous les lancements et signe le CPI post-graduation.
`base_vault`	SPL Token / Token-2022	Coffre par lancement contenant les jetons de base non vendus.
`quote_vault`	SPL Token	Coffre par lancement contenant les jetons de cotation accumulés.
`VestingRecord`	Programme LaunchLab	Enregistrement par bénéficiaire de falaise + déverrouillage linéaire. Optionnel.
`creator_fee_vault`	SPL Token	Coffre par créateur + par mint de cotation contenant les frais de créateur accumulés, vidé par `ClaimCreatorFee`.
`platform_fee_vault`	SPL Token	Coffre par plateforme + par mint de cotation contenant les frais de plateforme accumulés, vidé par `ClaimPlatformFeeFromVault`.
`PlatformAllowConfig`	Programme LaunchLab	Permission gérée par la plateforme optionnelle pour une paire `(PlatformConfig, GlobalConfig)`. Vérifiée uniquement lorsque la plateforme active la restriction.
(post-graduation) `cpmm_pool_state`	Programme CPMM	Pool créé par `MigrateToCpswap` pour chaque nouveau lancement. L’état hérité peut toujours référencer une graduation AMM v4.
(post-graduation) Fee Key NFT	Programme LP-Lock	Avant la mise à jour du 2026-08-17, les échelles de plateforme et de créateur pouvaient produire des Fee Keys séparées. Les migrations exécutées après combinent les deux échelles en une seule Fee Key de plateforme.

La méthode raydium.launchpad.getLaunchById du SDK retourne PoolState plus un drapeau indiquant si le lancement a été diplômé ; si c’est le cas, l’ID du pool post-migration est inclus.

`PoolState`

L’état racine par lancement. Les noms de champs ci-dessous correspondent à la structure Rust on-chain (states/pool.rs) ; certaines valeurs sont simplifiées pour la lisibilité — consultez la source pour la disposition exacte de la mémoire.

// states/pool.rs (abridged)
pub struct PoolState {
    pub epoch:                     u64,        // recent_epoch tracker
    pub auth_bump:                 u8,
    pub status:                    u8,         // PoolStatus enum
    pub base_decimals:             u8,
    pub quote_decimals:            u8,
    pub migrate_type:              u8,         // 0 = AMM v4, 1 = CPMM
    pub supply:                    u64,        // total base tokens (no decimals)
    pub total_base_sell:           u64,        // base supply allocated to the curve
    pub virtual_base:              u64,        // virtual-reserve seed
    pub virtual_quote:             u64,        // virtual-reserve seed
    pub real_base:                 u64,        // base sold so far
    pub real_quote:                u64,        // quote raised so far (excl. fees)
    pub total_quote_fund_raising:  u64,        // graduation threshold in quote

    pub quote_protocol_fee:        u64,        // accrued, pending CollectFee
    pub platform_fee:              u64,        // accrued, pending ClaimPlatformFee
    pub migrate_fee:               u64,        // accrued, pending CollectMigrateFee
    pub vesting_schedule:          VestingSchedule,

    pub global_config:             Pubkey,
    pub platform_config:           Pubkey,
    pub creator:                   Pubkey,
    pub base_mint:                 Pubkey,
    pub quote_mint:                Pubkey,
    pub base_vault:                Pubkey,
    pub quote_vault:               Pubkey,

    pub amm_creator_fee_on:        u8,         // 0 = QuoteToken, 1 = BothToken (CPMM-only)
    pub token_program_flag:        u8,         // bit flags for SPL Token vs Token-2022
    pub padding:                   [u8; 54],
}

#[derive(Default, Debug, Clone)]
pub struct VestingSchedule {
    pub total_locked_amount:    u64,
    pub cliff_period:           u64,
    pub unlock_period:          u64,
    pub start_time:             u64,           // set at graduation
    pub allocated_share_amount: u64,           // running sum across VestingRecords
}

Valeurs de PoolStatus (depuis l’IDL Anchor) :

= Funding         — accepte les achats / ventes ; en dessous de quote_reserve_target
= Migrate         — quote_reserve_target atteint ; en attente de MigrateTo*
= Migrated        — MigrateTo* déjà exécuté ; horloge de vesting en cours

Champs visibles pour les intégrateurs :

status — trois valeurs, monotones (Funding → Migrate → Migrated). Les lectures sont toujours sûres ; les écritures sont contrôlées.
real_base, real_quote — état actuel de la courbe. Combinés avec virtual_base / virtual_quote, ils suffisent pour calculer le prix au comptant sans toucher aux coffres. Consultez bonding-curve.
total_base_sell vs real_base — ratio « progression vers la graduation » pour les interfaces utilisateur.
migrate_type — l’initialisation nouvelle nécessite 1 (CPSWAP). Un 0 stocké reste significatif uniquement pour un lancement existant créé avant l’application obligatoire de CPMM.
amm_creator_fee_on — choisit creator_fee_on = OnlyQuoteToken (0) ou BothToken (1) sur le pool CPMM post-graduation. Il ne choisit pas la cible de migration. Consultez creator-fees.
quote_protocol_fee / platform_fee / migrate_fee — trois compteurs de frais indépendants. Chacun a sa propre instruction de réclamation ; consultez instructions.
vesting_schedule — présent sur chaque PoolState mais inactif lorsque total_locked_amount == 0. Consultez vesting pour le cycle de vie complet.

L’autorité PDA

LaunchLab utilise une seule autorité PDA sur tous les lancements, dérivée sans graine par lancement :

const LAUNCHLAB_PROGRAM_ID = new PublicKey("<LAUNCHLAB_ID>"); // see reference/program-addresses

const [authority, bump] = PublicKey.findProgramAddressSync(
  [Buffer.from("vault_auth_seed")],
  LAUNCHLAB_PROGRAM_ID,
);

Ce PDA unique est :

L’autorité sur chaque base_vault et quote_vault du lancement.
La mint_authority sur chaque base_mint du lancement (pré-graduation).
Le signataire sur le CPI de graduation CPMM, et sur la graduation AMM v4 hérité pour l’état existant.
Le signataire sur les transferts ClaimVestedToken hors du coffre de base.

La mint_authority est révoquée immédiatement après un appel MigrateToCpswap ou un appel MigrateToAmm hérité, de sorte que l’approvisionnement est définitivement fixé. Deux PDAs supplémentaires contrôlent les coffres de frais :

const [creatorFeeVaultAuthority] = PublicKey.findProgramAddressSync(
  [Buffer.from("creator_fee_vault_auth_seed")],
  LAUNCHLAB_PROGRAM_ID,
);

const [platformFeeVaultAuthority] = PublicKey.findProgramAddressSync(
  [Buffer.from("platform_fee_vault_auth_seed")],
  LAUNCHLAB_PROGRAM_ID,
);

Ceux-ci signent le transfert hors des coffres de frais correspondants lors de ClaimCreatorFee et ClaimPlatformFeeFromVault.

Mint de base

Créé en ligne par Initialize avec :

mint_authority = authority (révoquée à la graduation).
freeze_authority = None.
supply = supply, entièrement frappé dans base_vault.
decimals choisi par le créateur à Initialize (généralement 6).

Comme l’approvisionnement complet est pré-frappé, base_mint.supply est constant pendant la durée de vie du lancement. Les achats de courbe déplacent les jetons de base_vault vers l’acheteur, mais n’appellent pas mint_to. Initialize / InitializeV2 créent des lancements SPL Token. L’instruction dédiée InitializeWithToken2022 permet au mint de base d’être un mint Token-2022 (avec TransferFeeConfig optionnel) ; le mint de cotation reste SPL Token. Les trois chemins d’initialisation nécessitent une graduation CPMM.

Coffres

base_vault et quote_vault sont tous deux des comptes SPL Token standard possédés par le PDA LaunchLab authority. Les adresses sont stockées sur PoolState et peuvent également être dérivées :

const [baseVault] = PublicKey.findProgramAddressSync(
  [Buffer.from("pool_vault"), poolState.toBuffer(), baseMint.toBuffer()],
  LAUNCHLAB_PROGRAM_ID,
);
const [quoteVault] = PublicKey.findProgramAddressSync(
  [Buffer.from("pool_vault"), poolState.toBuffer(), quoteMint.toBuffer()],
  LAUNCHLAB_PROGRAM_ID,
);

(Vérifiez les préfixes de graine exacts à partir de la structure des comptes Initialize de la source avant de vous fier à une dérivation en production.)

Coffres de frais

Deux PDAs agrègent les frais sur les lancements :

Coffre de frais de créateur — PDA aux graines [creator, quote_mint]. Chaque lancement qui gagne les mêmes frais de créateur sur le même mint de cotation verse dans le même coffre. Le créateur le vide via ClaimCreatorFee.
Coffre de frais de plateforme — PDA aux graines [platform_config, quote_mint]. Chaque lancement acheminé via la même plateforme qui utilise le même mint de cotation verse dans le même coffre. Le platform_fee_wallet de la plateforme le vide via ClaimPlatformFeeFromVault. Il existe également une variante de balayage par lancement (ClaimPlatformFee) qui tire directement du quote_vault du lancement sans passer par le coffre agrégé.

Le modèle de coffre agrégé permet à un créateur ou une plateforme à haut volume d’amortir le coût du loyer de l’accumulation de frais sur de nombreux lancements.

Quote vault ↔ `real_quote`

quote_vault.balance et PoolState.real_quote doivent rester synchronisés. Ils peuvent dériver d’au maximum la somme des trois compteurs de frais en attente (quote_protocol_fee, platform_fee, migrate_fee), qui se trouvent dans le coffre mais appartiennent aux compteurs de frais et non à la réserve de courbe. Les mathématiques de courbe utilisent toujours real_quote, jamais le solde brut du coffre. Invariant pré-graduation :

quote_vault.balance ==
   real_quote
 + quote_protocol_fee
 + platform_fee
 + migrate_fee

Transitions de compte du cycle de vie

Événement	Statut	`real_base`	`real_quote`	Pool post-graduation
`Initialize`	Funding	0	0	—
`BuyExactIn` / `BuyExactOut`	Funding	`+base_out`	`+quote_in_after_fee`	—
`SellExactIn` / `SellExactOut`	Funding	`−base_in`	`−quote_out_before_fee`	—
`MigrateToCpswap` (ou `MigrateToAmm` hérité)	Funding → Migrate → Migrated	(gelé)	(gelé)	créé ; LP CPMM est divisé en LP verrouillé détenu par la plateforme et LP brûlé
`ClaimCreatorFee` / `ClaimPlatformFee*`	any	—	—	vide un coffre de frais
`CreateVestingAccount`	Funding	—	—	augmente `vesting_schedule.allocated_share_amount`
`ClaimVestedToken`	Migrated only	—	—	vide `base_vault`

Où aller ensuite

products/launchlab/bonding-curve — les mathématiques derrière real_base ↔ real_quote.
products/launchlab/instructions — listes de comptes par instruction.
products/launchlab/global-config — liaison au niveau du protocole.
products/launchlab/platform-config — surcouche de plateforme.
products/launchlab/vesting — mécaniques d’approvisionnement verrouillé.
products/cpmm/accounts — à quoi ressemble le cpmm_pool_state post-graduation.

Sources :

raydium-launch/programs/launchpad/src/states/pool.rs — PoolState, PoolStatus, VestingSchedule, AmmCreatorFeeOn.
raydium-launch/programs/launchpad/src/lib.rs — constantes de graine PDA (AUTH_SEED, CREATOR_FEE_VAULT_AUTH_SEED, PLATFORM_FEE_VAULT_AUTH_SEED).
Module launchpad du SDK Raydium v2.

LaunchLab

Flux de lancement de token

Tips & Gotchas

Inventaire des comptes

`PoolState`

L’autorité PDA

Mint de base

Coffres

Coffres de frais

Quote vault ↔ `real_quote`

Transitions de compte du cycle de vie

Où aller ensuite

​Inventaire des comptes

​PoolState

​L’autorité PDA

​Mint de base

​Coffres

​Coffres de frais

​Quote vault ↔ real_quote

​Transitions de compte du cycle de vie

​Où aller ensuite

Inventaire des comptes

`PoolState`

L’autorité PDA

Mint de base

Coffres

Coffres de frais

Quote vault ↔ `real_quote`

Transitions de compte du cycle de vie

Où aller ensuite