Skip to content

[Feature] MiniChain v0 - Educational Blockchain Prototype #15

@anuragShingare30

Description

@anuragShingare30

Summary

Implement MiniChain v0: a minimal educational blockchain prototype that demonstrates MiniChain's core philosophy of minimality, education, and research.

Proposed Implementation

Core Features:

  • Transactions - Ed25519 digital signatures (PyNaCl)
  • State Management - Account-based ledger (balances + nonces)
  • Block Structure - SHA-256 hashing, linked blocks
  • Blockchain - Chain validation, longest-chain rule
  • Consensus - Proof-of-Work mining with rewards
  • Mempool - Pending transaction pool
  • P2P Network - TCP socket-based peer communication
  • CLI Interface - Interactive node management interface

Educational Focus:

  • Clean, readable Python code
  • Minimal dependencies (PyNaCl only)
  • Well-documented architecture

File Structure:

Minichain_v0/
├── config.py         - Configuration
├── transaction.py    - Ed25519 transactions
├── state.py          - Account state
├── block.py          - Block structure
├── blockchain.py     - Chain validation
├── mempool.py        - Transaction pool
├── consensus.py      - Proof-of-Work
├── network.py        - P2P networking
├── main.py           - CLI interface
└── minichain         - Launcher script

Progression Path

v0 (Educational) → v1 (Optimized) → v2 (Smart Contracts)

Acceptance Criteria

  • Minimal dependencies
  • Multi-node P2P functionality
  • Mining with rewards
  • Interactive CLI
  • Documentation and README

This establishes MiniChain as the educational "MiniSat of blockchains" - minimal, clean, perfect for learning.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions