LaunchLab-Vesting

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​

Warum Vesting?

• Team-Zuteilung. Ein Gründer reserviert z. B. 5 % der Versorgung für das Gründungsteam, gesperrt für 6 Monate und linear über die folgenden 12 Monate freigegeben.
• Plattform-Zuteilung. Eine Launch-Plattform erhält einen Anteil an jedem Token, den sie auflistet, nach dem gleichen Zeitplan, über CreatePlatformVestingAccount.
• Berater- / Mitwirkendenzuschüsse. Mehrere Begünstigte mit eigenen VestingRecord-Konten, die jeweils ihren beanspruchten Betrag unabhängig nachverfolgen.

​

Zeitplan-Form

// states/pool.rs
pub struct VestingSchedule {
    pub total_locked_amount:     u64,
    pub cliff_period:            u64,
    pub unlock_period:           u64,
    pub start_time:              u64,   // von Programm bei Fundraising-Ende gesetzt
    pub allocated_share_amount:  u64,   // laufende Summe der Zuordnungen zu Vesting-Records
}

​

Lineare Freigabeformel

elapsed         = min(now, start_time + unlock_period) − start_time
unlocked_amount = token_share_amount × elapsed / unlock_period

delta_amount    = unlocked_amount − vesting_record.claimed_amount
vesting_record.claimed_amount = unlocked_amount

​

Konto-Layouts

​

VestingSchedule

​

VestingRecord

seeds = [
  b"pool_vesting",
  pool_state.key(),
  beneficiary.key(),
]
program = LaunchLab-Programm

// states/vesting.rs
#[account]
pub struct VestingRecord {
    pub epoch:               u64,         // recent_epoch-Tracker
    pub pool:                Pubkey,      // Rückverweis auf PoolState
    pub beneficiary:         Pubkey,      // wer ClaimVestedToken aufrufen darf
    pub claimed_amount:      u64,         // kumulativ beansprucht
    pub token_share_amount:  u64,         // insgesamt diesem Begünstigten zugeordnet
    pub padding:             [u64; 8],
}

​

Instruktionen

​

CreateVestingAccount

share_amount: u64    // Token, die diesem Begünstigten zugeordnet werden

• share_amount > 0.
• pool_state.vesting_schedule.allocated_share_amount + share_amount <= total_locked_amount.
• Der beneficiary-Pubkey hat keinen bestehenden VestingRecord für diesen Pool.

• vesting_record initialisiert mit token_share_amount = share_amount, claimed_amount = 0.
• pool_state.vesting_schedule.allocated_share_amount += share_amount.

​

CreatePlatformVestingAccount

​

ClaimVestedToken

• block_time >= pool_state.vesting_schedule.start_time (andernfalls VestingNotStarted).
• pool_state.status == PoolStatus::Migrated – Graduation muss bereits stattgefunden haben. Ein Aufruf vor Graduation wird rückgängig gemacht.
• Das entsperrte-Betrag-Delta ist größer als Null. Ein No-Op-Aufruf (berechneters Delta ist 0) wird rückgängig gemacht.

• vesting_record.claimed_amount geht zum neuen kumulativen entsperrten Betrag über.
• delta_amount Basis-Token wird zu beneficiary_ata übertragen.

​

Bearbeitetes Beispiel

• supply = 1_000_000_000
• total_locked_amount = 100_000_000 (10 % der Versorgung)
• cliff_period = 180 * 86400 (180 Tage)
• unlock_period = 365 * 86400 (1 Jahr linear nach dem Cliff)

• Begünstigter A (Team): share_amount = 70_000_000
• Begünstigter B (Berater): share_amount = 30_000_000

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

unlocked_amount = 70_000_000 × (270 / 365) ≈ 51_780_822
delta_amount    = 51_780_822 − 17_260_274 = 34_520_548

​

Grenzfälle

• Begünstigter verliert seinen Schlüssel. Der Pubkey auf VestingRecord.beneficiary ist der einzige Unterzeichner, der ClaimVestedToken aufrufen kann. Es gibt keinen Wiederherstellungspfad. Setzen Sie den Begünstigten auf eine Multisig, wenn Wiederherstellung wichtig ist.
• Token-2022-Transfergebühren. Wenn die Basis-Mint eine Token-2022-Mint mit einer Transfergebührerweiterung ist, empfängt der Begünstigte delta_amount − transfer_fee, nicht das vollständige Delta. Der Vault des Pools erfasst immer noch den Bruttobetrag als übertragen – die Differenz wird dem Withheld-Fee-Konto der Mint zugerechnet.
• Pool nicht graduiert. Ein Aufruf von ClaimVestedToken vor Graduation wird rückgängig gemacht. Die Vesting-Uhr beginnt nur, wenn die Fundraising tatsächlich abgeschlossen ist; ein abgebrochener Launch (der nie start_time setzt) hinterlässt gesperrte Token unerreichbar im Vault.
• Über-Allokations-Versuche. Das Programm setzt allocated_share_amount <= total_locked_amount auf jedem CreateVestingAccount durch. Der Rest (falls vorhanden) von total_locked_amount bleibt unzugeordnet und ist verloren – diese Token bleiben einmal Graduation für immer im Vault. Ordnen Sie den vollständigen Betrag zu, es sei denn, das ist beabsichtigt.

​

Verweise

• products/launchlab/accounts – vollständiges PoolState-Layout inklusive VestingSchedule.
• products/launchlab/instructions – Graduation-Lebenszyklus.
• products/launchlab/platform-config – platform_vesting_scale-Semantik für Plattform-Zuordnungen.
• products/launchlab/global-config – max_lock_rate-Obergrenze, die total_locked_amount begrenzt.

• 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.