Metadata-Version: 2.1
Name: bitcoin-address-generator
Version: 0.1.0
Summary: A Python package for generating Bitcoin addresses using ECDSA
Home-page: https://github.com/ol-s-cloud/bitcoin-address-generator
Author: ol-s-cloud
Author-email: gs_wl889@icloud.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ecdsa>=0.18.0
Requires-Dist: base58>=2.1.1
Requires-Dist: click>=8.0.0

# Bitcoin Address Generator

[![PyPI version](https://badge.fury.io/py/bitcoin-address-generator.svg)](https://badge.fury.io/py/bitcoin-address-generator)
[![Python Package](https://github.com/ol-s-cloud/bitcoin-address-generator/actions/workflows/python-package.yml/badge.svg)](https://github.com/ol-s-cloud/bitcoin-address-generator/actions)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## ⚠️ Educational and Development Use Only
This package is intended for educational and development purposes. Do not use for production or with real Bitcoin transactions.

## Introduction
This repository explores the use of randomly generated hexadecimal numbers to create a bitcoin wallet address using the Elliptic Curve Digital Signature Algorithm. When Alice wants to buy a book from Bob, after all has been agreed upon, Bob needs to provide Alice with a bitcoin wallet address where the payments will be deposited. The transaction will be done on the blockchain, so Bob needs a bitcoin wallet address to receive payments. This repository covers how a bitcoin wallet address can be created from randomly generated private keys.

In cryptography, the Elliptic Curve Digital Signature Algorithm (ECDSA) offers a variant of the Digital Signature Algorithm (DSA) which uses elliptic-curve cryptography.

## Method
Bob signs a hash of a message with his private key, and then Alice proves with his public key. Bob also uses a random nonce value for the signature (K)

![ecdsa_new](https://github.com/ol-s-cloud/bitcoin-address-generator/assets/134246135/3311cd8a-cebb-465e-bea8-91fcf7ffb39d)

With ECDSA, Alice will sign a message with her private key, and then Bob will use her public key to verify that she signed the message (and that the message has not changed)
![ecdsa](https://github.com/ol-s-cloud/bitcoin-address-generator/assets/134246135/e062bc0a-fc16-4203-a0fa-c0844cb995df)

The diagram below illustrates the architecture and how the Bitcoin wallet addresses are created:

![Architecture](https://github.com/ol-s-cloud/bitcoin-address-generator/assets/134246135/5c530686-c50a-4a00-bce7-3d1be3462d99)

## Features
- Generate random private keys
- Convert private keys to public keys using ECDSA
- Create valid Bitcoin addresses
- Command-line interface
- Comprehensive validation
- Educational examples and documentation

## Setting Up Our Environment
To achieve desired outcome, first we need to set-up the environment. For development purposes, you can use:
1. Google Colab environment - https://colab.research.google.com/
2. Local Python environment
3. Package installation via pip (see Installation section)

For getting randomly generated private keys, you can use:
- Random generation within the package
- Private keys from wallet addresses created via https://www.bitaddress.org
- Other hex generators like https://www.browserling.com/tools/random-hex

Note: For production use, always ensure secure methods of private key generation.

## Python Libraries & Dependencies
• **ECDSA Python Library** - Implementation of the Elliptic Curve Cryptography
• **Hashlib** - Contains hash algorithms for SHA256, RIPEMD160
• **Codecs** - For encoding and decoding
• **Base58** - For Base58Check encoding

## Installation
```bash
pip install bitcoin-address-generator
```

## Quick Start
```python
from bitcoin_address_generator import generate_wallet

# Generate new wallet
private_key, public_key, address = generate_wallet()
print(f"Bitcoin Address: {address}")
```

## Command Line Usage
```bash
# Generate new address
bitcoin-address-generator generate

# Validate address
bitcoin-address-generator validate <address>
```

## Development Roadmap

### v0.1.0 (Current)
- Basic Bitcoin address generation
- Command-line interface
- Core cryptographic operations
- Educational documentation
- Test suite

### v0.2.0 (Planned)
- Support for different address types (P2SH, SegWit)
- Key encryption for secure storage
- QR code generation for addresses
- Bulk address generation
- Basic transaction signing

### v0.3.0 (Planned)
- HD wallet support (BIP32/39/44)
- Mnemonic phrase generation
- Multi-signature support
- Network validation
- Address balance checking

### v0.4.0 (Planned)
- Web interface
- API endpoint support
- Transaction history
- Address monitoring
- Automated testing with testnet

## Documentation
- [Technical Guide](docs/TECHNICAL.md)
- [API Reference](docs/API.md)
- [Security Info](docs/SECURITY.md)

## Feedback
If you have any feedback, please reach out to me at gs_wl889@icloud.com

## Contributing
Contributions are always welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for ways to get started.
Please adhere to this project's [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).

## Love to read more? Here are some resources & references
- [Bitcoin Technical Document](https://en.bitcoin.it/wiki/Technical_background_of_version_1_Bitcoin_addresses)
- [List of Addresses Prefixes](https://en.bitcoin.it/wiki/List_of_address_prefixes)
- [Elliptic Curve Digital Signature Algorithm](https://en.bitcoin.it/wiki/Elliptic_Curve_Digital_Signature_Algorithm)
- [ECDSA Python Library](https://pypi.org/project/ecdsa/)
- [SEC2: Recommended Elliptic Curve Domain Parameters](https://www.secg.org/sec2-v2.pdf)
- [Efficient and Secure ECDSA Algorithm Survey](https://www.researchgate.net/publication/331397446_Efficient_and_Secure_ECDSA_Algorithm_and_its_Applications_A_Survey)

## Security
This package is for educational purposes. See [SECURITY.md](SECURITY.md) for important security considerations.

## License
[MIT](https://choosealicense.com/licenses/mit/)

