Onchain events
> V3 publication draft; not yet published. Economic terms follow the unfrozen specification v2 draft. {{待冻结}} means pending reconciliation with the final frozen specification. This page does not apply to V2 or existing tokens. Available actions depend on the verified release manifest.
Filter by verified Factory, project-contract and Hook addresses, then check release, token, pool and economic version. An event name or address suffix does not authenticate an unknown emitter. Use the final release ABI for complex tuples; this table describes implemented events and their roles.
| Emitter | Event | Main fields / use |
|---|---|---|
| Factory | ReleaseSealed | Release binding of Managers, Curve, Coordinator and Hooks |
| Factory | ProjectCreated | releaseId, token, creator, chainId, economicVersion, economicHash, configHash, mode, quote, quoteDecimals, components, name, symbol |
| Curve | CurveTrade | releaseId, token, tradeSeq, poolId, Trade tuple; payer/recipient, direction, exactOutput, opening, gross, fees, inventory/reserves, relative block and price fractions |
| Curve | TradeRefund | actualPaid, actualUsed, refund; distinguishes budget from spending |
| Graduator | Graduated | releaseId, token, poolId, version, PoolKey, Lock, tokenId, range, tradeSeq |
| Hook | PoolRegistered | Full PoolKey, token, Factory, Manager, Vault, version, configHash |
| Hook | HookTradeAccounting | seq, router, buy, exactInput, gross, net, protocolFee, projectTax, accrualSeq |
| Vault | RevenueAccrued | source, tradeSeq, gross, protocolFee, buckets, referralCode, tier, projectTax, antiFee, sourceId |
| Vault | TaxCollected | poolId, token, source, gross, amount, cumulative; another view of the same tax, not extra income |
| Vault | RevenueClaimed | kind, entitlement, asset, recipient, amount, paidAfter, remainingLiability |
| Rewards Token | DividendFunded | source, sourceAccrual, amount, start/end, previousUnreleased, budget, weight, remainder, dust, noEligible |
| Rewards Token | DividendClaimed | holder, asset, seq, amount, cumulativePaid, fractionCreditAfter |
| Lock | FeesCollected | poolId, tokenId, amount0/amount1, cumulative0/cumulative1 |
| Lock | FeesClaimed | role, asset, recipient, amount, paidAfter |
| Referral | CodeActivated / WalletBound / GenerationRevoked | Activation, payout binding and authorization-generation revocation |
| Risk | RiskPaused / RiskResumed | Risk-operation bitmask changes |
| ERC-20 Token | Transfer / Approval | Balance changes and allowances; Transfer alone does not prove a trade |
Curve accounting uses source=0; graduated Hook accounting uses source=1. LP claim role=0 is platform and role=1 is original creator. Native OKB uses address(0). These are implementation enums, not adjustable economic terms. Interpret Lock asset ordering through the authenticated PoolKey, not symbols.
Identify logs by chain, blockHash, transactionHash and logIndex. Replay in blockNumber / transactionIndex / logIndex order, deduplicate, rewind reorg ranges and respect release confirmation depth. Timestamps alone are insufficient. Accrual, funding and payment are distinct actions; correlated events do not represent multiple copies of income.
Creation, opening buy and graduation can share a receipt. Graduation may appear before the final trade accounting event. Process the complete receipt before resolving final state rather than assuming one lifecycle action per transaction.