LaunchLab PlatformConfig

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 →

PlatformConfig es la superposición a nivel de plataforma que se sitúa encima de GlobalConfig. Mientras que GlobalConfig define las reglas de todo el protocolo («la comisión de intercambio es del 1%, el suministro debe ser al menos 10M, solo esta billetera puede graduarse»), PlatformConfig es lo que cada plataforma de lanzamiento —pump.fun, la propia interfaz de Raydium, launchpads de terceros— utiliza para añadir su comisión, reclamar su porción de LP post-graduación, restringir qué formas de curva pueden elegir sus lanzamientos y mostrar su marca (nombre, sitio web, imagen) en cadena.

Qué es

Una cuenta PlatformConfig gestiona cinco aspectos transversales para una plataforma:

Marca — nombre, sitio web, enlace de imagen, todo almacenado en línea para que cualquier explorador o agregador pueda mostrar la plataforma que lanzó un token.
Comisión de plataforma — una comisión de intercambio adicional (fee_rate) además de la trade_fee_rate del protocolo. Se acumula en la platform_fee_wallet de la plataforma. Limitada a 100 bps por GlobalConfig.max_share_fee_rate.
División de migración de LP — tres enteros almacenados (platform_scale, creator_scale, burn_scale) que suman 1_000_000. Antes de la actualización del 2026-08-17, la escala del creador producía una Fee Key de creador separada. Las migraciones ejecutadas después de la actualización combinan las dos primeras en una participación de LP bloqueada propiedad de la plataforma; el resto se quema.
Lista blanca de parámetros de curva — un Vec<PlatformCurveParam> que enumera exactamente qué combinaciones de (supply, total_base_sell, total_quote_fund_raising, migrate_type, migrate_cpmm_fee_on, vesting_params...) están permitidas en esta plataforma. Si el vector está vacío o todas las entradas son inválidas, cualquier combinación está permitida; de lo contrario, los lanzamientos deben coincidir exactamente con una de las entradas.
Lista blanca de configuración global — una restricción opcional que requiere un PlatformAllowConfig creado por la plataforma para la GlobalConfig seleccionada.

Derivación de PDA:

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

(Consulta create_platform_config en el código fuente para la lista de semillas canónica.)

Diseño

// 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 debe ser igual a 1_000_000. Antes de la actualización del 2026-08-17, creator_scale se bloqueaba por separado y su Fee Key iba al creador del token. Para migraciones ejecutadas después de la actualización, se suma a platform_scale y sus derechos de LP bloqueado van a la plataforma en su lugar. Ejemplos de resultados bajo la lógica actualizada:

(0, 100_000, 900_000) — 90% de LP quemado, 10% bloqueado para la plataforma.
(50_000, 100_000, 850_000) — 85% quemado, 15% bloqueado para la plataforma.
(0, 0, 1_000_000) — quema completa, sin acuñación de NFT. Lanzamientos estrictos «sin insiders».

Campos de marca

name, web e img son matrices de bytes en línea rellenadas con ceros hasta sus constantes de tamaño. Para leerlas como cadenas, corta hasta el primer \0:

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

Las constantes son deliberadamente generosas (name: 64, web: 256, img: 256) para que las plataformas puedan incluir suficientes metadatos para exploradores y agregadores sin tocar almacenamiento fuera de cadena. Cualquier cosa que exceda estos tamaños revierte en CreatePlatformConfig con InvalidInput.

Mecánica de comisiones

Un intercambio en una curva vinculada a un PlatformConfig cobra tres comisiones en capas:

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 se acumula en el protocol_fee_owner del protocolo (reclamado vía CollectFee).
platform_fee se acumula en una bóveda por plataforma (reclamado vía ClaimPlatformFee o ClaimPlatformFeeFromVault; consulta instructions).
creator_fee se acumula en una bóveda por creador con clave del pubkey del creador + mint de cotización (reclamado vía ClaimCreatorFee).

creator_fee_rate está limitado por MAX_CREATOR_FEE_RATE = 5000 (50 bps). fee_rate (la comisión de plataforma) está limitado a 10000 (100 bps) por GlobalConfig.max_share_fee_rate.

División de migración de NFT (solo CPMM)

Cuando un lanzamiento se gradúa a CPMM, la instrucción de migración divide los tokens de LP acuñados por CPMM::InitializeWithPermission de dos formas:

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

