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 →
LaunchLab es el principal lugar de lanzamiento de mercado primario de Raydium. Un proyecto deposita su suministro de tokens en una curva de unión; los compradores intercambian contra la curva usando SOL (u otro mint de cotización); cuando se alcanza un umbral de graduación, los activos de la curva migran automáticamente a un pool CPMM, y el token se vuelve libremente comercializable. Esta página recorre el flujo completo desde el lado del proyecto.

Lo que necesitas

  • Mint de token — el token que quieres vender. Debe ser recién creado con:
    • Suministro completo acuñado en tu wallet (para que puedas depositarlo en la curva).
    • Autoridad de acuñación revocada antes del lanzamiento (de lo contrario, el precio de la curva puede ser manipulado por nuevas acuñaciones).
  • Metadatos — nombre, símbolo, imagen, enlaces sociales. Metadatos de Metaplex o similar.
  • Wallet — ~1 SOL para renta de creación + financiación de bóveda + comisiones de prioridad (la graduación en sí es pagada por quien se gradúa, no por ti).
  • Decisión sobre:
    • Tipo de curva (cuadrática vs CPMM de reservas virtuales).
    • Umbral de graduación.
    • Política de disposición de LP (Quemar / Bloquear / AlCreador).
    • Precio y cap iniciales.

Selección de curva

LaunchLab admite dos familias de curvas:

Cuadrática (curve_type = 0)

El precio crece cuadráticamente con el suministro vendido. Sensación clásica de “lanzamiento justo” — los compradores tempranos obtienen una ventaja de precio, los compradores tardíos pagan más, el precio se acelera suavemente.
price(s) = a * s^2 + b * s + c
donde s es el suministro vendido. Típicamente a > 0 (convexo). El diferencial entre precio inicial y graduación es determinista dados a, b, c y el cap. Mejor para: lanzamientos novedosos, memes, proyectos impulsados por la comunidad.

CPMM de reservas virtuales (curve_type = 1)

Emula un AMM de producto constante usando reservas virtuales — la curva se comporta como un CPMM con x * y = k pero el pool comienza sembrado con tokens sintéticos que nunca se retiran.
price = virtual_quote_reserve / virtual_base_reserve
A medida que los compradores compran, virtual_base_reserve disminuye y virtual_quote_reserve aumenta — la curva se ve idéntica a lo que el CPMM post-graduación se verá. Transición más suave. Mejor para: lanzamientos que desean continuidad de precio predecible post-graduación.

Tutorial de UI

En raydium.io/launchpad/create:
  1. Token. Pega la dirección del mint. La UI obtiene metadatos y los muestra.
  2. Tipo de curva. Elige cuadrática o CPMM virtual; la UI muestra una vista previa del gráfico de precios para cada una.
  3. Umbral de graduación. Predeterminado: la curva termina después de que se venda todo el total_base_supply. Alternativa: terminar en un graduation_quote_amount específico (p. ej. 85 SOL).
  4. Mint de cotización. SOL (predeterminado), USDC, u otro mint. SOL es estándar.
  5. Política de disposición de LP:
    • Quemar — Tokens LP enviados a una dirección inutilizable en la graduación. El creador no puede retirar liquidez; los usuarios confían en el pool para siempre.
    • Bloquear — Tokens LP enviados a un depósito bloqueado por tiempo durante lock_duration.
    • AlCreador — Tokens LP enviados al creador. Más flexible, menos reducción de confianza.
    Los lanzamientos más respetados utilizan Quemar.
  6. Revisión. La UI resume: rango de precio esperado, recaudación inicial si la curva se agota, configuración de CPMM de graduación.
  7. Firmar. Una transacción crea el estado de lanzamiento + bóveda base + bóveda de cotización, transfiere total_base_supply desde tu wallet a la bóveda base.

Tutorial programático

