Guida introduttiva

Cos'è il pool, come configurare il client e come funziona la scansione.

Cos'è btcpuzzle.info?

btcpuzzle.info è un pool in modalità solo creato appositamente per i Bitcoin Puzzle (o challenge). È open source e affidabile. Funziona con la Proof of Work (PoW) ed è protetto dagli attacchi malevoli. Per unirti al pool devi usare un client. Questo client è open source, e chiunque può sviluppare un proprio client se lo desidera. In questa guida la procedura per unirsi al pool è spiegata usando il nostro client ufficiale.

Cos'è un BTC Puzzle (challenge)?

Un BTC Puzzle non corrisponde del tutto a quello che il nome suggerisce. È stato creato in forma completamente anonima e contiene premi per un totale di oltre 1.000 BTC. Per spiegarlo in modo semplice, un puzzle consiste nel trovare il numero giusto all’interno di un intervallo specifico tra due numeri. Tuttavia, con la tecnologia attuale e l’architettura della blockchain di Bitcoin, la difficoltà aumenta man mano che questi range si allargano. Per questo serve un pool.

btcpuzzle.info è un pool in modalità solo: chi trova la soluzione riceve il premio. I range scansionati però sono condivisi. Un range già scansionato da un partecipante non può essere scansionato di nuovo da un altro.

Qui sotto trovi i link importanti relativi a questo progetto. Se hai bisogno di ulteriore aiuto, puoi contattarci tramite il supporto qui sotto.

Guide e documentazione

Compilalo da solo

Puoi compilare da solo il client e tutte le applicazioni usate. Client e app open source al 100%.

Proof of Work (PoW)

Quando richiedi un range al pool, vengono restituiti anche sei indirizzi wallet. Le chiavi private di questi indirizzi vengono scansionate contemporaneamente. Per garantire che un range sia stato scansionato, devono essere trovate le chiavi private di tutti e sei gli indirizzi wallet. Le chiavi private degli indirizzi trovati vengono sottoposte a hash con SHA256. In questo modo viene creata la "Proof Key". Serve a verificare che il tuo programma funzioni correttamente, e voglio anche essere sicuro che la tua scansione sia davvero corretta.

Esempio: il pool restituisce il range HEX 3E2ECB0 da scansionare. Il pool genera casualmente altre 6 chiavi private all’interno del range HEX restituito, tra 3E2ECB00000000000 e 3E2ECB0FFFFFFFFFF.

La marcatura viene fatta con

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

Nota: il numero di proof key può essere aumentato o diminuito dinamicamente dall’API. Di norma il totale è 6.

Come unirsi al pool?

Unirsi al pool è piuttosto semplice. Come minimo ti serve una scheda video Nvidia. In alternativa, puoi partecipare facilmente con CloudSearch.

Guida passo passo

  1. 01

    Crea un account sul sito BTCPuzzle.info e ottieni il tuo token utente.

  2. 02

    Scarica l’ultima versione del client Btcpuzzle.info oppure compilalo da solo.

  3. 03

    Modifica il file pool.conf secondo le tue esigenze.

  4. 04

    Avvia l’applicazione.

CloudSearch

Se cerchi il modo più semplice per unirti al pool, sei nel posto giusto. Noleggia la scheda video che vuoi a tariffa oraria e punta al premio. Vai su CloudSearch di btcpuzzle.info.

  1. 01

    Crea un account sul sito BTCPuzzle.info e attiva il tuo account CloudSearch.

  2. 02

    Ricarica il saldo (USD) usando Polygon, Base, ETH e molte altre reti.

  3. 03

    Crea un modello e noleggia l’istanza che vuoi. Tutto qui!

Client Btcpuzzle.info

Questa sezione illustra le funzioni del client btcpuzzle.info. Le funzioni supportate e il modo di usare il client sono descritti in dettaglio. Per qualsiasi domanda puoi ricevere supporto nel gruppo Telegram. Il precedente client usato da btcpuzzle.info, "“btcpuzzle-client”", non sarà più usato né sviluppato.

