/kurtosis-blockscout

Kurtosis module for Blockscout

Primary LanguageStarlark

Polygon CDK/zkEVM Blockscout Package

This is a Kurtosis based stack to deploy Blockscout on arbitrary CDK/zkEVM based chain.

Configuration

Be sure to have Kurtosis installed on you computer: https://docs.kurtosis.com/install/

Create a params.yaml with config params

Required params

  • rpc_url: RPC URL
  • ws_url: WS URL

Optional params

  • blockscout_public_port: port on which you'll have Blockscout frontend available, 8000 by default

  • blockscout_public_ip: public ip if you want to expose blockscout for remote access

  • blockscot_backend_port: if you want to expose blockscout to be accessed remotely (you've set blockscout_public_ip), you need to set a port for backend as well

  • trace_url: RPC URL with debug endpoints enabled, rpc_url will be used if omitted

  • chain_id: l2 chain id, if omitted it will be automatically determined through rpc_url

  • swap_url: URL for swap, will just enable a button link on the top right

  • l1_explorer: explorer URL for L1 network

  • l1_rpc_url: RPC URL for L1

  • deployment_suffix: specific for kurtosis, will append this suffic to all services

  • bridge_info: An object containing this fields:

    • l1_start_block: First L1 block to scan for deposits.
    • l1_contract: Address for L1 bridge contract
    • l1_network_id: Network ID for L1
    • l1_rollup_index: Rollup ID for L1
    • l2_start_block: 0
    • l2_contract: Address for L2 bridge contract
    • l2_network_id: Network ID for L2
    • l2_rollup_index: Rollup ID for L2

Example:

Find config example files under configs folder

Execution

Demo execution for zkEVM Cardona Testnet: kurtosis run github.com/xavier-romero/kurtosis-blockscout --args-file configs/zkevm-cardona.yaml --enclave bs-cardona Point your browser to http://127.0.0.1:8000

Demo execution for zkEVM Mainnet: kurtosis run github.com/xavier-romero/kurtosis-blockscout --args-file configs/zkevm-mainnet.yaml --enclave bs-mainnet Point your browser to http://127.0.0.1:8001

Sample screenshots

Main screen Stats Bridge deposits