import { Raydium, TxVersion } from "@raydium-io/raydium-sdk-v2";
import { PublicKey } from "@solana/web3.js";
import BN from "bn.js";

const raydium = await Raydium.load({ connection, owner, cluster: "mainnet" });

const baseMint  = new PublicKey("MyNewToken...");
const quoteMint = new PublicKey("So11111111111111111111111111111111111111112"); // SOL

const { execute, extInfo } = await raydium.launchpad.createLaunchpad({
  programId:      LAUNCHPAD_PROGRAM_ID,
  baseMint,
  quoteMint,
  curveType:      0,                           // quadratic
  totalBaseSupply:    new BN("1000000000000000000"),   // 1B tokens with 9 decimals
  graduationQuoteAmount: new BN("85000000000"),         // 85 SOL
  lpDisposalPolicy:   "Burn",
  priceCurveParams: {
    a: new BN("1"),
    b: new BN("0"),
    c: new BN("0"),
  },
  startTime: new BN(Math.floor(Date.now() / 1000) + 300),  // start in 5 min
  txVersion: TxVersion.V0,
  computeBudgetConfig: { units: 400_000, microLamports: 50_000 },
});

const { txId } = await execute({ sendAndConfirm: true });
console.log("Launch ID:", extInfo.launchId.toBase58());
console.log("Base vault:", extInfo.baseVault.toBase58());
console.log("Quote vault:", extInfo.quoteVault.toBase58());

Monitoreo pre-graduación

Rastrea la actividad a través de la API:
const status = await fetch(
  `https://api-v3.raydium.io/launchpad/status?launchId=${launchId}`
).then(r => r.json());

console.log("Sold so far:",       status.baseSold.toString());
console.log("Quote raised:",      status.quoteRaised.toString());
console.log("Current price:",     status.currentPriceUsd);
console.log("Graduation progress:", status.graduationProgress, "%");
O decodifica el estado on-chain directamente:
const launchState = await raydium.launchpad.fetchLaunchState(launchId);
console.log({
  baseSold:   launchState.baseSold.toString(),
  quoteHeld:  launchState.quoteHeld.toString(),
  graduated:  launchState.graduated,
});

Métricas a observar

  • Tasa de agotamiento: porcentaje de base vendida. El umbral de graduación típicamente se alcanza al 80–100% vendido.
  • Precio actual: derivado de la curva en el baseSold actual.
  • Compradores únicos: conteo de pagadores distintos a través del indexador.
  • Ratio de compra vs venta: los lanzamientos tempranos ven presión de compra fuerte que se desvanece.
Si el agotamiento es <10% después de 24 horas, considera si el marketing es adecuado. LaunchLab no rescata lanzamientos poco publicitados.

Graduación

La graduación es una transacción separada, que puede ser llamada por cualquiera (generalmente la primera persona en notar que se alcanzó el umbral gana la pequeña graduation_bounty). No se requiere acción de ti como creador más allá de la configuración inicial.

Lo que hace la graduación

  1. Lee los saldos de la bóveda.
  2. Cierra la curva (no más compras/ventas contra ella).
  3. Crea un nuevo pool CPMM con los saldos de la bóveda como liquidez inicial.
  4. Acuña tokens LP iniciales basados en los saldos de la bóveda.
  5. Dispone de los tokens LP según la política configurada (Quemar / Bloquear / AlCreador).
Después de la graduación, el pool CPMM está activo y las transacciones se realizan a través del enrutamiento normal de Raydium.

Monitoreo para graduación

const launchState = await raydium.launchpad.fetchLaunchState(launchId);
if (launchState.graduated) {
  const cpmmPoolId = launchState.graduatedCpmmPool;
  console.log("Graduated to CPMM pool:", cpmmPoolId.toBase58());
}

Graduación manual

Si nadie reclama la bounty y quieres forzar la graduación, puedes llamarla tú mismo:
await raydium.launchpad.graduate({
  launchId,
  txVersion: TxVersion.V0,
  computeBudgetConfig: { units: 600_000, microLamports: 100_000 },
});
La graduación usa CU significativo; presupuesta 600k.

