Skip to content

Deploy the CDK stack

Hardware requirements

  • A Linux-based OS (e.g., Ubuntu Server 22.04 LTS).
  • At least 8GB RAM with a 2-core CPU.
  • An AMD64 architecture system.

Tip

Make sure you install Docker Engine version 4.27 or higher to run the zkEVM prover on MacOS.

Prerequisites

  1. Install Kurtosis.

  2. Install the Foundry toolchain.

  3. Run the following script to check you have the remaining required tools and install where missing.

    curl -s https://raw.githubusercontent.com/0xPolygon/kurtosis-cdk/main/scripts/tool_check.sh | bash

Set up

  1. Clone the repo and cd into it.

    git clone https://github.com/0xPolygon/kurtosis-cdk.git
cd kurtosis-cdk

  2. Make sure Docker is running.

  3. Run the Kurtosis enclave.

    kurtosis run --enclave cdk-v1 --args-file params.yml --image-download always .

    This command takes a few minutes to complete and sets up and runs an entire local CDK deployment.

When everything is set up and running, we can play around with the test CDK.

Simple RPC calls

Inspect the stack

kurtosis enclave inspect cdk-v1

You should see a long output that starts like this:

Name:            cdk-v1
UUID:            47d8679066a6
Status:          RUNNING
Creation Time:   Wed, 10 Apr 2024 13:58:13 CEST
Flags:

========================================= Files Artifacts =========================================
UUID   Name

Check port mapping

To see the port mapping within the cdk-v1 enclave for the zkevm-node-rpc service and the trusted-rpc port, run the following command:

kurtosis port print cdk-v1 zkevm-node-rpc-001 http-rpc

You should see output that looks something like this (but won’t necessarily be the same):

http://127.0.0.1:65240

Set an environment variable

Let’s map the output from the previous step to an environment variable that we can use throughout these instructions.

export ETH_RPC_URL="$(kurtosis port print cdk-v1 zkevm-node-rpc-001 http-rpc)"

Test cast commands

This is the same environment variable that cast uses, so you should now be able to run the following command:

cast block-number

You should see something like this:

890

Pre-funded account

By default, the CDK is configured in test mode, and this means there is some pre-funded ETH in the admin account that has address: 0xE34aaF64b29273B7D567FCFc40544c014EEe9970.

Check the balance with the following:

cast balance --ether 0xE34aaF64b29273B7D567FCFc40544c014EEe9970

You should see something like this:

100000.000000000000000000

Send transaction with cast

cast send --legacy --private-key 0x12d7de8621a77640c9241b2595ba78ce443d05e94090365ab3bb5e19df82c625 --value 0.01ether 0x0000000000000000000000000000000000000000

You should see something like this as output:

blockHash               0xc467523f297a9c0b859bedc8feaf44c3e7462de56f7d7899b2039d9a3cfc421d
blockNumber             70
contractAddress
cumulativeGasUsed       21000
effectiveGasPrice       1000000000
from                    0xE34aaF64b29273B7D567FCFc40544c014EEe9970
gasUsed                 21000
logs                    []
logsBloom               0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
root
status                  1
transactionHash         0xa58b3383c1b1f53369723fdc537c88daa03585cb6a89aa49ebd493953d519fdf
transactionIndex        0
type                    0
to                      0x0000000000000000000000000000000000000000

Send transactions with polygon-cli

polycli loadtest --requests 500 --legacy --rpc-url $ETH_RPC_URL --verbosity 700 --rate-limit 5 --mode t --private-key 0x12d7de8621a77640c9241b2595ba78ce443d05e94090365ab3bb5e19df82c625
polycli loadtest --requests 500 --legacy --rpc-url $ETH_RPC_URL --verbosity 700 --rate-limit 10 --mode t --private-key 0x12d7de8621a77640c9241b2595ba78ce443d05e94090365ab3bb5e19df82c625
polycli loadtest --requests 500 --legacy --rpc-url $ETH_RPC_URL --verbosity 700 --rate-limit 10 --mode 2 --private-key 0x12d7de8621a77640c9241b2595ba78ce443d05e94090365ab3bb5e19df82c625
polycli loadtest --requests 500 --legacy --rpc-url $ETH_RPC_URL --verbosity 700 --rate-limit 3 --mode uniswapv3 --private-key 0x12d7de8621a77640c9241b2595ba78ce443d05e94090365ab3bb5e19df82c625
cast nonce 0xE34aaF64b29273B7D567FCFc40544c014EEe9970

Check the logs

kurtosis service logs cdk-v1 zkevm-agglayer-001

You can open a shell on any service.

kurtosis service shell cdk-v1 zkevm-node-sequencer-001

Another common way to check the status of the system is to make sure that batches go through the normal progression of trusted, virtual, and verified. To check this run:

cast rpc zkevm_batchNumber
cast rpc zkevm_virtualBatchNumber
cast rpc zkevm_verifiedBatchNumber

Clean up

When everything is done, you might want to clean up with this command which stops everything and deletes it.

kurtosis clean -a


Comments