Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

Bu sayfa yapay zekâ tarafından otomatik olarak çevrilmiştir. İngilizce sürüm esas alınır.İngilizce sürümü görüntüle →
Raydium beş yıllık bir geçmişe sahiptir. Programlarının birçoğu üçüncü veya dördüncü kuşaktadır. Bu sayfa, operatör perspektifinden “hangi program sürümünü kullanacağım, eski sürümlerin durumu nedir ve eğer bugün eski sürümde çalışıyorsam A’dan B’ye nasıl geçerim?” sorularının yanıtlarını sunmaktadır.

Duruma genel bakış

ProgramGüncelKullanımdan KaldırılmışYeni KonuşlandırmalarMevcut Örnekler
AMM v4v4 (tek kuşak)HayırÖnerilmemekle birlikte kabul edilirTamamen çalışır
CPMMv1Önerilen varsayılanTamamen çalışır
CLMMv1Aralıklı LP’ler için önerilirTamamen çalışır
Farmv6v3, v5Yalnızca v6v3 + v5 faz çıkışında (çoğunlukla salt okunur)
LaunchLabv1Yeni başlatmalar için önerilirTamamen çalışır
Bu tablodan en önemli çıkarım: AMM v4 kullanımdan kaldırılmamıştır ve CPMM yeni varsayılandır — ancak birlikte var olurlar. AMM v4 havuzlarının yılların işlem geçmişi vardır ve zorla geçirilmemektedir. Yeni bir havuz başlatırken seçilecek program, kısıtlama değil önerildir.

AMM v4 — durum ve yörünge

AMM v4, orijinal Raydium havuz tasarımıdır: sabit-çarpım fiyatlandırması (x · y = k). OpenBook (eski adıyla Serum) emir defteri entegrasyonu ile melez AMM olarak başlatılmıştır; defteri sınırlı bir pazara limit emirler olarak yansıtmıştır. OpenBook entegrasyonu devre dışı bırakılmıştır — havuzlar artık OpenBook ile likidite paylaşmaz ve tüm swaplar V2 swap entrypoint’leri aracılığıyla tamamen eğri karşısında gerçekleşir. Günümüzde AMM v4, uygulamada OpenBook hesapları atıl durum olarak korunmuş, salt sabit-çarpım AMM’dir.

Neler donmuş

  • Yeni ücret seviyeleri yok. AMM v4 ücret yapısı havuz başına belirlenmiş olup konuşlandırma sırasında ayarlanmıştır. Yeni havuzlar aynı sabit kodlanmış ~%0,25 işlem ücreti, ~%12’si protokolü kabul ederler.
  • Yeni özellik çalışması yok. CPMM yeni varsayılan olunca takım AMM v4’e yeni komutlar eklemiş değildir. Program bakım modundadır — yalnızca hata düzeltmeleri, kapsam genişlemesi yoktur.
  • Token-2022 desteği yoktur. AMM v4, Token-2022 var olmadan önce yazılmış olup entegrasyon asla geriye dönük olarak yapılmamıştır. Token-2022 mintleri CPMM (veya uygunsa CLMM) kullanmak zorundadır.
  • OpenBook entegrasyonu devre dışı. Her AMM v4 havuzu halen zincir üzerinde karşılık gelen OpenBook pazar hesabına bağlıdır, ancak havuz artık o pazarda emirler yayınlamaz veya bakım yapmaz. OpenBook kesintisi artık AMM v4 swaplarını etkilemez.

Halen çalışan neler

  • Mevcut havuzlar normal şekilde işlem görür. Zorunlu durrum geçişi yapılmamıştır; 2021’de oluşturulan v4 havuzları 2026’da birçok yüksek hacimli çift için halen aktif mekan olacaktır.
  • LP’ler her zamanki gibi yatırabilir, çekebilir ve farm ödüllerini hasat edebilir. CPMM’ye geçiş seçimlidir.
  • Agregörleri halen 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 halen kullanmalı

Açıkçası: nadiren. v4’ün daha iyi cevap olduğu durumlar sınırlıdır:
  • Çiftin zaten derin, iyi işlem gören bir v4 havuzu vardır ve mevcut derinliğe likidite eklemek istiyorsunuz, pazarı bölmek yerine.
(OpenBook entegre yönlendirme artık AMM v4 seçmenin nedeni değildir — bu entegrasyon kapalıdır.) Diğer her durumda, CPMM’de yeni havuzları 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 (constant-product market maker, iç ad raydium-cp-swap) 2024’te yeni varsayılan sabit-çarpım havuzu olmayı amaçlayan temiz oda yeniden yazımı olarak konuşlandırılmıştır. Yapısal olarak Raydium programlarının en basiti: saf x · y = k, emir defteri yok, yerel Token-2022 desteği, daha küçük işlem kapasitesi.

