KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

btc-hack-offline

★ 103 Open GitHub ↗

An automated bitcoin wallet generator that brute forces random wallet addresses by checking their balance against an offline database.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![btc-hack](https://socialify.git.ci/DavidMGilbert/btc-hack-offline/image?description=0&font=Raleway&forks=1&issues=1&language=1&owner=1&pattern=Circuit%20Board&pulls=1&stargazers=1&theme=Dark)

<h2 align=center> ⚠ PLEASE NOTE: This code is only for educational purposes. ⚠ </h2>
<h2 align=center> ⚠ If you do something illegal expect to be held responsible for your own actions. ⚠ </h2>

<h2 align=center> Like This Project? Give It A Star or please consider donating!</h2>

<h2 align=center> My Bitcoin Wallet Address: 1LKKJE62ygo2c9K2Xc8GxuGwpVDnvyRFRD </h2>

<h2 align=center> 📑 Introduction </h2>

This program is essentially a brute forcing algorithm. It continuously generates random Bitcoin private keys, converts the private keys into their respective wallet addresses, then checks the balance of the addresses. If a wallet with a balance is found, then the private key, public key and wallet address are saved to the text file `found.txt` on the user's hard drive. The ultimate goal is to randomly find a wallet with a balance out of the 2<sup>160</sup> possible wallets in existence.

A private key is a secret number that allows Bitcoins to be spent. If a wallet has Bitcoins in it, then the private key will allow a person to control the wallet and spend whatever balance the wallet has. So this program attempts to find Bitcoin private keys that correlate to wallets with positive balances. However, because it is impossible to know which private keys control wallets with money and which private keys control empty wallets, we have to randomly look at every possible private key that exists and hope to find one that has a balance.

# How It Works

32 byte hexidecimal strings are generated randomly using `os.urandom()` and are used as our private keys.

The private keys are converted into their respective public keys using the `fastecdsa` python library. This is the fastest library to perform secp256k1 signing. If you run this on Windows then `fastecdsa` is not supported, so instead we use `starkbank-ecdsa` to generate public keys. The public keys are converted into their Bitcoin wallet addresses using the `binascii` and `hashlib` standard libraries.

A pre-calculated database of every funded P2PKH Bitcoin address is included in this project. The generated address is searched within the database, and if it is found that the address has a balance, then the private key, public key and wallet address are saved to the text file `found.txt` on the user's hard drive.

This program also utilizes multiprocessing through the `multiprocessing.Process()` function in order to make concurrent calculations.

# Efficiency

It takes `0.002` seconds for this progam to brute force a __single__ Bitcoin address.

However, through `multiprocessing.Process()` a concurrent process is created for every CPU your computer has. So this program can brute force a single address at a speed of `0.002 ÷ cpu_count()` seconds.

# Database FAQ

An offline database is used to find the balance of generated Bitcoin addresses. Visit <a href="/database/">/database</a> for information.

# Parameters

This program has optional parameters to customize how it runs:

__help__: `python3 btc-hack-offline.py help` <br />
Prints a short explanation of the parameters and how they work

__time__: `python3 btc-hack-offline.py time` <br />
Brute forces a single address and takes a timestamp of how long it took - used for speed testing purposes

__verbose__: 0 or 1 <br />
`python3 btc-hack-offline.py verbose=1`: When set to 1, then every bitcoin address that gets bruteforced will be printed to the terminal. This has the potential to slow the program down

`python3 btc-hack-offline.py verbose=0`: When set to 0, the program will not print anything to the terminal and the bruteforcing will work silently. By default verbose is set to 0

__substring__: `python3 btc-hack-offline.py substring=8`:
To make the program memory efficient, the entire bitcoin address is not loaded from the database. Only the last <__substring__> characters are loaded. This significantly reduces the amount of RAM required to run the program. if you still get memory errors then try making this number smaller, by default it is set to 8. This opens us up to getting false positives (empty addresses mistaken as funded) with a probability of 1/(16^<__substring__>), however it does NOT leave us vulnerable to false negatives (funded addresses being mistaken as empty) so this is an acceptable compromise.

__cpu_count__: `python3 btc-hack-offline.py cpu_count=1`: number of cores to run concurrently. More cores = more resource usage but faster bruteforcing. Omit this parameter to run with the maximum number of cores

By default the program runs using `python3 btc-hack-offline.py verbose=0 substring=8` if nothing is passed.
  
# Expected Output

If a wallet with a balance is found, then all necessary information about the wallet will be saved to the text file `found.txt`. An example is:

>hex private key: 5A4F3F1CAB44848B2C2C515AE74E9CC487A9982C9DD695810230EA48B1DCEADD<br/>
>WIF private key: 5JW4RCAXDbocFLK9bxqw5cbQwuSn86fpbmz2HhT9nvKMTh68hjm<br/>
>public key: 04393B30BC950F358326062FF28D194A5B28751C1FF2562C02CA4DFB2A864DE63280CC140D0D540EA1A5711D1E519C842684F42445C41CB501B7EA00361699C320<br/>
>uncompressed address: 1Kz2CTvjzkZ3p2BQb5x5DX6GEoHX2jFS45<br/>

<h2 align=center> 👨🏻‍💻 How to get started? </h2>

Compiling & Use
 --------

# Dependencies

<a href="https://www.python.org/downloads/">Python 3.9</a> or higher

Python modules listed in the <a href="/requirements.txt">requirements.txt<a/>

If you have a __Linux__ or __MacOS__ operating system, libgmp3-dev is required. If you have __Windows__ then this is not required. Install by running the command:
```
sudo apt-get install libgmp3-dev
```

# Installation

```
git clone https://github.com/davdmgilbert/btc-hack-offline.git btc-hack-offline
```
```
cd btc-hack-offline && pip3 install -r requirements.txt
```

# Quick Start

```
python3 btc-hack-offline.py
```

<h2 align=center> 📝 How to Contribute & To do </h2>

<h2 align=center> ✨ Contributors ✨ </h2>
  
  <table>
	<tr>
		<td>
			<a href="https://github.com/DavidMGilbert/btc-hack/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=DavidMGilbert/btc-hack" />
      </a>
		</td>
	</tr>
</table>

Contributions of any kind welcome!

<h1 align=center> Project Admin </h1>
<p align="center">
  <a href="https://www.davidmgilbert.com"><img src="https://avatars.githubusercontent.com/u/118702908?v=4" width=150px height=150px /></a>

<h1 align=center>Happy Hacking 👨‍💻</h1>

btc-hack-offline

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README