LaunchLab talimatları

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 →

LaunchLab, sıkı bir talimat seti sunar: altı kullanıcı tarafından çağrılabilen çağrı artı bir avuç yönetici ilkel. SDK bunların tümünü sarmalamaktadır; bu sayfa, toplayıcılar, izleme araçları ve CPI gerektiren programlar için ham yüzeyi belgeler.2026-09 program yükseltmesi LaunchLab’ı Anchor 1.0.2 / Solana 3.1.10 üzerine yeniden inşa etti ve üç geçiş mekanizmasını temizledi: kullanımdan kaldırılan Initialize artık her zaman başarısız olur, MigrateToAmm üç argümanını ve her OpenBook hesabını kaybetti ve get_upgrade_timestamp kapısı birkaç kontrolü saate bağlı hale getirmiştir ve artık yoktur. Ayrıca bir yönetici talimatı olan CollectExcessLamports ekler. 2026-09-09 değişiklik günlüğü girişine bakın.

Talimat envanteri

Grup	Talimat	Çağrılabilir
Genel yapılandırma	`CreateConfig` / `UpdateConfig`	Program yöneticisi; devredilen yapılandırma oluştur yetkisi de `CreateConfig` çağırabilir
Başlatma yaşam döngüsü	`Initialize`	Kimse — her zaman `NotApproved` ile başarısız olur. Yalnızca ayırıcı işaretçi işgal etsin ve IDL istikrarlı kalsın diye tutulur. `InitializeV2` kullanın.
Başlatma yaşam döngüsü	`InitializeV2`	Herkes (yaratıcı) — SPL Token temel mint; nihai CPMM mezuniyeti için `amm_creator_fee_on` kaydeder ve Token-2022 alıntı mint’ini kabul eder.
Başlatma yaşam döngüsü	`InitializeWithToken2022`	Herkes (yaratıcı) — Token-2022 temel mint, isteğe bağlı `TransferFeeConfig`; her iki alıntı token programını kabul eder
İşlem	`BuyExactIn` / `BuyExactOut`	Herkes — bağlama eğrisinde tam giriş / tam çıkış satın alma
İşlem	`SellExactIn` / `SellExactOut`	Herkes — bağlama eğrisinde tam giriş / tam çıkış satış
Mezuniyet	`MigrateToAmm`	Geçiş cüzdanı — CPMM-yalnızca oluşturma uygulanmadan önce başlatılan havuzlar için eski AMM v4 mezuniyet. 2026-09’dan beri hiçbir argüman ve OpenBook hesabı almaz.
Mezuniyet	`MigrateToCpswap`	Geçiş cüzdanı — CPMM’ye mezun olun. Tüm yeni başlatılan başlatmalar bu yolu kullanır. CPMM’de `InitializeWithPermission` sarmalanır.
Ücretler	`CollectFee`	Yönetici — bir başlatmadan protokol ücretlerini temizle
Ücretler	`CollectMigrateFee`	Yönetici — birikmiş geçiş ücretlerini temizle
Ücretler	`ClaimCreatorFee`	Yaratıcı — eğri aşaması sırasında birikmiş yaratıcı ücretlerini talep et
Hak kazanma	`CreateVestingAccount`	Yaratıcı — kilitli token’ları bir lehtar için ayır, mezuniyetten sonra açılır
Hak kazanma	`CreatePlatformVestingAccount`	Platform yöneticisi — kilitli token’ları platform tarafı lehtarlar için ayır
Hak kazanma	`ClaimVestedToken`	Lehtar — uçurum sonrası açılan token’ları talep et
Platform yapılandırması	`CreatePlatformConfig` / `UpdatePlatformConfig`	Platform yöneticisi
Platform yapılandırması	`CreatePlatformCurveRule` / `UpdatePlatformCurveRule` / `RemovePlatformCurveRule` / `ClosePlatformCurveRule`	`PlatformConfig.curve_rule_manager` veya platform yöneticisi — bir `GlobalConfig` başlatma parametresi kuralını yönet
Platform ücretleri	`ClaimPlatformFee` / `ClaimPlatformFeeFromVault`	Platform yöneticisi
Platform erişimi	`CreatePlatformAllowConfig` / `ClosePlatformAllowConfig`	Platform yöneticisi — o platform kısıtlamayı etkinleştirdiğinde kullanılan `GlobalConfig` izin listesini koru
Kira	`CollectExcessLamports`	Program yöneticisi veya adanmış lamport toplama cüzdanı — LaunchLab tarafından kontrol edilen kasalardan ve PDA’lardan kira muafiyeti minimumunun üzerindeki lamport’ları temizle. 2026-09’da eklendi.

“ExactIn/ExactOut” bölünmesi CPMM’nin SwapBaseInput / SwapBaseOutput yansıtır — zincir üzerinde bunlar biraz farklı yuvarlama ile ayrı talimat ayırıcılarıdır. Mezuniyet yolu seçimi. Her yeni InitializeV2 ve InitializeWithToken2022 çağrısı migrate_type = 1 (CPSWAP) ayarlamalıdır. Yeni bir AMM v4 bağlı havuzu başlatmaya yönelik herhangi bir girişim MigrateTypeNotMatch döndürür. amm_creator_fee_on yalnızca ortaya çıkan CPMM yaratıcı ücretinin alıntı token’ına mı yoksa her iki token’a mı uygulanacağını seçer; hedef programı seçmez. Eski Initialize artık hiçbir şekilde başlatma oluşturamaz (aşağıya bakın). MigrateToAmm bu kısıtlamadan önce migrate_type = 0 ile başlatılan mevcut bir PoolState için çağrılabilir kalır. Sürüm mevcut havuz durumunu yeniden yazmaz veya eski talimatı kaldırmaz. Alıntı tarafı token programı. Alıntı mint’i SPL Token programı veya Token-2022 tarafından sahip olunabilir. Bunu dokunuşlayan her talimat — CreateConfig, InitializeV2, InitializeWithToken2022, dört işlem talimatının tümü, CollectFee, CollectMigrateFee, ClaimCreatorFee, ClaimPlatformFee ve ClaimPlatformFeeFromVault — sahip olan programı alıntı programı hesap yuvasında alır. Hesap konumları değişmedi; yalnızca kabul edilen değer değişti. GlobalConfig.quote_mint sahibi olan programı geçin, bunu mevcut bir başlatma için PoolState.token_program_flag bit1’den okuyabilirsiniz (bkz. accounts) veya aksi takdirde mint hesabının sahibinden. Kullanımdan kaldırılan Initialize burada alakasız: alıntı programı hesabı hala SPL Token’a yazılmıştır ve 2026-09 yükseltmesinden beri talimat herhangi bir hesabı okumadan önce başarısız olur. InitializeV2 veya InitializeWithToken2022 aracılığıyla başlatın. MigrateToCpswap diğer istisnadır, ters yönde — bir mint başına bir yerine her zaman her iki programı alır. Bkz. aşağıdaki geçiş hesapları.

