Bridge CLI

The mev-commit chain uses native ETH that must be bridged from L1 using our lock and mint bridge. A user CLI application can be downloaded from the releases page.

You can confirm your operating system and architecture by running uname -sm.

Or use the following command which automatically downloads and extracts the latest bridge user CLI binary for your system into your $HOME directory:

curl -Ls $(curl -s https://api.github.com/repos/primev/mev-commit/releases \
  | grep browser_download_url \
  | grep "mev-commit-bridge-user-cli_[0-9].*$(uname -s)_$(uname -m)\.tar\.gz" \
  | cut -d '"' -f 4 \
  | head -n1) | tar -xz -C ~

The binary will then be available in your $HOME directory as user-cli.

In order to bridge funds, users need to have an account which is funded with mainnet ETH.

❯_ bridge to settlement chain from L1

user-cli bridge-to-settlement \
	--account-key <Private Key of source account> \
	--dest-addr <Address to fund on the mev-commit chain> \
	--amount <Amount in Wei>

user-cli bridge-to-l1 \
	--account-key <Private Key of source account> \
	--dest-addr <Address to fund on the mev-commit chain> \
	--amount <Amount in Wei>

Testnet command

❯_ bridge to settlement chain from L1

user-cli bridge-to-settlement \
        --account-key $PRIVATE_KEY \
        --dest-addr $DEST_ADDR \
        --amount $AMOUNT_IN_WEI \
        --l1-rpc-url https://0xrpc.io/hoodi \
        --settlement-rpc-url https://chainrpc.testnet.mev-commit.xyz \
        --l1-contract-addr 0x0b3b6Cf113959214E313d6Ad37Ad56831acb1776 \
        --settlement-contract-addr 0xFaF6F0d4bbc7bC33a4b403b274aBb82d0E794202

A static fee is charged for bridging from the mev-commit chain to L1, to compensate the relayer for transaction inclusion. This fee is currently set to 0.005 ETH.

Users can also use a keystore file instead of using the private key.

CLI currently uses default contract addresses for mainnet and default mainnet RPC endpoints. Users can use separate RPC URLs using the respective options.

To check other options available in the user CLI, users can use the -h option

./user-cli -h
NAME:
   mev-commit-bridge-user-cli - CLI for interacting with a custom bridge between L1 and the mev-commit (settlement) chain

USAGE:
   mev-commit-bridge-user-cli [global options] command [command options]

COMMANDS:
   bridge-to-settlement  Submit a transaction to bridge ether to the settlement chain
   bridge-to-l1          Submit a transaction to bridge ether back to L1
   help, h               Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --help, -h  show help

./user-cli bridge-to-settlement -h
NAME:
   mev-commit-bridge-user-cli bridge-to-settlement - Submit a transaction to bridge ether to the settlement chain

USAGE:
   mev-commit-bridge-user-cli bridge-to-settlement [command options]

OPTIONS:
   --account-key value               private key of the account to use for signing transactions in hex encoding [$ACCOUNT_KEY]
   --keystore-path value             path to keystore location [$MEV_ORACLE_KEYSTORE_PATH]
   --keystore-password value         use to access keystore [$MEV_ORACLE_KEYSTORE_PASSWORD]
   --amount value                    amount of ether to bridge in wei [$AMOUNT]
   --dest-addr value                 destination address on the mev-commit (settlement) chain [$DEST_ADDR]
   --l1-rpc-url value                URL for L1 RPC [$L1_RPC_URL]
   --settlement-rpc-url value        URL for settlement RPC [$SETTLEMENT_RPC_URL]
   --l1-contract-addr value          address of the L1 gateway contract [$L1_CONTRACT_ADDR]
   --settlement-contract-addr value  address of the settlement gateway contract [$SETTLEMENT_CONTRACT_ADDR]
   --silent                          disable spinner (default: false) [$SILENT]
   --help, -h                        show help

The current bridge waits for finalization. Thus when moving funds from L1 to the settlement chain, users will have to wait for at least 15 mins (L1 finalization time) before getting a confirmation. Conversely, bridging from settlement to L1 chain will be significantly faster (less than 1 second settlement chain finalization time).

After the bridge is successful, the following command can be used to check their mev-commit chain balance

Mainnet

curl -L https://foundry.paradigm.xyz | bash && foundryup && cast balance mev_commit_mainnet_address --rpc-url https://chainrpc.mev-commit.xyz/

Testnet

curl -L https://foundry.paradigm.xyz | bash && foundryup && cast balance mev_commit_testnet_address --rpc-url https://chainrpc.testnet.mev-commit.xyz/