@exodus/bitcoin-api 4.15.0 → 4.15.2

package/CHANGELOG.md

@@ -3,6 +3,26 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [4.15.2](https://github.com/ExodusMovement/assets/compare/@exodus/bitcoin-api@4.15.1...@exodus/bitcoin-api@4.15.2) (2026-05-27)
+
+
+### Bug Fixes
+
+
+* fix: reconnect mempool websocket on missed pong (#8141)
+
+
+
+## [4.15.1](https://github.com/ExodusMovement/assets/compare/@exodus/bitcoin-api@4.15.0...@exodus/bitcoin-api@4.15.1) (2026-05-19)
+
+
+### Bug Fixes
+
+
+* fix: block btc empty-output transactions (#8086)
+
+
+
 ## [4.15.0](https://github.com/ExodusMovement/assets/compare/@exodus/bitcoin-api@4.14.7...@exodus/bitcoin-api@4.15.0) (2026-05-18)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/bitcoin-api",
-  "version": "4.15.0",
+  "version": "4.15.2",
   "description": "Bitcoin transaction and fee monitors, RPC with the blockchain node, other networking code.",
   "type": "module",
   "main": "src/index.js",
@@ -63,5 +63,5 @@
     "type": "git",
     "url": "git+https://github.com/ExodusMovement/assets.git"
   },
-  "gitHead": "266396ec25f5aa6ce87887d0df7f0e882e83f1aa"
+  "gitHead": "c5d3a519f291e17f6b95cb0804e6d86d71be1dd8"
 }

package/src/insight-api-client/mempool-ws-client.js

@@ -3,6 +3,7 @@ import EventEmitter from 'eventemitter3'
 const DEFAULT_RECONNECTION_DELAY = 10_000
 const DEFAULT_RECONNECTION_DELAY_MAX = 30_000
 const DEFAULT_PING_INTERVAL = 25_000
+const DEFAULT_PONG_TIMEOUT = 10_000
 const BLOCK_SUBSCRIBED_ASSETS = new Set(['bitcoin', 'bitcoinregtest', 'bitcointestnet'])
 
 const toMessageString = (data) => {
@@ -45,6 +46,7 @@ const normalizeOptions = (assetName, opts = {}) => {
     reconnectionDelay: DEFAULT_RECONNECTION_DELAY,
     reconnectionDelayMax: DEFAULT_RECONNECTION_DELAY_MAX,
     pingIntervalMs: DEFAULT_PING_INTERVAL,
+    pongTimeoutMs: DEFAULT_PONG_TIMEOUT,
     subscribeBlocks: BLOCK_SUBSCRIBED_ASSETS.has(assetName),
     ...opts,
   }
@@ -62,6 +64,7 @@ export default class MempoolWSClient extends EventEmitter {
     this.reconnectAttempt = 0
     this.reconnectTimer = null
     this.pingInterval = null
+    this.pongTimeout = null
     this.closed = false
     this.socketListeners = null
     this.connected = false
@@ -104,12 +107,9 @@ export default class MempoolWSClient extends EventEmitter {
     }
 
     const onError = (event) => {
-      // Some runtimes can stall without close; explicitly close to trigger reconnect flow.
       if (this.socket !== socket || this.closed) return
       console.warn('mempool-ws-client socket error', event)
-      try {
-        socket.close()
-      } catch {}
+      this.#recycleSocket(socket)
     }
 
     const onClose = () => {
@@ -117,6 +117,7 @@ export default class MempoolWSClient extends EventEmitter {
       const wasConnected = this.connected
       this.connected = false
       this.#clearPing()
+      this.#clearPongTimeout()
       if (wasConnected) this.emit('disconnect')
       this.socket = null
       this.socketListeners = null
@@ -159,6 +160,7 @@ export default class MempoolWSClient extends EventEmitter {
     this.pingInterval = setInterval(() => {
       if (!this.socket || this.socket.readyState !== (this.WebSocketClass?.OPEN ?? 1)) return
       this.#send(this.socket, { action: 'ping' })
+      this.#startPongTimeout(this.socket)
     }, intervalMs)
   }
 
@@ -168,6 +170,55 @@ export default class MempoolWSClient extends EventEmitter {
     this.pingInterval = null
   }
 
+  #startPongTimeout(socket) {
+    this.#clearPongTimeout()
+    const timeoutMs = this.options?.pongTimeoutMs
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) return
+
+    this.pongTimeout = setTimeout(() => {
+      if (this.socket !== socket || this.closed) return
+
+      console.warn('mempool-ws-client pong timeout')
+      this.#recycleSocket(socket)
+    }, timeoutMs)
+  }
+
+  #clearPongTimeout() {
+    if (!this.pongTimeout) return
+    clearTimeout(this.pongTimeout)
+    this.pongTimeout = null
+  }
+
+  #removeSocketListeners(socket) {
+    const listeners = this.socketListeners
+    this.socketListeners = null
+    if (!listeners) return
+
+    socket.removeEventListener('open', listeners.onOpen)
+    socket.removeEventListener('message', listeners.onMessage)
+    socket.removeEventListener('close', listeners.onClose)
+    socket.removeEventListener('error', listeners.onError)
+  }
+
+  #recycleSocket(socket) {
+    if (this.socket !== socket) return
+
+    const wasConnected = this.connected
+    this.connected = false
+    this.#clearPing()
+    this.#clearPongTimeout()
+    this.socket = null
+    this.#removeSocketListeners(socket)
+
+    if (wasConnected) this.emit('disconnect')
+    this.#scheduleReconnect()
+
+    try {
+      if (typeof socket.terminate === 'function') socket.terminate()
+      else socket.close()
+    } catch {}
+  }
+
   #send(socket, payload) {
     if (!socket || socket.readyState !== (this.WebSocketClass?.OPEN ?? 1)) return
 
