Versi dan migrasi

​

Status sekilas

Kesimpulan paling penting dari tabel ini: AMM v4 tidak dihentikan, dan CPMM adalah default baru — tetapi keduanya berdampingan dengan sengaja. Pool AMM v4 memiliki riwayat perdagangan bertahun-tahun dan tidak dipaksa untuk bermigrasi. Pilihan program mana untuk meluncurkan pool baru adalah rekomendasi, bukan batasan.

​

AMM v4 — status dan trajektori

AMM v4 adalah desain pool Raydium asli: penetapan harga constant-product (x · y = k). Diluncurkan sebagai AMM hybrid dengan integrasi orderbook OpenBook (sebelumnya Serum) yang mencerminkan sebagian kurva sebagai limit order di pasar terikat. Integrasi OpenBook telah dinonaktifkan sejak saat itu — pool tidak lagi berbagi likuiditas ke OpenBook dan semua swap dieksekusi murni terhadap kurva melalui entrypoint swap V2. AMM v4 saat ini, dalam praktiknya, adalah AMM constant-product murni dengan akun OpenBook dipertahankan sebagai state inert.

​

Apa yang dibekukan

• Tidak ada tier biaya baru. Struktur biaya AMM v4 per-pool dan ditetapkan saat deploy. Pool baru menerima biaya perdagangan hardcoded yang sama ~0,25%, ~12% ke protokol.
• Tidak ada pekerjaan fitur baru. Tim tidak menambahkan instruksi baru ke AMM v4 sejak CPMM menjadi default baru. Program berada dalam mode stewardship — perbaikan bug saja, tidak ada ekspansi cakupan.
• Tidak ada dukungan Token-2022. AMM v4 ditulis sebelum Token-2022 ada dan integrasi tidak pernah diretrofit. Mint Token-2022 harus menggunakan CPMM (atau CLMM, jika sesuai).
• Integrasi OpenBook dinonaktifkan. Setiap pool AMM v4 masih terikat ke akun pasar OpenBook yang sesuai on-chain, tetapi pool tidak lagi memposting atau memelihara order di pasar itu. Pemadaman OpenBook tidak lagi mempengaruhi swap AMM v4.

​

Apa yang masih berfungsi

• Pool yang ada berdagang secara normal. Tidak ada migrasi state yang dipaksa; pool v4 yang dibuat pada 2021 masih menjadi venue aktif untuk banyak pasangan volume tinggi pada 2026.
• LP dapat menyetor, menarik, dan memanen reward farm seperti biasa. Migrasi ke CPMM adalah opt-in.
• Aggregator masih merutekan melaluinya. Jupiter dan Raydium Trade API keduanya mengindeks pool v4 sebagai venue kelas satu.

​

Kapan masih menggunakan AMM v4

Jujur saja: jarang. Kasus di mana v4 adalah jawaban yang lebih baik sangat terbatas:

• Pasangan sudah memiliki pool v4 yang dalam dan banyak diperdagangkan dan Anda ingin menambah likuiditas ke kedalaman yang ada daripada memisahkan pasar.

(Routing terintegrasi OpenBook bukan lagi alasan untuk memilih AMM v4 — integrasi itu sudah mati.) Dalam setiap kasus lain, luncurkan pool baru di CPMM. Lihat user-flows/choosing-a-pool-type untuk pohon keputusan lengkap.

​

CPMM — kurva adopsi dan migrasi v4 → CPMM

CPMM (constant-product market maker, nama internal raydium-cp-swap) dideploy pada 2024 sebagai penulisan clean-room yang dimaksudkan menjadi default constant-product pool baru. Secara struktural, ini adalah yang paling sederhana dari program Raydium: x · y = k murni, tidak ada orderbook, dukungan Token-2022 native, jejak transaksi lebih kecil.

​

Apa yang CPMM dapatkan dibanding AMM v4

• Ekonomi LP lebih baik secara default. AmmConfig default CPMM merutekan 100% biaya perdagangan ke LP (dengan biaya protokol dapat diaktifkan per-tier). AMM v4 hardcodes ~12% ke protokol.
• Biaya pembuatan pool lebih rendah. Tidak perlu pasar OpenBook. Pembuatan adalah satu transaksi, ~0,15 SOL sewa vs ~0,6 SOL untuk v4.
• Token-2022. Mint transfer-fee, mint transfer-hook (dengan caveat), confidential transfer — semua didukung di CPMM, tidak ada di v4.
• Permukaan integrator lebih bersih. CPMM memiliki crate yang dipublikasikan ramah Anchor-CPI (raydium-cp-swap), daftar akun lebih sederhana, dan IDL stabil. AMM v4 mengirimkan IDL tetapi tidak pernah memiliki crate CPI Rust yang dipertahankan.
• Daftar akun lebih kecil per swap. ~10 akun vs ~17 untuk v4 (yang membawa akun pasar OpenBook bahkan ketika tidak mengenainya).

