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.