Guide de démarrage

Ce qu'est le pool, comment installer le client et comment fonctionne le scan.

Qu'est-ce que btcpuzzle.info ?

btcpuzzle.info est un pool solo créé spécialement pour les Bitcoin Puzzles (ou challenges). Il est open source et digne de confiance. Il fonctionne par preuve de travail (PoW) et est protégé contre les attaques malveillantes. Pour rejoindre le pool, vous devez utiliser un client. Ce client est open source, et chacun peut développer son propre client s'il le souhaite. Dans ce guide, la procédure pour rejoindre le pool est expliquée avec notre client officiel.

Qu'est-ce qu'un BTC Puzzle (challenge) ?

Un BTC Puzzle ne correspond pas tout à fait à ce que son nom suggère. Il a été créé de façon totalement anonyme et contient des récompenses totalisant plus de 1 000 BTC. Pour faire simple, un puzzle consiste à trouver le bon nombre dans une plage précise comprise entre deux nombres. Mais avec la technologie actuelle et l'architecture de la blockchain Bitcoin, la difficulté augmente à mesure que ces plages s'agrandissent. C'est pourquoi un pool est nécessaire.

btcpuzzle.info est un pool solo : celui qui trouve la solution reçoit la récompense. Les plages scannées, elles, sont partagées. Une plage déjà scannée par un participant ne peut pas être scannée à nouveau par un autre.

Vous trouverez ci-dessous les liens importants liés à ce projet. Si vous avez besoin d'aide supplémentaire, vous pouvez nous contacter via la section support ci-dessous.

Guides & documentation

Compilez-le vous-même

Vous pouvez compiler vous-même le client et toutes les applications utilisées. Client & applications 100 % open source.

Preuve de travail (PoW)

Quand vous demandez une plage au pool, six adresses de portefeuille sont également renvoyées. Les clés privées de ces adresses sont scannées en même temps. Pour garantir qu'une plage a bien été scannée, les clés privées des six adresses doivent toutes être trouvées. Les clés privées des adresses trouvées sont hachées en SHA256. C'est ainsi qu'est créée la "Proof Key" (clé de preuve). Cela permet de s'assurer que votre programme fonctionne correctement, et que votre scan est réellement sain.

Exemple : le pool renvoie la plage HEX 3E2ECB0 à scanner. Le pool génère aléatoirement 6 clés privées supplémentaires dans la plage HEX renvoyée, entre 3E2ECB00000000000 et 3E2ECB0FFFFFFFFFF.

Le marquage se fait avec

SHA256(PROOFKEY1+PROOFKEY2+PROOFKEY3+PROOFKEY4+PROOFKEY5+PROOFKEY6)

Remarque : le nombre de clés de preuve peut être augmenté ou diminué dynamiquement par l'API. Par défaut, il y en a 6 au total.

Comment rejoindre le pool ?

Rejoindre le pool est assez simple. Il vous faut au minimum une carte graphique Nvidia. Vous pouvez aussi participer facilement via CloudSearch.

Guide pas à pas

  1. 01

    Créez un compte sur le site BTCPuzzle.info et récupérez votre token utilisateur.

  2. 02

    Téléchargez la dernière version du client Btcpuzzle.info ou compilez-le vous-même.

  3. 03

    Modifiez le fichier pool.conf selon vos besoins.

  4. 04

    Lancez l'application.

CloudSearch

Si vous cherchez le moyen le plus simple de rejoindre le pool, vous êtes au bon endroit. Louez la carte graphique de votre choix à l'heure et visez la récompense. Rendez-vous sur CloudSearch par btcpuzzle.info.

  1. 01

    Créez un compte sur le site BTCPuzzle.info et activez votre compte CloudSearch.

  2. 02

    Rechargez votre solde (USD) via Polygon, Base, ETH et de nombreux autres réseaux.

  3. 03

    Créez un modèle et louez l'instance de votre choix. C'est tout !

Client Btcpuzzle.info

Cette section présente les fonctions du client btcpuzzle.info. Les fonctions prises en charge et l'utilisation du client y sont décrites en détail. Pour toute question, vous pouvez obtenir de l'aide dans le groupe Telegram. L'ancien client utilisé par btcpuzzle.info, "“btcpuzzle-client”", n'est plus utilisé ni développé.

Paramètres (pool.conf)

# Client Pool Configuration # https://btcpuzzle.info

# Required: Your user token from btcpuzzle.info
user_token=

# Worker name (leave empty for auto-generated)
worker_name=