CPMM’nin AMM v4’e göre getirdikleri

  • Varsayılan olarak daha iyi LP ekonomisi. CPMM’nin varsayılan AmmConfig tüm işlem ücretlerini LP’lere yönlendirir (protokol ücreti katman başına değiştirilebilir). AMM v4 ~%12’yi protokole sabit kodlar.
  • Daha düşük havuz oluşturma maliyeti. OpenBook pazarı gerekmez. Oluşturma bir işlem, ~0,15 SOL kirayı v4 için ~0,6 SOL’ye karşı.
  • Token-2022. Transfer ücreti mintleri, transfer hook mintleri (uyarılarla), gizli transferler — tümü CPMM’de desteklenir, v4’te hiçbiri desteklenmez.
  • Temiz entegratör yüzeyi. CPMM’nin Anchor-CPI-dostu yayınlanmış crate’i (raydium-cp-swap), daha basit hesap listesi ve kararlı IDL’si vardır. AMM v4 IDL gönderir ancak asla bakımı yapılan Rust CPI crate’i olmamıştır.
  • Swap başına daha küçük hesap listesi. ~10 hesap vs v4 için ~17 (OpenBook pazar hesaplarını taşır, bunları vurmuyor olsa da).

Geçişin değer bulduğu durumlar

Aktif şekilde işlem gören bir havuz için, LP-ücret artışı tek başına birkaç ay içinde geçişi haklı kılar. Aritmetik: günde 0,25% × $X hacimli havuz v4’te %0,03 protokole verir (%12 eksik). CPMM’de bu LP’lere geri döner. Bir yılda bu çarpılır. Düşük hacimli havuz için geçiş daha çok geleceğe hazırlık konusudur — daha iyi varsayılanlar, ihtiyacınız olursa Token-2022 desteği, daha kolay entegrasyonlar.

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

Yerinde yükseltme yoktur. Geçiş yeni-havuz-oluştur, eski-havuz-boşalt, yeni-havuz-doldur dizisidir. Tam adım adım user-flows/migrate-amm-v4-to-cpmm’da bulunmaktadır; üst seviye şekil:
  1. Aynı çift için yeni CPMM havuzu oluşturun, korumak istediğiniz aynı ücret katmanında.
  2. LP’leri koordine edin: eski havuzun boşaltıldığı ve yeni havuzun desteklendiği dönem duyurun.
  3. Her LP v4 havuzundan çeker ve yeni CPMM havuzuna yatırır.
  4. (İsteğe bağlı) CPMM tarafı farm’ı kurun, teşvik edilen LP’leri yeni havuza çekmek için.
  5. Agregörlerin daha derin havuza doğru yeniden ağırlıklandırması sırasında hacmi geçişini izleyin.
Zincir bunlardan hiçbirini zorlamaz — Raydium’un API’si ve ön ucu yalnızca hangisinin daha derin olduğunu tercih ederler ve agregörler kullanıcıya en ucuz olanı 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 kuşak olarak değil, aynı program ID’sine yerinde yükseltmeler olarak gönderilmiştir (24 saat zaman kilitli multisig’nin arkasında). Bu, CLMM geçiş hikayesi olmadığı anlamına gelir: mevcut pozisyonlar orada kalır ve yükseltme gönderildiğinde programın davranışı incelikle değişebilir, ancak hesap düzenleri ve PDA’lar kararlıdır. CLMM yükseltmeleri arasında neler değişmiş:
  • SwapV2 komutu eklendi, Token-2022 transfer ücreti matematiğini doğru şekilde desteklemek için. Eski Swap halen çağrılabilir; yeni entegrasyonlar SwapV2’i hedeflemelidir.
  • Ödül akışı uzantılarıRewardInfo yuva sayısı çıkartıldı (orijinal 3 → halen 3 şu anda, ancak rezervasyon deseni sıkılaştırıldı). Veri geçişi gerekmez.
  • Onay dizisini sıkıştırma — birçok onayı geçen swap’lerdeki CU’yu azaltmak için iç optimizasyon. Dışarıdan görülmez.
IDL, adanmış raydium-idl deposunda yaşar (bkz. sdk-api/anchor-idl). Eski SDK’yı güncel programa karşı çalıştırıyorsanız, en kötü durum yeni komutları 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. Üç kuşak ayrı programlar ayrı program ID’leri ve ayrı durum düzenleridir.

Kuşaklar

SürümYayınlandıDurumTemel Özellikler
v32021Faz çıkışında. Mevcut farm’lar çalışır; yeni farm’lar kabul edilmez.Tek ödül akışı. Yuva temelli emisyon.
v5Eki 2022Faz çıkışında. Mevcut farm’lar çalışır; yeni farm’lar kabul edilmez.2 ödül akışına kadar. Yuva temelli emisyon. Tamsayı per_second.
v62024Güncel. Tüm yeni farm’lar.5 ödül akışına kadar. Gerçek zaman emisyonu. Q64.64 sabit noktalı per_second. Token-2022 stake + ödül desteği.

