Mining

Mine webcash with your GPU in the browser, on the command line, or in the cloud.

How Mining Works

Webcash mining is SHA256 proof-of-work. You find a nonce such that SHA256(preimage) has enough leading zero bits to meet the server's difficulty target. A valid solution mints new webcash directly into your wallet.

  1. Fetch current difficulty from the server (GET /api/v1/target)
  2. Derive a mining secret from your wallet's MINING chain
  3. Iterate nonces until the SHA256 hash meets the difficulty
  4. Submit the solution (POST /api/v1/mining_report)
  5. Server validates and mints webcash — already keyed to your wallet

The mined webcash output uses your HD-derived MINING chain secret, so it's automatically recoverable from your mnemonic. No separate claiming step needed.

Browser Mining (Weby Wallet App)

The Weby wallet app mines directly in your browser using WebGPU.

  1. Open the wallet in Chrome 113+ or Edge 113+
  2. Click Start Mining in the Miner panel
  3. The wallet detects your GPU and starts SHA256 hashing
  4. Solutions are submitted automatically — mined webcash appears in your balance

Typical performance: 100-500+ MH/s on discrete GPUs, 10-50 MH/s on integrated GPUs. Mining pauses when the tab is backgrounded.

Requirements: WebGPU-capable browser and GPU. A CPU fallback is available for testnet.

CLI Mining (hrmw)

The hrmw CLI supports CUDA (NVIDIA), Vulkan/wgpu (AMD, Intel, Apple Silicon via Metal), and CPU fallback. Backend order: CUDA > Vulkan/wgpu > CPU.

hrmw webminer bench # benchmark all backends
hrmw webminer start -f --accept-terms # foreground with live logs
hrmw webminer start --accept-terms # background daemon
hrmw webminer start -f --backend gpu --accept-terms # force GPU
hrmw webminer status # check miner status
hrmw webminer stop # stop background miner

Platform notes

  • Apple Silicon — wgpu uses Metal. Run hrmw webminer bench to confirm.
  • NVIDIA — CUDA is preferred when drivers are installed.
  • AMD / Intel — Vulkan via wgpu.

Testnet Mining (webyc)

Testnet difficulty is low (16 bits) — CPU mining completes in seconds. Good for testing.

webyc --network testnet mine

Cloud Mining (Vast.ai)

Rent GPU instances and mine remotely. One command provisions, installs, and starts mining.

hrmw webminer cloud start # provision and start
hrmw webminer cloud start -n 3 # 3 instances in parallel
hrmw webminer cloud status # mining speed, solutions
hrmw webminer cloud stop # stop, recover webcash
hrmw webminer cloud destroy # destroy instance

Setup: register at cloud.vast.ai, add credits, copy your API key, and run hrmw setup to configure it.

SSH keys are derived from your wallet (deterministic — no key files to manage). Mined webcash is recovered locally via deterministic secrets.

Collecting Pending Solutions

hrmw webminer collect

Submits pending solutions that weren't fully reported — cloud instance destroyed mid-submission, network timeout, or abrupt shutdown. Run hrmw webcash recover afterward to pick up the newly accepted webcash.