Earning & claiming
Depositor rewards, purchaser epochs, token allowances, and how to claim each balance.
The current main pool records its FWA rewards in FWAV2Rewards. Depositor rewards, purchaser epochs, and purchaser token-buy allowances have separate balances and claim actions. A successful NFT acquisition does not automatically send all available token rewards to your wallet.
Purchaser rewards belong to the purchaser address named in the acquisition request. A router can pay on your behalf while naming your wallet; the router does not receive your epoch shares or token-buy allowance simply because it submitted the transaction. The same purchaser owns the NFT allocation, settlement choices, and any later acquisition-refund credit.
Depositor rewards
Active listings share FWA according to the square root of their ETH backing. A listing backed by 4 ETH has twice the token-reward weight of a listing backed by 1 ETH, while each still receives the same share of distributable ETH acquisition fees.
Token rewards can come from the funded emission schedule and recurring buybacks. Staged listings start earning only after activation. Allocation, withdrawal, or removal ends a listing's future rewards and records what it has already earned.
You can harvest rewards from your active listings without withdrawing the NFTs. Rewards recorded when a listing is repriced or removed become a separate token credit to withdraw 1.
Purchaser epochs
Each epoch is a 24-hour interval measured from the rewards module's emission start, rather than a UTC calendar day. A purchase belongs to the epoch in which its request was opened. Each successful acquisition earns one share; refunded requests earn none.
Your reward is the epoch's token pot multiplied by your successful acquisitions, divided by all successful acquisitions assigned to that epoch. Two successful acquisitions out of ten earn 20% of the pot, subject to integer rounding. The pot can include scheduled emissions and tokens routed to that epoch by buybacks.
An epoch must be closed and all its pending requests must be resolved before anyone can claim its purchaser rewards. A missing earlier result can therefore delay claims even after the 24-hour period ends. Buying FWA on the market does not earn an acquisition share.
Purchaser token-buy allowances
The rewards module can reserve part of the acquisition surcharge for a successful purchaser to buy FWA. With its activity-based settings, a quiet pool can reserve more of the surcharge for this allowance, while a busy pool can distribute more to depositors. A fixed configured split can override that activity curve.
The activity curve measures time since the previous request. In a batch, only the first request can benefit from a quiet interval; the rest see a zero-second gap. Each successfully processed request still earns its own purchaser-epoch share.
An allowance is an ETH budget for a later token purchase, not a fixed number of FWA tokens. Claiming spends your accumulated allowance on the market and transfers the purchased tokens to you. Set a minimum token output: the result depends on execution price, and a failed swap leaves the allowance available for another attempt 2.
The allowance is separate from purchaser-epoch rewards and from choosing to accept an NFT's standing bid as FWA. A refunded acquisition creates neither a successful-purchase allowance nor an epoch share.
The funded emission schedule
The current main-pool rewards module has a fixed 15-day emission schedule. Its depositor and purchaser allocations must be configured and funded with existing FWA before emissions begin. The first time acquisitions are enabled starts its clock.
Pausing and reopening acquisitions does not restart the schedule. The emission allocations cannot be reconfigured after the clock starts, and the schedule ends after 15 days even if the pool is empty for part of that time. Buyback-funded rewards can continue afterward. Check the module's recorded start and balances to determine which rewards are available.
Claim from the right contract
A credit belongs to the wallet and rewards contract that recorded it. Claiming one balance does not claim the others. FWAIR supporters instead receive their campaign's harvested reward shares through its campaign claim flow. Custom-pool participation does not directly earn main-pool listing or purchaser rewards.
See buybacks and fee routing for ongoing reward funding.
Technical breakdown
- 1.
claimDepositorTokensharvests active-listing rewards;withdrawTokenswithdraws settled token credit. Purchaser rewards useclaimEpochTokensfor closed epochs with no unresolved assigned requests. These token claims are separate from withdrawing earned ETH fees. - 2.Allowance purchases use
claimAccruedTokens(minOut). The surcharge curve useshotGap,coldGap, andforcedTokenShareBps; these settings are separate from the main pool's daily purchase blackout windows. An unspent allowance can be recovered as ETH throughwithdrawTokenBuyAllowanceAsETHonly while the pool is in withdraw-only mode with no unsettled acquisitions.