Si lp_to_platform es distinto de cero, el programa LP-Lock lo envuelve en una Fee Key NFT propiedad de platform_nft_wallet. Esto reemplaza el comportamiento anterior a la actualización que creaba Fee Keys separadas de plataforma y creador. Las Fee Keys creadas por migraciones completadas antes de la actualización permanecen sin cambios. Este derecho de comisión de LP es separado de las comisiones de creador de CPMM controladas por platform_cp_creator. La porción de quema se quema directamente, por lo que ninguna cuenta puede retirarla o reclamar las comisiones de LP representadas por esa participación. Los lanzamientos existentes con migrate_type = 0 almacenado aún pueden usar la ruta heredada de AMM v4. La nueva inicialización rechaza ese tipo de migración.

Lista blanca de parámetros de curva

curve_params: Vec<PlatformCurveParam> es el mecanismo de la plataforma para restringir qué formas de curva pueden elegir sus lanzamientos. Si el vector no está vacío y al menos una entrada es válida, el programa aplica en Initialize que los parámetros del lanzamiento coincidan exactamente con al menos una 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 tiene un valor centinela que significa comodín (cualquier valor coincide): u64::MAX para los campos u64, u8::MAX para los campos u8, 0 para los campos de suministro / venta / recaudación de fondos. Un BondingCurveParam con todos los centinelas es «permitir cualquier cosa» — equivalente al comportamiento de lista blanca vacía. El algoritmo de coincidencia en Initialize:

Filtra curve_params a entradas cuya global_config coincida con la GlobalConfig elegida del lanzamiento.
Si la lista filtrada está vacía, permite cualquier parámetro (la plataforma no incluyó en la lista blanca nada para esta GlobalConfig).
Si cada entrada en la lista filtrada tiene all_is_invalid() (cada campo es el comodín), permite cualquier parámetro.
De lo contrario, itera entradas; para cada entrada, verifica los parámetros del lanzamiento contra cada campo que no sea comodín. Si todos los campos que no son comodín coinciden, acepta y retorna.
Si ninguna entrada coincidió, revierte con InvalidInput.

Esto permite que una plataforma diga «solo permitimos la forma estándar de 1B de suministro / 800M vendidos / 30k USDC de recaudación / sin vesting» escribiendo una única entrada con valores concretos para esos cuatro campos y comodines en todos lados. O una plataforma más estricta podría enumerar tres o cuatro formas discretas, una por nivel de lanzamiento soportado. MAX_CURVE_PARAMS = 10 limita el tamaño de la lista blanca.

`PlatformAllowConfig` — restricción de una plataforma

Cada plataforma decide si restringir qué cuentas GlobalConfig pueden usar sus lanzamientos. Establece restrict_global_config con 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],
}

Semillas de PDA: [b"platform_allow_config", platform_config, global_config]. El administrador de la plataforma crea o cierra una cuenta por par permitido vía CreatePlatformAllowConfig y ClosePlatformAllowConfig. Cuando la restricción es 1, la inicialización busca en remaining_accounts el PDA esperado y rechaza una cuenta faltante con NotEnoughRemainingAccounts. Cuando la restricción es 0, no se requiere cuenta de permiso. La antigua cuenta PlatformGlobalAccess administrada por el administrador del protocolo y sus instrucciones de crear/cerrar se retiran. Los tamaños existentes de PlatformConfig y GlobalConfig no cambian, pero los decodificadores deben reemplazar la antigua bandera global con la nueva bandera de plataforma. Los antiguos PDAs de acceso no se consumen por la nueva verificación.

Ruta de lectura

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 una interfaz que muestre «desde dónde se lanzó este token», PoolState.platform_config apunta directamente a la PlatformConfig originaria — obtén la información una vez y almacena en caché la marca.

Ruta de actualización

