/blockchain

Java 实现的简易区块链 + 钱包

Primary LanguageJavaApache License 2.0Apache-2.0

blockchain-java

区块链钱包 Java 的简易实现版,自学了一段时间的区块链理论知识,自己尝试着写一个具有钱包雏形的区块链项目,开源出来, 供像我一样想开发区块链又不知从何下手初学者参考。

目前大部分区块链从业者都是从事 DApp 开发,做底层链开发的还是比较少,目前也没有很大必要, 不过尝试写链可以更好的理解区块链底层的运行逻辑。本人在开发的过程中最大的体会是,在理论学习的时候觉得区块链知识并不复杂, 理论自己都懂了,但是真要自己实现了就会发现有各种坑,最后才发现自己对某些细节理解还是一知半解。

希望这个项目能对初学区块链者有所帮助,大家一起学习,一起成长。


单节点部署

这个很简单, 直接像运行普通的 SpringBoot 项目一样运行就好了,单节点默认使用的 node1 节点的配置

多节点部署

项目默认部署3个节点,创建了3个配置文件 application-{env}.yml, 如果想要部署更多的节点,再创建更多的配置文件就 OK 了。

使用 idea 部署测试非常简单,按照下面的方法添加多个 springBoot 启动配置。

然后分别启动 3 个节点就好了。启动之后节点之间自动连接成 P2P 网络,随后你就可以使用 postman 工具进行测试了,如果没有安装 postman 的话请自行安装,或者和我一样使用 chrome 浏览器的 postman 扩展。

简单测试

首先依次启动 node1 - node3 3个节点,由于在启动的时候会自动链接初始化的节点,各自连接成为一个 P2P 的网络,所以被链接的节点没有启动的时候会抛出网络异常,不用管它,等其他节点启动好了之后又会自动连接上的。

你可以使用 PostMan 工具对上面的 RESTFUL api 进行一一测试。不过从 v1.2 之后我在项目中集成了 swagger2,所以现在更好的测试是直接使用 swagger 的 api ui 页面进行测试: http://localhost:8081/swagger-ui.html

直接点击相应的 api 进行测试就 OK 了。

Web 测试 API

API名称 请求方式 URL
生成钱包 POST /api/account/new_account
查看钱包列表 GET /api/account/list
获取挖矿账号 GET /api/account/get_miner_address
启动挖矿 GET /api/chain/mining
发送交易 POST /api/chain/send_transactions
查看最后一个区块 GET /api/chain/block/head
添加节点 POST /api/chain/node/add
查看节点 GET /api/chain/node/view

注意:凡是 POST 请求都是使用 RequestBody 的方式传参的, 不是用表单的 form-data 形式, 比如发送交易的参数形式如下:

{
    "name" : "value",
    "name2" : "value2"
}