Cadena de herramientas

Configuración mínima funcional para leer el estado en cadena de Raydium, construir transacciones y desarrollar contra los programas. Solana CLI, Anchor, SDKs en TypeScript y Python, y consejos para devnet/localnet.

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 →

Toda la documentación aquí asume una cadena de herramientas de desarrollo Solana funcional. Esta página lista las herramientas, las versiones conocidas por funcionar con Raydium a partir de septiembre de 2026, y los problemas específicos de configuración. Comienza aquí antes de ejecutar cualquiera de los ejemplos de código en capítulos posteriores.

Dos conjuntos de versiones importan, y no son iguales. Para construir o hacer fork de los programas de Raydium necesitas la cadena de herramientas exacta que fijan — Rust 1.91.0, Agave 3.1.10, Anchor 1.0.2 a partir de la actualización 2026-09-09. Para integrar contra los programas desplegados desde TypeScript o Python solo necesitas una biblioteca cliente lo suficientemente reciente para hablar con ellos, y los pines son recomendaciones. Cada sección a continuación dice cuál es el caso.

​

Herramientas principales

​

Solana CLI

La interfaz de línea de comandos canónica para interactuar con clústeres Solana — gestión de billeteras, llamadas RPC, despliegue de programas.

Instalar:

# La versión contra la que se construyen y prueban los programas de Raydium
sh -c "$(curl -sSfL https://release.anza.xyz/v3.1.10/install)"

# O seguir un canal en lugar de una etiqueta
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

Verificar:

solana --version   # → solana-cli 3.1.10 (... client:Agave)

El host de instalación se movió. release.solana.com pertenecía a Solana Labs; el cliente ahora es mantenido por Anza como Agave, y los lanzamientos se sirven desde release.anza.xyz. El binario de auto-actualización es agave-install (solana-install se mantiene como un alias heredado), así que agave-install update y agave-install init <version> son los nombres actuales. La propia documentación de Solana también ofrece un instalador de un comando que extrae CLI, Rust y Anchor juntos:

curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash

Ese instalador sigue su propia idea de lo actual y puede entregarte un Anchor diferente al que fijan los programas de Raydium — verifica anchor --version después.

Configurar para mainnet:

solana config set --url https://api.mainnet-beta.solana.com
solana config set --keypair ~/.config/solana/id.json
solana-keygen new                           # crear una billetera si no tienes una
solana address                              # tu clave pública

Para pruebas de Raydium, casi siempre querrás una billetera devnet financiada:

solana config set --url https://api.devnet.solana.com
solana airdrop 2                            # 2 SOL para pruebas

​

SPL Token CLI

La CLI oficial para operaciones SPL Token / Token-2022 — crear mints, acuñar tokens, transferir.

Instalar (incluido con Solana CLI):

spl-token --version

Operaciones comunes:

spl-token create-token                                  # crear un mint SPL Token
spl-token create-token --program-id TOKEN_2022 ...      # crear un mint Token-2022
spl-token create-account <MINT>                         # crear un ATA
spl-token mint <MINT> 1000                              # acuñar 1000 tokens en tu ATA
spl-token transfer <MINT> 100 <RECIPIENT>               # transferir 100
spl-token display <ACCOUNT_OR_MINT>                     # inspeccionar

​

Anchor CLI

Necesario para obtener IDLs de Raydium, construir clientes y verificar programas.

Instalar:

cargo install --git https://github.com/solana-foundation/anchor avm --locked --force
avm install 1.0.2
avm use 1.0.2
anchor --version   # → anchor-cli 1.0.2

