Toolchain

Setup minimum untuk membaca state on-chain Raydium, membangun transaksi, dan mengembangkan terhadap program. Solana CLI, Anchor, SDK TypeScript dan Python, serta tips devnet/localnet.

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

Lihat versi bahasa Inggris →

Seluruh 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 baris perintah 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. Dokumentasi 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, semuanya 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 sumber

​

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 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.

​

Toolchain

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 CPI Raydium

# 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 = "master", features = ["cpi"] }
raydium-clmm    = { git = "https://github.com/raydium-io/raydium-clmm",    branch = "master", features = ["cpi"] }

Pin anchor-lang dan anchor-spl dengan = ke versi yang di-pin program target. Di master, CPMM dan CLMM keduanya pin =1.0.2, jadi satu crate dapat CPI ke keduanya. Crate yang mencampur salah satu dari mereka dengan rev dari sebelum upgrade Anchor 1.0 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 laju 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 — pemindaian tanpa batasan mahal; beberapa penyedia membatasi atau mengenakan biaya per pemindaian.
• 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" });

Peringatan: pool devnet memiliki likuiditas tipis dan mungkin memiliki state yang ketinggalan zaman. Jangan andalkan devnet untuk penemuan harga; gunakan hanya untuk membangun-dan-menguji alur instruksi.

​

Localnet dengan state mainnet yang di-fork

Untuk pengujian yang 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

Minimal package.json:

{
  "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 yang berguna

​

solana-keygen

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

​

Membaca akun apa pun

solana account <ADDRESS> --output json-compact

Berguna untuk melihat status pool tanpa decoder.

​

Log program

solana logs | grep CPMMoo8                         # pantau log tx terkait CPMM

​

Inspeksi transaksi

solana confirm <TX_SIGNATURE> -v                   # tampilkan log dengan format rapi

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

​

Kebersihan lingkungan

​

Wallet terpisah per tujuan

• Wallet pengembangan: menyimpan testnet SOL, digunakan untuk membangun.
• Wallet produksi: menyimpan SOL asli, digunakan hanya untuk deploy / pengajuan multisig.
• Hot wallet untuk bot: saldo kecil, izin terbatas.

Kunci tidak boleh dikodekan keras. Gunakan variabel lingkungan atau manajer rahasia.

​

Pola .env

# .env (tidak dikomit)
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!);

​

Penambatan versi

Kunci semua dependensi ekosistem Solana. Ekosistem bergerak cepat; pembaruan versi minor @solana/web3.js sebelumnya telah memperkenalkan perubahan yang merusak. Gunakan package-lock.json / Cargo.lock dengan konsisten.

​

Referensi

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

Sumber:

• Dokumen instalasi Solana dan instalasi Agave CLI.
• Instalasi Anchor.
• Repositori Raydium SDK v2.