# Target puzzle
target_puzzle=71

# GPU Settings
gpu_index=0

# Security
untrusted_computer=false
public_key=

# Telegram Notifications
telegram_share=false
telegram_token=
telegram_chat_id=

# API Share (Custom webhook)
api_share=false
api_share_url=

# Save RSA encrypted key to btcpuzzle.info
save_key=false

# Other Settings
custom_range=none

Vous pouvez modifier les paramètres de l'application via le fichier pool.conf ou dans l'application. Vous pouvez créer votre fichier de paramètres depuis le tableau de bord de btcpuzzle.info. Vous pouvez aussi passer des arguments à l'application, comme dans l'exemple ci-dessous.

btcpuzzle.exe -puzzle 71 -worker YourWorkerName001 -token YourUserTokenFromBtcpuzzle.info
./btcpuzzle -puzzle 71 -worker YourWorkerName001 -token YourUserTokenFromBtcpuzzle.info

[user_token]

Vous pouvez créer la valeur du token utilisateur en vous connectant à votre compte sur btcpuzzle.info. Si vous n'avez pas de compte, vous pouvez en créer un avec votre adresse e-mail (vous définissez ensuite votre adresse de portefeuille dans les paramètres du compte).

Vous pouvez révoquer le token utilisateur à tout moment. Dans ce cas, vous devez aussi saisir la nouvelle valeur dans le fichier de paramètres de vos workers.

Exemple de token utilisateur :

VDGcruTrDZ62EuJsE9IQUCiRIKRhZpXw6RPtcnk1jBxbROn1nxZixBMql8L2zxKwD9QXb1UZoWgrDf8IwciRDUHxHzwkNrDzNBpio2UdAx4rLYsjMnI887eqWGauszBl

[worker_name]

Saisissez le nom du worker. worker4124 ou n'importe quel workername

Seuls les caractères alphanumériques sont acceptés. 16 caractères maximum. N'utilisez pas de caractères spéciaux. Si vous ne saisissez pas de nom de worker, il sera créé automatiquement.

[target_puzzle]

Choisissez le puzzle que vous voulez scanner. 38 ou 71 ou n'importe quel puzzle en cours. Vous pouvez utiliser 38 pour le pool de test. Le pool de test compte 32 plages possibles. Vous trouverez les données du pool de test sur le site. Les données du pool de test sont réinitialisées toutes les 30 minutes.

[public_key]

Type de clé : RSA PKCS#8 - 1024 Bit

Ce paramètre fonctionne avec untrusted_computer. Si vous fournissez une valeur valide pour la clé publique, la valeur untrusted_computer passe automatiquement à true. Ce paramètre crée un environnement de travail sécurisé, en particulier pour les instances qui tournent sur des serveurs distants.

Si une clé est trouvée, elle est chiffrée avec la clé publique que vous avez fournie. Ainsi, même le propriétaire de l'instance ne peut pas connaître la clé privée. La clé chiffrée vous est envoyée via Telegram ou Custom API Share. Vous seul pouvez la déchiffrer avec votre clé privée RSA.

Par exemple, vous pouvez utiliser cette page pour générer votre propre clé RSA : https://emn178.github.io/online-tools/rsa/key-generator/

Générez une clé RSA sur cette page et conservez bien votre clé privée. Vous utiliserez la clé publique dans vos instances. Pour vous assurer que tout fonctionne, lancez d'abord des scénarios de test avec le puzzle 38. Essayez ensuite de déchiffrer la clé trouvée avec votre clé privée.

Ce paramètre est recommandé aux utilisateurs avancés et ne doit pas être utilisé sans bien le comprendre. Voici un exemple de clé publique RSA générée.

-----BEGIN PUBLIC KEY-----
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCmj7S4rw7qEHvePQlcE2cRxNvq
+Nez6ltDxCUUwv8+InWFshfHX8B9Q0XrW/EUFJ/UcqDcGMEcGHM1XVmwAc6k5cSX
ZbmF6hcnXcBx8YuAUfJ3DUeRYE3uTYN5fiPnydPFoiuGgwE654bQnJyDMgT7JSbf
OPHabvA/NpiEvQnjOwIDAQAB
-----END PUBLIC KEY-----

Transmettez cette valeur à l'application de la façon suivante : remplacez tous les sauts de ligne par le caractère "|" pour obtenir une seule ligne, et utilisez-la ainsi. Vous pouvez aussi utiliser le caractère "@". De cette façon, toutes les instances lancées avec cet argument chiffreront toute clé privée avec cette clé publique et vous l'enverront. N'oubliez pas : vous seul pourrez déchiffrer ces données avec votre clé privée.

