Comment miner Keryx (KRX) avec un GPU
Keryx est un BlockDAG GHOSTDAG à 10 blocs par seconde. Sa preuve de travail est Proof-of-Model (PoM) : un GPU doit garder un modèle d'IA complet en VRAM pour miner, et le niveau du modèle détermine la part du mineur dans la récompense de bloc. Ce guide connecte le keryx-miner officiel à NushyPool en quelques minutes.
Ce qui distingue Keryx
Keryx n'est pas une simple course au hachage. Chaque nonce parcourt les poids du modèle résident sur le GPU : un mineur sans le modèle ne peut pas produire de preuve valide. Le même modèle répond aux requêtes d'inférence on-chain, et chaque nœud vérifie que la réponse provient bien du modèle déclaré.
Un GPU ne détient qu'un seul niveau de modèle. Le plus grand modèle qui tient en VRAM fixe le niveau — de Qwen3.5-9B sur les cartes 8 Go à Kimi-Linear-48B sur les cartes 32 Go. Les niveaux supérieurs reçoivent une plus grande part des 75 % de la récompense mineur ; la partie retirée est brûlée.
La part du mineur dépend aussi des KRX détenus par l'adresse de paiement (multiplicateur de détenteur). Les paiements de minage et le solde détenu comptent tous les deux : utilisez le portefeuille dans lequel vous comptez conserver les pièces.
Proof-of-Model est compatible avec les pools : chaque nœud réexécute toute la marche à partir de la preuve du bloc, contre la racine Merkle des poids du modèle.
Avant de commencer
Vous avez besoin de :
- GPU NVIDIA de Volta à Blackwell (GTX 16xx, RTX 20/30/40/50, V100, A100, H100, B200). Pascal (GTX 10xx) n'est pas pris en charge.
- Au moins 8 Go de VRAM pour le plus petit niveau ; 16 Go ou plus est le standard pratique.
- Pilote NVIDIA 525 ou plus récent (ère CUDA 12). Les paquets de release incluent les bibliothèques d'exécution CUDA.
- Linux avec glibc 2.34+, Windows 10/11 ou HiveOS.
- Espace disque et RAM pour le modèle — environ 8 Go pour le plus petit niveau et 32 Go pour le plus grand.
Le mineur télécharge le modèle au premier démarrage. Une connexion IPFS lente retarde le premier share, pas l'installation.
Créer un portefeuille
Utilisez un portefeuille Keryx que vous contrôlez. Le plus simple est le portefeuille web officiel : Portefeuille web Keryx
Votre adresse de paiement commence par keryx:. N'utilisez pas une adresse d'un service qui ne prend pas en charge les paiements de minage KRX.
Télécharger keryx-miner
Téléchargez la dernière version pour votre plateforme depuis le dépôt officiel : Versions de keryx-miner
Gardez keryx-miner, libkeryxcuda.so et libkeryx-llama.so dans le même répertoire. Sur HiveOS, utilisez l'archive de mineur personnalisé de la même page de version.
Choisir un niveau de modèle
Le flag de niveau détermine le modèle que le mineur doit détenir. Sans flag, le mineur utilise le niveau par défaut de 16 Go.
| Niveau | Modèle | VRAM min. | Récompense mineur |
|---|---|---|---|
--very-light |
Qwen3.5-9B | 8 GB+ | 60% |
--light |
GLM-4-9B | 12 GB+ | 70% |
par défaut |
Gemma-4-12B | 16 GB+ | 80% |
--high |
Qwen3.6-27B | 24 GB+ | 90% |
--very-high |
Kimi-Linear-48B | 32 GB+ | 100% |
La récompense du niveau applique un coefficient à la part de 75 % du mineur. Un niveau plus élevé paie davantage, mais seulement si le GPU peut réellement contenir le modèle.
Au premier lancement, le modèle est récupéré via IPFS et mis en cache à côté du binaire (models/<name>/model.gguf). Utilisez --models-dir pour changer l'emplacement ou installez l'archive manuellement.
Option : --resident-tree garde l'arbre de Merkle du modèle en RAM (environ 2× la taille du modèle) et construit les preuves plus vite.
Utilisez le port Pool pour le minage partagé ou le port SOLO pour des crédits winner-takes-all :
| Région | Hôte | Port Pool | Port SOLO |
|---|---|---|---|
| Europe / Amérique du Sud | nushypool.com |
40016 |
45016 |
| Amérique du Nord | us.nushypool.com |
40016 |
45016 |
| Asie | as.nushypool.com |
40016 |
45016 |
L'Europe et l'Amérique du Sud partagent nushypool.com.
Démarrer le minage
Mode Pool (recommandé) :
./keryx-miner --keryxd-address stratum+tcp://nushypool.com:40016 --mining-address keryx:YOUR_ADDRESS.worker1
Mode SOLO :
./keryx-miner --keryxd-address stratum+tcp://nushypool.com:45016 --mining-address keryx:YOUR_ADDRESS.worker1
Choisissez un niveau explicitement, par exemple sur une carte 8 Go :
./keryx-miner --very-light --keryxd-address stratum+tcp://nushypool.com:40016 --mining-address keryx:YOUR_ADDRESS.worker1
Ou sur une carte 24 Go :
./keryx-miner --high --keryxd-address stratum+tcp://nushypool.com:40016 --mining-address keryx:YOUR_ADDRESS.worker1
Sur HiveOS, installez l'archive comme mineur personnalisé et utilisez les mêmes champs host, port, portefeuille et worker.
Paiements et frais
NushyPool prélève une commission de 1 %. Le mode Pool utilise la répartition captured-round ; le mode SOLO crédite uniquement le trouveur.
Une récompense de minage positive est réglée 1000 DAA après l'acceptation du bloc. Les paiements KRX sont envoyés lorsque le solde atteint 20 KRX ; les frais réseau sont d'au moins 0,3 KRX par transaction.
Consultez les soldes et les blocs dans l'explorateur Keryx : Explorateur Keryx
Dépannage
- Le mineur s'arrête avant le premier share : vérifiez la version du pilote (525+), la VRAM de la carte choisie et le dossier des modèles. Un fichier de modèle manquant ou endommagé est signalé avant le démarrage du minage.
- IPFS est bloqué : téléchargez l'archive du modèle correspondant à votre niveau depuis la liste officielle et décompressez-la dans le dossier des modèles.
- Mauvais niveau ou « modèle trop volumineux » : le mineur retombe sur un niveau inférieur lorsque la carte ne peut pas contenir le modèle demandé ; retirez le flag ou choisissez --very-light / --light.
- Aucun share pendant longtemps sur une carte lente : PoM est gourmand en calcul ; comparez votre hashrate aux statistiques du pool et au tableau des niveaux.
Dernière mise à jour : 19 novembre 2026.
Les paramètres de Keryx et les exigences de niveau suivent la documentation officielle Keryx. NushyPool ne fournit pas son propre mineur Keryx.