​

Kapan migrasi layak dilakukan

Untuk pool yang diperdagangkan secara aktif, peningkatan biaya LP saja biasanya membenarkan migrasi dalam beberapa bulan. Aritmatikanya: pool yang menghasilkan 0,25% × $X volume harian memberikan 0,03% ke protokol di v4 (12% yang hilang). Di CPMM itu kembali ke LP. Selama setahun, itu bertambah secara bermakna. Untuk pool volume rendah, migrasi lebih tentang future-proofing — default lebih baik, dukungan Token-2022 jika Anda membutuhkannya, integrasi lebih mudah.

​

Cara kerja migrasi

Tidak ada upgrade in-place. Migrasi adalah urutan create-new-pool, drain-old-pool, refill-new-pool. Langkah demi langkah lengkapnya ada di user-flows/migrate-amm-v4-to-cpmm; bentuk tingkat tinggi:

1. Buat pool CPMM baru untuk pasangan yang sama, di tier biaya yang sama yang ingin Anda pertahankan.
2. Koordinasikan LP: umumkan jendela di mana pool lama dikuras dan pool baru ditanam.
3. Setiap LP menarik dari pool v4 dan menyetor ke pool CPMM baru.
4. (Opsional) Siapkan farm sisi CPMM untuk menarik LP yang diberi insentif ke pool baru.
5. Tonton volume bermigrasi saat aggregator menimbang ulang ke arah pool yang lebih dalam.

Chain itu sendiri tidak memberlakukan salah satu dari ini — API dan frontend Raydium hanya lebih menyukai pool mana pun yang lebih dalam, dan aggregator merutekan melalui mana pun yang termurah untuk pengguna.

​

CLMM — program tunggal, stabil di seluruh versi

CLMM berada di versi program pertamanya. Tidak ada v2 — peningkatan telah dikirim sebagai upgrade in-place ke ID program yang sama (di belakang multisig timelock 24j), bukan sebagai generasi baru. Itu berarti ada tidak ada cerita migrasi CLMM: posisi yang ada tetap di tempat mereka, dan perilaku program mungkin berubah sedikit ketika upgrade dikirim, tetapi tata letak akun dan PDA stabil. Apa yang telah berubah di seluruh upgrade CLMM:

• Instruksi SwapV2 ditambahkan untuk mendukung matematika transfer-fee Token-2022 dengan benar. Swap lama masih dapat dipanggil; integrasi baru harus menargetkan SwapV2.
• Ekstensi aliran reward — jumlah slot RewardInfo ditingkatkan (3 asli → masih 3 saat ini, tetapi pola reservasi diperketat). Tidak perlu migrasi data.
• Pemadatan tick-array — optimasi internal untuk mengurangi CU pada swap-crossing-many-ticks. Tidak terlihat secara eksternal.
• Rebuild Anchor 1.0 (2026-09-30): bergerak dari Anchor 0.32.1 ke 1.0.2 dan menambahkan admin CollectExcessLamports. Tidak ada instruksi atau tata letak akun yang menghadap pengguna berubah. Lihat entri changelog.

IDL hidup di repositori raydium-idl yang didedikasikan (lihat sdk-api/anchor-idl). Jika Anda menjalankan SDK yang lebih lama terhadap program saat ini, kasus terburuk adalah kehilangan instruksi baru.

​

Farm v3 → v5 → v6

Dari semua program Raydium, Farm memiliki riwayat versi paling eksplisit dan satu-satunya jalur migrasi yang dipaksa. Tiga generasi adalah program terpisah dengan ID program terpisah dan tata letak state terpisah.

​

Generasi

​

Mengapa tiga generasi ada

• v3 → v5: diperlukan beberapa aliran reward bersamaan (misalnya, farm dual-incentive). Desain single-stream v3 tidak bisa mendukungnya tanpa redesign.
• v5 → v6: u64 integer emission rate v5 membatasi tingkat minimum yang dapat diekspresikan pada “1 unit token per detik.” Untuk mint 9-desimal, itu adalah 1 lamport/detik — jauh terlalu kasar untuk program emisi rendah. Tingkat fraksi Q64.64 v6 memperbaiki ini. v6 juga mengangkat update berbasis slot ke wall-clock, dan menambahkan dukungan Token-2022.

