Operator

Prerequisites

Hardware
Minimum Spesification

CPU

2 Cores

RAM

4 GB

Disk

20 GB

Install Depedencies

Update & Upgrade your system

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

Install Docker

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 -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

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

If you get a Warning message, just ignore it.

Deploy Trap:

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

  • Replace xxx with your EVM wallet privatekey (Ensure it's funded with Holesky ETH)

  • Replace your-rpc with your Holesky ETH RPC, you can get it from Alchemy for free

  • Enter the command, when prompted, write ofc and press Enter.

If you don't see your trap's address as address = "0x..." line, Then follow the steps:

  • Connect to the Dashboard using same account you used to deploy your trap:

  • Select the “Traps Owned” button to display only traps that your account owns

  • On the trap’s page, click on the “Trap Config” address hyperlink. This will open a page to holesky etherscan.

  • Click the button to copy the contract’s address

Add your trap address to drosera.toml file, by adding this line: address = "TRAP_ADDRESS" in the bottom.

whitelist = ["Operator1_Address/Your-Wallet-Address"]
address = "TRAP_ADDRESS"

Re-apply your trap configuration

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

3. Check Trap in Dashboard

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

  • 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

6. Whitelist Your Operator

Edit Trap configuration

cd my-drosera-trap
nano drosera.toml

Add the following codes at the bottom of drosera.toml

private_trap = true
whitelist = ["Operator1_Address/Your-Wallet-Address"]

  • Replace Operator_Address with your EVM wallet Public Address

  • Your Public Address is your Operator_Address.

Update Trap Configuration

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

Install & Run Operator

Install Drosera Operator CLI

cd ~
curl -LO https://github.com/drosera-network/releases/releases/download/v1.17.2/drosera-operator-v1.17.2-x86_64-unknown-linux-gnu.tar.gz
tar -xvf drosera-operator-v1.17.2-x86_64-unknown-linux-gnu.tar.gz

  • Currently the Operator CLI version is v1.17.2. Verify the latest version here

  • You have to get the link of drosera-operator-v1.x.x-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

Install Docker image

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

Register Operator

drosera-operator register --eth-rpc-url your-holesky-rpc --eth-private-key your-private-key

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

Installation Via Docker

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

Edit docker-compose.yaml file:

nano docker-compose.yaml

  • Replace default --eth-rpc-url to your private Alchemy or QuickNode Ethereum Holesky RPCs.

Run Operator Via Docker

docker compose up -d
# Check health
docker logs -f drosera-node

# Stop node
docker compose down -v

# Restart node
docker compose up -d

7. Opt-in Trap

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

PreviousInstallationNextAdd Second Operator

Last updated