Events and Errors
OrderFulfilled
event OrderFulfilled(bytes32 orderHash, address offerer, address zone, address recipient, struct SpentItem[] offer, struct ReceivedItem[] consideration)
Emit an event whenever an order is successfully fulfilled.
Name | Type | Description |
---|---|---|
orderHash | bytes32 | The hash of the fulfilled order. |
offerer | address | The offerer of the fulfilled order. |
zone | address | The zone of the fulfilled order. |
recipient | address | The recipient of each spent item on the fulfilled order, or the null address if there is no specific fulfiller (i.e. the order is part of a group of orders). Defaults to the caller unless explicitly specified otherwise by the fulfiller. |
offer | struct SpentItem[] | The offer items spent as part of the order. |
consideration | struct ReceivedItem[] | The consideration items received as part of the order along with the recipients of each item. |
OrderCancelled
event OrderCancelled(bytes32 orderHash, address offerer, address zone)
Emit an event whenever an order is successfully cancelled.
Name | Type | Description |
---|---|---|
orderHash | bytes32 | The hash of the cancelled order. |
offerer | address | The offerer of the cancelled order. |
zone | address | The zone of the cancelled order. |
OrderValidated
event OrderValidated(bytes32 orderHash, address offerer, address zone)
Emit an event whenever an order is explicitly validated. Note that this event will not be emitted on partial fills even though they do validate the order as part of partial fulfillment.
Name | Type | Description |
---|---|---|
orderHash | bytes32 | The hash of the validated order. |
offerer | address | The offerer of the validated order. |
zone | address | The zone of the validated order. |
CounterIncremented
event CounterIncremented(uint256 newCounter, address offerer)
Emit an event whenever a counter for a given offerer is incremented.
Name | Type | Description |
---|---|---|
newCounter | uint256 | The new counter for the offerer. |
offerer | address | The offerer in question. |
OrdersMatched
event OrdersMatched(bytes32[] orderHashes)
Emit an event whenever one or more orders are matched using either matchOrders or matchAdvancedOrders.
Name | Type | Description |
---|---|---|
orderHashes | bytes32[] | The order hashes of the matched orders. |
OrderAlreadyFilled
error OrderAlreadyFilled(bytes32 orderHash)
Revert with an error when attempting to fill an order that has already been fully filled.
Name | Type | Description |
---|---|---|
orderHash | bytes32 | The order hash on which a fill was attempted. |
InvalidTime
error InvalidTime()
Revert with an error when attempting to fill an order outside the specified start time and end time.
InvalidConduit
error InvalidConduit(bytes32 conduitKey, address conduit)
Revert with an error when attempting to fill an order referencing an invalid conduit (i.e. one that has not been deployed).
MissingOriginalConsiderationItems
error MissingOriginalConsiderationItems()
Revert with an error when an order is supplied for fulfillment with a consideration array that is shorter than the original array.
InvalidCallToConduit
error InvalidCallToConduit(address conduit)
Revert with an error when a call to a conduit fails with revert data that is too expensive to return.
ConsiderationNotMet
error ConsiderationNotMet(uint256 orderIndex, uint256 considerationIndex, uint256 shortfallAmount)
Revert with an error if a consideration amount has not been fully zeroed out after applying all fulfillments.
Name | Type | Description |
---|---|---|
orderIndex | uint256 | The index of the order with the consideration item with a shortfall. |
considerationIndex | uint256 | The index of the consideration item on the order. |
shortfallAmount | uint256 | The unfulfilled consideration amount. |
InsufficientEtherSupplied
error InsufficientEtherSupplied()
Revert with an error when insufficient ether is supplied as part of msg.value when fulfilling orders.
EtherTransferGenericFailure
error EtherTransferGenericFailure(address account, uint256 amount)
Revert with an error when an ether transfer reverts.
PartialFillsNotEnabledForOrder
error PartialFillsNotEnabledForOrder()
Revert with an error when a partial fill is attempted on an order that does not specify partial fill support in its order type.
OrderIsCancelled
error OrderIsCancelled(bytes32 orderHash)
Revert with an error when attempting to fill an order that has been cancelled.
Name | Type | Description |
---|---|---|
orderHash | bytes32 | The hash of the cancelled order. |
OrderPartiallyFilled
error OrderPartiallyFilled(bytes32 orderHash)
Revert with an error when attempting to fill a basic order that has been partially filled.
Name | Type | Description |
---|---|---|
orderHash | bytes32 | The hash of the partially used order. |
InvalidCanceller
error InvalidCanceller()
Revert with an error when attempting to cancel an order as a caller other than the indicated offerer or zone.
BadFraction
error BadFraction()
Revert with an error when supplying a fraction with a value of zero for the numerator or denominator, or one where the numerator exceeds the denominator.
InvalidMsgValue
error InvalidMsgValue(uint256 value)
Revert with an error when a caller attempts to supply callvalue to a non-payable basic order route or does not supply any callvalue to a payable basic order route.
InvalidBasicOrderParameterEncoding
error InvalidBasicOrderParameterEncoding()
Revert with an error when attempting to fill a basic order using calldata not produced by default ABI encoding.
NoSpecifiedOrdersAvailable
error NoSpecifiedOrdersAvailable()
Revert with an error when attempting to fulfill any number of available orders when none are fulfillable.
InvalidNativeOfferItem
error InvalidNativeOfferItem()
Revert with an error when attempting to fulfill an order with an offer for ETH outside of matching orders.
Updated 7 months ago