Аккаунты LaunchLab

Эта страница переведена с помощью ИИ. За эталон принимается английская версия.Открыть английскую версию →

На этой странице описан граф аккаунтов на один запуск: PoolState (корневой аккаунт состояния одного запуска), его два хранилища, PDA авторитета и ссылки на постградуационные аккаунты, которые появляются при завершении запуска. Информацию о конфигурации на уровне протокола, действующей на все запуски, см. в разделе products/launchlab/global-config. Для наложения конфигурации платформы см. products/launchlab/platform-config. Для аккаунтов вестинга (VestingSchedule на PoolState, VestingRecord на получателя) см. products/launchlab/vesting.

Инвентарь аккаунтов

Аккаунт	Владелец	Назначение
`GlobalConfig`	Программа LaunchLab	Правила уровня протокола: сборы, минимальные объемы, кошельки миграции. Один на `(curve_type, index)`.
`PlatformConfig`	Программа LaunchLab	Наложение на уровне платформы: брендинг, сбор платформы, разделение NFT при выпуске, список допустимых форм кривых.
`PoolState`	Программа LaunchLab	Корневое состояние на один запуск: майнты, хранилища, параметры кривой, счетчики продаж, счетчики сборов, график вестинга, статус выпуска.
`authority`	Программа LaunchLab	Единственный PDA с seed `[b"vault_auth_seed"]`, который владеет хранилищами всех запусков и подписывает постградуационный CPI.
`base_vault`	SPL Token / Token-2022	Хранилище на один запуск, содержащее непроданные базовые токены.
`quote_vault`	SPL Token	Хранилище на один запуск, содержащее накопленные котируемые токены.
`VestingRecord`	Программа LaunchLab	Запись cliff + linear-unlock на одного получателя. Опционально.
`creator_fee_vault`	SPL Token	Хранилище на создателя + на котируемый майнт, содержащее начисленные сборы создателя, очищаемое `ClaimCreatorFee`.
`platform_fee_vault`	SPL Token	Хранилище на платформу + на котируемый майнт, содержащее начисленные сборы платформы, очищаемое `ClaimPlatformFeeFromVault`.
(после выпуска) `cpmm_pool_state` или `amm_pool_state`	Программа CPMM / AMM v4	Пул, созданный `MigrateToCpswap` / `MigrateToAmm`.
(после выпуска) Fee Key NFT	Программа LP-Lock	Обертывает долю создателя в LP при выпуске CPMM; дает владельцу право на `ClaimCreatorFee` в пуле CPMM.

Метод raydium.launchpad.getLaunchById SDK возвращает PoolState плюс флаг, указывающий, прошел ли запуск выпуск; если прошел, включается ID постмиграционного пула.

`PoolState`

Корневое состояние на один запуск. Имена полей ниже совпадают с on-chain структурой Rust (states/pool.rs); некоторые значения упрощены для читаемости — обратитесь к исходному коду для точного макета памяти.

// states/pool.rs (abridged)
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,         // bit flags for SPL Token vs 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 (из Anchor IDL):

= Funding         — принимаются покупки / продажи; ниже quote_reserve_target
= Migrate         — достигнут quote_reserve_target; ожидание MigrateTo*
= Migrated        — MigrateTo* уже выполнен; часы вестинга работают

Поля, видимые интегратору:

status — три значения, монотонные (Funding → Migrate → Migrated). Чтение всегда безопасно; запись ограничена.
real_base, real_quote — текущее состояние кривой. В сочетании с virtual_base / virtual_quote их достаточно для вычисления спотовой цены без касания хранилищ. См. bonding-curve.
total_base_sell vs real_base — коэффициент «прогресс к выпуску» для UI.
migrate_type — выбирает, является ли MigrateToAmm или MigrateToCpswap допустимым путем выпуска. Запуски Token-2022 должны использовать CPMM.
amm_creator_fee_on — имеет смысл только при выпуске на CPMM. Выбирает creator_fee_on = OnlyQuoteToken (0) или BothToken (1) в постградуационном пуле CPMM. Несмотря на название, этот enum фактически также определяет целевую миграцию — BothToken сочетается с MigrateToAmm в текущей операционной практике; QuoteToken с MigrateToCpswap. См. creator-fees.
quote_protocol_fee / platform_fee / migrate_fee — три независимых счетчика сборов. Каждый имеет собственную инструкцию claim; см. instructions.
vesting_schedule — присутствует на каждом PoolState, но неактивен когда total_locked_amount == 0. См. vesting для полного цикла жизни.

PDA авторитета

LaunchLab использует единый PDA авторитета для всех запусков, полученный без seed на запуск:

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

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

Этот единственный PDA:

Авторитет на base_vault и quote_vault каждого запуска.
mint_authority на base_mint каждого запуска (до выпуска).
Подписант на постградуационный CPI для AMM v4 / CPMM (MigrateTo*).
Подписант на передачи ClaimVestedToken из базового хранилища.

mint_authority отзывается немедленно после MigrateToAmm / MigrateToCpswap, так что предложение становится постоянно фиксированным. Два дополнительных PDA блокируют хранилища сборов:

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,
);

