MINING

Mining (Beginner Friendly)

Run the node first, then the miner. Use your own wallet address for rewards.

1) Build

git clone https://github.com/iriumlabs/irium.git
cd irium
source ~/.cargo/env
cargo build --release

2) Start the node (leave running)

./target/release/iriumd

sudo systemctl enable --now iriumd
sudo journalctl -u iriumd -f

3) Create a wallet address

./target/release/irium-wallet init
./target/release/irium-wallet new-address
./target/release/irium-wallet list-addresses

4) Start mining

export IRIUM_MINER_ADDRESS=<YOUR_IRIUM_ADDRESS>
./target/release/irium-miner --threads 2

Tip: the miner auto-loads /etc/irium/miner.env if it exists. Shell exports override the file.

Optional: set an RPC token (fixes HTTP 429)

export IRIUM_RPC_TOKEN=$(openssl rand -hex 24)
# use the same token for node + miner

Remote node (miner only)

export IRIUM_NODE_RPC=http://<node-ip>:38300

Common fixes

• Miner starts at height 1 → the node is not running or the RPC URL is wrong.
• HTTP 401 → token mismatch. Use the same IRIUM_RPC_TOKEN in node and miner.
• HTTP 429 → set a token or raise IRIUM_RATE_LIMIT_PER_MIN on the node.

Check logs

sudo journalctl -u irium-miner -f

API examples

Base: https://api.iriumlabs.org/

curl https://api.iriumlabs.org/api/stats
curl https://api.iriumlabs.org/api/block/1
curl "https://api.iriumlabs.org/api/blocks?limit=10"

Docs: Quickstart