A blockchain focused on native UTXO Compute execution and PoW security.
- Native UTXO Compute canonical path
- ed25519 native account and signing flow
- PoW consensus and P2P networking
- JSON-RPC + WebSocket service surface
- CLI for node, wallet, account, transaction, and block operations
# Clone
git clone https://github.com/zerochain/zero-chain.git
cd zero-chain
# Build
cargo build --release
# Run tests
cargo test# Initialize data directory (once per network profile)
./target/release/zerochain --network local init
./target/release/zerochain --network testnet init
./target/release/zerochain --network devnet init
./target/release/zerochain --network mainnet init
# Run local profile
./target/release/zerochain --network local run
# Run testnet profile
./target/release/zerochain --network testnet run
# Run devnet profile
./target/release/zerochain --network devnet run
# Run mainnet profile
./target/release/zerochain --network mainnet run# Create native wallet account
zerochain wallet new --name native-1 --scheme ed25519 --passphrase "StrongPassphrase123!"
# List wallet accounts
zerochain wallet list
# Account alias command (delegates to wallet)
zerochain account new --name native-2 --scheme ed25519 --passphrase "StrongPassphrase123!"
zerochain account list
# Sign message
zerochain wallet sign --name native-1 --message "hello" --passphrase "StrongPassphrase123!"
# Unlock then sign without passphrase
zerochain wallet unlock --name native-1 --passphrase "StrongPassphrase123!" --ttl-secs 600
zerochain wallet sign --name native-1 --message "hello"
# Submit native compute transaction from JSON file
zerochain transaction send --tx-file ./tx.json --account-name native-1 --passphrase "StrongPassphrase123!"
# Query native compute transaction result
zerochain transaction get --tx-id 0x...# Default RPC ports:
# - local/mainnet: 8545
# - testnet: 18545
# - devnet: 28545
curl -X POST http://localhost:8545 \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"zero_getAccount","params":["ZER0x..."],"id":1}'# Redline guard (禁止 silent fallback)
bash scripts/no_silent_fallback.sh
# 指定目录检查（可重复 -d）
bash scripts/no_silent_fallback.sh -d ../zero-chain -d ../zero-explore
# Format
cargo fmt
# Lint
cargo clippy -- -D warnings
# Tests
cargo test- 设计理念：
docs/DESIGN_PHILOSOPHY.md - 规范文档：
docs/ENGINEERING_REDLINES.md - CI 阻断：
.github/workflows/redline-guard.yml - 发布门禁包含 redline 检查：
scripts/run_tests.sh
# Public local + remote + observer + explorer checklist
./scripts/mainnet_checklist.shKey checks include:
- local/remote/observer RPC reachability, peerCount, block heights,
zero_syncStatus - local/remote block-gap threshold
- explorer
/health,/api/overview,/api/txs/recent, account balance + account tx endpoints - public soak monitor health and RPC/SSH error counters
MIT OR Apache-2.0