How josecantero/soverx works
Soverx is a C++ proof-of-work blockchain node with a CLI wallet, P2P networking, and JSON-RPC. The main workflow starts in the CLI: initialize the chain, create and sign a transaction or mine pending transactions, validate and update the UTXO-backed chain, then persist state and broadcast blocks. Peers synchronize chains and use witness checks for suspicious blocks; RPC clients can query balances or submit transactions. The graph preserves documented security, API, and storage capabilities; several subsystem links rely on README descriptions because their implementation excerpts were not shown.
Main entry points: blockchain.cpp Blockchain · main.cpp CLI runtime · Node.cpp P2P node · RpcServer.cpp JSON-RPC server
Components 22
Node entry
- CLI runtime
src/main.cpp
Ledger and consensus
- Blockchain
src/blockchain.cpp - Block validation
src/block.cpp - UTXO transactions
src/transaction.cpp - Merkle tree
src/merkle_tree.cpp - LevelDB storage
src/storage/storage_manager.cpp
P2P network
- P2P node
src/networking/Node.cpp - Peer connections
src/networking/Peer.cpp - Wire protocol
src/networking/Message.h
Wallet and API
- Wallet
src/wallet.cpp - JSON-RPC server
src/api/RpcServer.cpp - API keys
src/api/ApiKeyManager.cpp - Rate limiting
src/api/RateLimiter.cpp
Crypto and persistence
- ECDSA and SHA-256
src/crypto.cpp - RandomX PoW
src/randomx_util.cpp - Base58 addresses
src/base58.cpp - Binary serialization
src/persistence_util.cpp - Configuration
src/config.cpp
Other components
- Node operator
- RPC client
- Network peers
- LevelDB
Connections 28
- Node operator → CLI runtime: runs
src/main.cpp - CLI runtime → Blockchain: initializes
src/main.cpp - CLI runtime → Wallet: creates or loads
src/main.cpp - Wallet → UTXO transactions: creates and signs
README.md - CLI runtime → Blockchain: submits transaction
src/main.cpp - Blockchain → UTXO transactions: validates UTXOs
README.md - Blockchain → Block validation: mines and validates
README.md - Block validation → Merkle tree: builds root
README.md - Block validation → RandomX PoW: hashes proof
src/block.cpp - UTXO transactions → ECDSA and SHA-256: checks signatures
src/transaction.cpp - Wallet → ECDSA and SHA-256: derives keys
README.md - ECDSA and SHA-256 → Base58 addresses: encodes addresses
src/crypto.cpp - Blockchain → LevelDB storage: persists chain state
README.md - LevelDB storage → LevelDB: reads and writes
README.md - LevelDB storage → Binary serialization: serializes records
src/storage/storage_manager.cpp - CLI runtime → P2P node: starts node
src/main.cpp - CLI runtime → JSON-RPC server: starts RPC
src/main.cpp - RPC client → JSON-RPC server: sends requests
README.md - JSON-RPC server → Blockchain: queries and submits
src/api/RpcServer.cpp - JSON-RPC server → API keys: authenticates keys
src/api/RpcServer.cpp - JSON-RPC server → Rate limiting: limits requests
- P2P node → Blockchain: syncs and submits blocks
README.md - P2P node → Peer connections: handles connections
src/networking/Node.cpp - Peer connections → Wire protocol: exchanges messages
src/networking/Peer.cpp - P2P node → Network peers: discovers and broadcasts
README.md - P2P node → Blockchain: requests witnesses
README.md - Configuration → CLI runtime: configures runtime
src/main.cpp - CLI runtime → Blockchain: migrates legacy data
src/main.cpp