LaunchLab PlatformConfig

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

PlatformConfig é a sobreposição no nível da plataforma que fica acima de GlobalConfig. Enquanto GlobalConfig define as regras em todo o protocolo (“taxa de negociação é 1%, fornecimento deve ser pelo menos 10M, apenas esta carteira pode se formar”), PlatformConfig é o que cada plataforma de lançamento — pump.fun, a própria interface do Raydium, launchpads de terceiros — usa para adicionar sua taxa, reivindicar sua fatia do LP pós-graduação, restringir quais formas de curva seus lançamentos podem escolher e exibir sua marca (nome, site, imagem) on-chain.

O que é

Uma conta PlatformConfig gerencia cinco responsabilidades transversais para uma plataforma:

Marca — nome, site, link de imagem, todos armazenados inline para que qualquer explorador ou agregador possa exibir a plataforma que lançou um token.
Taxa de plataforma — uma taxa de negociação extra (fee_rate) além da trade_fee_rate do protocolo. Acumula na platform_fee_wallet da plataforma. Limitada a 100 bps por GlobalConfig.max_share_fee_rate.
Divisão de migração de LP — três inteiros armazenados (platform_scale, creator_scale, burn_scale) que somam 1_000_000. Antes da atualização de 2026-08-17, a escala do criador produzia uma Fee Key separada do criador. Migrações executadas após a atualização combinam as duas primeiras em uma compartilhamento de LP bloqueado de propriedade da plataforma; o restante é queimado.
Lista de permissões de parâmetros de curva — um Vec<PlatformCurveParam> listando exatamente quais combinações de (supply, total_base_sell, total_quote_fund_raising, migrate_type, migrate_cpmm_fee_on, vesting_params...) são permitidas nesta plataforma. Se o vetor estiver vazio ou todas as entradas forem inválidas, qualquer combinação é permitida; caso contrário, os lançamentos devem corresponder exatamente a uma das entradas.
Lista de permissões de configuração global — uma restrição opt-in que requer um PlatformAllowConfig criado pela plataforma para a GlobalConfig selecionada.

Derivação de PDA:

const [platformConfigPda] = PublicKey.findProgramAddressSync(
  [
    Buffer.from("platform_config"),
    platformAdmin.toBuffer(),       // platform's owning pubkey
  ],
  LAUNCHLAB_PROGRAM_ID,
);

(Veja create_platform_config no código-fonte para a lista de seeds canônica.)

Layout

// states/platform_config.rs
pub const PLATFORM_CONFIG_SEED: &str = "platform_config";
pub const NAME_SIZE: usize = 64;
pub const WEB_SIZE:  usize = 256;
pub const IMG_SIZE:  usize = 256;
pub const MAX_CREATOR_FEE_RATE: u64 = 5000;       // 50 bps (denominator 1_000_000)
pub const MAX_TRANSFER_FEE_RATE: u16 = 500;       // 5%   (denominator 10_000)
pub const MAX_CURVE_PARAMS: usize = 10;

#[account]
pub struct PlatformConfig {
    pub epoch:                       u64,
    pub platform_fee_wallet:         Pubkey,            // signs ClaimPlatformFee
    pub platform_nft_wallet:         Pubkey,            // receives the platform NFT slice at CPMM graduation
    pub platform_scale:              u64,               // share of LP minted to platform NFT
    pub creator_scale:               u64,               // creator share before upgrade; added to platform share afterward
    pub burn_scale:                  u64,               // share of LP burned permanently
    pub fee_rate:                    u64,               // platform's trade fee (1/1_000_000)
    pub name:                        [u8; 64],          // utf-8 padded with zeros
    pub web:                         [u8; 256],
    pub img:                         [u8; 256],
    pub cpswap_config:               Pubkey,            // CPMM AmmConfig that the post-grad pool will bind to
    pub creator_fee_rate:            u64,               // creator-side fee taken pre-graduation
    pub transfer_fee_extension_auth: Pubkey,            // for Token-2022 launches: who inherits transfer-fee authorities post-graduation
    pub platform_vesting_wallet:     Pubkey,
    pub platform_vesting_scale:      u64,               // platform's slice of total_locked_amount
    pub platform_cp_creator:         Pubkey,            // optional creator-of-record on the post-graduation CPMM pool
    pub restrict_global_config:      u8,                // 0 = unrestricted, 1 = require allow PDA
    pub padding:                     [u8; 107],
    pub curve_params:                Vec<PlatformCurveParam>, // whitelist of permitted curve shapes
}

platform_scale + creator_scale + burn_scale deve ser igual a 1_000_000. Antes da atualização de 2026-08-17, creator_scale era bloqueado separadamente e sua Fee Key ia para o criador do token. Para migrações executadas após a atualização, é adicionado a platform_scale e seus direitos de LP bloqueado vão para a plataforma. Exemplos de resultados sob a lógica atualizada:

(0, 100_000, 900_000) — 90% LP queimado, 10% bloqueado para a plataforma.
(50_000, 100_000, 850_000) — 85% queimado, 15% bloqueado para a plataforma.
(0, 0, 1_000_000) — queima total, sem cunhagem de NFT. Lançamentos estritos “sem insiders”.

Campos de marca

name, web e img são arrays de bytes inline preenchidos com zeros até suas constantes de tamanho. Para lê-los como strings, fatia até o primeiro \0:

function readString(bytes: Uint8Array): string {
  const end = bytes.indexOf(0);
  return Buffer.from(end === -1 ? bytes : bytes.subarray(0, end)).toString("utf-8");
}

As constantes são deliberadamente generosas (name: 64, web: 256, img: 256) para que as plataformas possam incluir metadados suficientes para exploradores e agregadores sem acessar armazenamento off-chain. Qualquer coisa que exceda esses tamanhos reverte em CreatePlatformConfig com InvalidInput.

Mecânica de taxas

Um swap em uma curva vinculada a um PlatformConfig cobra três taxas em camadas:

trade_fee     = amount_in × global_config.trade_fee_rate    / 1_000_000
platform_fee  = amount_in × platform_config.fee_rate        / 1_000_000
creator_fee   = amount_in × platform_config.creator_fee_rate / 1_000_000

amount_after_fee = amount_in − trade_fee − platform_fee − creator_fee

trade_fee acumula no protocol_fee_owner do protocolo (reivindicado via CollectFee).
platform_fee acumula em um cofre por plataforma (reivindicado via ClaimPlatformFee ou ClaimPlatformFeeFromVault; veja instructions).
creator_fee acumula em um cofre por criador com chave do pubkey do criador + quote mint (reivindicado via ClaimCreatorFee).

creator_fee_rate é limitado por MAX_CREATOR_FEE_RATE = 5000 (50 bps). fee_rate (a taxa de plataforma) é limitado a 10000 (100 bps) por GlobalConfig.max_share_fee_rate.

Divisão de migração de NFT (apenas CPMM)

Quando um lançamento se forma para CPMM, a instrução de migração divide os tokens LP cunhados por CPMM::InitializeWithPermission de duas maneiras:

lp_to_platform = floor(lp_total × (platform_scale + creator_scale) / 1_000_000)
lp_to_burn     = lp_total − lp_to_platform

Se lp_to_platform for diferente de zero, o programa LP-Lock o envolve em uma Fee Key NFT de propriedade de platform_nft_wallet. Isso substitui o comportamento pré-atualização que criava Fee Keys separadas de plataforma e criador. Fee Keys criadas por migrações concluídas antes da atualização permanecem inalteradas. Este direito de taxa de LP é separado das taxas de criador CPMM controladas por platform_cp_creator. A fatia de queima é queimada diretamente, portanto nenhuma conta pode sacá-la ou reivindicar as taxas de LP representadas por essa fatia. Lançamentos existentes com migrate_type = 0 armazenado ainda podem usar o caminho AMM v4 legado. A nova inicialização rejeita esse tipo de migração.

Lista de permissões de parâmetros de curva

curve_params: Vec<PlatformCurveParam> é o mecanismo da plataforma para restringir quais formas de curva seus lançamentos podem escolher. Se o vetor não estiver vazio e pelo menos uma entrada for válida, o programa força em Initialize que os parâmetros do lançamento correspondam exatamente a pelo menos uma entrada.

#[derive(AnchorSerialize, AnchorDeserialize, Clone)]
pub struct PlatformCurveParam {
    pub epoch:                u64,
    pub index:                u8,           // ordinal within this platform's whitelist
    pub global_config:        Pubkey,       // which GlobalConfig this entry applies to
    pub bonding_curve_param:  BondingCurveParam,
    pub padding:              [u64; 50],
}

