Skip to main content
Diese Seite wurde mit KI automatisch übersetzt. Maßgeblich ist stets die englische Version.Englische Version ansehen →
Die gesamte Dokumentation setzt eine funktionierende Solana-Entwicklungs-Toolchain voraus. Diese Seite listet die Tools, die Versionen, die mit Raydium ab September 2026 funktionieren, und spezifische Setup-Besonderheiten auf. Beginnen Sie hier, bevor Sie die Code-Beispiele in späteren Kapiteln ausführen.Zwei Versionsgruppen sind relevant, und sie sind nicht identisch. Um die Raydium-Programme zu bauen oder zu forken, benötigen Sie die exakte Toolchain, die sie festlegen — Rust 1.91.0, Agave 3.1.10, Anchor 1.0.2 ab dem Update vom 2026-09-09. Um von TypeScript oder Python aus gegen die bereitgestellten Programme zu integrieren, benötigen Sie nur eine Client-Bibliothek, die neu genug ist, um mit ihnen zu kommunizieren, und die Festlegungen sind empfehlend. Jeder Abschnitt unten gibt an, welcher Fall zutrifft.

Kern-Tools

Solana CLI

Die kanonische Befehlszeilenschnittstelle für die Interaktion mit Solana-Clustern — Wallet-Verwaltung, RPC-Aufrufe, Programm-Bereitstellung. Installation:
Überprüfung:
Der Installations-Host hat sich geändert. release.solana.com gehörte zu Solana Labs; der Client wird jetzt von Anza als Agave gepflegt, und Releases werden von release.anza.xyz bereitgestellt. Die Self-Update-Binärdatei ist agave-install (solana-install wird als Legacy-Alias beibehalten), daher sind agave-install update und agave-install init <version> die aktuellen Schreibweisen. Solanas eigene Dokumentation bietet auch ein One-Command-Installer, das die CLI, Rust und Anchor zusammen abruft:
Dieser Installer verfolgt seine eigene Vorstellung von aktuell und kann Ihnen einen anderen Anchor als den, den die Raydium-Programme festlegen, geben — überprüfen Sie danach anchor --version.
Konfiguration für Mainnet:
Für Raydium-Tests benötigen Sie fast immer ein finanziertes Devnet-Wallet:

SPL Token CLI

Die offizielle CLI für SPL Token / Token-2022-Operationen — Erstellen von Mints, Prägen von Tokens, Übertragungen. Installation (in Solana CLI enthalten):
Häufige Operationen:

Anchor CLI

Erforderlich zum Abrufen von Raydium IDLs, zum Erstellen von Clients und zum Überprüfen von Programmen. Installation:
Anchor hat das Repository und die Hauptversion gewechselt. Das kanonische Repository ist jetzt github.com/solana-foundation/anchor (es war coral-xyz/anchor), und Anchor 1.0 ist die erste Release-Linie, die die Raydium-Programme verwenden — CPMM und LaunchLab legen beide anchor-lang/anchor-spl =1.0.2 ab dem Update vom 2026-09-09 fest, aufwärts von 0.32.1. avm kann mehrere Versionen halten; avm use 1.0.2 ist das, was anchor build dazu bringt, Raydiums Artefakte zu reproduzieren. Anchor 1.1 und 1.2 existieren und bauen sich gut für Ihre eigenen Programme, aber eine CPI-Crate, die gegen eine andere anchor-lang-Nebenversion als die, die das Ziel-Programm festlegt, kompiliert wurde, wird nicht verlinkt — siehe sdk-api/rust-cpi.
Häufige Operationen:

TypeScript-Setup

Der primäre Integrationspfad für Raydium.

Pakete

Versionen, die ab September 2026 zusammen funktionieren:
@coral-xyz/anchor ist eingefroren; das Paket ist jetzt @anchor-lang/core. @coral-xyz/anchor stoppte bei 0.32.1, als Anchor Coral verließ. Anchor 1.x wird als @anchor-lang/core veröffentlicht, und Raydiums eigene Programm-Repositories wechselten ihre Test-Suites im Upgrade vom 2026-09-09 dazu. Die Importe, die Sie tatsächlich verwenden, sind unverändert — import { Program, BN, AnchorProvider } from "@anchor-lang/core" — daher ist die Migration eine Paket-Umbenennung plus ein Lockfile-Update.Zwei Verhaltenshinweise, wenn Sie von 0.3x wechseln: .accounts({...}) akzeptiert jetzt nur noch Konten, die Anchor nicht selbst auflösen kann, daher sollte ein Builder, der den vollständigen Satz übergibt, stattdessen .accountsPartial({...}) aufrufen; und @anchor-lang/core/dist/cjs/utils/token ist, wohin Helfer wie ASSOCIATED_PROGRAM_ID verschoben wurden.

Minimales Skript

Siehe sdk-api/typescript-sdk für die vollständige SDK-Referenz.

