Understand the timeline.
Start, cliff, end, and the difference between vested and claimed tokens.
The three dates
- Start
- The point from which vesting time is measured.
- Cliff
- The first point at which tokens can become claimable. It must fall between start and end.
- End
- The point at which the entire allocation is vested.
Before the cliff, nothing is claimable. At the cliff, vesting catches up to time elapsed since the start. After that, it increases linearly until the end.
An example with equal intervals
Suppose 1,200 tokens vest over 12 equal time intervals, with a cliff at the end of interval 3.
| Point in time | Total vested |
|---|---|
| Before the cliff | 0 tokens |
| At interval 3 | 300 tokens |
| At interval 6 | 600 tokens |
| At interval 12 | 1,200 tokens |
If 300 tokens were already claimed, the claimable amount at interval 6 is 300. This example uses equal intervals: actual vesting uses seconds, not calendar-month counts.
vested = total × (current time − start) ÷ (end − start)
claimable = vested − already claimedThe formula applies from the cliff onward and is capped at the total allocation. Amounts round down to whole token base units; the final claim includes the rounding remainder.
Who is the beneficiary?
The beneficiary is the wallet that receives every claim. It can be your own wallet or another recipient. Use my wallet fills the connected address in the form.
The recipient cannot be changed after creation. The creator does not get the tokens back by triggering a claim: the contract always sends them to the fixed beneficiary.
When and how claims happen
Vesting makes tokens available; it does not automatically send a transaction. Open the schedule, refresh its state, and select Claim tokens when there is a positive amount available. A claim transaction uses gas.
The contract permits anyone to trigger a claim, but payment always goes to the beneficiary. The dashboard currently lists the connected wallet’s creator/beneficiary schedules. The public viewer is read-only.
A schedule can be fully vested while tokens remain unclaimed. The app marks a schedule completed when its entire allocation has been claimed.
Can I edit or cancel it?
No. The current contract has no schedule editing, cancellation, beneficiary change, or administrator withdrawal function. Review the addresses, amounts, and dates before funding.
The form’s five-minute preset still creates a real funded schedule in mainnet mode. Use Demo workspace for a simulation.