Toolchain

Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.Lihat versi bahasa Inggris →

Dokumentasi ini mengasumsikan Anda memiliki toolchain pengembangan Solana yang berfungsi. Halaman ini mencantumkan alat-alat, versi yang diketahui bekerja dengan Raydium per September 2026, dan gotcha setup spesifik. Mulai dari sini sebelum menjalankan contoh kode di bab-bab berikutnya. Dua set versi penting, dan keduanya tidak sama. Untuk membangun atau fork program Raydium Anda memerlukan toolchain yang tepat sesuai pin mereka — Rust 1.91.0, Agave 3.1.10, Anchor 1.0.2 per upgrade 2026-09-09. Untuk mengintegrasikan terhadap program yang sudah di-deploy dari TypeScript atau Python Anda hanya memerlukan library klien yang cukup baru untuk berkomunikasi dengan mereka, dan pin bersifat advisory. Setiap bagian di bawah menjelaskan kasus mana yang dicakup.

Alat inti

Solana CLI

Antarmuka command-line kanonik untuk berinteraksi dengan cluster Solana — manajemen wallet, panggilan RPC, deployment program. Instalasi:

# Versi yang digunakan program Raydium untuk dibangun dan diuji
sh -c "$(curl -sSfL https://release.anza.xyz/v3.1.10/install)"

# Atau ikuti channel daripada tag
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

Verifikasi:

solana --version   # → solana-cli 3.1.10 (... client:Agave)

Host instalasi telah pindah. release.solana.com milik Solana Labs; klien sekarang dikelola oleh Anza sebagai Agave, dan rilis disajikan dari release.anza.xyz. Binary self-update adalah agave-install (solana-install dipertahankan sebagai alias legacy), jadi agave-install update dan agave-install init <version> adalah ejaan saat ini. Dokumen Solana sendiri juga menawarkan installer satu perintah yang menarik CLI, Rust dan Anchor bersama-sama:

curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash

Installer itu melacak ide sendiri tentang versi terkini dan mungkin memberi Anda Anchor yang berbeda dari yang di-pin program Raydium — periksa anchor --version setelahnya.

Konfigurasi untuk mainnet:

solana config set --url https://api.mainnet-beta.solana.com
solana config set --keypair ~/.config/solana/id.json
solana-keygen new                           # buat wallet jika Anda belum memilikinya
solana address                              # kunci publik Anda

Untuk pengujian Raydium, Anda hampir selalu menginginkan wallet devnet yang didanai:

solana config set --url https://api.devnet.solana.com
solana airdrop 2                            # 2 SOL untuk pengujian

SPL Token CLI

CLI resmi untuk operasi SPL Token / Token-2022 — membuat mint, minting token, transfer. Instalasi (disertakan dengan Solana CLI):

spl-token --version

Operasi umum:

spl-token create-token                                  # buat mint SPL Token
spl-token create-token --program-id TOKEN_2022 ...      # buat mint Token-2022
spl-token create-account <MINT>                         # buat ATA
spl-token mint <MINT> 1000                              # mint 1000 token ke ATA Anda
spl-token transfer <MINT> 100 <RECIPIENT>               # transfer 100
spl-token display <ACCOUNT_OR_MINT>                     # inspeksi

Anchor CLI

Diperlukan untuk mengambil IDL Raydium, membangun klien, dan memverifikasi program. Instalasi:

cargo install --git https://github.com/solana-foundation/anchor avm --locked --force
avm install 1.0.2
avm use 1.0.2
anchor --version   # → anchor-cli 1.0.2

Anchor pindah repository dan major version. Repo kanonik sekarang github.com/solana-foundation/anchor (sebelumnya coral-xyz/anchor), dan Anchor 1.0 adalah baris rilis pertama yang digunakan program Raydium — CPMM dan LaunchLab keduanya pin anchor-lang/anchor-spl =1.0.2 per upgrade 2026-09-09, dan CLMM mengikuti pada upgrade 2026-09-30, semua naik dari 0.32.1. avm dapat menampung beberapa versi; avm use 1.0.2 adalah yang membuat anchor build mereproduksi artifact Raydium. Anchor 1.1 dan 1.2 ada dan membangun dengan baik untuk program Anda sendiri, tetapi crate CPI yang dikompilasi terhadap anchor-lang minor yang berbeda dari yang di-pin program target tidak akan link — lihat sdk-api/rust-cpi.

Operasi umum:

anchor idl fetch <PROGRAM_ID> -o program.idl.json       # ambil IDL on-chain
anchor idl init -f idl.json <PROGRAM_ID>                # upload IDL
anchor build                                             # bangun program dari source

