Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

Esta página fue traducida automáticamente por IA. La versión en inglés es la fuente autorizada.Ver versión en inglés →
Esta página documenta el gráfico de cuentas por lanzamiento: la PoolState (la cuenta de estado raíz de un lanzamiento), sus dos vaults, el PDA de autoridad, y las referencias posteriores a la graduación que adquiere cuando el lanzamiento se liquida.Para la configuración a nivel de protocolo que limita cada lanzamiento, consulta products/launchlab/global-config. Para la superposición por plataforma, consulta products/launchlab/platform-config. Para cuentas de vesting (VestingSchedule en PoolState, VestingRecord por beneficiario), consulta products/launchlab/vesting.

​
Inventario de cuentas

CuentaPropietarioPropósito
GlobalConfigPrograma LaunchLabReglas a nivel de protocolo: comisiones, pisos de suministro, billeteras de migración. Una por (curve_type, index).
PlatformConfigPrograma LaunchLabSuperposición por plataforma: marca, comisión de plataforma, división de NFT en la graduación, lista blanca de formas de curva.
PoolStatePrograma LaunchLabEstado raíz por lanzamiento: mints, vaults, parámetros de curva, contadores vendidos, contadores de comisión, cronograma de vesting, estado de graduación.
authorityPrograma LaunchLabPDA único en la semilla [b"vault_auth_seed"] que posee los vaults en todos los lanzamientos y firma el CPI posterior a la graduación.
base_vaultSPL Token / Token-2022Vault por lanzamiento que retiene los tokens base no vendidos.
quote_vaultSPL TokenVault por lanzamiento que retiene los tokens quote acumulados.
VestingRecordPrograma LaunchLabRegistro de cliff + desbloqueo lineal por beneficiario. Opcional.
creator_fee_vaultSPL TokenVault por creador + por quote-mint que retiene las comisiones de creador acumuladas, barridas por ClaimCreatorFee.
platform_fee_vaultSPL TokenVault por plataforma + por quote-mint que retiene las comisiones de plataforma acumuladas, barridas por ClaimPlatformFeeFromVault.
(post-graduación) cpmm_pool_state o amm_pool_statePrograma CPMM / AMM v4El pool creado por MigrateToCpswap / MigrateToAmm.
(post-graduación) Fee Key NFTPrograma LP-LockEnvuelve la porción de LP del creador en la graduación de CPMM; autoriza al titular a ClaimCreatorFee en el pool de CPMM.
El método raydium.launchpad.getLaunchById del SDK devuelve PoolState más una bandera que indica si el lanzamiento se ha graduado; si es así, se incluye el ID del pool posterior a la migración.

​
PoolState

El estado raíz por lanzamiento. Los nombres de campo a continuación coinciden con la estructura Rust en cadena (states/pool.rs); algunos valores se han simplificado para legibilidad — consulta la fuente para el diseño exacto de memoria. 
// 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
}
Valores de PoolStatus (del IDL de Anchor): 
0 = Funding         — aceptando compras / ventas; por debajo de quote_reserve_target
1 = Migrate         — quote_reserve_target alcanzado; esperando MigrateTo*
2 = Migrated        — MigrateTo* ya ejecutado; reloj de vesting en marcha
Campos orientados al integrador:
  • status — tres valores, monótonos (Funding → Migrate → Migrated). Las lecturas son siempre seguras; las escrituras están controladas.
  • real_base, real_quote — estado actual de la curva. Combinados con virtual_base / virtual_quote son suficientes para calcular el precio spot sin tocar los vaults. Consulta bonding-curve.
  • total_base_sell vs real_base — relación de “progreso hacia la graduación” para interfaces de usuario.
  • migrate_type — selecciona si MigrateToAmm o MigrateToCpswap es la ruta válida de graduación. Los lanzamientos de Token-2022 deben usar CPMM.
  • amm_creator_fee_on — solo significativo cuando se gradúa a CPMM. Elige creator_fee_on = OnlyQuoteToken (0) o BothToken (1) en el pool de CPMM posterior a la graduación. A pesar del nombre, este enum también controla efectivamente el objetivo de migración — BothToken está emparejado con MigrateToAmm en la práctica operacional actual; QuoteToken con MigrateToCpswap. Consulta creator-fees.
  • quote_protocol_fee / platform_fee / migrate_fee — tres contadores de comisión independientes. Cada uno tiene su propia instrucción de reclamación; consulta instructions.
  • vesting_schedule — presente en cada PoolState pero inactivo cuando total_locked_amount == 0. Consulta vesting para el ciclo de vida completo.

​
El PDA de autoridad

