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:El host de instalación se movió. Ese instalador sigue su propia idea de lo actual y puede entregarte un Anchor diferente del que fijan los programas de Raydium — verifica
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:anchor --version después.SPL Token CLI
La CLI oficial para operaciones SPL Token / Token-2022 — crear mints, acuñar tokens, transferir. Instalar (incluido con Solana CLI):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.Configuración de TypeScript
La ruta de integración principal para Raydium.Paquetes
@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
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
cargo build-sbf (la antigua ortografía cargo build-bpf se ha ido).
Program Cargo.toml para una integración CPI de Raydium
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
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
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:
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.
cluster: "devnet":
Localnet con estado de mainnet bifurcado
Para pruebas realistas, bifurca el estado de mainnet en un validador local:- 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.
Plantillas de proyecto
Iniciador de integración TypeScript
package.json mínimo:
Iniciador de programa Anchor CPI
Utilidades CLI útiles
solana-keygen
Leer cualquier cuenta
Registros del programa
Inspección de transacciones
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.
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
sdk-api/typescript-sdk— Referencia del SDK de TypeScript.sdk-api/rust-cpi— Uso de CPI en Rust.sdk-api/python-integration— Configuración de Python.solana-fundamentals/programs-and-anchor— Antecedentes de Anchor.

