> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hoodstar.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Developer Overview

> Build on hoodstar.fun — chain details, contract architecture, addresses, and integration paths.

Everything on hoodstar.fun is on-chain and permissionlessly integrable. You can build trading bots, indexers, dashboards, or entire alternative frontends — no API key required.

## Two ways to integrate

<CardGroup cols={2}>
  <Card title="TypeScript SDK" icon="js" href="/developers/sdk">
    `@hoodstar/sdk` — typed reads, writes, exact client-side quote math, and event streaming on top of viem. The fastest way to build.
  </Card>

  <Card title="Raw contracts" icon="file-contract" href="/developers/contracts">
    Call the launchpad directly from Solidity, Foundry scripts, or any web3 library. Full function and error reference.
  </Card>
</CardGroup>

## Robinhood Chain

|           | Mainnet                                                                | Testnet                                                                                |
| --------- | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| Chain ID  | `4663`                                                                 | `46630`                                                                                |
| RPC       | `https://rpc.mainnet.chain.robinhood.com`                              | `https://rpc.testnet.chain.robinhood.com`                                              |
| Explorer  | [robinhoodchain.blockscout.com](https://robinhoodchain.blockscout.com) | [robinhoodchain-testnet.blockscout.com](https://robinhoodchain-testnet.blockscout.com) |
| Gas token | ETH (18 decimals)                                                      | Testnet ETH ([faucet](https://faucet.testnet.chain.robinhood.com))                     |

Robinhood Chain is an **Arbitrum Orbit L2**. Two practical consequences:

* Blocks are fast and reorgs are effectively nonexistent — confirmation counts of 0–1 are fine.
* The public RPC is **HTTP only** (no `eth_subscribe` websocket). The SDK's event layer is built around chunked `eth_getLogs` polling for exactly this reason; for websockets you need a paid RPC provider.

## Architecture

Three contracts run the whole protocol:

```mermaid theme={null}
flowchart LR
    Creator -- "createToken()" --> LP[HoodLaunchpad]
    Trader -- "buy / sell" --> LP
    LP -- deploys --> T["HoodToken (ERC-20 + permit)"]
    LP -- "migrate() after graduation" --> UNI["Uniswap v3 pool (1% tier)"]
    LP -- "LP position NFT" --> FL[FeeLocker]
    FL -- "collectFees(): 50/50" --> Creator2[Creator] & Treasury
```

| Contract          | Role                                                                                                                       |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **HoodLaunchpad** | Singleton: token factory, all bonding curves, fee ledger, and Uniswap migrator in one contract.                            |
| **HoodToken**     | Per-launch ERC-20 (+ EIP-2612). Fixed 1B supply, no admin functions, immutable `metadataURI`.                              |
| **FeeLocker**     | Immutable, ownerless vault holding every graduated LP position forever; splits collected swap fees 50/50 creator/treasury. |

Only the launchpad address is needed to integrate — the FeeLocker, treasury, WETH, and Uniswap position manager are all discoverable from it on-chain.

## Contract addresses

<Warning>
  The hoodstar.fun contracts are **not yet deployed** — launchpad addresses will be published here at launch. Until then, develop against a local fork or the testnet once live, or run the contracts yourself with the deploy scripts.
</Warning>

| Contract      | Mainnet (4663)    |
| ------------- | ----------------- |
| HoodLaunchpad | *To be announced* |
| FeeLocker     | *To be announced* |

Canonical Robinhood Chain infrastructure the protocol builds on:

| Contract                              | Address                                      |
| ------------------------------------- | -------------------------------------------- |
| Uniswap v3 Factory                    | `0x1f7d7550B1b028f7571E69A784071F0205FD2EfA` |
| Uniswap v3 NonfungiblePositionManager | `0x73991a25C818Bf1f1128dEAaB1492D45638DE0D3` |
| Uniswap SwapRouter02                  | `0xCaf681a66D020601342297493863E78C959E5cb2` |
| WETH                                  | `0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73` |

## Key protocol constants

```text theme={null}
TOTAL_SUPPLY     = 1_000_000_000 × 1e18   // per token
SALE_SUPPLY      =   793_100_000 × 1e18   // sold on the curve
POOL_SUPPLY      =   206_900_000 × 1e18   // reserved for Uniswap LP
VIRTUAL_TOKEN_0  = 1_073_000_000 × 1e18   // initial virtual token reserve
virtualEth0      = 1.6 ETH                // initial virtual ETH reserve (deploy parameter)
Trade fee        = 100 bps (70 protocol / 30 creator), hard cap 500 bps
Uniswap pool     = 1% fee tier (10000), full-range position
```