Back

Supply allocation and vesting

P12-L02 · P12 · P12-M01

Design a transparent illustrative allocation with unlock constraints

ILLUSTRATIVE · needs_review

Prerequisites: P12-L01

Learning objectives

  • Design a transparent illustrative allocation with unlock constraints
  • Reconcile a fictional allocation and compute a bounded unlock schedule in compatible units.

Why this matters

An allocation pie can sum to 100% while obscuring immediate team control or a vesting schedule that starts before funds are deposited.

Explanation

Specify total raw supply, decimal precision and allocation denominator before displaying percentages. Every allocation needs a purpose, recipient/authority label, amount, immediate availability and release conditions. Do not confuse a planned schedule with an enforced deployed contract. The source documentation describes a vesting mechanism; the exercise below defines its own hypothetical schedule.

For linear vesting, state start, duration, cliff if any, total allocation and released-to-date. Calculate vested entitlement separately from currently claimable amount: previous releases reduce what remains claimable. If deposits can arrive after the schedule starts, the implementation may make a portion immediately releasable; disclose that dependency rather than assuming a fresh lock for each deposit. Beneficiary transfer and administrative paths also matter.

An allocation disclosure does not independently verify all wallets or prevent another mint path. A total-supply design must be reconciled with actual supply/authority evidence before a live claim is possible. Here all amounts and recipients remain fictional, with no contract deployment or funding.

Key terms

Allocation denominator: stated total used for percentage calculations.

Vested entitlement: amount earned by the stipulated schedule.

Claimable: vested minus already released.

Enforced vesting: schedule implemented by inspectable controls, not a prose promise.

Historical example

ILLUSTRATIVE Cedar supply=1,000,000 whole-unit equivalents: community 500,000; treasury 250,000; team 200,000; testing reserve 50,000. Team schedule is stipulated linear over24 months from month 0, no cliff; at month 6,20,000 have already been released. This is a paper schedule, not a real escrow.

Visual specifications

Holder distribution plus unlock timeline:50/25/20/5 allocation shares; team month 6 vested 50,000, released 20,000, claimable 30,000, unvested 150,000. Label every figure illustrative and distinguish schedule from enforcement.

Caption: Fictional allocation and paper unlock schedule; no deposited or locked asset.

SPECIFICATION_ONLY — the rendered visual has not been produced or independently reviewed.

What the evidence proves

The fictional allocations sum to 1,000,000 and 100%. At month 6 the stipulated team entitlement is50,000; claimable is30,000 after the stated prior release.

What the evidence does not prove

It proves no locked funds, real custody, beneficiary independence, cap enforcement or future execution. A100% allocation pie cannot establish100% of supply is actually controlled by these labels.

Common mistakes

Showing vested amount as claimable; omitting prior releases; calling a paper promise a lock; ignoring late-deposit or beneficiary-transfer behavior.

Practical exercise

Calculate all percentages, month 6 team entitlement and claimable balance. Write a disclosure explaining the difference between this schedule and a verified vesting implementation.

Show worked correction

Community50%, treasury 25%, team 20%, reserve 5%; total 100%. Team vested=200,000×6/24=50,000. Claimable=50,000−20,000=30,000; remaining unvested=150,000. Disclosure: “Illustrative linear paper schedule with no cliff; no vesting contract, deposited balance, beneficiary path or release transaction has been independently observed.” An actual implementation must verify start/duration, deposits, prior releases and authority paths separately.

Checklist

  • Reconcile units and total allocation.
  • State start, duration, cliff and prior releases.
  • Separate vested, claimable and unvested amounts.
  • Do not label a paper schedule as enforced lock.

Summary

Allocation arithmetic is reproducible when its denominator and release assumptions remain explicit; enforcement requires separate records.

Summary

  • Vested is not the same as claimable.
  • A schedule promise is not an observed lock.
  • Supply and authority evidence must accompany live allocation claims.

Next lesson

P12-L03

Tools

Use the named ZECOIN tool only as an evidence-reading context. This lesson creates no tool output, account session or entitlement. Offline exercise; do not sign, deploy, approve or fund anything.

Sources & claim boundaries

  • ERC20: ERC-20 standard — Token interface and allowance semantics; the standard does not establish issuer identity or safe permissions. Boundary: Mechanism documentation only; original illustrative values are stipulated, not observations. Historical records have separately frozen provenance and explicit collection gaps.
  • VEST: OpenZeppelin Contracts 5.x finance — VestingWallet mechanism; actual schedule and beneficiary control require specific implementation evidence. Boundary: Mechanism documentation only; original illustrative values are stipulated, not observations. Historical records have separately frozen provenance and explicit collection gaps.

Evidence classifications

ILLUSTRATIVE — entirely fictional offline inputs; no current observation.

Observation date

null — no real observation

Content version

1

Review date

null

Review status

needs_review

Visual specifications

P12-L02-V01

SPECIFICATION_ONLY · ILLUSTRATIVE

Design a transparent illustrative allocation with unlock constraints

Fictional allocation and paper unlock schedule; no deposited or locked asset.

Holder distribution plus unlock timeline:50/25/20/5 allocation shares; team month 6 vested 50,000, released 20,000, claimable 30,000, unvested 150,000. Label every figure illustrative and distinguish schedule from enforcement.

Holder distribution plus unlock timeline:50/25/20/5 allocation shares; team month 6 vested 50,000, released 20,000, claimable 30,000, unvested 150,000. Label every figure illustrative and distinguish schedule from enforcement.

Stack observations, assumptions, gaps and conclusion at 390 px; retain full IDs and a complete text equivalent. Any wide table scrolls locally.

Prose may follow RTL; IDs, quantities and time axes remain LTR. Preserve dependency direction.

P12-L02-ILLUSTRATIVE-v1

Sources & claim boundaries

ERC20 · PRIMARY_DOCUMENTATION

ERC-20 standard

Supported claim
Token interface and allowance semantics; the standard does not establish issuer identity or safe permissions.
Verification boundary
Mechanism documentation only; original illustrative values are stipulated, not observations. Historical records have separately frozen provenance and explicit collection gaps.
Checked at
2026-10-02
Open primary source
https://eips.ethereum.org/EIPS/eip-20

VEST · PRIMARY_DOCUMENTATION

OpenZeppelin Contracts 5.x finance

Supported claim
VestingWallet mechanism; actual schedule and beneficiary control require specific implementation evidence.
Verification boundary
Mechanism documentation only; original illustrative values are stipulated, not observations. Historical records have separately frozen provenance and explicit collection gaps.
Checked at
2026-10-02
Open primary source
https://docs.openzeppelin.com/contracts/5.x/api/finance

Dataset provenance

id: P12-L02-ILLUSTRATIVE-v1

dataStatus: ILLUSTRATIVE

observedAt: null

source: Original offline scenario in realOrHistoricalExample

scope: Fictional stipulated labels and values. No wallet, deployment, transaction, token launch or production observation.

Test your reasoning

P12-L02-Q1 · How much is team vested at month 6 under the stipulated schedule?
P12-L02-Q2 · After20,000 released, what remains claimable?
P12-L02-Q3 · The four allocations sum to 100%. What does this establish?
P12-L02-Q4 · A deposit arrives after a vesting schedule starts. What must be checked?
P12-L02-Q5 · What is necessary before calling the paper schedule an enforced lock?