Static
defaultReturn the configuration for the orderbook module.
The configuration for the orderbook module.
Get an order by ID
The listingId to find.
The returned order result.
Get a trade by ID
The tradeId to find.
The returned order result.
List orders. This method is used to get a list of orders filtered by conditions specified in the params object.
Filtering, ordering and page parameters.
The paged orders.
List trades. This method is used to get a list of trades filtered by conditions specified in the params object
Filtering, ordering and page parameters.
The paged trades.
Get required transactions and messages for signing to facilitate creating bulk listings. Once the transactions are submitted and the message signed, call the completeListings method provided in the return type with the signature. This method supports up to 20 listing creations at a time. It can also be used for individual listings to simplify integration code paths.
Bulk listings created using an EOA (Metamask) will require a single listing confirmation signature. Bulk listings creating using a smart contract wallet will require multiple listing confirmation signatures(as many as the number of orders).
Details about the listings to be created.
PrepareListingResponse includes any unsigned approval transactions, the typed bulk order message for signing and the createListings method that can be called with the signature(s) to create the listings.
Get required transactions and messages for signing prior to creating a listing through the createListing method
Details about the listing to be created.
PrepareListingResponse includes
the unsigned approval transaction, the typed order message for signing and
the order components that can be submitted to createListing
with a signature.
Create an order
create an order with the given params.
The result of the order created in the Immutable services.
Get unsigned transactions that can be submitted to fulfil an open order. If the approval transaction exists it must be signed and submitted to the chain before the fulfilment transaction can be submitted or it will be reverted.
The listingId to fulfil.
The address of the account fulfilling the order.
Taker ecosystem fees to be paid.
Optional
amountToFill: stringAmount of the order to fill, defaults to sell item amount. Only applies to ERC1155 orders
Approval and fulfilment transactions.
Get unsigned transactions that can be submitted to fulfil multiple open orders. If approval transactions exist, they must be signed and submitted to the chain before the fulfilment transaction can be submitted or it will be reverted.
The details of the listings to fulfil, amounts to fill and taker ecosystem fees to be paid.
The address of the account fulfilling the order.
Approval and fulfilment transactions.
Cancelling orders is a gasless alternative to on-chain cancellation exposed with
cancelOrdersOnChain
. For the orderbook to authenticate the cancellation, the creator
of the orders must sign an EIP712 message containing the orderIds
The orderIds to attempt to cancel.
The signable action to cancel the orders.
Cancelling orders is a gasless alternative to on-chain cancellation exposed with
cancelOrdersOnChain
. Orders cancelled this way cannot be fulfilled and will be removed
from the orderbook. If there is pending fulfillment data outstanding for the order, its
cancellation will be pending until the fulfillment window has passed.
prepareOffchainOrderCancellations
can be used to get the signable action that is signed
to get the signature required for this call.
The orderIds to attempt to cancel.
The address of the account cancelling the orders.
The result of the off-chain cancellation request
Get an unsigned order cancellation transaction. Orders can only be cancelled by the account that created them. All of the orders must be from the same seaport contract. If trying to cancel orders from multiple seaport contracts, group the orderIds by seaport contract and call this method for each group.
The orderIds to cancel.
The address of the account cancelling the order.
The unsigned cancel order action
zkEVM orderbook SDK
Param: config
Configuration for Immutable services.