How btcsuite/btcd works
btcd is a Go Bitcoin full node, not a wallet. Its main workflow accepts peer connections, synchronizes blocks and transactions, validates blocks into chain state, persists that state, and relays transactions and newly mined blocks. Mining, indexing, and JSON-RPC are important companion capabilities. The graph emphasizes relationships visible in the supplied excerpts, SOURCE INDEX references, and README; some runtime wiring is unsampled, so uncertain links are omitted or marked unverified.
Main entry points: server.go Node server · chain.go Block validation · mining.go Block templates · mempool.go Transaction pool
Components 20
Peer networking
- Node server
server.go - Peer connections
peer/peer.go - Peer management
addrmgr/addrmanager.go - Chain synchronization
netsync/manager.go - Bitcoin messages
wire/message.go
Chain and storage
- Block validation
blockchain/chain.go - Consensus checks
blockchain/validate.go - Block database
database/ffldb/db.go - Chain indexes
blockchain/indexers/manager.go
Transactions and mining
- Transaction pool
mempool/mempool.go - Block templates
mining/mining.go - CPU mining
mining/cpuminer/cpuminer.go - Script execution
txscript/engine.go
Node interfaces
- JSON-RPC server
rpcserver.go - RPC command types
btcjson/chainsvrcmds.go - RPC command-line client
cmd/btcctl/httpclient.go - RPC client library
rpcclient/wallet.go
Other components
- Node operator
- Miner
- RPC user
Connections 24
- Node operator → Node server: starts
- Node server → Peer connections: configures
server.go - Node server → Peer management: configures
server.go - Node server → Chain synchronization: configures
server.go - Node server → Block database: configures
server.go - Node server → Transaction pool: configures
server.go - Node server → Block templates: configures
server.go - Peer connections → Bitcoin messages: exchanges
- Chain synchronization → Block validation: processes blocks
netsync/manager.go - Chain synchronization → Transaction pool: checks inventory
- Block validation → Block database: reads and writes
blockchain/chain.go - Block validation → Consensus checks: validates
- Block validation → Chain indexes: updates
- Chain indexes → Block database: reads and writes
blockchain/indexers/manager.go - Transaction pool → Block validation: checks inputs
mempool/mempool.go - Transaction pool → Block templates: supplies transactions
mempool/mempool.go - Block templates → Block validation: queries chain
mining/mining.go - CPU mining → Block templates: requests templates
mining/cpuminer/cpuminer.go - Miner → CPU mining: runs
- Block templates → Script execution: validates scripts
- RPC user → RPC command-line client: issues commands
cmd/btcctl/httpclient.go - RPC command-line client → JSON-RPC server: sends HTTP requests
- JSON-RPC server → RPC command types: dispatches commands
- RPC client library → RPC command types: builds commands
rpcclient/wallet.go