> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bags.fm/llms.txt
> Use this file to discover all available pages before exploring further.
# Robinhood Chain Overview
> How the Bags protocol works on Robinhood Chain: token lifecycle, fees, chain facts, and the full contract address book for third-party integrators.
Bags is deployed on **Robinhood Chain** as a set of public, permissionless smart contracts. Unlike the Solana integration (which is driven by the Bags REST API and SDK), the Robinhood Chain integration is **fully on-chain**: you launch, trade, and claim fees by calling the contracts directly with a standard EVM library such as [viem](https://viem.sh) or [ethers](https://docs.ethers.org).
These guides show third-party developers how to integrate launching and trading against those contracts. No API key is required to interact with the chain.
"Robinhood" here means **Robinhood Chain**, an EVM Layer 2 (Arbitrum Orbit) with chain ID `4663` and ETH as the native gas token. It is a separate chain from Solana and from BNB Chain.
## What you can do
* **Launch a token** through the `BagsFactory` (with an optional atomic initial buy). See [Launch a Token](/robinhood/launch-token).
* **Trade** a token against its bonding curve before graduation, and against a Uniswap v4 pool after graduation. See [Trade Tokens](/robinhood/trade-tokens).
* **Read state and discover tokens** through `BagsLens` and the factory registry. See [Read State & Discover Tokens](/robinhood/read-state).
* **Claim creator fees** from a token's `BagsFeeShare`. See [Claim Creator Fees](/robinhood/claim-fees).
Start with the [Environment Setup](/robinhood/setup) guide to configure your clients and ABIs.
## Token lifecycle
Every Bags token moves through two trading phases. It is created on a **bonding curve**; once enough ETH has been raised it **graduates** (migrates) into a Uniswap v4 pool with permanently locked liquidity.
```mermaid theme={null}
flowchart LR
create["factory.create / createAndBuy"] --> curve["Bonding curve phase (buy / sell vs BagsBondingCurve)"]
curve -->|"realQuoteReserves >= thresholdQuote"| migrate["Graduation (Migrated event)"]
migrate --> pool["Uniswap v4 pool (swap via modified UniversalRouter)"]
curve -. "1% creator fee" .-> feeshare["BagsFeeShare.claim"]
pool -. "1% creator fee" .-> feeshare
```
1. **Creation** — `BagsFactory.create` (or `createAndBuy`) deploys a per-token `BagsToken`, `BagsBondingCurve`, and `BagsFeeShare`, mints the fixed supply to the curve, and registers the token.
2. **Bonding curve** — trades run against the token's `BagsBondingCurve` using a virtual `x * y = k` AMM. Buys send native ETH; sells return native ETH.
3. **Graduation** — when the curve's real ETH reserves reach `thresholdQuote`, the next buy triggers migration: liquidity is deposited into a Uniswap v4 pool (with the Bags hook), the LP is locked, and the curve is paused. The curve emits a `Migrated` event.
4. **Uniswap v4** — after graduation, trades route through the Robinhood-modified UniversalRouter against the token/WETH pool.
Determine the current phase by reading the token's `migrated` flag from `BagsLens.getTokenState`, and route trades accordingly. Never assume a phase.
## Fee model
A flat **2% fee is charged on the ETH/WETH leg of every trade, in both phases**:
| Portion | Rate | Destination |
| ------------ | ------------------- | -------------------------------------------- |
| Platform | 1% (50% of the fee) | `BagsVault` (native ETH) |
| Creator side | 1% (50% of the fee) | The token's `BagsFeeShare` (accrues in WETH) |
* On **buys**, the fee is taken from the ETH input before it enters the curve/pool.
* On **sells**, the fee is taken from the ETH output.
* The creator side is split among the token's fee claimers (and an optional partner) by the basis points set at launch. Claim it with [`BagsFeeShare.claim`](/robinhood/claim-fees).
There is also a one-time **launch fee** (`creationFee`, currently 0 ETH) paid to the vault when a token is created.
`factory.creationFee()` and `factory.graduationThreshold()` are owner-settable globals on the factory and can change. Each curve also exposes its own `thresholdQuote()` — the per-curve reflection of the graduation target. Always read these live from the contracts before rendering or signing — never hardcode.
## Chain facts
| Fact | Value |
| --------------------- | ----------------------------------------------------------------------------------- |
| Network | Robinhood Chain (Arbitrum Orbit L2) |
| Chain ID | `4663` (`0x1237`) |
| Native currency | ETH (18 decimals) |
| RPC (public) | `https://rpc.mainnet.chain.robinhood.com` (rate-limited) |
| Explorer | [robinhoodchain.blockscout.com](https://robinhoodchain.blockscout.com) (Blockscout) |
| Block time | \~100 ms, first-come-first-served sequencer |
| Protocol deploy block | `6191492` (lower bound for any log scan) |
Because the sequencer is first-come-first-served and blocks are \~100 ms:
* Use **timestamps**, not block numbers, for transaction deadlines.
* The public RPC is rate-limited — batch reads with viem multicall (see [Setup](/robinhood/setup)).
* Priority fees buy nothing; gas is negligible.
## Contract address book
These are the protocol singletons and shared infrastructure on Robinhood Chain mainnet.
| Contract | Address | Role |
| --------------- | -------------------------------------------- | ---------------------------------------------------------- |
| `BagsFactory` | `0x46aD6f53A3C26C8027826e2104cF0595b7b24D40` | Launch entry point + on-chain registry |
| `BagsLens` | `0xcF8DA63Dd1cb58daDd2c1B350ac756ffA43EF2d4` | Batched read aggregator (state, claimable) |
| `BagsV4Hook` | `0x208378dDc05eD5De1833624a30EB9C1d26f86EcC` | Singleton Uniswap v4 hook; takes the 2% post-migration fee |
| `BagsVault` | `0x26e421917aeA64B615A3127A2BA3AC3051C3ab80` | Platform treasury (native ETH) |
| UniversalRouter | `0x8876789976dEcBfCbBbe364623C63652db8C0904` | **Robinhood-modified fork** — post-migration swaps |
| V4Quoter | `0x8Dc178eFB8111BB0973Dd9d722ebeFF267c98F94` | Off-chain quotes for pool swaps |
| StateView | `0xF3334192D15450CdD385c8B70e03f9A6bD9E673b` | Pool state reads (`getSlot0`, `getLiquidity`) |
| PoolManager | `0x8366a39CC670B4001A1121B8F6A443A643e40951` | Uniswap v4 singleton (`Swap` logs) |
| Permit2 | `0x000000000022D473030F116dDEE9F6B43aC78BA3` | Canonical Permit2 (router spending route) |
| WETH | `0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73` | aeWETH proxy (WETH9-compatible interface) |
| Multicall3 | `0xcA11bde05977b3631167028862bE2a173976CA11` | Canonical multicall |
The UniversalRouter above is a **modified fork**. Its v4 swap struct carries an extra `minHopPriceX36` field, so stock Uniswap SDK calldata will revert. Two other router look-alikes exist on this chain — only this address is correct. See [Trade Tokens](/robinhood/trade-tokens) for the exact encoding.
### Per-token contracts
`BagsToken`, `BagsBondingCurve`, and `BagsFeeShare` are deployed **per launch** as [EIP-1167 minimal proxy clones](https://eips.ethereum.org/EIPS/eip-1167) with no salt, so their addresses are **not predictable** before launch.
Always resolve them from:
* The `TokenCreated` event in the launch receipt (returns `token`, `curve`, `feeShare`, `poolId`), or
* The factory registry: `factory.curveForToken(token)` and `factory.feeShareForToken(token)`, or
* `BagsLens.getTokenState(token)` (returns `curve`, `feeShare`, `poolId`, and more).
Never hardcode per-token addresses.
## Token supply
Every Bags token has a fixed supply of **1,000,000,000 (1e9) tokens**, each with 18 decimals (`1_000_000_000 * 1e18` base units). Fully diluted valuation (FDV) equals the spot price in ETH per token multiplied by `1e9`.
## Next steps
Configure your viem clients and ABIs for Robinhood Chain.
Create a token through the BagsFactory.
Buy and sell across the bonding curve and Uniswap v4.
Functions, events, errors, and ABIs.