LaunchLab hesapları

PoolState (başlatma başına kök), temel ve alıntı kasaları, yetki PDA’sı ve başlatma başına hesapların küçük grafiği. Protokol düzeyindeki GlobalConfig ve platform düzeyindeki PlatformConfig kendi sayfalarında yer alır.

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 sayfa başlatma başına hesap grafiğini belgeler: PoolState (bir başlatma için kök durum hesabı), iki kasası, yetki PDA’sı ve başlatma kapandığında kazandığı sonrası referansları.

Her başlatmayı sınırlayan protokol düzeyindeki yapılandırma için bkz. products/launchlab/global-config. Platform başına ek katman için bkz. products/launchlab/platform-config. Vesting hesapları (PoolState üzerinde VestingSchedule, yararlanıcı başına VestingRecord) için bkz. products/launchlab/vesting.

​

Hesap envanteri

Hesap	Sahibi	Amaç
GlobalConfig	LaunchLab programı	Protokol düzeyindeki kurallar: ücretler, arz tabanları, göç cüzdanları. (curve_type, index) başına bir tane.
PlatformConfig	LaunchLab programı	Platform başına ek katman: marka, platform ücreti, kapanışta NFT bölünmesi, başlatma parametresi anahtarı ve kural yöneticisi. Sabit 944 bayt.
PoolState	LaunchLab programı	Başlatma başına kök durum: mintler, kasalar, eğri parametreleri, satılan sayaçlar, ücret sayaçları, vesting takvimi, kapanış durumu.
authority	LaunchLab programı	[b"vault_auth_seed"] tohumunda tek PDA, tüm başlatmalar arasında kasalara sahip ve sonrası CPI’yi imzalar.
base_vault	SPL Token / Token-2022	Başlatma başına satılmayan temel tokenları tutan kasa.
quote_vault	SPL Token / Token-2022	Başlatma başına birikmiş alıntı tokenlarını tutan kasa. Alıntı mintine sahip olan programı takip eder.
VestingRecord	LaunchLab programı	Yararlanıcı başına cliff + doğrusal kilit açma kaydı. İsteğe bağlı.
creator_fee_vault	SPL Token / Token-2022	Yaratıcı başına + alıntı-mint başına birikmiş yaratıcı ücretlerini tutan kasa, ClaimCreatorFee tarafından temizlenir. Alıntı mintinin programını takip eder.
platform_fee_vault	SPL Token / Token-2022	Platform başına + alıntı-mint başına birikmiş platform ücretlerini tutan kasa, ClaimPlatformFeeFromVault tarafından temizlenir. Alıntı mintinin programını takip eder.
PlatformAllowConfig	LaunchLab programı	İsteğe bağlı platform tarafından yönetilen bir (PlatformConfig, GlobalConfig) çifti için izin. Yalnızca platform kısıtlamayı etkinleştirdiğinde kontrol edilir.
PlatformCurveRule	LaunchLab programı	İsteğe bağlı platform tarafından yönetilen bir (PlatformConfig, GlobalConfig) çifti için başlatma parametresi kuralı. Değişken boyut, boş 150 bayt.
(kapanış sonrası) cpmm_pool_state	CPMM programı	Her yeni başlatma için MigrateToCpswap tarafından oluşturulan havuz. Eski durum hala AMM v4 kapanışına başvurabilir.
(kapanış sonrası) Ücret Anahtarı NFT	LP-Lock programı	2026-08-17 yükseltmesinden önce, platform ve yaratıcı ölçekleri ayrı Ücret Anahtarları üretebilirdi. Bundan sonra yürütülen göçler her iki ölçeği tek bir platform Ücret Anahtarında birleştirir.

SDK’nın raydium.launchpad.getLaunchById işlevi PoolState artı başlatmanın kapanıp kapanmadığını gösteren bir bayrak döndürür; kapandıysa, sonrası göç havuzu kimliği dahil edilir.

​

PoolState

Başlatma başına kök durum. Aşağıdaki alan adları zincir üzerindeki Rust yapısıyla eşleşir (states/pool.rs); bazı değerler okunabilirlik için basitleştirilmiştir — tam bellek düzeni için kaynağa bakın.

// states/pool.rs (kısaltılmış)
pub struct PoolState {
    pub epoch:                     u64,        // recent_epoch tracker
    pub auth_bump:                 u8,
    pub status:                    u8,         // PoolStatus enum
    pub base_decimals:             u8,
    pub quote_decimals:            u8,
    pub migrate_type:              u8,         // 0 = AMM v4, 1 = CPMM
    pub supply:                    u64,        // total base tokens (no decimals)
    pub total_base_sell:           u64,        // base supply allocated to the curve
    pub virtual_base:              u64,        // virtual-reserve seed
    pub virtual_quote:             u64,        // virtual-reserve seed
    pub real_base:                 u64,        // base sold so far
    pub real_quote:                u64,        // quote raised so far (excl. fees)
    pub total_quote_fund_raising:  u64,        // graduation threshold in quote

