Contracts

Every deployed contract: functions, events and errors.

FociV2LaunchFactory#

0xa93f9CeFD92A77e1EAffa3246B6F4DB91a5c5659

Functions an application calls#

canLaunch(address)#

0x58373f04 · view · view

Whether launcher may launch right now: true while the public gate is open, and true for whitelisted addresses while it is closed. The same predicate launchToken enforces on its caller, exposed so routers like FociV2LaunchAndBuy can hold their own callers to this single list instead of maintaining a second one.

launchEnabled is left FALSE by deployment. Always check this before showing a launch form.

Parameters

Returns

createGraduatedPool(address)#

0x2f53ef2f · nonpayable · Permissionless and retryable.

Initializes the V4 pool with the swept reserves, mints a full-range position directly to the locker, and registers the pool with the meme hook. The curve already holds the pool's quote asset, so this seeds with exactly what it swept and needs no slippage bound. Permissionless and retryable: a launch stays in Swept until a seed succeeds, so a transient failure can never strand reserves.

Seeds the V4 pool and locks the position. Like graduate this normally runs inside the crossing buy — but it costs roughly 900k gas on its own, and under EIP-150's 63/64 rule a buy sized by a naive estimateGas starves it. When that happens the curve emits AutoSeedFailed and the launch sits in phase 1 with no tradeable venue until someone calls this. Run a keeper on that event. Send an explicit gas limit; estimation is reliable here because there is no try/catch to hide the cost.

Parameters

Returns

Reverts

• WrongGraduationPhase — not in the Swept phase
• GraduationSeedNotViable

getLaunchConfig(uint256)#

0x1cad862d · view · view

Returns one token launch configuration.

Parameters

Returns

getLaunchedToken(address)#

0x3cf28b5a · view · view

Returns the immutable record for a token created by this factory.

Returns a ZEROED struct for an unknown token rather than reverting — check .exists. This is also where you get the per-launch curve address, since curves have no fixed deployment.

Parameters

Returns

graduate(address)#

0xff6d8d05 · nonpayable · Permissionless — anyone may call it.

Sweeps the curve's remaining quote and token reserves into this factory and halts curve trading. Purely internal to the curve's own balances, so it is safe for the curve to call this automatically the instant a buy crosses the graduation threshold.

Normally runs automatically inside the buy that crosses the threshold. Call it manually only when that inner attempt failed, which the curve reports by emitting AutoGraduationFailed.

Parameters

Reverts

• WrongGraduationPhase — already swept
• NotReadyToGraduate — the curve is not finished

launchFee()#

0xcf3cf573 · view · view

Returns

launchFeeToken()#

0xbd03b5fc · view · view

A flat charge on creating a launch, in launchFeeToken. Spam friction rather than revenue. Zero disables it outright: the payment path is skipped entirely, so nothing is pulled and no approval is needed while it is off. ERC-20 rather than native even where a chain's native asset is the same asset: the atomic launch router funds itself through transferFrom, and a native fee would make one call carry both an approval and attached value for what is economically one token.

Returns

launchToken((string,string,string,string,(string,string,string,string,string),address,uint16,bytes32,bytes32),uint256,address)#

0xbc9bc035 · nonpayable · Permissionless, but gated by canLaunch(msg.sender) — check it before offering a launch UI.

Deploys a bonding curve and its launch token, wires them together, and records the launch. Trading starts immediately on the curve; the graduation pool's pairToken is fixed here, chosen by the caller.

Approve first: factory for launchFee() of launchFeeToken() (USDC).

Use this when there is NO opening buy. The atomic router reverts on a zero quoteIn, so it cannot be used as a plain deployer. Note the approval target differs from the router path: the factory pulls the fee from msg.sender itself. If launchFee() is zero, no approval is needed at all. A token launched this way starts with the creator holding none of its supply.

Parameters

Returns

Reverts

• NotWhitelisted — launchEnabled is false and you are not a whitelisted launcher
• InvalidLaunchConfigId — no such config
• InvalidTokenParams — empty name or symbol
• CreatorTaxTooHigh — creatorTaxBps above maxCreatorTaxBps()
• PairTokenNotApproved — quote asset not approved by the owner
• LaunchEconomicsMismatch(expected,actual) — terms moved since you read previewLaunchEconomics
• FailedDeployment — you already used this salt; salts are namespaced per account
• ERC-20 revert on the fee transfer — insufficient allowance to the factory

pairTokenEconomics(address)#

0x31082134 · view · view

Phantom reserve and graduation threshold in the QUOTE ASSET'S OWN DECIMALS (6 for USDC).

Parameters

Returns

previewLaunchEconomics(uint256,address)#

0xf718b78c · view · view

Returns the economics digest a launch of launchConfigId in pairToken would produce right now, for a creator to pass back as TokenParams.expectedEconomics.

Reading the digest and launching in separate transactions still leaves the terms free to move in between; the pin is what makes that movement revert instead of silently repricing the launch.

Returns the digest to put in TokenParams.expectedEconomics. Fetch it in the same flow as the submit — it covers the launch fee, so an owner changing setLaunchFee between your quote and your signature invalidates it. Passing bytes32(0) waives the check entirely, which means accepting whatever terms are live when the transaction lands.

Parameters

Returns

Other functions#

Events#

Errors#

---

FociV2BondingCurve#

Deployed once per launch — no fixed address. Read it from factory.getLaunchedToken(token).

Functions an application calls#

buy(uint256,uint256,address)#

0x59a87bc1 · payable · Permissionless. Reverts once the launch has graduated.

Buys the launch token with this launch's quote asset. The fee is always taken from the quote leg, so this curve never holds a memecoin-denominated fee.

quoteIn must equal msg.value for a native launch, and must be accompanied by no value at all for an ERC-20 launch. The credited amount for an ERC-20 is the observed balance delta rather than the requested amount, so a fee-on-transfer quote asset cannot make the curve promise reserves it never received. A buy that would take the curve past its reserved allocation is filled only up to that allocation, charged for what it actually received, and refunded the difference. It is deliberately not rejected: the last buy of a launch is the one most likely to be sized against a state someone else has already moved, and reverting would let anyone grief it by slipping a small buy in ahead. Partial fills reinterpret minTokensOut as a bound on price rather than on quantity, since a caller who spends less than they offered cannot expect the whole quantity they asked for. The requirement is that the price paid is no worse than the price implied by the caller's own arguments, and when nothing is clamped it reduces exactly to tokensOut >= minTokensOut.

Approve first: curve for quoteIn of the quote asset (USDC).

minTokensOut is a PRICE bound, not a quantity bound. A buy that would exceed the remaining allocation is clamped rather than reverted, and the remainder is refunded to msg.sender in the same transaction — so you can safely overshoot the graduation threshold.

Parameters

Returns

Reverts

• CurveGraduated — the curve is closed; trade the V4 pool instead
• SlippageExceeded(tokensOut,minTokensOut) — the effective price broke your bound
• UnexpectedNativeValue — sent ETH on an ERC-20-quoted launch; msg.value must be 0
• ZeroAmount — the transfer delivered nothing

buy(uint256,uint256,address,address)#

0x82b2a559 · payable · Permissionless. Reverts once the launch has graduated.

Buys with a referrer attached.

The referrer is only consulted the first time recipient trades with one; after that the binding in the registry stands and this argument is ignored, so passing a fresh referrer cannot poach an existing relationship. An unusable referrer (the recipient themselves, or someone the recipient already refers) reverts rather than being dropped, because it is an argument the caller chose to supply and silently charging them the undiscounted fee would be worse.

Approve first: curve for quoteIn of the quote asset (USDC).

As above, with a referrer bound to recipient (not to msg.sender). The binding is written only on that address's first referred trade and is permanent thereafter. An unusable referrer REVERTS THE WHOLE BUY — SelfReferral and ReciprocalReferral are not swallowed — so resolve and validate a referrer before putting it in the call.

Parameters

Returns

Reverts

• SelfReferral — referrer is the recipient
• ReciprocalReferral — the recipient already refers that address
• everything the 3-argument overload throws

getReserves()#

0x0902f1ac · view · view

Returns the curve's current tradeable reserves, excluding fees pending sweep.

Returns the VIRTUAL reserves — quoteReserve includes the phantom reserve. For the amount actually raised use realQuoteReserve().

Returns

graduated()#

0xe7c2b772 · view · view

Returns

quoteReserve()#

0x9da771f4 · view · view

Tradeable quote reserve only, matching IFociV2BondingCurve.

Returns

readyToGraduate()#

0xc68360a5 · view · view

True once the curve's sellable allocation has been bought out.

Equivalent to the real quote reserve reaching graduationThreshold, since the reserved balance is derived from that same point. Expressed against the token side because that is the one a buy cannot overshoot: the quote side is a floor that a large trade could sail past, while the token side is a hard stop the curve refuses to cross.

