Guia de primeiros passos

O que é o pool, como configurar o cliente e como funciona o escaneamento.

O que é o btcpuzzle.info?

O btcpuzzle.info é um pool solo criado especificamente para os Bitcoin Puzzles (ou desafios). Ele é de código aberto e confiável. Funciona com prova de trabalho (PoW) e é protegido contra ataques maliciosos. Para entrar no pool, você precisa usar um cliente. Esse cliente é de código aberto, e qualquer pessoa pode desenvolver o próprio cliente se quiser. Neste guia, o processo de entrada no pool é explicado usando o nosso cliente oficial.

O que é um BTC Puzzle (desafio)?

Um BTC Puzzle não reflete totalmente o que o nome sugere. Ele foi criado de forma totalmente anônima e contém recompensas que somam mais de 1.000 BTC. Explicando de forma simples, um puzzle consiste em encontrar o número correto dentro de um intervalo específico entre dois números. Porém, com a tecnologia atual e a arquitetura da blockchain do Bitcoin, a dificuldade aumenta à medida que esses intervalos ficam maiores. É por isso que é preciso um pool.

O btcpuzzle.info é um pool solo, ou seja, quem encontra a solução recebe a recompensa. No entanto, os intervalos escaneados são compartilhados. Um intervalo que já foi escaneado por um participante não pode ser escaneado de novo por outro.

Abaixo você encontra links importantes relacionados a este projeto. Se precisar de mais ajuda, pode entrar em contato pela seção de suporte abaixo.

Guia & documentação

Compile você mesmo

Você pode compilar o cliente e todos os aplicativos usados por conta própria. Cliente & apps 100% de código aberto.

Prova de trabalho (PoW)

Ao solicitar um intervalo ao pool, também são retornados seis endereços de carteira. As chaves privadas desses endereços são escaneadas ao mesmo tempo. Para comprovar que um intervalo foi escaneado, as chaves privadas de todos os seis endereços de carteira precisam ser encontradas. As chaves privadas dos endereços encontrados passam por hash SHA256. Assim é criada a "Proof Key" (chave de prova). Isso serve para garantir que o seu programa está funcionando corretamente. Também quero ter certeza de que você está fazendo uma varredura realmente saudável.

Exemplo: o pool retorna o intervalo HEX 3E2ECB0 para escanear. O pool gera aleatoriamente 6 chaves privadas extras dentro do intervalo HEX retornado. 3E2ECB00000000000 e 3E2ECB0FFFFFFFFFF.

A marcação é feita com

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

Observação: o número de chaves de prova pode ser aumentado/diminuído dinamicamente pela API. Por padrão, o total é 6.

Como entrar no pool?

Entrar no pool é bem simples. No mínimo, você precisa ter uma placa de vídeo Nvidia. Como alternativa, você pode entrar facilmente usando o CloudSearch.

Guia passo a passo

  1. 01

    Crie uma conta no site BTCPuzzle.info e obtenha seu token de usuário.

  2. 02

    Baixe a versão mais recente do cliente Btcpuzzle.info ou compile-o você mesmo.

  3. 03

    Edite o arquivo pool.conf conforme sua necessidade.

  4. 04

    Execute o aplicativo.

CloudSearch

Se você procura a forma mais fácil de entrar no pool, está no lugar certo. Alugue a placa de vídeo que quiser por hora e corra atrás da recompensa. Acesse o CloudSearch do btcpuzzle.info.

  1. 01

    Crie uma conta no site BTCPuzzle.info e ative sua conta do CloudSearch.

  2. 02

    Recarregue saldo (USD) usando Polygon, Base, ETH e muitas outras redes.

  3. 03

    Crie um modelo e alugue a instância que quiser. É só isso!

Cliente Btcpuzzle.info

Este conteúdo explica os recursos do cliente btcpuzzle.info. Os recursos suportados e a forma de usar o cliente são descritos em detalhes. Se tiver dúvidas, você pode obter suporte no grupo do Telegram. O cliente anterior usado pelo btcpuzzle.info, "“btcpuzzle-client”", não será mais usado nem desenvolvido.

