Fees and rewards

Moonfiesta does not invent a fee. Every launch opens a standard Uniswap V3 pool at the 1% fee tier, and 1% is simply what that tier charges. The fee is taken off the top of whatever you put into the swap, before the trade is priced, and it is credited to the liquidity providers in that range. Since your pool has exactly one liquidity position and that position is locked in LpLocker forever, one hundred percent of the fee lands there. Nowhere else.

The trader pays it. There is no separate Moonfiesta cut layered on top of the swap, and there is no tax on the token itself. If you buy 1 WETH worth of a coin, 0.01 WETH becomes fee and the remaining 0.99 WETH executes against the pool.

When the factory hands the position NFT to the locker, it records a split in the same transaction: creator basis points, protocol basis points, and holder basis points. The three must add up to exactly 10000 or the transfer reverts and the launch fails. The locker stores that split against the position id and exposes no function to edit it. Not for the creator, not for the protocol, not for the factory owner.

The live test token launched with this split:

The creator share is the remainder: the factory computes it as 10000 minus the protocol share minus the holder share. The holder carve out comes out of the creator's side, not the protocol's, which is the honest way to read it. Choosing a 15% holder share means giving away 15 points of your own take.

With the settings live today, the protocol share is 20% and the holder carve out is capped at 20%, so the least a creator can end up with is 60%. That 60% is a consequence of the current configuration, not a law. The number the contract actually enforces forever is a hard cap of 40% on the protocol share, compiled into the factory as a constant that no one can raise.

Fees do not arrive in your wallet by themselves. Getting them out is two transactions, and they are deliberately separate.

1. Fees accrue in the pool

   Nothing to do. Uniswap tracks what the position has earned as people trade.
2. Someone calls collectRewards on LpLocker

   This is permissionless. collectRewards(tokenId) takes the position id, not the token address, and anyone can call it for anyone's token: the creator, a holder, a bot, a keeper, a stranger. The caller pays the gas and receives nothing for it. The locker pulls the fees out of Uniswap, splits them by the recorded ratio, sends the tokens to FeeVault, and credits each recipient's balance there.
3. You call claim on FeeVault

   claim(WETH) zeroes your balance and transfers it to you. Only you can claim what is owed to you. There is claimMany too, if you want several tokens in one transaction.

If you want to know why the position id and not the token address: the locker keys everything off the Uniswap NFT. It keeps tokenIdOf(launchToken) as a lookup so the UI can go from a coin to its position without you thinking about it.

The obvious design is to push: harvest the fees and transfer each recipient their share in the same call. It is one transaction instead of two and it feels better. It is also fragile in a way that matters here.

Recipients are arbitrary addresses. Any of them can be a contract. If a push design transfers to three recipients in a loop and one of them reverts on receipt, whether by accident, because it is a contract with no fallback, or on purpose, the whole harvest reverts. One bad recipient bricks fee collection for everyone else on that position, permanently, and there is no admin to fix it because the locker has no owner.

Pull based removes the failure mode. The harvest only ever writes a number into owed[recipient][token], which cannot revert on anyone else's behalf. Withdrawal is a separate call that each recipient makes for themselves, paying their own gas. A recipient who cannot receive tokens only fails to collect their own share. The other two are untouched.

Rewards pay out in WETH, the ERC20 wrapper, at 0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73. Not native ETH. The pool is a token/WETH pair, so fees are collected in WETH, credited in WETH, and claimed in WETH. The vault never unwraps for you. If you want native ETH, unwrap it yourself afterwards.

This is the mirror image of buying, where the UI wraps your ETH into WETH inside the router so you never handle WETH directly. See How to trade. On the reward side the wrapper is visible, because you are the one receiving it.

The creator studio wraps both steps. Each coin you launched has a Harvest button, which calls collectRewards for that coin's position and moves the fees from Uniswap into the vault. The panel at the top shows your claimable WETH read straight from owed(you, WETH) on the vault, and Claim to wallet calls claim(WETH).

Harvest first, then claim. If your claimable balance reads zero right after a burst of trading, that is expected: the fees are still sitting in the Uniswap position and nobody has harvested them into the vault yet. Both numbers only move once their transaction confirms.

Neither step is required on any schedule. Unharvested fees are not at risk, they are just still in the position. Unclaimed balances sit in the vault until you want them. There is no expiry and no admin path to move them.

A creator can carve out part of their own fee share for holders at launch, up to the configured cap. The live test token uses 15%. That share is credited on every harvest, same as the other two.

This is worth being precise about, because it looks like something it is not.

The token contract has no tax code in it at all. The only logic on the transfer path is the temporary anti snipe cap on buys, and it switches itself off when the window ends. Sending your coins to a friend costs you nothing but gas. The holder share is fee routing that happens entirely outside the token, in a contract the token does not know about.

Take the live split, 65 creator / 20 protocol / 15 holders, and a week where the coin trades 150 WETH of buys and 40,000,000 tokens worth of sells. The two sides accrue separately, so do the arithmetic twice.

The buy side, in WETH

150 WETH in, at 1%, is 150 x 0.01 = 1.5 WETH of fees.

The sell side, in the coin

40,000,000 tokens in, at 1%, is 400,000 tokens of fees.

After one collectRewards call the creator can claim 0.975 WETH and 260,000 tokens from the vault, in two separate claims or one claimMany. The studio will show the 0.975 WETH.

Scaling is linear and there is no cliff: 1000 WETH of buy volume is 10 WETH of fees and 6.5 WETH to a creator on a 65% share. Divide by 100 to get from volume to fees, then apply your share.