Esta página foi traduzida automaticamente por IA. A versão em inglês é a fonte oficial.Ver versão em inglês →
Toda a documentação aqui assume uma cadeia de ferramentas de desenvolvimento Solana funcional. Esta página lista as ferramentas, as versões conhecidas por funcionarem com o Raydium em setembro de 2026, e as armadilhas específicas de configuração. Comece aqui antes de executar qualquer um dos exemplos de código nos capítulos posteriores.Dois conjuntos de versões importam, e não são os mesmos. Para construir ou fazer fork dos programas Raydium você precisa da cadeia de ferramentas exata que eles fixam — Rust 1.91.0, Agave 3.1.10, Anchor 1.0.2 a partir da atualização de 2026-09-09. Para integrar contra os programas implantados a partir de TypeScript ou Python você só precisa de uma biblioteca cliente recente o suficiente para se comunicar com eles, e as fixações são consultivas. Cada seção abaixo diz qual caso ela cobre.
Ferramentas principais
Solana CLI
A interface de linha de comando canônica para interagir com clusters Solana — gerenciamento de carteira, chamadas RPC, implantação de programas. Instalar:O host de instalação mudou. Esse instalador rastreia sua própria ideia de atual e pode entregar um Anchor diferente daquele que os programas Raydium fixam — verifique
release.solana.com pertencia à Solana Labs; o cliente agora é mantido pela Anza como Agave, e as versões são servidas de release.anza.xyz. O binário de auto-atualização é agave-install (solana-install é mantido como um alias legado), então agave-install update e agave-install init <version> são as ortografias atuais. A própria documentação do Solana também oferece um instalador de um comando que puxa a CLI, Rust e Anchor juntos:anchor --version depois.SPL Token CLI
A CLI oficial para operações SPL Token / Token-2022 — criação de mints, cunhagem de tokens, transferências. Instalar (incluído com Solana CLI):Anchor CLI
Necessário para buscar IDLs do Raydium, construir clientes e verificar programas. Instalar:Anchor mudou de repositório e versão principal. O repositório canônico agora é
github.com/solana-foundation/anchor (era coral-xyz/anchor), e Anchor 1.0 é a primeira linha de versão que os programas Raydium usam — CPMM e LaunchLab ambos fixam anchor-lang/anchor-spl =1.0.2 a partir da atualização de 2026-09-09, acima de 0.32.1. avm pode manter várias versões; avm use 1.0.2 é o que faz anchor build reproduzir os artefatos do Raydium. Anchor 1.1 e 1.2 existem e constroem bem para seus próprios programas, mas uma crate CPI compilada contra um anchor-lang menor diferente daquele que o programa alvo fixa não será vinculada — veja sdk-api/rust-cpi.Configuração TypeScript
O caminho de integração principal para Raydium.Pacotes
@coral-xyz/anchor está congelado; o pacote agora é @anchor-lang/core. @coral-xyz/anchor parou em 0.32.1 quando o Anchor saiu da Coral. Anchor 1.x publica como @anchor-lang/core, e os próprios repositórios de programas Raydium mudaram seus conjuntos de testes para ele na atualização de 2026-09-09. As importações que você realmente usa não mudaram — import { Program, BN, AnchorProvider } from "@anchor-lang/core" — então migrar é uma renomeação de pacote mais uma atualização de lockfile.Duas notas comportamentais se você está saindo de 0.3x: .accounts({...}) agora aceita apenas contas que Anchor não pode resolver por si só, então um construtor que passa o conjunto completo deve chamar .accountsPartial({...}) em vez disso; e @anchor-lang/core/dist/cjs/utils/token é onde auxiliares como ASSOCIATED_PROGRAM_ID se mudaram.Script mínimo
sdk-api/typescript-sdk para a referência completa do SDK.
Configuração Rust
Para integração CPI e programas on-chain.Cadeia de ferramentas
cargo build-sbf (a ortografia antiga cargo build-bpf desapareceu).
Cargo.toml do programa para uma integração CPI Raydium
anchor-lang e anchor-spl com = para a versão que o programa alvo fixa. A partir de 2026-09 CPMM fixa =1.0.2 e CLMM ainda fixa =0.32.1, então uma única crate não pode fazer CPI em ambas — veja sdk-api/rust-cpi.
O recurso "cpi" importa o módulo cpi com auxiliares CPI (então você pode raydium_cp_swap::cpi::swap_base_input(...)). Veja sdk-api/rust-cpi.
Configuração Python
Caminho de integração secundário — comum para desenvolvedores de bots.Pacotes
Duas armadilhas de nomenclatura. O cliente RPC é importado como
solana mas o projeto é chamado solana-py — pip install solana-py não instala nada útil. E não há nenhum pacote raydium-py no PyPI: o auxiliar Raydium da comunidade é um repositório que você clona, AL-THE-BOT-FATHER/raydium_py, não uma distribuição publicada. Revisões anteriores desta página listavam uma linha pip install raydium-py que nunca funcionou.Script mínimo
sdk-api/python-integration.
Endpoints RPC
O RPC mainnet público (api.mainnet-beta.solana.com) é muito limitado em taxa e reduz sob qualquer carga. Para uso não trivial, obtenha um endpoint privado:
Configurar:
getProgramAccounts— varreduras irrestritas são caras; alguns provedores restringem ou cobram por varredura.getPriorityFeeEstimate— endpoint específico do Helius; outros têm equivalentes.geyser/ WebSocket streaming — necessário para bots de baixa latência; nem todos os provedores o expõem.
Devnet e localnet
Devnet
Cluster de teste público do Solana. Raydium tem uma implantação devnet parcial:- Alguns pools CPMM existem para testes.
- AMM v4 tem pools devnet históricos.
- CLMM tem alguns pools de demonstração.
- Farm v6 está implantado.
cluster: "devnet":
Localnet com estado mainnet bifurcado
Para testes realistas, bifurque o estado mainnet em um validador local:- Testes unitários de sua integração CPI contra um programa Raydium real.
- Reproduzir uma transação com um parâmetro modificado para depurar.
- Teste de estresse com grandes volumes sintéticos.
Modelos de projeto
Iniciador de integração TypeScript
package.json mínimo:
Iniciador de programa CPI Anchor
Utilitários CLI úteis
solana-keygen
Lendo qualquer conta
Logs do programa
Inspeção de transação
Higiene do ambiente
Carteiras separadas por propósito
- Carteira de desenvolvimento: mantém SOL testnet, usada para construir.
- Carteira de produção: mantém SOL real, usada apenas para implantações / submissões multisig.
- Carteira quente para bots: saldo pequeno, permissões estreitas.
Padrão .env
Fixação de versão
Fixe todas as dependências do ecossistema Solana. O ecossistema se move rápido; um bump de versão menor de@solana/web3.js introduziu anteriormente mudanças quebradas. Use package-lock.json / Cargo.lock religiosamente.
Ponteiros
sdk-api/typescript-sdk— Referência do SDK TypeScript.sdk-api/rust-cpi— Uso de CPI Rust.sdk-api/python-integration— Configuração Python.solana-fundamentals/programs-and-anchor— Contexto Anchor.