​

Apa yang tetap sama di seluruh generasi

• Pola akuntansi “deposit LP, accrue per-share counter, claim on withdraw” identik di seluruh v3/v5/v6. Matematikanya tidak berubah; hanya presisi counter rate dan jumlah aliran yang didukung.
• UserStake (v3/v5) dan UserLedger (v6) secara konseptual adalah catatan yang sama, dengan tata letak berbeda. SDK menormalkan keduanya.

​

Jalur migrasi

Tidak ada migrasi in-place antara versi farm. Untuk pindah dari v3/v5 ke v6:

1. Tunggu emisi farm yang ada berakhir (atau jalankan).
2. Staker menarik dan mengklaim reward yang tertunda di farm lama.
3. Operator farm membuat farm v6 baru terhadap mint staking yang sama.
4. Staker re-stake ke farm baru.

Realitas on-chain adalah dua akun farm yang tidak terkait. Pengguna dengan stake di keduanya memiliki dua catatan UserLedger (v6) / UserStake (v5).

​

Apa arti “wind-down” untuk v3 dan v5

• Program v3 dan v5 masih dideploy dan dapat dipanggil. Farm yang ada masih dapat mendistribusikan reward yang tertunda dan menerima penarikan.
• UI Raydium masih menampilkan farm v3 dan v5 dengan reward aktif; setelah end_time farm v3/v5 berlalu, UI menyembunyikannya dari “aktif” tetapi tetap dapat diklaim.
• Tim tidak akan membuat farm v3/v5 baru. Helper SDK untuk “create farm” merutekan ke v6 saja.
• v3 dan v5 menerima upgrade keamanan tetapi bukan pekerjaan fitur. Jika bug kritis ditemukan, itu diperbaiki; jika fitur bisa berguna, itu ditambahkan ke v6 sebagai gantinya.

Detail lengkap per versi ada di products/farm-staking/accounts dan products/farm-staking/instructions.

​

LaunchLab — program tunggal, config yang berkembang

LaunchLab berada di versi program pertamanya. Seperti CLMM, peningkatan dikirim sebagai upgrade in-place di belakang timelock 24j — bukan sebagai generasi baru. Apa yang telah berkembang melalui upgrade:

• Slot biaya kreator. Ditambahkan sehingga peluncuran dapat merutekan sebagian dari biaya perdagangan CPMM pasca-kelulusan ke kreator asli. Lihat products/launchlab/creator-fees.
• Konfigurabilitas formula kurva. Awalnya hardcoded kuadratik; sekarang LaunchConfig memilih dari set kecil bentuk kurva.

Peluncuran LaunchLab yang ada tidak terpengaruh oleh upgrade — setelah peluncuran diinisialisasi, parameternya dibekukan sampai kelulusan.

​

Kompatibilitas versi lintas program

Beberapa catatan kompatibilitas lintas produk yang sering dihadapi integrator:

• SwapV2 CLMM bukan instruksi yang sama dengan Swap. Jika klien Anda hanya berbicara Swap, itu akan secara diam-diam salah menangani biaya transfer Token-2022 — matematikanya salah dengan jumlah biaya. Perbarui ke SwapV2.
• Staking Farm v6 dengan posisi CLMM tidak didukung dengan cara staking LP-token. Posisi CLMM adalah NFT, bukan token LP yang dapat dipertukarkan. CLMM memiliki mekanisme reward native sendiri — lihat products/clmm/fees.
• Pool CPMM yang didukung oleh mint Token-2022 bekerja di farm hanya di Farm v6. v3 dan v5 menolak mint staking Token-2022.
• Pool AMM v4 tidak pernah memiliki mint LP Token-2022. Jika Anda melihat satu, itu palsu — AMM v4 tidak mendukung kombinasi itu.

​

Di mana membaca lebih lanjut

• introduction/history-and-milestones — garis waktu rilis kronologis dan mengapa setiap versi mendarat saat itu.
• user-flows/migrate-amm-v4-to-cpmm — buku runbook operator untuk perpindahan v4 → CPMM.
• user-flows/choosing-a-pool-type — pohon keputusan untuk deployment pool baru.
• products/farm-staking/accounts — skema berdampingan untuk v3 / v5 / v6.
• reference/changelog — apa yang telah berubah dalam dokumentasi ini saat versi program berkembang.

Sumber:

• Halaman bab per-produk yang dikutip inline di atas.
• Raydium SDK v2 — logika dispatch yang menyadari versi mengkonfirmasi program mana yang dimiliki pool tertentu.
• reference/program-addresses — ID kanonik per versi.