Impostazioni (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

Puoi aggiornare le impostazioni dell’applicazione tramite il file pool.conf o dall’app. Puoi creare il tuo file di impostazioni dalla dashboard di btcpuzzle.info. Puoi anche passare argomenti all’applicazione come nell’esempio qui sotto.

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

[user_token]

Puoi creare il valore del token utente accedendo al tuo account su btcpuzzle.info. Se non hai un account, puoi crearne uno nuovo con il tuo indirizzo email (l’indirizzo wallet lo imposti poi nelle impostazioni dell’account).

Puoi revocare il token utente in qualsiasi momento. In quel caso, però, devi inserire anche il nuovo valore nel file di impostazioni dei worker.

Esempio di valore del token utente:

VDGcruTrDZ62EuJsE9IQUCiRIKRhZpXw6RPtcnk1jBxbROn1nxZixBMql8L2zxKwD9QXb1UZoWgrDf8IwciRDUHxHzwkNrDzNBpio2UdAx4rLYsjMnI887eqWGauszBl

[worker_name]

Inserisci il nome del worker. worker4124 o qualsiasi workername

Sono accettati solo caratteri alfanumerici. Massimo 16 caratteri. Non usare caratteri speciali. Se non inserisci un nome per il worker, verrà creato automaticamente.

[target_puzzle]

Seleziona il puzzle che vuoi scansionare. 38 o 71 o qualsiasi puzzle attuale. Puoi usare il 38 per il pool di test. Nel pool di test ci sono 32 range possibili. Trovi i dati del pool di test sul sito. I dati del pool di test vengono azzerati ogni 30 minuti.

[public_key]

Tipo di chiave: RSA PKCS#8 - 1024 Bit

Questa impostazione funziona insieme a untrusted_computer. Se fornisci un valore valido per la chiave pubblica, il valore di untrusted_computer verrà impostato automaticamente su true. Questa impostazione crea un ambiente di lavoro sicuro, soprattutto per le istanze che girano su server remoti.

Se viene trovata una chiave, sarà cifrata con la chiave pubblica che hai fornito. Questo significa che nemmeno il proprietario dell’istanza può conoscere la chiave privata. La chiave cifrata ti verrà inviata via Telegram o tramite Custom API Share. Solo tu puoi decifrare questa chiave con la tua RSA Private Key.

Ad esempio, puoi usare questa pagina per generare la tua chiave RSA: https://emn178.github.io/online-tools/rsa/key-generator/

Genera una chiave RSA su questa pagina e assicurati di conservare la tua Private Key. Userai la Public Key nelle tue istanze. Per assicurarti che tutto funzioni correttamente, esegui prima degli scenari di prova con il puzzle 38. Poi prova a decifrare la chiave trovata con la tua Private Key.

Questa impostazione è consigliata agli utenti esperti e non va usata senza averla capita bene. Qui sotto trovi un esempio di RSA Public Key generata.

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

Devi passare questo valore all’applicazione in questo modo: unisci tutte le righe in una sola usando il carattere "|" e usalo così. In alternativa puoi usare anche il carattere "@". In questo modo tutte le istanze avviate con questo argomento cifreranno ogni chiave privata con questa chiave pubblica e te la invieranno. Ricorda: solo tu potrai decifrare questi dati con la tua Private Key.

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

Quando il client cifra la chiave e te la invia, riceverai un messaggio cifrato in formato base64 simile a quello qui sotto. Puoi decifrare questo messaggio con la Private Key della chiave RSA che hai generato.Promemoria per chi non ha familiarità: qualunque chiave pubblica tu fornisca al client o all’istanza, assicurati di conservare la chiave privata corrispondente. Il messaggio cifrato infatti può essere decifrato solo con quella chiave privata, e non può essere recuperato in altro modo.

mTCyRIE999ABAiTQ21oWvKDQMlezFVoz4cXKae4tHcg7z1LeQo0ud8/c6xtVymJrWeTXIYCCV1ZHAFkPTOYvsSoeOgL1uLWtsnE3lDWxR01Ht4LsP0W0YptNYf7g+Knd3SclRORuSqwsuglRHttzTyp+JvjITEFulKxi7yRW3gk=

[telegram_token]

Inserisci il token di accesso del BOT Telegram. Esempio: 6331494066:ABEfv4cF3dbc3mA8qGLDlEp2uxzgYESIa_w

[telegram_chat_id]

Inserisci l’ID della chat Telegram. Esempio: -1001945678901

[telegram_share]

Se inserisci i valori del token e dell’ID chat indicati sopra, verrà impostato automaticamente su "true", quindi non serve specificare questo valore a parte.

true: condivide l’avanzamento su Telegram.

false: se è false, non invia notifiche.

Se le impostazioni di Telegram sono corrette, riceverai una notifica quando il worker inizia a lavorare. Consiglio: se sei su un computer non affidabile, configura le impostazioni dalla console e procedi senza salvarle. IMPORTANTE: se la chiave viene trovata e Telegram non riesce a trasmettertela, i tentativi proseguono senza limiti.

[api_share_url]

empty o https://yourwebsite.com

Ricevi tutte le azioni come richiesta POST sul tuo server. Tutti i valori vengono inviati come "header". Qui sotto puoi vedere quali dati arrivano.

IMPORTANTE: se la chiave viene trovata e l’API restituisce un risultato non riuscito (body), i tentativi proseguono senza limiti.

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]