-pubkey "-----BEGIN PUBLIC KEY-----|MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCmj7S4rw7qEHvePQlcE2cRxNvq|+Nez6ltDxCUUwv8+InWFshfHX8B9Q0XrW/EUFJ/UcqDcGMEcGHM1XVmwAc6k5cSX|ZbmF6hcnXcBx8YuAUfJ3DUeRYE3uTYN5fiPnydPFoiuGgwE654bQnJyDMgT7JSbf|OPHabvA/NpiEvQnjOwIDAQAB|-----END PUBLIC KEY-----""

Quand le client chiffre la clé et vous l'envoie, vous recevez un message chiffré au format base64 semblable à celui ci-dessous. Vous pouvez déchiffrer ce message avec la clé privée de la paire RSA que vous avez générée.Rappel pour ceux qui ne sont pas familiers : quelle que soit la clé publique que vous fournissez au client ou à l'instance, conservez bien la clé privée correspondante. Le message chiffré ne peut être déchiffré qu'avec cette clé privée, et il est impossible de le récupérer autrement.

mTCyRIE999ABAiTQ21oWvKDQMlezFVoz4cXKae4tHcg7z1LeQo0ud8/c6xtVymJrWeTXIYCCV1ZHAFkPTOYvsSoeOgL1uLWtsnE3lDWxR01Ht4LsP0W0YptNYf7g+Knd3SclRORuSqwsuglRHttzTyp+JvjITEFulKxi7yRW3gk=

[telegram_token]

Saisissez le token d'accès du bot Telegram. Exemple : 6331494066:ABEfv4cF3dbc3mA8qGLDlEp2uxzgYESIa_w

[telegram_chat_id]

Saisissez l'ID du chat Telegram. Exemple : -1001945678901

[telegram_share]

Si vous saisissez les valeurs de token et d'ID de chat ci-dessus, il passe automatiquement à "true" : inutile donc d'indiquer cette valeur séparément.

true : partage la progression sur Telegram.

false : n'envoie aucune notification.

Si vos paramètres Telegram sont corrects, vous recevrez une notification indiquant que le worker a commencé à travailler. Conseil : si vous êtes sur un ordinateur non fiable, faites les réglages via la console et continuez sans enregistrer. IMPORTANT : si la clé est trouvée et que Telegram ne parvient pas à vous la transmettre, le client fera un nombre illimité de tentatives.

[api_share_url]

empty ou https://yourwebsite.com

Recevez toutes les actions sous forme de requête POST sur votre propre serveur. Toutes les valeurs sont transmises en "header". Vous voyez ci-dessous quelles données sont envoyées.

IMPORTANT : si la clé est trouvée et qu'un résultat négatif est reçu de l'API (body), le client fait un nombre illimité de tentatives.

status // [workerStarted, workerExited, rangeScanned, reachedOfKeySpace, keyFound]
hex // Scanned HEX value
privatekey // Private key if that found
targetpuzzle // Which puzzle is being scanned
workername // Worker name [worker1039]

Exemple de script PHP

<?php
 $headers = getallheaders();
 $status = $headers['Status'];
 $hex = $headers['Hex'];
 $workername = $headers['Workername'];
 $privatekey = $headers['Privatekey'];
 $targetpuzzle = $headers['Targetpuzzle'];

 if($status == "workerStarted"){
 shareTelegram($workername." started job!");
 }
 else if($status == "workerExited"){
 shareTelegram($workername." goes offline!");
 }
 else if($status == "rangeScanned"){
 shareTelegram($hex." scanned by ".$workername);
 }
 else if($status == "reachedOfKeySpace"){
 shareTelegram($workername." reached of keyspace!");
 }
 else if($status == "keyFound"){
 shareTelegram("Congratulations! ".$workername." found the key! Key is: ".$privatekey);
 }

 function shareTelegram($message){
 $apiToken = "{telegram_api_token}";
 $chatId= "{telegram_chat_id}";
 $data = [
 "chat_id" => $chatId,
 "text" => $message
 ];
 $response = file_get_contents("http://api.telegram.org/bot$apiToken/sendMessage?" . http_build_query($data) );
 }

 echo 'true';
?>

Votre API doit renvoyer true comme résultat. La valeur renvoyée n'est vérifiée que lorsque la clé est trouvée, et de nouvelles requêtes sont envoyées jusqu'à recevoir une réponse 'true' de l'API (tentatives illimitées).