Anchor cambió de repositorio y versión mayor. El repositorio canónico ahora es github.com/solana-foundation/anchor (era coral-xyz/anchor), y Anchor 1.0 es la primera línea de lanzamiento que usan los programas de Raydium — CPMM y LaunchLab ambos fijan anchor-lang/anchor-spl =1.0.2 a partir de la actualización 2026-09-09, y CLMM sigue en la actualización 2026-09-30, todos subiendo desde 0.32.1. avm puede mantener varias versiones; avm use 1.0.2 es lo que hace que anchor build reproduzca los artefactos de Raydium. Anchor 1.1 y 1.2 existen y se construyen bien para tus propios programas, pero un crate CPI compilado contra un anchor-lang menor diferente al que fija el programa objetivo no se vinculará — ver sdk-api/rust-cpi.

Operaciones comunes:

anchor idl fetch <PROGRAM_ID> -o program.idl.json       # obtener el IDL en cadena
anchor idl init -f idl.json <PROGRAM_ID>                # subir un IDL
anchor build                                             # construir un programa desde la fuente

​

Configuración de TypeScript

La ruta de integración principal para Raydium.

​

Paquetes

npm install \
  @solana/web3.js \
  @solana/spl-token \
  @anchor-lang/core \
  @raydium-io/raydium-sdk-v2 \
  bn.js \
  decimal.js

Versiones conocidas por funcionar juntas a partir de septiembre de 2026:

Paquete	Versión	Nota
@solana/web3.js	^1.95	La API 1.x. 2.x / 3.x son una superficie de API diferente e incompatible; el SDK de Raydium apunta a 1.x.
@solana/spl-token	^0.4.15	0.4.15 es lo que expone createUnwrapLamportsInstruction — ver renta reclamable.
@anchor-lang/core	^1.0 (actualmente se resuelve a 1.2.0)	El cliente TypeScript de Anchor 1.x. Los propios repositorios de Raydium fijan exactamente 1.0.2; para uso del lado del cliente cualquier 1.x funciona, pero fija 1.0.2 si quieres coincidir con sus suites de prueba.
@raydium-io/raydium-sdk-v2	0.2.64-alpha	El pin que usa cada demostración de código en estos documentos.

@coral-xyz/anchor está congelado; el paquete ahora es @anchor-lang/core. @coral-xyz/anchor se detuvo en 0.32.1 cuando Anchor se movió fuera de Coral. Anchor 1.x se publica como @anchor-lang/core, y los propios repositorios de programas de Raydium cambiaron sus suites de prueba a él en las actualizaciones 2026-09-09 (CLMM en 2026-09-30). Las importaciones que realmente usas no cambian — import { Program, BN, AnchorProvider } from "@anchor-lang/core" — así que migrar es un cambio de nombre de paquete más una actualización de lockfile.

Dos notas de comportamiento si te estás moviendo desde 0.3x: .accounts({...}) ahora solo acepta cuentas que Anchor no puede resolver por sí mismo, así que un constructor que pasa el conjunto completo debe llamar a .accountsPartial({...}) en su lugar; y @anchor-lang/core/dist/cjs/utils/token es donde se movieron ayudantes como ASSOCIATED_PROGRAM_ID.

​

Script mínimo

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

const connection = new Connection("https://api.mainnet-beta.solana.com", "confirmed");
const owner      = Keypair.fromSecretKey(/* your key */);

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

// `ids` es una lista separada por comas, y la llamada devuelve un array
const [poolInfo] = await raydium.api.fetchPoolById({ ids: "..." });
console.log(poolInfo);

Ver sdk-api/typescript-sdk para la referencia completa del SDK.

​

Configuración de Rust

Para integración CPI y programas en cadena.

​

Cadena de herramientas

rustup install 1.91.0           # lo que fijan los programas de Raydium
rustup default 1.91.0
rustup component add rustfmt clippy
agave-install init 3.1.10       # cadena de herramientas SBF incluida

Construye los programas con cargo build-sbf (el antiguo nombre cargo build-bpf se ha ido).

​

Cargo.toml de programa para una integración CPI de Raydium