@@ -202,6 +253,10 @@ export default class MempoolWSClient extends EventEmitter {
     const payload = tryParseJSON(rawData)
     if (!payload || typeof payload !== 'object') return
 
+    if (payload.pong === true) {
+      this.#clearPongTimeout()
+    }
+
     if (payload.block) {
       this.emit('block', payload.block)
     }
@@ -220,18 +275,12 @@ export default class MempoolWSClient extends EventEmitter {
     this.connected = false
     this.#clearReconnectTimer()
     this.#clearPing()
+    this.#clearPongTimeout()
 
     if (!this.socket) return
     const socket = this.socket
     this.socket = null
-    const listeners = this.socketListeners
-    this.socketListeners = null
-    if (listeners) {
-      socket.removeEventListener('open', listeners.onOpen)
-      socket.removeEventListener('message', listeners.onMessage)
-      socket.removeEventListener('close', listeners.onClose)
-      socket.removeEventListener('error', listeners.onError)
-    }
+    this.#removeSocketListeners(socket)
 
     socket.close()
     if (wasConnected) this.emit('disconnect')

package/src/tx-create/create-tx.js

@@ -261,6 +261,16 @@ function createChangeOutput({ selectedUtxos, totalAmount, fee, replaceTx, change
   return null
 }
 
+function assertTransactionHasOutputs({ outputs, bumpTxId }) {
+  if (outputs.length > 0) return
+
+  throw new Error(
+    bumpTxId
+      ? `Cannot bump transaction ${bumpTxId}: no spendable output after fees`
+      : 'Cannot create transaction without outputs'
+  )
+}
+
 async function createUnsignedTx({
   inputs,
   outputs,
@@ -480,6 +490,8 @@ const transferHandler = {
       changeAddress: context.changeAddress,
     })
 
+    assertTransactionHasOutputs({ outputs, bumpTxId })
+
     // Track our own outputs and their purposes. Today this is only the change
     // output; in the future we may add self-send primaries when applicable.
     const outputAddressPurposesMap = Object.create(null)