Esempio di 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';
?>

L’API deve restituire true come risultato. Il valore restituito viene controllato solo quando la chiave viene trovata, e nuove richieste vengono inviate finché l’API non risponde 'true' (tentativi illimitati).

[api_share]

true o false

Se inserisci un URL valido per l’API Share URL, questo valore verrà impostato automaticamente su "true", quindi non serve cambiarlo a mano.

[save_key]

Questa funzione è attiva solo se viene fornita una "RSA Public Key" valida. Se il client trova la chiave privata di un puzzle, questa viene cifrata lato client con la RSA Public Key che hai inserito e poi salvata nel database di btcpuzzle.info. Puoi vedere le chiavi salvate nella tua dashboard. Tutte le chiavi salvate qui sono cifrate con la tua chiave pubblica, quindi nessuno — nemmeno il team di btcpuzzle.info — può leggerne o decifrarne il contenuto.

Per decifrare questo contenuto ti servirà la "RSA Private Key", che è solo in tuo possesso e che devi generare tu su una piattaforma esterna. Assicurati quindi di non perdere la chiave privata corrispondente alla RSA Public Key che hai fornito al client. La cifratura avviene interamente lato client, così non c’è alcuna fuga di chiavi.

È un’alternativa per chi ha difficoltà a usare Telegram o API Share, e per chi vuole conservare le proprie chiavi in modo sicuro. Vale la pena ribadirlo: ricorda che questa cifratura avviene nel client che gira sul tuo sistema. Viene usata la cifratura RSA, e nel database viene salvata solo la chiave privata cifrata. Nessuno — nemmeno il team di btcpuzzle.info — può accedere a questo contenuto o leggerlo. Solo chi possiede la "RSA Private Key" corrispondente alla chiave pubblica può decifrarlo.

IMPORTANTE: il gestore del pool non può decifrare le chiavi cifrate con RSA. Tuttavia, un gestore malintenzionato potrebbe esaminare i range scansionati in precedenza da un utente, stimare l’area in cui è stata trovata la chiave e poi scansionare di nuovo quell’area a proprio vantaggio. Per questo devi valutare attentamente se usare la funzione save_key. Non ho alcuna intenzione di farlo, ma credo sia importante essere trasparenti sui rischi potenziali e sul funzionamento del sistema. Agli utenti che richiedono il massimo livello di privacy consigliamo di usare invece la funzione "api_share". In futuro proporrò nuove idee per rendere questa funzione più sicura e affidabile.

[custom_range]

none: scansiona tutti i range.

2D or 3BA or 3FF1: inserisci i primi [1-7] caratteri del range che vuoi scansionare. Un solo valore.

Puoi specificare range come 3400000:38FFFFF. Le chiavi assegnate verranno scelte da questo range. Devi scrivere il range per intero. Assicurati di inserire il range corretto.

Nota: per il campo del range personalizzato puoi specificare una sola impostazione.

👶🏽Per principianti👶🏿

Se sei nuovo del Bitcoin Puzzle o non hai familiarità con alcuni termini tecnici, e cerchi un modo semplice per risolvere il puzzle (o solo per divertirti), ti guidiamo nel modo più semplice e affidabile per farlo.

  1. 01

    1 - Crea un account gratuito su btcpuzzle.info e attiva il tuo account CloudSearch. Poi aggiungi l’importo che vuoi caricare come saldo.

  2. 02

    2 - Visita la pagina seguente e genera la tua "RSA Public & Private Key": https://emn178.github.io/online-tools/rsa/key-generator/ Assicurati di non perdere questi due valori e conservali al sicuro. In particolare, non condividere mai la tua "Private Key" con nessuno, nemmeno con il team di btcpuzzle.info.

  3. 03

    3 - Crea un nuovo modello tramite CloudSearch. Nel modello, inserisci nel campo "public_key" il valore generato in precedenza. Imposta anche l’opzione "save_key" su "Enabled/Active", dai un nome al modello e salvalo. Oltre a queste due non serve cambiare altre impostazioni. Assicurati solo che il puzzle sia quello giusto.

  4. 04

    4 - Tutto qui! Ora noleggia qualsiasi GPU tu voglia usando il modello che hai creato. Controlla i log per assicurarti che le GPU noleggiate funzionino correttamente. Ora sei un cacciatore di taglie nel mondo del Btc Puzzle!

