Skip to main content
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:
Verificar:
O host de instalação mudou. 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:
Esse instalador rastreia sua própria ideia de atual e pode entregar um Anchor diferente daquele que os programas Raydium fixam — verifique anchor --version depois.
Configurar para mainnet:
Para testes do Raydium, você quase sempre vai querer uma carteira devnet financiada:

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):
Operações comuns:

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.
Operações comuns:

Configuração TypeScript

O caminho de integração principal para Raydium.

Pacotes

Versões conhecidas por funcionarem juntas em setembro de 2026:
@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

Veja 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

Construa os programas com cargo build-sbf (a ortografia antiga cargo build-bpf desapareceu).

Cargo.toml do programa para uma integração CPI Raydium

Fixe 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

Versões:
Duas armadilhas de nomenclatura. O cliente RPC é importado como solana mas o projeto é chamado solana-pypip 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

Veja 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:
Algumas operações RPC precisam de capacidades estendidas:
  • 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.
O SDK suporta devnet via cluster: "devnet":
Ressalva: pools devnet têm liquidez fina e podem ter estado obsoleto. Não confie em devnet para descoberta de preço; use-o apenas para construir e testar fluxos de instruções.

Localnet com estado mainnet bifurcado

Para testes realistas, bifurque o estado mainnet em um validador local:
Isso clona estado específico de programa/conta para localhost, onde você pode transacionar livremente. Ideal para:
  • 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.
A equipe Raydium usa localnet bifurcado extensivamente para testes de regressão antes da implantação em mainnet.

Modelos de projeto

Iniciador de integração TypeScript

package.json mínimo:

Iniciador de programa CPI Anchor

Com Anchor 1.0:

Utilitários CLI úteis

solana-keygen

Lendo qualquer conta

Útil para examinar o estado do pool sem um decodificador.

Logs do programa

Inspeção de transação

Ou via explorer — cole a assinatura e procure na aba “Program Logs”.

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.
As chaves nunca devem ser codificadas. Use variáveis de ambiente ou gerenciadores de segredos.

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

Fontes: