Cliff Vesting

A pure vesting calculator, demoing the p/moul/x/daily/cliffvesting library.

A 12-month grant with a 3-month cliff

1200 tokens, Start = 0, Cliff = 3, End = 12.

month	vested	unvested	%
0	0	1200	0%
1	0	1200	0%
2	0	1200	0% ← nothing yet
3	300	900	25% ← cliff
4	400	800	33%
5	500	700	41%
6	600	600	50%
7	700	500	58%
8	800	400	66%
9	900	300	75%
10	1000	200	83%
11	1100	100	91%
12	1200	0	100% ← fully vested

The cliff is a step, not a ramp: at month 3 a quarter of the term has elapsed, so 300 tokens unlock at once. After that it accrues linearly.

Claiming

The library tracks no balances — the caller supplies what has already been claimed:

at month	already claimed	claimable
6	0	600
6	300	300
6	600	0
12	600	600

Integer rounding

All arithmetic is integer — no float ever reaches consensus state. Rounding is down, so nobody is ever paid more than they earned, and the final instalment collects the remainder.

1000 over 3 periods:

t	vested
0	0
1	333
2	666
3	1000

333 + 333 + 334 — the end is exactly 1000, never 999.

The bug this avoids

When the total is smaller than the duration, computing a per-tick rate first truncates it to zero and nothing ever vests. Multiplying before dividing keeps it honest — 7 tokens over 1000 ticks:

t	vested
100	0
150	1
500	3
1000	7