# Vesting & Claim Portal

### What is the Vesting & Claim Portal?

The **Vesting & Claim Portal** is where you turn your tokenomics into a **real, onchain distribution system**.

It lets you:

* Define **vesting strategies** (how and when tokens unlock).
* Assign **wallet allocations** to those strategies.
* Give users a **self-serve, branded portal** to connect their wallet and claim tokens as they unlock.

Instead of managing unlocks in spreadsheets and one-off contracts, you get a **single, structured system** that enforces your rules on-chain and makes the claim experience simple for your stakeholders.

<figure><img src="/files/HVhmaUk7fvdQoH9PPYXW" alt=""><figcaption></figcaption></figure>

***

### What problems does it solves

Without TMS, vesting usually looks like this:

* Token unlocks tracked in spreadsheets and ad-hoc dashboards.
* Custom vesting contracts for every launch or round.
* Confusion from investors and team members about **what they’re owed and when**.
* Manual, error-prone token sends.

With the Vesting & Claim Portal, you get:

* **Predictable unlocks** – Schedules are defined once and then executed via audited contracts.
* **Self-serve claiming** – Users connect their wallet and see exactly what they can claim.
* **Less support overhead** – You can answer “Where are my tokens?” with a single link.
* **Onchain transparency** – Unlock logic is transparent and verifiable.

Vesting stops being a spreadsheet problem and becomes a **core part of your token infrastructure**.

***

### How vesting works at a high level

In TMS, vesting is built around two simple ideas:

1. **Vesting strategy**
   * The **rules**: start date, cliff, duration, distribution type (linear, interval, monthly), and whether it’s revocable or immutable.
2. **Allocations**
   * The **who and how much**: wallet addresses and the number of tokens each should receive under that strategy.

You can have many strategies, for example:

* “Seed Round”
* “Private Round”
* “Team 4-Year”
* “Advisors”
* “Ecosystem Incentives”

Each strategy can hold **hundreds of allocations**, all following the same schedule logic.

***

### What your users see

From your users’ perspective, the Vesting & Claim Portal is simple:

1. They open your **branded portal** at a URL like `https://tokens.yourproject.com`.
2. They **connect their wallet**.
3. They see:
   * Which allocations they have (by category/strategy).
   * How much has **vested so far**.
   * How much is **claimable now**.&#x20;
4. They click **Claim**, sign a transaction, and receive tokens directly in their wallet.

They don’t need to understand the vesting math or the underlying contracts. The portal translates your tokenomics into a clear, usable interface.

> Note: Branding, colors, and domain settings are covered in the **Customization & White-label** docs. This page focuses on *how vesting itself works*.

<figure><img src="/files/jlemZypQ9Dwfc9DUUPQ6" alt=""><figcaption></figcaption></figure>

***

### Typical workflow for founders

A common workflow in TMS looks like this:

1. **Design your strategy**
   * Decide who needs vesting (team, investors, advisors, ecosystem, etc.).
   * Decide how each group should unlock (linear, interval, monthly, cliff, TGE portion).
2. **Create a vesting strategy**
   * Configure schedule, type, and category in TMS.
   * Set whether it should remain revocable (flexible) or eventually become immutable (locked).
3. **Upload wallet allocations**
   * Add wallets and amounts for each strategy via CSV or manual entry.
   * Review totals and timing.
4. **Fund and activate**
   * Ensure the vesting contract is funded (depending on your setup).
   * Let vesting start when its configured start date/cliff is reached.
5. **Share the claim portal**
   * Publish the claim URL to investors, team, and community.
   * Direct all “Where are my tokens?” questions there.
6. **Operate & commit**
   * Monitor strategies via the TMS dashboard.
   * For strategies you want to make **fully trustless**, lock them (immutable).
   * Only disable a live strategy if there’s a serious issue. In most cases, you’ll let it run as configured or lock it once you’re confident.

Over time, your vesting layer becomes a **permanent, auditable record** of who gets what, when, and why.

***

### How does this connect to the rest of TMS

The Vesting & Claim Portal works alongside other TMS modules:

* **Locks** – For tokens and LP that should not move at all until a specific time (e.g. team reserves, liquidity).
* **Staking** – For ongoing rewards and utility after tokens have vested.
* **Tokenomics & analytics** – To see circulating vs locked vs vested supply, and how vesting interacts with your overall token flows.

Together, they consolidate token operations into a single system rather than scattered tools.

***

### Where to go next

If you’re new to investing in TMS, start here:

* **How vesting strategies work**\
  Understand schedules, distribution types, and the revocable vs immutable model.

Then move on to:

* **Create a vesting strategy** (once that page is written) – to set up your first real schedule.
* **Manage strategies & wallet lookup** – to see how to run things day-to-day.
* **Display your vesting portal** – to share the claim experience with users.


---

# Agent Instructions: 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:

```
GET https://tms-finance.gitbook.io/tms.finance/vesting-and-lockups/vesting-and-claim-portal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.