Они подписывают передачу из соответствующих хранилищ сборов при ClaimCreatorFee и ClaimPlatformFeeFromVault.

Базовый майнт

Создается встроенно Initialize с:

mint_authority = authority (отзывается при выпуске).
freeze_authority = None.
supply = supply, целиком сминчено в base_vault.
decimals, выбранные создателем при Initialize (обычно 6).

Поскольку полное предложение предварительно сминчено, base_mint.supply остается константой на всю жизнь запуска. Покупки по кривой перемещают токены из base_vault покупателю, но не вызывают mint_to. Initialize / InitializeV2 создают запуски SPL Token. Специальная инструкция InitializeWithToken2022 позволяет базовому майнту быть майнтом Token-2022 (с опциональной TransferFeeConfig); майнт котировки остается SPL Token. Запуски Token-2022 должны выпуститься на пул CPMM, потому что AMM v4 поддерживает только хранилища SPL Token.

Хранилища

И base_vault, и quote_vault — это стандартные аккаунты SPL Token, принадлежащие PDA LaunchLab authority. Адреса хранятся на PoolState и могут быть также получены:

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,
);

(Перед использованием вывода в production проверьте точные префиксы seed в структуре аккаунтов Initialize исходного кода.)

Хранилища сборов

Два PDA агрегируют сборы по запускам:

Хранилище сборов создателя — PDA с seeds [creator, quote_mint]. Каждый запуск, начисляющий сборы одного создателя по одному котируемому майнту, поступает в одно и то же хранилище. Создатель очищает его через ClaimCreatorFee.
Хранилище сборов платформы — PDA с seeds [platform_config, quote_mint]. Каждый запуск, маршрутизируемый через одну и ту же платформу с одним и тем же котируемым майнтом, поступает в одно и то же хранилище. platform_fee_wallet платформы очищает его через ClaimPlatformFeeFromVault. Также есть вариант очистки на запуск (ClaimPlatformFee), который извлекает из quote_vault запуска напрямую без обращения к агрегированному хранилищу.

Паттерн агрегированного хранилища позволяет создателю или платформе с высоким объемом амортизировать стоимость аренды для накопления сборов по множеству запусков.

Quote vault ↔ `real_quote`

quote_vault.balance и PoolState.real_quote должны оставаться синхронизированными. Они могут расходиться максимум на сумму трех ожидающих счетчиков сборов (quote_protocol_fee, platform_fee, migrate_fee), которые находятся в хранилище, но принадлежат счетчикам сборов, а не резерву кривой. Математика кривой всегда использует real_quote, никогда не использует необработанный баланс хранилища. Инвариант до выпуска:

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

Переходы аккаунтов в цикле жизни

Событие	Статус	`real_base`	`real_quote`	Постградуационный пул
`Initialize`	Funding	0	0	—
`BuyExactIn` / `BuyExactOut`	Funding	`+base_out`	`+quote_in_after_fee`	—
`SellExactIn` / `SellExactOut`	Funding	`−base_in`	`−quote_out_before_fee`	—
`MigrateToAmm` / `MigrateToCpswap`	Funding → Migrate → Migrated	(frozen)	(frozen)	создан, LP разделен по `PlatformConfig`
`ClaimCreatorFee` / `ClaimPlatformFee*`	any	—	—	очищает хранилище сборов
`CreateVestingAccount`	Funding	—	—	увеличивает `vesting_schedule.allocated_share_amount`
`ClaimVestedToken`	Migrated only	—	—	очищает `base_vault`

Дальнейшее изучение

products/launchlab/bonding-curve — математика за real_base ↔ real_quote.
products/launchlab/instructions — списки аккаунтов на инструкцию.
products/launchlab/global-config — привязка на уровне протокола.
products/launchlab/platform-config — наложение платформы.
products/launchlab/vesting — механика блокировки предложения.
products/cpmm/accounts — как выглядит постградуационный cpmm_pool_state.

Источники:

raydium-launch/programs/launchpad/src/states/pool.rs — PoolState, PoolStatus, VestingSchedule, AmmCreatorFeeOn.
raydium-launch/programs/launchpad/src/lib.rs — константы seed PDA (AUTH_SEED, CREATOR_FEE_VAULT_AUTH_SEED, PLATFORM_FEE_VAULT_AUTH_SEED).
Модуль launchpad Raydium SDK v2.

LaunchLab

Запуск токена

Tips & Gotchas

Аккаунты LaunchLab

Инвентарь аккаунтов

`PoolState`

PDA авторитета

Базовый майнт

Хранилища

Хранилища сборов

Quote vault ↔ `real_quote`

Переходы аккаунтов в цикле жизни

Дальнейшее изучение

LaunchLab

Запуск токена

Tips & Gotchas

Documentation Index

​Инвентарь аккаунтов

​PoolState

​PDA авторитета

​Базовый майнт

​Хранилища

​Хранилища сборов

​Quote vault ↔ real_quote

​Переходы аккаунтов в цикле жизни

​Дальнейшее изучение

Инвентарь аккаунтов

`PoolState`

PDA авторитета

Базовый майнт

Хранилища

Хранилища сборов

Quote vault ↔ `real_quote`

Переходы аккаунтов в цикле жизни

Дальнейшее изучение