Bloquear liquidez / cobrar comisiones

Bloquea tokens LP de forma permanente usando el programa Burn & Earn y recoge tu parte de las comisiones de trading a través de un Fee Key NFT.

---

Cómo funciona

Cuando bloqueas tokens LP:

1. Tus tokens LP se transfieren al programa locker de Burn & Earn — no pueden retirarse.

2. Recibes un Fee Key NFT que representa tu posición bloqueada.

3. El Fee Key NFT te da derecho a reclamar las comisiones de trading que se han acumulado en el pool.

Cómo funciona la recolección de fees por debajo del capó

En un pool de producto constante, las fees no se almacenan por separado — se acumulan en las vaults del pool, haciendo que cada token LP valga con el tiempo más tokens subyacentes. La única forma de extraer ese valor acumulado es canjear (burn) tokens LP.

Cuando recolectas desde una posición bloqueada:

1. Tu posición bloqueada tiene, por ejemplo, 1000 LP tokens.

2. Se producen swaps, las fees fluyen hacia las vaults del pool y cada token LP se aprecia en valor.

3. Llamas a harvestLockLp con un lpFeeAmount (por ejemplo, 5 LP).

4. El programa locker quema esos 5 LP mediante un withdraw en el programa CPMM.

5. Recibes en tu wallet la parte proporcional de token A + token B.

6. Tu posición bloqueada ahora tiene 995 LP tokens.

El saldo de LP sí disminuye con cada recolección. Sin embargo, los 995 tokens LP restantes valen aproximadamente lo mismo que los 1000 originales antes de que se acumularan las fees, porque cada token LP ahora vale más. Estás extrayendo la apreciación, no el principal.

El lpFeeAmount parámetro controla cuánto LP se quema.

---

Bloquear tokens LP

Usa raydium.cpmm.lockLp() para bloquear permanentemente tokens LP y recibir un Fee Key NFT.

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

