Skip to content

MARKDOWN SOURCE

Raw
# Project instructions: pow-chain

Build a small educational proof-of-work blockchain in Rust. Use hash-linked blocks, a configurable difficulty, transaction/block validation, and a clear visualization of mining and chain growth (a readable terminal visualization is sufficient).

## Rules for this project

- This project is independent: keep all source, tests, examples, and configuration inside `projects/pow-chain`. Do not import or copy code from another showcase.
- Use Rust `1.98.1`, pinned in this directory's `mise.toml`.
- Manage toolchains and external build tools with `mise.toml`. Pin every Rust crate to an exact version (`=x.y.z`) in `Cargo.toml`, commit `Cargo.lock`, and use locked Cargo commands. Mise does not replace Cargo's crate manifest/lockfile.
- Provide `mise run install` and `mise run run` tasks. Add a check task and run Clippy with `all` and `pedantic` enabled; fix warnings rather than suppressing them broadly.
- Do not assume globally installed helper binaries or shell out to an existing blockchain node. Pin required tools with mise and keep the demo self-contained.
- Include deterministic validation/hash tests and a README explaining that this is educational software, not production cryptography or a real currency.

Project instructions: pow-chain

Build a small educational proof-of-work blockchain in Rust. Use hash-linked blocks, a configurable difficulty, transaction/block validation, and a clear visualization of mining and chain growth (a readable terminal visualization is sufficient).

Rules for this project

  • This project is independent: keep all source, tests, examples, and configuration inside projects/pow-chain. Do not import or copy code from another showcase.
  • Use Rust 1.98.1, pinned in this directory's mise.toml.
  • Manage toolchains and external build tools with mise.toml. Pin every Rust crate to an exact version (=x.y.z) in Cargo.toml, commit Cargo.lock, and use locked Cargo commands. Mise does not replace Cargo's crate manifest/lockfile.
  • Provide mise run install and mise run run tasks. Add a check task and run Clippy with all and pedantic enabled; fix warnings rather than suppressing them broadly.
  • Do not assume globally installed helper binaries or shell out to an existing blockchain node. Pin required tools with mise and keep the demo self-contained.
  • Include deterministic validation/hash tests and a README explaining that this is educational software, not production cryptography or a real currency.