Sürümler ve geçiş

​

Duruma genel bakış

Bu tablodaki en önemli sonuç: AMM v4 kullanımdan kaldırılmamıştır ve CPMM yeni varsayılandır — ancak kasıtlı olarak bir arada bulunurlar. AMM v4 havuzlarının yıllar süren işlem geçmişi vardır ve zorla geçirilmemektedir. Yeni bir havuz başlatmak için hangi programı seçeceğiniz bir tavsiye, bir kısıtlama değildir.

​

AMM v4 — durum ve yönelim

AMM v4, orijinal Raydium havuz tasarımıdır: sabit-çarpım fiyatlandırması (x · y = k). OpenBook (eski adıyla Serum) emir defteri entegrasyonuna sahip hibrit bir AMM olarak başlatılmıştır ve eğrinin bölümlerini bağlı bir pazarda limit emirleri olarak yansıtmıştır. OpenBook entegrasyonu devre dışı bırakılmıştır — havuzlar artık OpenBook’a likidite paylaşmaz ve tüm swaplar V2 swap giriş noktaları aracılığıyla tamamen eğriye karşı yürütülür. Bugün AMM v4, pratikte, OpenBook hesapları hareketsiz durum olarak korunmuş saf bir sabit-çarpım AMM’dir.

​

Dondurulmuş olanlar

• Yeni ücret katmanları yok. AMM v4 ücret yapısı havuz başına ve dağıtımda ayarlanmıştır. Yeni havuzlar aynı sabit kodlanmış ~0,25% işlem ücreti, ~%12’si protokole kabul eder.
• Yeni özellik çalışması yok. Takım, CPMM yeni varsayılan olduktan sonra AMM v4’e yeni talimatlar eklememiştir. Program bakım modundadır — yalnızca hata düzeltmeleri, kapsam genişlemesi yok.
• Token-2022 desteği yok. AMM v4, Token-2022 var olmadan önce yazılmıştır ve entegrasyon hiçbir zaman uyarlanmamıştır. Token-2022 mintleri CPMM’yi (veya uygun olduğunda CLMM’yi) kullanmalıdır.
• OpenBook entegrasyonu devre dışı. Her AMM v4 havuzu hala zincir üzerinde karşılık gelen bir OpenBook pazar hesabına bağlıdır, ancak havuz artık o pazarda emir göndermez veya bakım yapmaz. OpenBook kesintisi artık AMM v4 swaplarını etkilemez.

​

Hala çalışan olanlar

• Mevcut havuzlar normal şekilde işlem görür. Hiçbir durum geçişi zorlanmamıştır; 2021’de oluşturulan v4 havuzları 2026’da birçok yüksek hacimli çift için hala aktif mekan olmaya devam etmektedir.
• LP’ler her zamanki gibi yatırım yapabilir, çekebilir ve farm ödüllerini toplayabilir. CPMM’ye geçiş isteğe bağlıdır.
• Toplayıcılar hala bunu yönlendirir. Jupiter ve Raydium Trade API’si her ikisi de v4 havuzlarını birinci sınıf mekanlar olarak indeksler.

​

AMM v4’ü ne zaman kullanmalısınız

Dürüst olmak gerekirse: nadiren. v4’ün daha iyi cevap olduğu durumlar dar aralıktadır:

• Çift zaten derin, iyi işlem gören bir v4 havuzuna sahiptir ve mevcut derinliğe likidite eklemek istiyorsunuz, pazarı bölmek yerine.

(OpenBook entegre yönlendirmesi artık AMM v4’ü seçmek için bir neden değildir — bu entegrasyon kapalıdır.) Diğer her durumda, yeni havuzları CPMM’de başlatın. Tam karar ağacı için user-flows/choosing-a-pool-type bölümüne bakın.

​

CPMM — benimseme eğrisi ve v4 → CPMM geçişi

CPMM (sabit-çarpım pazar yapıcı, dahili ad raydium-cp-swap) 2024’te yeni varsayılan sabit-çarpım havuzu olmayı amaçlayan temiz oda yeniden yazımı olarak dağıtılmıştır. Raydium’un programlarının yapısal olarak en basiti: saf x · y = k, emir defteri yok, yerel Token-2022 desteği, daha küçük işlem ayak izi.

​

CPMM’nin AMM v4’e göre avantajları

• Varsayılan olarak daha iyi LP ekonomisi. CPMM’nin varsayılan AmmConfig, işlem ücretlerinin %100’ünü LP’lere yönlendirir (protokol ücreti katman başına açılıp kapatılabilir). AMM v4 ~%12’yi protokole sabit kodlar.
• Daha düşük havuz oluşturma maliyeti. OpenBook pazarı gerekmez. Oluşturma bir işlemdir, ~0,15 SOL kira vs v4 için ~0,6 SOL.
• Token-2022. Transfer ücreti mintleri, transfer-hook mintleri (uyarılarla), gizli transferler — tümü CPMM’de desteklenir, v4’te hiçbiri.
• Daha temiz entegratör yüzeyi. CPMM’nin Anchor-CPI dostu yayınlanmış sandığı (raydium-cp-swap), daha basit bir hesap listesi ve kararlı bir IDL’si vardır. AMM v4 bir IDL gönderir ancak hiçbir zaman bakımlı bir Rust CPI sandığına sahip olmamıştır.
• Swap başına daha küçük hesap listesi. ~10 hesap vs v4 için ~17 (bunları vurmadığında bile OpenBook pazar hesaplarını taşır).

