https://github.com/coderanchel/vortyxblockchain
VortyxBlockchain is a Java-based blockchain implementation designed to explore the core concepts of blockchain technology, such as cryptographic signatures, Proof of Work, Merkle Trees, and chain validation. This project serves as a hands-on guide for learning blockchain development and provides a foundation for scaling into a decentralized network
https://github.com/coderanchel/vortyxblockchain
Last synced: about 1 year ago
JSON representation
VortyxBlockchain is a Java-based blockchain implementation designed to explore the core concepts of blockchain technology, such as cryptographic signatures, Proof of Work, Merkle Trees, and chain validation. This project serves as a hands-on guide for learning blockchain development and provides a foundation for scaling into a decentralized network
- Host: GitHub
- URL: https://github.com/coderanchel/vortyxblockchain
- Owner: CoderAnchel
- Created: 2025-03-24T11:34:11.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-12T16:55:25.000Z (about 1 year ago)
- Last Synced: 2025-04-14T13:17:24.165Z (about 1 year ago)
- Language: Java
- Homepage:
- Size: 2.24 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# VortyxBlockchain
Welcome to **VortyxBlockchain**, a Java-based blockchain implementation designed as a learning project to understand the core concepts of blockchain technology. This repository provides a hands-on approach to creating a simple yet functional blockchain, complete with features like transaction signing, Proof of Work (PoW), Merkle Trees, and more.
---
## 🚀 Introduction
Blockchain technology has revolutionized industries by offering decentralized, immutable, and transparent systems. This project aims to demystify blockchain by building one from scratch using **Java** and **Go**. Whether you're a seasoned Java developer or someone looking for a challenging coding project, this repository is for you.
By the end of this project, you’ll have:
- A local blockchain capable of signing transactions, mining blocks, and validating chains.
- A foundation for scaling to a fully decentralized network.
Read the full article on Medium for an in-depth explanation of the project:
👉 [Creating a Blockchain with Java and Go Part 1: The Java Node](https://medium.com/@coderanchel/creating-a-blockchain-with-java-and-go-part-1-the-java-node-c10f5f51b60e)
## 🛠️ Features
### 🔐 Cryptographic Signatures
- Secure transactions using asymmetric cryptography.
- Transactions are signed with private keys and verified with public keys.
- Utilizes **ECDSA** via **Bouncy Castle** in Java for cryptographic operations.
### 🔨 Proof of Work (PoW)
- Prevents tampering by requiring miners to solve a computational puzzle.
- Blocks are mined by finding a valid nonce that produces a hash with a specific number of leading zeroes.
### 🌲 Merkle Tree
- Efficiently validates transactions in a block.
- Uses recursive hashing to generate a Merkle Root.
### 🕒 Mempool
- Holds unconfirmed transactions until they are included in a block.
- Ensures double-spending prevention and transaction validation.
### ⛓️ Chain Validation
- Validates block hashes, PoW, and transaction integrity.
- Ensures blocks are linked correctly to maintain chain consistency.
---
## 🏗️ Architecture Overview
### Core Entities
- **Wallet**: Holds public and private keys.
- **Transaction**: Represents value transfers between wallets.
- **Block**: Contains transactions and links to the previous block.
- **BlockchainStorage**: Manages data persistence using **LevelDB**.
### Network Design
- Decentralized network with nodes connected via gateways.
- Nodes mine blocks, validate transactions, and broadcast updates.
- Uses **Spring WebFlux** in Java and **Gorilla Mux** in Go for concurrency and routing.
---
## 📂 Project Structure
- `Context`: Manages wallets, transactions, blocks, and overall blockchain state.
- `BlockchainStorage`: Handles data persistence with LevelDB and RLP encoding.
- `Spring Controllers`: Expose blockchain functionality via HTTP.
---
## 🧬 Technical Details
### RLP Encoding
- Reduces data size and improves parsing efficiency.
- Inspired by Ethereum’s serialization method.
### Key-Value Storage
- Stores data as key-value pairs for fast querying and validation.
### Cryptography
- Built with battle-tested libraries:
- **Java Security Module**
- **Bouncy Castle**
- **Guava**
### Tests
- Comprehensive testing for:
- Signature validation
- Hash consistency
- Merkle root generation
- Block linkage
---
## 🌐 Networking
To scale the local blockchain into a real network:
1. Install Spring Boot dependencies.
2. Create controllers for wallets and transactions.
3. Implement HTTP endpoints to expose blockchain functionality.
---
## 💡 Lessons Learned
- Use **RLP encoding** for efficient data handling.
- Model data in **key-value format** for faster operations.
- Leverage proven cryptographic libraries for security.
- Write tests for validation logic to ensure robustness.
- Plan for networking early to enable scalability.
---
## 📜 Roadmap
1. **Local Node** (Completed)
- Wallet creation
- Transaction signing
- Block mining
- HTTP API
2. **Networking Layer**
- Concurrency and consistency
- Broadcasting and syncing nodes
- Fork resolution
3. **Scalability**
- Support for 100+ active nodes
- Optimized mempool and validation logic
---
## 📜 License
This project is open-source and available under the [MIT License](LICENSE).
---
Happy coding! 🚀