Skip to content

1.13.0: mempool channel for pending Hyperliquid transactions - #25

Merged
0xFantomMenace merged 2 commits into
masterfrom
feat/mempool-channel
Oct 8, 2026
Merged

0xFantomMenace merged 2 commits into
masterfrom
feat/mempool-channel

Conversation

@0xFantomMenace

Copy link
Copy Markdown
Member

Adds the mempool WebSocket channel: signed Hyperliquid transactions as our Hyperliquid node receives them, before they are included in a block, for every Hyperliquid product.

  • STREAM_WS_URL (wss://stream.0xarchive.io/ws), the only endpoint that serves mempool.
  • subscribeMempool(symbol?), unsubscribeMempool(symbol?) and onMempool, with typed MempoolItem and Zod schemas. The symbol is optional: without one the subscription receives every pending transaction our node receives.
  • The capability table and Capability gain optional wsEndpoint and plans, set only on mempool.
  • Live only: replay is refused locally. Included with the Pro, Scale and Enterprise plans; other plans receive forbidden.

The live contract test expects the mempool row in /v1/capabilities, which the API serves from today.

- WebSocket channel `mempool`: signed Hyperliquid transactions before they
  are included in a block, on every Hyperliquid product. Live only, served
  on wss://stream.0xarchive.io/ws, with the Pro, Scale and Enterprise plans.
- ws.subscribeMempool(symbol?), ws.unsubscribeMempool(symbol?) and
  ws.onMempool(); the symbol is optional on this channel only.
- STREAM_WS_URL. A client on the default endpoint refuses a mempool
  subscription before sending; a mempool replay is always refused.
- Types MempoolItem, MempoolAction, MempoolSignature and WsMempoolData,
  with Zod schemas.
- wsEndpoint and plans on WsChannelCapability and Capability.
- Acks and data messages accept a null coin and symbol.
- Version 1.13.0.
… limit

State that the unfiltered stream carries the pending transactions our
Hyperliquid node receives, and that unfiltered subscriptions share a
server-wide capacity limit that does not apply to symbol subscriptions.
@0xFantomMenace
0xFantomMenace merged commit 51ae375 into master Oct 8, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant