Getting started

From zero to mining.

Equium has two reference miners: a browser-based one at equium.xyz/mine and a native desktop app. Both produce identical on-chain transactions; the desktop app is faster because it runs natively.

Prerequisites

  • A modern CPU with at least 100 MB of free RAM per mining thread.
  • A small amount of SOL for transaction fees. Each mining attempt is a regular Solana transaction; about 0.005 SOL covers ~30 attempts.
  • For the desktop app: macOS 11+, Windows 10/11, or x86_64 Linux. For the browser miner: any current Chromium, Firefox, or Safari build.

Choose a miner

Both miners use the same on-chain program, so they are interchangeable. The difference is operational:

  • Browser miner — visit equium.xyz/mine. The site proxies RPC through its server, so you don't need to provide one. WebAssembly runs the solver, parallelized across workers. Throughput is roughly 2-3x slower per core than native.
  • Desktop app — install from the downloads page. Runs natively, hits the chain through your own Helius endpoint, and stays online without a browser tab. The wallet is encrypted at rest with Argon2id + AES-256-GCM.

Create a wallet

Both miners generate a fresh Solana keypair locally on first run. The secret key never leaves your machine. You will be shown the secret once during setup so you can back it up — there is no recovery if you lose it.

Write down your secret key
Equium does not run a custody service. There is no password reset, no recovery email, and no support channel that can restore access. The backup screen exists for a reason; copy the secret to a password manager or paper before continuing.

Importing an existing key

If you already have a Solana key you'd like to mine with, paste the secret on the import screen. Both base58 (Phantom-style) and the 64-byte JSON array format (Solana CLI's id.json) are accepted.

Fund your wallet

Send a small amount of SOL to your generated address. The dashboard shows the address with a copy button. The address is a regular Solana address, so any wallet works — Phantom, Backpack, a CEX withdrawal, or another wallet you already have funds in. Roughly 0.01 SOL covers a few hours of mining at the current fee market.

Start mining

  1. Wait for the network panel to show Mining open: live. During pre-launch periods this may read waiting on vault — the protocol vault has to be funded by the admin before the first round can open.
  2. Press Start mining. The dashboard begins streaming attempts in the Activity log.
  3. Each successful block credits 25 EQM to your wallet directly. You can stop and resume at any time.

Choosing how many CPU cores to use

The browser miner exposes a cores picker on the dashboard. It defaults to one less than your total core count so the OS and browser remain responsive. The desktop miner currently uses a single worker thread; multi-thread support is on the roadmap.

RPC considerations

The browser miner is served behind a proxied RPC, so casual mining works out of the box. The desktop miner uses the default public Solana endpoint unless you provide your own — public endpoints are rate-limited and slow down considerably under sustained mining load. A free Helius key takes five minutes to set up and gives you 100k requests per day. See the RPC setup guide.

Sending tokens

Both wallets include a Send action that supports SOL and EQM. EQM transfers use SPL transferChecked, so they work whether the mint is classic SPL or Token-2022 — the token program is detected at send time. If the recipient has never held EQM, the sender pays a small one-time SOL fee (~0.002 SOL) to create their associated token account.

Exporting your key

Both apps include an Export secret action that reveals your wallet's base58 secret key after you click through a blur. Use this if you want to move the wallet into Phantom, Backpack, or any standard Solana wallet. After export, treat both copies as the same key.

Next steps

  • Read Protocol for how rounds, retargeting, and halving work.
  • Read Tokenomics for the full supply schedule and what is or isn't reserved.

Building from source

The full miner stack is open source at github.com/HannaPrints/equium. The CLI reference miner is the shortest path to a headless setup:

git clone https://github.com/HannaPrints/equium
cd equium/clients/cli-miner
cargo build --release
./target/release/equium-miner \
  --rpc-url https://mainnet.helius-rpc.com/?api-key=YOUR_KEY \
  --keypair ~/.config/solana/id.json