Lesson 0213 min
ALLOCATION · VESTING · OVERHANG

When Does a Promise of Future Tokens Become Liquid?

Separate allocations, locked balances, unlocked ceilings, and actual claims to see how a schedule changes future market supply.

ObjectivesAfter this lesson, you should be able to:
  • Separate allocation, lock, claimable amount, and claimed amount
  • Explain why unlocking is not minting
  • Use locked share to judge future supply pressure
COURSE POSITIONStep 2 of 4
  1. PREVIOUSSupply Is a Set of Powers, Not a Number
  2. CURRENTWhen Does a Promise of Future Tokens Become Liquid?

    Separate allocations, locked balances, unlocked ceilings, and actual claims to see how a schedule changes future market supply.

  3. NEXTWho Gets Diluted, and Who Gets the Choice?
BEFORE YOU READ

Think about these questions first.

Choose an answer before opening the explanation. You can add anything unexpected to your review list.

Q01Tokens unlocked. Why aren’t they necessarily in the market?
SHORT ANSWER

Unlocking only grants claimability. Distribution and market supply change after claiming, transferring, or selling; claimable and circulating are different states.

Compared with your prediction:

An allocation table says who is meant to own units; a vesting schedule says when those units can be used. They are not the same field. Collapse them into one balance and learners—and markets—misread future supply pressure.

One allocation has four states

Creator and community vesting already count toward total supply, but cannot transfer their locked units. Advancing the phase only increases the claimable amount; a claim action moves units into a liquid balance.

SIMULATION ACTIVEVirtual asset · LAB
ASSET 001 · SUPPLY & AUTHORITY

LAB / Virtual token

Every action changes a public state table. Ask who can change supply, who can claim, and who absorbs dilution.

Mint authorityCREATOR SINGLE SIGNERCreator can mint
Total supply1,000,000Cap 1,200,000
Liquid supply600,00060.0% liquid
Locked supply400,000Claimable 0
Mintable200,000room under cap
VESTING · UNLOCK OVERHANG

Claimable does not mean circulating

Advancing time only changes claimable amounts; holders still have to claim. Keep locked, claimable, and liquid units separate.

Phase Launch dayUnlock overhang 40.0%Claimable now 0 LAB
Allocation & vestingLaunch day
Creator400,000 LAB
Liquid 100,000 · Locked 300,000
Community400,000 LAB
Liquid 300,000 · Locked 100,000
Treasury200,000 LAB
Liquid 200,000 · Locked 0
Learner0 LAB
Liquid 0 · Locked 0
LiquidLocked

Locked units count toward total supply but cannot transfer yet. Color is secondary; numbers and labels are the state.

Observation prompt

Start with the supply map: liquid balances, locked balances, and the mint authority are separate state variables.

Supply events2 EVENTS
  1. 02

    Initial allocation recorded:创建者、社区、国库余额可用;另外 400,000 LAB 处于锁仓.

  2. 01

    LAB created:总供应 1,000,000, 供应上限 1,200,000, 创建者保留增发权限.

ACTION HISTORYExperiment timeline
1 state snapshots

Use the slider to return to an earlier step. Continuing from there replaces the later history with a new sequence.

Initial state
View experiment records →

Ask four questions about any schedule: how much was allocated, how much was claimed, how much is unlocked now, and has the holder actually claimed it? Only the last answer changes the liquid balance.

Time advancement is not an automatic transfer

A timestamp changes the maximum a protocol permits a holder to claim. It does not mean the holder submitted a claim transaction. That explicit action lets an event log answer when units moved from locked to liquid, whether a claim repeated, and whether balances still conserve.

Expand: how this step works
unlocked = floor(schedule.total × phaseBps / 10_000)
claimable = unlocked - schedule.claimed
claim(holder):
  balance[holder] += claimable
  schedule.claimed += claimable

Production contracts must specify block time, rounding direction, revocation, and beneficiary-change rights. This deterministic core uses integer phases so every claim can be replayed and checked.

KNOWLEDGE CHECK

What is true after advancing one vesting phase but before clicking claim?

Audit the schedule with one table

  • Is the full schedule already counted in total supply?
  • Can claimed ever exceed the unlocked ceiling?
  • After claim, does liquid rise and locked fall without total supply changing?
  • Do team, community, and investor unlocks cluster in the same phase?
LESSON RECAPComplete the exercise and knowledge check first