Event Reference

4.3 Event Reference

This section defines all relevant emitted events across core contracts.

Events are the primary observable interface for:

• Indexers • Analytics systems • Auditors • Monitoring dashboards

All state transitions of significance emit events.

---

I. RecyclingEngine Events

---

Recycled(address user, address token, uint256 nativeIn, uint256 weightMinted)

Emitted when:

recycle(token)

succeeds.

Guarantees:

• Units were consumed • Native was routed • Weight was minted • accNativePerWeight may have increased

Does NOT guarantee:

• Profit • Future claimable value

Used for:

• Volume analytics • Weight growth tracking

---

Claimed(address user, uint256 amountWei)

Emitted when:

claim()

succeeds.

Guarantees:

• Native was transferred • rewardDebt updated

Does NOT guarantee:

• Net gain • Economic return

---

ParamsSet(...)

Emitted when owner or governance updates engine parameters.

Guarantees:

• Parameter change occurred • Previous value replaced

Used for:

• Governance monitoring • Parameter history tracking

---

OwnershipTransferred(address previousOwner, address newOwner)

Standard ownership transfer event.

Guarantees:

• Control state changed

Used for:

• Admin risk monitoring • Governance migration tracking

---

II. SponsorshipLedger Events

---

Sponsored(address provider, address beneficiary, address token, uint256 units)

Emitted when:

sponsor(...)

succeeds.

Guarantees:

• ERC-20 transferred to BlackHole • Units credited • Ledger updated

Does NOT guarantee:

• Future distribution • Immediate economic benefit

---

Consumed(address beneficiary, address token, uint256 units)

Emitted when:

Units are consumed during recycle.

Guarantees:

• Ledger unit balance reduced

Used to:

• Reconstruct unit flow • Validate recycle input

---

III. RecycleAssetRegistry Events

---

AssetSet(address token, bool enabled, uint256 unitsPer1e18Native, uint256 capUnits)

Emitted when asset parameters are updated.

Guarantees:

• Registry state changed

Used for:

• Tracking token eligibility • Monitoring cap changes

---

IV. Router Events (If Implemented)

---

RailsSet(...)

Emitted when rail percentages are updated.

Guarantees:

• Fee split changed

Used for:

• Monitoring fee topology • Detecting routing shifts

---

V. Fund Events

---

SharesMinted(address to, uint256 amount)

If implemented.

Guarantees:

• Share ledger updated

---

Distributed(uint256 amount)

If implemented.

Guarantees:

• Treasury distribution occurred

---

OwnershipTransferred(...)

Indicates governance transfer to Timelock.

Critical for decentralization verification.

---

VI. Governor Events

---

ProposalCreated(...)

Emitted when proposal is submitted.

Guarantees:

• Governance proposal registered

---

VoteCast(...)

Emitted during voting.

Guarantees:

• Vote weight recorded

---

ProposalQueued(...)

Indicates successful vote.

---

ProposalExecuted(...)

Indicates state change executed via Timelock.

---

VII. Event Reconstruction Model

Full recycle cycle reconstruction requires:

1. Sponsored

2. Consumed

3. Recycled

4. Claimed

Using these events, indexers can:

• Reconstruct ledger • Reconstruct weight distribution • Track native flow

No hidden mutation occurs without event emission.

---

VIII. Event Integrity Guarantees

All critical state changes emit events.

There are no silent:

• Weight mints • Unit burns • Rail splits • Treasury actions

Event absence implies no state change.

---

IX. Monitoring Strategy

To monitor the system:

Track:

• Recycled • Claim • Sponsored • AssetSet • OwnershipTransferred • ProposalExecuted

These form the minimum viable monitoring set.