> For the complete documentation index, see [llms.txt](https://stonkmarket.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stonkmarket.gitbook.io/docs/reference/protocol-configuration.md).

# Protocol Configuration

The protocol has two levels of configuration: **factory-level** (mutable, affects future launches) and **token-level** (immutable, set at launch).

Configuration is per-deployment: Base and [Robinhood Chain](/docs/reference/robinhood-chain.md) each have their own factory, set independently. The global values below are the same on both; the per-asset values differ, and both tables are given.

## Factory-Level Parameters

Controlled by the factory owner (a Ledger hardware wallet) and only affecting tokens launched **after** the change.

**Global** (apply to every backing asset):

| Parameter                  | Description                              | Value            |
| -------------------------- | ---------------------------------------- | ---------------- |
| Trade fee                  | Withheld from the asset leg of each swap | 1% (10,000 pips) |
| `maxWalletBasisPoints`     | Max wallet as % of supply                | 500 (5%)         |
| `devAllocationBasisPoints` | Dev mint as % of supply                  | 50 (0.5%)        |
| `treasury`                 | Protocol fee recipient                   | `0x7233…3b02`    |
| `paused`                   | Emergency stop for new launches          | `false`          |

The 1% trade fee is charged by the [StonkHook](/docs/smart-contracts/stonk-hook.md), not by the pool: the native Uniswap LP fee is forced to **zero** so the hook is the only fee charger.

**Fee split** — how the 1% is divided:

| Share             | Recipient                 | Referred | Unreferred |
| ----------------- | ------------------------- | -------- | ---------- |
| Creator           | Token deployer            | 10%      | 10%        |
| Platform referrer | Listed referring platform | 10%      | —          |
| Treasury          | Protocol                  | 80%      | 90%        |

An unreferred launch folds the platform 10% into the treasury (effective **10 / 90**). Fees accrue in the [StonkFeeLocker](/docs/smart-contracts/stonk-fee-locker.md).

**Per-asset** (one config per backing asset), on **Base**:

| Parameter              | Description                           | WETH     | USDC            |
| ---------------------- | ------------------------------------- | -------- | --------------- |
| Launch fee             | Deploy fee in the backing asset       | 0.1 WETH | 150 USDC        |
| Virtual asset reserves | Starting asset reserves for the curve | 2 WETH   | \~3,285.71 USDC |
| Discovery raise        | Asset depth of the curve band         | 7 WETH   | 11,500 USDC     |
| Max launch buy         | Cap on the deployer's launch buy      | 0.1 WETH | 160 USDC        |

And on **Robinhood Chain**, where the dollar asset is USDG and **both launch fees are zero**:

| Parameter              | Description                           | WETH     | USDG            |
| ---------------------- | ------------------------------------- | -------- | --------------- |
| Launch fee             | Deploy fee in the backing asset       | **0**    | **0**           |
| Virtual asset reserves | Starting asset reserves for the curve | 2 WETH   | \~3,285.71 USDG |
| Discovery raise        | Asset depth of the curve band         | 7 WETH   | 11,500 USDG     |
| Max launch buy         | Cap on the deployer's launch buy      | 0.1 WETH | 160 USDG        |

USDG is a 6-decimal dollar stablecoin like USDC, so it reuses the USDC curve numbers unchanged.

The launch fee is payable in ETH or WETH for a WETH launch, and in the dollar asset for a dollar-asset launch.

## Token-Level Parameters (Immutable)

Set once at launch and never changed. There is no owner and no upgrade path.

| Parameter       | Source            | Description                                                        |
| --------------- | ----------------- | ------------------------------------------------------------------ |
| `name`          | Deployer          | Token name                                                         |
| `symbol`        | Deployer          | Token symbol                                                       |
| `totalSupply`   | Fixed             | Always 1,000,000,000; minting is permanently disabled after launch |
| Trade fee       | Factory snapshot  | 1%, split per the table above                                      |
| Max wallet      | Factory snapshot  | 5% of the original supply                                          |
| `launchTime`    | Calculated        | Next NYSE market open after deploy — trading is locked until then  |
| Deployer        | `msg.sender`      | Address that called `deployToken`                                  |
| Backing asset   | Deployer choice   | WETH or USDC on Base; WETH or USDG on Robinhood Chain              |
| Uniswap v4 pool | Created at launch | The pool (and its `PoolKey`) this token trades in                  |
| Hook            | Fixed             | The StonkHook bound to the pool                                    |
| Oracle          | Factory           | MarketHoursOracle address                                          |

## Curve / Pool Constants

Identical for all tokens:

| Constant               | Value                           |
| ---------------------- | ------------------------------- |
| Total supply           | 1,000,000,000                   |
| Virtual token reserves | 700,000,000 (70% of supply)     |
| Tick spacing           | 60                              |
| Market-band ceiling    | 1000x                           |
| Native LP fee          | 0 (the hook charges the 1% fee) |

The virtual asset reserves and discovery raise come from each backing asset's config (see the per-asset table). The curve is installed as a single Uniswap v4 concentrated-liquidity position at launch — there is no graduation threshold, because there is no graduation (see [No Graduation](/docs/concepts/graduation.md)).

## Immutability Guarantee

```
Factory changes the trade fee for future launches

Token A (launched before change): its snapshotted fee forever
Token B (launched after change):  the new fee forever
```

Protocol changes never affect existing tokens. Each token is a standalone, autonomous contract.


---

# 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://stonkmarket.gitbook.io/docs/reference/protocol-configuration.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.
