Skip to main content
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 que se sabe funcionan 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 bifurcar 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 integrarte 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:
Verificar:
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:
Ese instalador sigue su propia idea de lo actual y puede entregarte un Anchor diferente del que fijan los programas de Raydium — verifica anchor --version después.
Configurar para mainnet:
Para pruebas de Raydium, casi siempre querrás una billetera devnet financiada:

SPL Token CLI

La CLI oficial para operaciones SPL Token / Token-2022 — crear mints, acuñar tokens, transferir. Instalar (incluido con Solana CLI):
Operaciones comunes:

Anchor CLI

Necesario para obtener IDLs de Raydium, construir clientes y verificar programas. Instalar:
Anchor cambió de repositorio y versión mayor. El repositorio canónico es ahora 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, 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 del que fija el programa objetivo no se vinculará — ver sdk-api/rust-cpi.
Operaciones comunes:

Configuración de TypeScript

La ruta de integración principal para Raydium.

Paquetes

Versiones que se sabe funcionan juntas a partir de septiembre de 2026:
@coral-xyz/anchor está congelado; el paquete es ahora @anchor-lang/core. @coral-xyz/anchor se detuvo en 0.32.1 cuando Anchor salió 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 la actualización 2026-09-09. 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

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

Construye los programas con cargo build-sbf (la antigua ortografía cargo build-bpf se ha ido).

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

Fija anchor-lang y anchor-spl con = a la versión que fija el programa objetivo. A partir de 2026-09 CPMM fija =1.0.2 y CLMM aún fija =0.32.1, así que un único crate no puede hacer CPI en ambos — ver sdk-api/rust-cpi. La característica "cpi" importa el módulo cpi con ayudantes CPI (así que 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

Versiones:
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. Las revisiones anteriores de esta página listaban una línea pip install raydium-py que nunca funcionó.

Script mínimo

Ver sdk-api/python-integration.

Puntos finales RPC

El RPC público de mainnet (api.mainnet-beta.solana.com) tiene límite de velocidad muy restrictivo y se ralentiza bajo cualquier carga. Para uso no trivial, obtén un punto final privado: Configurar:
Algunas operaciones RPC necesitan capacidades extendidas:
  • getProgramAccounts — los escaneos sin restricciones son costosos; algunos proveedores 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

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.
El SDK soporta devnet a través de 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:
Esto clona el estado específico del 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

package.json mínimo:

Iniciador de programa Anchor CPI

Con Anchor 1.0:

Utilidades CLI útiles

solana-keygen

Leer cualquier cuenta

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

Registros del programa

Inspección de transacciones

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

Higiene del entorno

Billeteras separadas por propósito

  • Billetera de desarrollo: contiene SOL de testnet, se usa para construir.
  • Billetera de producción: contiene SOL real, se usa solo para despliegues / envíos multisig.
  • Billetera 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

Fijación de versiones

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

Referencias

Fuentes: