TypeScript SDK

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.

​

Kurulum

npm install @raydium-io/raydium-sdk-v2 @solana/web3.js @solana/spl-token
# veya
pnpm add @raydium-io/raydium-sdk-v2 @solana/web3.js @solana/spl-token

​

Başlatma

import { Raydium } from "@raydium-io/raydium-sdk-v2";
import { Connection, Keypair, clusterApiUrl } from "@solana/web3.js";

const connection = new Connection(process.env.RPC_URL ?? clusterApiUrl("mainnet-beta"));
const owner      = Keypair.fromSecretKey(/* ... */);

const raydium = await Raydium.load({
  owner,
  connection,
  cluster: "mainnet",           // "mainnet" | "devnet"
  disableFeatureCheck: true,    // SDK'nin başlangıç özellik tespiti API çağrısını atlayın
  blockhashCommitment: "confirmed",
});

​

Dört modül cephesi

raydium.cpmm       // CPMM havuzları: createPool, addLiquidity, withdrawLiquidity, swap, ...
raydium.clmm       // CLMM havuzları: createPool, openPositionFromBase, increasePositionFromBase,
                   //                  decreaseLiquidity, harvestAllRewards, swap, ...
raydium.liquidity  // AMM v4 havuzları: computeAmountOut, swap, addLiquidity, removeLiquidity, ...
raydium.farm       // Farm v3/v5/v6: deposit, withdraw, harvestAllRewards, create, setRewards
raydium.launchpad  // LaunchLab: createLaunchpad, buyExactIn, sellExactIn, graduate, ...
raydium.trade      // Çok havuzlu yönlendirme: quotes, route-execution (0.2.41'de beta)
raydium.token      // Yardımcılar: token listesi, meta veri, ATA oluşturma

​

İşlem yapıcıları

const { execute, builder, transaction, innerTransactions, extInfo } =
  await raydium.cpmm.addLiquidity({
    poolInfo,
    amountInA,
    amountInB,
    slippage: 0.005,
    txVersion: TxVersion.V0,
  });

• execute — imzalayan ve gönderen kolaylık fonksiyonu. builder.execute ile eşdeğer.
• builder — biriken tüm talimat ve imzacılarla TxBuilder örneği. Bir VersionedTransaction[] almak için .build() öğesini çağırın; kendi talimatlarınızı enjekte etmeniz veya harici imzacılarla imzalamanız gerektiğinde kullanılır.
• transaction / innerTransactions — ham talimat dizileri. Oluşturulan çok programlı işlemleri oluştururken kullanılır.
• extInfo — ürüne özgü ekstralar. Örneğin, createPool extInfo.poolId döndürür; createLaunchpad yeni başlama durumu PDA’sını döndürür.

​

Neden asenkron yapıcılar?

​

CLMM modülü eklemeleri (en son sürüm)

• raydium.clmm.createCustomizablePool — collectFeeOn, enableDynamicFee ve dynamicFeeConfigId kabul eden createPool üst kümesi. Yeni kontroller gereken herhangi bir yeni havuz için bunu kullanın; klasik createPool varsayılan ücretli havuzlar için çalışmaya devam eder.
• raydium.clmm.openLimitOrder — bunu destekleyen bir havuzda tek tik limit emri açın. poolInfo, poolKeys, limitOrderConfig (/main/clmm-limit-order-config’ten), inputMint, inputAmount ve hedef tick alır.
• raydium.clmm.increaseLimitOrder / decreaseLimitOrder — mevcut bir emrin doldurulmamış kısmını ayarlayın. Azalma, tam olarak doldurulmuş bir emri InvalidOrderPhase ile geri çevirir.
• raydium.clmm.settleLimitOrder / settleAllLimitOrder — doldurulmuş çıktıyı sahibinin ATA’sına tarayın. Emrin sahibi veya havuzun limit_order_admin bekçisi bunları çağırabilir.
• raydium.clmm.closeLimitOrder / closeAllLimitOrder — kira geri kazanmak için tamamen kapatılmış emirleri kapatın.
• raydium.api.getClmmDynamicConfigs() / getClmmLimitOrderConfigs() — yeni /main/clmm-dynamic-config ve /main/clmm-limit-order-config uç noktalarına vuran REST yardımcıları.

​

Yaygın tuzaklar

​

1. Küme uyuşmazlığı

​

2. Önceden oluşturulmuş ATA’ları unutmak

​

3. Eski poolInfo

​

4. Öncelik ücretleri

const { execute } = await raydium.cpmm.swap({
  poolInfo,
  inputAmount: new BN(...),
  swapResult: ...,
  slippage: 0.005,
  txVersion: TxVersion.V0,
  computeBudgetConfig: {
    units: 250_000,          // CU sınırı
    microLamports: 50_000,   // CU başına öncelik ücreti
  },
});

​

5. Kayma toleransı havuz türüyle eşleşmelidir

​

6. BN ve number

​

Sürüm oluşturma ilkesi

• @raydium-io/raydium-sdk-v2 Raydium’un koruduğu tek SDK’dır. Tüm belgeler, demolar ve entegrasyon kılavuzu bunu hedefler.
• Eski bir v1 paketi (@raydium-io/raydium-sdk) tarihsel nedenlerle npm’de mevcuttur. Bakım, CPMM ve LaunchLab gönderildikten sonra sona ermiştir (v1 hiçbir zaman bunlardan herhangi birine destek kazandı) ve 2024 sonrasında v1 sürümü yayınlanmamıştır. v1’i yaşam sonu olarak kabul edin: yeni kod için kullanmayın ve kalan tüm v1 entegrasyonlarını v2’ye geçirin.
• SDK v2, 1.0’dan öncedir. 0.x küçük sürümleri arasında kırılma değişiklikleri mümkündür; doğruladığınız sürümü sabitleyin ve yükseltme sırasında GitHub yayın notlarını kontrol edin.

​

Yükseltme

1. Her değiştiren çağrının dönüş türünü yeniden kontrol edin — şekil değişiklikleri (örn. extInfo) sık sık iniş yapar.
2. poolInfo getirme imzalarını yeniden oluşturun — bir alan yeniden adlandırılmış olabilir.
3. Kayma işleminizi yeniden doğrulayın; SDK sürümler arasında otomatik bağlanmış ve opt-in bağlanmış davranışlar arasında kaymıştır.
4. raydium.trade (yönlendirme) kullanırsanız, rota şeklini yeniden doğrulayın — yüzeyin en kararsız kısmıdır.

​

Yardım almak

• GitHub sorunları — hata ve özellik istekleri için github.com/raydium-io/raydium-sdk-V2/issues adresinde dosya açın. Raydium ekibi aktif bir şekilde izler.
• Discord — senkron yardım için discord.gg/raydium adresindeki #dev-support kanalı.
• Telegram — raydium.io adresinden bağlantılı geliştirici sohbeti (doğrulanmamış Telegram gruplarından kaçının).

​

İşaretçiler

• sdk-api/rest-api — SDK’ya HTTP tamamlayıcısı.
• sdk-api/trade-api — sunucu tarafından oluşturulan swap işlemleri.
• sdk-api/anchor-idl — program IDL’lerinden doğrudan istemci yeniden oluşturma.
• sdk-api/python-integration — solana-py aracılığıyla Python eşdeğeri.
• integration-guides/priority-fee-tuning — computeBudgetConfig boyutlandırma.

• Raydium SDK v2 kaynağı
• Raydium SDK yayın notları.