True when the sellable allocation reaches zero, which is by construction the same point as the real quote reserve reaching the graduation threshold.

Returns

realQuoteReserve()#

0x4f1f58fd · view · view

Returns physically held tradeable quote asset, excluding virtual liquidity and balances already earmarked as fees or creator tax.

Returns

sell(uint256,uint256,address)#

0xd04c6983 · nonpayable · Permissionless. Closes the instant readyToGraduate() is true.

Sells the launch token back to the curve for the quote asset. The fee is taken from the quote output, so it is always quote-denominated here too.

Closed once the sellable allocation is exhausted, not merely once graduated is set. _tryAutoGraduate swallows a failed graduation so a problem there cannot take the crossing buy down with it, which leaves a window where the curve is ready but the flag is still false. buy already refuses that state through its own sellable == 0 check, and sell has to match: graduate hands the pool whatever trackedTokens holds, so a sell landing in the window would put tokens back on the curve and take quote off it, and the pool would then be seeded deeper and cheaper than the reserved allocation fixes it at. The deterministic graduation price only holds if the window is closed on both sides. This cannot strand a holder. graduate is permissionless, so anyone blocked here can settle the launch themselves in the same transaction and trade the V4 pool instead.

Approve first: curve for tokensIn of the MEMECOIN (18 decimals).

Unlike buy, minQuoteOut is a strict QUANTITY bound. The sell side shuts the moment the allocation is exhausted — before the graduated flag is even set — so a sell can start reverting with CurveGraduated while the UI still shows a live curve. Approve the CURVE for the memecoin, not the factory.

Parameters

Returns

Reverts

• CurveGraduated — the allocation is exhausted or the curve has graduated
• SlippageExceeded(quoteOut,minQuoteOut)
• ZeroAmount

sellableTokens()#

0x808bcddc · view · view

Tokens still available to buy before the curve graduates.

Returns

Other functions#

Events#

Errors#

---

FociV2LauncherToken#

Deployed once per launch — no fixed address. Read it from factory.getLaunchedToken(token).

Other functions#

Events#

Errors#

---

FociV2LaunchAndBuy#

0xE4A165a52A6033ee0C1b3B6dA83f72AbA1707349

Functions an application calls#

launchAndBuy((string,string,string,string,(string,string,string,string,string),address,uint16,bytes32,bytes32),uint256,address,uint256,uint256,address)#

0x32b6091a · payable · Permissionless, but factory.canLaunch(msg.sender) must hold — routing through the router does not widen the gate.

Launches a token and immediately buys quoteIn of its curve for recipient, both in this transaction.

A native launch carries the opening buy as msg.value. An ERC-20 launch carries no value at all and the buy is pulled from the caller, who must have approved this contract for quoteIn first.

Approve first: launchAndBuy for launchFee() + quoteIn — ONE approval covers both of launchFeeToken() (USDC).

Deploys the token and performs the creator's opening buy in one transaction. Two things differ from the direct path: creatorFeeRecipient may NOT be zero here (the direct path defaults it to the caller), and quoteIn may not be zero — the router exists to buy. GAS: if the opening buy crosses the graduation threshold the curve tries to seed the V4 pool inside this same transaction, and eth_estimateGas cannot size that — the seed is a best-effort try/catch, so a simulation in which it fails still succeeds overall and returns a limit too small for it to work. Send an explicit generous gas limit.

Parameters

Returns

Reverts

• NotApprovedLauncher — the factory's launch gate is closed for you
• ZeroAddress — recipient or params.creatorFeeRecipient is zero
• ZeroAmount — quoteIn is zero; use factory.launchToken instead
• everything launchToken throws, plus an allowance failure against the router

Other functions#

Events#

Errors#

---

FociV2MemeHook#

0x527129aB10Fa3163629A32c4E3Ab7a98ba28e044

Functions an application calls#

claimReferralFees(address,address)#

0xcf893acc · nonpayable · Permissionless — anyone may settle anyone's accrual into the escrow.

Pays a referrer their accrued fees for one currency into the escrow. Permissionless: the amount and destination are fixed by the ledger, so who triggers the settlement does not matter.

Deliberately not settled inside afterSwap. An escrow credit is an external call plus an approval, and putting it on the swap path would charge every trader for it. This mirrors how the pool's own fees are batched into sweepPoolFees rather than distributed per swap.

Two steps, not one: this moves the accrual into the escrow, then the referrer calls feeEscrow.claimToken to withdraw. Returns 0 and does nothing when the ledger is empty.