    pub quote_protocol_fee:        u64,        // accrued, pending CollectFee
    pub platform_fee:              u64,        // accrued, pending ClaimPlatformFee
    pub migrate_fee:               u64,        // accrued, pending CollectMigrateFee
    pub vesting_schedule:          VestingSchedule,

    pub global_config:             Pubkey,
    pub platform_config:           Pubkey,
    pub creator:                   Pubkey,
    pub base_mint:                 Pubkey,
    pub quote_mint:                Pubkey,
    pub base_vault:                Pubkey,
    pub quote_vault:               Pubkey,

    pub amm_creator_fee_on:        u8,         // 0 = QuoteToken, 1 = BothToken (CPMM-only)
    pub token_program_flag:        u8,         // bit0 = base mint, bit1 = quote mint; 0 = SPL Token, 1 = Token-2022
    pub padding:                   [u8; 54],
}

#[derive(Default, Debug, Clone)]
pub struct VestingSchedule {
    pub total_locked_amount:    u64,
    pub cliff_period:           u64,
    pub unlock_period:          u64,
    pub start_time:             u64,           // set at graduation
    pub allocated_share_amount: u64,           // running sum across VestingRecords
}

PoolStatus değerleri (Anchor IDL’den):

0 = Funding         — alım/satımları kabul eder; quote_reserve_target'ın altında
1 = Migrate         — quote_reserve_target'a ulaşıldı; MigrateTo* bekliyor
2 = Migrated        — MigrateTo* zaten yürütüldü; vesting saati çalışıyor

Entegratör tarafından görülen alanlar:

• status — üç değer, monoton (Funding → Migrate → Migrated). Okumalar her zaman güvenli; yazımlar kapılı.
• real_base, real_quote — mevcut eğri durumu. virtual_base / virtual_quote ile birlikte kasalara dokunmadan spot fiyatı hesaplamak için yeterlidirler. Bkz. bonding-curve.
• total_base_sell vs real_base — UI’ler için “kapanışa doğru ilerleme” oranı.
• migrate_type — yeni başlatma 1 (CPSWAP) gerektirir. Depolanan 0 yalnızca CPMM-only uygulaması öncesinde oluşturulan mevcut bir başlatma için anlamlı kalır.
• amm_creator_fee_on — sonrası CPMM havuzunda creator_fee_on = OnlyQuoteToken (0) veya BothToken (1) seçer. Göç hedefini seçmez. Bkz. creator-fees.
• token_program_flag — boole değil, bir bit alanı. Bit0 temel mint, bit1 alıntı mintidir; her biri SPL Token için 0, Token-2022 için 1’dir; bu nedenle bayt dört değer alır: 0 (her ikisi de eski), 1 (Token-2022 tabanı), 2 (Token-2022 alıntısı), 3 (her ikisi de Token-2022). Bir mintiyi (token_program_flag >> bit) & 1 ile okuyun. Tüm baytı 0 ile karşılaştırmak temel mintiyi sınıflandırmak 2’yi yanlış programa çözer. Bit1, Token-2022 alıntı mintleri desteklenene kadar sabit 0 idi.
• quote_protocol_fee / platform_fee / migrate_fee — üç bağımsız ücret sayacı. Her birinin kendi talep talimatı vardır; bkz. instructions.
• vesting_schedule — her PoolState üzerinde mevcut ancak total_locked_amount == 0 olduğunda etkin değil. Tam yaşam döngüsü için bkz. vesting.

​

Yetki PDA’sı

LaunchLab, tüm başlatmalar arasında tek bir yetki PDA’sı kullanır, başlatma başına tohum olmadan türetilir:

const LAUNCHLAB_PROGRAM_ID = new PublicKey("<LAUNCHLAB_ID>"); // bkz. reference/program-addresses

const [authority, bump] = PublicKey.findProgramAddressSync(
  [Buffer.from("vault_auth_seed")],
  LAUNCHLAB_PROGRAM_ID,
);

Bu tek PDA:

• Her başlatmanın base_vault ve quote_vault üzerinde yetki.
• Her başlatmanın base_mint üzerinde mint_authority (kapanış öncesi).
• CPMM kapanışı CPI’sinde ve mevcut durum için eski AMM v4 kapanışında imzalayan.
• ClaimVestedToken transferlerinde temel kasadan imzalayan.
• Token-2022 temel mintinin TransferFeeConfig üzerinde transfer_fee_config_authority, tüm kapanış öncesi aşama için — ve withdraw_withheld_authority da, ancak yalnızca platform PlatformConfig.transfer_fee_extension_auth ayarlamadığında.

