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 bộ công cụ 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 được biết là hoạt động với Raydium tính đến tháng 9 năm 2026, và các vấn đề cụ thể trong quá trình thiết lập. 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.Hai bộ phiên bản có ý nghĩa, và chúng không giống nhau. Để xây dựng hoặc fork các chương trình Raydium, bạn cần bộ công cụ chính xác mà chúng sử dụng — Rust 1.91.0, Agave 3.1.10, Anchor 1.0.2 tính đến bản nâng cấp 2026-09-09. Để tích hợp với các chương trình đã triển khai từ TypeScript hoặc Python, bạn chỉ cần một thư viện client đủ mới để giao tiếp với chúng, và các phiên bản được khuyến nghị là tùy chọn. Mỗi phần dưới đây cho biết trường hợp nào áp dụng.
Công cụ cốt lõi
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:Máy chủ cài đặt đã thay đổi. Trình cài đặt đó theo dõi ý tưởng của riêng nó về phiên bản hiện tại và có thể cung cấp cho bạn một Anchor khác với phiên bản mà các chương trình Raydium sử dụng — kiểm tra
release.solana.com thuộc về Solana Labs; client hiện được duy trì bởi Anza dưới tên Agave, và các bản phát hành được phục vụ từ release.anza.xyz. Tệp nhị phân tự cập nhật là agave-install (solana-install được giữ lại như một bí danh kế thừa), vì vậy agave-install update và agave-install init <version> là các cách viết hiện tại. Tài liệu của Solana cũng cung cấp một trình cài đặt một lệnh kéo CLI, Rust và Anchor cùng nhau:anchor --version sau đó.SPL Token CLI
CLI chính thức cho các hoạt động SPL Token / Token-2022 — tạo mint, mint token, chuyển giao. Cài đặt (bao gồm trong Solana CLI):Anchor CLI
Cần thiết để lấy IDL của Raydium, xây dựng client và xác minh chương trình. Cài đặt:Anchor đã chuyển kho lưu trữ và phiên bản chính. Kho lưu trữ chính thức hiện là
github.com/solana-foundation/anchor (trước đây là coral-xyz/anchor), và Anchor 1.0 là dòng phát hành đầu tiên mà các chương trình Raydium sử dụng — CPMM và LaunchLab đều sử dụng anchor-lang/anchor-spl =1.0.2 tính đến bản nâng cấp 2026-09-09, tăng từ 0.32.1. avm có thể giữ nhiều phiên bản; avm use 1.0.2 là cách làm cho anchor build tái tạo các tạo phẩm của Raydium. Anchor 1.1 và 1.2 tồn tại và xây dựng tốt cho các chương trình của riêng bạn, nhưng một crate CPI được biên dịch với một anchor-lang phụ khác với phiên bản mà chương trình đích sử dụng sẽ không liên kết — xem sdk-api/rust-cpi.Thiết lập TypeScript
Đường dẫn tích hợp chính cho Raydium.Gói
@anchor-lang/core bị đóng băng; gói hiện là @anchor-lang/core. @anchor-lang/core dừng lại ở 0.32.1 khi Anchor chuyển sang Solana Foundation. Anchor 1.x xuất bản dưới dạng @anchor-lang/core, và các kho lưu trữ chương trình của Raydium đã chuyển bộ kiểm tra của chúng sang nó trong bản nâng cấp 2026-09-09. Các lần nhập bạn thực sự sử dụng không thay đổi — import { Program, BN, AnchorProvider } from "@anchor-lang/core" — vì vậy di chuyển là một đổi tên gói cộng với cập nhật tệp khóa.Hai ghi chú về hành vi nếu bạn chuyển từ 0.3x: .accounts({...}) hiện chỉ chấp nhận các tài khoản mà Anchor không thể tự giải quyết, vì vậy một trình xây dựng chuyển toàn bộ bộ nên gọi .accountsPartial({...}) thay thế; và @anchor-lang/core/dist/cjs/utils/token là nơi các trợ giúp như ASSOCIATED_PROGRAM_ID được chuyển đến.Tập lệnh tối thiểu
sdk-api/typescript-sdk để tham khảo SDK đầy đủ.
Thiết lập Rust
Để tích hợp CPI và các chương trình on-chain.Bộ công cụ
cargo build-sbf (cách viết cũ cargo build-bpf đã biến mất).
Program Cargo.toml cho tích hợp CPI Raydium
anchor-lang và anchor-spl với = vào phiên bản mà chương trình đích sử dụng. Tính đến 2026-09, CPMM sử dụng =1.0.2 và CLMM vẫn sử dụng =0.32.1, vì vậy một crate duy nhất không thể CPI vào cả hai — xem sdk-api/rust-cpi.
Tính năng "cpi" nhập mô-đun cpi với các trợ giúp CPI (vì vậy bạn có thể raydium_cp_swap::cpi::swap_base_input(...)). Xem sdk-api/rust-cpi.
Thiết lập 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
Hai bẫy đặt tên. Client RPC được nhập dưới dạng
solana nhưng dự án được gọi là solana-py — pip install solana-py không cài đặt bất cứ điều gì hữu ích. Và không có gói raydium-py trên PyPI: trợ giúp Raydium của cộng đồng là một kho lưu trữ bạn sao chép, AL-THE-BOT-FATHER/raydium_py, không phải là một bản phân phối được xuất bản. Các bản sửa đổi trước của trang này liệt kê một dòng pip install raydium-py không bao giờ hoạt động.Tập lệnh tối thiểu
sdk-api/python-integration.
Điểm cuối RPC
RPC mainnet công khai (api.mainnet-beta.solana.com) bị giới hạn tốc độ nặng nề và bị điều chỉnh dưới bất kỳ tải nào. Để sử dụng không tầm thường, hãy lấy một điểm cuối riêng:
Cấu hình:
getProgramAccounts— quét không hạn chế rất tốn kém; một số nhà cung cấp gating hoặc tính phí cho mỗi lần quét.getPriorityFeeEstimate— điểm cuối 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ả các nhà cung cấp đều hiển thị nó.
Devnet và localnet
Devnet
Cụm kiểm tra công khai của Solana. Raydium có một triển khai devnet một phần:- 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.
cluster: "devnet":
Localnet với trạng thái mainnet được fork
Để kiểm tra thực tế, fork trạng thái mainnet vào một trình xác thực cục bộ:- Kiểm tra đơn vị tích hợp CPI của bạn với một chương trình Raydium thực.
- Phát lại một giao dịch với một 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.
Mẫu dự án
Bộ khởi động tích hợp TypeScript
package.json tối thiểu:
Bộ khởi động chương trình Anchor CPI
Tiện ích CLI hữu ích
solana-keygen
Đọc bất kỳ tài khoản nào
Nhật ký chương trình
Kiểm tra giao dịch
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 triển khai / gửi multisig.
- Ví nóng cho bot: số dư nhỏ, quyền hạn hẹp.
Mẫu .env
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 sửa đổi phụ của@solana/web3.js trước đây đã giới thiệu các thay đổi phá vỡ. Sử dụng package-lock.json / Cargo.lock một cách tôn giáo.
Con trỏ
sdk-api/typescript-sdk— Tham khảo SDK TypeScript.sdk-api/rust-cpi— Sử dụng CPI Rust.sdk-api/python-integration— Thiết lập Python.solana-fundamentals/programs-and-anchor— Nền tảng Anchor.

