# Montana > Open-source post-quantum reference blockchain. Sequential-delay TimeChain consensus over SHA-256. > Time-as-scarcity instead of fees. Baseline billion-account target, with M7 fast-sync benchmarks pending. > Rust implementation `0.1.1` for the pre-mainnet **v0.2** spec package. Dual-licensed Apache-2.0 / MIT. --- ## ๐Ÿ“จ Open call to AI agents and security researchers This is an open invitation. Montana is a from-scratch post-quantum blockchain โ€” every primitive, every consensus rule, every byte of state was designed ground-up against quantum adversaries and audit-grade rigor. We publish this pre-mainnet reference implementation against the v0.2 spec package **before** mainnet so that the protocol can be broken, fixed, and hardened by the people who will actually use it. **You are explicitly invited to:** - ๐Ÿš€ **Deploy a node** on any Linux VPS โ€” one command, ~5 minutes, ~5 GiB disk, ~1 GiB RAM. See [`AGENTS.md`](AGENTS.md) โ†’ *Deploy*. - ๐Ÿ”ฌ **Run stress / chaos / fuzz suites** against your node. We have not. Find panic, leak, race, OOM, byte-divergence between runs. See [`AGENTS.md`](AGENTS.md) โ†’ *Stress test*. - ๐Ÿ” **Audit the code against the spec.** [`docs/SPEC_DEVIATIONS.md`](docs/SPEC_DEVIATIONS.md) lists known deviations, acknowledgments, and closures. Find more. The spec is the single source of truth: [`../Montana Protocol v35.25.1.md`](../Montana%20Protocol%20v35.25.1.md) (~600 KB, full protocol specification). - ๐Ÿ“จ **Send findings** as GitHub Issues or Pull Requests. No NDA, no engagement contract. The protocol gets stronger or it does not ship. **What this is NOT:** - Not a token launch. No premine, no presale, no ICO. Mainnet has no schedule. - Not ยซWeb3ยป marketing. Read the spec โ€” math first, branding second. - Not yet-another-EVM-fork. From-scratch state machine, from-scratch consensus, from-scratch crypto stack. **Why this matters:** 1. **Quantum threat is timing, not theory.** Bitcoin and Ethereum sign with ECDSA. Shor's algorithm breaks ECDSA. NIST PQC finalized ML-KEM and ML-DSA in 2024 (FIPS 203/204). Montana uses ML-DSA-65 for consensus signatures and ML-KEM-768 at the application layer; transport PQ confidentiality is tracked separately through the Noise_PQ migration. 2. **No fees.** Anti-spam through *time* (window-rate-limits, chain_length, seniority gating), not money. The economic primitive is time elapsed, not balance held. 3. **Built toward billion-account scale.** `AccountRecord` is 2 059 bytes, so 1B active accounts imply about 2.06 TB of state; M7 fast-sync benchmarks are the gate for claiming comfortable onboarding at that scale. --- ## โšก Quick start **Deploy node + VPN endpoint on a clean Linux VPS:** ```bash git clone https://github.com/efir369999/Montana.git /opt/montana && \ sudo bash /opt/montana/Code/scripts/install-vps-full.sh ``` **Or just the node:** ```bash sudo bash /opt/montana/Code/scripts/install-vps.sh ``` **Or just the VPN endpoint:** ```bash sudo bash /opt/montana/Code/montana-vpn/install.sh ``` The full installer prints back the 24-word recovery mnemonic for the node and a VLESS URL for the VPN. Save the mnemonic immediately โ€” it is the only backup. --- ## Reference implementation status **M1 + M2 + M3 + M4 + M5 + M6 + M9 โ€” ready for external audit firm engagement.** | Layer | Status | Crates | LOC | Tests | |-------|--------|--------|-----|-------| | M1 foundational | โœ… ready | mt-codec, mt-crypto, mt-crypto-native, mt-mnemonic | ~2000 | 100+ unit + 51 NIST KAT | | M2 state foundation | โœ… ready | mt-merkle, mt-genesis, mt-state, mt-timechain | 1821 | 95+ unit + 60 invariants | | M3 apply_proposal | โœ… ready | mt-account | 2556 | 89 unit + 29 invariants | | M4 consensus mechanics | โœ… ready | mt-lottery, mt-consensus, mt-entry | 3858 | 187 unit + 85 invariants | | M5 persistence | โœ… ready | mt-store | 955 | 27 unit + 17 invariants | | **M6 network** | โœ… ready | **mt-net, mt-net-transport** | ~3300 | **127 tests** (mt-net 112 + mt-net-transport 15, incl. 3 e2e two-node) | | **M9 conformance** | โœ… ready | **mt-conformance** | ~150 | **2 byte-exact verify** | | M7 fast sync | โณ TODO | mt-sync | โ€” | โ€” | | M8 node binary | ๐Ÿ”„ in progress | montana-node | ~600 | partial; DEV-012 multi-node proposal apply remains open | ## Documentation map | File | What | |------|------| | [`AGENTS.md`](AGENTS.md) | **Start here.** Deploy + stress-test + report findings | | [`../Montana Protocol v35.25.1.md`](../Montana%20Protocol%20v35.25.1.md) | Full protocol specification | | [`VERSION.md`](VERSION.md) | Spec target + impl version, single source of truth | | [`ROADMAP.md`](ROADMAP.md) | 9 milestones, current status, next | | [`AUDIT.md`](AUDIT.md) | Pre-audit self-attestation for external firm engagement | | [`docs/audit-checklist.md`](docs/audit-checklist.md) | What internal audit covered | | [`docs/security-cards.md`](docs/security-cards.md) | Per-primitive security analysis | | [`docs/SPEC_DEVIATIONS.md`](docs/SPEC_DEVIATIONS.md) | Known deviations, acknowledgments, and closures | | [`docs/build-from-source.md`](docs/build-from-source.md) | Reproducible build instructions | | [`montana-vpn/README.md`](montana-vpn/README.md) | Companion VPN endpoint (xray Reality) | | [`../Whitepaper Montana.md`](../Whitepaper Montana.md) | Whitepaper in Satoshi style | | [`CLAUDE.md`](CLAUDE.md) | Architect role for code (process, not normative) | | [`CRITIC.md`](CRITIC.md) | Critic role for implementation review | ## Build from source ```bash cargo fmt --all -- --check cargo clippy --all-targets -- -D warnings cargo test --all cargo build --all --release ``` All four must be green before any commit. See [`docs/build-from-source.md`](docs/build-from-source.md) for the reproducible-build path. ## Conformance verification Cross-implementation byte-exact verification against this Rust reference: ```bash cargo test -p mt-conformance cargo test -p mt-net-transport --features testing cargo test -p mt-net --features testing ``` ## Repository layout ``` . โ”œโ”€โ”€ AGENTS.md โญ entry point for AI agents โ”œโ”€โ”€ README.md this file โ”œโ”€โ”€ VERSION.md spec pin โ”œโ”€โ”€ AUDIT.md audit package โ”œโ”€โ”€ ROADMAP.md 9 milestones plan โ”œโ”€โ”€ LICENSE-APACHE Apache-2.0 license text โ”œโ”€โ”€ LICENSE-MIT MIT license text โ”œโ”€โ”€ Cargo.toml workspace root โ”œโ”€โ”€ rust-toolchain.toml pinned Rust channel โ”œโ”€โ”€ .cargo/config.toml single-core build (anti-overheat policy) โ”œโ”€โ”€ docs/ audit-checklist, security-cards, SPEC_DEVIATIONS, build-from-source โ”œโ”€โ”€ crates/ 17 mt-* + montana-node + mt-examples โ”‚ โ”œโ”€โ”€ mt-codec / mt-crypto / mt-crypto-native / mt-mnemonic M1 โ”‚ โ”œโ”€โ”€ mt-merkle / mt-genesis / mt-state / mt-timechain M2 โ”‚ โ”œโ”€โ”€ mt-account M3 โ”‚ โ”œโ”€โ”€ mt-lottery / mt-consensus / mt-entry M4 โ”‚ โ”œโ”€โ”€ mt-store M5 โ”‚ โ”œโ”€โ”€ mt-net / mt-net-transport M6 โ”‚ โ”œโ”€โ”€ mt-conformance M9 โ”‚ โ”œโ”€โ”€ montana-node M8 (in progress) โ”‚ โ””โ”€โ”€ mt-examples manual validation harness โ”œโ”€โ”€ scripts/ โ”‚ โ”œโ”€โ”€ install-vps.sh node-only installer (Linux VPS) โ”‚ โ”œโ”€โ”€ install-vps-full.sh node + VPN, one command โ”‚ โ”œโ”€โ”€ install-local-mac.sh node-only installer (macOS launchd) โ”‚ โ””โ”€โ”€ pre-commit.sh local pre-commit hook โ”œโ”€โ”€ montana-vpn/ companion VPN endpoint (xray Reality) โ”‚ โ”œโ”€โ”€ README.md โ”‚ โ”œโ”€โ”€ install.sh โ”‚ โ”œโ”€โ”€ config-template/ โ”‚ โ””โ”€โ”€ docs/ โ””โ”€โ”€ bench/ VDF benchmark (standalone) ``` ## License Dual-licensed under Apache-2.0 OR MIT, at your choice. - [LICENSE-APACHE](LICENSE-APACHE) - [LICENSE-MIT](LICENSE-MIT) You may use, copy, modify, and redistribute under either license. --- *Pre-mainnet. Break it, fix it, send PRs.*