Minimum energy. Maximum stability.
Quantum-resistant BlockDAG Layer 1 inspired by the Bohr–Rutherford atomic model. SHA-256d Proof-of-Work, ML-DSA-65 signatures (NIST FIPS 204), GhostDAG consensus, libp2p networking, RocksDB storage.
Status: mainnet bootstrap (v0.4.1+). Block time 10 s, 21,000,000 GRND max supply.
| Layer | Technology |
|---|---|
| Consensus | PHANTOM / GhostDAG (k=10) |
| Proof-of-Work | SHA-256d |
| Signatures | ML-DSA-65 (NIST FIPS 204, post-quantum) |
| Transport encryption | Kyber768 hybrid + AES-256-GCM (NIST FIPS 203) |
| Networking | libp2p gossipsub + IBD sync |
| Storage | RocksDB |
| Wallet keystore | AES-256-GCM + Argon2id (256 MiB, 4 iterations) |
| Address format | grnd1q + 20-byte SHA3-256 hash + 4-byte checksum |
| Parameter | Value |
|---|---|
| Max supply | 21,000,000 GRND |
| Founder allocation | 1,050,000 GRND (5%, genesis coinbase) |
| Miner rewards | ~19,550,000 GRND (93.1%) |
| Community Development Fund | ~400,000 GRND (2% of every block reward) |
| Initial block reward | 5 GRND (4.9 miner + 0.1 fund) |
| Block time | 10 seconds |
| Halving | every 2,100,000 blocks (~243 days) |
| Difficulty retarget | every 2,016 blocks (~5.6 hours) |
| Coinbase maturity | 100 blocks |
| Finality depth | 1,000 blocks |
| Dust threshold | 546 satoshis |
2% of every block reward is automatically routed to a community-controlled wallet that funds protocol development, security bounties, and ecosystem integrations. The fund accumulates on-chain with no voting mechanism — disbursement is manual, transparent, and published on-chain as regular transactions.
Current custody: founder-held single-signature wallet during network bootstrap. Planned transition (v0.6.0+): 2-of-3 multisig with independent community members.
Fund address: grnd1q633ef5f51f2434437a6daada1e984372cca0be7c2c0de299
See BOUNTIES.md for categories and payout policy
(coming soon — v0.5.0).
cargo build --releaseProduces three binaries in target/release/:
groundstate— full node (RPC + P2P + optional mining)grnd-wallet— keystore and signing CLIgrnd-cli— convenience RPC client
# Single node (connects to default seeds)
./target/release/groundstate
# Connect to specific peer
./target/release/groundstate --peer /ip4/1.2.3.4/tcp/16110/p2p/<peer-id>
# Mine to a specific address
./target/release/groundstate --mine --miner-address grnd1q...Default ports: 16110/tcp (P2P), 16111/tcp (WebSocket), 16210/tcp (RPC).
./target/release/grnd-wallet new --output wallet.json
./target/release/grnd-wallet address wallet.json
./target/release/grnd-wallet balance grnd1q...Wallets are encrypted at rest with AES-256-GCM and Argon2id password stretching. ML-DSA-65 keypairs are ~6 KB total (1,952-byte public, 4,032-byte private).
curl http://localhost:16210 -X POST \
-H "Content-Type: application/json" \
-d '{"method":"getnetworkinfo","id":1}'Full RPC method list at docs.groundstate.network.
- ML-DSA-65 signatures (NIST FIPS 204) — post-quantum secure
- Kyber768 hybrid handshake for P2P transport (NIST FIPS 203)
- AES-256-GCM + Argon2id (256 MiB, 4 iterations) wallet encryption
- Full block validation: PoW, Merkle, signatures, UTXO
- Difficulty and height validation against consensus state
- Coinbase maturity enforcement (100 blocks)
- Timestamp bounds checking (max 2 hours in future, not before parent)
- Intra-block double-spend prevention
- Dust output rejection (546 sat minimum)
- Finality checkpoint (1,000 block depth, no deep reorgs)
- Persistent P2P identity and peer memory
GroundState follows the Bitcoin model: improvement proposals are discussed publicly, implemented by contributors, reviewed by maintainers, and activated off-chain through voluntary upgrades by node operators. There is no on-chain governance, token voting, or automatic protocol upgrade mechanism.
- Improvement proposals:
gips/directory (process defined inGIP-0001) - Discussion: GitHub Issues and Discussions
- Releases: semantic versioning; mainnet-compatible changes flagged
- Explorer: scan.groundstate.network
- Docs: docs.groundstate.network
- Site: groundstate.network
MIT