Post-graduación

Verifica el pool CPMM

const pool = await raydium.cpmm.getPoolInfoFromRpc({ poolId: cpmmPoolId });
console.log("CPMM price:", pool.poolInfo.price);
console.log("CPMM TVL:  ", pool.poolInfo.tvl);
El pool CPMM debe tener (aproximadamente):
  • Saldo de token base: total_base_supply - baseSold + remanente de curva.
  • Saldo de token de cotización: quoteRaised - graduationFee.
  • Precio: coincide con el precio de curva anterior.

Verifica la disposición de LP

  • Quemar: el suministro del mint LP muestra enviado a 1nc1nerator11111111111111111111111111111111 o similar.
  • Bloquear: tokens LP en el PDA del depósito con marca de tiempo de desbloqueo.
  • AlCreador: tokens LP en el wallet del creador.

Recopila comisiones del creador

Si configuraste una participación de comisión del creador, llama periódicamente:
await raydium.launchpad.collectCreatorFees({
  launchId,
  txVersion: TxVersion.V0,
});
Las comisiones se acumulan a partir de transacciones de curva pre-graduación y del pool CPMM graduado post-graduación (si ToCreator LP).

Lista de verificación de anuncio

El anuncio post-graduación debe incluir:
  • Hash de transacción de graduación.
  • ID del nuevo pool CPMM.
  • Prueba de disposición de LP (tx de quema / tx de bloqueo / wallet del creador).
  • ETA de cobertura de agregador (los wallets típicamente indexan dentro de 5 minutos).
  • Verificación de contrato de token (coincide la dirección del mint en todos los canales de anuncio).

Trampas

1. Autoridad de acuñación no revocada

Si baseMint.mintAuthority sigue siendo una clave que controlas, puedes acuñar nuevo suministro y vender en tu propia curva. Los lanzamientos que no han revocado se marcan comúnmente como alto riesgo o sin verificar por agregadores y sitios de listado. Revoca antes de lanzar.

2. Parámetros de curva incorrectos

Las curvas cuadráticas con a demasiado alto hacen tokens tempranos gratis (precio ≈ 0) y tokens posteriores absurdos. Las curvas con a demasiado bajo hacen la curva casi lineal (pierden la sensación de “unión”). Prueba parámetros en devnet primero.

3. Umbral de graduación demasiado alto

Si la graduación requiere más capital que la demanda realista, la curva nunca se gradúa y los compradores quedan atrapados con tokens que solo pueden vender de vuelta a la curva (a peores precios). Elige un umbral que realmente puedas alcanzar.

4. Estafas de mint de cotización

Si tu mint de cotización es un token personalizado (no SOL/USDC), los usuarios no lo confiarán. Adhiérete a SOL o USDC para cotización.

5. Olvidó financiar la bóveda base

El SDK transfiere totalBaseSupply desde tu wallet al crear. Si tu wallet no lo tiene, la tx revierte. Confirma el saldo antes de firmar.

6. Disposición de LP = Quemar es irreversible

Una vez que el LP se envía a 1nc1nerator, nadie puede retirar liquidez, incluyéndote a ti. Este es el punto — reducción de confianza. No elijas Quemar si no estás seguro.

7. Nivel de comisión CPMM post-graduación

El pool graduado utiliza la configuración CPMM predeterminada de LaunchLab (0.25%). Si querías 1% o 0.01%, necesitas crear un segundo pool CPMM tú mismo post-graduación y migrar liquidez — es torpe y fragmenta. Acepta el predeterminado, o lanza a través de creación CPMM directa en lugar de LaunchLab.

Referencias

Fuentes:
  • Módulo launchpad de Raydium SDK v2.
  • Estado de lanzamiento a través de endpoints de api-v3.raydium.io.