> For the complete documentation index, see [llms.txt](https://docs.smithii.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smithii.io/products/tools/solana/token-tools/token-vesting.md). # Token Vesting Lock SPL tokens in a Smithii contract and release them on a fixed schedule, with a public certificate anyone can check. Token Vesting locks SPL tokens in a Smithii contract and releases them on a fixed schedule. The schedule and the receivers are recorded on-chain, and anyone can check them on a public page (the "certificate"). You don't need to write any code. Project teams use it to prove that team, investor or treasury tokens are locked and unlock on specific dates. You can also use it to lock your own tokens for yourself. The release is **step-based**, not linear: either a single unlock on one date, or up to 5 tranches, each with its own date and percentage. ## Open the tool * [Open Token Vesting on Solana](https://tools.smithii.io/token-vesting/solana) {% embed url="" %} ## How it works 1. Connect your [wallet](https://smithii.io/en/dictionary/wallet/). It becomes the **authority** (creator) of the vesting. 2. Choose the **method**: * **Single unlock**: 100% is released on one date. * **Cliffs**: the release is split into 1 to 5 tranches. This is the default method. 3. Pick the **token** from your wallet and the **amount** to lock. Only whole amounts are accepted (no decimals). The token must use the classic SPL Token program: Token-2022 tokens are not accepted. Your balance must cover the amount. 4. Enter the **vesting URL**: the last part of the public address. Lowercase letters, numbers and hyphens only, up to 30 characters. 5. Write a **description** (required, up to 500 characters). It is shown on the certificate. 6. Click **Choose duration**. There are two tabs: * **Duration**: years, days, hours and minutes counted from now. The default is 60 days. A year counts as 365 days. * **Fixed Dates**: start and end date and time. The start can't be in the past. 7. If you chose **Cliffs**, set the number of steps (1 to 5). For each step, set the **end date** and the **percentage to unlock**. Dates are spread evenly at first, but you can edit them. Each date must be later than the previous one, no date can go past the vesting end date, percentages are whole numbers from 0 to 100 and **they must add up to exactly 100%**. Percentages start at 0 so you set each split yourself. 8. Check the **simulation** chart of the schedule. 9. Optional, under **Advanced Options**: add **receivers** (extra fee) and certificate details (social links and a [tokenomics](https://smithii.io/en/dictionary/tokenomics/) image). 10. Review the summary on the right (method, token, amount, fee, "Non-cancelable: Yes", duration, steps and dates) and click **Create Token Vesting**. You sign one transaction. The tool sends it to Smithii's servers, which submit it on-chain and register the URL. You are then redirected to the certificate. You can create only one vesting per wallet and token. The tool blocks a second vesting of the same token from the same wallet. ## Features and options ### Single unlock The whole amount stays locked until the end date. From then on, 100% can be claimed. ### Cliffs (tranches) Each tranche releases a percentage of the total on its end date. Until that date, that percentage stays locked. There is no gradual release between dates: the unlocked total is the sum of the tranches whose date has passed. For example, with three tranches of 20%, 30% and 50%, the unlocked amount goes from 0% to 20%, then to 50% and then to 100%. Each tranche end date must be later than the previous one (the first one, later than the start), so nothing unlocks at the moment of creation. What counts for claiming are the end dates of each tranche. ### Receivers Optional, with an extra fee (see Fees). Without receivers, only the authority (you) can claim. With receivers turned on: * Up to 50 wallets. Paste one per line or import a CSV or TXT file. * All must be valid wallet addresses and can't repeat. You need at least one. * **Every receiver gets the same share**: the total divided by the number of receivers. You can't assign different amounts. * Only a fingerprint of the list (a Merkle root) is stored on-chain. The full list is stored on IPFS together with the description, and it is public. * Once you add receivers, the authority can no longer claim. Only the wallets on the list can. ### Certificate details Optional: website, Telegram, Discord and X/Twitter links (up to 45 characters each) and a tokenomics image. The image is uploaded to IPFS; the form suggests PNG or JPG at 1000x1000 px. ### Claiming The public vesting page (`/vesting/solana/`) is where tokens are claimed: 1. The beneficiary connects their wallet. If it is authorized (on the receivers list or, if there is no list, the authority), the page shows the available amount and the next unlock. If not, the page says so. 2. They click **Claim Now**. The "Withdraw from vesting" window shows the unlocked amount, what was already withdrawn and what can be withdrawn now. The amount and the destination (their own wallet) are fixed. 3. On confirming, they receive everything unlocked that they haven't withdrawn yet. They can claim several times, tranche by tranche, or let it build up. The contract records the percentage each beneficiary has already claimed. ### What the public sees on the certificate * Status (Upcoming, Vesting or Completed), start and end dates, token, number of tranches and amount per tranche. * A pie chart of unlocked versus locked, and the schedule chart. * A list of milestones with their status: Upcoming, Unlocked, Partially claimed, Claimed. * Project description, social links, tokenomics image and the "How to claim" steps. * Addresses to verify on Solscan: the vesting account, the authority and the mint. The receivers list is not shown on the page, but it is public on IPFS. ### Admin panel The creator has a page at `/vesting/solana//admin`, available only when the authority wallet is connected. It shows the status, dates, charts, number of receivers, the amount already claimed and the remaining balance, plus a **Share** button to copy the public link. It is read-only: you can't edit or cancel from it. Older links in the format redirect to the admin panel of that vesting. {% hint style="info" %} There is no list of "your vestings" in the tool. Save the link of your vesting page when you create it. {% endhint %} ## Limits | Setting | Limit | | ----------------------------- | ------------------------------------------- | | Tranches (Cliffs) | 1 to 5 | | Receivers | 1 to 50, equal shares | | Vesting URL | 30 characters (lowercase, numbers, hyphens) | | Description | 500 characters | | Social links | 45 characters each | | Vestings per wallet and token | 1 | | Token standard | Classic SPL Token (no Token-2022) | ## Fees | Action | Smithii fee | | --------------------- | -------------- | | Single unlock | 0.3 SOL | | Cliffs | +0.1 SOL | | Receivers | +0.1 SOL | | Cliffs with receivers | 0.5 SOL | | Claiming | No Smithii fee | When you create the vesting you also pay, once, the deposit (rent) for the accounts the contract opens. When a beneficiary claims, they pay only network gas and, if needed, the opening of their token account. Network gas is paid separately. Fees were checked on 2026-10-26 and can change: the tool shows the exact amount before you sign. ## Good to know {% hint style="warning" %} **A vesting can't be cancelled or edited.** Once created, the schedule is final. The creator can't take the tokens back while they are locked, and with receivers set, the authority can't claim them either. {% endhint %} * It is non-custodial: Smithii has no access to the vault where the tokens are held. The contract moves the tokens from your account to an account owned by the vesting. * Check the dates carefully. The form warns you when you change the duration, but review the tranche percentages after every change. * Without receivers, only the authority can claim. If you lose access to that wallet, you lose access to the tokens. * Amounts are whole numbers. A token with decimals can be locked, but only in full units. * The certificate can show a different symbol or name if the token metadata was changed. Always verify the mint. * Token-2022 tokens are not supported. ## FAQ ### Is the release linear? No. It is step-based: a single unlock or up to 5 tranches, each with its own date and percentage. ### Who can claim? Without receivers, only the wallet that created the vesting. With receivers, only the wallets on the list, each for an equal share. ### Can I cancel the vesting or get the tokens back? No. It is irreversible. ### Can I give different amounts to each receiver? No. The split is equal for everyone. ### Can I claim before the final date? Yes. As soon as a tranche unlocks, you can claim what is unlocked. ### How many vestings can I have for the same token? One per wallet and token. ### What does the beneficiary see? The unlocked amount, what was already withdrawn, what can be withdrawn and the next unlock date. ## Related * [Token Manager on Solana](/products/tools/solana/token-tools/token-manager.md): manage authorities and metadata of your token. * [Liquidity Pool on Solana](/products/tools/solana/token-tools/liquidity-pool.md): create the pool for your token's [liquidity](https://smithii.io/en/dictionary/liquidity/). * Market Maker: * [Presale, Launches List and Claim Site](/products/tools/solana/token-tools/token-launchpad.md) * Blog: [Lock Solana Token (SPL or LP Tokens)](https://smithii.io/en/lock-solana-token-spl-or-lp/) * Blog: [Design Tokenomics: CSV CALCULATOR](https://smithii.io/en/how-to-make-tokenomics/)