Depositar / retirar liquidez

Deposita tokens en un pool CPMM para recibir tokens LP, o quema tokens LP para retirar tu parte del pool.

---

Obteniendo información del pool

Tanto las operaciones de depósito como de retiro requieren información del pool.

import {
  ApiV3PoolInfoStandardItemCpmm,
  CpmmKeys,
  CREATE_CPMM_POOL_PROGRAM,
  DEVNET_PROGRAM_ID,
} from '@raydium-io/raydium-sdk-v2'
import { initSdk } from '../config'

const VALID_PROGRAM_ID = new Set([
  CREATE_CPMM_POOL_PROGRAM.toBase58(),
  DEVNET_PROGRAM_ID.CREATE_CPMM_POOL_PROGRAM.toBase58(),
])
const isValidCpmm = (id: string) => VALID_PROGRAM_ID.has(id)

let poolInfo: ApiV3PoolInfoStandardItemCpmm
let poolKeys: CpmmKeys | undefined

const raydium = await initSdk()
const poolId = 'YOUR_POOL_ID'

if (raydium.cluster === 'mainnet') {
  const data = await raydium.api.fetchPoolById({ ids: poolId })
  poolInfo = data[0] as ApiV3PoolInfoStandardItemCpmm
  if (!isValidCpmm(poolInfo.programId)) throw new Error('target pool is not CPMM pool')
} else {
  const data = await raydium.cpmm.getPoolInfoFromRpc(poolId)
  poolInfo = data.poolInfo
  poolKeys = data.poolKeys
}

---

Depositando liquidez

Usa raydium.cpmm.addLiquidity() para depositar tokens en un pool. Especificas la cantidad de un token, y el SDK calcula la cantidad requerida del otro token según la proporción actual del pool.

import { Percent } from '@raydium-io/raydium-sdk-v2'
import BN from 'bn.js'
import Decimal from 'decimal.js'

const deposit = async () => {
  const raydium = await initSdk()
  // ... fetch poolInfo and poolKeys as shown above

  const uiInputAmount = '0.0001'
  const inputAmount = new BN(
    new Decimal(uiInputAmount).mul(10 ** poolInfo.mintA.decimals).toFixed(0)
  )
  const slippage = new Percent(1, 100) // 1%
  const baseIn = true // true = inputAmount is for mintA, false = for mintB

  const { execute } = await raydium.cpmm.addLiquidity({
    poolInfo,
    poolKeys,
    inputAmount,
    slippage,
    baseIn,
    txVersion: TxVersion.V0,
    // optional: set up priority fee here
    // computeBudgetConfig: {
    //   units: 600000,
    //   microLamports: 46591500,
    // },
  })

  const { txId } = await execute({ sendAndConfirm: true })
  console.log('pool deposited', { txId: `https://explorer.solana.com/tx/${txId}` })
}

Calculando la cantidad emparejada (opcional)

Antes de depositar, puedes previsualizar la cantidad requerida del otro token para mostrarla en la UI:

const rpcPoolInfos = await raydium.cpmm.getRpcPoolInfos([poolId])
const pool1Info = rpcPoolInfos[poolId]

const computeRes = await raydium.cpmm.computePairAmount({
  baseReserve: pool1Info.baseReserve,
  quoteReserve: pool1Info.quoteReserve,
  poolInfo,
  amount: uiInputAmount,
  slippage,
  baseIn,
  epochInfo: await raydium.fetchEpochInfo(),
})

// computeRes.anotherAmount.amount -> cantidad del token emparejado necesaria
// computeRes.anotherAmount.fee -> comisión de transferencia de Token-2022 (si aplica)

Parámetros de depósito

Parámetro	Tipo	Descripción
poolInfo	object	Información del pool desde la API o RPC.
poolKeys	object	Claves del pool, requeridas para devnet. Opcionales en mainnet (el SDK las deriva).
inputAmount	BN	Cantidad a depositar para el token base o quote, en las unidades más pequeñas.
slippage	Percent	Tolerancia al deslizamiento. new Percent(1, 100) = 1%.
baseIn	boolean	true si inputAmount es para token A, false para token B.
txVersion	TxVersion	Versión de la transacción.

---

Retirando liquidez

Usa raydium.cpmm.withdrawLiquidity() para quemar tokens LP y recibir de vuelta tu parte proporcional de ambos tokens.

import { Percent } from '@raydium-io/raydium-sdk-v2'
import BN from 'bn.js'

const withdraw = async () => {
  const raydium = await initSdk()
  // ... fetch poolInfo and poolKeys as shown above

  const slippage = new Percent(1, 100) // 1%
  const lpAmount = new BN(100) // cantidad de tokens LP a retirar

  const { execute } = await raydium.cpmm.withdrawLiquidity({
    poolInfo,
    poolKeys,
    lpAmount,
    slippage,
    txVersion: TxVersion.V0,
    // optional: set up priority fee here
    // computeBudgetConfig: {
    //   units: 600000,
    //   microLamports: 46591500,
    // },
  })

  const { txId } = await execute({ sendAndConfirm: true })
  console.log('pool withdrawn', { txId: `https://explorer.solana.com/tx/${txId}` })
}

Parámetros de retiro

Parámetro	Tipo	Descripción
poolInfo	object	Información del pool desde la API o RPC.
poolKeys	object	Claves del pool, requeridas para devnet.
lpAmount	BN	Cantidad de tokens LP a quemar, en las unidades más pequeñas.
slippage	Percent	Tolerancia al deslizamiento para las cantidades mínimas de tokens recibidas.
txVersion	TxVersion	Versión de la transacción.

De forma predeterminada, el SDK cierra automáticamente la cuenta wSOL y devuelve SOL nativo. Para mantener abierta la cuenta wSOL, pasa closeWsol: false.