# Integración CPMM y/o CLMM (Anchor 1.0) — un crate puede tomar ambos
[dependencies]
anchor-lang     = "=1.0.2"
anchor-spl      = "=1.0.2"
raydium-cp-swap = { git = "https://github.com/raydium-io/raydium-cp-swap", branch = "master", features = ["cpi"] }
raydium-clmm    = { git = "https://github.com/raydium-io/raydium-clmm",    branch = "master", features = ["cpi"] }

Fija anchor-lang y anchor-spl con = a la versión que fija el programa objetivo. En master, CPMM y CLMM ambos fijan =1.0.2, así que un único crate puede hacer CPI en ambos. Un crate que mezcla uno de ellos con un rev de antes de su actualización a Anchor 1.0 no se construirá. Ver sdk-api/rust-cpi.

La característica "cpi" importa el módulo cpi con ayudantes CPI (así puedes raydium_cp_swap::cpi::swap_base_input(...)). Ver sdk-api/rust-cpi.

​

Configuración de Python

Ruta de integración secundaria — común para desarrolladores de bots.

​

Paquetes

pip install solders solana anchorpy

Versiones:

Paquete	Nombre en PyPI	Versión
solders	solders	≥0.29
solana-py	solana	≥0.40
anchorpy	anchorpy	≥0.21

Dos trampas de nomenclatura. El cliente RPC se importa como solana pero el proyecto se llama solana-py — pip install solana-py no instala nada útil. Y no hay paquete raydium-py en PyPI: el ayudante comunitario de Raydium es un repositorio que clonas, AL-THE-BOT-FATHER/raydium_py, no una distribución publicada. Revisiones anteriores de esta página listaban una línea pip install raydium-py que nunca funcionó.

​

Script mínimo

from solana.rpc.async_api import AsyncClient
from solders.keypair import Keypair
from anchorpy import Provider, Wallet, Program

async def main():
    conn = AsyncClient("https://api.mainnet-beta.solana.com")
    owner = Keypair()
    wallet = Wallet(owner)
    provider = Provider(conn, wallet)

    # Cargar IDL y programa
    with open("cpmm.idl.json") as f:
        idl = json.load(f)
    program = Program(idl, CPMM_PROGRAM_ID, provider)

    pool = await program.account["PoolState"].fetch(pool_id)
    print(pool)

Ver sdk-api/python-integration.

​

Puntos finales RPC

El RPC público de mainnet (api.mainnet-beta.solana.com) está muy limitado en velocidad y se ralentiza bajo cualquier carga. Para uso no trivial, obtén un punto final privado:

Proveedor	Notas
Helius	El más popular; nivel gratuito generoso.
Triton	Empresarial; precios premium, estable.
QuickNode	Sólido; latencia sub-por-segundo.
Tu propio nodo RPC	Cuesta ~$500/mes en hardware; control total.

Configurar:

const connection = new Connection("https://mainnet.helius-rpc.com/?api-key=...");

Algunas operaciones RPC necesitan capacidades extendidas:

• getProgramAccounts — los escaneos sin restricciones son costosos; algunos proveedores los cierran o cobran por escaneo.
• getPriorityFeeEstimate — punto final específico de Helius; otros tienen equivalentes.
• geyser / transmisión WebSocket — necesario para bots de baja latencia; no todos los proveedores lo exponen.

​

Devnet y localnet

​

Devnet

El clúster de prueba público de Solana. Raydium tiene un despliegue parcial en devnet:

• Algunos pools CPMM existen para pruebas.
• AMM v4 tiene pools históricos de devnet.
• CLMM tiene algunos pools de demostración.
• Farm v6 está desplegado.

solana config set --url https://api.devnet.solana.com
solana airdrop 2

El SDK soporta devnet a través de cluster: "devnet":

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

Advertencia: los pools de devnet tienen liquidez delgada y pueden tener estado obsoleto. No confíes en devnet para descubrimiento de precios; úsalo solo para construir y probar flujos de instrucciones.

​

Localnet con estado de mainnet bifurcado

Para pruebas realistas, bifurca el estado de mainnet en un validador local:

