SDK de TypeScript

​

Instalar

npm install @raydium-io/raydium-sdk-v2 @solana/web3.js @solana/spl-token
# o
pnpm add @raydium-io/raydium-sdk-v2 @solana/web3.js @solana/spl-token

​

Inicializar

import { Raydium } from "@raydium-io/raydium-sdk-v2";
import { Connection, Keypair, clusterApiUrl } from "@solana/web3.js";

const connection = new Connection(process.env.RPC_URL ?? clusterApiUrl("mainnet-beta"));
const owner      = Keypair.fromSecretKey(/* ... */);

const raydium = await Raydium.load({
  owner,
  connection,
  cluster: "mainnet",           // "mainnet" | "devnet"
  disableFeatureCheck: true,    // omitir la llamada API de detección de características del SDK al inicio
  blockhashCommitment: "confirmed",
});

​

Las fachadas de módulos

raydium.cpmm       // Pools CPMM: createPool, addLiquidity, withdrawLiquidity, swap, ...
raydium.clmm       // Pools CLMM: createPool, openPositionFromBase, increasePositionFromBase,
                   //             decreaseLiquidity, harvestAllRewards, swap, limit orders, ...
raydium.liquidity  // Pools AMM v4: computeAmountOut, swap, addLiquidity, removeLiquidity, ...
raydium.farm       // Farm v3/v5/v6: deposit, withdraw, harvestAllRewards, create,
                   //                restartReward(s), addNewRewardToken(s)
raydium.launchpad  // LaunchLab: createLaunchpad, buyToken, buyTokenExactOut, sellToken,
                   //            claimCreatorFee, constructores de curve-rule y platform-config, ...
raydium.tradeV2    // Enrutamiento multi-pool: descubrimiento de rutas, cómputo, ejecución de rutas
raydium.marketV2   // Creación de mercados OpenBook (heredado)
raydium.utils1216  // Ayudantes puntuales de reclamaciones históricas
raydium.token      // Lista de tokens + metadatos: load(), getTokenInfo()
raydium.account    // Cuentas de token de la billetera, búsqueda y creación de ATA
raydium.api        // El cliente REST (fetchPoolById, getCpmmConfigs, fetchLaunchConfigs, ...)

​

Constructores de transacciones

import { Percent } from "@raydium-io/raydium-sdk-v2";

const { execute, builder, transaction, instructionTypes, signers, extInfo } =
  await raydium.cpmm.addLiquidity({
    poolInfo,
    inputAmount,              // BN — one side, not a pair
    baseIn: true,
    slippage: new Percent(1, 100),   // a Percent, not a number
    txVersion: TxVersion.V0,
  });

• execute — una función de conveniencia que firma + envía. Equivalente a builder.execute.
• builder — la instancia TxBuilder con todas las instrucciones y firmantes acumulados. builder.build() devuelve un TxBuildData cuya transaction es una única Transaction heredada; builder.buildV0() devuelve un TxV0BuildData con una única VersionedTransaction. Solo buildMultiTx / buildMultiTxV0 producen un arreglo.
• transaction — la Transaction / VersionedTransaction construida.
• instructionTypes / signers — las etiquetas de instrucción y el conjunto de firmantes acumulados.
• extInfo — extras específicos del producto. Por ejemplo, cpmm.createPool devuelve extInfo.address.{poolId, lpMint, vaultA, vaultB}; launchpad.createLaunchpad devuelve extInfo.address (un LaunchpadPoolInfo más poolId).

​

¿Por qué constructores asincrónico?

​

Adiciones del módulo CLMM (versión más reciente)