mint_authority, MigrateToCpswap veya eski MigrateToAmm çağrısından hemen sonra iptal edilir, bu nedenle arz kalıcı olarak sabitlenir.

İki ek PDA ücret kasalarını kapılar:

const [creatorFeeVaultAuthority] = PublicKey.findProgramAddressSync(
  [Buffer.from("creator_fee_vault_auth_seed")],
  LAUNCHLAB_PROGRAM_ID,
);

const [platformFeeVaultAuthority] = PublicKey.findProgramAddressSync(
  [Buffer.from("platform_fee_vault_auth_seed")],
  LAUNCHLAB_PROGRAM_ID,
);

Bunlar ClaimCreatorFee ve ClaimPlatformFeeFromVault sırasında ilgili ücret kasasından transferi imzalarlar.

​

Temel mint

Initialize tarafından satır içi oluşturulur:

• mint_authority = authority (kapanışta iptal edilir).
• freeze_authority = None.
• supply = supply, tamamen base_vault içine basılır.
• decimals yaratıcı tarafından Initialize sırasında seçilir (yaygın olarak 6).

Tam arz önceden basıldığından, base_mint.supply başlatmanın ömrü boyunca sabittir. Eğri alımları tokenları base_vault’tan alıcıya taşır, ancak mint_to çağırmaz.

Initialize / InitializeV2 SPL Token temel mintleri oluşturur. Özel InitializeWithToken2022 talimatı temel mintin Token-2022 mintidir (isteğe bağlı TransferFeeConfig ile). Üç başlatma yolu da CPMM kapanışı gerektirir.

InitializeWithToken2022 bir TransferFeeConfig eklediğinde, mint transfer_fee_config_authority = authority ve withdraw_withheld_authority = PlatformConfig.transfer_fee_extension_auth ile oluşturulur, platform bu alanı ayarlamadığında authority’ye geri döner. Her iki yetki de kapanışta platform anahtarına yeniden atanır, geri çekme tarafı yalnızca PDA hala tutuyorsa. Bkz. platform-config.

Alıntı mintidir temel mintten bağımsız ve kendisi Token-2022 mintidir — InitializeV2 ve InitializeWithToken2022 alıntı programı yuvasında her iki programı da kabul eder. Kullanımdan kaldırılan Initialize yapmaz: alıntı programı hesabı hala SPL Token’a yazılmıştır, bu nedenle alıntı mintidir Token-2022 olan bir yapılandırma yalnızca diğer ikisi aracılığıyla başlatılabilir. Alıntı mintidir LaunchLab tarafından asla oluşturulmaz; GlobalConfig.quote_mint adlandırdığı şeydir. Bkz. global-config ve reference/token-2022-support.

​

Kasalar

Hem base_vault hem de quote_vault, LaunchLab authority PDA’sına ait token hesaplarıdır; her biri kendi mintine sahip olan programda oluşturulur — bu nedenle bir başlatma eski bir temel kasaya ve Token-2022 alıntı kasasına sahip olabilir veya başka herhangi bir kombinasyon. token_program_flag hangisinin hangisi olduğunu kaydeder. Adresler PoolState üzerinde depolanır ve ayrıca türetilebilir:

const [baseVault] = PublicKey.findProgramAddressSync(
  [Buffer.from("pool_vault"), poolState.toBuffer(), baseMint.toBuffer()],
  LAUNCHLAB_PROGRAM_ID,
);
const [quoteVault] = PublicKey.findProgramAddressSync(
  [Buffer.from("pool_vault"), poolState.toBuffer(), quoteMint.toBuffer()],
  LAUNCHLAB_PROGRAM_ID,
);

(Üretimde bir türetmeye güvenmeden önce kaynağın Initialize hesapları yapısından tam tohum öneklerini doğrulayın.)

​

Ücret kasaları

İki PDA başlatmalar arasında ücretleri toplar:

• Yaratıcı ücret kasası — [creator, quote_mint] tohumlarında PDA. Aynı alıntı mintinde aynı yaratıcı ücretlerini kazanan her başlatma aynı kasaya dökülür. Yaratıcı ClaimCreatorFee aracılığıyla temizler.
• Platform ücret kasası — [platform_config, quote_mint] tohumlarında PDA. Aynı platform üzerinden yönlendirilen ve aynı alıntı mintini kullanan her başlatma aynı kasaya dökülür. Platform’un platform_fee_wallet ClaimPlatformFeeFromVault aracılığıyla temizler. Başlatmanın quote_vault’undan doğrudan toplanan ücret kasasından geçmeden çeken başlatma başına bir temizleme varyantı (ClaimPlatformFee) da vardır.