Se viene trovata una chiave, la vedrai come "cifrata" nella pagina "Chiavi trovate". Per decifrare questo contenuto ti servirà la "RSA Private Key" creata al passaggio 2. Puoi tornare sullo stesso sito del passaggio 2, andare nella sezione "Decrypt" e inserire i valori corretti per rivelare la chiave privata che contiene il premio del puzzle.

Questo metodo è consigliato da btcpuzzle.info ed è considerato sicuro e affidabile. La chiave scoperta non verrà esposta: solo tu potrai accedervi! Buona fortuna con il puzzle!

Immagini Docker

Puoi creare facilmente la tua immagine con il Dockerfile presente nel repository. Le immagini Docker ufficiali create per btcpuzzle.info sono disponibili a questo URL: https://hub.docker.com/r/ilkercndk/btcpuzzle/tags. Puoi inoltre compilare una tua immagine Docker usando il "Dockerfile" disponibile su GitHub.

Come usare le immagini Docker

ilkercndk/btcpuzzle:latest

Esegui il comando con le tue impostazioni. Esempio:

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

L’immagine Docker è stata compilata con CUDA 12.8 per supportare sia le GPU NVIDIA serie 5000 sia le schede video più vecchie. Per questo, quando usi piattaforme come CloudSearch, Vast.ai o Clore.ai, devi avviare istanze che abbiano almeno questa versione di CUDA. CloudSearch esclude automaticamente per impostazione predefinita le istanze con versioni di CUDA inferiori.

Puoi inserire il valore seguente nel campo "Startup script" per fare in modo che l’immagine Docker si avvii automaticamente al caricamento.

bash /app/btcpuzzle.sh

Impostazioni predefinite

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"

Come creare/compilare/pubblicare un’immagine Docker?

1 - Compila il Dockerfile.

$ docker build -t btcpuzzle .

2 - Assegna un tag all’immagine (per pubblicarla sull’hub), con il formato {username}/{image_name}:{tag}.

$ docker tag btcpuzzle ilkercndk/btcpuzzle:latest

Altre informazioni

Cos’è l’App Hash? L’App Hash è un valore di hash ottenuto firmando il codice dell’applicazione. L’ultimo codice compilato dell’applicazione è fisso, e questo valore non cambia finché il codice non viene modificato. Se noti che il valore dell’App Hash è cambiato, significa che il codice dell’applicazione in esecuzione è stato alterato. È una misura di sicurezza aggiuntiva.

Cos’è il Secret Hash? Il Secret Hash è una misura di sicurezza legata all’App Hash. Il Secret Hash calcola l’hash di tutte le impostazioni che inserisci insieme al valore dell’App Hash, producendo un hash unico e immutabile. Se noti che il valore del Secret Hash è cambiato, significa che le tue impostazioni attuali sono state modificate oppure che il valore dell’App Hash è cambiato del tutto. A ogni aggiornamento dell’applicazione cambia anche l’App Hash, e di conseguenza cambierà anche il Secret Hash attuale.

Devo usare la funzione PubKey? Te lo consigliamo vivamente. Quando usi PubKey, se viene trovata una chiave (per il puzzle 71 o per qualsiasi altro puzzle), l’applicazione la cifra con la RSA Public Key che hai fornito. Questo significa che, quando una chiave viene trovata sul computer che esegue l’applicazione, vengono salvate o inviate come notifica solo le informazioni cifrate. Il contenuto cifrato può essere decifrato solo con la chiave privata che possiedi solo tu: la RSA Private Key che hai generato su un sito a tua scelta.

Questo sito, il client e tutto il resto sono stati creati con grande passione e amore da un padre di due figli. Le tue donazioni mi aiutano a continuare a dedicarmi a questo progetto.

Donazioni in Bitcoin (BTC): ❤️ 1LKERC27h9BpkKbkTQ1c83dASww74a4eDU

Offrimi un caffè

Puzzle del pool

Cosa scansiona ora il pool, cosa viene dopo e i puzzle su cui ha già lavorato.

In scansione ora1

Prossimo2

Scansionati in passato4

Tutti i 160 puzzle