op-interop-contender

a custom contender script designed to spam interop transactions & relay them directly.

Contender's builtin features are used to measure time-to-inclusion for interop transactions. The duration is measured from when we get the initiating tx response to when the relay tx is included onchain.

quickstart

In a terminal, run supersim (without the --interop.autorelay flag):

supersim

This will start a dev environment with 3 nodes: an L1 node on localhost:8545, an L2 node on localhost:9545, and another L2 node on localhost:9546.

💁‍♂️ You can skip this step if you're targeting a different interop deployment. Just set the following variables in your environment to target your nodes:

• SPAM_SENDER_PRIVATE_KEY (used to send funds to spammers on src. chain, and to send relay txs on dest. chain)
• SPAM_ORIGIN_RPC (source L2)
• SPAM_DEST_RPC (destination L2)
• OP_ADMIN_URL (must support admin_getAccessListForIdentifier RPC method)

In a new terminal, clone this repo and run the binary:

git clone https://github.com/zeroxbrock/op-interop-contender
cd op-interop-contender
cargo run

You can generate a contender report after spamming by setting SPAM_MAKE_REPORT in your environment:

export SPAM_MAKE_REPORT=true
cargo run

The default settings should work when running against supersim, but if you need to change them, you can set the desired variables in your environment. See here for reference.

Any variables not set will also show up as a warning when you run the script.

how it works

By default, the program runs a builtin scenario on a timed spammer, which mints tokens on chain A and transfers them to chain B

spam_callback.rs defines a custom callback which holds a JSON-RPC provider connected to the destination chain. This allows us to watch transactions after we relay them, and record information about them in the DB.