#[derive(AnchorSerialize, AnchorDeserialize, Clone)]
pub struct BondingCurveParam {
    pub migrate_type:               u8,    // new launches require 1 = CPMM; u8::MAX = wildcard
    pub migrate_cpmm_fee_on:        u8,    // 0 = quote-only, 1 = both. u8::MAX = wildcard
    pub supply:                     u64,   // 0 = wildcard
    pub total_base_sell:            u64,   // 0 = wildcard
    pub total_quote_fund_raising:   u64,   // 0 = wildcard
    pub total_locked_amount:        u64,   // u64::MAX = wildcard
    pub cliff_period:               u64,   // u64::MAX = wildcard
    pub unlock_period:              u64,   // u64::MAX = wildcard
}

Cada campo tem um valor sentinela que significa wildcard (qualquer valor corresponde): u64::MAX para os campos u64, u8::MAX para os campos u8, 0 para os campos de fornecimento / venda / arrecadação de fundos. Um BondingCurveParam com todos os sentinelas é “permitir qualquer coisa” — equivalente ao comportamento de lista vazia. O algoritmo de correspondência em Initialize:

Filtra curve_params para entradas cuja global_config corresponde à GlobalConfig escolhida do lançamento.
Se a lista filtrada estiver vazia, permite qualquer parâmetro (a plataforma não colocou na lista de permissões nada para esta GlobalConfig).
Se cada entrada na lista filtrada tiver all_is_invalid() (cada campo é o wildcard), permite qualquer parâmetro.
Caso contrário, itera entradas; para cada entrada, verifica os parâmetros do lançamento contra cada campo não-wildcard. Se todos os campos não-wildcard corresponderem, aceita e retorna.
Se nenhuma entrada correspondeu, reverte com InvalidInput.

Isso permite que uma plataforma diga “permitimos apenas a forma padrão de 1B de fornecimento / 800M vendidos / 30k USDC de arrecadação / sem vesting” escrevendo uma única entrada com valores concretos para esses quatro campos e wildcards em qualquer outro lugar. Ou uma plataforma mais rigorosa pode enumerar três ou quatro formas discretas, uma por nível de lançamento suportado. MAX_CURVE_PARAMS = 10 limita o tamanho da lista de permissões.

`PlatformAllowConfig` — restringindo uma plataforma

Cada plataforma decide se restringe quais contas GlobalConfig seus lançamentos podem usar. Defina restrict_global_config com UpdatePlatformConfig::RestrictGlobalConfig(0 | 1).

pub const PLATFORM_ALLOW_CONFIG_SEED: &str = "platform_allow_config";

#[account]
pub struct PlatformAllowConfig {
    pub bump:            u8,
    pub platform_config: Pubkey,
    pub global_config:   Pubkey,
    pub padding:         [u64; 8],
}

Seeds de PDA: [b"platform_allow_config", platform_config, global_config]. O administrador da plataforma cria ou fecha uma conta por par permitido via CreatePlatformAllowConfig e ClosePlatformAllowConfig. Quando a restrição é 1, a inicialização procura em remaining_accounts pelo PDA esperado e rejeita uma conta ausente com NotEnoughRemainingAccounts. Quando a restrição é 0, nenhuma conta de permissão é necessária. A conta PlatformGlobalAccess gerenciada anteriormente pelo administrador do protocolo e suas instruções de criar/fechar são descontinuadas. Os tamanhos existentes de PlatformConfig e GlobalConfig não mudam, mas os decodificadores devem substituir o sinalizador global antigo pelo novo sinalizador de plataforma. PDAs de acesso antigos não são consumidos pela nova verificação.

Caminho de leitura

const platformConfig = await raydium.launchpad.getPlatformConfig(platformConfigPda);

console.log("Platform:", readString(platformConfig.name));
console.log("Fee rate:", platformConfig.feeRate, "(/1M)");
console.log("NFT split:",
  platformConfig.platformScale,
  platformConfig.creatorScale,
  platformConfig.burnScale,
);
console.log("Curve whitelist size:", platformConfig.curveParams.length);

Para uma interface mostrando “de onde este token foi lançado”, PoolState.platform_config aponta diretamente para o PlatformConfig originário — busque uma vez e coloque em cache a marca.

Caminho de atualização

