montana/Монтана-Протокол/Код

Montana

Open-source post-quantum reference blockchain. VDF-based TimeChain consensus. Time-as-scarcity instead of fees. Architected for 1B+ active users. Pre-mainnet v0.1. Rust, 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 v0.1 as a reference implementation 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 → Deploy.
• 🔬 Run stress / chaos / fuzz suites against your node. We have not. Find panic, leak, race, OOM, byte-divergence between runs. See AGENTS.md → Stress test.
• 🔍 Audit the code against the spec. docs/SPEC_DEVIATIONS.md lists 9 known deviations (M5-singleton phase). Find more. The spec is the single source of truth: Протокол/Montana v35.23.0.md (~600 KB, full whitepaper).
• 📨 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 has finalized post-quantum primitives in 2024 (FIPS 203/204/205). Montana uses ML-DSA-65 + ML-KEM-768 + SHA-256 from day one.
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 for 1B+ users. Every architectural decision is validated against a target of one billion active accounts. Mechanisms that do not scale are rejected without negotiation.

---

📨 Открытое обращение к ИИ-агентам и исследователям

Это публичное приглашение. Montana — пост-квантовый блокчейн, спроектированный с нуля: каждый примитив, каждое правило консенсуса, каждый байт состояния — против квантовых противников и аудиторских критериев. Мы публикуем v0.1 как референс-реализацию до запуска mainnet чтобы протокол мог быть сломан, починен и закалён теми кто будет им пользоваться.

Вы приглашены:

• 🚀 Развернуть узел на любом Linux VPS — одна команда, ~5 минут, ~5 GiB диска, ~1 GiB ОЗУ. См. AGENTS.md → Deploy.
• 🔬 Прогнать stress / chaos / fuzz сюиты против своего узла. Мы — не прогнали. Ищите panic, утечки, race-conditions, OOM, расхождения байт между запусками. См. AGENTS.md → Stress test.
• 🔍 Аудитить код против спеки. docs/SPEC_DEVIATIONS.md перечисляет 9 известных отклонений (фаза M5-singleton). Ищите больше. Спека — single source of truth: Протокол/Montana v35.23.0.md (~600 KB, полный whitepaper).
• 📨 Шлите findings как GitHub Issues или Pull Requests. Никаких NDA, никаких engagement contracts. Протокол либо становится сильнее, либо не запускается.

Что это НЕ:

• Не token-launch. Никакого премайна, presale, ICO. У mainnet нет даты.
• Не «Web3»-маркетинг. Читайте спеку — математика первична, бренд вторичен.
• Не yet-another-EVM-fork. Своя state machine, свой консенсус, свой крипто-стек, всё с нуля.

Зачем это нужно:

1. Квантовая угроза — вопрос времени, не теории. Bitcoin и Ethereum подписывают через ECDSA. Алгоритм Шора ломает ECDSA. NIST PQC финализировал пост-квантовые примитивы в 2024 (FIPS 203/204/205). Montana использует ML-DSA-65 + ML-KEM-768 + SHA-256 с первого дня.
2. Без комиссий. Анти-спам через время (окно-лимиты, chain_length, seniority-gating), не через деньги. Экономический примитив — прошедшее время, а не удержанный баланс.
3. Под 1B+ пользователей. Каждое архитектурное решение валидируется против цели в один миллиард активных аккаунтов. Механизмы которые не масштабируются — отклоняются без обсуждения.

---

⚡ Quick start

Deploy node + VPN endpoint on a clean Linux VPS:

git clone https://github.com/efir369999/Montana.git /opt/montana && \
sudo bash /opt/montana/Протокол/Код/scripts/install-vps-full.sh

Or just the node:

sudo bash /opt/montana/Протокол/Код/scripts/install-vps.sh

Or just the VPN endpoint:

sudo bash /opt/montana/Протокол/Код/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	110 + 14 (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 (9 documented SPEC_DEVIATIONS)

Documentation map

File	What
AGENTS.md	Start here. Deploy + stress-test + report findings
Протокол/Montana v35.23.0.md	Full protocol specification (whitepaper)
VERSION.md	Spec target + impl version, single source of truth
ROADMAP.md	9 milestones, current status, next
AUDIT.md	Pre-audit self-attestation for external firm engagement
docs/audit-checklist.md	What internal audit covered
docs/security-cards.md	Per-primitive security analysis
docs/SPEC_DEVIATIONS.md	Known deviations from spec (9 documented)
docs/build-from-source.md	Reproducible build instructions
montana-vpn/README.md	Companion VPN endpoint (xray Reality)
[../Whitepaper Montana.md](../Whitepaper Montana.md)	Whitepaper in Сатоши style
CLAUDE.md	Architect role for code (process, not normative)
CRITIC.md	Critic role for implementation review

Build from source

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 for the reproducible-build path.

Conformance verification

Cross-implementation byte-exact verification against this Rust reference:

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-MIT

You may use, copy, modify, and redistribute under either license.

---

Pre-mainnet. Break it, fix it, send PRs.