# foci

> A permissionless bonding-curve launchpad on Arc. Tokens trade on a curve until a fixed
> amount is raised, then graduate into a Uniswap V4 pool with permanently locked liquidity.

10 contracts · 202 functions · 70 events · 140 errors.
The complete documentation as one document: https://foci.family/llms-full.txt

## Get started

- [Overview](https://foci.family/documentation.md): What foci is, and how a token moves from a bonding curve to a Uniswap V4 pool.
- [Quickstart](https://foci.family/documentation/quickstart.md): Launch a token and buy it, in two transactions, with viem.
- [Addresses](https://foci.family/documentation/addresses.md): Every deployed contract on Arc testnet, plus the Uniswap and Permit2 addresses you need.

## Guides

- [Lifecycle](https://foci.family/documentation/lifecycle.md): Launch, curve trading, the graduation threshold, the sweep, and the pool seed.
- [Launching a token](https://foci.family/documentation/launching.md): launchToken versus launchAndBuy, TokenParams field by field, and the economics pin.
- [Trading the curve](https://foci.family/documentation/trading.md): Buying and selling before graduation, and why the two slippage bounds differ.
- [Graduation](https://foci.family/documentation/graduation.md): What happens at the threshold, and the gas trap that leaves a launch half-migrated.
- [Trading the pool](https://foci.family/documentation/pool.md): Swapping a graduated token through UniversalRouter, and the two-step Permit2 approval.
- [Approvals](https://foci.family/documentation/approvals.md): Which contract pulls your funds for every entrypoint. Read this before writing any code.
- [Decimals](https://foci.family/documentation/decimals.md): A 6-decimal quote asset against an 18-decimal memecoin, and where that goes wrong.
- [Fees and referrals](https://foci.family/documentation/fees.md): How fees are split, how referrals bind, and how anyone claims what they are owed.

## Reference

- [Contracts](https://foci.family/documentation/contracts.md): Every deployed contract: functions, events and errors.
- [Errors](https://foci.family/documentation/errors.md): Every custom error by selector — what to look up when a transaction reverts.
- [Events](https://foci.family/documentation/events.md): Every event with its topic0, for indexers.