Toolchain

Cấu hình tối thiểu cho việc đọc trạng thái on-chain của Raydium, xây dựng giao dịch và phát triển với các chương trình. Hướng dẫn Solana CLI, Anchor, SDK TypeScript và Python, cùng các mẹo cho devnet/localnet.

Trang này được dịch tự động bằng AI. Phiên bản tiếng Anh là bản chính thức.

Xem bản tiếng Anh →

Toàn bộ tài liệu này giả định bạn có một toolchain phát triển Solana hoạt động. Trang này liệt kê các công cụ, các phiên bản tối thiểu được biết là hoạt động với Raydium từ tháng 4 năm 2026, và các vấn đề cấu hình cụ thể. Hãy bắt đầu từ đây trước khi chạy bất kỳ ví dụ mã nào trong các chương sau.

​

Công cụ cơ bản

​

Solana CLI

Giao diện dòng lệnh chính thức để tương tác với các cụm Solana — quản lý ví, gọi RPC, triển khai chương trình.

Cài đặt:

sh -c "$(curl -sSfL https://release.solana.com/v1.18.22/install)"
# Hoặc phiên bản ổn định mới nhất:
sh -c "$(curl -sSfL https://release.solana.com/stable/install)"

Xác minh:

solana --version   # → solana-cli 1.18.22 (hoặc mới hơn)

Cấu hình cho mainnet:

solana config set --url https://api.mainnet-beta.solana.com
solana config set --keypair ~/.config/solana/id.json
solana-keygen new                           # tạo ví nếu bạn chưa có
solana address                              # khóa công khai của bạn

Để kiểm tra Raydium, bạn hầu như luôn cần một ví devnet được cấp quỹ:

solana config set --url https://api.devnet.solana.com
solana airdrop 2                            # 2 SOL để kiểm tra

​

SPL Token CLI

CLI chính thức cho các hoạt động SPL Token / Token-2022 — tạo mint, đúc token, chuyển token.

Cài đặt (có sẵn với Solana CLI):

spl-token --version

Các hoạt động thường gặp:

spl-token create-token                                  # tạo mint SPL Token
spl-token create-token --program-id TOKEN_2022 ...      # tạo mint Token-2022
spl-token create-account <MINT>                         # tạo ATA
spl-token mint <MINT> 1000                              # đúc 1000 token vào ATA của bạn
spl-token transfer <MINT> 100 <RECIPIENT>               # chuyển 100
spl-token display <ACCOUNT_OR_MINT>                     # kiểm tra

​

Anchor CLI

Cần thiết để lấy IDL Raydium, xây dựng client và xác minh chương trình.

Cài đặt:

cargo install --git https://github.com/coral-xyz/anchor avm --locked
avm install 0.30.1
avm use 0.30.1
anchor --version

Các hoạt động thường gặp:

anchor idl fetch <PROGRAM_ID> -o program.idl.json       # lấy IDL on-chain
anchor idl init -f idl.json <PROGRAM_ID>                # tải lên IDL
anchor build                                             # xây dựng chương trình từ mã nguồn

​

Cấu hình TypeScript

Đường dẫn tích hợp chính cho Raydium.

​

Gói

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

Phiên bản được biết là hoạt động cùng nhau từ tháng 4 năm 2026:

Gói	Phiên bản
@solana/web3.js	≥1.95
@solana/spl-token	≥0.4
@coral-xyz/anchor	≥0.30
@raydium-io/raydium-sdk-v2	≥0.2.42-alpha

​

Script tối thiểu

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,
});

const poolInfo = await raydium.api.fetchPoolById({ id: "..." });
console.log(poolInfo);

Xem sdk-api/typescript-sdk để có tham chiếu SDK đầy đủ.

​

Cấu hình Rust

Để tích hợp CPI và các chương trình on-chain.

​

Toolchain

rustup install 1.76.0           # hoặc bất kỳ phiên bản Anchor yêu cầu hiện tại
rustup component add rustfmt clippy
solana-install init 1.18.22     # BPF toolchain được bao gồm

​

Cargo.toml của chương trình cho tích hợp Raydium CPI

[dependencies]
anchor-lang        = "0.30.1"
anchor-spl         = "0.30.1"
raydium-cp-swap    = { version = "0.2", features = ["cpi"] }
raydium-clmm       = { version = "0.1", features = ["cpi"] }

Tính năng "cpi" nhập khẩu mô-đun cpi với các helper CPI (để bạn có thể gọi raydium_cp_swap::cpi::swap_base_input(...)). Xem sdk-api/rust-cpi.

​

Cấu hình Python

Đường dẫn tích hợp thứ cấp — phổ biến cho các nhà phát triển bot.

​

Gói

pip install solders solana-py anchorpy
pip install raydium-py    # SDK Raydium của cộng đồng (không chính thức)

Phiên bản:

Gói	Phiên bản
solders	≥0.21
solana-py	≥0.34
anchorpy	≥0.21
raydium-py	≥0.2.1

​

Script tối thiểu

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)

    # Tải IDL và chương trình
    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)

Xem sdk-api/python-integration.

​

