Skip to content

⛏ Getting Started - Miner

Step 1: Prerequisites

System Requirements
  • CPU: 2+ cores
  • RAM: 8GB+
  • Storage: 50GB+
  • OS: Linux-based (Ubuntu 22.04 LTS+ recommended)
  • Network: Stable internet connection

Step 2: Clone the miner repository

Create a dedicated directory for RedTeam Subnet projects (if not exists):

# Create projects directory:
mkdir -pv ~/workspaces/projects/redteam61

# Enter into projects directory:
cd ~/workspaces/projects/redteam61

Clone the miner repository:

git clone https://github.com/RedTeamSubnet/miner.git && \
    cd miner

Step 3: Run miner node

3.1. Configure active commit file to submit

IMPORTANT

Make sure to change the commit hash with your own pushed docker image SHA256 digest as commit hash in the active_commit.yaml file:

# Copy template active commit file:
cp -v ./templates/configs/active_commit.yaml ./volumes/configs/agent-miner/active_commit.yaml

# Change active commit file with your own commit hash:
nano ./volumes/configs/agent-miner/active_commit.yaml

active_commit.yaml format:

- <CHALLENGE_NAME>---<USERNAME>/<REPO_NAME>@sha256:<DIGEST>

For example:

- ab_sniffer_v5---my_username/my_repo@sha256:abc123def456...
- ada_detection_v3---my_username/my_repo@sha256:abc123def456...

TIP

You can add multiple commits for different challenges in the same active_commit.yaml file.

WARNING

  • Only one commit per challenge is allowed in the active_commit.yaml file. If you add multiple commits for the same challenge, only the last one will be considered during submission and others will be ignored.
  • We are allowing only one commit per challenge/day for submission to avoid spam, abuse, unnecessary network load, and fair evaluation for all participants.

3.2. Configure environment variables

IMPORTANT

Make sure to change the wallet directory, wallet name, and hotkey name variables in the .env file to match your wallet and hotkey:

RT_BTCLI_WALLET_DIR="${HOME}/.bittensor/wallets" # !!! CHANGE THIS TO REAL WALLET DIRECTORY !!!
RT_MINER_WALLET_NAME="miner" # !!! CHANGE THIS TO REAL MINER WALLET NAME !!!
RT_MINER_HOTKEY_NAME="default" # !!! CHANGE THIS TO REAL MINER HOTKEY NAME !!!

# Copy '.env.example' file to '.env' file:
cp -v ./.env.example ./.env

# Edit environment variables to fit in your environment
nano ./.env

3.3. Validate docker compose configuration

# Check docker compose configuration is valid:
./compose.sh validate
# Or:
docker compose config

3.4. Start miner node to submit

# Start docker compose:
./compose.sh start -l
# Or:
docker compose up -d --remove-orphans --force-recreate && \
    docker compose logs -f --tail 100

IMPORTANT

  • You need to keep the miner node running continuously to submit solutions and earn rewards during the challenge period (at 2 least days).
  • Stopping the miner node could halt submission communications with validators and affect your earnings.

Step 4: Monitor your miner

  • Visit the RedTeam Dashboard to monitor your miner's performance, score, and our evaluation system feedback.
  • Check miner status on RedTeam Subne:
# Check subnet seat info:
btcli subnet show --netuid 61

# Check miner wallet status:
btcli wallet overview \
    --wallet-path ~/.bittensor/wallets \
    --wallet-name my_wallet \
    --wallet-hotkey my_hotkey \
    --netuid 61 \
    --verbose

Step 5: Optimize your solution

  • Check submission analysis and feedback on the RedTeam Dashboard
  • Based on scores and feedback, refine and improve your solution.
  • Rebuild and republish your docker image with the updated solution.
  • Update the active_commit.yaml file with the new commit hash.
  • Restart the miner node to resubmit the improved solution.

Step 6: Check your rewards

  • After successful scoring and validation, rewards will be distributed to your registered wallet based on your performance.
  • Ensure your wallet is secure and monitor your balance regularly.
  • Check your wallet balance to see the rewards earned:
btcli wallet balance \
    --wallet-path ~/.bittensor/wallets \
    --wallet-name my_wallet \
    --wallet-hotkey my_hotkey \
    --verbose

Next steps