UpdateKeryx (KRX) is now supportedKeryx (KRX) mining is now available on NushyPool. Use the official keryx-miner; pool port 40016, SOLO port 45016.
Updated: 2026-11-20 12:00 UTCRead more...

Mining Keryx (KRX)

GPU mining guide for Keryx — Proof-of-Model v5, model tiers and NushyPool connection settings.

From Mining Guides

How to mine Keryx (KRX) with GPU

Keryx is a GHOSTDAG BlockDAG with 10 blocks per second. Its proof of work is Proof-of-Model (PoM): a GPU must hold a complete AI model in VRAM to mine, and the model tier scales the miner's share of the block reward. This guide connects the official keryx-miner to NushyPool in a few minutes.




What makes Keryx different

Keryx is not a plain hash race. Every nonce walks the weights of the model resident on the GPU, so a miner without the model cannot produce a valid proof. The same model answers on-chain inference requests, and every node verifies that the answer came from the declared model.

One GPU holds one model tier. The largest model that fits in VRAM sets the tier — from Qwen3.5-9B on 8 GB cards to Kimi-Linear-48B on 32 GB cards. Higher tiers receive a larger share of the 75% miner cut; the part scaled away is burned.

The miner cut also depends on the KRX held by the payout address (holder multiplier). Mining payouts and the holder balance both matter, so use the wallet you intend to keep the coins in.

Proof-of-Model is pool-safe: every node re-executes the whole walk from the block proof against the model's weight Merkle root.




Before you start


You need:

  • NVIDIA GPU from Volta to Blackwell (GTX 16xx, RTX 20/30/40/50, V100, A100, H100, B200). Pascal (GTX 10xx) is not supported.
  • At least 8 GB of VRAM for the smallest tier; 16 GB or more is the practical default.
  • NVIDIA driver 525 or newer (CUDA 12 era). The release packages include the CUDA runtime libraries.
  • Linux with glibc 2.34+, Windows 10/11, or HiveOS.
  • Disk space and RAM for the model — roughly 8 GB for the smallest tier and 32 GB for the largest.

The miner downloads the model on first start. A slow IPFS connection delays the first share, not the setup.




Create a wallet


Use a Keryx wallet you control. The easiest option is the official web wallet: Keryx web wallet

Your payout address starts with keryx:. Do not use an address from a service that does not support KRX mining payouts.




Download keryx-miner


Download the latest release for your platform from the official repository: keryx-miner releases

Keep keryx-miner, libkeryxcuda.so and libkeryx-llama.so in the same directory. On HiveOS use the custom miner archive from the same release page.




Choose a model tier


The tier flag decides which model the miner must hold. Without a flag the miner uses the default 16 GB tier.

Tier Model Min VRAM Miner reward
--very-light Qwen3.5-9B 8 GB+ 60%
--light GLM-4-9B 12 GB+ 70%
default Gemma-4-12B 16 GB+ 80%
--high Qwen3.6-27B 24 GB+ 90%
--very-high Kimi-Linear-48B 32 GB+ 100%

The tier reward scales the miner's 75% block cut. A higher tier pays more, but only if the GPU can really hold the model.

On the first run the model is fetched over IPFS and cached next to the binary (models/<name>/model.gguf). Use --models-dir to change the location or install the archive manually.

Optional: --resident-tree keeps the model's Merkle tree in RAM (about 2× the model size) and builds proofs faster.

Connect to NushyPool

Use the pool port for shared mining or the SOLO port for winner-takes-all credits:

Region Host Pool port SOLO port
Europe / South America nushypool.com 40016 45016
North America us.nushypool.com 40016 45016
Asia as.nushypool.com 40016 45016

Europe and South America share nushypool.com.




Start mining


Pool mode (recommended):

./keryx-miner --keryxd-address stratum+tcp://nushypool.com:40016 --mining-address keryx:YOUR_ADDRESS.worker1

SOLO mode:

./keryx-miner --keryxd-address stratum+tcp://nushypool.com:45016 --mining-address keryx:YOUR_ADDRESS.worker1

Pick a tier explicitly, for example on an 8 GB card:

./keryx-miner --very-light --keryxd-address stratum+tcp://nushypool.com:40016 --mining-address keryx:YOUR_ADDRESS.worker1

Or on a 24 GB card:

./keryx-miner --high --keryxd-address stratum+tcp://nushypool.com:40016 --mining-address keryx:YOUR_ADDRESS.worker1

On HiveOS, install the archive as a custom miner and use the same host, port, wallet and worker fields.




Payouts and fees


NushyPool charges a 1% commission. Pool mode uses captured-round allocation; SOLO mode credits the finder only.

A positive mining reward settles 1000 DAA after the block is accepted. KRX payouts are sent when the balance reaches 20 KRX; the network fee is at least 0.3 KRX per transaction.

Check balances and blocks in the Keryx explorer: Keryx explorer




Troubleshooting


  • The miner exits before the first share: check the driver version (525+), the VRAM of the selected card and the model folder. A missing or damaged model file is reported before mining starts.
  • IPFS is blocked: download the model archive for your tier from the official model list and unpack it into the models directory.
  • Wrong tier or "model too large": the miner falls back to a smaller tier when the card cannot hold the requested model; remove the flag or choose --very-light / --light.
  • No shares for a long time on a slow card: PoM is compute-heavy; compare your hashrate with the pool statistics and the tier table.

Last updated: November 19, 2026.
Keryx parameters and tier requirements follow the official Keryx documentation. NushyPool does not provide its own Keryx miner.

About Keryx

Keryx is a GHOSTDAG BlockDAG for verifiable on-chain AI inference. Miners prove model possession with Proof-of-Model and earn KRX for blocks and inference.