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