Settlement-first SHA-256d proof-of-work blockchain for trustless commerce.

Download the Irium Core desktop app: https://github.com/iriumlabs/irium-core/releases/latest

Bundles iriumd, irium-wallet, and the CPU/GPU miners. Builds for Windows, macOS, and Linux. Handles wallet creation, marketplace, pool mining, settlement, and explorer in one window. No terminal required.

Use the command-line tooling below if you need a server install, automation, or want to build from source.

The chain activates Bitcoin-standard block-header serialization at block 23,500. Every node must run iriumd v1.9.28 or newer before block 23,500 is mined. Older nodes will compute the wrong header hash for post-fork blocks and fork off from the canonical chain. Mainnet tip is currently ~22,500; activation is days away at the current cadence.

The desktop app's auto-update prompt will surface the same warning. Server / pool / ASIC operators should git pull && cargo build --release (or pull the v1.9.28 release binary) and restart iriumd before activation.

Irium is a proof-of-work blockchain built for trustless escrow and proof-based commerce. Instead of smart contracts, it uses a deterministic settlement layer: buyer and seller lock funds on-chain, an attestor submits a cryptographic proof of delivery, and the chain enforces release or refund automatically. No lawyers, no chargebacks, no intermediaries.

SHA-256d consensus. No premine. No admin keys. 100,000,000 IRM total supply (96.5M from mining + 3.5M genesis CLTV vesting). Mainnet live since January 5, 2026.

Option 0 — Irium Core desktop app (recommended for most users)

Download the latest installer for Windows, macOS, or Linux from https://github.com/iriumlabs/irium-core/releases/latest. The app bundles the v1.9.49 sidecars, runs the node + wallet + miner in one window, and ships pool client + marketplace + settlement Hub.

The CLI options below are for power users, server operators, and developers.

Option 1 — Pre-built binary (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/iriumlabs/irium/main/install.sh | bash

Installs iriumd, irium-wallet, irium-miner, and irium-miner-gpu to /usr/local/bin.

Option 2 — Docker

cp .env.example .env   # fill in your wallet address
docker-compose up -d

Option 3 — Build from source

git clone https://github.com/iriumlabs/irium.git && cd irium
cargo build --release

GPU miner:

cargo build --release --features gpu --bin irium-miner-gpu

Web developers can integrate Irium settlement into their apps using the official TypeScript SDK:

npm install irium-js

Full documentation and examples at sdk/irium-js/. Covers agreement lifecycle, proof submission, offer feed, real-time WebSocket events, and chain queries.

iriumd                              # start the node (syncs automatically)
curl http://127.0.0.1:38300/status  # confirm it is running
irium-wallet new-address            # generate your first address
irium-wallet list-addresses         # see your addresses
irium-wallet balance <YOUR_ADDRESS> # check balance once synced

The node connects to the Irium network automatically. On first run it uses the signed seed list bundled with the software. After the first connection it caches peer addresses locally and never needs the seed nodes again. No configuration needed for a basic setup. Default P2P port: 38291. Default RPC port: 38300.

Public pool stats live at https://pool.iriumlabs.org/stats and at the raw proxy http://pool.iriumlabs.org:3337/stats (CORS-enabled JSON with active miners, accepted shares, blocks found, current share difficulty, and a rolling-window hashrate estimate per profile).

After block 23,500 activates Fix 2a, every SHA-256d miner (ASIC, GPU, CPU) that submits valid work earns real block rewards directly to the IRM address used as the Stratum worker name — the pool runs in SOLO payout mode (no fee, no aggregation).

If your node has a public IP address, you can help new users bootstrap by advertising your address. Two complementary mechanisms exist:

Coinbase peer-discovery embed — your miner stamps the listen address into every coinbase transaction so new nodes scanning the chain discover you without DNS or a central seed server:

export IRIUM_ADVERTISE_ADDR=<your-public-ip>:38291

P2P handshake external endpoint — your node tells each peer the IP they should record as your dialable address. This is the CGNAT escape hatch: without it, peers infer your address from the TCP source IP, which under carrier-grade NAT (RFC 6598, 100.64.0.0/10) is the carrier's NAT address rather than your real public IP. Set this when you know your real external IPv4:

export IRIUM_EXTERNAL_ENDPOINT=<your-public-ip>:38291

iriumd validates the value (rejects RFC1918 private, RFC6598 CGNAT, loopback, link-local, multicast, documentation, and IPv6) before advertising it. Old peers without the field simply fall back to the TCP-source-IP behavior, so this is fully backwards compatible.

To add your node as a seed for a running node without restarting:

curl -X POST http://localhost:38300/admin/add-seed \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"addr": "<your-public-ip>:38291"}'

If your ISP gives you a 100.64.0.0/10 address rather than a real public IP, peers that observe your TCP source IP record an unroutable address and gossip it onwards. Symptoms: 0 inbound peers indefinitely, even with port forwarding configured on the local router.

Fixes, in order of impact:

1. Ask your ISP for a public IPv4 (many offer it free on request) — then set IRIUM_EXTERNAL_ENDPOINT=<that-public-ip>:38291.
2. Run a small relay on a VPS and forward port 38291 to your home node.
3. Accept outbound-only operation: iriumd still syncs and submits transactions, you just don't accept inbound connections.

The desktop wallet (irium-core) auto-detects your public IPv4 via an external IP-echo service before launching iriumd, and only sets IRIUM_EXTERNAL_ENDPOINT when the result validates as globally routable. Manual CLI users on cloud servers should set the env var explicitly.

The minimum commands for a complete buyer–seller trade:

# Seller: create an offer
irium-wallet offer-create \
  --seller <YOUR_ADDRESS> \
  --amount 1.0 \
  --description "Software licence delivery" \
  --policy-template software_delivery

# Buyer: list open offers and take one
irium-wallet offer-list --status open
irium-wallet offer-take --offer <OFFER_ID> --buyer <BUYER_ADDRESS>

# Attestor or seller: submit delivery proof
irium-wallet agreement-proof-submit --proof proof.json

# Check release eligibility (true after 6-block finality)
irium-wallet agreement-release-eligibility <AGREEMENT_HASH>

Full walkthrough: QUICKSTART.md | API reference: docs/API.md

MIT