[api_share]

true ou false

Si vous saisissez une URL valide pour l'API Share URL, cette valeur passe automatiquement à "true" : inutile donc de la modifier à la main.

[save_key]

Cette fonction ne marche que si une "RSA Public Key" valide est fournie. Si le client trouve la clé privée d'un puzzle, elle est chiffrée côté client avec la clé publique RSA que vous avez saisie, puis stockée dans la base de données de btcpuzzle.info. Vous pouvez voir ces clés stockées sur votre tableau de bord. Toutes les clés enregistrées ici sont chiffrées avec votre clé publique : personne, pas même l'équipe btcpuzzle.info, ne peut lire ni déchiffrer ce contenu.

Pour déchiffrer ce contenu, il vous faut la "RSA Private Key", que vous êtes seul à détenir et que vous devez générer vous-même sur une plateforme externe. Veillez donc à ne pas perdre la clé privée correspondant à la clé publique RSA fournie au client. Le chiffrement se fait entièrement côté client, ce qui garantit qu'aucune clé ne fuite.

C'est une alternative pour les utilisateurs qui ont du mal avec Telegram ou API Share, et pour ceux qui veulent stocker leurs clés en toute sécurité. Insistons encore : ce chiffrement a lieu dans le client qui tourne sur votre système. Le chiffrement RSA est utilisé, et seule la clé privée chiffrée est stockée dans la base de données. Personne, pas même l'équipe btcpuzzle.info, ne peut accéder à ce contenu ni le lire. Seule une personne possédant la "RSA Private Key" liée à la clé publique peut le déchiffrer.

IMPORTANT : l'opérateur du pool ne peut pas déchiffrer les clés chiffrées en RSA. Cependant, un opérateur malveillant pourrait examiner les plages déjà scannées par un utilisateur, estimer la zone dans laquelle la clé a été trouvée, puis rescanner cette zone à son propre profit. Réfléchissez donc bien avant d'utiliser la fonction save_key. Je n'ai aucune intention de le faire, mais je pense qu'il est important d'être transparent sur les risques potentiels et le fonctionnement du système. Les utilisateurs qui ont besoin du plus haut niveau de confidentialité sont invités à utiliser plutôt la fonction "api_share". Je proposerai de nouvelles idées à l'avenir pour rendre cette fonction plus sûre et plus fiable.

[custom_range]

none : scanne toutes les plages.

2D or 3BA or 3FF1 : saisissez les [1-7] premiers caractères de la plage à scanner. Une seule valeur.

Vous pouvez indiquer des plages comme 3400000:38FFFFF. Les clés reçues seront choisies dans cette plage. Vous devez écrire la plage en longueur complète. Vérifiez que vous saisissez la bonne plage.

Remarque : vous ne pouvez indiquer qu'un seul réglage dans le champ de plage personnalisée.

👶🏽Pour les débutants👶🏿

Si vous découvrez le Bitcoin Puzzle ou si certains termes techniques ne vous sont pas familiers, et que vous cherchez un moyen simple de résoudre le puzzle (ou simplement de vous amuser), voici la façon la plus simple et la plus fiable de procéder.

  1. 01

    1 - Créez un compte gratuit sur btcpuzzle.info et activez votre compte CloudSearch. Ajoutez ensuite le montant que vous souhaitez charger sur votre solde.

  2. 02

    2 - Rendez-vous sur la page suivante et générez votre propre "RSA Public & Private Key" : https://emn178.github.io/online-tools/rsa/key-generator/ Veillez à ne pas perdre ces deux valeurs et conservez-les en lieu sûr. En particulier, ne partagez jamais votre "Private Key" avec qui que ce soit, y compris l'équipe btcpuzzle.info.

  3. 03

    3 - Créez un nouveau modèle dans CloudSearch. Dans le modèle, saisissez la valeur générée plus tôt dans le champ "public_key". Réglez aussi l'option "save_key" sur "Enabled/Active", donnez un nom au modèle et enregistrez-le. Vous n'avez besoin de modifier aucun autre réglage que ces deux-là. Vérifiez simplement que le puzzle est le bon.

  4. 04

    4 - C'est tout ! Louez maintenant le GPU de votre choix avec le modèle créé. Consultez les logs pour vérifier que vos GPU loués fonctionnent correctement. Vous voilà chasseur de primes dans le monde du Btc Puzzle !

