Fix: A Missing .catch() That Crashes Your Entire Node.js Process (ethers.js WebSocket Provider)

This is a submission for DEV's Summer Bug Smash: Clear the Lineup powered by Sentry.

Project Overview

ethers.js is one of the most widely used Ethereum libraries, with over 3 million weekly downloads on npm. It provides the core infrastructure that thousands of dApps, wallets, and blockchain tools depend on for interacting with EVM chains.

I discovered a bug in the WebSocketProvider that causes uncatchable unhandled rejections — silently crashing production Node.js processes with no way for application code to intercept the error.

Bug Fix or Performance Improvement

Fix: A Missing .catch() That Crashes Your Entire Node.js Process (ethers.js WebSocket Provider)

Related reading

Bug Smash: restoring dropped Gemini chat config in Sentry's JavaScript SDK

Smash Stories: Mitigating Core EVM State Desyncs and Gas Latency Hurdles

Clear the Lineup: Eliminating an N+1 Query Bug to Boost API Performance by 6

Smashed: Eliminating Ghost Audio & YouTube IFrame Lifecycle Race Conditions in…

I Used Sentry to Expose a Silent Data-Loss Bug with Zero Errors

Sentry Saved Our Users When the API Melted: Fixing a Production-Stopping Schema…