EIP4337 bundler compatibility tests.

For more information on the motivation and importance of having a compatibility test suite, see https://notes.ethereum.org/@yoav/unified-erc-4337-mempool

For the formal schema EIP-4337 bundler RPC API spec, see https://github.com/eth-infinitism/bundler-spec

Prerequisites

Python version 3.8+ PDM - python package and dependency manager version 2.2.1+

Installation

Run pdm install && pdm run update-deps

Running the tests

Running with an up and running Ethereum node and bundler

Assuming you already have an Ethereum node running, EntryPoint deployed and your bundler running and ready for requests, you can run the test suite with:

pdm run pytest -rA -W ignore::DeprecationWarning --url <bundler_url> --entry-point <entry_point> --ethereum-node <ethereum_node_url>

Running with a launcher script

You can provide a launcher script by adding the option --launcher-script to the command:

pdm run pytest -rA -W ignore::DeprecationWarning --url <bundler_url> --entry-point <entry_point> --ethereum-node <ethereum_node_url> --launcher-script <launcher-script-file>

Your launcher script will be invoked by shell with:

<launcher-script-file> {start|stop|restart}

where:

start should start an Ethereum node, deploy an EntryPoint contract and start your bundler.
stop should terminate both the Ethereum node and your bundler processes, and cleanup if necessary.
restart should stop and start atomically.

bxdoan / bundler-spec-tests