LaunchLab utiliza un único PDA de autoridad en todos los lanzamientos, derivado sin ninguna semilla por lanzamiento: 
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,
);
Ese único PDA es:
  • La autoridad en los base_vault y quote_vault de cada lanzamiento.
  • El mint_authority en el base_mint de cada lanzamiento (pre-graduación).
  • El firmante en el CPI posterior a la graduación a AMM v4 / CPMM (MigrateTo*).
  • El firmante en las transferencias ClaimVestedToken fuera del base vault.
El mint_authority se revoca inmediatamente después de MigrateToAmm / MigrateToCpswap para que el suministro se fije permanentemente. Dos PDAs adicionales controlan los vaults de comisión: 
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,
);
Estos firman la transferencia fuera del vault de comisión correspondiente durante ClaimCreatorFee y ClaimPlatformFeeFromVault.

​
Mint base

Creado en línea por Initialize con:
  • mint_authority = authority (revocado en la graduación).
  • freeze_authority = None.
  • supply = supply, completamente acuñado en base_vault.
  • decimals elegido por el creador en Initialize (comúnmente 6).
Dado que el suministro completo se acuña previamente, base_mint.supply es constante durante toda la vida del lanzamiento. Las compras en la curva mueven tokens de base_vault al comprador, pero no llaman a mint_to. Initialize / InitializeV2 crean lanzamientos de SPL Token. La instrucción dedicada InitializeWithToken2022 permite que el mint base sea un mint de Token-2022 (con opcional TransferFeeConfig); el mint quote sigue siendo SPL Token. Los lanzamientos de Token-2022 deben graduarse a un pool de CPMM porque AMM v4 solo admite vaults de SPL Token.

​
Vaults

Tanto base_vault como quote_vault son cuentas SPL Token estándar propiedad del PDA de authority de LaunchLab. Las direcciones se almacenan en PoolState y también pueden derivarse: 
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,
);
(Verifica los prefijos de semilla exactos del struct de cuentas Initialize en la fuente antes de depender de una derivación en producción.)

​
Vaults de comisión

Dos PDAs agregan comisiones en todos los lanzamientos:
  • Vault de comisión del creador — PDA en las semillas [creator, quote_mint]. Cada lanzamiento que obtiene las mismas comisiones del creador en el mismo quote mint se vierte en el mismo vault. El creador lo barre mediante ClaimCreatorFee.
  • Vault de comisión de plataforma — PDA en las semillas [platform_config, quote_mint]. Cada lanzamiento enrutado a través de la misma plataforma que usa el mismo quote mint se vierte en el mismo vault. El platform_fee_wallet de la plataforma lo barre mediante ClaimPlatformFeeFromVault. También hay una variante de barrida por lanzamiento (ClaimPlatformFee) que extrae del quote_vault del lanzamiento directamente sin pasar por el vault agregado.
El patrón de vault agregado es lo que permite que un creador o plataforma de alto volumen amortice el costo de alquiler de la acumulación de comisiones en muchos lanzamientos.

​
Quote vault ↔ real_quote

quote_vault.balance y PoolState.real_quote deben mantenerse sincronizados. Pueden desviarse como máximo la suma de los tres contadores de comisión pendientes (quote_protocol_fee, platform_fee, migrate_fee), que se encuentran en el vault pero pertenecen a los contadores de comisión y no a la reserva de la curva. Las matemáticas de la curva siempre usan real_quote, nunca el saldo sin procesar del vault. Invariante pre-graduación: 
quote_vault.balance ==
   real_quote
 + quote_protocol_fee
 + platform_fee
 + migrate_fee

​
Transiciones de cuentas del ciclo de vida

EventoEstadoreal_basereal_quotePool post-graduación
InitializeFunding00—
BuyExactIn / BuyExactOutFunding+base_out+quote_in_after_fee—
SellExactIn / SellExactOutFunding−base_in−quote_out_before_fee—
MigrateToAmm / MigrateToCpswapFunding → Migrate → Migrated(congelado)(congelado)creado, LP dividido por PlatformConfig
ClaimCreatorFee / ClaimPlatformFee*cualquiera——drena un vault de comisión
CreateVestingAccountFunding——incrementa vesting_schedule.allocated_share_amount
ClaimVestedTokenSolo Migrated——drena base_vault

​
A dónde ir a continuación

Fuentes:
  • raydium-launch/programs/launchpad/src/states/pool.rs — PoolState, PoolStatus, VestingSchedule, AmmCreatorFeeOn.
  • raydium-launch/programs/launchpad/src/lib.rs — constantes de semilla de PDA (AUTH_SEED, CREATOR_FEE_VAULT_AUTH_SEED, PLATFORM_FEE_VAULT_AUTH_SEED).
  • Módulo launchpad del SDK de Raydium v2.