Docs

nonce.fun product map.

A compact guide for launching, discovering, and trading Ethereum meme tokens through nonce.fun.

Protocol

Open-source contracts in the Official V1 pipeline.

nonce.fun Official V1 contracts (factory, token deployer, token, pool hook, liquidity locker) are open-source in this repository under `contracts/src`.

Trading and pool lifecycle are built on Uniswap V4 core/periphery contracts and interfaces.

Route execution uses Universal Router and Permit2 integration for token approvals and swap routing.

All launch and trade state is anchored to Ethereum mainnet transactions and events.

Stack

Core technologies used by nonce.fun.

Solidity + Foundry for protocol contracts, tests, and deployment scripts.

Next.js + React + TypeScript for the web terminal interface.

Wagmi + Ethers for wallet connectivity and transaction execution.

Postgres + custom indexer API for launch, pool, and trade read models.

Supabase Realtime as an event-triggered refresh layer for discovery views.

IPFS upload flow for token metadata and media references.

Create

Launch a token.

Open Create Token.

Enter name, ticker, description, and optional links.

Upload a square logo. The interface uploads image and metadata through the server-side IPFS route.

Keep the default first buy or enter a higher amount.

Review the wallet prompt and confirm only if the transaction details match.

Trade

Open a token terminal.

Open Trade.

Search by token name, ticker, creator, or token address.

Select a token card to open the chart and execution terminal.

Review price, liquidity, route, quote age, wallet prompts, and gas before submitting.

Profile

Review wallet-linked activity.

Profile is intended to show the connected wallet's visible holdings, launches, and trading activity once market and wallet data are available.

Data

Understand data and execution responsibilities.

Onchain truth: launch, pool, and swap states are sourced from Ethereum logs and transactions.

Indexer truth: API payloads are projection models built from canonical onchain events.

Realtime layer: Supabase events trigger UI refresh; API remains the primary read source.

Chart source: token chart embed is rendered from Dexscreener.

Creator media: logos and metadata resolve from creator uploads and IPFS gateways.

Safety

Confirm everything in wallet.

nonce.fun prepares transactions, but the wallet confirmation is the final source of truth. Always review destination, value, token, approval, slippage, and gas before signing.