Endpoint RPC

RPC mainnet công cộng (api.mainnet-beta.solana.com) bị giới hạn tốc độ nặng nề và sẽ bị điều tiết dưới bất kỳ tải nào. Để sử dụng không tầm thường, hãy lấy một endpoint riêng tư:

Nhà cung cấp	Ghi chú
Helius	Phổ biến nhất; gói miễn phí rộng rãi.
Triton	Doanh nghiệp; định giá cao cấp, ổn định.
QuickNode	Tốt; độ trễ dưới miligiây.
RPC node của riêng bạn	Chi phí ~$500/tháng cho phần cứng; kiểm soát hoàn toàn.

Cấu hình:

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

Một số hoạt động RPC cần khả năng mở rộng:

• getProgramAccounts — quét không hạn chế rất tốn kém; một số nhà cung cấp hạn chế hoặc tính phí theo lần quét.
• getPriorityFeeEstimate — endpoint cụ thể của Helius; những người khác có tương đương.
• geyser / WebSocket streaming — cần thiết cho bot độ trễ thấp; không phải tất cả nhà cung cấp đều công khai nó.

​

Devnet và localnet

​

Devnet

Cụm kiểm tra công khai của Solana. Raydium có một phần triển khai devnet:

• Một số pool CPMM tồn tại để kiểm tra.
• AMM v4 có các pool devnet lịch sử.
• CLMM có một vài pool demo.
• Farm v6 được triển khai.

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

SDK hỗ trợ devnet thông qua cluster: "devnet":

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

Cảnh báo: các pool devnet có thanh khoản mỏng và có thể có trạng thái cũ. Đừng dựa vào devnet để khám phá giá; chỉ sử dụng nó để xây dựng và kiểm tra luồng hướng dẫn.

​

Localnet với trạng thái mainnet được fork

Để kiểm tra thực tế, fork trạng thái mainnet vào trình xác thực cục bộ:

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

Điều này sao chép trạng thái chương trình/tài khoản cụ thể vào localhost, nơi bạn có thể giao dịch tự do. Lý tưởng cho:

• Kiểm tra đơn vị tích hợp CPI của bạn với chương trình Raydium thực.
• Phát lại giao dịch với tham số được sửa đổi để gỡ lỗi.
• Kiểm tra áp lực với khối lượng tổng hợp lớn.

Đội Raydium sử dụng localnet được fork rộng rãi để kiểm tra hồi quy trước khi triển khai mainnet.

​

Mẫu dự án

​

Starter tích hợp TypeScript

my-raydium-app/
├── package.json
├── tsconfig.json
├── src/
│   ├── swap.ts           # ví dụ swap
│   ├── add-liquidity.ts
│   └── read-pool.ts
└── .env                  # RPC URL, đường dẫn ví

Tệp package.json tối thiểu:

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

​

Starter chương trình Anchor CPI

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

Với Anchor 0.30:

anchor init my-raydium-cpi
cd my-raydium-cpi
# thêm raydium-cp-swap vào Cargo.toml với features = ["cpi"]
anchor build
anchor test

​

Tiện ích CLI hữu ích

​

solana-keygen

solana-keygen new --outfile ./wallet.json          # tạo khóa
solana-keygen pubkey ./wallet.json                 # hiển thị khóa công khai

​

Đọc bất kỳ tài khoản nào

solana account <ADDRESS> --output json-compact

Hữu ích để xem trạng thái pool mà không cần bộ giải mã.

​

Nhật ký chương trình

solana logs | grep CPMMoo8                         # theo dõi nhật ký tx liên quan đến CPMM

​

Kiểm tra giao dịch

solana confirm <TX_SIGNATURE> -v                   # in đẹp các nhật ký

Hoặc thông qua explorer — dán chữ ký và xem tab “Program Logs”.

​

Vệ sinh môi trường

​

Ví riêng biệt cho mỗi mục đích

• Ví phát triển: giữ testnet SOL, được sử dụng để xây dựng.
• Ví sản xuất: giữ SOL thực, chỉ được sử dụng cho lần triển khai / đệ trình multisig.
• Ví nóng cho bot: số dư nhỏ, quyền hạn hẹp.

Khóa không bao giờ nên được mã hóa cứng. Sử dụng các biến môi trường hoặc trình quản lý bí mật.

​

Mẫu .env

# .env (không được 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!);

​

Ghim phiên bản

Khóa tất cả các phụ thuộc của hệ sinh thái Solana. Hệ sinh thái di chuyển nhanh; một bản phát hành phụ của @solana/web3.js trước đây đã giới thiệu các thay đổi đột phá. Sử dụng package-lock.json / Cargo.lock một cách tôn giáo.

​

Con trỏ

• sdk-api/typescript-sdk — Tham chiếu TypeScript SDK.
• sdk-api/rust-cpi — Sử dụng Rust CPI.
• sdk-api/python-integration — Cấu hình Python.
• solana-fundamentals/programs-and-anchor — Nền tảng Anchor.

Nguồn:

• Tài liệu cài đặt Solana.
• Anchor book: bắt đầu.
• Raydium SDK v2 repo.