Rust-Setup

Für CPI-Integration und On-Chain-Programme.

Toolchain

Bauen Sie die Programme mit cargo build-sbf (die alte cargo build-bpf-Schreibweise ist weg).

Program Cargo.toml für eine Raydium CPI-Integration

Legen Sie anchor-lang und anchor-spl mit = auf die Version fest, die das Ziel-Programm festlegt. Ab 2026-09 legt CPMM =1.0.2 fest und CLMM legt immer noch =0.32.1 fest, daher kann eine einzelne Crate nicht in beide CPI-Aufrufe durchführen — siehe sdk-api/rust-cpi. Das "cpi"-Feature importiert das cpi-Modul mit CPI-Helfern (damit Sie raydium_cp_swap::cpi::swap_base_input(...) aufrufen können). Siehe sdk-api/rust-cpi.

Python-Setup

Sekundärer Integrationspfad — häufig für Bot-Entwickler.

Pakete

Versionen:
Zwei Benennungsfallen. Der RPC-Client wird als solana importiert, aber das Projekt heißt solana-py — pip install solana-py installiert nichts Nützliches. Und es gibt kein raydium-py-Paket auf PyPI: der Community-Raydium-Helfer ist ein Repository, das Sie klonen, AL-THE-BOT-FATHER/raydium_py, keine veröffentlichte Distribution. Frühere Versionen dieser Seite listeten eine pip install raydium-py-Zeile auf, die nie funktionierte.

Minimales Skript

Siehe sdk-api/python-integration.

RPC-Endpunkte

Öffentliches Mainnet RPC (api.mainnet-beta.solana.com) ist stark ratenbegrenzt und drosselt unter jeder Last. Für nicht-triviale Nutzung erhalten Sie einen privaten Endpunkt: Konfiguration:
Einige RPC-Operationen benötigen erweiterte Funktionen:
  • getProgramAccounts — uneingeschränkte Scans sind teuer; einige Anbieter sperren oder berechnen pro Scan.
  • getPriorityFeeEstimate — Helius-spezifischer Endpunkt; andere haben Äquivalente.
  • geyser / WebSocket-Streaming — erforderlich für Low-Latency-Bots; nicht alle Anbieter stellen es bereit.

Devnet und Localnet

Devnet

Solanas öffentlicher Test-Cluster. Raydium hat eine teilweise Devnet-Bereitstellung:
  • Einige CPMM-Pools existieren zum Testen.
  • AMM v4 hat historische Devnet-Pools.
  • CLMM hat ein paar Demo-Pools.
  • Farm v6 ist bereitgestellt.
Das SDK unterstützt Devnet über cluster: "devnet":
Vorsicht: Devnet-Pools haben dünne Liquidität und können veraltete Zustände haben. Verlassen Sie sich nicht auf Devnet für Preiserkennung; verwenden Sie es nur zum Erstellen und Testen von Anweisungsflüssen.

Localnet mit gegabeltem Mainnet-Status

Für realistisches Testen, gabeln Sie Mainnet-Status in einen lokalen Validator:
Dies klont spezifischen Programm-/Kontostatus zu Localhost, wo Sie frei transagieren können. Ideal für:
  • Unit-Tests Ihrer CPI-Integration gegen ein echtes Raydium-Programm.
  • Wiedergabe einer Transaktion mit einem geänderten Parameter zum Debuggen.
  • Stress-Tests mit großen synthetischen Volumen.
Raydiums Team verwendet gegabeltes Localnet umfangreich für Regressionstests vor der Mainnet-Bereitstellung.

Projekt-Templates

TypeScript-Integrations-Starter

Minimale package.json:

Anchor CPI-Programm-Starter

Mit Anchor 1.0:

Nützliche CLI-Dienstprogramme

solana-keygen

Beliebigen Konto lesen

Nützlich zum Überprüfen des Pool-Status ohne Decoder.

Programm-Logs

Transaktions-Inspektion

Oder über Explorer — fügen Sie die Signatur ein und schauen Sie sich die Registerkarte „Program Logs” an.

Umgebungs-Hygiene

Separate Wallets pro Zweck

  • Entwicklungs-Wallet: hält Testnet SOL, wird zum Bauen verwendet.
  • Produktions-Wallet: hält echte SOL, wird nur für Bereitstellungen / Multisig-Einreichungen verwendet.
  • Hot Wallet für Bots: kleines Guthaben, enge Berechtigungen.
Schlüssel sollten niemals hartcodiert sein. Verwenden Sie Umgebungsvariablen oder Secret Manager.

.env-Muster

Versions-Pinning

Sperren Sie alle Solana-Ökosystem-Abhängigkeiten. Das Ökosystem bewegt sich schnell; ein Minor-Version-Bump von @solana/web3.js hat zuvor Breaking Changes eingeführt. Verwenden Sie package-lock.json / Cargo.lock gewissenhaft.

Verweise

Quellen: