Skip to main content

Events & errors

Bonds​

EventEmitted 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
ErrorMeaning
CommitTooSmallBelow the 20% floor
CommitExceedsBalanceAbove the caller's balance
OriginMismatchA merge tried to mix sell-side and commit bonds
BoostMismatchA merge tried to mix a live boost with a forfeited one
NothingPendingNothing to harvest
UnauthorizedOnly the retention source may open sell-side bonds

Hook​

EventEmitted 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
ErrorMeaning
UnalignedLaunchTickThe launch price is off the tick grid
UnexpectedPoolPriceThe price moved between initialize and seed
PartialFillNotSupportedThe sell only partly executed
ExactOutputNotSupportedExact-output orders are refused
ExternalLiquidityBlockedOnly the hook may provide liquidity

Token​

EventEmitted when
BondsSet(bonds)The bonds contract is wired; from then on every outbound transfer is reported to it