Как начать

Что такое пул, как настроить клиент и как работает сканирование.

Что такое btcpuzzle.info?

btcpuzzle.info — соло-пул, созданный специально для Bitcoin Puzzle (или challenge). Он открытый и заслуживает доверия. Он работает по принципу Proof of Work (PoW) и защищён от злонамеренных атак. Чтобы вступить в пул, нужен клиент. Этот клиент имеет открытый исходный код, и при желании любой может разработать собственный клиент. В этом руководстве процесс вступления в пул объясняется на примере нашего официального клиента.

Что такое BTC Puzzle (challenge)?

BTC Puzzle не совсем соответствует тому, что подразумевает его название. Он был создан полностью анонимно и содержит награды на общую сумму более 1000 BTC. Проще говоря, puzzle — это поиск правильного числа в определённом диапазоне между двумя числами. Однако при сегодняшних технологиях и архитектуре блокчейна Bitcoin сложность растёт по мере увеличения этих диапазонов. Именно поэтому нужен пул.

btcpuzzle.info — соло-пул: тот, кто найдёт решение, получает награду. Однако просканированные диапазоны общие. Диапазон, уже просканированный одним участником, не может быть повторно просканирован другим.

Ниже собраны важные ссылки, связанные с проектом. Если нужна дополнительная помощь, обратитесь через раздел поддержки ниже.

Руководства и документация

Соберите сами

Клиент и все используемые приложения можно собрать самостоятельно. Клиент и приложения на 100% открыты.

Proof Of Work (PoW)

При запросе диапазона у пула также возвращаются шесть адресов кошельков. Приватные ключи этих адресов сканируются одновременно. Чтобы подтвердить, что диапазон просканирован, нужно найти приватные ключи всех шести адресов кошельков. Приватные ключи найденных адресов хешируются SHA256. Так создаётся "Proof Key". Это нужно, чтобы убедиться, что ваша программа работает правильно. Я также хочу быть уверен, что сканирование действительно полноценное.

Пример: пул возвращает для сканирования HEX-диапазон 3E2ECB0. Пул случайным образом генерирует 6 дополнительных приватных ключей внутри возвращённого HEX-диапазона. 3E2ECB00000000000 и 3E2ECB0FFFFFFFFFF.

Отметка выполняется с помощью

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

Примечание: число ключей подтверждения может динамически увеличиваться/уменьшаться через API. Стандартно их всего 6.

Как вступить в пул?

Вступить в пул довольно просто. Как минимум нужна видеокарта Nvidia. Либо можно легко вступить через CloudSearch.

Пошаговое руководство

  1. 01

    Создайте аккаунт на сайте BTCPuzzle.info и получите свой токен пользователя.

  2. 02

    Скачайте последнюю версию клиента Btcpuzzle.info или соберите его сами.

  3. 03

    Отредактируйте файл pool.conf под себя.

  4. 04

    Запустите приложение.

CloudSearch

Если вы ищете самый простой способ вступить в пул, вы по адресу. Арендуйте нужную видеокарту по почасовой ставке и охотьтесь за наградой. Перейдите в CloudSearch от btcpuzzle.info.

  1. 01

    Создайте аккаунт на сайте BTCPuzzle.info и активируйте аккаунт CloudSearch.

  2. 02

    Пополните баланс (USD) через Polygon, Base, ETH и многие другие сети.

  3. 03

    Создайте шаблон и арендуйте нужный инстанс. Вот и всё!

Клиент Btcpuzzle.info

В этом разделе описаны возможности клиента btcpuzzle.info. Подробно описаны поддерживаемые функции и то, как пользоваться клиентом. Если у вас есть вопросы, можно получить поддержку в группе Telegram. Предыдущий клиент btcpuzzle.info, "“btcpuzzle-client”", больше не будет использоваться и развиваться.

