Quick Start Guide for Artela EVM++ with Rollkit ​

This guide will assist you to quickly set up a rollup node with Artela EVM++ execution layer using Rollkit and local-DA.

EVM++ is a modular dual-VM execution layer that supports the dynamic creation of native extension modules for blockchain at runtime. It enables developers to leverage WasmVM to build native extensions that co-process with EVM, offering enhanced customization capabilities. More than just a dual-VM setup, these native extensions facilitate blockchain-level customization. They allow for the integration of custom logic throughout the transaction lifecycle, providing access to an expanded runtime context.

📦 Clone the Artela Rollkit Repository ​

Start by cloning the Artela Rollkit repository:

git clone https://github.com/artela-network/artela-rollkit.git
cd artela-rollkit

🛥️ Run with Docker Compose ​

Ensure Docker is installed on your system before setting up the Artela rollup node. If not already installed, download and follow the setup instructions available here.

After installing Docker, run the following command to start a local development node:

docker compose up -d

This command launches the Artela rollup node with Rollkit and local-DA. To monitor the logs, use this command:

docker logs artroll -f

If you observe the following output, the local development node is running properly:

...
7:09AM INF finalized block block_app_hash=E483920A1E1E7E492E47036300003769420813BB13BB3F25CFAFDB0DF19C144A height=3 module=BlockManager num_txs_res=0 num_val_updates=0
7:09AM INF executed block app_hash=E483920A1E1E7E492E47036300003769420813BB13BB3F25CFAFDB0DF19C144A height=3 module=BlockManager
7:09AM INF indexed block events height=3 module=txindex
7:09AM INF Creating and publishing block height=4 module=BlockManager
...

🔑 Get prefunded test accounts ​

Access testing accounts by entering the artroll Docker container:

docker exec -ti artroll /bin/bash

Retrieve the address and private key of testing accounts using:

# 👇 Alternatively, you can use myKey2.info, myKey3.info, myKey4.info
./entrypoint keyinfo --file ~/.artroll/keyring-test/mykey.info --passwd test

This will display the testing private key and its address:

private key: { Plain Private Key in Hex Format }
address: { Address Associated with the Private Key }

There are four testing accounts available in the local development node for interacting with the EVM chain.

🧪 Build on EVM++ ​

Let’s dive into Artela EVM++ by kicking off with the Hello World project, the following code will guide you through the essentials:

👉 Contract interaction tutorial: Get hands-on experience with deploying and interacting with smart contracts on the Artela rollup node.

👉 Quick Start for Aspect on EVM++: Try your first Aspect with Artela rollup node.

By now, we assume that you:

• Have a basic understanding of Artela technology.
• Have installed and played with Artela development tools.
• Understand how Aspect functions and its impact on making dApps distinct and superior.
• May already have numerous innovative ideas for building on Artela.

📖 More to know ​

If you want to gain a deeper understanding of Aspect’s capabilities and limitations to fully grasp how it can enhance or constrain your project, make sure not to overlook these essential concepts:

• Aspect Runtime
• Aspect Lifecycle
• Join Point
• Aspect Tool
• Aspect Libs

💥 Build with examples ​

Our community has built numbers of projects with Aspect, you can refer to these projects and modify them to learn how to use Aspect more effectively.

Simple examples that use the basic functionalities of Aspect:

• Example 1: Aspect Reentrancy Guard
• Example 2: Black List Aspect
• Example 3: Throttler Aspect

Real-world use cases that show how to build more complex projects with Aspect:

• Session key Aspect: use Aspect to extend EoA with session keys and improve
• JIT-gaming Aspect: use Aspect to add automatic on-chain NPC for a fully on-chain game.

🛑 Stopping the Node ​

To cease operations and shutdown the Artela rollup node, use:

docker compose down

This command halts all running containers and clears the environment.

🎉 Conclusion ​

Congratulations! You have successfully learnt some basic knowledge of EVM++ and have set up an Artela EVM++ rollup using Rollkit and local-DA. This setup enables you to test the integrated capabilities of Artela’s EVM++ with Rollkit.