Parameters

Returns

currentFeePolicy()#

0x89a69bd8 · view · view

Returns the policy terms new launches snapshot immutably.

Live policy. A launch freezes a copy of this at creation, so an existing launch is unaffected by later changes.

Returns

pendingReferral(address,address)#

0xd85b2777 · view · view

Parameters

Returns

sweepPoolFees(bytes32,uint256)#

0xebe51768 · nonpayable · The fee-sweep operator, or the pool's creator.

Converts any pending memecoin-denominated fee into the pool's quote currency against the pool's own liquidity, then splits the combined quote-currency total between protocol and creator using the live policy, exactly mirroring the bonding curve's own sweep. The trusted sweep operator is required whenever the sweep would execute an internal conversion. The creator may still distribute already-quoted fees when no internal swap is needed.

If any memecoin-denominated fee is pending, only the operator may call and minConversionQuoteOut must be non-zero — the sweep converts inventory against the pool's own liquidity and needs a slippage bound.

Parameters

Other functions#

Events#

Errors#

---

FociV2FeeEscrow#

0xcecCFebAcaDCd9404Ae70b160305Af07D9760A46

Functions an application calls#

balanceOf(address)#

0x70a08231 · view · view

Returns the claimable native ETH balance for recipient.

Parameters

Returns

balanceOfToken(address,address)#

0xf59e38b7 · view · view

Returns the claimable balance of token for recipient.

(account, token). Read this rather than an indexer if you want on-chain truth for a claim button.

Parameters

Returns

claim()#

0x4e71d92d · nonpayable · Pull-only, msg.sender.

Pays out the caller's entire claimable native ETH balance.

Native-asset balance. Unreachable unless a launch quotes in the native asset, which no approved pair token does.

Returns

claimToken(address)#

0x32f289cf · nonpayable · Pull-only — claims the balance of msg.sender. You cannot claim for someone else.

Pays out the caller's entire claimable balance of token.

The escrow holds ONE balance per (recipient, token). It does not distinguish creator fees from referral fees — that split is attribution derived off-chain from events — so this withdraws both at once. Fees on Arc are the 6-decimal USDC ERC-20, so this is the path, not the native claim().

Parameters

Returns

Reverts

• NoBalance — nothing accrued for you in that token

Other functions#

Events#

Errors#

---

FociV2ReferralRegistry#

0xEB286974C35d2741B0fe9b2a1Cd41E53d06aE406

Functions an application calls#

referrerOf(address)#

0xd21cacdf · view · view

The permanent referrer of each user, or the zero address if they have never been referred. Read by every curve on every trade.

Parameters

Returns

setReferrer(address)#

0xa18a7bfc · nonpayable · Self-service — binds msg.sender.

Claims a referrer for the caller before their first trade.

Reverts rather than no-ops on an existing binding: someone calling this directly asked for a specific outcome and should be told it did not happen, where a trade merely carrying a stale referrer should still settle.

Permanent and never rewritten. Bind before trading, or pass the referrer to buy instead.

Parameters

Reverts

• AlreadyReferred
• SelfReferral
• ReciprocalReferral
• ZeroAddress

Other functions#

Events#

Errors#

---

FociV2LaunchLocker#

0xe047D0F0ce0dD600732793762B1f1929Adc5015d

Other functions#

Events#

Errors#

---

FociV2LaunchDeployer#

0x5C5c202271E1300bD5Ce43A4F5C1cEA8efd57B63

Functions an application calls#

predictLaunchAddresses((address,address,address,address,(address,uint16,uint16,uint16,uint16,uint16),address,uint256,uint256,uint256,uint256,uint256,bytes32,string,string,string,string,(string,string,string,string,string)))#

0xe6a900b5 · view · view

Returns the addresses deployLaunch would produce for params, without deploying anything.

Lets a caller confirm that a launch it has not seen confirmed yet will land where it expects, and lets the launch path be checked for a salt the creator has already used. The token is derived from the curve because the curve's address is one of the token's constructor arguments, so the pair has to be computed in deployment order.

Computes the CREATE2 token and curve addresses before you send. Use it to mine a vanity address, and to check for an existing deployment — a reused salt reverts with the unhelpful FailedDeployment.

Parameters

Returns

Other functions#

Errors#

---

FociV2GraduationExecutor#

0x02e7d818080bf85EEB7191536A768B0CFdB38D5D

Other functions#

Events#

Errors#