Configurações (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

Você pode atualizar as configurações do aplicativo pelo arquivo pool.conf ou no próprio app. Você pode criar seu arquivo de configurações no painel do btcpuzzle.info. Também é possível passar argumentos para o aplicativo, como no exemplo abaixo.

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

[user_token]

Você pode criar o valor do token de usuário entrando na sua conta no btcpuzzle.info. Se não tiver uma conta, pode criar uma nova com seu endereço de e-mail (o endereço de carteira é definido depois, nas configurações da conta).

Você pode revogar o token de usuário a qualquer momento. Porém, ao fazer isso, também precisa informar o novo valor no arquivo de configurações dos workers.

Exemplo de valor de token de usuário:

VDGcruTrDZ62EuJsE9IQUCiRIKRhZpXw6RPtcnk1jBxbROn1nxZixBMql8L2zxKwD9QXb1UZoWgrDf8IwciRDUHxHzwkNrDzNBpio2UdAx4rLYsjMnI887eqWGauszBl

[worker_name]

Informe o nome do worker. worker4124 ou qualquer workername

Apenas caracteres alfanuméricos são aceitos. No máximo 16 caracteres. Não use caracteres especiais. Se você não informar um nome de worker, ele será criado automaticamente.

[target_puzzle]

Selecione o puzzle que você quer escanear. 38 ou 71 ou qualquer puzzle atual. Você pode usar o 38 para o pool de teste. Há 32 intervalos possíveis no pool de teste. Os dados do pool de teste estão disponíveis no site e são zerados a cada 30 minutos.

[public_key]

Tipo de chave: RSA PKCS#8 - 1024 Bit

Esta configuração funciona em conjunto com untrusted_computer. Se você fornecer um valor válido para a chave pública, o valor de untrusted_computer será definido automaticamente como true. Esta configuração cria um ambiente de trabalho seguro, principalmente para instâncias que rodam em servidores remotos.

Se uma chave for encontrada, ela será criptografada com a chave pública que você forneceu. Isso significa que nem mesmo o dono da instância pode conhecer a chave privada. A chave criptografada será enviada a você via Telegram ou Custom API Share. Só você pode descriptografar essa chave usando sua RSA Private Key.

Como exemplo, você pode usar esta página para gerar sua própria chave RSA: https://emn178.github.io/online-tools/rsa/key-generator/

Gere uma chave RSA nessa página e guarde bem sua Private Key. Você usará a Public Key nas suas instâncias. Para garantir que tudo funciona, primeiro rode cenários de teste com o puzzle 38. Depois tente descriptografar a chave encontrada usando sua Private Key.

Esta configuração é recomendada para usuários avançados e não deve ser usada sem o devido entendimento. Abaixo está um exemplo de RSA Public Key gerada.

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

Você deve enviar esse valor ao aplicativo da seguinte forma: converta todas as quebras de linha em uma única linha usando o caractere "|" e use-o assim. Como alternativa, também pode usar o caractere "@". Dessa forma, todas as instâncias que rodarem com esse argumento vão criptografar qualquer chave privada usando essa chave pública e enviá-la a você. Lembre-se: só você poderá descriptografar esses dados usando sua Private Key.

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

Quando o cliente criptografa a chave e a envia a você, você recebe uma mensagem criptografada parecida com a abaixo, em formato base64. Você pode descriptografar essa mensagem usando a Private Key da chave RSA que gerou.Um lembrete para quem não está familiarizado: qualquer que seja a chave pública que você fornecer ao cliente ou à instância, guarde a chave privada correspondente. Isso porque a mensagem criptografada só pode ser descriptografada com essa chave privada, e não há outra forma de recuperá-la.

mTCyRIE999ABAiTQ21oWvKDQMlezFVoz4cXKae4tHcg7z1LeQo0ud8/c6xtVymJrWeTXIYCCV1ZHAFkPTOYvsSoeOgL1uLWtsnE3lDWxR01Ht4LsP0W0YptNYf7g+Knd3SclRORuSqwsuglRHttzTyp+JvjITEFulKxi7yRW3gk=

[telegram_token]

Informe o access token do BOT do Telegram. Exemplo: 6331494066:ABEfv4cF3dbc3mA8qGLDlEp2uxzgYESIa_w

[telegram_chat_id]

Informe o chat ID do Telegram. Exemplo: -1001945678901

[telegram_share]

Se você informar os valores de token e chat ID mencionados acima, ele será definido automaticamente como "true", então não é preciso especificar esse valor separadamente.

true: compartilha o progresso no Telegram.

false: se for false, não envia notificação.

Se suas configurações do Telegram estiverem corretas, você receberá uma notificação de que o worker começou a trabalhar. Sugestão: se estiver em um computador não confiável, faça as configurações pelo console e prossiga sem salvar. IMPORTANTE: se a chave for encontrada e o Telegram não conseguir entregá-la a você, ele fará tentativas ilimitadas.

[api_share_url]

empty ou https://yourwebsite.com

Receba todas as ações como uma requisição POST no seu próprio servidor. Todos os valores são enviados como "header". Abaixo você vê quais dados chegam.

IMPORTANTE: se a chave for encontrada e a API retornar um resultado sem sucesso (body), ele faz tentativas ilimitadas.

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]

