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’u entegre eden cüzdanlar, genellikle her kullanıcı için dört soruyu yanıtlamak zorundadır: bu kullanıcı hangi havuzlarda LP’ye sahiptir? hangi pozisyonları (CLMM NFT’leri) tutarlar? hangi çiftçiliklere hisse tutarlar? hepsinin değeri ne kadardır? Bu sayfa bunların her birini belgelemektedir.
Raydium pozisyonlarını algılama
Klasik LP tokenleri (CPMM, AMM v4)
Bunlar diğer SPL Token’ler gibi görünür: kullanıcının ATA’sı bir bakiye tutar. Bir cüzdan bunu varsayılan olarak sadece başka bir token olarak gösterir. Bunu bir Raydium LP pozisyonu olarak ortaya koymak için:- Kullanıcının token hesaplarını numaralandırın:
connection.getParsedTokenAccountsByOwner(user, { programId: TOKEN_PROGRAM_ID }). - Her mint için Raydium’un mint listesini kontrol edin:
GET https://api-v3.raydium.io/pools/info/lps?lps=<LP_MINT>,...(çağrı başına ~50 LP mint’e kadar toplu işleyin). - Eşleşen mintler için, API havuz referansını döndürür. Pozisyonun token ile gösterilen değerini hesaplamak için kullanın:
CLMM pozisyon NFT’leri
CLMM pozisyonları NFT’lerdir. Her pozisyonunPersonalPositionState PDA’sı NFT mint’inden türetilir. Algılamak için:
- Kullanıcının NFT’lerini numaralandırın. Eski Metaplex NFT’leri için: token hesaplarını, arzı 1 ve ondalık basamağı 0 olan olanlarla filtreyin.
- Her NFT mint’i için PersonalPositionState PDA’sını türetmeyi deneyin:
-
raydium.clmm.getPositionInfo({ positionPda })aracılığıyla kodunu çözerek şunları alın:poolId→ mint’leri çözmek için havuzu getirtickLower,tickUpper→ aralığını gösterliquidity,tokensOwedA/B→ pozisyon değeri + bekleyen ücretleri hesaplarewardInfos→ akış başına bekleyen ödüller
-
Token-2022 altında verilen pozisyon-NFT’leri için (
OpenPositionWithToken22Nft), NFT mint’inin programı SPL Token yerine Token-2022’dir. Tarama yaparken her ikisini de numaralandırın.
Çiftçilik hisseleri
Farm v3 / v5 / v6’nın her biri kullanıcı başına bir defter PDA’sına sahiptir. Türetmeler:UserLedger PDA’larını, kullanıcıyı “olası” çiftçilik kimliği listesine göre karma yaparak yinelenebilir. Tüm çiftçilik kimliklerini kapsamlı olarak numaralandırmak pratik değildir (binlerce vardır); API’yi kullanın.
Pozisyon değerini hesaplama
CPMM / AMM v4 LP
raydium.token veya fiyat oracle’ından).
CLMM pozisyonu
- Likidite değeri (cari fiyat)
- Toplanmayan ücretler
- Akış başına bekleyen ödüller
- Aralık:
[tickLower_price, tickUpper_price]cari fiyatın aralık içinde olup olmadığını gösteren görsel bir çubukla
Çiftçilik hissesi
reward_per_share_x64’ü tembel güncelleme formülüyle yenileyin (geçen süre × emisyon hızı ÷ toplam_hisse).
İşlem simülasyonu ön izlemesi için
Kullanıcı imzalamadan önce, cüzdanlar genellikle bakiye değişikliklerini ön izlerler.simulateTransaction kullanın:
accounts parametresi, doğrulayıcıdan listelenen adresler için simülasyon sonrası hesap durumunu döndürmesini ister. Bakiye değişimini sadece yönerge şeklinden tahmin etmeye çalışmaktan çok daha doğru.
Simülasyon tuzakları
- CLMM swapleri geçerli tick dizileri gerektirir. Kullanıcının giriş boyutu başlatılmamış bir tick dizisine geçerse, simülasyon geri alır (yürütme ile aynı). Bunu açıkça arayüzde gösterin.
- Öncelik ücreti. Simülasyon, uygulanmış hesaplama bütçesi yönergeleri olmadan çalışır. Varsayılan 200k CU’yu aşan büyük bir işlem için simülasyon başarısız olur, ancak açık bir CU sınırı ile gerçek yürütme başarılı olur. Simülasyona yapılan işlemde de CU sınırını her zaman ayarlayın.
- Taze blockhash. Simülasyon geçerli blockhash’i kullanır; imzalama 60 saniyeden fazla sürerse işlem geçersiz hale gelir. Kullanıcı duraksamazsa yeniden simülasyon yapın.
Token-2022 görüntüleme
Token-2022 programı altındaki tokenlerin, farklı risk yüzeylerine sahip oldukları için cüzdanın token listesinde bu şekilde etiketlenmesi gerekir:- Transfer-ücret mint’leri: mevcut
transferFeeBasisPoints’i bakiyenin yanında “Transfer ücretine: X%” olarak gösterin. Alırken uyarı yapın — kullanıcılar gönderenin gönderdiklerinden daha azını alacaklarını fark etmeyebilirler. - Transfer-hook mint’leri: hook programı kimliğini gösterin. Kötü amaçlı bir hook giden transferleri engelleyebilir; kullanıcılar hook’un bekledikleri olduğunu doğrulamalıdırlar.
- Aktarılmayan mint’ler: “Aktarılamaz” gösterin ve swap/göndermeyi devre dışı bırakın. Bunlar tipik olarak soulbound tokenleri veya kimlik bilgileridir.
- Faiz getiren mint’ler:
TokenAccount.amount’tan türetilen arayüz bakiyesi tahakkuk eden faizi yansıtmaz. Gösterilen değer için@solana/spl-token’danamountToUiAmountkullanın (ölçek faktörünü uygular).
Çiftçilik APR görüntüsü
Kullanıcılara gösterilen APR, tüm canlı ödül akışlarını birleştirmeli, USD’ye dönüştürmeli ve annualize etmelidir:APR: X.Y% olarak gösterin. Hisse mint’i bir LP token’i ise, temel LP’nin temel ücret APR’sini de hesaplayın ve toplamı “Toplam APR” veya “APR + ücretler” olarak etiketleyin.
İşaretçiler
products/clmm/ticks-and-positions— pozisyon-değeri türetme.products/farm-staking/accounts— çiftçilik durum alanları.algorithms/token-2022-transfer-fees— transfer-ücret tokenleri için görüntüleme semantiği.
- Raydium SDK v2 — pozisyon/çiftçilik yardımcıları.
api-v3.raydium.io’daki kullanıcı-pozisyon uç noktaları.


