Skip to content

pow-chain

A small, self-contained Rust demo of a proof-of-work blockchain. It mines a genesis block and two example transfer blocks, prints each hash and link, and validates the completed chain.

Educational only: this project is not production cryptography, a secure payment system, or a real currency. Its transactions are only checked for a nonblank sender/recipient and a positive amount. It has no signatures, balances, networking, persistence, consensus, or protection against an attacker controlling the chain.

Run

Rust 1.98.1 is pinned in mise.toml; crate versions are pinned exactly in Cargo.toml, and Cargo.lock is used by every Cargo task.

mise install
mise run install
mise run run
mise run run -- --difficulty 4
mise run check

Difficulty is the required number of leading zero hexadecimal digits in a block's SHA-256 hash (from 0 to 64). Higher values make mining exponentially slower; use small values for a quick demo. The default is 3.

What it demonstrates

  • Each block hashes its index, previous block hash, nonce, and ordered transactions using a stable, length-delimited encoding.
  • Mining increments the nonce until the hash meets the configured difficulty.
  • Validation checks transaction structure, sequential indices, predecessor links, recomputed hashes, and proof-of-work for every block.
  • Unit tests cover deterministic hashing/mining, transaction rejection, and tampering detection.

Amounts are illustrative integers, not currency units. A valid chain here only means its local structure and proof-of-work checks pass; it does not imply that transactions are authorized or economically valid.