# District - Full Documentation

> The Launchpad for Builders

District is a token launchpad built on Base (Ethereum L2) that enables creators, builders, and communities to launch their own tokens, raise funds through decentralized fundraising, and trade on-chain. District supports both traditional fundraising launches and instant token launches with automated liquidity provisioning via Uniswap v4.

## Platform Overview

District provides an end-to-end platform for token creation and community building on Base. Users can create a project, configure tokenomics, run a fundraising campaign, and graduate to a tradeable token with liquidity — all through a single interface.

## How It Works

### Token Launch (Fundraising)
1. A creator configures their token: name, symbol, supply allocation, fundraising goal, and duration
2. Community members contribute ETH during the fundraising period
3. If the fundraising goal is met, the token launches with automated liquidity on Uniswap
4. Contributors receive tokens proportional to their contribution
5. If the goal is not met, contributors can reclaim their ETH

### Instant Launch
1. A creator configures their token and skips the fundraising step entirely
2. The token is immediately deployed with liquidity on a Uniswap v4 pool
3. Trading begins right away

### Trading
- District integrates with 0x for aggregated swap routing across Base DEX liquidity
- Users can trade any launched District token or discovered external token
- Real-time price quotes with permit2 gasless approvals

## Key Concepts

### Projects (DAOs)
Each launched token on District is called a "project" (internally referred to as a DAO). A project includes:
- An ERC-20 token deployed on Base
- A project page with description, logo, and social links
- Price charts and market data (market cap, volume, price change)
- Member/holder tracking
- Governance proposals
- Analytics dashboard

### External Tokens
District also discovers and tracks tokens launched on other Base launchpads. These external tokens appear alongside District-native projects in the unified token list, allowing users to discover trending tokens across the Base ecosystem.

### Fundraising Status
Projects go through the following lifecycle:
- **ACTIVE**: Fundraising is in progress, accepting contributions
- **SUCCESS**: Fundraising goal was met, token is live and tradeable
- **FAILED**: Fundraising did not meet its goal, contributors can reclaim funds

Instant launch projects skip directly to SUCCESS status.

## URL Structure

- `https://www.district.xyz` - Homepage with featured projects and token lists
- `https://www.district.xyz/projects` - Browse all launched projects and external tokens
- `https://www.district.xyz/t/{slug}` - Individual project page (trading, analytics, governance)
- `https://www.district.xyz/t/{slug}/fundraise` - Project fundraising page (if active)
- `https://www.district.xyz/new` - Launch a new token
- `https://www.district.xyz/upcoming` - Upcoming projects not yet launched
- `https://www.district.xyz/referrals` - Referral program
- `https://www.district.xyz/builder-fund` - Builder fund program
- `https://www.district.xyz/agentic` - Agentic features

## Technical Details

- **Blockchain**: Base (Ethereum L2, Chain ID: 8453)
- **Smart Contracts**: Custom fundraising contracts + Uniswap v4 pool integration
- **Swap Routing**: 0x Swap API v2 with Permit2 gasless approvals
- **Authentication**: Privy (Sign In With Ethereum)
- **Data**: Real-time on-chain data with snapshot-based price history

## Contact

- Website: https://www.district.xyz
- Twitter/X: https://x.com/districtxyz