⛏️ Lattice — Quantum-Resistant Blockchain

CPU-Friendly Mining · Post-Quantum Cryptography · Fair Launch

Quick Start • Mining • Tokenomics • Documentation

---

🌟 What is Lattice?

Lattice is a quantum-resistant blockchain built for the future. While other cryptocurrencies will become vulnerable when quantum computers arrive, Lattice is secured by CRYSTALS-Dilithium3 signatures — the same algorithm chosen by NIST for post-quantum security.

Key Features

Feature	Description
🔐 Quantum-Resistant	CRYSTALS-Dilithium3 signatures, Kyber768 key exchange
⛏️ CPU-Friendly Mining	Argon2 memory-hard PoW — no ASICs, no GPUs needed
🚀 Fast Blocks	2-15 second block times depending on network
💰 Fair Launch	95% of supply goes to miners, only 5% genesis allocation
🔓 Open Source	MIT/Apache-2.0 dual license

---

🪙 Tokenomics

Parameter	Value
Symbol	LAT
Total Supply	50,000,000 LAT
Decimals	8 (1 LAT = 100,000,000 Latt)
Block Reward	10 LAT
Genesis Allocation	5% (2.5M LAT with vesting)
Mining Allocation	95% (47.5M LAT)

Block Times & Difficulty

Network	Block Time	Initial Difficulty	PoW Memory
Devnet	~2 seconds	1	512 KB
Testnet	~5 seconds	5	4 MB
Mainnet	~15 seconds	10	64 MB

💡 Lower difficulty = faster block finding. Use devnet for development!

Genesis Allocation

The 5% founder allocation ensures sustainable development:

• 500,000 LAT — Immediately available (exchange listings, infrastructure)
• 2,000,000 LAT — 24-month linear vesting (long-term commitment)

👉 See TOKENOMICS.md for full details.

---

🚀 Quick Start

Install (60 seconds)

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/dill-lk/Lattice/main/install.sh | bash

Windows (PowerShell):

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm https://raw.githubusercontent.com/dill-lk/Lattice/main/install.ps1 | iex

This installs the official unified executable:

Binary	Purpose
lattice	All-in-one node, miner, wallet, query, and contract CLI

Legacy binaries such as lattice-node, lattice-miner, and lattice-cli are compatibility paths only. The primary UX is lattice ....

Create Wallet

lattice wallet create
# Output: Address: 1FDG9t5ar77bddgn6bQRfXeBUmTZ69xrdq

Start Mining

# Terminal 1 — Start node
lattice node --network devnet

# Terminal 2 — Start miner
lattice miner --coinbase <your-address> --network devnet

Or use the smoother local UX:

# create default wallet once
lattice --wallet-new

# start integrated local mining
lattice --mine 4

If lattice miner ... points at the default local RPC endpoint and no node is running, Lattice can fall back to integrated local miner-node mode for a smoother first-run experience.

That's it! You're now mining LAT. 🎉

---

⛏️ Mining

Network Selection

Choose your network based on your needs:

# Development (instant blocks, ~2 sec)
lattice node --network devnet
lattice miner --coinbase <addr> --network devnet

# Testing (moderate speed, ~5 sec)
lattice node --network testnet
lattice miner --coinbase <addr> --network testnet

# Production (full security, ~15 sec)
lattice node --network mainnet
lattice miner --coinbase <addr> --network mainnet

Thread Recommendations

CPU Cores	Recommended Threads
2	2
4	3-4
8	6-8
16+	12-16

lattice miner --coinbase <addr> --threads 8 --network devnet

Mining Display

The miner shows real-time stats:

╔═══════════════════════════════════════════════════════════╗
║                 ⛏  LATTICE MINER  v0.1.0                  ║
╠═══════════════════════════════════════════════════════════╣
║  Network : DEVNET                                         ║
║  Threads : 8                                              ║
║  Coinbase: 1FDG9t5ar77bddgn6bQRfXeBUmTZ69xrdq             ║
║  Node RPC: http://127.0.0.1:8545                          ║
╚═══════════════════════════════════════════════════════════╝

 ⛏  #42  │  125.3 H/s  (avg 118.7 H/s)  │  1,247 hashes  │  3 found  │  up 2m

---

💵 Wallet Commands

# Create new wallet
lattice wallet create

# Show your address
lattice wallet address

# Validate an address
lattice wallet validate <address>