Setup TypeScript

Jalur integrasi utama untuk Raydium.

Paket

npm install \
  @solana/web3.js \
  @solana/spl-token \
  @anchor-lang/core \
  @raydium-io/raydium-sdk-v2 \
  bn.js \
  decimal.js

Versi yang diketahui bekerja bersama per September 2026:

Paket	Versi	Catatan
`@solana/web3.js`	`^1.95`	API 1.x. `2.x` / `3.x` adalah permukaan API yang berbeda dan tidak kompatibel; SDK Raydium menargetkan 1.x.
`@solana/spl-token`	`^0.4.15`	0.4.15 adalah yang mengekspos `createUnwrapLamportsInstruction` — lihat reclaimable rent.
`@anchor-lang/core`	`^1.0` (saat ini resolve ke `1.2.0`)	Klien TypeScript Anchor 1.x. Repo Raydium sendiri pin tepat `1.0.2`; untuk penggunaan sisi klien 1.x apa pun berfungsi, tetapi pin `1.0.2` jika Anda ingin mencocokkan test suite mereka.
`@raydium-io/raydium-sdk-v2`	`0.2.64-alpha`	Pin yang digunakan setiap demo kode dalam dokumentasi ini.

@coral-xyz/anchor beku; paket sekarang @anchor-lang/core. @coral-xyz/anchor berhenti di 0.32.1 ketika Anchor pindah keluar dari Coral. Anchor 1.x menerbitkan sebagai @anchor-lang/core, dan repository program Raydium sendiri beralih test suite mereka ke dalamnya pada upgrade 2026-09-09 (CLMM pada 2026-09-30). Import yang sebenarnya Anda gunakan tidak berubah — import { Program, BN, AnchorProvider } from "@anchor-lang/core" — jadi migrasi adalah rename paket plus update lockfile.Dua catatan perilaku jika Anda pindah dari 0.3x: .accounts({...}) sekarang hanya menerima akun yang tidak dapat diselesaikan Anchor sendiri, jadi builder yang melewatkan set lengkap harus memanggil .accountsPartial({...}) sebagai gantinya; dan @anchor-lang/core/dist/cjs/utils/token adalah tempat helper seperti ASSOCIATED_PROGRAM_ID pindah.

Skrip minimal

import { Connection, Keypair } from "@solana/web3.js";
import { Raydium } from "@raydium-io/raydium-sdk-v2";

const connection = new Connection("https://api.mainnet-beta.solana.com", "confirmed");
const owner      = Keypair.fromSecretKey(/* your key */);

const raydium = await Raydium.load({
  connection,
  owner,
  cluster:      "mainnet",
  disableFeatureCheck: true,
});

// `ids` adalah daftar yang dipisahkan koma, dan panggilan mengembalikan array
const [poolInfo] = await raydium.api.fetchPoolById({ ids: "..." });
console.log(poolInfo);

Lihat sdk-api/typescript-sdk untuk referensi SDK lengkap.

Setup Rust

Untuk integrasi CPI dan program on-chain.

rustup install 1.91.0           # apa yang di-pin program Raydium
rustup default 1.91.0
rustup component add rustfmt clippy
agave-install init 3.1.10       # SBF toolchain disertakan

Bangun program dengan cargo build-sbf (ejaan lama cargo build-bpf sudah hilang).

Program Cargo.toml untuk integrasi Raydium CPI

# Integrasi CPMM dan/atau CLMM (Anchor 1.0) — satu crate dapat mengambil keduanya
[dependencies]
anchor-lang     = "=1.0.2"
anchor-spl      = "=1.0.2"
raydium-cp-swap = { git = "https://github.com/raydium-io/raydium-cp-swap", branch = "chore/upgrade-anchor", features = ["cpi"] }
raydium-clmm    = { git = "https://github.com/raydium-io/raydium-clmm",    branch = "chore/upgrade-anchor", features = ["cpi"] }

Pin anchor-lang dan anchor-spl dengan = ke versi yang di-pin program target. Pada branch chore/upgrade-anchor mereka, CPMM dan CLMM keduanya pin =1.0.2, jadi satu crate dapat CPI ke keduanya. Branch master repo keduanya masih pin 0.32.1, dan crate yang mencampur dependensi master dengan satu upgrade-branch tidak akan membangun. Lihat sdk-api/rust-cpi. Fitur "cpi" mengimpor modul cpi dengan helper CPI (jadi Anda dapat raydium_cp_swap::cpi::swap_base_input(...)). Lihat sdk-api/rust-cpi.

Setup Python

Jalur integrasi sekunder — umum untuk pengembang bot.

