A modern, Python-based blockchain implementation focusing on simplicity, security, and scalability. RavenChain demonstrates core blockchain concepts while providing a foundation for building decentralized applications.
- ✅ Core blockchain implementation with proof-of-work mining
- ✅ Secure wallet management with ECDSA cryptography
- ✅ Transaction system with digital signatures
- ✅ Bitcoin-style address generation
- ✅ Interactive command-line interface
- ✅ Persistent wallet storage
- ✅ Chain validation and integrity checking
- ✅ Mining rewards system
- ✅ FastAPI-based REST API
- ✅ Database persistence with PostgreSQL
- ✅ Docker containerization
- 🔄 Peer-to-peer networking
- 📊 Block explorer web interface
- 📜 Smart contract support
- 🔍 UTXO model implementation
- 🔒 Enhanced security features
- ⚡ Performance optimizations
- Language: Python 3.13+
- Cryptography:
ecdsa,hashlib - Storage: PostgreSQL for blockchain persistence
- Backend: FastAPI for REST API endpoints
- Frontend: React 19 with TypeScript (planned)
- Future Stack:
- WebSocket for real-time updates
- Redis for caching
- Elasticsearch for block/transaction search (optional)
ravenchain/
├── ravenchain/ # Core package
│ ├── __init__.py
│ ├── block.py # Block implementation
│ ├── blockchain.py # Main blockchain logic
│ ├── transaction.py # Transaction handling
│ └── wallet.py # Wallet management
├── api/ # FastAPI backend
│ ├── __init__.py
│ ├── main.py # API entry point
│ ├── routes/ # API route handlers
│ │ ├── block_routes.py
│ │ ├── mining_routes.py
│ │ ├── transaction_routes.py
│ │ └── wallet_routes.py
│ └── database/ # Database models and config
│ └── models.py
├── config/ # Configuration
│ ├── settings.py # App settings
│ └── logging.py # Logging setup
├── scripts/ # Utility scripts
├── tests/ # Test suite
├── Dockerfile # Docker build file
├── docker-compose.yml # Docker services config
└── requirements.txt # Python dependencies
- Python 3.13 or higher
- pip (Python package installer)
OR
- Docker
- Docker Compose
# Clone the repository
git clone https://github.com/yourusername/ravenchain.git
cd ravenchain
# Create and activate virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -e .# Clone the repository
git clone https://github.com/yourusername/ravenchain.git
cd ravenchain
# Build and start the containers
docker-compose up --build
# Or run in detached mode
docker-compose up -dThe Docker setup provides:
- Isolated development environment
- Consistent dependencies across platforms
- Easy setup for future features (API, database)
- Production-ready container configuration
# Run tests in a new container
docker-compose run --rm ravenchain pytest
# Run tests with coverage
docker-compose run --rm ravenchain pytest --cov=ravenchain- Basic blockchain implementation
- Wallet management system
- Command-line interface
- Transaction handling
- Unit test coverage
- Documentation improvements
- Implement PostgreSQL for blockchain storage
- Design and implement FastAPI REST API
- Block endpoints
- Transaction endpoints
- Wallet endpoints
- Mining endpoints
- API documentation with Swagger/OpenAPI
- Request rate limiting
- API authentication system
- P2P network implementation
- Node discovery protocol
- Block synchronization
- Transaction broadcasting
- Consensus mechanism improvements
- Network state management
- Peer management system
- Basic smart contract engine
- Contract deployment system
- Standard contract templates
- Contract execution environment
- Gas fee implementation
- UTXO model implementation
- Merkle tree optimization
- Chain pruning
- Advanced security features
- Double-spend protection
- Sybil attack prevention
- DDoS mitigation
- Performance benchmarking
- Block explorer web interface
- Wallet GUI application
- Network monitoring tools
- Development tools and SDKs
pytest tests/The REST API will provide the following endpoints:
# Authentication Endpoints
POST /api/v1/auth/register # Register a new user
POST /api/v1/auth/login # Login and get tokens
POST /api/v1/auth/refresh # Refresh access token
GET /api/v1/auth/me # Get current user info
PUT /api/v1/auth/me # Update current user info
# Admin Endpoints
GET /api/v1/admin/users # List all users (admin only)
GET /api/v1/admin/users/{id} # Get user details (admin only)
PUT /api/v1/admin/users/{id} # Update user (admin only)
DELETE /api/v1/admin/users/{id} # Delete user (admin only)
# Block Endpoints
GET /api/v1/blocks # List blocks
GET /api/v1/blocks/{hash} # Get block details
GET /api/v1/blocks/latest # Get latest block
# Transaction Endpoints
GET /api/v1/transactions # List transactions
POST /api/v1/transactions # Create transaction
# Wallet Endpoints
GET /api/v1/wallets/{address} # Get wallet info
# Mining Endpoints
POST /api/v1/mine # Mine new block
Detailed API documentation is available via Swagger UI at /docs.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Built with Python's cryptographic libraries
- Inspired by blockchain technology principles
- Community contributions and feedback
Ray Thurman - @raythurman2386
Project Link: https://github.com/raythurman2386/ravenchain