Neden üç kuşak mevcut

  • v3 → v5: eşzamanlı birden fazla ödül akışı gerekli (örn. çift teşvik farm’ları). v3’ün tek akış tasarımı yeniden tasarım olmadan bunu destekleyemez.
  • v5 → v6: v5’in u64 tamsayı emisyon oranı minimum ifade edilebilir oranı “1 token birimi/saniye” ile sınırlar. 9 ondalak mint için bu 1 lamport/sn’dir — düşük emisyon programları için çok kısadır. v6’nın Q64.64 kesirli oranı bunu düzeltir. v6 ayrıca yuva temelli güncellemesini gerçek zamana kaldırdı ve Token-2022 desteğini ekledi.

Kuşaklar arasında değişmeyen neler

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

Geçiş yolu

Farm sürümleri arasında yerinde geçiş yoktur. v3/v5’ten v6’ya taşımak için:
  1. Mevcut farm’ın emisyonunun bitmesini bekleyin (veya bitir).
  2. Stake’çiler eski farm’a çekişen ve talep eden ödülleri geri alırlar.
  3. Farm operatörü aynı stake mint karşısında yeni v6 farm’ı oluşturur.
  4. Stake’çiler yeni farm’a yeniden stake ederler.
Zincir üstü gerçeklik iki ilişkisiz farm hesabıdır. Her ikisinde stake bulunan bir kullanıcının iki UserLedger (v6) / UserStake (v5) kaydı vardır.

v3 ve v5 için “faz çıkışı” ne anlama gelir

  • v3 ve v5 programları halen konuşlandırılmış ve çağrılabilirdir. Mevcut farm’lar halen beklenen ödülleri dağıtabilir ve çekilişleri kabul edebilir.
  • Raydium UI helen v3 ve v5 farm’larını etkin ödüllerle gösterir; v3/v5 farm’ının end_time’ı geçtiğinde UI bunu “etkin”den gizler ama talep edilebilir tutar.
  • Takım yeni v3/v5 farm’ları oluşturmayacaktır. “Farm oluştur” için SDK yardımcıları yalnızca v6’ya yönlendirilir.
  • v3 ve v5 güvenlik yükseltmeleri alıyorlar ancak özellik çalışması almıyorlar. Kritik bir hata bulunursa düzeltilir; faydalı olabilecek bir özellik varsa v6’ya eklenir.
Sürüm başına tam ayrıntı products/farm-staking/accounts ve products/farm-staking/instructions’da bulunmaktadır.

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

LaunchLab ilk program sürümündedir. CLMM gibi, iyileştirmeler 24 saat zaman kilitli multisig’nin arkasında yerinde yükseltmeler olarak gönderilir — yeni kuşaklar olarak değil. Yükseltmeler aracılığıyla neler evrimleştirmiş:
  • Yaratıcı-ücret yuvası. Başlatmalar mezuniyetten sonra CPMM işlem ücretlerinin bir kısmını orijinal yaratıcıya yönlendirebilir. Bkz products/launchlab/creator-fees.
  • Eğri-formül yapılandırılabilirliği. Orijinal olarak sabit kodlanmış ikinci dereceli; şimdi LaunchConfig küçük bir eğri şekiller kümesinden seçer.
Mevcut LaunchLab başlatmaları yükseltmelerden etkilenmez — başlatma başlatıldıktan sonra parametreleri mezuniyete kadar donmuştur.

Programlar arası sürüm uyumluluğu

Entegratörlerin rutin olarak vurdukları birkaç ürünler arası uyumluluk notu:
  • CLMM SwapV2, Swap komutu ile aynı değildir. Müşteri yalnızca Swap konuşursa Token-2022 transfer ücretlerini sessizce yanlış işleyecektir — matematik ücret tutarı kadar yanlıştır. SwapV2’ye güncelleyin.
  • Farm v6 stake CLMM pozisyonlarla LP-token stake gibi desteklenmez. CLMM pozisyonları NFT’lerdir, fungible LP tokenler değildir. CLMM bunun yerine kendi yerel ödül mekanizmasına sahiptir — bkz products/clmm/fees.
  • CPMM havuzları Token-2022 mintleri tarafından desteklenenler yalnızca Farm v6’da farm’larda çalışırlar. v3 ve v5 Token-2022 stake mintlerini reddederler.
  • AMM v4 havuzları hiçbir zaman Token-2022 LP mintine sahip değildir. Birini görürseniz, taklit olur — AMM v4 bu kombinasyonu desteklemez.

Daha fazla bilgi nerede bulunur

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