Events & errors
Bonds
| Event | Emitted when |
|---|---|
BondOpened(tokenId, owner, amount, rateBps, origin) | A bond is opened, from either path. rateBps is the effective entry rate: 1500 (15%/day) for a commit bond, 1000 (10%/day) for a sell-side one. |
BoostDied(tokenId) | Once per bond, when a forfeited boost is materialised into it |
RateFloorSet(bps) | The deploying key lifted, changed or cleared the floor under every bond's daily rate |
ExemptionGranted(wallet, tokenId, amount) | A new bond granted its first holder retention-free selling volume, 5x the principal it opened with. Once per bond, never again |
ExemptionConsumed(seller, amount) | An exempt sale was charged against the seller's lifetime allowance |
Compounded(tokenId, amount, principal, rateBps) | Rewards rolled in; carries the new stored rate |
Claimed(tokenId, to, amount, stillPending) | Rewards paid out |
PoolExhausted(tokenId, requested, paid) | The pool could not cover a claim in full |
| Error | Meaning |
|---|---|
CommitTooSmall | Below the 20% floor |
CommitExceedsBalance | Above the caller's balance |
OriginMismatch | A merge tried to mix sell-side and commit bonds |
BoostMismatch | A merge tried to mix a live boost with a forfeited one |
NothingPending | Nothing to harvest |
Unauthorized | Only the retention source may open sell-side bonds |
Hook
| Event | Emitted when |
|---|---|
CovenantPoolBound(poolId, token) | The canonical pool is bound |
LiquiditySeeded(seeder, ethAmount, tokenAmount) | The launch band is funded |
TaxCollected(payer, isBuy, ethAmount) | Tax taken on a trade |
RouterSet(router) | The official router is wired — one of the two ways a seller is vouched for; the other is their own outgoing C4 |
| Error | Meaning |
|---|---|
UnalignedLaunchTick | The launch price is off the tick grid |
UnexpectedPoolPrice | The price moved between initialize and seed |
PartialFillNotSupported | The sell only partly executed |
ExactOutputNotSupported | Exact-output orders are refused |
ExternalLiquidityBlocked | Only the hook may provide liquidity |
Token
| Event | Emitted when |
|---|---|
BondsSet(bonds) | The bonds contract is wired; from then on every outbound transfer is reported to it |