`Initialize`

2026-09 yükseltmesinden itibaren etkili olarak kaldırıldı — bu talimat her zaman başarısız olur. initialize’ın işleyicisi artık Not supported. Please use initialize_v2 instruction ve NotApproved (6000) günlüğünden başka bir şey değildir. Yalnızca ayırıcısı işgal etsin ve IDL istikrarlı bir şekil kalsın diye tutulur. (Accounts yapısı değişmemiştir, bu nedenle Anchor’ın oluşturulan doğrulaması yine de ilk olarak çalışır; işlem yine de geri alınır.)Daha önce saate bağlıydı: get_upgrade_timestamp kesintisinden üç gün sonrasına kadar çalıştı ve sonrasında başarısız oldu. Bu zaman damgası yardımcısı artık yoktur, bu nedenle başarısızlık artık koşulsuz olur. Bununla oluşturulan mevcut başlatmalar etkilenmez — MigrateToAmm veya MigrateToCpswap aracılığıyla normal şekilde işlem görür ve mezun olur, depolanan migrate_type bağlı olarak.Aşağıdaki argümanlar ve hesap listesi InitializeV2’ye aittir. Kullanımdan kaldırılan Initialize aynı 18 hesabı aynı sırada ve yalnızca ilk üç argümanı alır — onda amm_fee_on yoktur — ve quote_token_program yuvası Interface<TokenInterface> değil, SPL Token olarak tiplenmiştir.

Yeni bir başlatma oluşturun. InitializeV2, kullanımdan kaldırılan Initialize’a göre yalnızca amm_fee_on argümanını ekler; hesap sayısı ve sırası özdeştir ve tek hesap düzeyi fark, quote_token_program’ın Interface<TokenInterface> olarak tiplenmesidir; böylece Token-2022 bir quote mint kabul edilir. Argümanlar Tek bir yapı değil, dört konumsal argüman. (InitializeWithToken2022 beşinci bir argüman ekler: transfer_fee_extension_param: Option<TransferFeeExtensionParams>; kullanımdan kaldırılan Initialize ise amm_fee_on’u atar.)

base_mint_param: MintParams {
    decimals: u8,                 // must equal the program's BASE_MINT_DECIMALS
    name:     String,
    symbol:   String,
    uri:      String,
}

curve_param: CurveParams {        // Borsh enum — one leading variant-tag byte
    Constant { data: ConstantCurve { supply: u64, total_base_sell: u64,
                                     total_quote_fund_raising: u64, migrate_type: u8 } },
    Fixed    { data: FixedCurve    { supply: u64,
                                     total_quote_fund_raising: u64, migrate_type: u8 } },
    Linear   { data: LinearCurve   { supply: u64,
                                     total_quote_fund_raising: u64, migrate_type: u8 } },
}

vesting_param: VestingParams {
    total_locked_amount: u64,     // 0 requires cliff_period == unlock_period == 0
    cliff_period:        u64,     // seconds after fundraising ends
    unlock_period:       u64,     // seconds
}

amm_fee_on: AmmCreatorFeeOn       // 0 = QuoteToken, 1 = BothToken (CPMM migrations only)