Instrução	Quem assina	O que muda
`CreatePlatformConfig`	administrador da plataforma (uma vez)	Inicializa a conta com `PlatformParams`.
`UpdatePlatformConfig`	administrador da plataforma	Despacho genérico com chave por um `param: u8`; muta um campo por chamada. Campos de marca, taxas, carteira de vesting e as várias carteiras são todos configuráveis através disso.
`CreatePlatformAllowConfig` / `ClosePlatformAllowConfig`	administrador da plataforma	Adiciona ou remove uma `GlobalConfig` permitida para esta plataforma.
`UpdatePlatformCurveParam`	administrador da plataforma	Adiciona ou substitui uma entrada `PlatformCurveParam` por `(global_config, index)`.
`RemovePlatformCurveParam`	administrador da plataforma	Limpa uma entrada (define como todos-sentinela = wildcard).
`ClaimPlatformFee`	`platform_fee_wallet`	Varre a taxa de plataforma por pool de `PoolState.quote_vault`.
`ClaimPlatformFeeFromVault`	`platform_fee_wallet`	Varre o cofre de taxa por plataforma (PDA em `[platform_config, quote_mint]`).

Rotações de carteira (platform_fee_wallet, platform_nft_wallet, platform_vesting_wallet, platform_cp_creator, transfer_fee_extension_auth, cpswap_config) todas passam por UpdatePlatformConfig. Leia a tabela de despacho update_platform_config do código-fonte para os códigos param exatos.

Armadilhas comuns

Sentinelas de lista de permissões mal definidas. Um BondingCurveParam com total_locked_amount = 0 não é um wildcard — corresponde a lançamentos que explicitamente optam por não usar vesting. O wildcard para esse campo é u64::MAX. A mesma armadilha existe para cliff_period e unlock_period. Use clear() (que o programa expõe) para definir sentinelas corretamente.
Arredondamento de divisão de NFT. As três escalas devem somar exatamente 1_000_000. Erros de um em CreatePlatformConfig revertam; erros de um em tempo de execução cunhariam ou queimariam uma unidade LP extra, que é o que a verificação de igualdade estrita está lá para prevenir.
Dupla alocação de vesting de plataforma. Se platform_vesting_scale > 0, a plataforma deve chamar CreatePlatformVestingAccount uma vez após o término da arrecadação de fundos do lançamento; se esquecer, essa fatia permanece não alocada e dormente para sempre (o orçamento total_locked_amount do lançamento é consumido mas a plataforma nunca reclama).
Ambiguidade de platform_cp_creator. Quando definido como Pubkey::default(), o criador do lançamento é registrado como pool_creator do pool CPMM pós-graduação; quando definido como uma chave real, essa chave é registrada. Isso determina o beneficiário das taxas de criador CPMM pós-graduação e quem pode assinar o caminho original CPMM::CollectCreatorFee. O caminho de coleta sem permissão ainda paga as ATAs canônicas dessa chave registrada. Decida no momento da criação da configuração da plataforma qual modelo você quer.
Restrição sem uma conta de permissão. Habilitar restrict_global_config antes de criar o PlatformAllowConfig necessário bloqueia novos lançamentos que selecionam essa configuração.

Referências

products/launchlab/global-config — regras do lado do protocolo que um lançamento deve satisfazer.
products/launchlab/vesting — mecânica de platform_vesting_scale.
products/launchlab/creator-fees — taxas de criador versus direitos de Fee Key de plataforma.
products/launchlab/platforms — guia de como fazer para integradores de plataforma.

Fontes:

raydium-launch/programs/launchpad/src/states/platform_config.rs — PlatformConfig, PlatformParams, MigrateNftInfo, PlatformCurveParam, BondingCurveParam, is_valid_curve_param.
raydium-launch/programs/launchpad/src/states/platform_allow_config.rs — PlatformAllowConfig.
raydium-launch/programs/launchpad/src/lib.rs — pontos de entrada de configuração de plataforma e configuração de permissão.

LaunchLab

Token launch flow

Tips & Gotchas

LaunchLab PlatformConfig

O que é

Layout

Campos de marca

Mecânica de taxas

Divisão de migração de NFT (apenas CPMM)

Lista de permissões de parâmetros de curva

`PlatformAllowConfig` — restringindo uma plataforma

Caminho de leitura

Caminho de atualização

Armadilhas comuns

Referências

​O que é

​Layout

​Campos de marca

​Mecânica de taxas

​Divisão de migração de NFT (apenas CPMM)

​Lista de permissões de parâmetros de curva

​PlatformAllowConfig — restringindo uma plataforma

​Caminho de leitura

​Caminho de atualização

​Armadilhas comuns

​Referências

O que é

Layout

Campos de marca

Mecânica de taxas

Divisão de migração de NFT (apenas CPMM)

Lista de permissões de parâmetros de curva

`PlatformAllowConfig` — restringindo uma plataforma

Caminho de leitura

Caminho de atualização

Armadilhas comuns

Referências