Vesting é opcional em um lançamento do LaunchLab. Configure vesting_param.total_locked_amount = 0 em Initialize e a seção abaixo não se aplica. Uma vez ativado, o cronograma é fixo pela vida útil do lançamento; o cliff e os períodos de desbloqueio não podem ser alterados retroativamente.
Por que fazer vesting
A curva de ligação vende base_supply_graduation tokens durante a arrecadação de fundos e semeia o pool pós-formatura com o restante. O vesting separa uma fatia adicional da oferta, a bloqueia por um cliff configurável e, em seguida, a libera linearmente para um ou mais beneficiários — tipicamente a equipe do criador, consultores ou parceiros de plataforma.
Casos de uso práticos:
- Alocação de equipe. Um criador reserva, digamos, 5% da oferta para a equipe fundadora, bloqueada por 6 meses e desbloqueando linearmente nos 12 meses seguintes.
- Alocação de plataforma. Uma plataforma de lançamento recebe uma fatia de cada token que lista, no mesmo cronograma, via
CreatePlatformVestingAccount.
- Concessões a consultores / contribuidores. Múltiplos beneficiários com suas próprias contas
VestingRecord, cada um rastreando seu próprio valor reivindicado de forma independente.
Tokens bloqueados nunca entram na curva e não fazem parte do LP de formatura. Eles ficam dormentes no base_vault do pool até que cada beneficiário chame ClaimVestedToken.
O vesting para um lançamento é descrito por três números, registrados uma vez no momento de Initialize:
| Campo | Tipo | Significado |
|---|
total_locked_amount | u64 | Soma de todos os tokens base bloqueados em todos os beneficiários (criador + plataforma). Deve satisfazer total_locked_amount <= supply * max_lock_rate / 1_000_000 da GlobalConfig vinculante. |
cliff_period | u64 (segundos) | Tempo de espera após o fim da arrecadação antes de qualquer desbloqueio de tokens. |
unlock_period | u64 (segundos) | Duração da janela de desbloqueio linear após o cliff. 0 significa que tudo é desbloqueado instantaneamente no final do cliff. |
PoolState.vesting_schedule (uma struct VestingSchedule) mais o start_time em cadeia, que o programa registra como block_time + cliff_period no momento em que a arrecadação termina com sucesso (quando as condições de formatura são primeiramente atendidas).
// 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 é o montante total já atribuído às contas VestingRecord via CreateVestingAccount / CreatePlatformVestingAccount. Nunca deve exceder total_locked_amount. Se um criador fizer uma alocação excessiva, a próxima chamada CreateVestingAccount reverte com InvalidTotalLockedAmount.
Fórmula de desbloqueio linear
Após o fim da arrecadação de fundos, o programa calcula o montante cumulativo desbloqueado para cada VestingRecord como:
elapsed = min(now, start_time + unlock_period) − start_time
unlocked_amount = token_share_amount × elapsed / unlock_period
unlock_period == 0, todo o token_share_amount fica reivindicável em uma única etapa em start_time. Caso contrário, a curva é uma linha reta de 0 em start_time para token_share_amount em start_time + unlock_period, limitada a token_share_amount daí em diante.
O montante transferido em cada chamada ClaimVestedToken é o delta entre o montante cumulativo desbloqueado recém-recomputado e o campo claimed_amount em execução no registro.
delta_amount = unlocked_amount − vesting_record.claimed_amount
vesting_record.claimed_amount = unlocked_amount
start_time reverte com VestingNotStarted. Uma reivindicação após start_time + unlock_period resolve o restante total.
Layouts de conta
VestingSchedule
Reside inline em PoolState. Veja accounts.
VestingRecord
Registro por beneficiário. PDA derivada como:
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 por lançamento. Alocar novamente para o mesmo beneficiário no mesmo lançamento reverte porque a PDA já existe.
Instruções
CreateVestingAccount
Somente para criador. Aloca uma fatia do total_locked_amount do pool para um novo beneficiário inicializando uma PDA VestingRecord nova.
Argumentos
share_amount: u64 // tokens to assign to this beneficiary
| # | Nome | W | S | Notas |
|---|
| 1 | creator | W | S | Deve ser igual a pool_state.creator; paga aluguel pela nova conta. |
| 2 | beneficiary | W | | Recebe os tokens desbloqueados mais tarde. O pubkey é bloqueado aqui — não pode ser alterado. |
| 3 | pool_state | W | | Mutada para aumentar vesting_schedule.allocated_share_amount. |
| 4 | vesting_record | W | | init; PDA [b"pool_vesting", pool_state, beneficiary]. |
| 5 | system_program | | | Obrigatório para criação de conta. |
share_amount > 0.pool_state.vesting_schedule.allocated_share_amount + share_amount <= total_locked_amount.- O pubkey do
beneficiary não tem nenhum VestingRecord existente para este pool.
Pós-condições
vesting_record inicializada com token_share_amount = share_amount, claimed_amount = 0.pool_state.vesting_schedule.allocated_share_amount += share_amount.
Erros comuns — InvalidTotalLockedAmount, InvalidInput.
Variante de admin de plataforma de CreateVestingAccount. A carteira de vesting da plataforma (armazenada em PlatformConfig.platform_vesting_wallet) é o beneficiário, e a fatia é limitada por PlatformConfig.platform_vesting_scale.
O signatário deve ser igual a platform_config.platform_vesting_wallet. Outras contas espelham CreateVestingAccount. Use isto quando uma plataforma se contrata para receber uma fatia de vesting fixa em cada lançamento que lista.
ClaimVestedToken
Somente para beneficiário. Transfere qualquer token recém-desbloqueado do base_vault do pool para o ATA do beneficiário.
Argumentos
Nenhum (o programa calcula o montante da reivindicação a partir do cronograma).
Contas
| # | Nome | W | S | Notas |
|---|
| 1 | beneficiary | W | S | Deve ser igual a vesting_record.beneficiary. |
| 2 | authority | | | PDA [b"vault_auth_seed"]; assina a transferência do vault. |
| 3 | pool_state | W | | Mutada apenas se o cronograma precisar ser revalidado. |
| 4 | vesting_record | W | | claimed_amount é atualizada. |
| 5 | base_vault | W | | Vault de token base do pool; debitado. |
| 6 | beneficiary_ata | W | | Recebe os tokens desbloqueados; init_if_needed. |
| 7 | base_mint | | | Mint de token base do pool. |
| 8 | token_program | | | Programa SPL Token ou Token-2022. |
| 9 | associated_token_program | | | Para criação de ATA se necessário. |
| 10 | system_program | | | Obrigatório para criação de conta. |
block_time >= pool_state.vesting_schedule.start_time (caso contrário VestingNotStarted).pool_state.status == PoolStatus::Migrated — a formatura deve ter acontecido já. Chamar antes da formatura reverte.- O delta do montante desbloqueado é maior que zero. Uma chamada no-op (delta calculada é 0) reverte.
Pós-condições
vesting_record.claimed_amount avança para o novo montante cumulativo desbloqueado.delta_amount de token base é transferido para beneficiary_ata.
Erros comuns — VestingNotStarted, NoAssetsToCollect, MathOverflow.
Exemplo prático
Um lançamento define:
supply = 1_000_000_000total_locked_amount = 100_000_000 (10% da oferta)cliff_period = 180 * 86400 (180 dias)unlock_period = 365 * 86400 (1 ano linear após o cliff)
O criador aloca duas contas VestingRecord imediatamente após Initialize:
- Beneficiário A (equipe):
share_amount = 70_000_000
- Beneficiário B (consultor):
share_amount = 30_000_000
allocated_share_amount = 100_000_000, igual a total_locked_amount — nenhuma alocação adicional possível.
A arrecadação de fundos é concluída em 2027-01-01T00:00Z. O programa define start_time = 2027-01-01 + 180 dias = 2027-06-30.
Em 2027-09-30 (90 dias após start_time), o Beneficiário A chama 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 avança para 17_260_274.
Seis meses depois (2028-03-31, 270 dias após start_time), A reivindica novamente:
unlocked_amount = 70_000_000 × (270 / 365) ≈ 51_780_822
delta_amount = 51_780_822 − 17_260_274 = 34_520_548
2028-06-30 (o fim de unlock_period), a próxima reivindicação transfere os ~18,22M restantes e deixa claimed_amount == token_share_amount.
Casos extremos
- Beneficiário perde sua chave. O pubkey em
VestingRecord.beneficiary é o único signatário que pode chamar ClaimVestedToken. Não há caminho de recuperação. Configure o beneficiário para um multisig se a recuperação importa.
- Taxas de transferência do Token-2022. Se o mint base é um mint Token-2022 com uma extensão de taxa de transferência, o beneficiário recebe
delta_amount − transfer_fee, não o delta total. O vault do pool ainda registra o montante bruto como transferido — a diferença acumula na conta de taxa retida do mint.
- Pool não formado. Chamar
ClaimVestedToken antes da formatura reverte. O relógio de vesting começa apenas quando a arrecadação de fundos realmente termina; um lançamento abortado (que nunca define start_time) deixa tokens bloqueados inacessíveis no vault.
- Tentativas de alocação excessiva. O programa impõe
allocated_share_amount <= total_locked_amount em cada CreateVestingAccount. O restante (se houver) de total_locked_amount deixado não alocado é perdido — esses tokens permanecem no vault para sempre uma vez que o lançamento se forma. Aloque o montante total a menos que essa seja a intenção.
Ponteiros
Fontes:
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.
