Integration docs

A token launches with a fixed supply of 1,000,000,000 (18 decimals) on a bonding curve paired with a quote asset. When the curve has raised its graduation threshold, the launch graduates: the raised quote and the tokens held back for it are placed as one full-range position in a Uniswap v4 pool behind our hook, and that position is locked for good. Trading happens on the curve until graduation and in the pool after it.

The contracts are Pons V2 without modification, byte-identical to the live Pons deployment on Robinhood Chain. If you already integrate Pons there, point the same code at our factory addresses. Two peripheral contracts on Arc carry a small patch for Arc's native USDC; they change no interface.

Every launch is one event on the factory, from its deploy block onward. It names the token, its bonding curve and the quote asset it pairs with; a pairToken of the zero address is native ETH, on Robinhood Chain only.

"event TokenLaunched(address indexed token, address indexed curve, address indexed deployer, address pairToken, uint256 launchConfigId, uint256 graduationThreshold)"

Read a launch's state at any time from the factory:

"function getLaunchedToken(address token) view returns ((address token, address curve, address deployer, address creatorFeeRecipient, address pairToken, uint256 graduationThreshold, uint24 poolFee, int24 tickSpacing, uint16 creatorTaxBps, bool buybackEnabled, uint8 phase, uint256 sweptQuote, uint256 sweptTokens, uint256 sweptAt, bool exists))"

The token is a plain ERC-20 with name(), symbol(), 18 decimals, and views for the logo, description and socials its creator set at launch.

Each launch has its own curve contract. Two functions do all the trading, and both return the amount received, so an eth_call of the same call is an exact quote.

"function buy(uint256 quoteIn, uint256 minTokensOut, address recipient) payable returns (uint256 tokensOut)"
"function sell(uint256 tokensIn, uint256 minQuoteOut, address recipient) returns (uint256 quoteOut)"

