BaseLaunchBondingCurve

Share of the creator part of the base fee earmarked for buyback-and-lock while buyback is on, in basis points. Frozen at launch.

The creator recipient the curve was created with; buybacks it locks name this account in the vault.

Whether buyback-and-lock is on for fees charged from now on.

The slice of creatorFeeBalance already earmarked for buyback-and-lock, set aside as each fee was charged under whatever the buyback flag said at that moment. Bucketing at accrual rather than deriving the slice at sweep time keeps the flag forward-looking: toggling it decides how the next trade's fee is split, never how an already-charged one is. It is not a separate pot, only a marker on part of the creator bucket, and it is measured on the creator part of the fee alone, never the creator tax.

The shared buyback vault the curve locks bought-back coins into.

Pending creator side: the creator part of the base fee, its part of the launch tax and the creator fee. Swept to the fee escrow.

Creator-chosen at launch, capped by the protocol at launch time. Kept entirely separate from feeBps: it is layered on top of the base trade fee, not part of the protocol/buyback/creator split, and is paid to the creator in full.

Snipe tax recipient would pay on a buy landing right now, in basis points of the quote leg. Starts at this launch's frozen snipeTaxStartBps in the launch second and decays exponentially to zero across snipeTaxSeconds, both snapshotted from the factory when the curve initialized. Exempt wallets and a disabled tax both read as zero.

The decay is fourteen successive halvings spread evenly across the window, done with right shifts so it stays in integer arithmetic. Fourteen because 2^14 exceeds the maximum 9,900 starting tax, so the tax always reaches zero inside the window rather than cutting off at a still-meaningful rate. The decay anchors to launchedAt, set in the launch transaction itself, so second zero is the first second the token is publicly buyable.

The coin's current creator fee recipient (despite the name); the factory updates it when the recipient changes.

The launch factory; the only caller allowed through onlyFactory.

The curve's base trading fee in basis points, charged on the pair asset side of every buy and sell. Frozen at launch.

The fee escrow every curve payout is credited to.

The hook, read live for the fee sweep operator, the protocol fee recipient and the interface registry.

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

True once the curve has handed its reserves to the factory; trading on the curve is closed for good.

The real pair asset reserve at which the curve has sold its whole sellable allocation and graduates.

True when this launch trades and graduates against native ETH.

Timestamp trading opened, anchoring the snipe tax decay. Set once at initialize, which the factory calls in the launch transaction itself, so second zero of the decay is the launch second.

Total supply this launch was created with, snapshotted at initialize and exposed for off-chain consumers. Held here rather than read live from the token because the token is burnable, so its own totalSupply stops describing the supply the launch was configured around.

Cap on how far the fee buyback may move the curve's reserves, in basis points. Frozen at launch.

The pair asset the curve trades and graduates against; the zero address means native ETH.

Virtual quote reserve seeded at deploy, denominated in the quote asset's own decimals rather than always in wei.

Pending protocol part of the base fee and of the launch tax, net of referrer payments. Swept to the fee escrow.

The protocol's fee recipient, read live from the fee policy on every payout. It is deliberately not snapshotted (unlike every fee rate): the protocol may move its own revenue address, and that move must reach launches already trading.

Protocol share of the base fee and of the launch tax, in basis points. Frozen at launch.

Tradeable quote reserve only, matching IBondingCurve.

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.

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

Token balance the curve will never sell below, set once at initialize and handed to the graduated pool intact. Everything above it is the sellable allocation, and graduation is exactly its exhaustion.

Tokens still available to buy before the curve graduates.

Wallets the creator declared at launch, exempt from the snipe tax so a team's own bundled buys are not eaten by the launch window's anti-bot pricing. Written only by the factory during the launch transaction.

Seconds over which this coin's launch tax decays to zero, snapshotted from the factory at launch.

This coin's launch tax in the launch second, in basis points, snapshotted from the factory at launch. Zero means no launch tax.

The coin this curve sells. Set once by the factory in the launch transaction.

Tradeable token reserve only, matching IBondingCurve.

Net real quote asset held from curve trading: buys add their value, sell payouts, referrer credits and swept protocol/creator fees subtract theirs. Tracked explicitly instead of reading a live balance, so a forced transfer in (an ERC-20 airdrop, or ETH from a selfdestruct) can neither inflate curve pricing nor push a launch past its graduation threshold with no tokens actually sold.

Launch tokens this curve holds as tradeable reserve: set to the minted allocation at initialize, reduced by buys and the internal buyback, increased by sells. The token side needs the same treatment as the quote side because both feed the constant-product price. Reading a live balance would let any holder transfer tokens straight in to move the curve's pricing, delay graduation past the point the launch's economics were quoted at, and shift what the graduated pool opens at.

buy with a trade referrer. The referrer is paid LaunchFeeShares.REFERRER_BPS of the base fee (capped at this launch's protocol share) out of the protocol part, credited to the fee escrow in this same call. The buyer's price and the creator's share are identical with or without a referrer; the zero address means none.

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. Buys landing in the opening seconds of a launch additionally pay the decaying snipe tax (see currentSnipeTaxBps) unless the recipient was exempted at launch. The tax comes off the quote leg before pricing, so a sniper's spend mostly accrues as fees instead of buying tokens, and it decays to nothing within seconds for ordinary buyers. 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.

Marks account as exempt from the snipe tax. Called by the factory during the launch transaction for the creator, their fee recipient, and any bundle wallets the creator declared, so a team's own opening buys clear at the untaxed price while sniper bots in the same window do not.

Sweeps fees, halts trading, and hands the remaining tradeable reserves to the factory so it can seed the graduated Uniswap V4 pool. Because the curve already holds the pool's quote asset, the factory receives exactly what it needs to seed with, and no conversion step sits between the two. Restricted to the factory; deliberately not nonReentrant since it may be invoked from within buy()'s own reentrancy-guarded scope.

Wires the launch token this curve dispenses. Called once by the factory immediately after deploying the token with this curve's (now known) address, before either contract is reachable by anyone else.

Also fixes the pool's token allocation, which is why this cannot happen in the constructor: the supply is only known once the token exists. Holding phantomQuote * supply constant, the curve reaches a real quote reserve of graduationThreshold exactly when its token balance falls to supply * phantomQuote / (phantomQuote + threshold). Reserving that balance therefore does not change where a launch graduates, it only stops the curve selling through it: the quote threshold and the token allocation are the same point, so whichever one is used as the trigger, the graduated pool is seeded with the same amounts at the same price on every launch.

Pays this curve's pending fees straight to the protocol and creator recipients, bypassing the escrow. Restricted to the factory, which gates it on the protocol owner.

Exists because an ordinary sweep routes every payout through BaseLaunchFeeEscrow, and a permissioned quote asset can stop delivering to that one address while still permitting transfers between traders and this curve. Trading then continues normally, but the fees are unreachable, and graduation is unreachable with them: graduate sweeps before it hands over the reserves, and fees accrue from the first trade, so the sweep is never a no-op by the time the threshold is crossed. The launch would be stuck on its curve forever. Clearing the buckets here is what unblocks that: the sweep inside graduate then finds nothing pending and returns early, so graduation proceeds without this function needing to touch it. The buyback slice is deliberately skipped rather than executed. It would have to settle through the vault and the same escrow, which is the dependency this path exists to route around, so the whole creator bucket is paid out directly instead, split with the launch interface exactly as a sweep splits it, so the owner can never use this path to take the interface's share away. On a native launch that share is still credited to the escrow, which native ETH can always reach. Mirrors BaseLaunchHook.rescuePoolFees for the post-graduation pool and BaseLaunchFactory.rescueSweptGraduation for the reserves in between.

sell with a trade referrer, paid out of the protocol part of the base fee exactly as on buy. The zero address means none.

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.

Enables or disables this launch's buyback-and-lock fee route. The factory authorizes both the current creator recipient and protocol owner before forwarding the setting here.

Applies to fees charged from here on, not to fees already pending. Each trade earmarks its buyback slice as it is charged, so a toggle cannot reach back and reroute value that accrued under the opposite setting. Without that, a disable landing before a sweep would divert a buyback the creator had already earned into their own payout, and an enable would sweep fees earned under a plain split into the vest.

Updates who receives creator fees from future sweeps. Restricted to the factory, which gates both self-service creator transfers and protocol-owner overrides before forwarding here, so this contract only needs to trust one caller.

Distributes pending quote fees across protocol, buyback-and-lock, and the creator using this launch's frozen policy. The trusted sweep operator is required when the sweep would execute an internal buyback. The creator may still distribute fees when no swap is required.

Reverts once graduated rather than silently no-op'ing. graduate() already drains protocolFeeBalance/creatorFeeBalance to zero before setting the flag, and trading is halted afterward so they can never refill, but making the guard explicit here keeps that invariant self-evident instead of depending on reasoning across two functions.

The buy that sold out the curve could not graduate it in the same call; anyone can call the factory's graduate. gasRemaining helps spot a starved call.

Emitted by buy, buy (4 args)

Buyback-and-lock was turned on or off for fees charged from now on.

Emitted by setBuybackEnabled

A fee sweep bought coins off the curve and locked them in the buyback vault.

Emitted by graduate, sweepFees

The creator fee recipient of this curve changed.

Emitted by setCreatorFeeRecipient

fee and tax are reported separately because they fund different parties: the fee splits across referrer, protocol, buyback and creator, while the tax is paid to the creator in full. referrerAmount is the part of fee already credited to referrer in the same trade.

Emitted by buy, buy (4 args)

A buy was clamped at the end of the curve and the unspent pair asset was returned to the buyer.

Emitted by buy, buy (4 args)

Graduation: the curve sent its reserves to the factory and closed.

Emitted by graduate

A sell on the curve. fee is the base fee, tax the creator fee, referrerAmount the part of fee paid to referrer in the same trade.

Emitted by sell, sell (4 args)

The owner, through the factory, paid pending curve fees straight to the protocol and creator recipients (and the launch interface).

Emitted by rescueFees

Pending curve fees were paid out: protocol, buyback, creator and launch interface amounts.

Emitted by graduate, sweepFees

The factory wired the coin to the curve and trading opened.

Emitted by initialize

During a fee rescue on an ERC-20 pair, the launch interface's share could not be sent and went to the creator instead.

Emitted by rescueFees

Separate from CurveBuy so indexers can tell an ordinary fee from a launch-window penalty and surface which wallets sniped the launch.

Emitted by buy, buy (4 args)

An account was exempted from the launch tax during the launch transaction.

Emitted by exemptFromSnipeTax