Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Incompatibility between `@flashbots/ethers-provider-bundle` (v1.x.x) and ethers (v6.x.x)

Open
#615 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
35/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Stale
Tech stack
node.js, typescript
Domain
blockchain

Research direction

Start with the package.json dependency versions and the import of FlashbotsBundleProvider, then reproduce the failure using the reported ethers, @flashbots/ethers-provider-bundle, and Node.js versions. Inspect node_modules/@flashbots/ethers-provider-bundle/build/index.js and confirm that a supported setup initializes without the @ethersproject/web module-not-found error.

Written by the indexing model from the issue text.

Description

I found an incompatibility issue when using @flashbots/ethers-provider-bundle version 1.x.x with ethers version 6.x.x, resulting in a module not found error.

Component: @flashbots/ethers-provider-bundle

Steps to reproduce bug:

  1. Set up a Node.js project with ethers v6.x.x and @flashbots/ethers-provider-bundle v1.x.x installed as dependencies in package.json.
  2. Write or use existing TypeScript/JavaScript code that imports and attempts to initialize FlashbotsBundleProvider from @flashbots/ethers-provider-bundle.
  3. Run the code or tests that involve this import and initialization.

Expected behavior:

The FlashbotsBundleProvider should be imported and initialized successfully without errors when used with a compatible version of ethers v6, as indicated by the Flashbots library documentation for v1.x.x.

Actual behavior:

When running the code, the following error occurs:

Cannot find module '@ethersproject/web' from 'node_modules/@flashbots/ethers-provider-bundle/build/index.js'

This error indicates that the Flashbots library is attempting to import a module (@ethersproject/web) that is part of the ethers v5 structure but is not present or has been moved/removed in ethers v6.

Version number:

  • ethers: ^6.11.1
  • @flashbots/ethers-provider-bundle: ^1.0.0 (the latest version)
  • Node.js: v20.18.1

Operating system:

Windows 11

Dominant language
TypeScript
Stars
245
Forks
198
PR merge metrics
No merged PRs in 30d

Getting set up

We have not checked this project's setup files yet. Start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from flashbots/flashbots-docs

All issues in flashbots/flashbots-docs

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.