Instrucción	Quién firma	Qué cambia
`CreatePlatformConfig`	administrador de plataforma (una sola vez)	Inicializa la cuenta con `PlatformParams`.
`UpdatePlatformConfig`	administrador de plataforma	Envío genérico con clave de un `param: u8`; muta un campo por llamada. Los campos de marca, tasas de comisión, billetera de vesting y las diversas billeteras son todos configurables a través de esto.
`CreatePlatformAllowConfig` / `ClosePlatformAllowConfig`	administrador de plataforma	Añade o elimina una `GlobalConfig` permitida para esta plataforma.
`UpdatePlatformCurveParam`	administrador de plataforma	Añade o reemplaza una entrada `PlatformCurveParam` por `(global_config, index)`.
`RemovePlatformCurveParam`	administrador de plataforma	Limpia una entrada (la establece en todos los centinelas = comodín).
`ClaimPlatformFee`	`platform_fee_wallet`	Barre la comisión de plataforma por grupo desde `PoolState.quote_vault`.
`ClaimPlatformFeeFromVault`	`platform_fee_wallet`	Barre la bóveda de comisión por plataforma (PDA en `[platform_config, quote_mint]`).

Las rotaciones de billetera (platform_fee_wallet, platform_nft_wallet, platform_vesting_wallet, platform_cp_creator, transfer_fee_extension_auth, cpswap_config) todas van a través de UpdatePlatformConfig. Lee la tabla de envío de update_platform_config del código fuente para los códigos exactos de param.

Trampas comunes

Centinelas de lista blanca mal configurados. Un BondingCurveParam con total_locked_amount = 0 no es un comodín — coincide con lanzamientos que explícitamente optan por no usar vesting. El comodín para ese campo es u64::MAX. La misma trampa existe para cliff_period y unlock_period. Usa clear() (que el programa expone) para establecer los centinelas correctamente.
Redondeo de división de NFT. Las tres escalas deben sumar exactamente 1_000_000. Los errores de uno en CreatePlatformConfig revierten; los errores de uno en tiempo de ejecución acuñarían o quemarían una unidad de LP adicional, que es lo que la verificación de igualdad estricta está ahí para prevenir.
Doble asignación de vesting de plataforma. Si platform_vesting_scale > 0, la plataforma debe llamar a CreatePlatformVestingAccount una vez después de que termine la recaudación de fondos del lanzamiento; si lo olvida, esa participación permanece sin asignar e inactiva para siempre (el presupuesto total_locked_amount del lanzamiento se consume pero la plataforma nunca lo reclama).
Ambigüedad de platform_cp_creator. Cuando se establece en Pubkey::default(), el creador del lanzamiento se registra como el pool_creator del grupo CPMM post-graduación; cuando se establece en una clave real, esa clave se registra en su lugar. Esto determina el beneficiario de las comisiones de creador de CPMM post-graduación y quién puede firmar la ruta original de CPMM::CollectCreatorFee. La ruta de recopilación sin permisos aún paga las ATAs canónicas de esta clave registrada. Decide en el momento de creación de la configuración de plataforma qué modelo quieres.
Restricción sin una cuenta de permiso. Habilitar restrict_global_config antes de crear el PlatformAllowConfig requerido bloquea nuevos lanzamientos que seleccionen esa configuración.

Referencias

products/launchlab/global-config — reglas del lado del protocolo que un lanzamiento debe satisfacer.
products/launchlab/vesting — mecánica de platform_vesting_scale.
products/launchlab/creator-fees — comisiones de creador versus derechos de Fee Key de plataforma.
products/launchlab/platforms — guía de integración de plataforma.

Fuentes:

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 — puntos de entrada de configuración de plataforma y configuración de permiso.

LaunchLab

Flujo de lanzamiento de token

Tips & Gotchas

LaunchLab PlatformConfig

Qué es

Diseño

Campos de marca

Mecánica de comisiones

División de migración de NFT (solo CPMM)

Lista blanca de parámetros de curva

`PlatformAllowConfig` — restricción de una plataforma

Ruta de lectura

Ruta de actualización

Trampas comunes

Referencias

​Qué es

​Diseño

​Campos de marca

​Mecánica de comisiones

​División de migración de NFT (solo CPMM)

​Lista blanca de parámetros de curva

​PlatformAllowConfig — restricción de una plataforma

​Ruta de lectura

​Ruta de actualización

​Trampas comunes

​Referencias

Qué es

Diseño

Campos de marca

Mecánica de comisiones

División de migración de NFT (solo CPMM)

Lista blanca de parámetros de curva

`PlatformAllowConfig` — restricción de una plataforma

Ruta de lectura

Ruta de actualización

Trampas comunes

Referencias