Her ikisi de ücret tahakkuk ettiren ilk swapte, alıntı mintine sahip olan programda tembel olarak oluşturulur. Aynı alıntı mintinde eski ve Token-2022 alıntı mintlerine karşı başlatmalar çalıştıran bir yaratıcı veya platform, zaten iki farklı eski mint için yaptığı gibi mint başına bir kasa ile sonuçlanır.

Toplanan kasa deseni, yüksek hacimli bir yaratıcı veya platformun ücret birikiminin kira maliyetini birçok başlatma arasında amortize etmesine izin verir.

​

Alıntı kasası ↔ real_quote

quote_vault.balance ve PoolState.real_quote senkronize kalmalıdır. Üç bekleyen ücret sayacının toplamı kadar sapabilirler (quote_protocol_fee, platform_fee, migrate_fee), bunlar kasada oturur ancak ücret sayaçlarına ve eğri rezervine değil. Eğri matematiği her zaman real_quote kullanır, asla ham kasa bakiyesini değil.

Kapanış öncesi değişmez:

quote_vault.balance ==
   real_quote
 + quote_protocol_fee
 + platform_fee
 + migrate_fee

​

PlatformCurveRule

(PlatformConfig, GlobalConfig) çifti başına bir hesap, o yapılandırmada platformun izin verdiği başlatma şekillerini tutar. PDA tohumları [b"platform_curve_rule", platform_config, global_config]’dir.

#[account]
pub struct PlatformCurveRule {
    pub bump:            u8,
    pub version:         u8,
    pub platform_config: Pubkey,
    pub global_config:   Pubkey,
    pub epoch:           u64,
    pub padding:         [u64; 8],
    pub groups:          Vec<CurveRuleGroup>,   // up to 10
}

pub struct CurveRuleGroup {
    pub group_id:    u16,                       // stable id, used to update or remove the group
    pub epoch:       u64,
    pub constraints: Vec<ParamConstraint>,      // up to 25, ANDed
}

pub struct ParamConstraint {
    pub field: u8,                              // which launch parameter
    pub op:    u8,                              // 0 Eq, 1 Gte, 2 Lte, 3 Neq
    pub value: u128,
}

Hesap hiçbir grup tutmadan oluşturulur ve her grup değişikliğinde yeniden boyutlandırılır, bu nedenle uzunluğu 150 + Σ(14 + 18 × constraints)’dir ve kod çözücüler sabit bir boyut varsaymamalıdır. Gruplar OR’lanır: bir başlatma, bir grubun kısıtlamalarının tümü tutulur tutulmaz izin verilir. Sıfır grup kısıtlama yok anlamına gelir.

Sahibi PlatformConfig.restrict_curve_param 1 olduğunda okuyun — 0’da program hesabı yok sayar ve eski bir kural orada oturabilir. Alan kimlikleri, operatörler ve oyun kitapları products/launchlab/curve-rules’da.

​

Yaşam döngüsü hesap geçişleri

Olay	Durum	real_base	real_quote	Kapanış sonrası havuz
Initialize	Funding	0	0	—
BuyExactIn / BuyExactOut	Funding	+base_out	+quote_in_after_fee	—
SellExactIn / SellExactOut	Funding	−base_in	−quote_out_before_fee	—
MigrateToCpswap (veya eski MigrateToAmm)	Funding → Migrate → Migrated	(dondurulmuş)	(dondurulmuş)	oluşturulmuş; CPMM LP platform tarafından sahip olunan kilitli LP ve yakılan LP’ye bölünür
ClaimCreatorFee / ClaimPlatformFee*	herhangi	—	—	bir ücret kasasını boşaltır
CreateVestingAccount	Funding	—	—	vesting_schedule.allocated_share_amount arttırır
ClaimVestedToken	Yalnızca Migrated	—	—	base_vault boşaltır

​

Sonraki adım

• products/launchlab/bonding-curve — real_base ↔ real_quote arkasındaki matematik.
• products/launchlab/instructions — talimat başına hesap listeleri.
• products/launchlab/global-config — protokol düzeyindeki bağlama.
• products/launchlab/platform-config — platform ek katmanı.
• products/launchlab/vesting — kilitli arz mekaniği.
• products/cpmm/accounts — kapanış sonrası cpmm_pool_state neye benziyor.

Kaynaklar:

• raydium-launch/programs/launchpad/src/states/pool.rs — PoolState, PoolStatus, VestingSchedule, AmmCreatorFeeOn.
• raydium-launch/programs/launchpad/src/lib.rs — PDA tohum sabitleri (AUTH_SEED, CREATOR_FEE_VAULT_AUTH_SEED, PLATFORM_FEE_VAULT_AUTH_SEED).
• Raydium SDK v2 launchpad modülü.