Doc reference
Class: WSClient
This class includes all the functionality related to interacting with a Mesh JSON RPC websocket endpoint.
Hierarchy
WSClient
Index
Constructors
Methods
Constructors
constructor
+ new WSClient(url: string, wsOpts?: WSOpts): WSClient
Defined in ws_client.ts:252
Instantiates a new WSClient instance
Parameters:
Name
Type
Description
url
string
WS server endpoint
wsOpts?
WebSocket options
Returns: WSClient
An instance of WSClient
Methods
addOrdersAsync
▸ addOrdersAsync(signedOrders: SignedOrder[], pinned: boolean): Promise<ValidationResults>
Defined in ws_client.ts:281
Adds an array of 0x signed orders to the Mesh node.
Parameters:
Name
Type
Default
Description
signedOrders
SignedOrder[]
-
signedOrders to add
pinned
boolean
true
Whether or not the orders should be pinned. Pinned orders will not be affected by any DDoS prevention or incentive mechanisms and will always stay in storage until they are no longer fillable.
Returns: Promise<ValidationResults>
validation results
destroy
▸ destroy(): void
Defined in ws_client.ts:417
destroy unsubscribes all active subscriptions, closes the websocket connection and stops the internal heartbeat connection liveness check.
Returns: void
getOrdersAsync
▸ getOrdersAsync(perPage: number): Promise<GetOrdersResponse>
Defined in ws_client.ts:311
Get all 0x signed orders currently stored in the Mesh node
Parameters:
Name
Type
Default
Description
perPage
number
200
number of signedOrders to fetch per paginated request
Returns: Promise<GetOrdersResponse>
the snapshotID, snapshotTimestamp and all orders, their hashes and fillableTakerAssetAmounts
getOrdersForPageAsync
▸ getOrdersForPageAsync(page: number, perPage: number, snapshotID?: undefined | string): Promise<GetOrdersResponse>
Defined in ws_client.ts:342
Get page of 0x signed orders stored on the Mesh node at the specified snapshot
Parameters:
Name
Type
Default
Description
page
number
-
Page index at which to retrieve orders
perPage
number
200
number of signedOrders to fetch per paginated request
snapshotID?
undefined | string
-
The DB snapshot at which to fetch orders. If omitted, a new snapshot is created
Returns: Promise<GetOrdersResponse>
the snapshotID, snapshotTimestamp and all orders, their hashes and fillableTakerAssetAmounts
getStatsAsync
▸ getStatsAsync(): Promise<GetStatsResponse>
Defined in ws_client.ts:302
Returns: Promise<GetStatsResponse>
onClose
▸ onClose(cb: function): void
Defined in ws_client.ts:399
Get notified when the underlying WS connection closes normally. If it closes with an error, WSClient automatically attempts to re-connect without emitting a close event.
Parameters:
▪ cb: function
callback to call when WS connection closes
▸ (): void
Returns: void
onReconnected
▸ onReconnected(cb: function): void
Defined in ws_client.ts:408
Get notified when a connection to the underlying WS connection is re-established
Parameters:
▪ cb: function
callback to call with the error when it occurs
▸ (): void
Returns: void
subscribeToOrdersAsync
▸ subscribeToOrdersAsync(cb: function): Promise<string>
Defined in ws_client.ts:359
Subscribe to the 'orders' topic and receive order events from Mesh. This method returns a subscriptionId that can be used to unsubscribe() from this subscription.
Parameters:
▪ cb: function
callback function where you'd like to get notified about order events
▸ (orderEvents: OrderEvent[]): void
Parameters:
Name
Type
orderEvents
Returns: Promise<string>
subscriptionId
unsubscribeAsync
▸ unsubscribeAsync(subscriptionId: string): Promise<void>
Defined in ws_client.ts:389
Unsubscribe from a subscription
Parameters:
Name
Type
Description
subscriptionId
string
identifier of the subscription to cancel
Returns: Promise<void>
Enumeration: ContractEventKind
Index
Enumeration members
Enumeration members
ERC1155ApprovalForAllEvent
• ERC1155ApprovalForAllEvent: = "ERC1155ApprovalForAllEvent"
Defined in types.ts:222
ERC1155TransferBatchEvent
• ERC1155TransferBatchEvent: = "ERC1155TransferBatchEvent"
Defined in types.ts:224
ERC1155TransferSingleEvent
• ERC1155TransferSingleEvent: = "ERC1155TransferSingleEvent"
Defined in types.ts:223
ERC20ApprovalEvent
• ERC20ApprovalEvent: = "ERC20ApprovalEvent"
Defined in types.ts:218
ERC20TransferEvent
• ERC20TransferEvent: = "ERC20TransferEvent"
Defined in types.ts:217
ERC721ApprovalEvent
• ERC721ApprovalEvent: = "ERC721ApprovalEvent"
Defined in types.ts:220
ERC721ApprovalForAllEvent
• ERC721ApprovalForAllEvent: = "ERC721ApprovalForAllEvent"
Defined in types.ts:221
ERC721TransferEvent
• ERC721TransferEvent: = "ERC721TransferEvent"
Defined in types.ts:219
ExchangeCancelEvent
• ExchangeCancelEvent: = "ExchangeCancelEvent"
Defined in types.ts:226
ExchangeCancelUpToEvent
• ExchangeCancelUpToEvent: = "ExchangeCancelUpToEvent"
Defined in types.ts:227
ExchangeFillEvent
• ExchangeFillEvent: = "ExchangeFillEvent"
Defined in types.ts:225
WethDepositEvent
• WethDepositEvent: = "WethDepositEvent"
Defined in types.ts:228
WethWithdrawalEvent
• WethWithdrawalEvent: = "WethWithdrawalEvent"
Defined in types.ts:229
Enumeration: OrderEventEndState
Index
Enumeration members
Enumeration members
Added
• Added: = "ADDED"
Defined in types.ts:286
Cancelled
• Cancelled: = "CANCELLED"
Defined in types.ts:289
Expired
• Expired: = "EXPIRED"
Defined in types.ts:290
FillabilityIncreased
• FillabilityIncreased: = "FILLABILITY_INCREASED"
Defined in types.ts:294
Filled
• Filled: = "FILLED"
Defined in types.ts:287
FullyFilled
• FullyFilled: = "FULLY_FILLED"
Defined in types.ts:288
Invalid
• Invalid: = "INVALID"
Defined in types.ts:285
StoppedWatching
• StoppedWatching: = "STOPPED_WATCHING"
Defined in types.ts:292
Unexpired
• Unexpired: = "UNEXPIRED"
Defined in types.ts:291
Unfunded
• Unfunded: = "UNFUNDED"
Defined in types.ts:293
Enumeration: RejectedCode
Index
Enumeration members
Enumeration members
InternalError
• InternalError: = "InternalError"
Defined in types.ts:358
MaxOrderSizeExceeded
• MaxOrderSizeExceeded: = "MaxOrderSizeExceeded"
Defined in types.ts:359
NetworkRequestFailed
• NetworkRequestFailed: = "NetworkRequestFailed"
Defined in types.ts:362
OrderAlreadyStored
• OrderAlreadyStored: = "OrderAlreadyStored"
Defined in types.ts:360
OrderCancelled
• OrderCancelled: = "OrderCancelled"
Defined in types.ts:367
OrderExpired
• OrderExpired: = "OrderExpired"
Defined in types.ts:365
OrderForIncorrectChain
• OrderForIncorrectChain: = "OrderForIncorrectChain"
Defined in types.ts:361
OrderFullyFilled
• OrderFullyFilled: = "OrderFullyFilled"
Defined in types.ts:366
OrderHasInvalidMakerAssetAmount
• OrderHasInvalidMakerAssetAmount: = "OrderHasInvalidMakerAssetAmount"
Defined in types.ts:363
OrderHasInvalidMakerAssetData
• OrderHasInvalidMakerAssetData: = "OrderHasInvalidMakerAssetData"
Defined in types.ts:369
OrderHasInvalidSignature
• OrderHasInvalidSignature: = "OrderHasInvalidSignature"
Defined in types.ts:371
OrderHasInvalidTakerAssetAmount
• OrderHasInvalidTakerAssetAmount: = "OrderHasInvalidTakerAssetAmount"
Defined in types.ts:364
OrderHasInvalidTakerAssetData
• OrderHasInvalidTakerAssetData: = "OrderHasInvalidTakerAssetData"
Defined in types.ts:370
OrderUnfunded
• OrderUnfunded: = "OrderUnfunded"
Defined in types.ts:368
Enumeration: RejectedKind
Index
Enumeration members
Enumeration members
MeshError
• MeshError: = "MESH_ERROR"
Defined in types.ts:353
MeshValidation
• MeshValidation: = "MESH_VALIDATION"
Defined in types.ts:354
ZeroexValidation
• ZeroexValidation: = "ZEROEX_VALIDATION"
Defined in types.ts:352
Interface: AcceptedOrderInfo
Hierarchy
AcceptedOrderInfo
Index
Properties
Properties
fillableTakerAssetAmount
• fillableTakerAssetAmount: BigNumber
Defined in types.ts:335
isNew
• isNew: boolean
Defined in types.ts:336
orderHash
• orderHash: string
Defined in types.ts:333
signedOrder
• signedOrder: SignedOrder
Defined in types.ts:334
Interface: ClientConfig
WebSocketClient configs Source: https://github.com/theturtle32/WebSocket-Node/blob/master/docs/WebSocketClient.md#client-config-options
Hierarchy
ClientConfig
Index
Properties
Properties
Optional assembleFragments
Optional assembleFragments• assembleFragments? : undefined | false | true
Defined in types.ts:16
Optional closeTimeout
Optional closeTimeout• closeTimeout? : undefined | number
Defined in types.ts:17
Optional fragmentOutgoingMessages
Optional fragmentOutgoingMessages• fragmentOutgoingMessages? : undefined | false | true
Defined in types.ts:14
Optional fragmentationThreshold
Optional fragmentationThreshold• fragmentationThreshold? : undefined | number
Defined in types.ts:15
Optional maxReceivedFrameSize
Optional maxReceivedFrameSize• maxReceivedFrameSize? : undefined | number
Defined in types.ts:12
Optional maxReceivedMessageSize
Optional maxReceivedMessageSize• maxReceivedMessageSize? : undefined | number
Defined in types.ts:13
Optional tlsOptions
Optional tlsOptions• tlsOptions? : any
Defined in types.ts:18
Optional webSocketVersion
Optional webSocketVersion• webSocketVersion? : undefined | number
Defined in types.ts:11
Interface: ContractEvent
Hierarchy
ContractEvent
Index
Properties
Properties
address
• address: string
Defined in types.ts:279
blockHash
• blockHash: string
Defined in types.ts:274
isRemoved
• isRemoved: string
Defined in types.ts:278
kind
• kind: ContractEventKind
Defined in types.ts:280
logIndex
• logIndex: number
Defined in types.ts:277
parameters
• parameters: ContractEventParameters
Defined in types.ts:281
txHash
• txHash: string
Defined in types.ts:275
txIndex
• txIndex: number
Defined in types.ts:276
Interface: ERC1155ApprovalForAllEvent
Hierarchy
ERC1155ApprovalForAllEvent
Index
Properties
Properties
approved
• approved: boolean
Defined in types.ts:144
operator
• operator: string
Defined in types.ts:143
owner
• owner: string
Defined in types.ts:142
Interface: ERC1155TransferBatchEvent
Hierarchy
ERC1155TransferBatchEvent
Index
Properties
Properties
from
• from: string
Defined in types.ts:127
ids
• ids: BigNumber[]
Defined in types.ts:129
operator
• operator: string
Defined in types.ts:126
to
• to: string
Defined in types.ts:128
values
• values: BigNumber[]
Defined in types.ts:130
Interface: ERC1155TransferSingleEvent
Hierarchy
ERC1155TransferSingleEvent
Index
Properties
Properties
from
• from: string
Defined in types.ts:111
id
• id: BigNumber
Defined in types.ts:113
operator
• operator: string
Defined in types.ts:110
to
• to: string
Defined in types.ts:112
value
• value: BigNumber
Defined in types.ts:114
Interface: ERC20ApprovalEvent
Hierarchy
ERC20ApprovalEvent
Index
Properties
Properties
owner
• owner: string
Defined in types.ts:68
spender
• spender: string
Defined in types.ts:69
value
• value: BigNumber
Defined in types.ts:70
Interface: ERC20TransferEvent
Hierarchy
ERC20TransferEvent
Index
Properties
Properties
from
• from: string
Defined in types.ts:56
to
• to: string
Defined in types.ts:57
value
• value: BigNumber
Defined in types.ts:58
Interface: ERC721ApprovalEvent
Hierarchy
ERC721ApprovalEvent
Index
Properties
Properties
approved
• approved: string
Defined in types.ts:93
owner
• owner: string
Defined in types.ts:92
tokenId
• tokenId: BigNumber
Defined in types.ts:94
Interface: ERC721ApprovalForAllEvent
Hierarchy
ERC721ApprovalForAllEvent
Index
Properties
Properties
approved
• approved: boolean
Defined in types.ts:106
operator
• operator: string
Defined in types.ts:105
owner
• owner: string
Defined in types.ts:104
Interface: ERC721TransferEvent
Hierarchy
ERC721TransferEvent
Index
Properties
Properties
from
• from: string
Defined in types.ts:80
to
• to: string
Defined in types.ts:81
tokenId
• tokenId: BigNumber
Defined in types.ts:82
Interface: ExchangeCancelEvent
Hierarchy
ExchangeCancelEvent
Index
Properties
Properties
feeRecipientAddress
• feeRecipientAddress: string
Defined in types.ts:178
makerAddress
• makerAddress: string
Defined in types.ts:176
makerAssetData
• makerAssetData: string
Defined in types.ts:180
orderHash
• orderHash: string
Defined in types.ts:179
senderAddress
• senderAddress: string
Defined in types.ts:177
takerAssetData
• takerAssetData: string
Defined in types.ts:181
Interface: ExchangeCancelUpToEvent
Hierarchy
ExchangeCancelUpToEvent
Index
Properties
Properties
makerAddress
• makerAddress: string
Defined in types.ts:185
orderEpoch
• orderEpoch: BigNumber
Defined in types.ts:187
senderAddress
• senderAddress: string
Defined in types.ts:186
Interface: ExchangeFillEvent
Hierarchy
ExchangeFillEvent
Index
Properties
Properties
feeRecipientAddress
• feeRecipientAddress: string
Defined in types.ts:151
makerAddress
• makerAddress: string
Defined in types.ts:148
makerAssetData
• makerAssetData: string
Defined in types.ts:157
makerAssetFilledAmount
• makerAssetFilledAmount: BigNumber
Defined in types.ts:152
makerFeePaid
• makerFeePaid: BigNumber
Defined in types.ts:154
orderHash
• orderHash: string
Defined in types.ts:156
senderAddress
• senderAddress: string
Defined in types.ts:150
takerAddress
• takerAddress: string
Defined in types.ts:149
takerAssetData
• takerAssetData: string
Defined in types.ts:158
takerAssetFilledAmount
• takerAssetFilledAmount: BigNumber
Defined in types.ts:153
takerFeePaid
• takerFeePaid: BigNumber
Defined in types.ts:155
Interface: GetOrdersResponse
Hierarchy
GetOrdersResponse
Index
Properties
Properties
ordersInfos
• ordersInfos: OrderInfo[]
Defined in types.ts:415
snapshotID
• snapshotID: string
Defined in types.ts:413
snapshotTimestamp
• snapshotTimestamp: number
Defined in types.ts:414
Interface: GetStatsResponse
Hierarchy
GetStatsResponse