Настройки (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

Настройки приложения можно изменить в файле pool.conf или в самом приложении. Файл настроек можно создать в панели на btcpuzzle.info. Также можно передавать приложению аргументы, как в примере ниже.

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

[user_token]

Значение токена пользователя можно создать, войдя в аккаунт на btcpuzzle.info. Если аккаунта нет, создайте новый с помощью адреса email (адрес кошелька затем указывается в настройках аккаунта).

Токен пользователя можно отозвать в любой момент. Однако после этого нужно указать новое значение и в файле настроек воркеров.

Пример значения токена пользователя:

VDGcruTrDZ62EuJsE9IQUCiRIKRhZpXw6RPtcnk1jBxbROn1nxZixBMql8L2zxKwD9QXb1UZoWgrDf8IwciRDUHxHzwkNrDzNBpio2UdAx4rLYsjMnI887eqWGauszBl

[worker_name]

Укажите имя воркера. worker4124 или любое workername

Допускаются только буквы и цифры. Не более 16 символов. Не используйте специальные символы. Если имя воркера не указано, оно будет создано автоматически.

[target_puzzle]

Выберите puzzle для сканирования. 38, 71 или любой текущий puzzle. Для тестового пула используйте 38. В тестовом пуле 32 возможных диапазона. Данные тестового пула есть на сайте. Данные тестового пула сбрасываются каждые 30 минут.

[public_key]

Тип ключа: RSA PKCS#8 - 1024 Bit

Эта настройка работает вместе с untrusted_computer. Если вы указываете действительное значение Public Key, значение untrusted_computer автоматически становится true. Эта настройка создаёт безопасную рабочую среду, особенно для инстансов на удалённых серверах.

Если ключ будет найден, он будет зашифрован указанным вами публичным ключом. Это значит, что даже владелец инстанса не сможет узнать приватный ключ. Зашифрованный ключ будет отправлен вам через Telegram или Custom API Share. Расшифровать этот ключ сможете только вы своим RSA Private Key.

Для примера, чтобы сгенерировать собственный ключ RSA, можно воспользоваться этой страницей: https://emn178.github.io/online-tools/rsa/key-generator/

Сгенерируйте ключ RSA на этой странице и обязательно сохраните свой Private Key. Public Key вы будете использовать в инстансах. Чтобы убедиться, что всё работает правильно, сначала проведите тесты на Puzzle 38. Затем попробуйте расшифровать найденный ключ своим Private Key.

Эта настройка рекомендуется опытным пользователям, и её не следует использовать без должного понимания. Ниже пример сгенерированного RSA Public Key.

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

Передавать это значение приложению нужно так: замените все переносы строк символом "|", чтобы получилась одна строка, и используйте её. Также можно использовать символ "@". Тогда все инстансы, запущенные с этим аргументом, будут шифровать любой приватный ключ этим публичным ключом и отправлять его вам. Помните: расшифровать эти данные сможете только вы своим Private Key.

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

Когда клиент зашифрует ключ и отправит его вам, вы получите зашифрованное сообщение в формате base64, похожее на приведённое ниже. Расшифровать его можно с помощью Private Key сгенерированного вами ключа RSA.Напоминание для тех, кто может быть не знаком с этим: какой бы публичный ключ вы ни указали клиенту или инстансу, обязательно сохраните соответствующий ему приватный ключ. Зашифрованное сообщение можно расшифровать только этим приватным ключом, и иначе его не восстановить.

mTCyRIE999ABAiTQ21oWvKDQMlezFVoz4cXKae4tHcg7z1LeQo0ud8/c6xtVymJrWeTXIYCCV1ZHAFkPTOYvsSoeOgL1uLWtsnE3lDWxR01Ht4LsP0W0YptNYf7g+Knd3SclRORuSqwsuglRHttzTyp+JvjITEFulKxi7yRW3gk=

[telegram_token]

Укажите токен доступа Telegram-бота. Пример: 6331494066:ABEfv4cF3dbc3mA8qGLDlEp2uxzgYESIa_w

[telegram_chat_id]

Укажите ID чата Telegram. Пример: -1001945678901

[telegram_share]

Если вы указали токен и ID чата, описанные выше, значение автоматически станет "true", поэтому указывать его отдельно не нужно.

true: отправлять прогресс в Telegram.

false: уведомления не отправляются.

Если настройки Telegram верны, вы получите уведомление о том, что воркер начал работу. Совет: если вы работаете на ненадёжном компьютере, задайте настройки через консоль и продолжайте без сохранения. ВАЖНО: если ключ найден, а Telegram не может передать его вам, попытки будут повторяться без ограничений.

[api_share_url]

empty или https://yourwebsite.com

Получайте все события в виде POST-запроса на свой сервер. Все значения передаются как "header". Ниже показано, какие данные приходят.

ВАЖНО: если ключ найден, а от API (body) получен неуспешный ответ, попытки повторяются без ограничений.

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]

