A tool that mimics an Ethereum Execution RPC endpoint in order to implement Special Contributions to the Ethereum KZG Ceremony without having to change the Sequencer Code, nor that of the clients interacting with it.

It replaces the Ethereum RPC endpoint that the sequencer normally talks to so that we can effectively only allow certain addresses to contribute at certain times, which is the functionality required for the Special Contribution period of the KZG Ceremony.

SCAR maintains a database of whitelisted addresses and time-span they are whitelisted for and returns a specified nonce if an address is in the DB and has a valid time-stamp, otherwise 0. This way, we repurpose the existing sequencer logic for only allowing people to log-in when their nonce is "high enough" and use it to allow or deny whitelisted participants.

The primary design goal was to require as few changes to the existing code-bases as possible when supporting Special Contributions, and this method doesn't require any other changes.

Install requirements:

pip3 install -r requirements.txt

Create the DB:

python server.py create-db

Import Calendly CSV into whitelist DB:

python server.py import-csv --csv-file ./path/to/events-export.csv

Run the server:

python server.py run