Contas do LaunchLab

PoolState (raiz por lançamento), os vaults base e quote, o PDA de autoridade e o grafo de contas por lançamento. GlobalConfig em nível de protocolo e PlatformConfig em nível de plataforma vivem em suas próprias páginas.

Esta página foi traduzida automaticamente por IA. A versão em inglês é a fonte oficial.

Ver versão em inglês →

Esta página documenta o grafo de contas por lançamento: o PoolState (a conta de estado raiz para um lançamento), seus dois vaults, o PDA de autoridade e as referências pós-graduação que ele ganha quando o lançamento é liquidado.

Para a configuração em nível de protocolo que limita todos os lançamentos, veja products/launchlab/global-config. Para a camada por plataforma, veja products/launchlab/platform-config. Para contas de vesting (VestingSchedule em PoolState, VestingRecord por beneficiário), veja products/launchlab/vesting.

​

Inventário de contas

Conta	Proprietário	Propósito
GlobalConfig	Programa LaunchLab	Regras em nível de protocolo: taxas, pisos de suprimento, carteiras de migração. Uma por (curve_type, index).
PlatformConfig	Programa LaunchLab	Camada por plataforma: marca, taxa de plataforma, divisão de NFT na graduação, lista branca de forma de curva.
PoolState	Programa LaunchLab	Estado raiz por lançamento: mints, vaults, parâmetros de curva, contadores vendidos, contadores de taxa, cronograma de vesting, status de graduação.
authority	Programa LaunchLab	PDA único na seed [b"vault_auth_seed"] que possui vaults em todos os lançamentos e assina o CPI pós-graduação.
base_vault	SPL Token / Token-2022	Vault por lançamento contendo os tokens base não vendidos.
quote_vault	SPL Token	Vault por lançamento contendo tokens quote acumulados.
VestingRecord	Programa LaunchLab	Registro por beneficiário de cliff + desbloqueio linear. Opcional.
creator_fee_vault	SPL Token	Vault por criador + por quote mint contendo taxas de criador acumuladas, limpas por ClaimCreatorFee.
platform_fee_vault	SPL Token	Vault por plataforma + por quote mint contendo taxas de plataforma acumuladas, limpas por ClaimPlatformFeeFromVault.
(pós-graduação) cpmm_pool_state ou amm_pool_state	Programa CPMM / AMM v4	O pool criado por MigrateToCpswap / MigrateToAmm.
(pós-graduação) Fee Key NFT	Programa LP-Lock	Envolve a fatia do LP do criador na graduação CPMM; entitula o detentor a ClaimCreatorFee no pool CPMM.

O raydium.launchpad.getLaunchById do SDK retorna PoolState mais uma flag indicando se o lançamento foi graduado; se foi, o ID do pool pós-migração está incluído.

​

PoolState

O estado raiz por lançamento. Os nomes de campo abaixo correspondem à struct Rust on-chain (states/pool.rs); alguns valores são simplificados para legibilidade — consulte a fonte para o layout exato de memória.

// 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 (do IDL Anchor):

0 = Funding         — aceitando compras / vendas; abaixo de quote_reserve_target
1 = Migrate         — quote_reserve_target atingido; aguardando MigrateTo*
2 = Migrated        — MigrateTo* já executado; relógio de vesting rodando

Campos voltados para integradores:

• status — três valores, monotone (Funding → Migrate → Migrated). Leituras sempre seguras; escritas controladas.
• real_base, real_quote — estado de curva atual. Combinados com virtual_base / virtual_quote são suficientes para calcular o preço spot sem tocar nos vaults. Veja bonding-curve.
• total_base_sell vs real_base — razão de “progresso em direção à graduação” para UIs.
• migrate_type — seleciona se MigrateToAmm ou MigrateToCpswap é o caminho de graduação válido. Lançamentos Token-2022 devem usar CPMM.
• amm_creator_fee_on — apenas significativo ao graduar para CPMM. Escolhe creator_fee_on = OnlyQuoteToken (0) ou BothToken (1) no pool CPMM pós-graduação. Apesar do nome, este enum efetivamente também direciona o alvo de migração — BothToken é pareado com MigrateToAmm na prática operacional atual; QuoteToken com MigrateToCpswap. Veja creator-fees.
• quote_protocol_fee / platform_fee / migrate_fee — três contadores de taxa independentes. Cada um tem sua própria instrução de claim; veja instructions.
• vesting_schedule — presente em todo PoolState mas inativo quando total_locked_amount == 0. Veja vesting para o ciclo de vida completo.

