Important
Prerequisites
Before you start, make sure you have the following installed on your machine:
Based-op is fully l1 pectra ready
The following steps have been tested on Sepolia, with a previously deployed L2 chain (l2 non-pectra)
- locate your
rollup.json,genesis.jsonandstate.jsonfiles - run
make config-main-node OP_NODE_DATA_DIR=<path/to/op-node/data> OP_GETH_DATA_DIR=<path/to/op-geth/data> ROLLUP_JSON=<path/to/rollup.json> GENESIS_JSON=<path/to/genesis.json> STATE_JSON=<path/to/state.json> - there should be some files set up in
.local_main_node - start sequencing the main chain with
make start-main-node OP_BATCHER_KEY=<op-batcher-private-key> OP_PROPOSER_KEY=<op-proposer-private-key> MAIN_KEY=<vault-key/main-sequencing key> L1_RPC_URL=<sepolia rpc url> L1_BEACON_RPC_URL=<sepolia beacon rpc url> - Normally you should see some logs starting
blockscoutshould be up and running athttp://0.0.0.0:40007a.make stop-main-nodeto stop all the sequencing services 7b.make logs-main-nodeto output logs of all the main services
- To deploy a new chain on l2, make sure to have an address on Sepolia with some funds. This will be used as the
MAIN/vaultaddress. - create 2 more accounts, deposit ~0.2 eth in them. One will be used for the
op-batcherone for the `op-proposer. - run
make deploy-chain OP_BATCHER_KEY=<op-batcher private key> OP_PROPOSER_KEY=<op-proposer private key> MAIN_KEY=<vault key> L1_RPC_URL=<l1 sepolia rpc url> L1_BEACON_RPC_URL=<l1 sepolia beacon rpc url> - start sequencing the main chain with
make start-main-node OP_BATCHER_KEY=<op-batcher-private-key> OP_PROPOSER_KEY=<op-proposer-private-key> MAIN_KEY=<vault-key/main-sequencing key> L1_RPC_URL=<sepolia rpc url> L1_BEACON_RPC_URL=<sepolia beacon rpc url> - Normally you should see some logs starting
blockscoutshould be up and running athttp://0.0.0.0:40007a.make stop-main-nodeto stop all the sequencing services 7b.make logs-main-nodeto output logs of all the main services
- run
make start-gateway PORTAL=<portal rpc url> GATEWAY_SEQUENCING_KEY=<private key used to sequence with> - to stop the based gateway run
make stop-gateway - for logs
make logs-gateway
When a based-gateway is started with make start-gateway, it will register itself to the Registry behind the PORTAL. For now, the Registry is kept in a simple json file in .local_main_node/config/registry.json. You can add/update/remove gateways there, the Registry and Portal will pick up on the changes every minute.
If you have started both the main sequencing node and the gateway on the same machine, you might need to change the ip to 0.0.0.0, by default curl ifconfig.me is used to populate
your url.
You can now test sending a transaction with make test-tx.
The transaction will be sent to the Portal, and forwarded to the gateway, which will sequence the transaction in a new Frag, and broacast it via p2p to follower nodes.
Important
The following is experimental
Wallets commonly use a high polling interval for the transaction receipt. To be able to see the preconfirmation speed, we modify Rabby to speed up that interval. You can test it compiling it:
make build-rabbyAnd importing it to your browser locally (see Firefox or Chrome references). The compiled extension directory is rabby/dist for Google Chrome, and rabby/dist-mv2 for Mozilla Firefox.
Warning
You need to have our modified Rabby extension installed.
- Open your Rabby extension.
- Import, create a new wallet, or use your existing one.
- Click on "More".
- Scroll down to the "Settings" section.
- Click on "Add Custom Network".
- Fill the form with the following values:
- Network Name:
Based-OP - RPC URL:
http://localhost:8545 - Chain ID:
2151908 - Symbol:
ETH - Block Explorer URL:
<TODO>
- Network Name:
- Check the "This network supports preconfirmations" option.
- Click on "Confirm".
Now, you have added your local follower node RPC as the custom network.
Warning
You need to have our modified Rabby extension installed and connected to your local follower node.
- Open your Rabby extension.
- Click on "Send".
- Click on the "Chain" dropdown and select "Based-OP".
- Fill the form.
- Click on "Send".
- Sign the transaction.
- Enjoy.