In this Guide, we contribute to Drosera testnet by:

1. Installing the CLI
2. Setting up a vulnerable contract
3. Deploying a Trap on testnet
4. Connecting an operator to the Trap

• 2 CPU Cores
• 4 GB RAM
• 20 GB Disk Space
• Get started with a low-budget VPS for as low as $5! Purchase here
• Create your own Ethereum Holesky RPC in Alchemy or QuickNode.

sudo apt-get update && sudo apt-get upgrade -y

sudo apt install curl ufw iptables build-essential git wget lz4 jq make gcc nano automake autoconf tmux htop nvme-cli libgbm1 pkg-config libssl-dev libleveldb-dev tar clang bsdmainutils ncdu unzip libleveldb-dev  -y

Docker:

sudo apt update -y && sudo apt upgrade -y
for pkg in docker.io docker-doc docker-compose podman-docker containerd runc; do sudo apt-get remove $pkg; done

sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update -y && sudo apt upgrade -y

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Test Docker
sudo docker run hello-world

Drosera CLI:

curl -L https://app.drosera.io/install | bash

source /root/.bashrc

droseraup

Foundry CLI:

curl -L https://foundry.paradigm.xyz | bash

source /root/.bashrc

foundryup

Bun:

curl -fsSL https://bun.sh/install | bash

source /root/.bashrc

mkdir my-drosera-trap

cd my-drosera-trap

Replace Github_Email & Github_Username:

git config --global user.email "Github_Email"
git config --global user.name "Github_Username"

Initialize Trap:

forge init -t drosera-network/trap-foundry-template

Compile Trap:

curl -fsSL https://bun.sh/install | bash

source /root/.bashrc

bun install

forge build

skip warnings!

Deploy Trap:

DROSERA_PRIVATE_KEY=xxx drosera apply