​

Geçiş ne zaman değer

Aktif olarak işlem gören bir havuz için, LP ücret artışı tek başına birkaç ay içinde geçişi haklı çıkarır. Aritmetik: günlük $X hacim kazanan bir havuz v4’te 0,25% × $X’in 0,03%‘ünü protokole verir (eksik %12). CPMM’de bu LP’lere geri döner. Bir yıl boyunca, bu anlamlı bir şekilde bileşik olur. Düşük hacimli bir havuz için, geçiş daha çok geleceğe hazırlık hakkındadır — daha iyi varsayılanlar, ihtiyaç duyarsanız Token-2022 desteği, daha kolay entegrasyonlar.

​

Geçiş nasıl çalışır

Yerinde bir yükseltme yoktur. Geçiş bir yeni havuz oluştur, eski havuzu boşalt, yeni havuzu doldur dizisidir. Tam adım adım user-flows/migrate-amm-v4-to-cpmm bölümündedir; yüksek seviye şekil:

1. Aynı çift için yeni bir CPMM havuzu oluşturun, korumak istediğiniz aynı ücret katmanında.
2. LP’leri koordine edin: eski havuzun boşaltıldığı ve yeni havuzun tohumlandığı bir pencereyi duyurun.
3. Her LP v4 havuzundan çeker ve yeni CPMM havuzuna yatırır.
4. (İsteğe bağlı) Yeni havuza teşvikli LP’leri çekmek için CPMM tarafında bir farm kurun.
5. Toplayıcılar daha derin havuza doğru yeniden ağırlık verdikçe hacmin geçişini izleyin.

Zincir bunun hiçbirini zorlamaz — Raydium’un API’si ve ön ucu basitçe hangisinin daha derin olduğunu tercih eder ve toplayıcılar kullanıcı için hangisinin en ucuz olduğu aracılığıyla yönlendirir.

​

CLMM — tek program, sürümler arasında kararlı

CLMM ilk program sürümündedir. v2 olmamıştır — iyileştirmeler yeni bir nesil olarak değil, aynı program ID’sine yerinde yükseltmeler olarak gönderilmiştir (24 saat zaman kilitli multisig’in arkasında). Bu, CLMM geçiş hikayesi olmadığı anlamına gelir: mevcut pozisyonlar yerinde kalır ve bir yükseltme gönderildiğinde programın davranışı hafifçe değişebilir, ancak hesap düzenleri ve PDA’lar kararlıdır. CLMM yükseltmeleri arasında değişen olanlar:

• SwapV2 talimatı Token-2022 transfer ücreti matematiğini doğru şekilde desteklemek için eklendi. Eski Swap hala çağrılabilir; yeni entegrasyonlar SwapV2’yi hedeflemelidir.
• Ödül akışı uzantıları — RewardInfo slot sayısı çıkartıldı (orijinal 3 → hala şu anda 3, ancak rezervasyon deseni sıkılaştırıldı). Veri geçişi gerekmez.
• Tick-array sıkıştırması — birçok tick’i geçen swap’ta CU’yu azaltmak için dahili optimizasyon. Dışarıdan görünmez.
• Anchor 1.0 yeniden oluşturma (2026-09-30): Anchor 0.32.1’den 1.0.2’ye geçer ve yönetici CollectExcessLamports’ı ekler. Kullanıcıya yönelik hiçbir talimat veya hesap düzeni değişmedi. Değişiklik günlüğü girişine bakın.

IDL, adanmış raydium-idl deposunda bulunur (bkz. sdk-api/anchor-idl). Eski bir SDK’yı mevcut programa karşı çalıştırıyorsanız, en kötü durum yeni talimatları kaçırmaktır.

​

Farm v3 → v5 → v6

Tüm Raydium programları arasında Farm’ın en açık sürüm geçmişi ve tek zorunlu geçiş yolu vardır. Üç nesil ayrı programlar, ayrı program ID’leri ve ayrı durum düzenleridir.

​

Nesiller

​

Neden üç nesil var

• v3 → v5: eşzamanlı birden fazla ödül akışına ihtiyaç duydu (örn., çift teşvikli farmlar). v3’ün tek akış tasarımı bunu yeniden tasarım olmadan destekleyemedi.
• v5 → v6: v5’in u64 tamsayı emisyon oranı, minimum ifade edilebilir oranı “saniye başına 1 token birimi” ile sınırlar. 9 ondalak bir mint için, bu saniye başına 1 lamport — düşük emisyon programları için çok kaba. v6’nın Q64.64 kesirli oranı bunu düzeltir. v6 ayrıca slot tabanlı güncellemeyi duvar saatine yükseltti ve Token-2022 desteği ekledi.

​

Nesiller arasında aynı kalan