Paket

pip install solders solana anchorpy

Versi:

Paket	Nama PyPI	Versi
`solders`	`solders`	≥0.29
solana-py	`solana`	≥0.40
`anchorpy`	`anchorpy`	≥0.21

Dua jebakan penamaan. Klien RPC diimpor sebagai solana tetapi proyek disebut solana-py — pip install solana-py tidak menginstal apa pun yang berguna. Dan tidak ada paket raydium-py di PyPI: helper Raydium komunitas adalah repository yang Anda clone, AL-THE-BOT-FATHER/raydium_py, bukan distribusi yang diterbitkan. Revisi sebelumnya dari halaman ini mencantumkan baris pip install raydium-py yang tidak pernah berfungsi.

Skrip minimal

from solana.rpc.async_api import AsyncClient
from solders.keypair import Keypair
from anchorpy import Provider, Wallet, Program

async def main():
    conn = AsyncClient("https://api.mainnet-beta.solana.com")
    owner = Keypair()
    wallet = Wallet(owner)
    provider = Provider(conn, wallet)

    # Muat IDL dan program
    with open("cpmm.idl.json") as f:
        idl = json.load(f)
    program = Program(idl, CPMM_PROGRAM_ID, provider)

    pool = await program.account["PoolState"].fetch(pool_id)
    print(pool)

Lihat sdk-api/python-integration.

Endpoint RPC

RPC mainnet publik (api.mainnet-beta.solana.com) sangat dibatasi rate dan throttle di bawah beban apa pun. Untuk penggunaan non-trivial, dapatkan endpoint privat:

Penyedia	Catatan
Helius	Paling populer; tier gratis yang murah hati.
Triton	Enterprise; harga premium, stabil.
QuickNode	Solid; latensi sub-per-detik.
Node RPC Anda sendiri	Biaya ~$500/bulan dalam hardware; kontrol penuh.

Konfigurasi:

const connection = new Connection("https://mainnet.helius-rpc.com/?api-key=...");

Beberapa operasi RPC memerlukan kemampuan yang diperluas:

getProgramAccounts — scan tanpa batasan mahal; beberapa penyedia membatasi atau mengenakan biaya per scan.
getPriorityFeeEstimate — endpoint spesifik Helius; yang lain memiliki setara.
geyser / WebSocket streaming — diperlukan untuk bot latensi rendah; tidak semua penyedia mengeksposnya.

Devnet dan localnet

Devnet

Cluster test publik Solana. Raydium memiliki deployment devnet parsial:

Beberapa pool CPMM ada untuk pengujian.
AMM v4 memiliki pool devnet historis.
CLMM memiliki beberapa pool demo.
Farm v6 di-deploy.

solana config set --url https://api.devnet.solana.com
solana airdrop 2

SDK mendukung devnet melalui cluster: "devnet":

const raydium = await Raydium.load({ connection, owner, cluster: "devnet" });

Caveat: pool devnet memiliki likuiditas tipis dan mungkin memiliki state basi. Jangan andalkan devnet untuk penemuan harga; gunakan hanya untuk membangun-dan-menguji alur instruksi.

Localnet dengan state mainnet yang di-fork

Untuk pengujian realistis, fork state mainnet ke validator lokal:

solana-test-validator \
  --url https://api.mainnet-beta.solana.com \
  --clone CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C \
  --clone CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK \
  --clone <SOME_POOL_ID> \
  --clone <SOME_MINT_ID>

Ini mengkloning state program/akun spesifik ke localhost, di mana Anda dapat bertransaksi dengan bebas. Ideal untuk:

Unit-testing integrasi CPI Anda terhadap program Raydium nyata.
Memutar ulang transaksi dengan parameter yang dimodifikasi untuk debug.
Stress-testing dengan volume sintetis besar.

Tim Raydium menggunakan localnet yang di-fork secara ekstensif untuk regression testing sebelum deployment mainnet.

Template proyek

Starter integrasi TypeScript

my-raydium-app/
├── package.json
├── tsconfig.json
├── src/
│   ├── swap.ts           # contoh swap
│   ├── add-liquidity.ts
│   └── read-pool.ts
└── .env                  # RPC URL, jalur wallet

package.json minimal:

{
  "name": "my-raydium-app",
  "type": "module",
  "scripts": { "swap": "tsx src/swap.ts" },
  "dependencies": {
    "@raydium-io/raydium-sdk-v2": "0.2.64-alpha",
    "@solana/web3.js": "^1.95",
    "@solana/spl-token": "^0.4.15"
  },
  "devDependencies": {
    "@types/node": "^20",
    "tsx": "^4",
    "typescript": "^5"
  }
}

