一个使用 Go 语言从零实现的完整区块链系统,包含工作量证明(PoW)、UTXO 模型、数字签名、Merkle 树、简易多节点网络实现等核心功能。
- Go 版本: 1.24.9
- 操作系统: Ubuntu
- 数据库: BoltDB
github.com/boltdb/bolt- 持久化存储区块链数据golang.org/x/crypto- 加密算法支持(RIPEMD160、ECDSA)github.com/stretchr/testify- 单元测试框架
# 克隆项目
git clone https://github.com/ReisenCW/go-simple-blockchain.git
cd go-simple-blockchain
# 下载依赖
go mod download
# 编译生成可执行文件
make
# 或手动编译
go build -o go-blockchain main.gogo-simple-blockchain/
├── blockchain/ # 区块链核心模块
│ ├── block.go # 区块结构定义
│ ├── blockchain.go # 区块链管理
│ ├── blockchain_iterator.go # 区块链迭代器
│ ├── proof_of_work.go # 工作量证明(PoW)
│ ├── transaction.go # 交易结构与验证
│ ├── transaction_input.go # 交易输入
│ ├── transaction_ouput.go # 交易输出
│ ├── txo_set.go # UTXO 集合管理
│ ├── merkle_tree.go # Merkle 树实现
│ ├── wallet.go # 钱包(密钥对管理)
│ ├── wallets.go # 钱包集合管理
│ ├── base58.go # Base58 编解码
│ ├── server.go # P2P 网络节点
│ └── util.go # 工具函数
├── cli/ # 命令行接口
│ ├── cli.go # CLI 主框架
│ └── cli_functions.go # CLI 命令实现
├── main.go # 程序入口
├── go.mod # Go 模块定义
├── Makefile # 编译脚本
└── README.md # 项目文档
-
核心字段:
TimeStamp: 区块创建时间戳Transactions: 区块包含的交易列表PrevHash: 前一个区块的哈希值(父哈希)Hash: 当前区块的哈希值Nonce: 工作量证明的随机数
-
功能:
- 使用 Merkle 树计算交易摘要
- 通过 PoW 计算有效区块哈希
- 序列化/反序列化支持持久化
- 数据结构: 基于 BoltDB 的持久化链式存储
- 核心功能:
- 创建创世块(Genesis Block)
- 添加新区块到链
- 区块迭代与遍历
- UTXO 集合管理(快速余额查询)
- 交易签名与验证
- 算法: SHA-256 哈希计算
- 难度: 目标值为 16 位前导零(可调节
targetBits) - 流程:
- 拼接区块数据(PrevHash + 交易哈希 + TimeStamp + Nonce)
- 计算 SHA-256 哈希
- 验证哈希是否小于目标值
- 若不满足则递增 Nonce 重新计算
- 设计理念: 类似比特币的交易输出模型
- 核心机制:
- 每笔交易包含输入(TXInput)和输出(TXOutput)
- 输入引用之前交易的未花费输出
- 输出锁定到特定地址的公钥哈希
- UTXO 集合缓存提升查询性能
- 签名算法: ECDSA(椭圆曲线数字签名)
- 曲线参数: P-256(secp256r1)
- 流程:
- 发送方使用私钥对交易签名
- 接收方使用发送方公钥验证签名
- 防止交易篡改和双重支付
-
密钥生成: ECDSA 生成公私钥对
-
地址生成流程:
- 对公钥进行 SHA-256 哈希
- 对结果进行 RIPEMD-160 哈希
- 添加版本前缀
- 计算校验和(双重 SHA-256 取前 4 字节)
- Base58 编码生成最终地址
-
持久化: 使用 x509 DER 格式序列化私钥,避免 gob 序列化椭圆曲线内部结构
- 用途: 高效验证区块中的交易完整性
- 结构: 二叉树,叶子节点为交易哈希,父节点为子节点哈希的组合哈希
- 优势:
- 仅需 O(log n) 时间验证单笔交易
- 支持简化支付验证(SPV)
-
节点类型:
- 中心节点(Central Node): 初始区块链的引导节点
- 钱包节点(Wallet Node): 创建和发送交易
- 矿工节点(Miner Node): 挖矿打包交易
-
通信协议:
version: 节点版本握手inv: 通知可用区块/交易清单getdata: 请求具体区块/交易数据block: 传输区块数据tx: 传输交易数据
| 命令 | 参数 | 功能说明 |
|---|---|---|
createwallet |
- | 生成新的钱包地址(ECDSA 密钥对) |
listaddresses |
- | 列出所有本地钱包地址 |
createblockchain |
-address ADDRESS |
创建新区块链并生成创世块,奖励发送至指定地址 |
getbalance |
-address ADDRESS |
查询指定地址的余额 |
send |
-from FROM -to TO -amount AMOUNT [-mine] |
发送交易,-mine 参数表示立即挖矿确认 |
printchain |
- | 打印区块链中的所有区块信息 |
reindexutxo |
- | 重建 UTXO 集合索引 |
startnode |
[-miner ADDRESS] |
启动 P2P 节点,-miner 参数指定挖矿奖励地址 |
./go-blockchain createwallet
# 输出: Your new address: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa./go-blockchain createblockchain -address 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa
# 输出: Done!./go-blockchain getbalance -address 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa
# 输出: Balance of '1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa': 10./go-blockchain send -from 1A1zP1eP... -to 1BvBMSEY... -amount 3 -mine
# 输出: Success!# 终端 1 - 启动中心节点
export NODE_ID=3000
./go-blockchain startnode
# 终端 2 - 启动矿工节点
export NODE_ID=3001
./go-blockchain startnode -miner 1MinerAddress...验证区块链多节点间的交易发送、区块同步、挖矿奖励及余额计算功能,模拟中心节点、钱包节点、矿工节点的协同工作流程。
-
环境要求:
- 操作系统:Linux(本项目的开发环境以及以下命令示例基于此,Windows需将
export替换为set) - Go环境:已配置Go编译环境
- 终端:至少3个(分别对应3个节点)
- 操作系统:Linux(本项目的开发环境以及以下命令示例基于此,Windows需将
-
程序编译:
在项目根目录执行make命令或手动编译,生成可执行文件:# 编译生成可执行文件 make # 或手动编译 go build -o go-blockchain main.go
作用:创建创世块、作为初始区块链节点,负责向其他钱包地址转账。
-
打开终端1,设置环境变量NODE_ID作为节点ID:
export NODE_ID=3000 # 声明当前节点标识为3000
-
创建中心节点钱包(CENTRAL_NODE):
执行命令生成中心节点地址,记录该地址(后续用CENTRAL_NODE指代):./blockchain_go createwallet # 输出示例:Your new address: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa(假地址,以实际输出为准) -
创建包含创世块的区块链:
以中心节点地址作为创世块奖励接收者,初始化区块链:./blockchain_go createblockchain -address CENTRAL_NODE # 输出示例:Done!(此时生成区块链数据库文件blockchain_3000.db) -
备份创世块数据库:
创世块是区块链的唯一标识,需复制给其他节点作为初始化依据:cp blockchain_3000.db blockchain_genesis.db # 备份创世块到通用文件 -
向钱包节点转账并挖矿:
向后续钱包节点的地址转账(暂时记录命令,后续在钱包节点生成地址后执行):# 后续步骤中,替换WALLET_1和WALLET_2为实际地址 ./blockchain_go send -from CENTRAL_NODE -to WALLET_1 -amount 10 -mine ./blockchain_go send -from CENTRAL_NODE -to WALLET_2 -amount 10 -mine # 说明:-mine参数表示当前节点立即挖矿确认交易,生成新块
-
启动中心节点服务:
启动节点监听网络连接,用于与其他节点同步区块:./blockchain_go startnode # 输出示例:Starting node 3000(节点将持续运行,请勿关闭终端)
作用:生成用户钱包地址,接收中心节点转账,发起新交易。
-
打开终端2,设置节点ID:
export NODE_ID=3001 # 声明当前节点标识为3001
-
生成钱包地址:
执行3次createwallet命令,生成3个地址,分别记录为WALLET_1、WALLET_2、WALLET_3:./blockchain_go createwallet # 生成WALLET_1 ./blockchain_go createwallet # 生成WALLET_2 ./blockchain_go createwallet # 生成WALLET_3 # 输出示例:每次执行会返回一个新地址,需记录下来
-
初始化区块链(基于创世块):
复制中心节点备份的创世块数据库,作为本节点区块链的起点:cp blockchain_genesis.db blockchain_3001.db # 从创世块初始化本节点数据库 -
启动钱包节点服务(同步区块):
启动节点,自动连接中心节点并同步区块:./blockchain_go startnode # 输出示例: # Starting node 3001 # Received version command # (节点会从中心节点同步之前的转账区块,运行片刻后按Ctrl+C暂停)
-
验证余额(同步后):
暂停节点后,检查各地址余额是否正确:# 检查WALLET_1余额(预期10) ./blockchain_go getbalance -address WALLET_1 # 检查WALLET_2余额(预期10) ./blockchain_go getbalance -address WALLET_2 # 检查中心节点余额(创世块奖励+剩余,预期初始奖励减去已转账部分,示例10) ./blockchain_go getbalance -address CENTRAL_NODE
作用:负责挖矿确认交易,获取挖矿奖励。
-
打开终端3,设置节点ID:
export NODE_ID=3002 # 声明当前节点标识为3002
-
生成矿工钱包地址:
执行createwallet生成矿工地址,记录为MINER_WALLET:./blockchain_go createwallet # 输出示例:Your new address: 1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2(假地址,以实际输出为准) -
初始化区块链(基于创世块):
复制创世块数据库,与其他节点保持区块链一致性:cp blockchain_genesis.db blockchain_3002.db
-
启动矿工节点(开启挖矿模式):
启动节点并指定矿工地址(挖矿奖励将转入该地址):./blockchain_go startnode -miner MINER_WALLET # 输出示例: # Starting node 3002 # Mining is on. Address to receive rewards: MINER_WALLET # (节点将持续运行,等待接收交易并挖矿)
-
钱包节点(NODE 3001)发送交易:
在终端2中重新启动钱包节点(若已暂停),执行交易命令:# 重新启动钱包节点(确保与其他节点连接) ./blockchain_go startnode # 按Ctrl+C暂停,执行交易(无需-mine,由矿工节点挖矿) ./blockchain_go send -from WALLET_1 -to WALLET_3 -amount 1 ./blockchain_go send -from WALLET_2 -to WALLET_4 -amount 1 # WALLET_4可提前生成
-
矿工节点(NODE 3002)挖矿确认:
观察终端3,矿工节点会收到交易并挖矿,输出类似:Recevied a new block! Added block [哈希值] -
钱包节点(NODE 3001)同步区块:
在终端2中重启钱包节点,自动同步矿工节点挖出的新块:./blockchain_go startnode # 输出示例:Recevied a new block!(运行片刻后按Ctrl+C暂停) -
验证最终余额:
在终端2中执行余额检查命令,预期结果如下:# WALLET_1:10 - 1 = 9 ./blockchain_go getbalance -address WALLET_1 # WALLET_2:10 - 1 = 9 ./blockchain_go getbalance -address WALLET_2 # WALLET_3:0 + 1 = 1 ./blockchain_go getbalance -address WALLET_3 # WALLET_4:0 + 1 = 1 ./blockchain_go getbalance -address WALLET_4 # MINER_WALLET:获得挖矿奖励(示例10) ./blockchain_go getbalance -address MINER_WALLET
| 地址 | 最终余额(示例) | 说明 |
|---|---|---|
| WALLET_1 | 9 | 转出1个单位后剩余 |
| WALLET_2 | 9 | 转出1个单位后剩余 |
| WALLET_3 | 1 | 接收WALLET_1转入 |
| WALLET_4 | 1 | 接收WALLET_2转入 |
| MINER_WALLET | 10 | 挖矿奖励(区块奖励) |
- 地址有效性:确保所有地址通过
createwallet生成 - 节点连接:若节点无法同步,检查
knownNodes配置(默认包含localhost:3000),确保节点端口正确。 - 数据库文件:每个节点的数据库文件(
blockchain_XXX.db)需独立,避免互相覆盖。 - 挖矿确认:交易需等待矿工节点挖矿生成新块后才会生效,若长时间未确认,检查矿工节点是否正常运行。