Exemplo 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';
?>

Você deve retornar true como resultado da API. O valor retornado só é verificado quando a chave é encontrada, e novas requisições são enviadas até receber uma resposta 'true' da API (tentativas ilimitadas).

[api_share]

true ou false

Se você informar uma URL válida em API Share URL, este valor será definido automaticamente como "true", então não é preciso alterá-lo manualmente.

[save_key]

Este recurso só funciona quando uma "RSA Public Key" válida é fornecida. Se o cliente encontrar a chave privada de um puzzle, ela será criptografada no lado do cliente com a RSA Public Key que você informou e depois armazenada no banco de dados do btcpuzzle.info. Você pode ver essas chaves armazenadas na página do seu painel. Todas as chaves salvas ali são criptografadas com a sua chave pública, o que significa que ninguém — incluindo a equipe do btcpuzzle.info — consegue ler ou descriptografar esse conteúdo.

Para descriptografar esse conteúdo, você precisará da "RSA Private Key", que fica somente com você e deve ser gerada por você em uma plataforma externa. Portanto, não perca a chave privada correspondente à RSA public key que você forneceu ao cliente. O processo de criptografia acontece inteiramente no lado do cliente, garantindo que nenhuma chave vaze.

Esta é uma alternativa para usuários que têm dificuldade em usar o Telegram ou o API Share e para quem quer armazenar suas chaves com segurança. Vale reforçar: lembre-se de que esse processo de criptografia acontece no cliente que roda no seu sistema. É usada criptografia RSA, e apenas a chave privada criptografada é armazenada no banco de dados. Ninguém — incluindo a equipe do btcpuzzle.info — pode acessar ou ler esse conteúdo. Só quem possui a "RSA Private Key" correspondente à chave pública pode descriptografá-lo.

IMPORTANTE: o operador do pool não consegue descriptografar chaves criptografadas com RSA. Porém, um operador mal-intencionado poderia analisar os intervalos já escaneados por um usuário, estimar a área em que a chave foi encontrada e escanear essa área de novo em benefício próprio. Por isso, pense bem antes de usar o recurso save_key. Embora eu não tenha nenhuma intenção de fazer isso, acredito que é importante ser transparente sobre os riscos potenciais e sobre como o sistema funciona. Usuários que precisam do nível máximo de privacidade devem usar o recurso "api_share". No futuro, vou trazer novas ideias para tornar este recurso mais seguro e confiável.

[custom_range]

none: escaneia todos os intervalos.

2D or 3BA or 3FF1: informe os primeiros [1-7] caracteres do intervalo que você quer escanear. Apenas um valor.

Você pode especificar intervalos como 3400000:38FFFFF. As chaves recebidas serão selecionadas desse intervalo. Você deve escrever o intervalo com o comprimento completo. Confira se informou o intervalo correto.

Observação: você só pode especificar uma configuração no campo de intervalo personalizado.

👶🏽Para iniciantes👶🏿

Se você é novo no Bitcoin Puzzle ou não conhece certos termos técnicos, e procura uma forma fácil de resolver o puzzle (ou só se divertir), nós guiamos você pelo caminho mais simples e confiável.

  1. 01

    1 - Crie uma conta gratuita no btcpuzzle.info e ative sua conta do CloudSearch. Depois, adicione o valor que quer carregar como saldo.

  2. 02

    2 - Acesse a página a seguir e gere sua própria "RSA Public & Private Key": https://emn178.github.io/online-tools/rsa/key-generator/ Não perca esses dois valores e guarde-os com segurança. Em especial, nunca compartilhe sua "Private Key" com ninguém — incluindo a equipe do btcpuzzle.info.

  3. 03

    3 - Crie um novo modelo pelo CloudSearch. No modelo, informe no campo "public_key" o valor que você gerou antes. Também defina a opção "save_key" como "Enabled/Active", dê um nome ao modelo e salve. Você não precisa alterar nenhuma outra configuração além dessas duas. Só confira se o puzzle está correto.

  4. 04

    4 - É só isso! Agora alugue a GPU que quiser usando o modelo que você criou. Confira os logs para garantir que as GPUs alugadas estão funcionando corretamente. Agora você é um caçador de recompensas no mundo do Btc Puzzle!

