P12-L02 · P12 · P12-M01
Design a transparent illustrative allocation with unlock constraints
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
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
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
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.