Si une clé est trouvée, vous la verrez sous forme "chiffrée" sur la page "Clés trouvées". Pour déchiffrer ce contenu, il vous faut la "RSA Private Key" créée à l'étape 2. Retournez sur le site de l'étape 2, allez dans la section "Decrypt" et saisissez les bonnes valeurs pour révéler la clé privée qui contient la récompense du puzzle.

Cette méthode est recommandée par btcpuzzle.info et considérée comme sûre et fiable. La clé découverte ne sera pas exposée : vous seul y aurez accès ! Bonne chance avec le puzzle !

Images Docker

Vous pouvez facilement créer votre propre image avec le Dockerfile présent dans le dépôt. Les images Docker officielles créées pour btcpuzzle.info sont visibles à cette URL : https://hub.docker.com/r/ilkercndk/btcpuzzle/tags. Vous pouvez aussi construire votre propre image Docker avec le "Dockerfile" disponible sur GitHub.

Utiliser les images Docker

ilkercndk/btcpuzzle:latest

Lancez la commande avec vos paramètres. Exemple :

$ docker run --gpus all -it ilkercndk/btcpuzzle:latest -e USERTOKEN=xxx -e WORKERNAME=workername ...

L'image Docker a été construite avec CUDA 12.8 pour prendre en charge à la fois les GPU NVIDIA de la série 5000 et les cartes graphiques plus anciennes. Sur des plateformes comme CloudSearch, Vast.ai ou Clore.ai, vous devez donc lancer des instances disposant au moins de cette version de CUDA. CloudSearch exclut automatiquement par défaut les instances dont la version de CUDA est inférieure.

Vous pouvez saisir la valeur suivante dans le champ "Startup script" pour que l'image Docker se lance automatiquement à son chargement.

bash /app/btcpuzzle.sh

Paramètres par défaut

ENV PUZZLE=71
ENV USERTOKEN=""
ENV WORKERNAME=""
ENV APISHARE=""
ENV PUBKEY=""
ENV TELEGRAM_TOKEN=""
ENV TELEGRAM_CHATID=""
ENV CUSTOM_RANGE=""
ENV SAVE_KEY="false"
ENV CLOUDSEARCH_MODE="false"

Comment créer, construire et publier une image Docker ?

1 - Construisez le fichier Docker.

$ docker build -t btcpuzzle .

2 - Étiquetez l'image (pour la publier sur le hub), avec votre {username}/{image_name}:{tag}.

$ docker tag btcpuzzle ilkercndk/btcpuzzle:latest

Plus d'informations

Qu'est-ce que l'App Hash ? L'App Hash est une valeur de hachage obtenue en signant le code de l'application. Le code compilé le plus récent de l'application est figé, et cette valeur ne change pas tant que le code n'est pas modifié. Si vous remarquez que la valeur App Hash a changé, cela indique que le code de l'application en cours d'exécution a été modifié. C'est une mesure de sécurité supplémentaire.

Qu'est-ce que le Secret Hash ? Le Secret Hash est une mesure de sécurité liée à l'App Hash. La valeur Secret Hash hache tous les paramètres que vous saisissez avec la valeur App Hash, ce qui produit un hachage unique et immuable. Si vous remarquez que la valeur Secret Hash a changé, cela indique soit que vos paramètres actuels ont été modifiés, soit que la valeur App Hash a complètement changé. À chaque mise à jour de l'application, la valeur App Hash change aussi, et donc la valeur Secret Hash actuelle également.

Dois-je utiliser la fonction PubKey ? Nous la recommandons vivement. Avec PubKey, si une clé est trouvée (pour le puzzle 71 ou tout autre puzzle), l'application la chiffre avec la clé publique RSA que vous avez fournie. Ainsi, quand une clé est trouvée sur l'ordinateur qui exécute l'application, seule l'information chiffrée est enregistrée ou envoyée en notification. Le contenu chiffré ne peut être déchiffré qu'avec la clé privée que vous êtes seul à posséder : la clé privée RSA que vous avez générée sur le site de votre choix.

Ce site, le client et tout le reste ont été créés avec beaucoup de passion et d'amour par un père de deux enfants. Vos dons m'aident à rester engagé dans ce projet.

Don en Bitcoin (BTC) : ❤️ 1LKERC27h9BpkKbkTQ1c83dASww74a4eDU

Offrez-moi un café

Puzzles du pool

Ce que le pool scanne maintenant, ce qui vient ensuite, et les puzzles sur lesquels il a déjà travaillé.

En cours de scan1

Suivant2

Scannés auparavant4

Les 160 puzzles