Вестинг опционален при запуске LaunchLab. Установите vesting_param.total_locked_amount = 0 при инициализации, и раздел ниже не применяется. После активации график фиксируется на весь жизненный цикл запуска; cliff и периоды разблокировки не могут быть изменены задним числом.
Зачем нужен вестинг
Bonding curve продаёт base_supply_graduation токенов во время сбора средств и засевает постградуальный пул оставшимся количеством. Вестинг выделяет дополнительную часть предложения, блокирует её на настраиваемый cliff, а затем линейно высвобождает её одному или нескольким получателям — обычно команде создателя, советникам или партнёрам платформы.
Практические варианты использования:
- Распределение команде. Создатель резервирует, скажем, 5% предложения для основной команды, заблокированное на 6 месяцев и разблокировавшееся линейно в течение следующих 12 месяцев.
- Распределение платформе. Платформа запуска получает часть каждого токена, который она перечисляет, по той же схеме, через
CreatePlatformVestingAccount.
- Гранты советникам и участникам. Несколько получателей с собственными аккаунтами
VestingRecord, каждый отслеживающий свою заявленную сумму независимо.
Заблокированные токены никогда не входят в кривую и не входят в постградуальный LP. Они остаются неактивными в base_vault пула до тех пор, пока каждый получатель не вызовет ClaimVestedToken.
Форма графика
Вестинг для запуска описывается тремя числами, записанными один раз во время инициализации:
| Поле | Тип | Смысл |
|---|
total_locked_amount | u64 | Сумма всех базовых токенов, заблокированных для всех получателей (создатель + платформа). Должна удовлетворять total_locked_amount <= supply * max_lock_rate / 1_000_000 из GlobalConfig. |
cliff_period | u64 (секунды) | Время ожидания после окончания сбора средств, прежде чем любые токены будут разблокированы. |
unlock_period | u64 (секунды) | Длительность окна линейной разблокировки после cliff. 0 означает, что всё разблокируется мгновенно в конце cliff. |
PoolState.vesting_schedule (структура VestingSchedule) плюс on-chain start_time, который программа записывает как block_time + cliff_period в момент, когда сбор средств успешно заканчивается (когда условия выпуска впервые выполняются).
// states/pool.rs
pub struct VestingSchedule {
pub total_locked_amount: u64,
pub cliff_period: u64,
pub unlock_period: u64,
pub start_time: u64, // set by the program at fundraising end
pub allocated_share_amount: u64, // running sum of allocations to vesting records
}
allocated_share_amount — это общая сумма, уже назначенная аккаунтам VestingRecord через CreateVestingAccount / CreatePlatformVestingAccount. Она никогда не должна превышать total_locked_amount. Если создатель переалоцирует, следующий вызов CreateVestingAccount вернёт ошибку InvalidTotalLockedAmount.
Формула линейной разблокировки
После окончания сбора средств программа вычисляет совокупную разблокированную сумму для каждого VestingRecord как:
elapsed = min(now, start_time + unlock_period) − start_time
unlocked_amount = token_share_amount × elapsed / unlock_period
unlock_period == 0, весь token_share_amount становится требуемым в один шаг в start_time. В противном случае кривая представляет собой прямую линию от 0 в start_time до token_share_amount в start_time + unlock_period, ограниченную token_share_amount впоследствии.
Сумма, переведённая при каждом вызове ClaimVestedToken, — это разница между вновь рассчитанной совокупной разблокированной суммой и текущим полем claimed_amount в записи.
delta_amount = unlocked_amount − vesting_record.claimed_amount
vesting_record.claimed_amount = unlocked_amount
start_time вернёт ошибку VestingNotStarted. Получение после start_time + unlock_period выплатит полный остаток.
Схемы аккаунтов
VestingSchedule
Находится inline на PoolState. См. accounts.
VestingRecord
Запись для каждого получателя. PDA получен как:
seeds = [
b"pool_vesting",
pool_state.key(),
beneficiary.key(),
]
program = LaunchLab program
// states/vesting.rs
#[account]
pub struct VestingRecord {
pub epoch: u64, // recent_epoch tracker
pub pool: Pubkey, // back-pointer to PoolState
pub beneficiary: Pubkey, // who can call ClaimVestedToken
pub claimed_amount: u64, // cumulative claimed
pub token_share_amount: u64, // total allocated to this beneficiary
pub padding: [u64; 8],
}
VestingRecord для каждого запуска. Алоцирование снова одному и тому же получателю при одном запуске вернёт ошибку, так как PDA уже существует.
Инструкции
CreateVestingAccount
Только создатель. Выделяет часть total_locked_amount пула новому получателю путём инициализации свежего PDA VestingRecord.
Аргументы
share_amount: u64 // токены для назначения этому получателю
| # | Имя | W | S | Примечания |
|---|
| 1 | creator | W | S | Должен равняться pool_state.creator; оплачивает аренду для нового аккаунта. |
| 2 | beneficiary | W | | Позже получает разблокированные токены. Pubkey заблокирован здесь — не может быть изменён. |
| 3 | pool_state | W | | Мутируется для увеличения vesting_schedule.allocated_share_amount. |
| 4 | vesting_record | W | | init; PDA [b"pool_vesting", pool_state, beneficiary]. |
| 5 | system_program | | | Требуется для создания аккаунта. |
share_amount > 0.pool_state.vesting_schedule.allocated_share_amount + share_amount <= total_locked_amount.- Pubkey
beneficiary не имеет существующего VestingRecord для этого пула.
Постусловия
vesting_record инициализирован с token_share_amount = share_amount, claimed_amount = 0.pool_state.vesting_schedule.allocated_share_amount += share_amount.
Общие ошибки — InvalidTotalLockedAmount, InvalidInput.
Вариант CreateVestingAccount для администратора платформы. Кошелёк вестинга платформы (хранящийся на PlatformConfig.platform_vesting_wallet) является получателем, а доля ограничена PlatformConfig.platform_vesting_scale.
Подписавший должен равняться platform_config.platform_vesting_wallet. Другие аккаунты зеркалируют CreateVestingAccount. Используйте это, когда платформа контрактует получать фиксированную долю вестинга при каждом запуске, который она перечисляет.
ClaimVestedToken
Только получатель. Переводит любые вновь разблокированные токены из base_vault пула на ATA получателя.
Аргументы
Нет (программа вычисляет сумму претензии из графика).
Аккаунты
| # | Имя | W | S | Примечания |
|---|
| 1 | beneficiary | W | S | Должен равняться vesting_record.beneficiary. |
| 2 | authority | | | PDA [b"vault_auth_seed"]; подписывает перевод из хранилища. |
| 3 | pool_state | W | | Мутируется только если график нуждается в переподтверждении. |
| 4 | vesting_record | W | | claimed_amount обновляется. |
| 5 | base_vault | W | | Хранилище базового токена пула; дебетуется. |
| 6 | beneficiary_ata | W | | Получает разблокированные токены; init_if_needed. |
| 7 | base_mint | | | Базовый mint пула. |
| 8 | token_program | | | Программа SPL Token или Token-2022. |
| 9 | associated_token_program | | | Для создания ATA при необходимости. |
| 10 | system_program | | | Требуется для создания аккаунта. |
block_time >= pool_state.vesting_schedule.start_time (иначе VestingNotStarted).pool_state.status == PoolStatus::Migrated — выпуск должен был уже произойти. Вызов перед выпуском вернёт ошибку.- Дельта разблокированной суммы больше нуля. Холостой вызов (рассчитанная дельта 0) вернёт ошибку.
Постусловия
vesting_record.claimed_amount переходит в новую совокупную разблокированную сумму.delta_amount базового токена переводится на beneficiary_ata.
Общие ошибки — VestingNotStarted, NoAssetsToCollect, MathOverflow.
Практический пример
Запуск устанавливает:
supply = 1_000_000_000total_locked_amount = 100_000_000 (10% предложения)cliff_period = 180 * 86400 (180 дней)unlock_period = 365 * 86400 (1 год линейно после cliff)
Создатель выделяет два аккаунта VestingRecord сразу же после инициализации:
- Получатель A (команда):
share_amount = 70_000_000
- Получатель B (советник):
share_amount = 30_000_000
allocated_share_amount = 100_000_000, равно total_locked_amount — дальнейшие алокации невозможны.
Сбор средств завершается на 2027-01-01T00:00Z. Программа устанавливает start_time = 2027-01-01 + 180 дней = 2027-06-30.
На 2027-09-30 (90 дней после start_time), получатель A вызывает ClaimVestedToken:
elapsed = min(now, start_time + 365·86400) − start_time
= 90 · 86400
unlocked_amount = 70_000_000 × (90 / 365) ≈ 17_260_274
delta_amount = 17_260_274 − 0 = 17_260_274
vesting_record.claimed_amount переходит к 17_260_274.
Шесть месяцев спустя (2028-03-31, 270 дней после start_time), A получает снова:
unlocked_amount = 70_000_000 × (270 / 365) ≈ 51_780_822
delta_amount = 51_780_822 − 17_260_274 = 34_520_548
2028-06-30 (конец unlock_period), следующий вызов передаёт оставшиеся ~18,22 млн и оставляет claimed_amount == token_share_amount.
Граничные случаи
- Получатель потеряет ключ. Pubkey на
VestingRecord.beneficiary — единственный подписавший, который может вызвать ClaimVestedToken. Пути восстановления нет. Установите получателя на multisig, если восстановление важно.
- Комиссии за передачу Token-2022. Если базовый mint — это mint Token-2022 с расширением комиссии за передачу, получатель получает
delta_amount − transfer_fee, а не полную дельту. Хранилище пула всё ещё записывает валовую переданную сумму — разница начисляется на счёт удержанных комиссий mint.
- Пул не выпущен. Вызов
ClaimVestedToken перед выпуском вернёт ошибку. Часы вестинга начинают работать только когда сбор средств действительно завершится; отменённый запуск (который никогда не устанавливает start_time) оставляет заблокированные токены недостижимыми в хранилище.
- Попытки переалокации. Программа устанавливает
allocated_share_amount <= total_locked_amount при каждом CreateVestingAccount. Остаток (если есть) из total_locked_amount, оставшийся неалоцированным, теряется — эти токены остаются в хранилище навсегда после выпуска пула. Алоцируйте полную сумму, если это не намеренно.
Ссылки
Источники:
raydium-launch/programs/launchpad/src/states/vesting.rs — VestingRecord.raydium-launch/programs/launchpad/src/states/pool.rs — VestingSchedule, VestingParams, is_vesting_started, vesting_end_time.raydium-launch/programs/launchpad/src/instructions/create_vesting_account.rs.raydium-launch/programs/launchpad/src/instructions/claim_vested_token.rs.