solana-test-validator \
  --url https://api.mainnet-beta.solana.com \
  --clone CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C \
  --clone CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK \
  --clone <SOME_POOL_ID> \
  --clone <SOME_MINT_ID>

Esto clona el estado específico de programa/cuenta a localhost, donde puedes transaccionar libremente. Ideal para:

• Pruebas unitarias de tu integración CPI contra un programa Raydium real.
• Reproducir una transacción con un parámetro modificado para depurar.
• Pruebas de estrés con grandes volúmenes sintéticos.

El equipo de Raydium usa localnet bifurcado extensamente para pruebas de regresión antes del despliegue en mainnet.

​

Plantillas de proyecto

​

Iniciador de integración TypeScript

my-raydium-app/
├── package.json
├── tsconfig.json
├── src/
│   ├── swap.ts           # ejemplo de swap
│   ├── add-liquidity.ts
│   └── read-pool.ts
└── .env                  # URL de RPC, ruta de wallet

package.json mínimo:

{
  "name": "my-raydium-app",
  "type": "module",
  "scripts": { "swap": "tsx src/swap.ts" },
  "dependencies": {
    "@raydium-io/raydium-sdk-v2": "0.2.64-alpha",
    "@solana/web3.js": "^1.95",
    "@solana/spl-token": "^0.4.15"
  },
  "devDependencies": {
    "@types/node": "^20",
    "tsx": "^4",
    "typescript": "^5"
  }
}

​

Iniciador de programa Anchor CPI

my-raydium-cpi/
├── Anchor.toml
├── Cargo.toml
├── programs/
│   └── my-cpi/
│       ├── Cargo.toml
│       └── src/lib.rs
└── tests/
    └── my-cpi.ts

Con Anchor 1.0:

anchor init my-raydium-cpi
cd my-raydium-cpi
# agregar raydium-cp-swap a Cargo.toml con features = ["cpi"]
anchor build
anchor test

​

Utilidades CLI útiles

​

solana-keygen

solana-keygen new --outfile ./wallet.json          # generar una clave
solana-keygen pubkey ./wallet.json                 # mostrar clave pública

​

Leer cualquier cuenta

solana account <ADDRESS> --output json-compact

Útil para inspeccionar el estado del pool sin un decodificador.

​

Registros de programa

solana logs | grep CPMMoo8                         # seguir logs de tx relacionados con CPMM

​

Inspección de transacciones

solana confirm <TX_SIGNATURE> -v                   # imprime logs con formato

O a través del explorador — pega la firma y mira la pestaña “Program Logs”.

​

Higiene del entorno

​

Wallets separadas por propósito

• Wallet de desarrollo: contiene SOL de testnet, se usa para construir.
• Wallet de producción: contiene SOL real, se usa solo para deploys / envíos de multisig.
• Wallet activa para bots: saldo pequeño, permisos limitados.

Las claves nunca deben estar codificadas. Usa variables de entorno o gestores de secretos.

​

Patrón .env

# .env (no comprometido)
SOLANA_RPC_URL=https://mainnet.helius-rpc.com/?api-key=...
WALLET_PATH=/Users/you/.config/solana/id.json

import { config } from "dotenv";
config();

const connection = new Connection(process.env.SOLANA_RPC_URL!);

​

Fijación de versiones

Fija todas las dependencias del ecosistema Solana. El ecosistema se mueve rápido; un cambio de versión menor de @solana/web3.js ha introducido cambios incompatibles anteriormente. Usa package-lock.json / Cargo.lock religiosamente.

​

Referencias

• sdk-api/typescript-sdk — Referencia del SDK de TypeScript.
• sdk-api/rust-cpi — Uso de Rust CPI.
• sdk-api/python-integration — Configuración de Python.
• solana-fundamentals/programs-and-anchor — Antecedentes de Anchor.

Fuentes:

• Documentación de instalación de Solana e instalación de Agave CLI.
• Instalación de Anchor.
• Repositorio de Raydium SDK v2.