Skip to content
This repository was archived by the owner on May 21, 2026. It is now read-only.

0riginal-claw/zgc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 

Repository files navigation

ZGC — A Blockchain You Run With curl

Tamper-proof state log for AI agents. 180 lines of Python. No GPU. No SSD. No VC. Run a validator in 30 seconds.

License: MIT Python 3.8+ Validators Discord


What is ZGC?

ZGC (Zach Gladstone Chain Coin) is a purpose-built, lightweight proof-of-stake chain that anchors AI agent state to a tamper-proof ledger. When an autonomous agent makes a decision — a trade, a transfer, a policy change — that decision is recorded in a block. The chain is the "why" behind every machine action.

Problem it solves: AI agents have no trust-minimized state layer. Centralized databases are single points of failure. General-purpose blockchains (Bitcoin, Ethereum, Solana) are too expensive and slow for agent-scale logging.

Solution: A blockchain so light, every laptop is a full node. So friendly, you join with one curl command. So purpose-built, the entire core is 180 lines of Python.


One-Command Join

curl -sL https://zgc.run | bash

That's it. No wallet setup. No gas. No KYC. No browser extension. You are now a validator.


Why Run a Node?

Action Reward Cap
Install node (first 100) 50 ZGC 100 nodes
Keep alive 7 days +100 ZGC unlimited
Keep alive 30 days +500 ZGC unlimited
Refer a node 10% of their earnings forever unlimited
Propose a valid block 1 ZGC 288/day
Star this repo 10 ZGC first 500
Write a guide 100 ZGC first 50
Report a bug 25 ZGC first 100

First 100 validators get a 5x earnings bonus. Bonuses end the moment the 100th node comes online.


Specs at a Glance

ZGC Bitcoin Ethereum Solana
Core lines of code 180 100,000+ 800,000+ 1,200,000+
Block time 5 sec 10 min 12 sec 0.4 sec
Hardware needed Any laptop ASIC 32 ETH + SSD GPU + SSD
Token sale None None Yes Yes
VC backed No No Partially Yes
Premine 10M (founder) None 72M 500M
Purpose AI agent state Money DeFi DeFi
Energy per block <0.001 kWh 1,000 kWh 0.03 kWh 0.001 kWh

How It Works

  1. You install a node with curl -sL zgc.run | bash
  2. You're auto-registered as a validator (HMAC keypair generated at ~/.zgc/keys/)
  3. Every 5 seconds, the network elects a block proposer round-robin among active validators
  4. Your node proposes when its turn comes — earn 1 ZGC
  5. Block is gossiped to peers via simple HTTP
  6. Chain is Merkle-anchored in chain.jsonl — any node can re-verify the full history

No mining. No staking lockup. No slashing (we're friendly-PoS). Just run software.


Token Details

  • Symbol: ZGC
  • Decimals: 0 (integer-only; simplifies state machine)
  • Pre-mine: 10,000,000 ZGC to founder at genesis
  • Issuance: +1 ZGC per accepted block (288/day across the network)
  • Total supply: Unbounded, linear emission
  • Validator earnings: Round-robin proposer reward

Links


Quickstart (Manual)

# Clone
git clone https://github.com/0riginal-claw/zgc && cd zgc

# Generate address + register
python3 scripts/zg_chain_node.py register_validator --stake 1.0

# Run a node
python3 scripts/zg_chain_node.py serve \
    --port 9933 \
    --node-id $(hostname) \
    --peers https://seed1.zgc.run:9933,https://seed2.zgc.run:9933

Architecture (TL;DR)

┌─────────────────────────────────────────────────────┐
│  Your AI agent (any language)                       │
│        │ POST /tx                                   │
│        ▼                                            │
│  zg_chain_node.py (180 LOC)                         │
│    ├─ HMAC sig verify                               │
│    ├─ Mempool                                       │
│    ├─ Round-robin proposer                          │
│    ├─ Merkle anchor → chain.jsonl                   │
│    └─ HTTP gossip ↔ peers                           │
└─────────────────────────────────────────────────────┘

The chain stores anchors, not full agent state. Agents write a content-hash of their state; the chain proves when and who.


FAQ

Is this a real cryptocurrency? It's a real chain with real validators. Whether ZGC has market value depends on what people do with it. We make no price promises — we make a working chain.

Is there a token sale / ICO / IDO? No. None. Never. The only way to get ZGC is to run a node or earn it through bounties.

Why not just use IPFS / Arweave / Filecoin? Those store files. ZGC stores ordered, signed events — the "what happened and when" layer.

Can I lose money? You can't lose money on something you never paid for. The downside is the electricity to keep a laptop on.

What's the catch? Honest answer: This is a hobbyist chain optimized for builders, not speculators. If you want a moon-pump, look elsewhere. If you want to run interesting infrastructure, you're home.


Roadmap

  • Phase 0 — Genesis block + founder pre-mine
  • Phase 1 — 180-LOC core node, HMAC signatures, gossip
  • Phase 2 — 100-validator milestone (you are here)
  • Phase 3 — Block explorer + leaderboard public
  • Phase 4 — Ed25519 upgrade (PyNaCl) for adversarial deployment
  • Phase 5 — Cross-chain bridge (ETH receipts → ZGC anchors)
  • Phase 6 — Light-client mobile validator (run from a phone)

License

MIT. Fork it, study it, run it. It's 180 lines — you'll read the whole thing in 10 minutes.


Built by humans + agents in the open. Anchored to the chain since genesis.

About

ZGC - Lightweight Python PoS chain anchoring AI agent state. No GPU, no token sale. Run a validator in 30 seconds.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages