FormationBuy separates totalEth, reserveEth, creatorContributionEth, reserveFeeEth, and creatorTradingFeeEth. Sum totalEth for gross formation buy payments; do not then add those components again. FormationSell separates gross curve value, contribution, reserve fee, and netEthOut.
FormationTargetUpdated records persisted reviews. currentTarget may already preview a lower target before such an event exists. FormationGraduated records the actual circulation, target, ETH reserve, liquidity seed, surplus inventory, staking allocation, and timestamp.
PermanentMarketActivated identifies the pool, initial square-root price, locked liquidity, and seed amounts. PoolManager swap events describe v4 trade execution; FeesHarvested describes subsequent collection and routing. Harvested fees and trade volume are separate measures.
CreatorTradingFeeAccrued can represent harvested permanent ETH as well as formation buy fees. CreatorClaimed is a payment of previously accrued revenue, not new revenue generation.
RevenueDeposited contains amount, delivered routed amount, retained amount, and pending amount. RouteDelivered can happen during a deposit or on a later retry. RouteDeliveryFailed does not mean the source receipt disappeared.
For a stream, total deposits reconcile to retained balance plus pending balance plus total routed plus total withdrawn. Count a retry as delivery of an existing deposit, not a second revenue receipt. Asset denominations must stay separate.
Staked records principal and internal shares. PrincipalWithdrawn, RewardsClaimed, and PositionClosed distinguish principal movements from reward payouts. Time-based reward release can change previewed asset value without an event at every second.
Use totalAssets and reward-state reads at the same block when reconciling balances. A raw token transfer after activation can be unaccounted inventory and must not be classified as a stake or authenticated funding event.
A Coinflip WagerPlaced event initially describes escrow, not earned revenue. LotteryLobbyWeightRecorded is provisional weight, not final drawable eligibility. LotteryLobbyResolved identifies the actual assigned epoch at settlement.
Coinflip LobbySettled and turn-game GameSettlementRouted identify decisive fee splits. LotteryFunded and SettledGameRecorded describe amounts already paid from those splits; summing both source fee and receipt as independent revenue double-counts the same movement. Payout and refund claims settle liabilities rather than creating game volume.
Index from the verified deployment block, persist chain ID and contract address with events, and deduplicate by transaction hash plus log index. Handle chain reorganizations and replay from a stable checkpoint. Store integer amounts and explicit asset identifiers. Compare selected intervals against raw logs and contract counters before publishing aggregate statistics.
Source reference
Checked against the source shipped with this documentation. Contract calls and units are detailed in the contract reference.
Imported source files 70
Supporting contracts, interfaces, and libraries imported by the sources above, including their dependencies.