> 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/readme.md).

# Overview

A fair-launch token launchpad that enforces NYSE market hours on-chain, deployed on **Base L2** and **Robinhood Chain**. Every token trades in its own **Uniswap v4** pool — live from the first bell, with a bonding-curve price and permanently locked liquidity.

## How It Works

1. **Deploy** a token through the Factory (with an optional atomic launch buy). The launch seeds a Uniswap v4 pool with the bonding curve as a single concentrated-liquidity position.
2. **Wait for the bell** — trading is locked until the next NYSE market open (9:30 AM ET).
3. **Trade** by swapping in the v4 pool during market hours. There is no graduation; the pool is real from launch.

## Core Components

| Contract                                                          | Purpose                                                                  |
| ----------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [StonkTokenFactory](/docs/smart-contracts/stonk-token-factory.md) | Launches tokens (EIP-1167 clones) and seeds each one's Uniswap v4 pool   |
| [StonkToken](/docs/smart-contracts/stonk-token.md)                | Fixed-supply ERC-20 with a 5% wallet cap and an NYSE transfer gate       |
| [StonkHook](/docs/smart-contracts/stonk-hook.md)                  | Uniswap v4 hook: market hours, the 1% asset-leg fee, permanent liquidity |
| [StonkFeeLocker](/docs/smart-contracts/stonk-fee-locker.md)       | Holds accrued trade fees; beneficiaries claim from here                  |
| [MarketHoursOracle](/docs/smart-contracts/market-hours-oracle.md) | NYSE hours, holidays, and DST (reused from v1)                           |

## Key Properties

* **Gas-free on the website** — launches and trades on stonk.market are sponsored by a Base paymaster; you pay no gas (direct contract calls off-site pay normal network gas).
* **Immutable tokens** — no owner, not upgradeable, fixed supply after launch.
* **No grace period** — trading locked until the next market open.
* **Atomic launch buy** — no front-running at launch.
* **Permanent liquidity** — the hook reverts every removal; only the factory can add liquidity, once.
* **Fee only on the asset leg** — 1% in the backing asset, never in the launched token.
* **Name/symbol registry** — prevents impersonation.

## Networks

Two independent deployments of the same contracts, on Uniswap v4:

| Network             | Chain ID | Backing assets   | Launch fee          |
| ------------------- | -------- | ---------------- | ------------------- |
| **Base** L2         | 8453     | ETH / WETH, USDC | 0.1 WETH / 150 USDC |
| **Robinhood Chain** | 4663     | ETH / WETH, USDG | free                |

The two share no addresses and are administered independently. See [Deployments](/docs/reference/deployments.md) for the contract addresses, and [Robinhood Chain](/docs/reference/robinhood-chain.md) for what is specific to that chain.


---

# 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/readme.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.