Se uma chave for encontrada, você a verá como "criptografada" na página "Chaves encontradas". Para descriptografar esse conteúdo, você precisará da "RSA Private Key" que criou na etapa 2. Você pode voltar ao mesmo site da etapa 2, ir até a seção "Decrypt" e informar os valores corretos para revelar a chave privada que contém a recompensa do puzzle.

Este método é recomendado pelo btcpuzzle.info e é considerado seguro e confiável. A chave descoberta não ficará exposta — só você terá acesso a ela! Boa sorte com o puzzle!

Imagens Docker

Você pode criar facilmente sua própria imagem com o Dockerfile da imagem Docker no repositório. As imagens Docker oficiais criadas para o btcpuzzle.info estão nesta URL: https://hub.docker.com/r/ilkercndk/btcpuzzle/tags. Além disso, você pode compilar sua própria imagem Docker usando o "Dockerfile" disponível no GitHub.

Como usar as imagens Docker

ilkercndk/btcpuzzle:latest

Execute o comando com as suas configurações. Exemplo:

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

A imagem Docker foi compilada com CUDA 12.8 para suportar tanto as GPUs NVIDIA da série 5000 quanto placas de vídeo mais antigas. Por isso, ao usar plataformas como CloudSearch, Vast.ai ou Clore.ai, você deve rodar instâncias que tenham pelo menos essa versão do CUDA. O CloudSearch filtra automaticamente, por padrão, as instâncias com versões inferiores do CUDA.

Você pode informar o valor a seguir no campo "Startup script" para que a imagem Docker rode automaticamente ao ser carregada.

bash /app/btcpuzzle.sh

Configurações padrão

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"

Como criar/compilar/enviar a imagem Docker?

1 - Compile o arquivo docker.

$ docker build -t btcpuzzle .

2 - Adicione uma tag à imagem (para enviar ao hub). Use seu {username}/{image_name}:{tag}.

$ docker tag btcpuzzle ilkercndk/btcpuzzle:latest

Mais informações

O que é o App Hash? O App Hash é um valor de hash obtido ao assinar o código do aplicativo. O código compilado mais recente do aplicativo é fixo, e esse valor não muda enquanto não houver modificações no código. Se você notar que o valor do App Hash mudou, isso indica que o código do aplicativo em execução foi alterado. É uma medida de segurança adicional.

O que é o Secret Hash? O Secret Hash é uma medida de segurança ligada ao App Hash. O valor do Secret Hash faz o hash de todas as configurações que você informa junto com o valor do App Hash, produzindo um hash único e imutável. Se você notar que o valor do Secret Hash mudou, isso indica que suas configurações atuais foram modificadas ou que o valor do App Hash mudou por completo. A cada atualização do aplicativo, o valor do App Hash também muda, o que significa que o valor atual do Secret Hash também mudará.

Devo usar o recurso PubKey? Recomendamos fortemente que sim. Quando você usa o PubKey, se uma chave for encontrada (seja do puzzle 71 ou de qualquer outro), o aplicativo a criptografa com a RSA Public Key que você forneceu. Isso significa que, quando uma chave é encontrada no computador que roda o aplicativo, apenas a informação criptografada é salva ou enviada como notificação. O conteúdo criptografado só pode ser descriptografado com a chave privada que só você possui — a RSA Private Key que você gerou em qualquer site de sua escolha.

Este site, o cliente e todo o resto foram criados com muita paixão e carinho por um pai de dois filhos. Suas doações me ajudam a continuar dedicado a este projeto.

Doação em Bitcoin (BTC): ❤️ 1LKERC27h9BpkKbkTQ1c83dASww74a4eDU

Me pague um café

Puzzles do pool

O que o pool escaneia agora, o que vem a seguir e os puzzles em que ele já trabalhou.

Escaneando agora1

Próximo2

Escaneados antes4

Todos os 160 puzzles