> For the complete documentation index, see [llms.txt](https://docs.novamp.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.novamp.io/creators/supply-and-allocation.md).

# Supply, Allocation & Initial Buy

Decide how many tokens exist, how many you keep, and whether you buy in atomically at launch.

{% hint style="info" %}
Total supply and the no-mint guarantee are **permanent**. Allocation size, lock duration, and the initial buy are set at launch and cannot be changed afterward.
{% endhint %}

## Overview

Every Novamp token is a **fixed-supply ERC-20**. The full supply is minted once at creation — there is **no mint function and no owner**, so it can never inflate. Three choices shape your token's distribution:

1. **Total supply** — how many tokens exist.
2. **Creator allocation** — the slice sent to you at launch (0–10%).
3. **Initial buy** — an optional atomic purchase in the launch transaction.

Everything not allocated or bought is seeded into the pool as tradable liquidity.

## How it works

The supply value is stored on-chain as `supply × 10¹⁸` (all tokens use 18 decimals). Your allocation and initial buy are carved from that supply inside the same `launch()` transaction, so distribution is deterministic and public from block zero.

## How to use it

### Total supply

Pick a preset or set a custom whole number:

| Preset   | Supply                                     |
| -------- | ------------------------------------------ |
| Small    | **1,000,000** (1M)                         |
| Standard | **100,000,000** (100M)                     |
| Large    | **1,000,000,000** (1B)                     |
| Custom   | any whole number within the factory limits |

{% hint style="info" %}
Opening price is normalized to a target **fully-diluted valuation (FDV)**, not a fixed per-token price, so your opening market cap stays consistent no matter which supply you choose.
{% endhint %}

### Creator allocation

Reserve **0–10% of supply** for yourself at launch. A small (or zero) allocation is a strong trust signal — it's shown publicly on the token page.

If you take an allocation, choose a lock:

| Lock         | Behavior                                          |
| ------------ | ------------------------------------------------- |
| **Unlocked** | Transferable immediately.                         |
| **7 days**   | Held in `CreatorVesting`, claimable after 7 days. |
| **30 days**  | Claimable after 30 days.                          |
| **90 days**  | Claimable after 90 days.                          |

Locked allocations are custodied by the on-chain `CreatorVesting` contract and released when the lock expires.

### Initial buy (optional)

Buy **up to 10% of supply** atomically in the launch transaction. Because it runs through the launcher, your buy **bypasses the anti-snipe window** while open-market snipers stay capped — see [Anti-sniper protections](/creators/anti-snipe-and-protection.md). Any excess beyond the 10% cap is refunded.

## Important details

| Property               | Detail                                           |
| ---------------------- | ------------------------------------------------ |
| Supply                 | Fixed forever; no mint function, no owner        |
| Decimals               | 18 (stored as `supply × 10¹⁸`)                   |
| Creator allocation     | 0–10% of supply                                  |
| Allocation lock        | Unlocked / 7 / 30 / 90 days via `CreatorVesting` |
| Initial buy cap        | 10% of supply; excess refunded                   |
| Exempt from anti-snipe | Allocation, vesting tokens, and the initial buy  |

## What happens next?

* Your allocation percentage and lock are disclosed on the token page.
* Locked tokens sit in `CreatorVesting` until they unlock, then you claim them.
* Because allocation and the initial buy originate from the launch, they **never trip your own anti-snipe caps**.

## Troubleshooting

| Symptom                                       | Fix                                                      |
| --------------------------------------------- | -------------------------------------------------------- |
| "Total supply is outside the allowed range"   | Choose a preset or a value within the factory's min/max. |
| "Creator allocation is above the 10% maximum" | Lower the allocation to 10% or less.                     |
| Initial buy smaller than expected             | It was capped at 10% of supply; the excess was refunded. |

## Continue exploring

* [🚀 Launch a Token](/creators/launching-a-token.md)
* [💸 Token Taxes](/creators/taxes.md)
* [🛡️ Anti-Sniper Protections](/creators/anti-snipe-and-protection.md)
* [💰 Fee Model](/protocol/fee-model.md)


---

# 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.novamp.io/creators/supply-and-allocation.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.