> For the complete documentation index, see [llms.txt](https://docs.chestfi.cash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chestfi.cash/tools/token-vesting.md).

# Token Vesting

Set structured vesting schedules. Supports cliffs, gradual release, and self-claim directly via the Web App.

* **Path:** Web App → **Token Vesting → Create Vesting / My Vestings**
* **Status:** Coming soon

### Current status

> **Coming Soon** — Token Vesting is not available yet. Please check back later.

The **Active Vestings** counter on your Dashboard will populate once the module ships.

### What vesting is

A lock is binary: everything is frozen, then everything is free. Vesting is gradual: tokens unlock continuously or in steps over a defined period, so a recipient earns access over time rather than receiving a single cliff-edge windfall.

The standard vocabulary:

| Term               | Meaning                                                                                                                                                                    |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Cliff**          | An initial period during which nothing unlocks. A 12-month cliff means the recipient can claim nothing for a year, then receives everything accrued so far in one release. |
| **Vesting period** | The total duration over which the full allocation unlocks.                                                                                                                 |
| **Linear release** | Tokens unlock at a constant rate — a little more claimable every block.                                                                                                    |
| **Claim**          | The recipient's transaction to withdraw whatever has vested so far. Unclaimed tokens keep accruing; there's no penalty for claiming late.                                  |

A common team schedule: **4-year vesting, 1-year cliff.** Nothing for twelve months; at month 12 the recipient can claim 25%; the remaining 75% then unlocks smoothly over the following three years.

### Planned capabilities

* **Cliffs** — an initial no-release period of any length.
* **Gradual release** — linear unlocking after the cliff.
* **Self-claim** — beneficiaries connect their own wallet and claim what has vested. No action required from you, no manual distributions, no spreadsheets.
* **Multiple beneficiaries** — one schedule per recipient, all visible from **My Vestings**.
* **Public verification** — schedules readable on-chain by anyone.

### When to use vesting instead of a lock

| Situation                                          | Use                                                                                    |
| -------------------------------------------------- | -------------------------------------------------------------------------------------- |
| Team allocation with long-term alignment           | **Vesting** — a cliff plus linear release ties compensation to continued contribution. |
| Investor allocation with negotiated unlock terms   | **Vesting**                                                                            |
| Proving liquidity can't be pulled                  | **Locker** — binary is the point.                                                      |
| A single treasury commitment with one release date | **Locker** — simpler and cheaper.                                                      |
| Advisor or contributor grants                      | **Vesting**                                                                            |

### In the meantime

You can approximate a vesting schedule using several Token Locker entries with staggered unlock dates — for example, four locks unlocking at 12, 24, 36, and 48 months. It is coarser than true linear vesting and each lock costs a separate `0.000615 ETH` fee, but the trust signal is comparable and it's available today.

Follow [@ChestFiCash](https://x.com/ChestFiCash) for the launch announcement.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.chestfi.cash/tools/token-vesting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.