• Replace xxx with your EVM wallet privatekey (Ensure it's funded with Holesky ETH)
• Enter the command, when prompted, write ofc and press Enter.

🚨 Error: You may get several errors (.eg #429) due to rpc issues, to fix, you can enter bellow command by adding --eth-rpc-url

DROSERA_PRIVATE_KEY=xxx drosera apply --eth-rpc-url RPC

• Replace RPC with your own Ethereum Holesky rpc by registering and creating one in Alchemy or QuickNode.

1- Connect your Drosera EVM wallet: https://app.drosera.io/

2- Click on Traps Owned to see your deployed Traps OR search your Trap address.

Open your Trap on Dashboard and Click on Send Bloom Boost and deposit some Holesky ETH on it.

drosera dryrun

• You can

1- Edit Trap configuration:

cd my-drosera-trap
nano drosera.toml

Add the following codes at the bottom of drosera.toml:

private_trap = true
whitelist = ["Operator_Address"]

• Replace Operator_Address with your EVM wallet Public Address between " " symbols
• Your Public Address is your Operator_Address.

2- Update Trap Configuration:

DROSERA_PRIVATE_KEY=xxx drosera apply

• Replace xxx with your EVM wallet privatekey
• If RPC issue, use DROSERA_PRIVATE_KEY=xxx drosera apply --eth-rpc-url RPC and replace RPC with your own.

Your Trap should be private now with your operator address whitelisted internally.

cd ~

# Download
curl -LO https://github.com/drosera-network/releases/releases/download/v1.16.2/drosera-operator-v1.16.2-x86_64-unknown-linux-gnu.tar.gz

# Install
tar -xvf drosera-operator-v1.16.2-x86_64-unknown-linux-gnu.tar.gz

Test the CLI with ./drosera-operator --version to verify it's working.

# Check version
./drosera-operator --version

# Move path to run it globally
sudo cp drosera-operator /usr/bin

# Check if it is working
drosera-operator

docker pull ghcr.io/drosera-network/drosera-operator:latest

drosera-operator register --eth-rpc-url https://ethereum-holesky-rpc.publicnode.com --eth-private-key PV_KEY

• Replace PV_KEY with your Drosera EVM privatekey. We use the same wallet as our trap wallet.

# Enable firewall
sudo ufw allow ssh
sudo ufw allow 22
sudo ufw enable

# Allow Drosera ports
sudo ufw allow 31313/tcp
sudo ufw allow 31314/tcp

Choose one Installation Method:

• Method 1: Install using Docker
• Method 2: Install using SystemD

• Make sure you have installed Docker in Dependecies step.

If you are currently running via old systemd method, stop it:

sudo systemctl stop drosera
sudo systemctl disable drosera

git clone https://github.com/0xmoei/Drosera-Network

cd Drosera-Network

cp .env.example .env

Edit .env file:

nano .env

• Replace your_evm_private_key and your_vps_public_ip
• To save: CTRL+X, Y & ENTER.

Edit docker-compose.yaml file:

nano docker-compose.yaml

• Replace default rpc to your private Alchemy or QuickNode Ethereum Holesky RPCs.
• To save: CTRL+X, Y & ENTER.

docker compose up -d

docker logs -f drosera-node

No problem if you are receiveing WARN drosera_services::network::service: Failed to gossip message: InsufficientPeers

# Stop node
cd Drosera-Network
docker compose down -v

# Restart node
cd Drosera-Network
docker compose up -d

Now running your node using Docker, you can Jump to step 7.

Enter this command in the terminal, But first replace:

• PV_KEY with your privatekey
• VPS_IP with your solid vps IP (without anything else)
• Replace default https://ethereum-holesky-rpc.publicnode.com to your private Alchemy or QuickNode Ethereum Holesky RPCs.

sudo tee /etc/systemd/system/drosera.service > /dev/null <<EOF
[Unit]
Description=drosera node service
After=network-online.target

[Service]
User=$USER
Restart=always
RestartSec=15
LimitNOFILE=65535
ExecStart=$(which drosera-operator) node --db-file-path $HOME/.drosera.db --network-p2p-port 31313 --server-port 31314 \
    --eth-rpc-url https://ethereum-holesky-rpc.publicnode.com \
    --eth-backup-rpc-url https://1rpc.io/holesky \
    --drosera-address 0xea08f7d533C2b9A62F40D5326214f39a8E3A32F8 \
    --eth-private-key PV_KEY \
    --listen-address 0.0.0.0 \
    --network-external-p2p-address VPS_IP \
    --disable-dnr-confirmation true

[Install]
WantedBy=multi-user.target
EOF

# reload systemd
sudo systemctl daemon-reload
sudo systemctl enable drosera

# start systemd
sudo systemctl start drosera

journalctl -u drosera.service -f

!! No problem if you are receiveing WARN drosera_services::network::service: Failed to gossip message: InsufficientPeers

# Stop node
sudo systemctl stop drosera

# Restart node
sudo systemctl restart drosera

In the dashboard., Click on Opti in to connect your operator to the Trap

Your node will start producing greeen blocks in the dashboard

Let's run a 2nd operator on your Trap using Docker:

sudo systemctl stop drosera
sudo systemctl disable drosera

1- Create a new EVM wallet, Fund it with Holeksy ETH and write down its Privatekey (2nd_Operator_Privatekey) & PublicAddress (2nd_Operator_Address).

2- Edit Trap Configuration:

cd ~/my-drosera-trap
nano drosera.toml

Edit the following codes at the bottom of drosera.toml:

private_trap = true
whitelist = ["1st_Operator_Address","2nd_Operator_Address"]

• Replace 1st_Operator_Address & 2nd_Operator_Address with your Operators EVM wallet Public Addresses between " " symbols.

3- Update Trap Configuration:

DROSERA_PRIVATE_KEY=xxx drosera apply

• Replace xxx with your Trap EVM wallet privatekey.
• If RPC issue, use DROSERA_PRIVATE_KEY=xxx drosera apply --eth-rpc-url RPC and replace RPC with your own.

Your 2nd_Operator_Address is now added to the whitelist in the dashboard of your Trap.

drosera-operator register --eth-rpc-url https://ethereum-holesky-rpc.publicnode.com --eth-private-key 2nd_Operator_Privatekey

• Replace 2nd_Operator_Privatekey with your 2nd Operator Privatekey.

sudo ufw allow 31315/tcp
sudo ufw allow 31316/tcp

cd Drosera-Network

nano docker-compose.yaml

Replace the content of the file with the following codes:

version: '3'
services:
  drosera1:
    image: ghcr.io/drosera-network/drosera-operator:latest
    container_name: drosera-node1
    ports:
      - "${P2P_PORT1}:31313"
      - "${SERVER_PORT1}:31314"
    volumes:
      - drosera_data1:/data
    command: node --db-file-path /data/drosera.db --network-p2p-port 31313 --server-port 31314 --eth-rpc-url Your_RPC_URL_1 --eth-backup-rpc-url https://holesky.drpc.org --drosera-address 0xea08f7d533C2b9A62F40D5326214f39a8E3A32F8 --eth-private-key ${ETH_PRIVATE_KEY} --listen-address 0.0.0.0 --network-external-p2p-address ${VPS_IP} --disable-dnr-confirmation true
    restart: always

  drosera2:
    image: ghcr.io/drosera-network/drosera-operator:latest
    container_name: drosera-node2
    ports:
      - "${P2P_PORT2}:31313"
      - "${SERVER_PORT2}:31314"
    volumes:
      - drosera_data2:/data
    command: node --db-file-path /data/drosera.db --network-p2p-port 31313 --server-port 31314 --eth-rpc-url Your_RPC_URL_2 --eth-backup-rpc-url https://holesky.drpc.org --drosera-address 0xea08f7d533C2b9A62F40D5326214f39a8E3A32F8 --eth-private-key ${ETH_PRIVATE_KEY2} --listen-address 0.0.0.0 --network-external-p2p-address ${VPS_IP} --disable-dnr-confirmation true
    restart: always

volumes:
  drosera_data1:
  drosera_data2:

• Replace RPC_URL_1 & RPC_URL_2 with your own Ethereum Holesky RPC, You can use Alchemy or QuickNode to create Ethereum Holesky RPC.
• You can use same RPCs for both RPC_URL_1 & RPC_URL_2.
• To save: CTRL+X, Y & ENTER

nano .env

Replace the content of the file with the following codes:

ETH_PRIVATE_KEY=
ETH_PRIVATE_KEY2=
VPS_IP=
P2P_PORT1=31313
SERVER_PORT1=31314
P2P_PORT2=31315
SERVER_PORT2=31316

• Enter a value for ETH_PRIVATE_KEY & ETH_PRIVATE_KEY2 (Operators Private key) & VPS_IP.
• To save: CTRL+X, Y & ENTER

Stop old docker node:

docker compose down -v
docker stop drosera-node
docker rm drosera-node

Run Operators:

docker compose up -d

Method 1: Login with your 2nd Operator wallet in Dashboard, and Opt-in to your Trap

Method 2: via CLI

drosera-operator optin --eth-rpc-url https://ethereum-holesky-rpc.publicnode.com --eth-private-key 2nd_Operator_Privatekey --trap-config-address Trap_Address

• Replace 2nd_Operator_Privatekey & Trap_Address

cd ~/Droseta-Network
docker compose up -d

• You will get Green Blocks after a while!

Make sure you are in Operators directory:

cd ~/Droseta-Network

Restart Operators:

docker compose up -d
# OR
docker compose restart

Restart Operators seprately:

docker compose up -d drosera1
docker compose up -d drosera2
# OR
docker compose restart drosera1
docker compose restart drosera2

Kill Operators:

docker compose down -v

White Blocks for an Operator: Restart the Operator seprately until it get fixed