Reference / Events & errors
Events & errors
What to subscribe to, what reverts mean.
Events
Subscribe to these to react in real time instead of polling. Indexed fields let you filter by listing id or address.
| Event | Fires when |
|---|---|
| SellerRegistered(seller, name) | a new seller profile is created |
| ProfileUpdated(seller) / AvailabilityChanged(seller, active) | a profile changes |
| ListingCreated(listingId, seller, kind, platform, handle, price) | something is listed |
| ListingUpdated(listingId) / ListingDelisted(listingId) | a listing is edited, relisted or hidden |
| ListingBought(listingId, buyer, price) | a buyer pays; USDG enters escrow |
| ListingDelivered(listingId, deliveryURI) | the handover is posted; review window starts |
| ListingSold(listingId, seller, sellerAmount, feeAmount) | settlement: confirmation, auto-claim or dispute release |
| PurchaseRefunded(listingId, buyer) | refund via timeout, cancel or dispute |
| DisputeRaised(listingId, buyer, reason) / DisputeResolved(listingId, releasedToSeller) | a dispute opens or is settled by the platform |
| ListingBoosted(listingId, booster, amount, totalBoost) | $AKA is spent boosting a listing |
| SellerRated(listingId, seller, rating, review) | the buyer rates a completed sale, optionally with a written review |
| ListingMessage(listingId, sender, text) | someone posts to a listing's public Q&A thread — events only, read it back with getLogs |
| BoostTokenUpdated / FeeUpdated / TreasuryUpdated / ReviewPeriodUpdated / DeliveryPeriodUpdated | admin changes |
Custom errors
| Error | Meaning |
|---|---|
| NotRegistered / AlreadyRegistered | seller profile required, or profile already exists |
| NotSeller / NotBuyer | you are not the right party for this call |
| WrongStatus | the listing is not in a state that allows this action |
| ReviewPeriodNotOver | claimPayment called before the 3-day review window elapsed |
| DeliveryPeriodNotOver | refundPurchase called before the 3-day delivery window elapsed |
| Disputed | auto-claim is frozen, or a dispute is already open |
| NotDisputed | resolveDispute called with no open dispute |
| AlreadyRated | one rating per completed sale |
| BoostDisabled | boost called before the $AKA token is plugged in |
| InvalidParams | zero price, empty kind, platform or title, buying your own listing, empty message or review / message over 500 chars, nonexistent listing id, out-of-bounds fee or period… |