Nottingham Runner

This is a CLI tool and library used for running tournaments in the Searchers of Nottingham CTF.

Setup

Clone this repo, cd into it then:

npm i -D && npm run build

CLI Commands

CLI commands require either explicitly passing in a season's private key or being run against seasons that have already been revealed.

Fetching bytecode

You can fetch and decrypt the last submitted bytecode for a player(s) in a past season with the last-bytecode command. For example, to fetch player (identified by address) 0x2621ea417659Ad69bAE66af05ebE5788E533E5e7's bytecode from season 0 (seasons are 0-based):

npm run cli -- last-bytecode -u 'https://us-central1-nottingham-420415.cloudfunctions.net/data' 0 0x2621ea417659Ad69bAE66af05ebE5788E533E5e7

You can extract and decrypt bytecode from a transaction hash for a past season with the tx-bytecode command. You will need to provide an http RPC.

npm run cli -- tx-bytecode -u 'https://us-central1-nottingham-420415.cloudfunctions.net/data' -r 'https://mainnet.era.zksync.io' 0xb1702b6b45939167f5de210fd6a0002c5a745d31e98d5fd5969effcd3a3a74fb

Running tournaments

You can run tournaments locally with the run command. For example, to run a tournament on season 0 with 3 brackets of 8 matches per player and 12 match workers:

npm run cli -- run 0 -u 'https://us-central1-nottingham-420415.cloudfunctions.net/data' -w 12 -b 8 8 8