Skip to main content
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:
Xác minh:
Máy chủ cài đặt đã thay đổi. 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 updateagave-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:
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 anchor --version sau đó.
Cấu hình cho mainnet:
Để kiểm tra Raydium, bạn hầu như luôn muốn một ví devnet được tài trợ:

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):
Các hoạt động phổ biến:

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.
Các hoạt động phổ biến:

Thiết lập TypeScript

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

Gói

Các phiên bản được biết là hoạt động cùng nhau tính đến tháng 9 năm 2026:
@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

Xem 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ụ

Xây dựng các chương trình với 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

Ghim anchor-langanchor-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

Phiên bản:
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-pypip 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

Xem 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:
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 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.
SDK hỗ trợ devnet thông qua 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 một trình xác thực cục bộ:
Đ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 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.
Nhóm 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

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

Với Anchor 1.0:

Tiện ích CLI hữu ích

solana-keygen

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

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

Kiểm tra giao dịch

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 triển khai / gửi multisig.
  • Ví nóng cho bot: số dư nhỏ, quyền hạn hẹp.
Các 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

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ỏ

Nguồn: