Tools to interact with CDK smart contracts and Go bindings
Not all the commands have the same requirements, but here is the complete list of requirements (to be able to run all the commands):
- Go
- NVM installed under $NVM_DIR
- abigen
From the root of this repo run go run ./cmd. This will print a help message explaining how to use all the commands
Some commands require using RPC endpoints. There are multiple ways to import these endpoints, but all of them require to:
- Copy paste
rpcs.example.tomlintorpcs.toml - Edit the new file to include your RPC configurations (the file has comments to make the needed changes comprehensible)
Unfortunately the base genesis file cannot be retrieved from L1. Therefore they must be imported manually.
For the full execution proofs rollups, the location that should contain the genesis allocations is ./genesis/legacy/<state_root_hex>.json
For the pessimistic proofs rollups (since they are initialized with an empty genesis root), the location that should contain the genesis allocations is constructed following the pattern ./genesis/pp_default/<l1_network_alias>/<rollup_manager_alias>/<rollup_alias>/allocs.json.
Example
Let's assume that we have a pessimistic proofs rollup named cdk-pp-1 running on the cardona, that is pointing to sepolia l1 network.
The genesis file should be named as allocs.json and placed in the ./genesis/pp_default/sepolia/cardona/cdk-pp-1/, so the full path is ./genesis/pp_default/sepolia/cardona/cdk-pp-1/allocs.json.
Generate genesis file for a node (cdk-validium-node or zkevm-node) and the config for a Bridge service (zkevm-bridge-service)
- Import the rollup manager:
go run ./cmd import-rm -l1 sepolia -addr 0x32d33d5137a7cffb54c5bf8371172bcec5f310ff -alias cardonaIn this example:
- -l1 sepolia is the L1 network, make sure that your rpcs.toml file contains a valid RPC for the L1 network this CDK belongs to
- -addr 0x32d33d5137a7cffb54c5bf8371172bcec5f310ff is the L1 address where the rollup manager is deployed
- -alias cardona is an arbitrary name. You can really name this however you want, but this is going to be used later to reference this rollup manager deployment
- (OPTIONAL) After first step, all the attached rollups are imported using their name as alias, and defaulting to chainID for name if the name has the default value
networkName. It's possible to manually import a rollup using a custom alias:
go run ./cmd import-r -l1 sepolia -rm cardona -r 22-moonveil-testnet -chainid 1093502521In this example:
- -rm cardona rollup manager referenced by the alias used in the previous step
- -chainid 1093502521 is the chain ID of the rollup (L2 Chain ID)
- -alias 22-moonveil-testnet is an arbitrary name. You can really name this however you want, but this is going to be used later to reference this rollup deployment
- Generate the genesis file for the node:
go run ./cmd genesis -l1 sepolia -rm cardona -r API3 -output 22-moonveil-testnet.json`. In this example:
- -l1 sepolia is the L1 network
- -rm cardona rollup manager referenced by the alias used in the step 1 (import rollup manager)
- -r 22-moonveil-testnet rollup referenced by the alias used in the previous step
- -output 22-moonveil-testnet.json file where the genesis will be stored
- Generate combined json for the specified rollup. It contains combined metadata related to the rollup, such as contract addresses, state root etc.
go run ./cmd import-combined-json -l1 sepolia -rm cardona -r 22-moonveil-testnetIn this example:
- -l1 sepolia is the L1 network
- -rm cardona rollup manager referenced by the alias used in the step 1 (import rollup manager)
- -r 22-moonveil-testnet rollup referenced by the alias used in the previous step
- Generate the network config section of the zkevm bridge service:
go run ./cmd bridge -l1 sepolia -rm cardona -r 22-moonveil-testnet -output 22-moonveil-testnet.toml
Note that step 1 only needs to be done once, if there are multiple rollups attached to the same rollup manager, with a single run it will be enough.