testnet-ops/l2-setup
2024-09-05 13:17:23 +05:30
..
templates Add vars file for config values 2024-09-05 13:17:21 +05:30
l2-vars.yml Add vars file for config values 2024-09-05 13:17:21 +05:30
README.md Ask for sudo password when running playbook 2024-09-05 13:17:23 +05:30
run-optimism.yml Copy l2-accounts.json for existing contracts deployment in L2 2024-09-05 13:17:23 +05:30
setup-vars.yml Add vars file for config values 2024-09-05 13:17:21 +05:30

l2-setup

Setup Ansible

To get started, follow the installation guide to setup ansible on your machine

Setup and Run Optimism

The following commands have to be executed in l2-setup directory

  • Edit l2-vars.yml with the required values

    # L1 chain ID
    l1_chain_id: ""
    
    # L1 RPC endpoint
    l1_rpc: ""
    
    # L1 RPC endpoint host or IP address
    l1_host: ""
    
    # L1 RPC endpoint port number
    l1_port: ""
    
    # L1 Beacon endpoint
    l1_beacon: ""
    
    # Address of the funded account on L1
    # Used for optimism contracts deployment
    l1_address: ""
    
    # Private key of the funded account on L1
    l1_priv_key: ""
    
  • To setup and run L2, execute the run-optimism.yml Ansible playbook by running the following command.

    NOTE: By default, deployments are created in the l2-setup/out directory. To change this location, update the l2_directory variable in the vars.yml file.

    LANG=en_US.utf8 ansible-playbook -i localhost, --connection=local run-optimism.yml --extra-vars='{ "target_host": "localhost"}' -kK --user $USER
    
    • For skipping container build, set "skip_container_build" : true in the --extra-vars parameter:

      LANG=en_US.utf8 ansible-playbook -i localhost, --connection=local run-optimism.yml --extra-vars='{"target_host" : "localhost", "skip_container_build": true}' -kK --user $USER
      
  • To run using existing contracts deployment

    • Update artifact_path in setup-vars.yml file with path to data directory of the existing deployment

    • Run the ansible playbook with "existing_contracts_deployment": true in the --extra-vars parameter:

      LANG=en_US.utf8 ansible-playbook -i localhost, --connection=local run-optimism.yml --extra-vars='{"target_host" : "localhost", "existing_contracts_deployment":  true}' -kK --user $USER
      

Check Deployment Status

  • Run the following command in the directory where the optimism-deployment is created

    • Follow optimism contracts deployment logs:

      laconic-so deployment --dir optimism-deployment logs -f fixturenet-optimism-contracts
      
    • Check L2 logs:

      laconic-so deployment --dir optimism-deployment logs -f op-geth
      
      # Ensure new blocks are getting created