Token Vesting | Umia Docs

Umia mints a project's entire initial token supply once, up front. Only the circulating float is sold in the auction; the allocations for founders, the team, and early backers are locked in vesting contracts and released gradually, as time passes or as price milestones defined in the grant are met. Because the initial supply already exists in full, unlocks never create hidden dilution, and any later issuance happens only through a decision market (see Ongoing Funding). The app always shows circulating vs. total so the locked overhang stays visible.

Umia handles this with MetaVesT, a well-established onchain vesting framework wired into the project's noncustodial treasury and decision-market governance.

Noncustodial by design

No founder or team member can move locked tokens early. Release follows the schedule that was set, and any new grants or changes go through a decision market, never a unilateral action.

How a Grant Works

Each grant is its own onchain allocation that custodies its tokens for the grant's lifetime. Two independent conditions decide how much a beneficiary can actually take:

Vesting: has the token been earned yet (by time or by price)?
Unlocking: has it been released for withdrawal yet?

A beneficiary can withdraw the amount that has both vested and unlocked, minus whatever they have already taken. Keeping the two axes separate lets a project, for example, vest tokens on a fast schedule while releasing them more slowly.

Two Release Schedules

Over time. Tokens vest linearly across a set duration. A grant can include a cliff, an initial period where nothing vests, after which a lump becomes available all at once and the rest continues linearly. This is the classic "1-year cliff, then linear" startup schedule.

At a price. A grant can carry milestones that unlock only once the token's market price crosses a set threshold. The price used is a manipulation-resistant time-weighted average (TWAP), so a momentary spike can't trigger an unlock. This ties rewards to value actually delivered, not just time served.

A single grant can combine both: a steady time-vesting stream plus price milestones layered on top.

Price unlocks come after launch

A price milestone can only be met once the project's market is live (after the auction migrates to a spot pool). There is no market price before then.

The Three Kinds of Grant

MetaVesT supports three allocation types, so Umia can model the usual compensation structures:

Vesting allocation: the common case. Granted tokens vest and unlock on the schedule above.
Token option: the right to buy tokens at a fixed exercise price. The option vests over time; the holder pays the exercise price to claim the underlying tokens.
Restricted token award: tokens granted up front but subject to repurchase if conditions aren't met; the restriction lapses on a schedule.

When Grants Are Created

At launch (genesis). Founder, team, and early-backer grants are locked before the token goes to auction, so only the remaining float is offered to the public. Once the project is live, control over the grants routes to the project's governance; at no point can the launch operator amend, terminate, or claw back an existing grant.

After launch. A new grant (a new hire, an advisor) is added through a decision market. The treasury mints and funds the allocation only if the market approves the proposal, the same way every other treasury action is governed.

Claiming

Beneficiaries claim directly from their own allocation whenever something is withdrawable: withdraw for a vesting grant, exercise for an option. Confirming a price milestone is permissionless: anyone (or Umia's keeper, as a convenience) can flip a milestone to "unlocked" once its TWAP threshold has been met.

Seeing It in the App

The project's vesting surface shows, for each grant, how much has been granted / vested / unlocked / claimed / withdrawable, the schedule behind it, and any price tranches measured against the live TWAP, alongside the project-wide circulating-vs-total supply view.