Пример скрипта 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';
?>

API должен возвращать результат true. Возвращаемое значение проверяется только при нахождении ключа, и новые запросы отправляются до тех пор, пока API не ответит 'true' (без ограничения попыток).

[api_share]

true или false

Если вы указали действительный URL в API Share URL, это значение автоматически станет "true", поэтому менять его вручную не нужно.

[save_key]

Эта функция работает, только если указан действительный "RSA Public Key". Если клиент найдёт приватный ключ puzzle, ключ будет зашифрован на стороне клиента указанным вами RSA Public Key, а затем сохранён в базе данных btcpuzzle.info. Сохранённые ключи можно посмотреть на странице своей панели. Все сохранённые здесь ключи зашифрованы вашим публичным ключом, поэтому никто — включая команду btcpuzzle.info — не может прочитать или расшифровать это содержимое.

Чтобы расшифровать это содержимое, понадобится "RSA Private Key", который есть только у вас и который вы должны сгенерировать на внешней платформе. Поэтому не потеряйте приватный ключ, соответствующий RSA Public Key, указанному в клиенте. Шифрование полностью выполняется на стороне клиента, что исключает утечку ключа.

Это альтернатива для пользователей, которым сложно пользоваться Telegram или API Share, и для тех, кто хочет надёжно хранить свои ключи. Стоит подчеркнуть ещё раз: шифрование выполняется в клиенте, работающем на вашей системе. Используется шифрование RSA, и в базе данных хранится только зашифрованный приватный ключ. Никто — включая команду btcpuzzle.info — не может получить доступ к этому содержимому или прочитать его. Расшифровать его может только тот, у кого есть соответствующий публичному ключу "RSA Private Key".

ВАЖНО: оператор пула не может расшифровать ключи, зашифрованные RSA. Однако недобросовестный оператор мог бы просмотреть ранее просканированные пользователем диапазоны, оценить область, где был найден ключ, и повторно просканировать её в своих интересах. Поэтому тщательно взвесьте, стоит ли использовать функцию save_key. Хотя у меня нет намерения так поступать, я считаю важным открыто говорить о возможных рисках и о том, как работает система. Пользователям, которым нужен максимальный уровень конфиденциальности, рекомендуется использовать вместо этого функцию "api_share". В будущем я придумаю новые способы сделать эту функцию безопаснее и надёжнее.

[custom_range]

none: сканировать все диапазоны.

2D or 3BA or 3FF1: укажите первые [1-7] символов диапазона, который хотите сканировать. Только одно значение.

Можно задать диапазон вида 3400000:38FFFFF. Выдаваемые ключи будут выбираться из этого диапазона. Диапазон нужно записать полной длины. Убедитесь, что указали правильный диапазон.

Примечание: для поля custom range можно указать только одну настройку.

👶🏽Для новичков👶🏿

Если вы впервые столкнулись с Bitcoin Puzzle или не знакомы с некоторыми техническими терминами и ищете простой способ решать puzzle (или просто развлечься), мы покажем самый простой и надёжный путь.

  1. 01

    1 - Создайте бесплатный аккаунт на btcpuzzle.info и активируйте аккаунт CloudSearch. Затем пополните баланс на нужную сумму.

  2. 02

    2 - Перейдите на следующую страницу и сгенерируйте собственные "RSA Public & Private Key": https://emn178.github.io/online-tools/rsa/key-generator/ Не потеряйте эти два значения и храните их надёжно. В особенности никогда никому не передавайте свой "Private Key" — включая команду btcpuzzle.info.

  3. 03

    3 - Создайте новый шаблон в CloudSearch. В шаблоне укажите в поле "public_key" сгенерированное ранее значение. Также установите для опции "save_key" значение "Enabled/Active", дайте шаблону название и сохраните его. Кроме этих двух, менять другие настройки не нужно. Только убедитесь, что puzzle выбран правильно.

  4. 04

    4 - Вот и всё! Теперь арендуйте любой понравившийся GPU с созданным шаблоном. Проверьте логи, чтобы убедиться, что арендованные GPU работают правильно. Теперь вы охотник за наградами в мире Btc Puzzle!