• “LP yatır, hisse başına sayaç tahakkuk et, çekişte talep et” muhasebe deseni v3/v5/v6 arasında aynıdır. Matematik değişmez; yalnızca oran sayacının kesinliği ve desteklenen akış sayısı.
• UserStake (v3/v5) ve UserLedger (v6) kavramsal olarak aynı kayıttır, farklı düzenlerle. SDK her ikisini de normalleştirir.

​

Geçiş yolu

Farm sürümleri arasında yerinde geçiş yoktur. v3/v5’ten v6’ya geçmek için:

1. Mevcut farm’ın emisyonunun bitmesini bekleyin (veya çalıştırın).
2. Staker’lar eski farm’dan çeker ve bekleyen ödülleri talep eder.
3. Farm operatörü aynı staking mint’e karşı yeni bir v6 farm oluşturur.
4. Staker’lar yeni farm’a yeniden stake eder.

Zincir üzerindeki gerçeklik iki ilişkisiz farm hesabıdır. Her iki farm’da da stake’i olan bir kullanıcının iki UserLedger (v6) / UserStake (v5) kaydı vardır.

​

v3 ve v5 için “kapanış aşamasında” ne anlama gelir

• v3 ve v5 programları hala dağıtılmış ve çağrılabilir. Mevcut farmlar hala bekleyen ödülleri dağıtabilir ve çekişleri kabul edebilir.
• Raydium UI hala aktif ödülleri olan v3 ve v5 farmlarını gösterir; bir v3/v5 farm’ın end_time’ı geçtikten sonra, UI bunu “aktif”ten gizler ancak talep edilebilir tutar.
• Takım yeni v3/v5 farmları oluşturmayacaktır. “Farm oluştur” için SDK yardımcıları yalnızca v6’ya yönlendirir.
• v3 ve v5 güvenlik yükseltmeleri alıyor ancak özellik çalışması almıyor. Kritik bir hata bulunursa, düzeltilir; bir özellik yararlı olabilirse, bunun yerine v6’ya eklenir.

Sürüm başına tam detay products/farm-staking/accounts ve products/farm-staking/instructions bölümlerindedir.

​

LaunchLab — tek program, gelişen yapılandırma

LaunchLab ilk program sürümündedir. CLMM gibi, iyileştirmeler yeni nesiller olarak değil, 24 saat zaman kilidi arkasında yerinde yükseltmeler olarak gönderilir. Yükseltmeler aracılığıyla gelişen olanlar:

• Yaratıcı ücret yuvası. Başlatmaların mezuniyet sonrası CPMM işlem ücretlerinin bir kısmını orijinal yaratıcıya yönlendirebilmesi için eklendi. Bkz. products/launchlab/creator-fees.
• Eğri formülü yapılandırılabilirliği. Orijinal olarak sabit kodlanmış ikinci dereceden; şimdi LaunchConfig küçük bir eğri şekilleri kümesinden seçim yapar.

Mevcut LaunchLab başlatmaları yükseltmelerden etkilenmez — bir başlatma başlatıldıktan sonra, parametreleri mezuniyete kadar dondurulur.

​

Programlar arası sürüm uyumluluğu

Entegratörlerin rutin olarak karşılaştığı birkaç çapraz ürün uyumluluk notu:

• CLMM SwapV2 Swap talimatı ile aynı değildir. İstemciniz yalnızca Swap konuşuyorsa, Token-2022 transfer ücretlerini sessizce yanlış işleyecektir — matematik ücret miktarı kadar yanlıştır. SwapV2’ye güncelleyin.
• Farm v6 staking’i CLMM pozisyonları ile LP token staking’in yolu olmayan desteklenmez. CLMM pozisyonları NFT’lerdir, fungible LP token’ları değildir. CLMM bunun yerine kendi yerel ödül mekanizmasına sahiptir — bkz. products/clmm/fees.
• Token-2022 mintleri tarafından desteklenen CPMM havuzları yalnızca Farm v6’da farmlar içinde çalışır. v3 ve v5 Token-2022 staking mintlerini reddeder.
• AMM v4 havuzları hiçbir zaman Token-2022 LP mintlerine sahip değildir. Eğer birini görürseniz, sahte — AMM v4 bu kombinasyonu desteklemez.

​

Daha fazla bilgi nerede bulunur

• introduction/history-and-milestones — kronolojik sürüm zaman çizelgesi ve her sürümün ne zaman ve neden geldiği.
• user-flows/migrate-amm-v4-to-cpmm — v4 → CPMM hareketi için operatör çalışma kitabı.
• user-flows/choosing-a-pool-type — yeni havuz dağıtımları için karar ağacı.
• products/farm-staking/accounts — v3 / v5 / v6 için yan yana şema.
• reference/changelog — program sürümleri geliştiğinde bu belgelerde ne değişti.

Kaynaklar:

• Yukarıda satır içinde alıntılanan ürüne özgü bölüm sayfaları.
• Raydium SDK v2 — sürüm farkında gönderme mantığı, belirli bir havuzun hangi programa ait olduğunu doğrular.
• reference/program-addresses — sürüm başına kanonik ID’ler.