# Check balance
lattice wallet balance <address-or-wallet.json>

# Check current nonce
lattice wallet nonce <address-or-wallet.json>

# Send LAT
lattice tx send --to <address> --amount 10.5

# Export private key (⚠️ keep safe!)
lattice wallet export

---

🖥️ System Requirements

Tier	CPU	RAM	Disk	Expected Hash Rate
Minimum	2 cores	4 GB	20 GB	~10 H/s
Recommended	4+ cores	8 GB	50 GB SSD	~50 H/s
Optimal	8+ cores	16 GB	100 GB SSD	~150+ H/s

💡 Lattice uses Argon2 memory-hard PoW. More RAM = better performance.

---

🔐 Security

Backup Your Wallet

# Your wallet is at ~/.lattice/wallet.json (or ./wallet.json)
cp wallet.json ~/backup/wallet-$(date +%Y%m%d).json

⚠️ WARNING: If you lose your wallet file and password, your LAT is gone forever.

Post-Quantum Cryptography

Lattice uses algorithms selected by NIST for post-quantum security:

Component	Algorithm	Security Level
Signatures	CRYSTALS-Dilithium3	NIST Level 3
Key Exchange	Kyber768	NIST Level 3
Hashing	SHA3-256	256-bit
PoW	Argon2id	Memory-hard

---

🆘 Troubleshooting

Problem	Solution
Node won't start	Check port 30303 isn't in use
Miner shows 0.00 H/s	Use --network devnet for faster hashes
RPC connection error	Make sure lattice node is running
Invalid coinbase address	Use address from lattice wallet address
Low hashrate	Increase --threads, close background apps
Old chain data	Delete data directory and restart (see below)

Reset Chain Data

If you need to start fresh (e.g., after updating difficulty settings):

Windows:

Remove-Item -Recurse $env:LOCALAPPDATA\Lattice

Linux/macOS:

rm -rf ~/.local/share/lattice

Node Commands

# Check node status
lattice status

# View peers
lattice peers

# Chain summary
lattice chain

# Mempool summary
lattice mempool

# Run local diagnostics
lattice doctor

# Generate completions
lattice completion bash

# Create a starter config interactively
lattice config init --path node.toml

# Script-friendly JSON output
lattice --json status

# Open firewall (Linux)
sudo ufw allow 30303/tcp

---

📚 Documentation

Document	Description
TOKENOMICS.md	Token supply, genesis allocation, vesting
MINING_GUIDE.md	In-depth mining optimization
ADMIN.md	Full operator guide, systemd setup
DEPLOYMENT.md	Docker & production deployment
CONTRIBUTING.md	Build from source, contribute
docs/api-reference.md	JSON-RPC API reference
docs/protocol-baseline.md	Canonical roots, validation, tokenomics, and wallet safety baseline
docs/rollback-strategy.md	Rollback / reorg strategy baseline
docs/vm-scope.md	Honest scope statement for current WASM runtime integration

---

🛠️ Build from Source

# Requirements: Rust 1.75+, C++ compiler (for RocksDB)

git clone https://github.com/dill-lk/Lattice.git
cd Lattice

# Build
cargo build --release

# Test
cargo test --workspace

# Install the official unified CLI locally
cargo install --path bins/lattice

---

🏗️ Architecture

┌─────────────────┐
│     lattice     │ ← Unified CLI / node / miner entrypoint
└────────┬────────┘
         │
    ┌────┴────┬─────────────┐
    │         │             │
    ▼         ▼             ▼
┌───────┐ ┌───────┐ ┌───────────┐
│Network│ │  RPC  │ │ Consensus │
└───┬───┘ └───┬───┘ └─────┬─────┘
    │         │           │
    └────┬────┴───────────┘
         │
    ┌────┴────┐
    │ Storage │ ← RocksDB
    └────┬────┘
         │
    ┌────┴────┐
    │  Core   │ ← Blocks, Transactions, State
    └────┬────┘
         │
    ┌────┴────┐
    │ Crypto  │ ← Dilithium, Kyber, SHA3
    └─────────┘

---

💬 Community

• GitHub Issues: Report bugs & request features
• Releases: Download latest
• Source Code: github.com/dill-lk/Lattice

---

📄 License

Dual-licensed under MIT or Apache-2.0 at your option.

---

Built with ❤️ for the post-quantum future

⭐ Star this repo if you find it useful!