https://github.com/eth-infinitism/bundler-spec-tests

Bundler specification test suites
https://github.com/eth-infinitism/bundler-spec-tests

Last synced: about 2 months ago
JSON representation

Bundler specification test suites

• Host: GitHub
• URL: https://github.com/eth-infinitism/bundler-spec-tests
• Owner: eth-infinitism
• Created: 2022-11-13T16:12:01.000Z (about 2 years ago)
• Default Branch: master
• Last Pushed: 2024-05-09T18:15:46.000Z (8 months ago)
• Last Synced: 2024-05-16T04:25:28.595Z (8 months ago)
• Language: Python
• Size: 233 KB
• Stars: 68
• Watchers: 9
• Forks: 28
• Open Issues: 12
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-account-abstraction - Bundler Compatibility Test Suite

README

        
# EIP4337 bundler compatibility tests.

## Version 0.7

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

The spec test for previous release is at [releases/v0.6](https://github.com/eth-infinitism/bundler-spec-tests/tree/releases/v0.6)

#### 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:

```shell script

pdm test

```

With the following parameters:

  * **--url** the bundler to test (defaults to http://localhost:3000)

  * **--entry-point** (defaults to `0x0000000071727De22E5E9d8BAf0edAc6f37da032`)

  * **--ethereum-node** (defaults to http://localhost:8545)

  * **--launcher-script** (See below)

  * **-k** <regex>, (or any other pytest param)

##### Running with a launcher script

You can provide a launcher script by adding the option `--launcher-script` to the command line.

Your launcher script will be invoked by the shell with:

```shell script

 {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.  

##### Running using the "test executor"

See https://github.com/eth-infinitism/bundler-test-executor, for the test executor to run the test suite against all registered bundler implementations.