• raydium.clmm.createCustomizablePool — superconjunto de createPool que acepta collectFeeOn y dynamicFeeConfig (la PublicKey de la cuenta de configuración). Suministrar dynamicFeeConfig es lo que habilita las comisiones dinámicas; no hay una bandera enableDynamicFee aparte ni un dynamicFeeConfigId. El createPool clásico continúa funcionando para pools con comisión predeterminada.
• raydium.clmm.openLimitOrder — abre una orden limitada de un solo tick. Toma poolInfo, baseIn (dirección), orderTick, amount y, opcionalmente, tickArrayBitmap, noneIndex, ownerInfo. Usa el ayudante exportado getOrderTick({ baseIn, mintADecimal, mintBDecimal, tickSpacing, price }) para cuantizar el tick.
• raydium.clmm.increaseLimitOrder / decreaseLimitOrder — ajusta la porción no completada de una orden existente. Ambas toman { poolInfo, limitOrder, amount }; decreaseLimitOrder añade un slippage opcional. Disminuir revierte en una orden completamente completada con InvalidOrderPhase.
• raydium.clmm.settleLimitOrder / settleAllLimitOrder — barre la salida completada al ATA del propietario. settleLimitOrder toma solo { limitOrder } — sin poolInfo. Puede llamarla tanto el propietario de la orden como el guardián limit_order_admin del programa.
• raydium.clmm.closeLimitOrder / closeAllLimitOrder — cierra órdenes completamente liquidadas para recuperar renta.
• raydium.api.getClmmDynamicConfigs() — ayudante REST que accede al nuevo punto final /main/clmm-dynamic-config. (No hay ayudante ni punto final de configuración de órdenes limitadas: las órdenes limitadas se indexan por tick, no por una cuenta de configuración por pool.)

​

Escollos comunes

​

1. Desajuste de clúster

​

2. Olvidar pre-crear ATAs

​

3. poolInfo obsoleto

​

4. Comisiones de prioridad

const { execute } = await raydium.cpmm.swap({
  poolInfo,
  baseIn,                    // required: which side inputAmount is denominated in
  inputAmount: new BN(...),
  swapResult: ...,           // required: from CurveCalculator.swapBaseInput/Output
  slippage: 0.005,
  txVersion: TxVersion.V0,
  computeBudgetConfig: {
    units: 250_000,          // Límite de CU
    microLamports: 50_000,   // Comisión de prioridad por CU
  },
});

​

5. La tolerancia de slippage debe coincidir con el tipo de pool

​

6. BN vs number

​

Política de versionado

• @raydium-io/raydium-sdk-v2 es el único SDK que Raydium mantiene. Toda la documentación, demostraciones y orientación de integración lo apuntan.
• Un paquete v1 más antiguo (@raydium-io/raydium-sdk) existe en npm por razones históricas. El mantenimiento terminó después de que CPMM y LaunchLab se enviaran (v1 nunca ganó soporte para ninguno de los dos), y no ha habido versiones v1 desde 2024. Trata v1 como fin de vida: no lo uses para código nuevo, y migra cualquier integración v1 restante a v2.
• El SDK v2 es pre-1.0. Los cambios de ruptura entre versiones menores 0.x son posibles; fija la versión que hayas verificado y consulta las notas de lanzamiento de GitHub al actualizar.

​

Actualizar

1. Re-verifica el tipo de retorno de cada llamada mutante — los cambios de forma (p. ej. extInfo) llegan frecuentemente.
2. Regenera las firmas de obtención de poolInfo — un campo puede haber sido renombrado.
3. Re-verifica tu manejo de slippage; el SDK ha alternado entre comportamientos de límite automático y límite opcional entre versiones.
4. Si usas raydium.tradeV2 (enrutamiento), re-verifica la forma de la ruta — es la parte más inestable de la superficie. Ten en cuenta que la fachada pasó de llamarse trade a tradeV2; el nombre antiguo ya no existe.

​

Obtener ayuda

• Issues de GitHub — presenta en github.com/raydium-io/raydium-sdk-V2/issues para bugs y solicitudes de características. El equipo de Raydium monitorea activamente.
• Discord — canal #dev-support en discord.gg/raydium para ayuda sincrónica.
• Telegram — chat de desarrolladores enlazado desde raydium.io (evita grupos de Telegram no verificados).

​

Referencias

• sdk-api/rest-api — el complemento HTTP del SDK.
• sdk-api/trade-api — transacciones de swap construidas por servidor.
• sdk-api/anchor-idl — regenerando clientes directamente desde IDLs de programa.
• sdk-api/python-integration — equivalente en Python a través de solana-py.
• integration-guides/priority-fee-tuning — dimensionando computeBudgetConfig.

• Fuente de Raydium SDK v2
• Notas de lanzamiento de Raydium SDK.