Skip to main content
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 →
Bu belgelerdeki her şey, çalışan bir Solana geliştirme araç zincirinin mevcut olduğunu varsayar. Bu sayfa araçları, Eylül 2026 itibariyle Raydium ile çalışması bilinen sürümleri ve belirli kurulum sorunlarını listeler. Sonraki bölümlerdeki kod örneklerinden herhangi birini çalıştırmadan önce buradan başlayın. İki sürüm seti önemlidir ve bunlar aynı değildir. Raydium programlarını oluşturmak veya çatallak için, pinledikleri tam araç zincirini gerekir — Rust 1.91.0, Agave 3.1.10, Anchor 1.0.2 (2026-09-09 yükseltmesi itibariyle). TypeScript veya Python’dan dağıtılan programlara karşı entegre olmak için, onlarla konuşmak için yeterince güncel bir istemci kitaplığına ihtiyacınız vardır ve pinler tavsiye niteliğindedir. Aşağıdaki her bölüm hangi durumu kapsadığını söyler.

Temel araçlar

Solana CLI

Solana kümeleriyle etkileşim kurmak için kanonik komut satırı arayüzü — cüzdan yönetimi, RPC çağrıları, program dağıtımı. Yükleme:
Doğrulama:
Yükleme ana bilgisayarı taşındı. release.solana.com Solana Labs’a aitti; istemci artık Anza tarafından Agave olarak korunmakta ve sürümler release.anza.xyz adresinden sunulmaktadır. Kendi kendini güncelleyen ikili agave-install (solana-install eski bir takma ad olarak tutulur), bu nedenle agave-install update ve agave-install init <version> geçerli yazımlarıdır. Solana’nın kendi belgeleri ayrıca CLI, Rust ve Anchor’u birlikte çeken tek komutlu bir yükleyici sunar:
Bu yükleyici kendi mevcut fikrini takip eder ve Raydium’un programlarının pinlediklerinden farklı bir Anchor size verebilir — sonrasında anchor --version kontrol edin.
Mainnet için yapılandırma:
Raydium testi için neredeyse her zaman finanse edilmiş bir devnet cüzdanı isteyeceksiniz:

SPL Token CLI

SPL Token / Token-2022 işlemleri için resmi CLI — mint’ler oluşturma, token’ları basma, aktarma. Yükleme (Solana CLI’ye dahil):
Yaygın işlemler:

Anchor CLI

Raydium IDL’lerini getirmek, istemciler oluşturmak ve programları doğrulamak için gerekli. Yükleme:
Anchor depo ve ana sürümü taşındı. Kanonik depo artık github.com/solana-foundation/anchor (coral-xyz/anchor idi) ve Anchor 1.0, Raydium programlarının kullandığı ilk sürüm satırıdır — CPMM ve LaunchLab her ikisi de anchor-lang/anchor-spl =1.0.2 pinler (2026-09-09 yükseltmesi itibariyle), CLMM 2026-09-30 yükseltmesinde takip eder, hepsi 0.32.1’den yukarı. avm birkaç sürümü tutabilir; avm use 1.0.2 anchor build’in Raydium’un yapılarını yeniden üretmesini sağlayan şeydir. Anchor 1.1 ve 1.2 var ve kendi programlarınız için iyi oluşturulur, ancak hedef programın pinlediklerinden farklı bir anchor-lang minörüne karşı derlenmiş bir CPI sandığı bağlanmayacaktır — bkz. sdk-api/rust-cpi.
Yaygın işlemler:

TypeScript kurulumu

Raydium için birincil entegrasyon yolu.

Paketler

Eylül 2026 itibariyle birlikte çalışması bilinen sürümler:
@coral-xyz/anchor donduruldu; paket artık @anchor-lang/core. @coral-xyz/anchor Anchor Coral’dan çıktığında 0.32.1’de durdu. Anchor 1.x @anchor-lang/core olarak yayınlanır ve Raydium’un kendi program depoları 2026-09-09 yükseltmelerinde test paketlerini buna geçti (CLMM 2026-09-30’da). Gerçekten kullandığınız içe aktarmalar değişmez — import { Program, BN, AnchorProvider } from "@anchor-lang/core" — bu nedenle geçiş bir paket yeniden adlandırması artı bir lockfile güncellemesidir.0.3x’ten uzaklaşıyorsanız iki davranışsal not: .accounts({...}) artık yalnızca Anchor’un kendisi çözemediği hesapları kabul eder, bu nedenle tam seti geçen bir oluşturucu bunun yerine .accountsPartial({...}) çağırmalıdır; ve @anchor-lang/core/dist/cjs/utils/token ASSOCIATED_PROGRAM_ID gibi yardımcıların taşındığı yerdir.

Minimal betik

Tam SDK referansı için sdk-api/typescript-sdk bölümüne bakın.

Rust kurulumu

CPI entegrasyonu ve zincir üstü programlar için.

Araç zinciri

Programları cargo build-sbf ile oluşturun (eski cargo build-bpf yazımı gitti).