1. ERC-20 quote (USDG, cbBTC, TAO, a Stock Token, Arc's USDC): approve the curve for quoteIn, then call buy with no value.
2. Native ETH quote (Robinhood Chain): call buy with value equal to quoteIn.
3. Selling: approve the curve for tokensIn, then sell. The quote comes back to recipient, native or ERC-20 as the pair is.

Pricing is constant-product over virtual reserves: quoteReserve() is the real quote plus a fixed phantom amount, tokenReserve() the tokens still on the curve. With the fee and any tax taken from the input first, a buy gives tokensOut = tokenReserve × in′ / (quoteReserve + in′) where in′ = quoteIn × (10000 − feeBps − taxBps) / 10000. A sell is the same curve in reverse, with the fee and tax taken from the proceeds. A buy larger than sellableTokens() is clamped and the unspent quote refunded in the same transaction.

Views for quoting, and the events for indexing trades:

"function getReserves() view returns (uint256 quoteReserve_, uint256 tokenReserve_)"
"function quoteReserve() view returns (uint256 quoteReserve_)"
"function tokenReserve() view returns (uint256 tokenReserve_)"
"function phantomQuote() view returns (uint256)"
"function feeBps() view returns (uint256)"
"function creatorTaxBps() view returns (uint256)"
"function currentSnipeTaxBps(address recipient) view returns (uint256)"
"function sellableTokens() view returns (uint256)"
"function graduationThreshold() view returns (uint256)"
"function readyToGraduate() view returns (bool)"
"function graduated() view returns (bool)"
"event CurveBuy(address indexed buyer, address indexed recipient, uint256 quoteIn, uint256 tokensOut, uint256 fee, uint256 tax)"
"event CurveSell(address indexed seller, address indexed recipient, uint256 tokensIn, uint256 quoteOut, uint256 fee, uint256 tax)"
"event CurveBuyRefunded(address indexed buyer, uint256 refund)"
"event CurveCompleted(address recipient, uint256 quoteOut, uint256 tokenOut)"

A buy that crosses the graduation threshold graduates the launch inside the same transaction. Send it with generous gas: a bare eth_estimateGas often lands on the path where that inner graduation runs out of gas and is caught, leaving the curve readyToGraduate(). We send the estimate plus a quarter plus 450,000. If it slips through, anyone can call graduate(token) on the factory.

When the real quote reserve reaches graduationThreshold, the curve sweeps its reserves to the factory (LaunchSwept, phase 1). Then createGraduatedPool(token), callable by anyone, initialises the Uniswap v4 pool, mints the full-range position and hands it to the locker (PoolGraduated, phase 2). The position can never be withdrawn.

"event LaunchSwept(address indexed token, uint256 quoteOut, uint256 tokenOut)"
"event PoolGraduated(address indexed token, uint256 positionId, uint256 tokenAmount, uint256 pairTokenAmount)"

PoolKey {
  currency0, currency1 = the token and the quote, sorted by address (native ETH is address(0))
  fee         = getLaunchedToken(token).poolFee
  tickSpacing = getLaunchedToken(token).tickSpacing
  hooks       = the Hook address for that chain
}

Trade the pool as any v4 pool: the Universal Router's V4_SWAP with SWAP_EXACT_IN_SINGLE, SETTLE_ALL and TAKE_ALL, Permit2 for ERC-20 input, and the V4 Quoter for quotes. The hook takes its fee and the creator's tax inside the swap and emits HookFeeCollected; a swap log's amounts are gross of that, so net the fee off the unspecified side when you index pool trades.

Per-pair economics live on the factory: approvedPairTokens(address) and pairTokenEconomics(address). Native ETH's live in launch config 0, getLaunchConfig(0). A Stock Token can be paused, can block addresses and can be burned or split by its issuer; a launch paired with one inherits that. Circle can pause or blocklist USDC on Arc.

Human-readable, ready for ethers or viem's parseAbi, printed from the ABIs this site itself sends to. The full JSON ABIs are Pons V2's; ask and we'll send them.

Factory

"event TokenLaunched(address indexed token, address indexed curve, address indexed deployer, address pairToken, uint256 launchConfigId, uint256 graduationThreshold)"
"event LaunchSwept(address indexed token, uint256 quoteOut, uint256 tokenOut)"
"event PoolGraduated(address indexed token, uint256 positionId, uint256 tokenAmount, uint256 pairTokenAmount)"
"function getLaunchedToken(address token) view returns ((address token, address curve, address deployer, address creatorFeeRecipient, address pairToken, uint256 graduationThreshold, uint24 poolFee, int24 tickSpacing, uint16 creatorTaxBps, bool buybackEnabled, uint8 phase, uint256 sweptQuote, uint256 sweptTokens, uint256 sweptAt, bool exists))"
"function approvedPairTokens(address pairToken) view returns (bool approved)"
"function pairTokenEconomics(address pairToken) view returns (uint256 phantomQuote, uint256 graduationThreshold, uint8 decimals)"
"function launchEnabled() view returns (bool)"
"function launchFee() view returns (uint256)"
"function graduate(address token)"
"function createGraduatedPool(address token) returns (uint256 positionId)"

Bonding curve, one per launch

"function buy(uint256 quoteIn, uint256 minTokensOut, address recipient) payable returns (uint256 tokensOut)"
"function sell(uint256 tokensIn, uint256 minQuoteOut, address recipient) returns (uint256 quoteOut)"
"function getReserves() view returns (uint256 quoteReserve_, uint256 tokenReserve_)"
"function quoteReserve() view returns (uint256 quoteReserve_)"
"function tokenReserve() view returns (uint256 tokenReserve_)"
"function phantomQuote() view returns (uint256)"
"function feeBps() view returns (uint256)"
"function creatorTaxBps() view returns (uint256)"
"function currentSnipeTaxBps(address recipient) view returns (uint256)"
"function sellableTokens() view returns (uint256)"
"function graduationThreshold() view returns (uint256)"
"function readyToGraduate() view returns (bool)"
"function graduated() view returns (bool)"
"function pairToken() view returns (address)"
"function token() view returns (address)"
"event CurveBuy(address indexed buyer, address indexed recipient, uint256 quoteIn, uint256 tokensOut, uint256 fee, uint256 tax)"
"event CurveSell(address indexed seller, address indexed recipient, uint256 tokensIn, uint256 quoteOut, uint256 fee, uint256 tax)"
"event CurveBuyRefunded(address indexed buyer, uint256 refund)"
"event CurveCompleted(address recipient, uint256 quoteOut, uint256 tokenOut)"