OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Developer Tools

Headless WEB3 Provider

Headless WEB3 Provider is an open-source TypeScript library that emulates a Web3 wallet provider for automated testing of Ethereum applications. It lets tests inject a provider into a page or test environment and programmatically control supported wallet requests, including account access, network changes, signatures and transaction submission.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Headless WEB3 Provider — OpenViST project profile in Developer Tools.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use it when an Ethereum application test needs to control wallet-provider interactions without opening a wallet's visual interface.

Who it is for

  • Developers testing Ethereum dApps that interact with a Web3 wallet provider.
  • Teams building wallet-interaction end-to-end tests with Playwright or Jest.

Documented uses

  • Automate wallet connection and account-access flows.
  • Test acceptance or rejection of supported wallet operations.
  • Exercise network switching, network addition, signing and transaction requests in application tests.
Before you choose

Requirements & limits

  • The README documents Playwright and Jest examples, with different injection patterns for each.
  • The Playwright setup takes private keys, a chain ID and an Ethereum client JSON-RPC URL.
  • The method table marks wallet actions such as account requests and transaction submission as confirmable, while several read methods are non-confirmable.
  • Foundry Anvil is named as a complementary development-chain option; it is not the provider library itself.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Add a headless provider fixture to Playwright

Set up a Playwright fixture that injects the emulated provider into a page for wallet-interaction tests.

Before you start

  • Install headless-web3-provider as a development dependency.
  • Use Playwright's test fixture extension.
  • Provide test private keys, a chain ID and an Ethereum client's JSON-RPC URL.

Steps

  1. Install the package with the command below.

    Documented command
    npm i -D headless-web3-provider

  2. Extend the Playwright test fixture and define the signers from the test private key.

  3. Use injectHeadlessWeb3Provider to inject the provider into a page, passing the keys, chain ID and JSON-RPC URL.

  4. In a test, inject the provider, trigger a wallet request in the app, then authorize or reject it through the wallet object.

Expected outcome

A Playwright test can drive and assert a wallet interaction without a visual wallet interface.

Guide limitations

  • The example requires the test project to provide private keys and an Ethereum client endpoint.
  • The README lists some provider methods as non-confirmable, including eth_call, eth_estimateGas and transaction or block lookups.
Documentation 1 ↗
Source-based practical guide

Set up provider injection for Jest tests

Create a Jest helper that exposes test wallets and a headless provider to application tests.

Before you start

  • Install headless-web3-provider as a development dependency.
  • Use the documented ethers Wallet API.
  • Provide a chain ID and Ethereum client's JSON-RPC URL.

Steps

  1. Create test wallets with Wallet.createRandom().

  2. Pass the wallets' private keys, chain ID and JSON-RPC URL to makeHeadlessWeb3Provider.

  3. Expose the provider as window.ethereum in the test environment.

  4. Use the returned wallets and provider backend in a test to authorize a wallet connection request.

Expected outcome

A Jest test can exercise and assert an application's wallet-connection flow using the emulated provider.

Guide limitations

  • The example depends on a test environment where window is available.
  • The README's example uses a JSON-RPC endpoint that must be supplied by the test setup.
Documentation 1 ↗
COMPARE OPTIONS

Compare options for Wallet connections

These projects document a common task and share a project role. This is a source-based comparison, not an execution benchmark or a guarantee of interchangeability.

ProjectDocumented purposePlatformAccess and requirements
Headless WEB3 ProviderAutomate wallet connection and account-access flows.CLI
Sample Project GradleConnect a Java web3j application to an Ethereum node.CLI
Eth Nextjs BoilerplateCreate a dApp frontend with wallet connection and an example transaction flow.CLI, Web
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
17 October 2026
Original website title
cawabunga/headless-web3-provider · Official homepage title · retained in its source language
How we review sourcesSuggest a correction