Raydium CPI entegrasyonu için Program Cargo.toml

anchor-lang ve anchor-spl’yi hedef programın pinledikleri sürüme = ile sabitleyin. chore/upgrade-anchor dallarında, CPMM ve CLMM her ikisi de =1.0.2 pinler, bu nedenle tek bir sandık her ikisine de CPI yapabilir. Her iki deponun master hala 0.32.1 pinler ve bir master bağımlılığını bir yükseltme dalı bağımlılığıyla karıştıran bir sandık oluşturmayacaktır. sdk-api/rust-cpi bölümüne bakın. "cpi" özelliği CPI yardımcılarıyla cpi modülünü içe aktarır (böylece raydium_cp_swap::cpi::swap_base_input(...) yapabilirsiniz). sdk-api/rust-cpi bölümüne bakın.

Python kurulumu

İkincil entegrasyon yolu — bot geliştiricileri için yaygın.

Paketler

Sürümler:
İki adlandırma tuzağı. RPC istemcisi solana olarak içe aktarılır ancak proje solana-py olarak adlandırılır — pip install solana-py hiçbir şey yararlı yüklemez. Ve PyPI’de raydium-py paketi yoktur: topluluk Raydium yardımcısı klonladığınız bir depo, AL-THE-BOT-FATHER/raydium_py, yayınlanmış bir dağıtım değil. Bu sayfanın önceki revizyonları hiçbir zaman çalışmayan pip install raydium-py satırını listeledi.

Minimal betik

sdk-api/python-integration bölümüne bakın.

RPC uç noktaları

Genel mainnet RPC (api.mainnet-beta.solana.com) ağır oranda sınırlandırılmış ve herhangi bir yük altında kısıtlanır. Önemsiz olmayan kullanım için özel bir uç nokta alın: Yapılandırma:
Bazı RPC işlemleri genişletilmiş yetenekler gerekir:
  • getProgramAccounts — sınırsız taramalar pahalıdır; bazı sağlayıcılar kapı veya tarama başına ücret alır.
  • getPriorityFeeEstimate — Helius’a özgü uç nokta; diğerlerinin eşdeğerleri vardır.
  • geyser / WebSocket akışı — düşük gecikmeli botlar için gerekli; tüm sağlayıcılar bunu ortaya çıkarmaz.

Devnet ve localnet

Devnet

Solana’nın genel test kümesi. Raydium’un kısmi bir devnet dağıtımı vardır:
  • Test için bazı CPMM havuzları vardır.
  • AMM v4’ün tarihsel devnet havuzları vardır.
  • CLMM’nin birkaç demo havuzu vardır.
  • Farm v6 dağıtılmıştır.
SDK devnet’i cluster: "devnet" aracılığıyla destekler:
Uyarı: devnet havuzlarının ince likiditeleri vardır ve eski duruma sahip olabilir. Fiyat keşfi için devnet’e güvenmeyin; bunu yalnızca talimat akışları oluşturma ve test etme için kullanın.

Çatallı mainnet durumu ile localnet

Gerçekçi test için mainnet durumunu yerel bir doğrulayıcıya çatallayın:
Bu belirli program/hesap durumunu localhost’a klonlar; burada serbestçe işlem yapabilirsiniz. İdeal:
  • CPI entegrasyonunuzu gerçek bir Raydium programına karşı birim test etmek.
  • Hata ayıklamak için değiştirilmiş bir parametre ile bir işlemi yeniden oynatmak.
  • Büyük sentetik hacimlerle stres testi yapmak.
Raydium’un ekibi mainnet dağıtımından önce regresyon testi için çatallı localnet’i kapsamlı bir şekilde kullanır.

Proje şablonları

TypeScript entegrasyon başlangıcı

Minimal package.json:

Anchor CPI program başlangıcı

Anchor 1.0 ile:

Yararlı CLI yardımcıları

solana-keygen

Herhangi bir hesabı okuma

Bir çözücü olmadan havuz durumunu göz atmak için yararlı.

Program günlükleri

İşlem incelemesi

Veya explorer aracılığıyla — imzayı yapıştırın ve “Program Logs” sekmesine bakın.

Ortam hijyeni

Amaç başına ayrı cüzdanlar

  • Geliştirme cüzdanı: testnet SOL tutar, oluşturma için kullanılır.
  • Üretim cüzdanı: gerçek SOL tutar, yalnızca dağıtımlar / multisig gönderileri için kullanılır.
  • Botlar için sıcak cüzdan: küçük bakiye, dar izinler.
Anahtarlar asla kodlanmış olmamalıdır. Ortam değişkenlerini veya gizli yöneticileri kullanın.

.env deseni

Sürüm sabitleme

Tüm Solana ekosistemi bağımlılıklarını kilitleyin. Ekosistem hızlı hareket eder; @solana/web3.js’nin küçük bir sürüm çarpması daha önce kırıcı değişiklikler getirmiştir. package-lock.json / Cargo.lock kullanın dini bir şekilde.

İşaretçiler

Kaynaklar: