Skip to content

Latest commit

 

History

History
248 lines (163 loc) · 9.25 KB

HOW-TO-USE.md

File metadata and controls

248 lines (163 loc) · 9.25 KB

Run on Windows

Download and install .NET 6.0.x runtimes for Windows from Microsoft.

1 - Go to ilkerccom/bitcrackrandomiser/releases and download latest released "bitcrackrandomiser.zip" file.

2 - Unzip downloaded file.

bitcrackrandomiser

3 - Edit settings.txt file from "bitcrackrandomiser" app folder.

a. Enter "user_token" value. Get your "user_token" from btcpuzzle.info/user-center website.

b. Enter "wallet_address" value. You should use your BTC wallet address.

c. Save the file.

4 - Run the "BitcrackRandomiser.exe"

bitcrackrandomiser

Run on Windows as Docker Image

NOTE: ONLY FOR NVIDIA DEVICES! The relevant docker image only builds for "cuda devices". For AMD and OpenCL devices, use the "BUILD_OPENCL=1" argument in the dockerfile. (or go to Long Way section)

Download and install Docker app

There are two Docker images you can use for Bitcrackrandomiser.

Manual Launch

ilkercndk/bitcrackrandomiser:latest will be used for manual launch.

1 - Open a new Command Prompt console and write below code.

docker run --gpus all -it ilkercndk/bitcrackrandomiser:latest

2 - Press enter and bingo!

docker console

3 - Edit settings file. You can use following code to edit on console.

$ nano settings.txt

Or you can edit "settings.txt" file from Docker app in currently active container.

docker edit settings file

4 - Enter following command end press ENTER.

$ dotnet BitcrackRandomiser.dll

Auto Launch

ilkercndk/bitcrackrandomiser:autorun will be used for auto launch.

1 - Open a new Command Prompt console and write below code.

docker run --gpus all -e BC_USER_TOKEN={your_user_token} -e BC_WALLET={your_wallet_address} ilkercndk/bitcrackrandomiser:autorun

You can use more settings for this docker image. See below (default settings);

-e BC_PUZZLE=66
-e BC_USERTOKEN="0"
-e BC_WALLET="1eosEvvesKV6C2ka4RDNZhmepm1TLFBtw"
-e BC_APP_TYPE="vanitysearch"
-e BC_APP="/app/VanitySearch/./vanitysearch"
-e BC_APP_ARGS=""
-e BC_GPUCOUNT="1"
-e BC_GPUINDEX="0"
-e BC_SCAN_TYPE="includeDefeatedRanges"
-e BC_SCAN_REWARDS="true"
-e BC_CUSTOM_RANGE="none"
-e BC_API_SHARE="none"
-e BC_TELEGRAM_SHARE="false"
-e BC_TELEGRAM_ACCESS_TOKEN="0"
-e BC_TELEGRAM_CHAT_ID="0"
-e BC_TELEGRAM_SHARE_EACHKEY="false"
-e BC_UNTRUSTED_COMPUTER="false"
-e BC_FORCE_CONTINUE="false"
-e BC_PRIVATEPOOL="none"

2 - No more step. The application started automatically.

Run on CloudSearch

CloudSearch by btcpuzzle.info

Discover the easiest way to use the app and join the pool. Everything here is optimized for the application and the repository. Top up the balance and rent the instance at the hourly rates you want.

1 - Create an account on BTCPuzzle.info website and activate your CloudSearch account.

2 - Create template. The templates in Cloud Search are an area where you can create settings for “bitcrackrandomiser” and you can create as many templates as you want. Templates are used when creating instances.

Templates on CloudSearch

3 - Top up balance (USD) using Polygon, Base, ETH and many other networks.

4 - Rent! To create a new instance, you first need a template that you can use. You can create new instances with default settings without using a template. Scroll down to the Cloud Search page and click on the “Search Instances” link. Select the template you want to use. Then, rent the instance by clicking the "Rent" button next to any instance you want to rent.

Rent instance on CloudSearch

You are now ready! You can read the questions you are wondering about on the FAQ. page.

Run on Vast.ai

NOTE [1]: ONLY FOR NVIDIA DEVICES! The relevant docker image only builds for "cuda devices". For AMD and OpenCL devices, use the "BUILD_OPENCL=1" argument in the dockerfile. (or go to Long Way section)

NOTE [2]: When you use Vast.ai or similar, I recommend setting the value of "untrusted_computer" to "true" and turning on Telegram or Api share. Api share is always a better option instead of Telegram. If you don't, when the key is found it will be saved to the running instance. If you have not selected any sharing options, you will not receive a notification when the key is found.

Example docker options;

-e BC_UNTRUSTED_COMPUTER=true -e BC_API_SHARE=https://yourapiwebsite.com ...any other settings

For more information about API share, go to related page.

security hash

Additionally, the "security hash" value (in your dashboard) that I underlined in red above is simple security information. This value changes when there is a change in the settings in which you run the application or when there is any code change in the application. With each new version (bitcrackrandomiser), new values are generated even if your settings remain the same.

Register Vast.ai to rent GPU(s).

Easiest way

Use custom docker image ilkercndk/bitcrackrandomiser:autorun from dockerhub in "Template Slot" and run any instance.

vast ai console

You can enter any settings you want in the "Docker options" field. "wallet_addres" and "user_token" values are entered in this field.

You can create a template similar to the one above and rent the instance you want with this template. When you rent instance, bitcrackrandomiser will be run automatically according to the settings you enter. Make sure any of the Telegram or Api Share settings are active. It is also a useful setting to set the "untrusted_computer" value to "true" when using vast.ai. Thus, when the key is found, it is not saved anywhere in the running instance.

vast ai console instance

Example

Using ilkercndk/bitcrackrandomiser:autorun image.

Docker options

-e BC_WALLET=1eosEvvesKV6C2ka4RDNZhmepm1TLFBtw -e BC_USERTOKEN {YOUR_USERTOKEN_VALUE} -e BC_SCAN_TYPE=excludeIterated4

Launch mode

[x] Docker Run: use docker ENTRYPOINT.

Short Way

Use custom docker image ilkercndk/bitcrackrandomiser:latest from dockerhub in "Template Slot" and run any instance.

Connect instance. Vast.ai doesnt support --it interactive arguments for docker image on SSH. You must go to main folder;

$ cd /app/bitcrackrandomiser

Then edit settings.txt file and run the app.

$ dotnet BitcrackRandomiser.dll

(Optional) Auto-start bitcrackrandomiser on instance starts; enter your parameters to on-start script on vast.ai. You can use all the variables in the settings.txt file.

$ cd /app/bitcrackrandomiser
$ dotnet BitcrackRandomiser.dll app_path=/app/BitCrack/bin/./cuBitCrack app_arguments="-b 896 -t 256 -p 256" user_token=xxxx wallet_address=1eosEvvesKV6C2ka4RDNZhmepm1TLFBtw;

You can use env variables for docker entrypoint with ilkercndk/bitcrackrandomiser:autorun image:

-e BC_PUZZLE=66
-e BC_USER_TOKEN=0
-e BC_WALLET=1eosEvvesKV6C2ka4RDNZhmepm1TLFBtw
-e BC_APP=/app/BitCrack/bin/./cuBitCrack
-e BC_APP_ARGS="-b 896 -t 256 -p 256"
-e BC_SCAN_TYPE=includeDefeatedRanges
-e BC_CUSTOM_RANGE=none
-e BC_TELEGRAM_SHARE=false
-e BC_TELEGRAM_ACCESS_TOKEN=0
-e BC_TELEGRAM_CHAT_ID=0
-e BC_TELEGRAM_SHARE_EACHKEY=false
-e BC_UNTRUSTED_COMPUTER=false

Example docker create/run options

-e BC_USER_TOKEN=xxxx -e BC_WALLET=1eosEvvesKV6C2ka4RDNZhmepm1TLFBtw -e BC_SCAN_TYPE=default -e BC_UNTRUSTED_COMPUTER=true

Long Way

(1) Select custom docker image nvidia/cuda:12.0.0-devel-ubuntu20.04 in "Template Slot" and run any instance. (3090 or 4090 is fine)

(2) Connect instance via SSH client (Like PuTTY). Follow commands:

$ sudo apt install nano
$ wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh
$ sudo chmod +x ./dotnet-install.sh
$ ./dotnet-install.sh --version latest
$ export DOTNET_ROOT=$HOME/.dotnet
$ export PATH=$PATH:$HOME/.dotnet:$HOME/.dotnet/tools
$ export DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1
$ git clone https://github.com/brichard19/BitCrack
$ cd BitCrack
$ make BUILD_CUDA=1 COMPUTE_CAP=86
$ git clone https://github.com/ilkerccom/bitcrackrandomiser
$ cd bitcrackrandomiser/BitcrackRandomiser

Edit settings.txt file. You can edit settings.txt file with nano settings.txt or connect with WinSCP and download-edit settings.txt file. Example below:

target_puzzle=66
app_type=bitcrack
app_path=/root/BitCrack/bin/./cuBitCrack
app_arguments=-b 896 -t 256 -p 256
user_token=xxxxxxxxxxxxxxxxxx
wallet_address=1eosEvvesKV6C2ka4RDNZhmepm1TLFBtw
... other settings

Finally, run the app.

$ dotnet run

You can press "CTRL+B" and then "D" to leave terminal without closing app.