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ı, Raydium ile çalışması bilinen sürümleri (Eylül 2026 itibariyle) 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 tam olarak sabitlediği 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 yalnızca onlarla konuşmak için yeterince güncel bir istemci kitaplığına ihtiyacınız vardır ve sürüm sabitlemeleri tavsiye niteliğindedir. Aşağıdaki her bölüm hangi durumu kapsadığını belirtir.

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ı. Kurulum:
Doğrulama:
Kurulum 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> güncel yazılışlardı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 güncel fikrini takip eder ve Raydium’un programlarının sabitlediğinden 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. Kurulum (Solana CLI’ye dahil):
Yaygın işlemler:

Anchor CLI

Raydium IDL’lerini getirmek, istemciler oluşturmak ve programları doğrulamak için gerekli. Kurulum:
Anchor depo ve ana sürümü taşındı. Kanonik depo artık github.com/solana-foundation/anchor (daha önce 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 2026-09-09 yükseltmesi itibariyle anchor-lang/anchor-spl =1.0.2 sabitlemiştir, 0.32.1’den yükseltilmiştir. 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 mevcut ve kendi programlarınız için iyi oluşturulur, ancak hedef programın sabitlediğinden 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 dondurulmuştur; paket artık @anchor-lang/core’dir. @coral-xyz/anchor, Anchor Coral’dan ayrıldığı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ükseltmesinde test paketlerini buna geçirdi. Gerçekten kullandığınız içe aktarmalar değişmemiştir — import { Program, BN, AnchorProvider } from "@anchor-lang/core" — bu nedenle geçiş yapmak bir paket yeniden adlandırması artı bir lockfile güncellemesidir.0.3x’ten geçiyorsanı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ılışı gitti).

Raydium CPI entegrasyonu için Program Cargo.toml

anchor-lang ve anchor-spl’yi hedef programın sabitlediği sürüme = ile sabitleyin. 2026-09 itibariyle CPMM =1.0.2 sabitlemiş ve CLMM hala =0.32.1 sabitlemiştir, bu nedenle tek bir sandık her ikisine de CPI yapamaz — bkz. sdk-api/rust-cpi. "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). Bkz. sdk-api/rust-cpi.

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ğildir. Bu sayfanın önceki revizyonları hiçbir zaman çalışmayan bir pip install raydium-py satırı listelemiştir.

Minimal betik

Bkz. sdk-api/python-integration.

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ş yeteneklere ihtiyaç duyar:
  • 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ı mevcuttur.
  • AMM v4’ün tarihsel devnet havuzları vardır.
  • CLMM’nin birkaç demo havuzu vardır.
  • Farm v6 dağıtılmıştır.
SDK, cluster: "devnet" aracılığıyla devnet’i destekler:
Uyarı: devnet havuzlarının ince likiditeleri vardır ve eski duruma sahip olabilir. Fiyat keşfi için devnet’e güvenmeyin; yalnızca talimat akışlarını oluşturmak ve test etmek için kullanın.

Çatallı mainnet durumuna sahip 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 parametreyle 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 hiçbir zaman 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’u dindar bir şekilde kullanın.

İşaretçiler

Kaynaklar: