工具鏈

# Raydium 程式建構和測試所用的版本
sh -c "$(curl -sSfL https://release.anza.xyz/v3.1.10/install)"

# 或追蹤一個頻道而不是標籤
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

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

solana config set --url https://api.mainnet-beta.solana.com
solana config set --keypair ~/.config/solana/id.json
solana-keygen new                           # 如果沒有錢包，建立一個
solana address                              # 你的公鑰

solana config set --url https://api.devnet.solana.com
solana airdrop 2                            # 2 SOL 用於測試

spl-token --version

spl-token create-token                                  # 建立 SPL Token mint
spl-token create-token --program-id TOKEN_2022 ...      # 建立 Token-2022 mint
spl-token create-account <MINT>                         # 建立 ATA
spl-token mint <MINT> 1000                              # 鑄造 1000 個代幣到你的 ATA
spl-token transfer <MINT> 100 <RECIPIENT>               # 轉移 100 個
spl-token display <ACCOUNT_OR_MINT>                     # 檢查

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 idl fetch <PROGRAM_ID> -o program.idl.json       # 取得鏈上 IDL
anchor idl init -f idl.json <PROGRAM_ID>                # 上傳 IDL
anchor build                                             # 從原始碼建構程式

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

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` 是逗號分隔的列表，呼叫會傳回陣列
const [poolInfo] = await raydium.api.fetchPoolById({ ids: "..." });
console.log(poolInfo);

rustup install 1.91.0           # Raydium 程式所固定的版本
rustup default 1.91.0
rustup component add rustfmt clippy
agave-install init 3.1.10       # 包含 SBF 工具鏈

# CPMM 整合（Anchor 1.0）
[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"] }

# CLMM 整合 — 仍為 Anchor 0.32，所以需要自己的 crate
[dependencies]
anchor-lang  = "=0.32.1"
anchor-spl   = "=0.32.1"
raydium-clmm = { git = "https://github.com/raydium-io/raydium-clmm", branch = "master", features = ["cpi"] }

pip install solders solana anchorpy

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)

    # 載入 IDL 和程式
    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)

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

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

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

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

my-raydium-app/
├── package.json
├── tsconfig.json
├── src/
│   ├── swap.ts           # 交換範例
│   ├── add-liquidity.ts
│   └── read-pool.ts
└── .env                  # RPC URL、錢包路徑

{
  "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"
  }
}

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

anchor init my-raydium-cpi
cd my-raydium-cpi
# 將 raydium-cp-swap 新增到 Cargo.toml，features = ["cpi"]
anchor build
anchor test

solana-keygen new --outfile ./wallet.json          # 產生金鑰
solana-keygen pubkey ./wallet.json                 # 顯示公鑰

solana account <ADDRESS> --output json-compact

solana logs | grep CPMMoo8                         # 追蹤 CPMM 相關交易日誌

solana confirm <TX_SIGNATURE> -v                   # 漂亮列印日誌

# .env（未提交）
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!);