-
Notifications
You must be signed in to change notification settings - Fork 97
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #459 from 0xPolygon/anvil_l1
Anvil l1
- Loading branch information
Showing
11 changed files
with
289 additions
and
36 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,4 @@ | ||
| args: | ||
| verbosity: debug | ||
| l1_engine: anvil | ||
| consensus_contract_type: rollup |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,55 @@ | ||
| ANVIL_BLOCK_TIME = 1 | ||
| ANVIL_SLOTS_IN_AN_EPOCH = ( | ||
| 2 # Setting to X leads to block N-(X+1) being finalized, being N latest block | ||
| ) | ||
| STATE_PATH = "/tmp" | ||
|
|
||
|
|
||
| def run(plan, args): | ||
| chain_id = str(args["l1_chain_id"]) | ||
| service_files = {} | ||
| mnemonic = args.get("l1_preallocated_mnemonic") | ||
|
|
||
| cmd = ( | ||
| "anvil --block-time " | ||
| + str(ANVIL_BLOCK_TIME) | ||
| + " --slots-in-an-epoch " | ||
| + str(ANVIL_SLOTS_IN_AN_EPOCH) | ||
| + " --chain-id " | ||
| + chain_id | ||
| + " --host 0.0.0.0 --port " | ||
| + str(args["anvil_port"]) | ||
| + " --dump-state " | ||
| + STATE_PATH | ||
| + "/state_out.json" | ||
| + " --balance 1000000000" | ||
| + ' --mnemonic "' | ||
| + mnemonic | ||
| + '"' | ||
| ) | ||
|
|
||
| load_state = bool(args.get("anvil_state_file")) | ||
|
|
||
| if load_state: | ||
| anvil_state = plan.upload_files( | ||
| name="anvil-state", | ||
| src=args["anvil_state_file"], | ||
| description="Uploading Anvil State", | ||
| ) | ||
| service_files = { | ||
| STATE_PATH: anvil_state, | ||
| } | ||
| cmd += " --load-state " + STATE_PATH + "/" + args["anvil_state_file"] | ||
|
|
||
| plan.add_service( | ||
| name="anvil" + args["deployment_suffix"], | ||
| config=ServiceConfig( | ||
| image=args["anvil_image"], | ||
| ports={ | ||
| "rpc": PortSpec(args["anvil_port"], application_protocol="http"), | ||
| }, | ||
| files=service_files, | ||
| cmd=[cmd], | ||
| ), | ||
| description="Anvil", | ||
| ) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,91 @@ | ||
| # Anvil L1 | ||
|
|
||
| You can configure the stack to use Anvil as L1 by setting | ||
| ``` | ||
| l1_engine: anvil | ||
| ``` | ||
|
|
||
| Please, understand that by doing: | ||
| - l1_chain_id is taken into account | ||
| - l1_rpc_url is automatically set to http://anvil-001:8545 | ||
| - l1_ws_url is automatically set to ws://anvil-001:8545 | ||
| - These params are ignored: | ||
| - l1_beacon_url | ||
| - l1_additional_services | ||
| - l1_preset | ||
| - l1_seconds_per_slot | ||
| - l1_participants_count | ||
|
|
||
|
|
||
| ## State dump and recover | ||
| By using Anvil as L1, you can dump L1 network state, totally remove the network, and recreate again with the same L1 state. | ||
| This procedure has been tested with zkEVM rollup mode, for other scenarios you could need to perform additional steps (like dumping/restoring DAC database) or could be even not supported. | ||
|
|
||
| ### Procedure | ||
| Deploy the network. | ||
| ```bash | ||
| ENCLAVE=cdk | ||
| kurtosis run --enclave $ENCLAVE . '{ | ||
| "args": { | ||
| "l1_engine": "anvil", | ||
| "consensus_contract_type": "rollup", | ||
| } | ||
| }' | ||
| ``` | ||
|
|
||
| Once deployed, save the required files to recreate again later. These are the files you need: | ||
| - ./anvil_state.json | ||
| - ./templates/contract-deploy/ | ||
| - ./templates/contract-deploy/combined.json | ||
| - ./templates/contract-deploy/genesis.json | ||
| - ./templates/contract-deploy/dynamic-kurtosis-conf.json | ||
| - ./templates/contract-deploy/dynamic-kurtosis-allocs.json | ||
|
|
||
| Let's get them: | ||
|
|
||
| ```bash | ||
| STATE_FILE=anvil_state.json | ||
| DEPLOYMENT_FILES="combined.json genesis.json dynamic-kurtosis-conf.json dynamic-kurtosis-allocs.json" | ||
|
|
||
| contracts_uuid=$(kurtosis enclave inspect --full-uuids $ENCLAVE | grep contracts | awk '{ print $1 }') | ||
| for file in $DEPLOYMENT_FILES; do | ||
| # Save each file on ./templates/contract-deploy, as they are expected there for use_previously_deployed_contracts=True | ||
| docker cp contracts-001--$contracts_uuid:/opt/zkevm/$file ./templates/contract-deploy/$file | ||
| done | ||
|
|
||
| # Dump Anvil state (L1) | ||
| anvil_uuid=$(kurtosis enclave inspect --full-uuids $ENCLAVE | grep anvil | awk '{ print $1 }') | ||
| docker cp anvil-001--$anvil_uuid:/tmp/state_out.json $STATE_FILE | ||
| ``` | ||
|
|
||
| At that point you have all you need, you can totally remove the network. | ||
| ```bash | ||
| kurtosis enclave stop $ENCLAVE | ||
| kurtosis enclave rm $ENCLAVE | ||
| ``` | ||
|
|
||
| To recreate the network, run kurtosis from scratch like this: | ||
| ```bash | ||
| time kurtosis run --enclave $ENCLAVE . '{ | ||
| "args": { | ||
| "anvil_state_file": '$STATE_FILE', | ||
| "use_previously_deployed_contracts": true, | ||
| "consensus_contract_type": "rollup", | ||
| } | ||
| }' | ||
| ``` | ||
|
|
||
| This will perform the required steps to load the previous state, however, the sequencer needs to recover the state from L1 so it has been set with a specific param, that won't allow it to resume generating new blocks. So you need to manually unlock it: | ||
|
|
||
| ```bash | ||
| # Check cdk-erigon-sequencer logs until you see lines like this before proceeding. | ||
| # "L1 block sync recovery has completed!"" | ||
|
|
||
| # Disable L1 recovery mode | ||
| kurtosis service exec $ENCLAVE cdk-erigon-sequencer-001 \ | ||
| "sed -i 's/zkevm.l1-sync-start-block: 1/zkevm.l1-sync-start-block: 0/' /etc/cdk-erigon/config.yaml" | ||
|
|
||
| # Restart sequenccer | ||
| kurtosis service stop $ENCLAVE cdk-erigon-sequencer-001 | ||
| kurtosis service start $ENCLAVE cdk-erigon-sequencer-001 | ||
| ``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.