# kiwi.rich developer integration

kiwi.rich is a USDC-priced bonding-curve token launchpad on Arc Mainnet.
Canonical onchain events are the lowest-latency source for launch, trade, and graduation discovery.
The public read API provides normalized metadata, market state, holders, and history.

## Network
- Chain: Arc Mainnet
- Chain ID: 5042
- CAIP-2: eip155:5042
- Native gas currency: USDC (18 decimals)
- System USDC ERC-20: 0x3600000000000000000000000000000000000000 (6 decimals)
- Explorer: https://arcscan.app

## Factories
- V2 primary: 0x8Ac834b6A56278f4cf4a6D2E66F332a5348e12Dc, deployment block 11202050
- V1 legacy: 0x74B79eA7C8c8621979c5aB9710f27B70aBB543E5, deployment block 11075665
- Canonical token rule: curveForToken(token) != address(0) on either factory

## Lifecycle
- Phase 0: bonding_curve. Read and trade the token's curveForToken(token) venue.
- Phase 1: permanent_pool. Read poolForToken(token), then quote and trade that pool.
- Graduation is atomic and emits LaunchGraduated(token, curve, pool).
- Both venues expose quoteBuy, quoteSell, buy, sell, and permit-enabled variants.

## Integration resources
- Developer guide: https://kiwi.rich/developers
- Launchpad manifest: https://kiwi.rich/api/v1/launchpad
- OpenAPI: https://kiwi.rich/api/v1/openapi
- ABI catalog: https://kiwi.rich/api/v1/abis
- Recent markets: https://kiwi.rich/api/v1/markets
- Token template: https://kiwi.rich/api/v1/token/{address}
- Support: help@kiwi.rich
- X: https://x.com/Kiwidotrich

## Important units
- Launch tokens: 18 decimals
- System USDC ERC-20 trade amounts: 6 decimals
- Native USDC gas balance: 18 decimals
- Contract trades send value=0; USDC moves through ERC-20 allowance or EIP-2612 permit