const lockLiquidity = async () => {
  const raydium = await initSdk()
  const poolId = 'YOUR_POOL_ID'

  let poolInfo: ApiV3PoolInfoStandardItemCpmm
  let poolKeys: CpmmKeys | undefined

  if (raydium.cluster === 'mainnet') {
    const data = await raydium.api.fetchPoolById({ ids: poolId })
    poolInfo = data[0] as ApiV3PoolInfoStandardItemCpmm
  } else {
    const data = await raydium.cpmm.getPoolInfoFromRpc(poolId)
    poolInfo = data.poolInfo
    poolKeys = data.poolKeys
  }

  // Obtener las cuentas de tokens de la wallet para obtener el saldo de LP
  await raydium.account.fetchWalletTokenAccounts()
  const lpBalance = raydium.account.tokenAccounts.find(
    (a) => a.mint.toBase58() === poolInfo.lpMint.address
  )
  if (!lpBalance) throw new Error(`no LP balance for pool: ${poolId}`)

  const { execute, extInfo } = await raydium.cpmm.lockLp({
    // devnet: programId: DEVNET_PROGRAM_ID.LOCK_CPMM_PROGRAM
    // devnet: authProgram: DEVNET_PROGRAM_ID.LOCK_CPMM_AUTH
    // devnet: poolKeys
    poolInfo,
    lpAmount: lpBalance.amount,
    withMetadata: true,
    txVersion: TxVersion.V0,
  })

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

lockLiquidity()

Parámetros de bloqueo

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 bloquear, en las unidades más pequeñas.
withMetadata	boolean	Si true, crea metadata on-chain para el Fee Key NFT.
programId	PublicKey	Programa locker. El valor predeterminado en mainnet se resuelve automáticamente. Devnet: DEVNET_PROGRAM_ID.LOCK_CPMM_PROGRAM.
authProgram	PublicKey	Programa de auth del locker. Devnet: DEVNET_PROGRAM_ID.LOCK_CPMM_AUTH.
txVersion	TxVersion	Versión de la transacción.

El bloqueo es permanente. Una vez bloqueados, los tokens LP no pueden retirarse. Solo las fees de trading pueden cobrarse mediante el Fee Key NFT.

---

Cobro de fees desde liquidez bloqueada

Usa raydium.cpmm.harvestLockLp() para reclamar las fees de trading acumuladas de una posición LP bloqueada usando la dirección mint del Fee Key NFT.

import { PublicKey } from '@solana/web3.js'
import BN from 'bn.js'

const harvestLockLiquidity = async () => {
  const raydium = await initSdk()
  const poolId = 'YOUR_POOL_ID'

  let poolInfo: ApiV3PoolInfoStandardItemCpmm
  let poolKeys: CpmmKeys | undefined

  if (raydium.cluster === 'mainnet') {
    const data = await raydium.api.fetchPoolById({ ids: poolId })
    poolInfo = data[0] as ApiV3PoolInfoStandardItemCpmm
  } else {
    const data = await raydium.cpmm.getPoolInfoFromRpc(poolId)
    poolInfo = data.poolInfo
    poolKeys = data.poolKeys
  }

  const { execute } = await raydium.cpmm.harvestLockLp({
    // devnet: programId: DEVNET_PROGRAM_ID.LOCK_CPMM_PROGRAM
    // devnet: authProgram: DEVNET_PROGRAM_ID.LOCK_CPMM_AUTH
    // devnet: poolKeys
    poolInfo,
    nftMint: new PublicKey('YOUR_FEE_KEY_NFT_MINT'),
    lpFeeAmount: new BN(99999999),
    txVersion: TxVersion.V0,
    // closeWsol: false, // default true — set false to keep wSOL account
  })

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

harvestLockLiquidity()

Parámetros de recolección

Parámetro	Tipo	Descripción
poolInfo	object	Información del pool desde la API o RPC.
poolKeys	object	Claves del pool. Requeridas para devnet.
nftMint	PublicKey	Dirección mint del Fee Key NFT recibido al bloquear.
lpFeeAmount	BN	Cantidad de tokens LP a quemar desde la posición bloqueada. Así es como extraes el valor acumulado de las fees — consulta "Cómo funciona la recolección de fees" arriba.
closeWsol	boolean	Predeterminado true. Cierra la cuenta wSOL y devuelve SOL nativo. Establece false para conservar wSOL.
txVersion	TxVersion	Versión de la transacción.

---

Cobro de creator fees

Las creator fees son una fee separada por swap pagada al creador del pool. Solo están disponibles en pools creados mediante la ruta con permiso (createPoolWithPermission), que requiere un Permission PDA del administrador de Raydium. Los pools creados con la función estándar createPool() tienen las creator fees deshabilitadas a nivel de programa — consulta Crear un pool para más detalles.

Si tu pool fue creado con permiso y la configuración de fees incluye un valor distinto de cero en creator_fee_rate, puedes cobrar las creator fees acumuladas.

Pool único

const collectCreatorFee = async () => {
  const raydium = await initSdk()
  // ... obtener poolInfo y poolKeys

  const { execute } = await raydium.cpmm.collectCreatorFees({
    poolInfo,
    poolKeys,
    txVersion: TxVersion.V0,
  })

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

Varios pools a la vez

import {
  CREATE_CPMM_POOL_PROGRAM,
  DEVNET_PROGRAM_ID,
} from '@raydium-io/raydium-sdk-v2'

const collectAllCreatorFees = async () => {
  const raydium = await initSdk()
  const isDevnet = raydium.cluster === 'devnet'

  const host = isDevnet
    ? 'https://temp-api-v1-devnet.raydium.io'
    : 'https://temp-api-v1.raydium.io'

  // Obtener todos los pools en los que la wallet conectada tiene creator fees pendientes
  const res = await fetch(
    `${host}/cp-creator-fee?wallet=${raydium.ownerPubKey.toBase58()}`
  )
  const { data } = await res.json()

  const poolsWithFees = data.filter(
    (d: any) => d.fee.amountA !== '0' || d.fee.amountB !== '0'
  )

  if (!poolsWithFees.length) {
    console.log('no pending creator fees')
    return
  }

  const { execute } = await raydium.cpmm.collectMultiCreatorFees({
    poolInfoList: poolsWithFees.map((d: any) => d.poolInfo),
    programId: isDevnet
      ? DEVNET_PROGRAM_ID.CREATE_CPMM_POOL_PROGRAM
      : CREATE_CPMM_POOL_PROGRAM,
    txVersion: TxVersion.V0,
  })

  const sentInfo = await execute({ sequentially: true })
  console.log('creator fees collected', sentInfo)
}