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 |
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 |
Vault
| Event | Emitted when |
|---|---|
DistributorSet(distributor) | Destination chosen (still changeable) |
DistributorFrozen(distributor) | Destination made permanent |
TrancheReleased(index, amount, remaining) | A tranche moved to the distributor |
| Error | Meaning |
|---|---|
DistributorNotFrozen | A release was attempted before the freeze |
NotAContract | The destination must be a contract, not a wallet |
VaultEmpty | Nothing left to release |
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 CVN |
| 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 |