lunalib 1.1.0__tar.gz

lunalib-1.1.0/PKG-INFO

@@ -0,0 +1,283 @@
+Metadata-Version: 2.4
+Name: lunalib
+Version: 1.1.0
+Summary: A Complete Cryptocurrency Wallet and Mining System
+Home-page: https://github.com/taellinglin/LunaLib
+Author: Ling Lin
+Author-email: taellinglin@gmail.com
+License: MIT
+Project-URL: Bug Tracker, https://github.com/taellinglin/LunaLib/issues
+Project-URL: Documentation, https://linglin.art/docs/luna-lib
+Project-URL: Source Code, https://github.com/taellinglin/LunaLib
+Keywords: cryptocurrency,blockchain,wallet,mining,bitcoin,ethereum,crypto
+Classifier: Development Status :: 4 - Beta
+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: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Security :: Cryptography
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: qrcode[pil]>=7.4.0
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: pytest>=7.4.0
+Requires-Dist: pytest-cov>=4.1.0
+Requires-Dist: pytest-mock>=3.11.0
+Requires-Dist: coverage>=7.0.0
+Requires-Dist: black>=23.0.0
+Requires-Dist: flake8>=6.0.0
+Requires-Dist: mypy>=1.5.0
+Requires-Dist: isort>=5.12.0
+Requires-Dist: bandit>=1.7.0
+Requires-Dist: build>=0.10.0
+Requires-Dist: twine>=4.0.0
+Requires-Dist: sphinx>=7.0.0
+Requires-Dist: sphinx-rtd-theme>=1.3.0
+Requires-Dist: types-requests>=2.31.0
+Requires-Dist: typing-extensions>=4.8.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Luna Library
+
+**A Complete Cryptocurrency Wallet and Mining System**  
+*Developed by Ling Lin • [LingLin.Art](https://linglin.art) • LingLin.Art, LLC*
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)
+[![Version](https://img.shields.io/badge/version-1.0.0-green.svg)]()
+
+## 🌟 Overview
+
+Luna Library is a comprehensive cryptocurrency system featuring secure wallet management, GTX Genesis digital bill mining, and blockchain transaction processing. Built with security and performance in mind, it provides the foundation for cryptocurrency applications including wallets, casinos, nodes, and treasury systems.
+
+## 🚀 Features
+
+### 💰 Wallet Management
+- **Secure Key Generation**: Cryptographically secure private/public key pairs
+- **Encrypted Storage**: AES-256 encrypted wallet files with password protection
+- **Multi-Wallet Support**: Manage multiple wallets with individual labels
+- **Import/Export**: Backup and restore wallets using private keys
+- **Transaction History**: Complete transaction tracking and balance management
+
+### ⛏️ GTX Genesis Mining
+- **Digital Bill Mining**: Mine GTX Genesis bills with denomination-based difficulty
+- **Proof-of-Work**: Configurable difficulty (2-10 leading zeros) based on bill value
+- **CUDA Acceleration**: GPU-accelerated mining for improved performance
+- **Bill Registry**: Track mined bills with verification URLs and metadata
+- **1:1 Luna Value**: Each GTX bill denomination equals equivalent Luna value
+
+### 🔗 Blockchain Integration
+- **Network Connectivity**: Connect to Luna blockchain nodes
+- **Transaction Broadcasting**: Send signed transactions to the network
+- **Blockchain Scanning**: Efficient blockchain scanning for address activity
+- **Mempool Monitoring**: Real-time transaction pool monitoring
+- **Caching System**: Optimized caching for improved performance
+
+### 🔒 Security & Validation
+- **Cryptographic Signing**: Secure transaction signing with ECDSA
+- **Transaction Validation**: Comprehensive security validation for all transaction types
+- **Anti-Spam Protection**: Rate limiting and blacklisting capabilities
+- **Risk Assessment**: Transaction risk level evaluation
+- **Network Security**: Protection against malicious activities
+
+## 📦 Installation
+
+### Prerequisites
+- Python 3.7 or higher
+- pip (Python package manager)
+
+### Install from Source
+
+1. **Clone the repository**:
+```bash
+git clone https://github.com/linglin-art/luna_lib.git
+cd luna_lib
+```
+2. **Install Requirements**
+```bash
+pip install -r requirements.txt
+```
+3. **Install with Pip**
+```bash
+pip install -e .
+```
+Optional: **CUDA Support**
+```bash
+Optional: CUDA Support
+
+For GPU-accelerated mining, install CUDA dependencies:
+```
+
+
+## Basic Usage:
+
+```python
+from luna_lib import LunaWallet, GenesisMiner, GTXGenesis
+
+# Create a new wallet
+wallet = LunaWallet()
+wallet_data = wallet.create_wallet("My Wallet", "secure_password")
+
+print(f"Wallet created: {wallet_data['address']}")
+
+# Initialize miner
+miner = GenesisMiner()
+
+# Mine a GTX $1000 bill
+bill = miner.mine_bill(1000, wallet_data['address'])
+
+if bill['success']:
+    print(f"✅ Mined GTX ${bill['denomination']:,} bill!")
+    print(f"💰 Luna value: {bill['luna_value']:,}")
+    print(f"🔗 Verification: {bill.get('verification_url', 'N/A')}")
+```
+    
+## Advanced Usage
+```python
+from luna_lib import GTXGenesis, BlockchainManager
+from luna_lib.gtx.bill_registry import BillRegistry
+
+# Check GTX portfolio
+gtx = GTXGenesis()
+portfolio = gtx.get_user_portfolio(wallet_data['address'])
+
+print(f"Total GTX bills: {portfolio['total_bills']}")
+print(f"Total Luna value: {portfolio['total_luna_value']:,}")
+
+# Scan blockchain for transactions
+blockchain = BlockchainManager()
+transactions = blockchain.scan_transactions_for_address(wallet_data['address'])
+
+print(f"Found {len(transactions)} transactions")
+
+```
+## Project Structure
+
+```
+luna_lib/
+├── core/              # Core wallet and blockchain functionality
+│   ├── wallet.py      # Wallet management
+│   ├── blockchain.py  # Blockchain interactions
+│   └── crypto.py      # Cryptographic operations
+├── mining/            # Mining-related components
+│   ├── miner.py       # Genesis bill miner
+│   ├── difficulty.py  # Difficulty calculations
+│   └── cuda_manager.py # GPU acceleration
+├── gtx/               # GTX Genesis system
+│   ├── genesis.py     # Main GTX manager
+│   ├── digital_bill.py # Digital bill representation
+│   └── bill_registry.py # Bill database
+├── transactions/      # Transaction processing
+│   ├── transaction.py # Transaction creation
+│   ├── security.py    # Security validation
+│   └── validator.py   # Transaction validation
+└── storage/           # Data storage
+    ├── database.py    # Wallet database
+    ├── cache.py       # Blockchain cache
+    └── encryption.py  # Encryption utilities
+
+```
+
+# **API Reference**
+Core Classes
+
+    LunaWallet: Main wallet management class
+
+    GenesisMiner: GTX Genesis bill mining
+
+    GTXGenesis: GTX bill management and verification
+
+    BlockchainManager: Blockchain interactions
+
+    TransactionManager: Transaction creation and signing
+
+## ***Key Methods***
+### **Wallet Management**
+```python
+wallet.create_wallet(label, password)  # Create new wallet
+wallet.unlock_wallet(address, password)  # Unlock existing wallet
+wallet.export_private_key(address, password)  # Export private key
+```
+
+## ***Mining***
+```python
+miner.mine_bill(denomination, address)  # Mine single bill
+miner.start_auto_mining(denominations, address)  # Auto-mine multiple bills
+miner.stop_mining()  # Stop mining operations
+```
+
+## **GTX Management**
+
+```python
+gtx.verify_bill(bill_serial)  # Verify bill authenticity
+gtx.get_user_portfolio(address)  # Get user's GTX portfolio
+gtx.transfer_bill(bill_serial, from_addr, to_addr, priv_key)  # Transfer bill
+```
+# Configuration
+## **Environment Variables**
+
+```bash
+export LUNA_ENDPOINT_URL="https://bank.linglin.art"  # Blockchain endpoint
+export LUNA_DATA_DIR="$HOME/.luna_wallet"  # Data directory
+```
+
+## **Bill Denominations**
+
+Supported GTX Genesis bill denominations:
+```bash
+  $1 (Difficulty: 2 zeros)
+  $10 (Difficulty: 3 zeros)
+  $100 (Difficulty: 4 zeros)
+  $1,000 (Difficulty: 5 zeros)
+  $10,000 (Difficulty: 6 zeros)
+  $100,000 (Difficulty: 7 zeros)
+  $1,000,000 (Difficulty: 8 zeros)
+  $10,000,000 (Difficulty: 9 zeros)
+  $100,000,000 (Difficulty: 10 zeros)
+```
+
+### **Contributing**
+
+We welcome contributions! Please see our Contributing Guidelines for details.
+
+   - Fork the repository
+
+   - Create a feature branch (git checkout -b feature/amazing-feature)
+
+   - Commit your changes (git commit -m 'Add amazing feature')
+
+   - Push to the branch (git push origin feature/amazing-feature)
+
+   - Open a Pull Request
+
+## License
+  This project is licensed under the MIT License - see the LICENSE file for details.
+
+### Support
+
+    Email: taellinglin@gmail.com
+    Website: LingLin.Art
+
+    Built with ❤️ by Ling Lin and the LingLin.Art, LLC team
+
+Luna Library • Empowering the future of digital currency • LingLin.Art

lunalib-1.1.0/README.md

@@ -0,0 +1,224 @@
+# Luna Library
+
+**A Complete Cryptocurrency Wallet and Mining System**  
+*Developed by Ling Lin • [LingLin.Art](https://linglin.art) • LingLin.Art, LLC*
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)
+[![Version](https://img.shields.io/badge/version-1.0.0-green.svg)]()
+
+## 🌟 Overview
+
+Luna Library is a comprehensive cryptocurrency system featuring secure wallet management, GTX Genesis digital bill mining, and blockchain transaction processing. Built with security and performance in mind, it provides the foundation for cryptocurrency applications including wallets, casinos, nodes, and treasury systems.
+
+## 🚀 Features
+
+### 💰 Wallet Management
+- **Secure Key Generation**: Cryptographically secure private/public key pairs
+- **Encrypted Storage**: AES-256 encrypted wallet files with password protection
+- **Multi-Wallet Support**: Manage multiple wallets with individual labels
+- **Import/Export**: Backup and restore wallets using private keys
+- **Transaction History**: Complete transaction tracking and balance management
+
+### ⛏️ GTX Genesis Mining
+- **Digital Bill Mining**: Mine GTX Genesis bills with denomination-based difficulty
+- **Proof-of-Work**: Configurable difficulty (2-10 leading zeros) based on bill value
+- **CUDA Acceleration**: GPU-accelerated mining for improved performance
+- **Bill Registry**: Track mined bills with verification URLs and metadata
+- **1:1 Luna Value**: Each GTX bill denomination equals equivalent Luna value
+
+### 🔗 Blockchain Integration
+- **Network Connectivity**: Connect to Luna blockchain nodes
+- **Transaction Broadcasting**: Send signed transactions to the network
+- **Blockchain Scanning**: Efficient blockchain scanning for address activity
+- **Mempool Monitoring**: Real-time transaction pool monitoring
+- **Caching System**: Optimized caching for improved performance
+
+### 🔒 Security & Validation
+- **Cryptographic Signing**: Secure transaction signing with ECDSA
+- **Transaction Validation**: Comprehensive security validation for all transaction types
+- **Anti-Spam Protection**: Rate limiting and blacklisting capabilities
+- **Risk Assessment**: Transaction risk level evaluation
+- **Network Security**: Protection against malicious activities
+
+## 📦 Installation
+
+### Prerequisites
+- Python 3.7 or higher
+- pip (Python package manager)
+
+### Install from Source
+
+1. **Clone the repository**:
+```bash
+git clone https://github.com/linglin-art/luna_lib.git
+cd luna_lib
+```
+2. **Install Requirements**
+```bash
+pip install -r requirements.txt
+```
+3. **Install with Pip**
+```bash
+pip install -e .
+```
+Optional: **CUDA Support**
+```bash
+Optional: CUDA Support
+
+For GPU-accelerated mining, install CUDA dependencies:
+```
+
+
+## Basic Usage:
+
+```python
+from luna_lib import LunaWallet, GenesisMiner, GTXGenesis
+
+# Create a new wallet
+wallet = LunaWallet()
+wallet_data = wallet.create_wallet("My Wallet", "secure_password")
+
+print(f"Wallet created: {wallet_data['address']}")
+
+# Initialize miner
+miner = GenesisMiner()
+
+# Mine a GTX $1000 bill
+bill = miner.mine_bill(1000, wallet_data['address'])
+
+if bill['success']:
+    print(f"✅ Mined GTX ${bill['denomination']:,} bill!")
+    print(f"💰 Luna value: {bill['luna_value']:,}")
+    print(f"🔗 Verification: {bill.get('verification_url', 'N/A')}")
+```
+    
+## Advanced Usage
+```python
+from luna_lib import GTXGenesis, BlockchainManager
+from luna_lib.gtx.bill_registry import BillRegistry
+
+# Check GTX portfolio
+gtx = GTXGenesis()
+portfolio = gtx.get_user_portfolio(wallet_data['address'])
+
+print(f"Total GTX bills: {portfolio['total_bills']}")
+print(f"Total Luna value: {portfolio['total_luna_value']:,}")
+
+# Scan blockchain for transactions
+blockchain = BlockchainManager()
+transactions = blockchain.scan_transactions_for_address(wallet_data['address'])
+
+print(f"Found {len(transactions)} transactions")
+
+```
+## Project Structure
+
+```
+luna_lib/
+├── core/              # Core wallet and blockchain functionality
+│   ├── wallet.py      # Wallet management
+│   ├── blockchain.py  # Blockchain interactions
+│   └── crypto.py      # Cryptographic operations
+├── mining/            # Mining-related components
+│   ├── miner.py       # Genesis bill miner
+│   ├── difficulty.py  # Difficulty calculations
+│   └── cuda_manager.py # GPU acceleration
+├── gtx/               # GTX Genesis system
+│   ├── genesis.py     # Main GTX manager
+│   ├── digital_bill.py # Digital bill representation
+│   └── bill_registry.py # Bill database
+├── transactions/      # Transaction processing
+│   ├── transaction.py # Transaction creation
+│   ├── security.py    # Security validation
+│   └── validator.py   # Transaction validation
+└── storage/           # Data storage
+    ├── database.py    # Wallet database
+    ├── cache.py       # Blockchain cache
+    └── encryption.py  # Encryption utilities
+
+```
+
+# **API Reference**
+Core Classes
+
+    LunaWallet: Main wallet management class
+
+    GenesisMiner: GTX Genesis bill mining
+
+    GTXGenesis: GTX bill management and verification
+
+    BlockchainManager: Blockchain interactions
+
+    TransactionManager: Transaction creation and signing
+
+## ***Key Methods***
+### **Wallet Management**
+```python
+wallet.create_wallet(label, password)  # Create new wallet
+wallet.unlock_wallet(address, password)  # Unlock existing wallet
+wallet.export_private_key(address, password)  # Export private key
+```
+
+## ***Mining***
+```python
+miner.mine_bill(denomination, address)  # Mine single bill
+miner.start_auto_mining(denominations, address)  # Auto-mine multiple bills
+miner.stop_mining()  # Stop mining operations
+```
+
+## **GTX Management**
+
+```python
+gtx.verify_bill(bill_serial)  # Verify bill authenticity
+gtx.get_user_portfolio(address)  # Get user's GTX portfolio
+gtx.transfer_bill(bill_serial, from_addr, to_addr, priv_key)  # Transfer bill
+```
+# Configuration
+## **Environment Variables**
+
+```bash
+export LUNA_ENDPOINT_URL="https://bank.linglin.art"  # Blockchain endpoint
+export LUNA_DATA_DIR="$HOME/.luna_wallet"  # Data directory
+```
+
+## **Bill Denominations**
+
+Supported GTX Genesis bill denominations:
+```bash
+  $1 (Difficulty: 2 zeros)
+  $10 (Difficulty: 3 zeros)
+  $100 (Difficulty: 4 zeros)
+  $1,000 (Difficulty: 5 zeros)
+  $10,000 (Difficulty: 6 zeros)
+  $100,000 (Difficulty: 7 zeros)
+  $1,000,000 (Difficulty: 8 zeros)
+  $10,000,000 (Difficulty: 9 zeros)
+  $100,000,000 (Difficulty: 10 zeros)
+```
+
+### **Contributing**
+
+We welcome contributions! Please see our Contributing Guidelines for details.
+
+   - Fork the repository
+
+   - Create a feature branch (git checkout -b feature/amazing-feature)
+
+   - Commit your changes (git commit -m 'Add amazing feature')
+
+   - Push to the branch (git push origin feature/amazing-feature)
+
+   - Open a Pull Request
+
+## License
+  This project is licensed under the MIT License - see the LICENSE file for details.
+
+### Support
+
+    Email: taellinglin@gmail.com
+    Website: LingLin.Art
+
+    Built with ❤️ by Ling Lin and the LingLin.Art, LLC team
+
+Luna Library • Empowering the future of digital currency • LingLin.Art

lunalib-1.1.0/lunalib/__init__.py

@@ -0,0 +1,19 @@
+"""
+Luna Library - Complete cryptocurrency wallet and mining system
+"""
+import os
+
+from .core.wallet import LunaWallet
+from .mining.miner import GenesisMiner
+from .gtx.genesis import GTXGenesis
+from .transactions.transactions import TransactionManager
+from .core.blockchain import BlockchainManager
+
+__version__ = "1.0.0"
+__all__ = [
+    'LunaWallet', 
+    'GenesisMiner', 
+    'GTXGenesis', 
+    'TransactionManager',
+    'BlockchainManager'
+]

lunalib-1.1.0/lunalib/cli.py

@@ -0,0 +1,18 @@
+# lunalib/cli.py
+import argparse
+from .luna_lib import LunaLib
+
+def main():
+    """Command line interface for LunaLib"""
+    parser = argparse.ArgumentParser(description="LunaLib Cryptocurrency Wallet")
+    parser.add_argument('--version', action='store_true', help='Show version')
+    
+    args = parser.parse_args()
+    
+    if args.version:
+        print(f"LunaLib v{LunaLib.get_version()}")
+    else:
+        print("LunaLib - Use 'luna-wallet --help' for options")
+
+if __name__ == "__main__":
+    main()