Come minare Keryx (KRX) con la GPU
Keryx è un BlockDAG GHOSTDAG con 10 blocchi al secondo. La proof of work è Proof-of-Model (PoM): una GPU deve tenere un modello AI completo in VRAM per minare, e il livello del modello determina la quota del miner sulla ricompensa del blocco. Questa guida collega il keryx-miner ufficiale a NushyPool in pochi minuti.
Cosa rende diverso Keryx
Keryx non è una semplice corsa agli hash. Ogni nonce percorre i pesi del modello residente sulla GPU, quindi un miner senza il modello non può produrre una proof valida. Lo stesso modello risponde alle richieste di inferenza on-chain e ogni nodo verifica che la risposta provenga dal modello dichiarato.
Una GPU tiene un solo livello di modello. Il modello più grande che entra nella VRAM determina il livello: da Qwen3.5-9B sulle schede da 8 GB a Kimi-Linear-48B sulle schede da 32 GB. I livelli superiori ricevono una quota maggiore del 75% del miner; la parte ridotta viene bruciata.
La quota del miner dipende anche dai KRX detenuti dall'indirizzo di pagamento (moltiplicatore holder). Contano sia i pagamenti di mining sia il saldo detenuto, quindi usa il wallet in cui intendi conservare le monete.
Proof-of-Model è pool-safe: ogni nodo riesegue l'intero walk dalla proof del blocco contro la radice Merkle dei pesi del modello.
Prima di iniziare
Ti serve:
- GPU NVIDIA da Volta a Blackwell (GTX 16xx, RTX 20/30/40/50, V100, A100, H100, B200). Pascal (GTX 10xx) non è supportato.
- Almeno 8 GB di VRAM per il livello più piccolo; 16 GB o più è lo standard pratico.
- Driver NVIDIA 525 o successivo (era CUDA 12). I pacchetti release includono le librerie runtime CUDA.
- Linux con glibc 2.34+, Windows 10/11 o HiveOS.
- Spazio su disco e RAM per il modello: circa 8 GB per il livello più piccolo e 32 GB per il più grande.
Il miner scarica il modello al primo avvio. Una connessione IPFS lenta ritarda il primo share, non la configurazione.
Creare un wallet
Usa un wallet Keryx che controlli. L'opzione più semplice è il wallet web ufficiale: Wallet web Keryx
Il tuo indirizzo di pagamento inizia con keryx:. Non usare un indirizzo di un servizio che non supporta i pagamenti di mining KRX.
Scaricare keryx-miner
Scarica l'ultima versione per la tua piattaforma dal repository ufficiale: Release di keryx-miner
Tieni keryx-miner, libkeryxcuda.so e libkeryx-llama.so nella stessa cartella. Su HiveOS usa l'archivio custom miner della stessa pagina delle release.
Scegliere un livello del modello
Il flag del livello decide quale modello deve tenere il miner. Senza flag, il miner usa il livello predefinito da 16 GB.
| Livello | Modello | VRAM min. | Ricompensa miner |
|---|---|---|---|
--very-light |
Qwen3.5-9B | 8 GB+ | 60% |
--light |
GLM-4-9B | 12 GB+ | 70% |
predefinito |
Gemma-4-12B | 16 GB+ | 80% |
--high |
Qwen3.6-27B | 24 GB+ | 90% |
--very-high |
Kimi-Linear-48B | 32 GB+ | 100% |
La ricompensa del livello scala la quota del 75% del miner. Un livello più alto paga di più, ma solo se la GPU può davvero tenere il modello.
Al primo avvio il modello viene scaricato via IPFS e memorizzato accanto al binario (models/<name>/model.gguf). Usa --models-dir per cambiare posizione o installa l'archivio manualmente.
Opzionale: --resident-tree tiene l'albero Merkle del modello in RAM (circa 2× la dimensione del modello) e costruisce le proof più velocemente.
Usa la porta Pool per il mining condiviso o la porta SOLO per crediti winner-takes-all:
| Regione | Host | Porta Pool | Porta SOLO |
|---|---|---|---|
| Europa / Sud America | nushypool.com |
40016 |
45016 |
| Nord America | us.nushypool.com |
40016 |
45016 |
| Asia | as.nushypool.com |
40016 |
45016 |
Europa e Sud America condividono nushypool.com.
Avviare il mining
Modalità Pool (consigliata):
./keryx-miner --keryxd-address stratum+tcp://nushypool.com:40016 --mining-address keryx:YOUR_ADDRESS.worker1
Modalità SOLO:
./keryx-miner --keryxd-address stratum+tcp://nushypool.com:45016 --mining-address keryx:YOUR_ADDRESS.worker1
Scegli un livello esplicitamente, per esempio su una scheda da 8 GB:
./keryx-miner --very-light --keryxd-address stratum+tcp://nushypool.com:40016 --mining-address keryx:YOUR_ADDRESS.worker1
Oppure su una scheda da 24 GB:
./keryx-miner --high --keryxd-address stratum+tcp://nushypool.com:40016 --mining-address keryx:YOUR_ADDRESS.worker1
Su HiveOS installa l'archivio come custom miner e usa gli stessi campi host, porta, wallet e worker.
Pagamenti e commissioni
NushyPool applica una commissione dell'1%. La modalità Pool usa l'allocazione captured-round; la modalità SOLO accredita solo chi trova il blocco.
Una ricompensa di mining positiva viene regolata 1000 DAA dopo l'accettazione del blocco. I pagamenti KRX vengono inviati quando il saldo raggiunge 20 KRX; la commissione di rete è di almeno 0,3 KRX per transazione.
Controlla saldi e blocchi nell'explorer di Keryx: Explorer di Keryx
Risoluzione dei problemi
- Il miner si chiude prima del primo share: controlla la versione del driver (525+), la VRAM della scheda scelta e la cartella dei modelli. Un file del modello mancante o danneggiato viene segnalato prima dell'avvio del mining.
- IPFS è bloccato: scarica l'archivio del modello per il tuo livello dalla lista ufficiale e decomprimilo nella cartella dei modelli.
- Livello errato o «modello troppo grande»: il miner passa a un livello inferiore quando la scheda non può tenere il modello richiesto; rimuovi il flag o scegli --very-light / --light.
- Nessuno share per molto tempo su una scheda lenta: PoM è pesante da calcolare; confronta il tuo hashrate con le statistiche del pool e la tabella dei livelli.
Ultimo aggiornamento: 19 novembre 2026.
I parametri di Keryx e i requisiti dei livelli seguono la documentazione ufficiale di Keryx. NushyPool non fornisce un proprio miner Keryx.