Varyant, global_config.curve_type ile eşleşmelidir; aksi hâlde talimat InputNotMatchCurveConfig (6003) ile geri döner. open_time yoktur, quote_mint argümanı yoktur (bu değer global_config’ten gelir), fees yapısı yoktur ve post_graduation_lp_policy de yoktur — mezuniyette LP’nin elden çıkarılması başlatma başına değil, PlatformConfig üzerinde ayarlanır. Hesaplar — toplam 18 (bildirilen 16 artı iki #[event_cpi] eklemesi)

#	Ad	W	S	Notlar
1	`payer`	W	S	Tüm kirayı öder. Yaratıcı olması gerekmez.
2	`creator`			`pool_state.creator` olarak kaydedilir; imzalayan değildir.
3	`global_config`			Quote mint’i, eğri türünü ve her taban/tavanı sağlar.
4	`platform_config`			Platform ücret oranını ve LP elden çıkarma politikasını sağlar.
5	`authority`			PDA `["vault_auth_seed"]` — tüm başlatmaların paylaştığı tek bir global PDA.
6	`pool_state`	W		Yeni hesap.
7	`base_mint`	W	S	Taze keypair — bu talimat onu başlatır.
8	`quote_mint`			`global_config.quote_mint` ile eşleşmelidir.
9	`base_vault`	W		PDA `["pool_vault", pool_state, base_mint]`.
10	`quote_vault`	W		PDA `["pool_vault", pool_state, quote_mint]`.
11	`metadata_account`	W		Metaplex metadata PDA’sı.
12	`base_token_program`			`InitializeV2` için SPL Token; `InitializeWithToken2022` için Token-2022.
13	`quote_token_program`			`quote_mint`’in sahibi olan program — SPL Token veya Token-2022.
14	`metadata_program`			Metaplex Token Metadata.
15	`system_program`
16	`rent_program`			Rent sysvar’ı.
17	`event_authority`			PDA `["__event_authority"]`; `#[event_cpi]` tarafından eklenir.
18	`program`			LaunchLab program kimliği; `#[event_cpi]` tarafından eklenir.

Ön koşullar

quote_mint ∈ launch_config.allowed_quote_mints.
base_supply_graduation ≤ base_supply_max.
Ücret parametreleri launch_config.max_*_fee_rate kontrollerini geçer.
open_time ≥ now − slop (SDK ≥ now uygular; program hafif geriye dönük tarihlemeyi tolere eder).
curve_type tanınır.

Son koşullar

base_mint supply = curve_param.supply ile, tümü base_vault içinde.
Mint yetkisi, arz basıldıktan hemen sonra bu aynı talimat içinde iptal edilir (set_authority(MintTokens, None)) — mezuniyette değil. Bu nedenle base mint kalıcı olarak sabit arzlıdır ve daha sonraki hiçbir talimat daha fazlasını basamaz.
PoolState, status = Fund (0), real_a = 0, real_b = 0 ile başlatılır.
total_fund_raising_b doğrudan curve_param.total_quote_fund_raising değerinden gelir.
InitializeWithToken2022 için ekli TransferFeeConfig ile: transfer_fee_config_authority = launch_authority ve bu alan ayarlandığında withdraw_withheld_authority = PlatformConfig.transfer_fee_extension_auth, aksi takdirde launch_authority. Çekme tarafı mint oluşturmada yazılır, tam olarak platform mezuniyetten önce alıkonulan ücretleri temizleyebilsin diye. Bkz. platform-config.

Yaygın hatalar — NotApproved (6000, kullanımdan kaldırılan Initialize için koşulsuz olarak), InvalidInput (6002, GlobalConfig’ten gelen bir arz / oran / fon toplama tabanı ihlal edildi), InputNotMatchCurveConfig (6003, curve_param varyantı global_config.curve_type ile eşleşmiyor), MigrateTypeNotMatch (6007, migrate_type != 1), MathOverflow (6008), VestingRatioTooHigh (6010), NoSupportExtension (6017), NotEnoughRemainingAccounts (6018), InvalidPlatformAllowConfig (6022), CurveParamNotMatchPlatformRule (6025). Başarısız bir Anchor address = / constraint = kontrolü bunlardan biri olarak değil 2xxx kodu olarak görünür — programın hata enum’unda InvalidQuoteMint, FeeRateTooHigh veya InvalidCurveParams diye bir şey yoktur.

`Buy` (kanonik varyant: `BuyExactIn`)

Kullanıcı sabit bir giriş tutarı sağlar; eğri çıkışı hesaplar. Argümanlar

amount_in:           u64
minimum_amount_out:  u64
share_fee_rate:      u64   // referral fee on a 1_000_000 denominator; must be
                           // <= global_config.max_share_fee_rate. Pass 0 for no
                           // referral. Any non-zero value requires the share-fee
                           // receiver as remaining_accounts[0].

Hesaplar

#	Ad	W	S	Notlar
1	`payer`	W	S	İşlem yapan taraf.
2	`authority`			PDA `["vault_auth_seed"]` — tek bir global PDA, başlatma başına tohum yok.
3	`global_config`			`address = pool_state.global_config`.
4	`platform_config`			`address = pool_state.platform_config`.
5	`pool_state`	W
6	`user_base_token`	W		`token::mint = base_token_mint`.
7	`user_quote_token`	W		`token::mint = quote_token_mint`.
8	`base_vault`	W		`address = pool_state.base_vault`.
9	`quote_vault`	W		`address = pool_state.quote_vault`.
10	`base_token_mint`
11	`quote_token_mint`
12	`base_token_program`			Base mint’in sahibi olan program — SPL Token veya Token-2022.
13	`quote_token_program`			Quote mint’in sahibi olan program.
14	`event_authority`			PDA `["__event_authority"]`; `#[event_cpi]` tarafından eklenir.
15	`program`			LaunchLab program kimliği; `#[event_cpi]` tarafından eklenir.

Kalan hesaplar — ücret tesisatı; tam olarak şu sırada okunur:

share_fee_receiver — yalnızca share_fee_rate > 0 olduğunda.
system_program — her zaman; == System::id() olduğu kontrol edilir, aksi hâlde InvalidInput.
platform_fee_vault — PDA [platform_config, quote_token_mint]; ilk kullanımda oluşturulur.
creator_fee_vault — PDA [creator, quote_token_mint]; ilk kullanımda oluşturulur.

Eksik kalmak NotEnoughRemainingAccounts (6018) döndürür. associated_token_program diye bir yuva yoktur ve system_program bildirilmiş bir hesap değil, kalan bir hesaptır. Ön koşullar

launch_state.status == Active.
now ≥ open_time.
user_quote_ata.balance ≥ quote_in.
quote_in > 0.

Etki

quote_in öğesini quote_in_after_fee ve ücret kısımlarına böl.
Post-ücret alıntısı verilen base_out için eğriyi Newton-çöz.
require(base_out ≥ minimum_base_out) aksi takdirde ExceededSlippage ile geri al.
quote_in kullanıcı → kasa taşı. base_out kasa → kullanıcı taşı.
base_sold += base_out, quote_reserve_real += quote_in_after_fee × (lp_share / total_share) güncelle.
Ücret sayaçlarını güncelle (protocol_fees_quote, creator_fees_quote).
state_data.num_buys += 1.
Güncelleme sonrası quote_reserve_real ≥ quote_reserve_target ise, SDK tipik olarak aynı işlemde bir Graduate ix zincirler. Program Buy içinde otomatik mezun olmaz — sonraki bir Graduate gereklidir.

`BuyExactOut`

Kullanıcı tam base_out belirtir; program quote_in hesaplar. Argümanlar

amount_out:         u64
maximum_amount_in:  u64
share_fee_rate:     u64   // as for BuyExactIn

BuyExactIn ile aynı hesaplar ve aynı kalan-hesap sözleşmesi. Newton yinelemesi yerine kapalı form ikinci dereceden integral (veya curve_type 1 için CPMM tersi) kullanır.

`Sell` / `SellExactIn` / `SellExactOut`

Buy yansıması. Kullanıcı base_in eğriye döndürür ve quote_out alır. Ücret quote_out öğesinden düşülür, bu nedenle kullanıcı ham entegre gelirlerin daha azını alır. Ön koşullar —

user_base_ata.balance ≥ base_in.
Satış base_sold öğesini 0’ın altına itemiyor (muhasebe tutarlı olduğu göz önüne alındığında yukarıdakiyle gereksiz).
Başlatma Active olur.

Etki — Buy ile simetrik. base_sold azalır, quote_reserve_real azalır. Ücretler yine de tahakkuk eder.

Alıntı tarafı transfer ücretleri

Alıntı mint’i TransferFeeConfig taşıdığında, kasanın hareket ettiği miktar ve ödeyicinin borçlandırıldığı veya alacaklandırıldığı miktar farklıdır ve kayma sınırı ödeyicinin tarafına karşı kontrol edilir. Uzantı olmayan alıntı mint’inde aşağıdaki her durum düz eski mint ile aynıdır.

Talimat	Argüman	Kontrol edilen
`BuyExactIn`	`amount_in`	Eğri `amount_in − transfer_fee(amount_in)` üzerinde fiyatlandırılır — kasaya ulaşan şey. Tam doldurma tam olarak `amount_in` borçlandırır; kısmi doldurma tüketilen kasa miktarı artı ters ücretini borçlandırır.
`BuyExactOut`	`maximum_amount_in`	Kasa miktarı artı ters transfer ücreti — gerçek borç.
`SellExactIn`	`minimum_amount_out`	Satıcının mint ücretini kestikten sonra tuttuğu şey, kasadan çıkan brüt miktar değil.
`SellExactOut`	`amount_out`	Tam olarak teslim edilir. Eğri `amount_out` artı ters transfer ücreti hedefler.

Alıntı için iki sonuç:

Mint ücretsiz olsaydı hesaplanan sınır reddedilir. Ücretsiz maliyeti maximum_amount_in olarak veya ücretsiz gelirleri minimum_amount_out olarak geçmek ExceededSlippage ile geri alınır.
real_quote yalnızca kasaya ulaşan şey kadar ilerler. %5 alıntı mint’inde amount_in BuyExactIn real_quote öğesini amount_in × 0.95 kadar hareket ettirir.

%100 ücretli alıntı mint’i (10000 baz puan) ters çevrilemez ve tam çıkış yollarında CalculateOverflow ile geri alınır. Her iki işlem tarafı mint’i de eşleşen yuvasında geçirilen programa kısıtlanır, bu nedenle uyumsuz base_token_program artık yoksayılmak yerine başarısız olur. Bkz. algorithms/token-2022-transfer-fees temel ücret matematiği için.

İşlem kalan hesapları

Dört işlem talimatının tümü ücret tesisatlarını remaining_accounts aracılığıyla bu sırada alır:

İndeks	Hesap	Ne zaman
0	`share_fee_receiver`	Yalnızca `share_fee_rate > 0` olduğunda. Mevcut olduğunda aşağıdaki her indeksi birer kaydırır.
sonraki	`system_program`	Her zaman. Ücret kasası oluşturmayı finanse eder.
sonraki	`platform_fee_vault`	Her zaman. PDA `[platform_config, quote_token_mint]` tohumlarında, ilk kullanımda oluşturulur.
sonraki	`creator_fee_vault`	Her zaman. PDA `[creator, quote_token_mint]` tohumlarında, ilk kullanımda oluşturulur.

2026-09’da değişti: son üçü artık koşulsuz ve system_program doğrulanır. Bu sürümden önce program yalnızca unix_timestamp >= get_upgrade_timestamp() olduğunda bunları okudu ve kesintiden önce platform/yaratıcı ücret bölünmesini tamamen atladı. Zaman damgası uzun geçmiştir, bu nedenle mainnet’teki davranış pratikte değişmemiştir — ancak dal koddan gitti ve üç hesabı hala atlayan bir oluşturucu artık her zaman kesintiden sonra yerine NotEnoughRemainingAccounts (6018) ile başarısız olur. system_program yuvası ek olarak System::id() karşısında kontrol edilir ve başka bir şey tutarsa InvalidInput (6002) döndürür, daha önce herhangi bir hesap bu konumda kabul edilirdi.

`MigrateToAmm` / `MigrateToCpswap`

Eğri total_quote_fund_raising öğesine ulaştığında bir başlatmayı işlem gören havuza mezun edin. Yeni başlatmalar yalnızca CPMM’dir. MigrateToAmm depolanan migrate_type 0 olan mevcut havuzlar için tutulur. Kim imzalar

MigrateToAmm — bağlama GlobalConfig üzerinde kaydedilen migrate_to_amm_wallet.
MigrateToCpswap — bağlama GlobalConfig üzerinde kaydedilen migrate_to_cpswap_wallet.

Bu cüzdanlar tipik olarak Raydium tarafından işletilen mezuniyet krankı tarafından tutulur; pratikte mezuniyet eşik geçildikten saniyeler sonra iner, son satın almayı kim tetiklerse tetiklesin. Argümanlar Hiçbiri almaz.

Kırıcı değişiklik (yalnızca geçiş cüzdanı, 2026-09). MigrateToAmm üç argümanın tümünü — base_lot_size, quote_lot_size, market_vault_signer_nonce — ve dokuz hesabı bıraktı. Talimat verisi artık çıplak ayırıcıdır, bu nedenle eski bir oluşturucu hem 17 beklenmeyen argüman baytı gönderir hem de artık hizalanmayan bir hesap listesi sağlar.Bu AMM v4’ün kendi OpenBook kaldırılmasını takip eder: AMM v4’ün Initialize2 artık market_program veya amm_open_orders almaz, bu nedenle LaunchLab’ın iletecek bir şeyi kalmadı. Program ayrıca initialize_openbook_market CPI’ını yapmayı bıraktı, üç argümanın yapılandırdığı şey.Kaldırılan hesaplar: openbook_program, request_queue, event_queue, bids, asks, market_vault_signer, market_base_vault, market_quote_vault ve amm_open_orders. market hesabı kalır konumunda — AMM v4 hala bunu referans alanı olarak kaydeder — ancak artık çıplak #[account(mut)] olarak bildirilir: sahip, adres veya tohum kısıtlaması yok. Tamamen doğrulanmamıştır, doğrudan AMM v4’ün Initialize2 CPI’ına iletilir ve program artık bunu başlatmaz. Pazar hesabının gerçek başlatılmış bir pazar olmasını isteyen bir çağrıcı bunu kendisi önceden oluşturmalıdır.Kalan 23 hesap listesi sırasıyla: payer, base_mint, quote_mint, market, amm_program, amm_pool, amm_authority, amm_lp_mint, amm_base_vault, amm_quote_vault, amm_target_orders, amm_config, amm_create_fee_destination, authority, pool_state, global_config, base_vault, quote_vault, pool_lp_token, spl_token_program, associated_token_program, system_program, rent_program.MigrateToCpswap etkilenmez — hiçbir zaman argüman almadı.

Etki (her ikisine ortak)

pool_state.status == Migrate doğrula (yani, quote_reserve_target ulaşıldı). Aksi takdirde PoolMigrated (durum zaten Migrated idi) veya PoolFunding (hala finansman) ile geri al.
pool_state.migrate_type talimatla eşleştiğini doğrula (0 AMM için, 1 CPMM için). Aksi takdirde MigrateTypeNotMatch ile geri al.
Mezuniyet sonrası rezervleri hesapla:
- base_amount_out = base_vault.amount − vesting_schedule.total_locked_amount
- quote_amount_out = quote_vault.amount − quote_protocol_fee − migrate_fee − platform_fee
Hedef programa CPI (AMM v4 Initialize2 veya CPMM InitializeWithPermission) bu rezervlerle mezuniyet sonrası havuzu oluşturmak için.
2026-08-17 yükseltmesinden sonra yürütülen CPMM geçişleri için platform_scale + creator_scale öğesini bir platform tarafından sahip olunan kilitli LP payına birleştir ve en fazla bir Ücret Anahtarı NFT’si platform_nft_wallet öğesine bas. burn_scale kalanını yak. Yükseltmeden önce, creator_scale ayrı olarak kilitliydi ve Ücret Anahtarı token yaratıcısına gitti. Tamamlanan tarihsel geçişler değiştirilmez. Eski AMM v4 mezuniyeti için LP dağılımı bu talimatın mevcut akışını takip eder.
(Mint yetki adımı yok. base_mint.mint_authority başlatma oluşturmada zaten None olarak ayarlandı — aşağıdaki nota bakın.)
pool_state.status = Migrated çevir, vesting_schedule.start_time = block_time + cliff_period ayarla.

Token-2022 transfer ücreti yetki devri — temel mint Token-2022 mint’i olduğunda TransferFeeConfig taşıyıp ve PlatformConfig.transfer_fee_extension_auth varsayılan olmadığında, geçiş ayrıca bu uzantının yetkilerini platform anahtarına yeniden atar:

transfer_fee_config_authority her zaman yeniden atanır. Başlatma authority PDA bunu tüm ön mezuniyet aşaması boyunca tutar, bu nedenle her zaman taşınacak bir şey vardır.
WithheldWithdraw yeniden atanır yalnızca authority PDA hala tuttuğunda. 2026-08-27’den itibaren oluşturulan başlatmalar zaten mint oluşturmada bu yetkiye transfer_fee_extension_auth taşır, bu nedenle adım atlanır. Koruma, geçişin bu mint’lerde geri alınmasını engeller — PDA artık tutmadığı bir yetki imzalayamaz.

transfer_fee_extension_auth geçiş zamanında Pubkey::default() ise, hiçbir yetki hareket etmez ve her ikisi de authority PDA’da kalıcı olarak kalır. Bkz. platform-config.

Temel mint’in arzı oluşturmadan değil, mezuniyetten ayarlanır. InitializeV2 ve InitializeWithToken2022 tüm arzı temel kasaya basarlar ve ardından aynı talimatında hemen MintTokens öğesini iptal ederler, bu nedenle base_mint.mint_authority başlatmanın tüm yaşamı boyunca None olur. Geçiş buna dokunmaz. (Bu sayfanın önceki revizyonları iptalı mezuniyete yerleştirdi; bu yanlıştı.) Geçişin hareket ettirebileceği tek yetki aşağıda açıklanan Token-2022 transfer ücreti olanlarıdır.

Son koşullar — BuyExactIn, BuyExactOut, SellExactIn, SellExactOut bu noktadan itibaren PoolMigrated ile reddedecektir. Ortaya çıkan AMM havuzu kanonik olur ve diğer herhangi bir AMM v4 / CPMM havuzu gibi işlem görür. Yaygın hatalar — PoolFunding, PoolMigrated, MigrateTypeNotMatch, InvalidCpSwapConfig, MathOverflow.

CPMM geçiş kalan hesapları

MigrateToCpswap oluşturan istemciler bu sabit remaining_accounts indekslerini kullanmalıdır:

İndeks	Hesap
0–4	Platform Ücret Anahtarı sahibi, mint, token hesabı, kilitli likidite PDA’sı ve metadata hesabı
5	Orijinal başlatma yaratıcısı; `platform_cp_creator` ayarlanmadığında kullanılır
6	`[b"permission", launch_authority]` öğesinden türetilen CPMM izin PDA’sı
7	Yapılandırılmış `platform_cp_creator`; alan varsayılan olmadığında kullanılır
8	Sıralanmış `mint0` için CPMM destek mint PDA’sı, `[b"support_mint", mint0]` öğesinden türetilmiş
9	Sıralanmış `mint1` için CPMM destek mint PDA’sı, `[b"support_mint", mint1]` öğesinden türetilmiş

Talimat en az on kalan hesap gerektirir. Destek mint hesapları salt okunur CPI girdileridir. Her iki adresi de mint başlatılmış destek kaydı olmasa bile türet. Hala yaratıcı kilit hesapları ekleyen veya indeks 8–9 atlayan eski oluşturucular güncellenmeli.

2026-09’da değişti. İki temizlik, hiçbiri doğru bir oluşturucuyu değiştirmez:

İzinli CPMM yolu artık tek yoldur. MigrateToCpswap unix_timestamp >= get_upgrade_timestamp() temelinde InitializeCpSwap ve InitializeCpSwapWithPermission arasında seçim yapmak için kullanılırdı. Zaman damgası yardımcısı ve eski CPI her ikisi de gitti, bu nedenle izinli yol — ve bu nedenle on hesap minimum — koşulsuz olarak uygulanır.
Üç adres kısıtlaması hesap yapısından talimat gövdesine taşındı. platform_config, base_vault ve quote_vault hala PoolState üzerinde depolanan değerlerle eşleşmesi gerekir, ancak uyumsuzluk artık Anchor’ın address = kısıtlaması yerine require_keys_eq! tarafından yükseltilir. Kontrol eşdeğerdir; yalnızca hata yüzeyi farklıdır — bu üç hesap için Anchor’ın genel RequireKeysEqViolated (2502) yerine ConstraintAddress (2012) alırsınız ve hesap adı olmadan raporlanır. Bu üç hesap için 2012 ile eşleşen hata işlemesini güncelleyin.

CPMM geçiş token programları

MigrateToCpswap her iki token programını koşulsuz olarak alır ve hangi programın her mint’i sahip olduğunu kendisi çalışır. İki token programı hesabı buna göre yeniden adlandırıldı:

Konum	Hesap	Değer
ilk	`token_program`	Her zaman eski SPL Token programı
ikinci	`token_program_2022`	Her zaman Token-2022 programı

Bunlar eski base_token_program (temel mint’i sahip olan program) ve quote_token_program (her zaman eski) yerine geçer. Konumlar değişmemiştir, bu nedenle bu bir değer değişikliği yerine bir düzen değişikliğidir — ancak iki değer neredeyse ters çevrilmiştir ve eski çiftini geçirmeye devam eden bir oluşturucu, her iki mint de Token-2022 mint’i olur olmaz eski programın gerekli olduğu yere Token-2022 sağlayacaktır. Eski program hiçbir mint kullanmasa bile gereklidir, çünkü CPMM LP mint’i ve kilitli likidite Ücret Anahtarı NFT’si her zaman bunda yaşar.

Platform `GlobalConfig` izin listesi

PlatformConfig.restrict_global_config kontrolü:

0: platform herhangi bir başka şekilde geçerli GlobalConfig kabul eder; izin hesabı gerekli değildir.
1: Initialize, InitializeV2 ve InitializeWithToken2022 eşleşen PlatformAllowConfig öğesini remaining_accounts içinde herhangi bir yere dahil etmelidir.

Platform yöneticisi CreatePlatformAllowConfig ve ClosePlatformAllowConfig ile PDA’yı oluşturur veya kapatır. Tohumları [b"platform_allow_config", platform_config, global_config] olur. Eski yönetici tarafından yönetilen PlatformGlobalAccess talimatları ve PDA’sı emekli olmuştur.

Platform başlatma parametresi kuralları

Dört talimat bir PlatformCurveRule hesabını yönetir. Dördü de PlatformConfig.curve_rule_manager veya platform yöneticisi tarafından imzalanır — program yöneticiyi imzalayıcıdan PlatformConfig PDA’sını yeniden türeterek kabul eder, bu nedenle ayrı bir hesap bunu kanıtlamaz. Ne de ne de olmayan bir imzalayıcı InvalidCurveRuleAuthority döndürür.

Talimat	Hesaplar	Argümanlar
`CreatePlatformCurveRule`	`curve_rule_authority` (imzalayıcı, mut), `platform_config`, `global_config`, `platform_curve_rule` (mut), `system_program`	hiçbiri
`UpdatePlatformCurveRule`	aynı beş	`group_id: u16`, `constraints: Vec<ParamConstraint>`
`RemovePlatformCurveRule`	aynı beş	`group_id: u16`
`ClosePlatformCurveRule`	ilk dört	hiçbiri

platform_curve_rule [b"platform_curve_rule", platform_config, global_config] adresindeki PDA’dır.

Create hiçbir grup tutmayan hesabı tahsis eder. Bu durum hiçbir şeyi kısıtlamaz.
Update bu group_id ile grubu upsert eder, varsa tamamen değiştirir. Hesabı sığdırmak için yeniden boyutlandırır, bu nedenle imzalayıcı büyüdüğü kirayı toplar ve küçüldüğü kirayı geri alır. Onuncu ötesinde yeni bir grup CurveRuleGroupsExceeded döndürür; 25’ten fazla kısıtlama, bilinmeyen alan veya operatör veya bir grupta aynı (field, op) çifti iki kez InvalidCurveRuleConstraint döndürür; sabit olmayan ürün yapılandırmasında dört TotalSellA türetilmiş alan CurveRuleFieldNotSupportedByCurve döndürür.
Remove bir grubu id’ye göre bırakır, hesabı küçültür ve farkı geri öder. Bilinmeyen id CurveRuleGroupNotExist döndürür.
Close tüm kirayı imzalayıcıya döndürür. Yapılandırma daha sonra restrict_curve_param 1 kalsa bile sınırlanmamış olur.

Dördü de kuralların uygulanıp uygulanmadığını değiştirmez. Bu UpdatePlatformConfig::RestrictCurveParam(0 | 1) olur, yalnızca platform yöneticisi çağırabilir. Başlatma yolunda. restrict_curve_param 1 iken, InitializeV2 ve InitializeWithToken2022 kural PDA’sını remaining_accounts içinde gerektirir — var olmasa bile, bunu atlayamayacak şekilde. Eksik hesap NotEnoughRemainingAccounts olur; hiçbir grubu karşılamayan başlatma CurveParamNotMatchPlatformRule olur. Kontrol GlobalConfig’ün kendi sınırlarından önce çalışır ve yalnızca bunları daraltabilir. Model ve oyun kitapları: products/launchlab/curve-rules. Her iki hata da istemci tarafında kaçınılabilir — SDK bu kontrolü saf bir işlev olarak yansıtır, bkz. Göndermeden önce kontrol edin.

`CollectFee`

Tek bir başlatmada protokolün birikmiş işlem ücretlerinin yönetici taraması. Argümanlar — hiçbiri. Hesaplar

#	Ad	W	S	Notlar
1	`protocol_fee_owner`		S	`global_config.protocol_fee_owner` ile eşit olmalıdır.
2	`authority`			PDA `[b"vault_auth_seed"]`; kasa transferini imzalar.
3	`pool_state`	W		`quote_protocol_fee` sıfırlamak için mutasyona uğratılır.
4	`global_config`			İmzalayıcı için gerçek kaynak.
5	`quote_vault`	W		`quote_protocol_fee` tarafından boşaltılır.
6	`quote_mint`
7	`recipient_token_account`	W		`protocol_fee_owner` üzerinde `quote_mint` ATA’sı.
8	`token_program`			Quote mint’in sahibi olan program — SPL Token veya Token-2022.

Burada quote_mint, recipient_token_account’tan önce gelir — alıcıyı öne koyan ClaimCreatorFee, ClaimPlatformFee ve ClaimPlatformFeeFromVault’un tersi. İki yuvanın Anchor tipleri farklıdır (Mint ve TokenAccount), bu nedenle bunları takas etmek çalışma zamanında seri açımını başarısız kılar ve yanlış-hesap hatası gibi görünür. CollectMigrateFee, CollectFee ile aynı sıraya sahiptir.

Etki — quote_vault öğesinden quote_protocol_fee öğesini recipient_token_account öğesine aktar, ardından sayacı sıfırla. İlk satın almadan sonra herhangi bir zamanda çağrılabilir.

`CollectMigrateFee`

Mezuniyette birikmiş geçiş ücretinin yönetici taraması. CollectFee ile aynı hesap şekli, protocol_fee_owner yerine migrate_fee_owner imzalayıcı olarak ve pool_state.migrate_fee boşaltılan sayaç olarak.

`ClaimCreatorFee`

Yaratıcının sahip olduğu her başlatmada aynı alıntı mint’ini kullanan birikmiş yaratıcı ücretlerinin yaratıcı başına taraması. Per-havuz olanı değil, per-yaratıcı ücret kasasını boşaltır. Argümanlar — hiçbiri. Hesaplar

#	Ad	W	S	Notlar
1	`creator`	W	S	Havuz yaratıcısı.
2	`fee_vault_authority`			PDA `[b"creator_fee_vault_auth_seed"]`.
3	`creator_fee_vault`	W		`[creator, quote_mint]` tohumlarında PDA; toplanmış yaratıcı kasası.
4	`recipient_token_account`	W		`init_if_needed`; `creator` üzerinde `quote_mint` ATA’sı.
5	`quote_mint`
6	`token_program`
7	`system_program`			Gerekirse ATA oluşturma için.
8	`associated_token_program`

Etki — creator_fee_vault öğesinin tüm bakiyesini recipient_token_account öğesine aktar. Kasa boşsa sıfırdan büyük bir kontrol gerektirir ile geri alınır.

`ClaimPlatformFee`

Bir başlatmanın alıntı kasasını doğrudan boşaltan platform başına tarama. Bunu, bir platform toplanmış platform kasasından geçmeden belirli bir başlatma için dilimini talep etmek istediğinde kullanın. Argümanlar — hiçbiri. Hesaplar

#	Ad	W	S	Notlar
1	`platform_fee_wallet`	W	S	`platform_config.platform_fee_wallet` ile eşit olmalıdır.
2	`authority`			PDA `[b"vault_auth_seed"]`.
3	`pool_state`	W		`pool_state.platform_fee` tarafından boşaltılır.
4	`platform_config`			İmzalayıcı için gerçek kaynak.
5	`quote_vault`	W		Boşaltılır.
6	`recipient_token_account`	W		`init_if_needed`; `platform_fee_wallet` üzerinde ATA’sı.
7	`quote_mint`
8	`token_program`
9	`system_program`
10	`associated_token_program`

Etki — pool_state.platform_fee öğesini quote_vault öğesinden recipient_token_account öğesine aktar, sayacı sıfırla.

`ClaimPlatformFeeFromVault`

Platform başına toplanmış tarama. Her başlatmadan platformdan yönlendirilen ücretleri biriktiren platform’un per alıntı mint ücret kasasını boşaltır. Argümanlar — hiçbiri. Hesaplar

#	Ad	W	S	Notlar
1	`platform_fee_wallet`	W	S	`platform_config.platform_fee_wallet` ile eşit olmalıdır.
2	`fee_vault_authority`			PDA `[b"platform_fee_vault_auth_seed"]`.
3	`platform_config`
4	`platform_fee_vault`	W		`[platform_config, quote_mint]` tohumlarında PDA.
5	`recipient_token_account`	W		`init_if_needed`; `platform_fee_wallet` üzerinde ATA’sı.
6	`quote_mint`
7	`token_program`
8	`system_program`
9	`associated_token_program`

Etki — platform_fee_vault öğesinin tam bakiyesini recipient_token_account öğesine aktar. Kasa boşsa geri alınır.

`CollectExcessLamports`

LaunchLab’ın kontrol ettiği hesaplarda kira muafiyeti minimumunun üzerinde oturan lamport’ların yönetici taraması. 2026-09 yükseltmesinde eklendi, böylece protokol SIMD-0437 kira azaltmasının her adımdan sonra hesaplarda bıraktığı aşırı finansmanı geri alabilir. Yalnızca fazlalık hareket eder. Token bakiyeleri, hesap verileri, sahipleri, eğri durumu ve hak kazanma dokunulmaz ve talimat zaten minimumda olan bir hesaba karşı bir no-op olur — bu nedenle her dağıtım adımından sonra yeniden çalıştırmak güvenlidir. Argümanlar — hiçbiri. Hesaplar

#	Ad	W	S	Notlar
1	`collect_lamports_wallet`	W	S	Her taranmış lamport için hedef. LaunchLab program yöneticisi veya adanmış lamport toplama cüzdanı olmalıdır — bkz. `reference/program-addresses`. Başka bir imzalayıcı `InvalidOwner` (`6001`) ile başarısız olur.
2	`authority`			Biri LaunchLab’ın üç kasa yetki PDA’sından (aşağıya bakın). Bu çağrıdaki her token hesabı için token programı CPI’larını imzalar.
3	`token_program`			SPL Token.
4	`token_program_2022`			Token-2022. Her ikisi de koşulsuz olarak gereklidir; program kaynak hesaba göre seçer.
5..	`remaining_accounts`	W		`M` kaynak hesapları taranacak, herhangi bir sayı, herhangi bir sıra.

authority seçme Hesap işaretlenmemiş olarak geçirilir ve program tarafından çözülür, bu da LaunchLab’ın üç yetki PDA’sını yeniden türetir ve eşleştirir:

Tohum	Sahip
`[b"vault_auth_seed"]`	Her başlatmanın temel ve alıntı havuz kasası
`[b"platform_fee_vault_auth_seed"]`	Her platform ücret kasası
`[b"creator_fee_vault_auth_seed"]`	Her yaratıcı ücret kasası

Üçünün hiçbiriyle eşleşmeyen bir anahtar tüm talimatı InvalidOwner (6001) ile başarısız kılar.

Kaynak hesaplarınızı yetki tarafından gruplandırın. Bir çağrı bir authority taşır ve token programı hesabın gerçek sahibinin imzalamasını gerektirir. Geçirdiğiniz authority öğesinden farklı üçünden biri tarafından sahip olunan bir token hesabı CPI’ı başarısız kılar ve tüm işlemi onunla birlikte alır. Havuz kasalarını, platform ücret kasalarını ve yaratıcı ücret kasalarını ayrı işlemlerde tarayın.Program tarafından sahip olunan PDA’lar istisnadır — doğrudan borçlandırılırlar, bu nedenle herhangi bir yetki ile birlikte gidebilirler.

Her kaynak hesabı nasıl işlenir

Kaynak hesap sahibi	İşleme
SPL Token veya Token-2022, yerel olmayan token hesabı	CPI `WithdrawExcessLamports` (token programı ayırıcısı `38`), `authority` tarafından imzalanmış.
SPL Token veya Token-2022, yerel (wSOL) token hesabı	`WithdrawExcessLamports` yerel hesapları reddeder. Program `SyncNative` CPI’ları, sarılı `amount` ne kadar büyüdüğünü ölçer, tam o delta için `UnwrapLamports` (ayırıcı `45`) ve sarılı bakiyenin ön senkronizasyon değerine eşit olmasını gerektirir — aksi takdirde `LamportsCalculateError` (`6031`). SOL alıntılı başlatma bu nedenle tam alıntı rezervini tutar.
LaunchLab programının kendisi — `PoolState`, `GlobalConfig`, `PlatformConfig`, `VestingRecord`, `PlatformCurveRule`, `PlatformAllowConfig`	Program hesabı doğrudan `rent.minimum_balance(data_len)` öğesine borçlandırır.
Başka bir şey	Sessizce atlanır. Hata yok, lamport hareket yok.

Temel mint’ler taranamaz. InitializeV2 ve InitializeWithToken2022 temel mint’i oluşturan aynı talimatında MintTokens öğesini iptal eder, bu nedenle hiçbir anahtar bunu imzalayamaz — temel mint’in kirayı kalıcı olarak kalır. Yaygın hatalar — InvalidOwner (6001, yanlış imzalayıcı veya üçünün hiçbiri olmayan bir authority), LamportsCalculateError (6031, wSOL gidiş dönüş sıfıra net olmadı) ve program tarafından sahip olunan yoldan bir hesap kendi kira minimumundan daha az tuttuğunda InsufficientFunds. SDK oluşturucu yok. @raydium-io/raydium-sdk-v2 bu talimat için bir oluşturucu göndermez ve raydium-sdk-V2-demo deposu da göndermez — bu bir yönetici yoludur. Bunu elle kodlayın, solana-fundamentals/rent-and-reclaimable-rent içindeki cüzdan tarafı taramasının token programı talimatı için yaptığı şekilde.

Hak kazanma ve platform yapılandırması talimatları

Bunlar ayrılmış sayfalarda belgelenmiştir çünkü her birinin kendi durum modeli vardır:

Durum değişikliği matrisi

Talimat	`status`	`real_base`	`real_quote`	Ücret sayaçları	Sonrası havuz
`Initialize{V2,WithToken2022}`	Funding	0	0	0	—
`BuyExactIn(q_in)`	Funding	+∆	+∆q_after_fee	`quote_protocol_fee += ∆`, `platform_fee += ∆`	—
`SellExactIn(b_in)`	Funding	−∆	−∆q_before_fee	(aynı)	—
Eşik ulaşıldı	→ Migrate	—	—	—	—
`MigrateToCpswap` / eski `MigrateToAmm`	→ Migrated	(dondurulmuş)	(dondurulmuş)	`migrate_fee` ayarlanmış	oluşturulmuş; CPMM LP platform kilidi ve yakılmaya bölünmüş
`CollectExcessLamports`	—	—	—	—	—
`CollectFee` / `CollectMigrateFee`	herhangi	—	—	sayaç sıfırlanmış	—
`ClaimCreatorFee` / `ClaimPlatformFee*`	herhangi	—	—	kasa boşaltılmış	—
`CreateVestingAccount`	Funding	—	—	—	`allocated_share_amount` çarpıntılı
`ClaimVestedToken`	Migrated	—	—	—	`base_vault` boşaltılmış

Sonra nereye gidilir

products/launchlab/code-demos — her talimat için TypeScript örnekleri.
products/launchlab/accounts — tam durum şekli.
reference/error-codes — LaunchLab hata numaralandırması.

Kaynaklar:

Raydium SDK v2 LaunchLab modülü
Raydium LaunchLab program kaynağı

LaunchLab

Token launch flow

Tips & Gotchas

Talimat envanteri

`Initialize`

`Buy` (kanonik varyant: `BuyExactIn`)

`BuyExactOut`

`Sell` / `SellExactIn` / `SellExactOut`

Alıntı tarafı transfer ücretleri

İşlem kalan hesapları

`MigrateToAmm` / `MigrateToCpswap`

CPMM geçiş kalan hesapları

CPMM geçiş token programları

Platform `GlobalConfig` izin listesi

Platform başlatma parametresi kuralları

`CollectFee`

`CollectMigrateFee`

`ClaimCreatorFee`

`ClaimPlatformFee`

`ClaimPlatformFeeFromVault`

`CollectExcessLamports`

Hak kazanma ve platform yapılandırması talimatları

Durum değişikliği matrisi

Sonra nereye gidilir

​Talimat envanteri

​Initialize

​Buy (kanonik varyant: BuyExactIn)

​BuyExactOut

​Sell / SellExactIn / SellExactOut

​Alıntı tarafı transfer ücretleri

​İşlem kalan hesapları

​MigrateToAmm / MigrateToCpswap

​CPMM geçiş kalan hesapları

​CPMM geçiş token programları

​Platform GlobalConfig izin listesi

​Platform başlatma parametresi kuralları

​CollectFee

​CollectMigrateFee

​ClaimCreatorFee

​ClaimPlatformFee

​ClaimPlatformFeeFromVault

​CollectExcessLamports

​Hak kazanma ve platform yapılandırması talimatları

​Durum değişikliği matrisi

​Sonra nereye gidilir

Talimat envanteri

`Initialize`

`Buy` (kanonik varyant: `BuyExactIn`)

`BuyExactOut`

`Sell` / `SellExactIn` / `SellExactOut`

Alıntı tarafı transfer ücretleri

İşlem kalan hesapları

`MigrateToAmm` / `MigrateToCpswap`

CPMM geçiş kalan hesapları

CPMM geçiş token programları

Platform `GlobalConfig` izin listesi

Platform başlatma parametresi kuralları

`CollectFee`

`CollectMigrateFee`

`ClaimCreatorFee`

`ClaimPlatformFee`

`ClaimPlatformFeeFromVault`

`CollectExcessLamports`

Hak kazanma ve platform yapılandırması talimatları

Durum değişikliği matrisi

Sonra nereye gidilir