Blockchain Events
Query historical blockchain events from the Thetanuts protocol using the client.events module.
Methods
getOrderFillEvents(filters?)
OptionBook order fill events
No
getOrderCancelledEvents(filters?)
OptionBook order cancellation events
No
getOptionCreatedEvents(filters?)
New option contract creation events
No
getQuotationRequestedEvents(filters?)
RFQ quotation request events
No
getOfferMadeEvents(filters?)
RFQ encrypted offer submission events
No
getOfferRevealedEvents(filters?)
RFQ offer reveal events
No
getQuotationSettledEvents(filters?)
RFQ quotation settlement events
No
getPositionClosedEvents(option, filters?)
Position close events for a specific option
No
getExcessCollateralReturnedEvents(option, filters?)
Excess collateral returned to seller (per option)
No
getOptionSplitEvents(option, filters?)
Position split events (per option)
No
getTransferApprovalEvents(option, filters?)
Transfer-approval events (per option)
No
getOptionSettlementFailedEvents(option, filters?)
Settlement failures (per option)
No
v0.2.1 rename:
getCollateralReturnedEventswas renamed togetExcessCollateralReturnedEventsand the event field shape changed to match the r12 contract ({ seller, collateralToken, collateralReturned }). See the Migration Guide for the full diff.
All event queries auto-chunk block ranges into 10,000-block segments — no manual splitting needed.
When
fromBlockis omitted, the query searches backward from the latest block (most recent events first).
Usage
Filter Common Parameters
Most event methods accept an optional filters object:
Order Fill Events (OptionBook)
Order Cancellation Events
Option Created Events (RFQ Settlement)
RFQ Lifecycle Events
Track the full RFQ lifecycle — from request through offer submission, reveal, and final settlement:
Full RFQ History in One Call
getRfqHistory(quotationId, filters?) is a convenience that batches the four RFQ-lifecycle event queries (requested, offerMade, offerRevealed, settled) for a single quotation and returns them sorted in chronological order. Skips the bookkeeping you'd do manually:
queryEvents — generic catch-all
If you need to scan the OptionBook or OptionFactory ABIs for an arbitrary event signature not covered by a typed helper, fall through to queryEvents:
Most users should reach for the typed helpers above. queryEvents is the escape hatch for protocol introspection or custom indexers.
Using OfferMade Events for Early Settlement
The getOfferMadeEvents() result includes the encrypted offer data needed for settleQuotationEarly():
Position Closed Events
Query close events for a specific option contract:
See Also
WebSocket — real-time updates instead of historical queries
Position Management — position state queries via contract calls
Error Handling —
HTTP_ERROR,CONTRACT_REVERTerror codes
Last updated