Если ключ будет найден, вы увидите его в "зашифрованном" виде на странице "Найденные ключи". Чтобы расшифровать это содержимое, понадобится "RSA Private Key", созданный на шаге 2. Вернитесь на тот же сайт из шага 2, откройте раздел "Decrypt" и введите правильные значения, чтобы получить приватный ключ с наградой за puzzle.

Этот способ рекомендуется btcpuzzle.info и считается безопасным и надёжным. Найденный ключ не будет раскрыт — доступ к нему будет только у вас! Удачи с puzzle!

Образы Docker

С помощью Dockerfile в репозитории можно легко создать собственный образ. Официальные образы Docker для btcpuzzle.info доступны по этому адресу: https://hub.docker.com/r/ilkercndk/btcpuzzle/tags. Кроме того, можно собрать собственный образ Docker с помощью "Dockerfile", доступного на GitHub.

Как использовать образы Docker

ilkercndk/btcpuzzle:latest

Запустите команду со своими настройками. Пример:

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

Образ Docker собран с CUDA 12.8, чтобы поддерживать как GPU NVIDIA серии 5000, так и более старые видеокарты. Поэтому на платформах вроде CloudSearch, Vast.ai или Clore.ai запускайте инстансы как минимум с этой версией CUDA. CloudSearch по умолчанию автоматически отфильтровывает инстансы с более низкими версиями CUDA.

Чтобы образ Docker запускался автоматически после загрузки, укажите в поле "Startup script" следующее значение.

bash /app/btcpuzzle.sh

Настройки по умолчанию

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"

Как создать/собрать/опубликовать образ Docker?

1 - Соберите docker-файл.

$ docker build -t btcpuzzle .

2 - Присвойте образу тег (для публикации в hub) в формате {username}/{image_name}:{tag}.

$ docker tag btcpuzzle ilkercndk/btcpuzzle:latest

Дополнительная информация

Что такое App Hash? App Hash — хеш-значение, полученное подписью кода приложения. Последний скомпилированный код приложения зафиксирован, и это значение не меняется, пока в код не внесены изменения. Если вы заметили, что значение App Hash изменилось, это значит, что код запущенного приложения был изменён. Это дополнительная мера безопасности.

Что такое Secret Hash? Secret Hash — мера безопасности, связанная с App Hash. Значение Secret Hash хеширует все введённые вами настройки вместе со значением App Hash и даёт уникальный неизменяемый хеш. Если вы заметили, что значение Secret Hash изменилось, значит, либо изменились ваши текущие настройки, либо полностью изменилось значение App Hash. С каждым обновлением приложения меняется и App Hash, а значит, изменится и текущее значение Secret Hash.

Стоит ли использовать функцию PubKey? Мы настоятельно рекомендуем её использовать. При использовании PubKey, если ключ найден (для Puzzle 71 или любого другого), приложение шифрует его указанным вами RSA Public Key. Это значит, что когда ключ найден на компьютере, где работает приложение, сохраняется или отправляется в уведомлении только зашифрованная информация. Зашифрованное содержимое можно расшифровать только приватным ключом, который есть только у вас, — RSA Private Key, сгенерированным вами на любом выбранном сайте.

Этот сайт, клиент и всё остальное созданы с большой страстью и любовью отцом двоих детей. Ваши пожертвования помогают мне продолжать заниматься этим проектом.

Пожертвования в Bitcoin (BTC): ❤️ 1LKERC27h9BpkKbkTQ1c83dASww74a4eDU

Угостите меня кофе

Puzzle пула

Что пул сканирует сейчас, что дальше и над какими puzzle он уже работал.

Сканируется1

Далее2

Ранее4

Все 160 puzzle