Drosera-Network

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

Recommended System Requirements

• 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.

Install Dependecies

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

Trap Setup

1. Configure Enviorments

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

---

2. Deploy Contract & Trap

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.

---

3. Check Trap in Dashboard

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.

---

4. Bloom Boost Trap

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

5. Fetch Blocks

drosera dryrun

• You can

---

Operator Setup

1. Whitelist Your Operator

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.

---

2. Operator CLI

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

3. Install Docker image

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

---

4. Register Operator

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.

---

5. Open Ports

# 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

---

6. Install & Run Operator

Choose one Installation Method:

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

Method 1: Docker

6-1-1: Configure Docker

• 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.

6-1-2: Run Operator

docker compose up -d

6-1-3: Check health

docker logs -f drosera-node

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

6-1-4: Optional Docker commands

# 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.

---

Method 2: SystemD

6-2-1: Configure SystemD service file

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

6-2-2: Run Operator

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

# start systemd
sudo systemctl start drosera

6-2-3: Check Node Health

journalctl -u drosera.service -f

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

6-2-4: Optional commands

# Stop node
sudo systemctl stop drosera

# Restart node
sudo systemctl restart drosera

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

7. Opt-in Trap

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

---

8. Check Node Liveness

Your node will start producing greeen blocks in the dashboard

---

Run 2nd Operators

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

1- Stop SystemD if ruuning operator using it.

sudo systemctl stop drosera
sudo systemctl disable drosera

2- Whitelist Your 2nd Operator

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.

3- Register 2nd Operator

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.

4- Open Ports

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

5- Edit docker-compose.yaml

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

5- Edit .env

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

6- Run Operators

Stop old docker node:

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

Run Operators:

docker compose up -d

7- Opt-in 2nd Operator

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

8- Restart Operators

cd ~/Droseta-Network
docker compose up -d

• You will get Green Blocks after a while!

9- Useful Commands (If Running Two Operators)

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