​

O PDA de autoridade

LaunchLab usa um único PDA de autoridade em todos os lançamentos, derivado sem seed por lançamento:

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,
);

Esse PDA único é:

• A autoridade em cada base_vault e quote_vault de lançamento.
• A mint_authority em cada base_mint do lançamento (pré-graduação).
• O signatário no CPI pós-graduação para AMM v4 / CPMM (MigrateTo*).
• O signatário nas transferências ClaimVestedToken fora do base vault.

A mint_authority é revogada imediatamente após MigrateToAmm / MigrateToCpswap para que o suprimento seja permanentemente fixo.

Dois PDAs adicionais controlam os vaults de taxa:

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,
);

Estes assinam a transferência para fora do vault de taxa correspondente durante ClaimCreatorFee e ClaimPlatformFeeFromVault.

​

Base mint

Criado inline por Initialize com:

• mint_authority = authority (revogada na graduação).
• freeze_authority = None.
• supply = supply, inteiramente cunhada em base_vault.
• decimals escolhido pelo criador em Initialize (comumente 6).

Como o suprimento total é pré-cunhado, base_mint.supply é constante para a vida útil do lançamento. Compras de curva movem tokens de base_vault para o comprador, mas não chamam mint_to.

Initialize / InitializeV2 criam lançamentos SPL Token. A instrução dedicada InitializeWithToken2022 permite que o base mint seja um mint Token-2022 (com TransferFeeConfig opcional); o quote mint ainda é SPL Token. Lançamentos Token-2022 devem graduar para um pool CPMM porque AMM v4 suporta apenas vaults SPL Token.

​

Vaults

Tanto base_vault quanto quote_vault são contas SPL Token padrão possuídas pelo PDA LaunchLab authority. Os endereços são armazenados em PoolState e também podem ser derivados:

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,
);

(Verifique os prefixos exatos de seed da struct de contas Initialize da fonte antes de confiar em uma derivação em produção.)

​

Vaults de taxa

Dois PDAs agregam taxas em lançamentos:

• Vault de taxa do criador — PDA nas seeds [creator, quote_mint]. Todo lançamento que arrecada as mesmas taxas de criador no mesmo quote mint despeja no mesmo vault. O criador o limpa via ClaimCreatorFee.
• Vault de taxa de plataforma — PDA nas seeds [platform_config, quote_mint]. Todo lançamento roteado através da mesma plataforma que usa o mesmo quote mint despeja no mesmo vault. A platform_fee_wallet da plataforma o limpa via ClaimPlatformFeeFromVault. Há também uma variante de limpeza por lançamento (ClaimPlatformFee) que extrai do quote_vault do lançamento diretamente sem passar pelo vault agregado.

O padrão de vault agregado é o que permite que um criador ou plataforma de alto volume amortize o custo de aluguel da acumulação de taxas em muitos lançamentos.

​

Quote vault ↔ real_quote

quote_vault.balance e PoolState.real_quote devem permanecer em sincronização. Podem divergir no máximo pela soma dos três contadores de taxa pendentes (quote_protocol_fee, platform_fee, migrate_fee), que ficam no vault mas pertencem aos contadores de taxa e não à reserva de curva. A matemática da curva sempre usa real_quote, nunca o saldo bruto do vault.

Invariante pré-graduação:

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

​

Transições de contas do ciclo de vida

Evento	Status	real_base	real_quote	Pool pós-graduação
Initialize	Funding	0	0	—
BuyExactIn / BuyExactOut	Funding	+base_out	+quote_in_after_fee	—
SellExactIn / SellExactOut	Funding	−base_in	−quote_out_before_fee	—
MigrateToAmm / MigrateToCpswap	Funding → Migrate → Migrated	(congelado)	(congelado)	criado, LP dividido por PlatformConfig
ClaimCreatorFee / ClaimPlatformFee*	qualquer	—	—	drena um vault de taxa
CreateVestingAccount	Funding	—	—	incrementa vesting_schedule.allocated_share_amount
ClaimVestedToken	Migrated apenas	—	—	drena base_vault

​

Próximos passos

• products/launchlab/bonding-curve — a matemática por trás de real_base ↔ real_quote.
• products/launchlab/instructions — listas de contas por instrução.
• products/launchlab/global-config — vinculação em nível de protocolo.
• products/launchlab/platform-config — camada de plataforma.
• products/launchlab/vesting — mecânica de suprimento bloqueado.
• products/cpmm/accounts — como o cpmm_pool_state pós-graduação se parece.

Fontes:

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