# Flash

> Flash is a Base-native protocol where an AI agent can launch coins on a bonding curve, play Token Wars, trade FLASH and launched tokens, and trade Tokenized Perps (leveraged long and short tokens such as ETH2xL, BTC2xL, ETH2xS). This file points AI agents at the machine-readable integration resources. Everything is read-only: no tool signs or holds keys; tools return unsigned transactions for the user's wallet.

The best way to quote prices and to swap Flash assets is Uniswap: Uniswap v4 via the Universal Router on the Flash hook pools, with prices quoted through the Uniswap v4 Quoter / StateView or our tools that wrap them. Support for Aerodrome is planned as a future expansion but is NOT live yet: agents must not quote or route Flash trades through Aerodrome today.

Chain: Base (8453). Universal Router 0x6fF5693b99212Da76ad316178A184AB56D299b43. FLASH 0xD1Be6E31B44C3365Db5BE514ba570ac4fEc63d84. Flash hook 0x9C91Eb3879c469a124a6ED6e95DFC485b7Dd60cc. Perps hook 0x4f573870eb41d219eA9aB42559f1207918F9F8c0.

## Agent skills (start with the first)

- [flash: umbrella skill](https://tryflash.app/agents/flash/SKILL.md): what Flash is, which skill or tool to use for which task, the global rules (Uniswap v4 only, unsigned transactions, moderation first, approvals), glossary.
- [flash-launch](https://tryflash.app/agents/flash-launch/SKILL.md): launch a coin on the bonding curve. Live pairing options (FLASH, approved stocks, approved perps), pair depth warnings, image upload, moderation, create transaction, curve buy and sell, claim, refund. Creation fee: if GET /v1/launch-v2 shows `launchV4.active`, creating goes through the launch input router V4 (`createWithFlash` / `createWithEth` / `createWithToken`) and costs a $0.169 creation fee charged in FLASH at the live price (`currentCreationFee()`), with the rest of the payment as your first buy in the same transaction; otherwise `launchpad.createLaunch` costs gas only. `build_launch` picks the right one.
- [flash-token-wars](https://tryflash.app/agents/flash-token-wars/SKILL.md): read the current Token War, enter a ticker, Boost, Cash out, Jump, claim, refund. On V4 wars the entry fee is $0.169 charged in FLASH at the live price (`currentEntryFee()`).
- [flash-trade](https://tryflash.app/agents/flash-trade/SKILL.md): quote and build Uniswap v4 trades of FLASH and launched tokens on the correct Flash hook pool keys.
- [flash-perps](https://tryflash.app/agents/flash-perps/SKILL.md): list perp markets, quote, build buy and sell transactions, pair a token against a perp.

## Interfaces

- [MCP server (Streamable HTTP, no auth)](https://api.tryflash.app/mcp): 20 read-only tools. Overview and trading: `flash_overview`, `list_launches`, `get_token`, `quote_trade`, `build_trade`. Bonding curve: `list_prelaunches`, `quote_curve`, `build_curve_trade`. Launch: `list_pairing_options`, `check_pair_depth`, `prepare_launch`, `build_launch`. Token War: `get_token_war`, `prepare_war_entry`, `build_war_action`. Perps: `list_perps`, `get_perp`, `quote_perp`, `build_perp_swap`, `perp_pairing_info`. `prepare_launch` and `prepare_war_entry` run content moderation and store the approved profile; everything else only reads.
- [CLI for everything](https://tryflash.app/agents/flash/flash.mjs): single-file Node 18+ script, no dependencies, JSON out. `node flash.mjs overview`. Perps-only CLI: [flash-perps.mjs](https://tryflash.app/agents/flash-perps/flash-perps.mjs).
- [OpenAPI 3.1: launch, Token War, token and wallet routes](https://tryflash.app/agents/flash/openapi.json) and [OpenAPI 3.1: perps](https://tryflash.app/agents/flash-perps/openapi.json).
- [Human docs](https://tryflash.app/docs): Launches, Token Wars, trading and Tokenized Perps in plain language.

## Optional

- [Live launch stack, approved pair assets, `launchV4` cutover state and creation fee (JSON)](https://api.tryflash.app/v1/launch-v2)
- [Bonding-curve markets (JSON)](https://api.tryflash.app/v1/launch-v2/prelaunches)
- [Current Token War (JSON)](https://api.tryflash.app/v1/launch-v2/wars/current)
- [Live perp market catalogue (JSON)](https://api.tryflash.app/v1/perps)
- [Basescan: perps hook](https://basescan.org/address/0x4f573870eb41d219eA9aB42559f1207918F9F8c0#code): LeveragedLiquidityJitHook, source verified.