Starter program Anchor CPI

my-raydium-cpi/
├── Anchor.toml
├── Cargo.toml
├── programs/
│   └── my-cpi/
│       ├── Cargo.toml
│       └── src/lib.rs
└── tests/
    └── my-cpi.ts

Dengan Anchor 1.0:

anchor init my-raydium-cpi
cd my-raydium-cpi
# tambahkan raydium-cp-swap ke Cargo.toml dengan features = ["cpi"]
anchor build
anchor test

Utilitas CLI berguna

`solana-keygen`

solana-keygen new --outfile ./wallet.json          # hasilkan kunci
solana-keygen pubkey ./wallet.json                 # tampilkan kunci publik

Membaca akun apa pun

solana account <ADDRESS> --output json-compact

Berguna untuk melihat state pool tanpa decoder.

Log program

solana logs | grep CPMMoo8                         # tail log tx terkait CPMM

Inspeksi transaksi

solana confirm <TX_SIGNATURE> -v                   # pretty-prints logs

Atau melalui explorer — tempel signature dan lihat tab “Program Logs”.

Kebersihan lingkungan

Wallet terpisah per tujuan

Wallet pengembangan: memegang testnet SOL, digunakan untuk membangun.
Wallet produksi: memegang SOL nyata, digunakan hanya untuk deploy / pengajuan multisig.
Hot wallet untuk bot: saldo kecil, izin sempit.

Kunci tidak boleh hardcoded. Gunakan variabel lingkungan atau secret manager.

Pola `.env`

# .env (tidak di-commit)
SOLANA_RPC_URL=https://mainnet.helius-rpc.com/?api-key=...
WALLET_PATH=/Users/you/.config/solana/id.json

import { config } from "dotenv";
config();

const connection = new Connection(process.env.SOLANA_RPC_URL!);

Pinning versi

Kunci semua dependensi ekosistem Solana. Ekosistem bergerak cepat; bump minor version @solana/web3.js sebelumnya telah memperkenalkan breaking changes. Gunakan package-lock.json / Cargo.lock dengan religius.

Pointer

sdk-api/typescript-sdk — Referensi SDK TypeScript.
sdk-api/rust-cpi — Penggunaan Rust CPI.
sdk-api/python-integration — Setup Python.
solana-fundamentals/programs-and-anchor — Latar belakang Anchor.

Sumber:

Solana fundamentals

Quick start

SDK & API

Integration guides

Toolchain

Alat inti

Solana CLI

SPL Token CLI

Anchor CLI

Setup TypeScript

Paket

Skrip minimal

Setup Rust

Toolchain

Program Cargo.toml untuk integrasi Raydium CPI

Setup Python

Paket

Skrip minimal

Endpoint RPC

Devnet dan localnet

Devnet

Localnet dengan state mainnet yang di-fork

Template proyek

Starter integrasi TypeScript

Starter program Anchor CPI

Utilitas CLI berguna

`solana-keygen`

Membaca akun apa pun

Log program

Inspeksi transaksi

Kebersihan lingkungan

Wallet terpisah per tujuan

Pola `.env`

Pinning versi

Pointer

​Alat inti

​Solana CLI

​SPL Token CLI

​Anchor CLI

​Setup TypeScript

​Paket

​Skrip minimal

​Setup Rust

​Toolchain

​Program Cargo.toml untuk integrasi Raydium CPI

​Setup Python

​Paket

​Skrip minimal

​Endpoint RPC

​Devnet dan localnet

​Devnet

​Localnet dengan state mainnet yang di-fork

​Template proyek

​Starter integrasi TypeScript

​Starter program Anchor CPI

​Utilitas CLI berguna

​solana-keygen

​Membaca akun apa pun

​Log program

​Inspeksi transaksi

​Kebersihan lingkungan

​Wallet terpisah per tujuan

​Pola .env

​Pinning versi

​Pointer

Alat inti

Solana CLI

SPL Token CLI

Anchor CLI

Setup TypeScript

Paket

Skrip minimal

Setup Rust

Toolchain

Program Cargo.toml untuk integrasi Raydium CPI

Setup Python

Paket

Skrip minimal

Endpoint RPC

Devnet dan localnet

Devnet

Localnet dengan state mainnet yang di-fork

Template proyek

Starter integrasi TypeScript

Starter program Anchor CPI

Utilitas CLI berguna

`solana-keygen`

Membaca akun apa pun

Log program

Inspeksi transaksi

Kebersihan lingkungan

Wallet terpisah per tujuan

Pola `.env`

Pinning versi

Pointer