Skip to content

Latest commit

 

History

History
377 lines (297 loc) · 10.1 KB

README_CN.md

File metadata and controls

377 lines (297 loc) · 10.1 KB
Raw

Build Status

DNA (Distributed Networks Architecture)

DNA是go语言实现的基于区块链技术的去中心化的分布式网络协议。可以用来数字化资产和金融相关业务包括资产注册，发行，转账等。

特性

  • 可扩展的轻量级通用智能合约
  • 跨链交互协议（进行中）
  • 抗量子密码算法 (可选择模块)
  • 中国商用密码算法 (可选择模块)
  • 高度优化的交易处理速度
  • 基于IPFS的分布式存储和文件共享解决方案
  • 节点访问权限控制
  • P2P连接链路加密
  • 多种共识算法支持 (DBFT/RBFT/SBFT)
  • 可配置区块生成时间
  • 可配置电子货币模型
  • 可配置的分区共识(进行中)

编译

成功编译DNA需要以下准备：

  • Go版本在1.8及以上
  • 安装第三方包管理工具glide
  • 正确的Go语言开发环境

克隆DNA仓库到$GOPATH/src目录

$ git clone https://github.com/DNAProject/DNA.git

用第三方包管理工具glide拉取依赖库

$ cd DNA
$ glide install

用make编译源码

$ make

成功编译后会生成两个可以执行程序

  • node: 节点程序
  • nodectl: 以命令行方式提供的节点控制程序

部署

成功运行DNA需要至少4个节点，可以通过两种方式进行部署

  • 多机部署
  • 单机部署

多机部署配置

我们可以通过修改默认的配置文件config.json进行快速部署。

  1. 将相关文件复制到目标主机，包括：

    • 默认配置文件config.json
    • 节点程序node
    • 节点控制程序nodectl

  2. 设置每个节点网络连接的端口号（推荐不做修改，使用默认端口配置）

    • NodePort为的P2P连接端口号（默认20338）
    • HttpJsonPort和HttpLocalPort为RPC端口号（默认为20336，20337）

  3. 种子节点配置

    • 在4个主机中选出至少一个做种子节点，并将种子节点地址分别填写到每个配置文件的SeelList中，格式为种子节点IP地址 + 种子节点NodePort

  4. 创建钱包文件

    • 通过命令行程序，在每个主机上分别创建节点运行所需的钱包文件wallet.dat

      $ ./nodectl wallet -c -p password

      注：通过-p参数设置钱包密码

  5. 记账人配置

    • 为每个节点创建钱包时会显示钱包的公钥信息，将所有节点的公钥信息分别填写到每个节点的配置文件的BookKeepers项中

      注：每个节点的钱包公钥信息也可以通过命令行程序查看：

      $ ./nodectl wallet -l -p password

多机部署配置完成，每个节点目录结构如下

$ ls
config.json node nodectl wallet.dat

一个配置文件片段如下, 其中10.0.1.100、10.0.1.101等都是种子节点地址:

$ cat config.json
    ...
    "SeedList": [
      "10.0.1.100:10338",
      "10.0.1.101:10338",
      "10.0.1.102:10338"
    ],
    "BookKeepers": [
      "0322cfdb6a20401c2e44ede40b5282b2925fcff21cdc3814d782fd26026f1d023d",
      "02b639c019537839ba30b7c8c0396095da8838993492c07fe6ca11a5cf7b8fd2ca",
      "032c842494feba4e3dec3b9b7d9ad080ce63c81a41f7d79d2bbb5d499d16322907",
      "03d36828a99547184452276116f1b5171861931ff439a6da2316fddf1f3f428850"
    ],
    "HttpInfoPort": 10333,
    "HttpInfoStart": true,    
    "HttpRestPort": 10334,
    "HttpWsPort": 10335,
    "HttpJsonPort": 10336,
    "HttpLocalPort": 10337,
    "NoticeServerUrl":"",
    "OauthServerUrl":"",
    "NodePort": 10338,
    ...

单机部署配置

在单机上创建4个不同的目录，类似多机部署的方法分别在每个目录下存放以下文件：

  • 默认配置文件config.json
  • 节点程序node
  • 节点控制程序nodectl
  • 钱包文件wallet.dat 与多机配置不同的是，需要保证本机上端口不冲突, 请使用者自行修改个端口值。

单机配置的例子如下：

  • 目录结构
$ tree
├── node1
│   ├── config.json
│   ├── node
│   ├── nodectl
│   └── wallet.dat
├── node2
│   ├── config.json
│   ├── node
│   ├── nodectl
│   └── wallet.dat
├── node3
│   ├── config.json
│   ├── node
│   ├── nodectl
│   └── wallet.dat
└── node4
    ├── config.json
    ├── node
    ├── nodectl
    └── wallet.dat
  • 配置文件参考
$ cat node[1234]/config.json
    ...
    "SeedList": [
      "10.0.1.100:10338",
      "10.0.1.100:20338",
      "10.0.1.100:30338",
      "10.0.1.100:40338"
    ],
    "BookKeepers": [
      "0322cfdb6a20401c2e44ede40b5282b2925fcff21cdc3814d782fd26026f1d023d",
      "02b639c019537839ba30b7c8c0396095da8838993492c07fe6ca11a5cf7b8fd2ca",
      "032c842494feba4e3dec3b9b7d9ad080ce63c81a41f7d79d2bbb5d499d16322907",
      "03d36828a99547184452276116f1b5171861931ff439a6da2316fddf1f3f428850"
    ],
    "HttpInfoPort": 10333,
    "HttpInfoStart": true,    
    "HttpRestPort": 10334,
    "HttpWsPort": 10335,
    "HttpJsonPort": 10336,
    "HttpLocalPort": 10337,
    "NoticeServerUrl":"",
    "OauthServerUrl":"",
    "NodePort": 10338,
    ...

    "SeedList": [
      "10.0.1.100:10338",
      "10.0.1.100:20338",
      "10.0.1.100:30338",
      "10.0.1.100:40338"
    ],
    "BookKeepers": [
      "0322cfdb6a20401c2e44ede40b5282b2925fcff21cdc3814d782fd26026f1d023d",
      "02b639c019537839ba30b7c8c0396095da8838993492c07fe6ca11a5cf7b8fd2ca",
      "032c842494feba4e3dec3b9b7d9ad080ce63c81a41f7d79d2bbb5d499d16322907",
      "03d36828a99547184452276116f1b5171861931ff439a6da2316fddf1f3f428850"
    ],
    "HttpInfoPort": 20333,
    "HttpInfoStart": true,    
    "HttpRestPort": 20334,
    "HttpWsPort": 20335,
    "HttpJsonPort": 20336,
    "HttpLocalPort": 20337,
    "NoticeServerUrl":"",
    "OauthServerUrl":"",
    "NodePort": 20338,
    ...

    "SeedList": [
      "10.0.1.100:10338",
      "10.0.1.100:20338",
      "10.0.1.100:30338",
      "10.0.1.100:40338"
    ],
    "BookKeepers": [
      "0322cfdb6a20401c2e44ede40b5282b2925fcff21cdc3814d782fd26026f1d023d",
      "02b639c019537839ba30b7c8c0396095da8838993492c07fe6ca11a5cf7b8fd2ca",
      "032c842494feba4e3dec3b9b7d9ad080ce63c81a41f7d79d2bbb5d499d16322907",
      "03d36828a99547184452276116f1b5171861931ff439a6da2316fddf1f3f428850"
    ],
    "HttpInfoPort": 30333,
    "HttpInfoStart": true,    
    "HttpRestPort": 30334,
    "HttpWsPort": 30335,
    "HttpJsonPort": 30336,
    "HttpLocalPort": 30337,
    "NoticeServerUrl":"",
    "OauthServerUrl":"",
    "NodePort": 30338,
    ...

    "SeedList": [
      "10.0.1.100:10338",
      "10.0.1.100:20338",
      "10.0.1.100:30338",
      "10.0.1.100:40338"
    ],
    "BookKeepers": [
      "0322cfdb6a20401c2e44ede40b5282b2925fcff21cdc3814d782fd26026f1d023d",
      "02b639c019537839ba30b7c8c0396095da8838993492c07fe6ca11a5cf7b8fd2ca",
      "032c842494feba4e3dec3b9b7d9ad080ce63c81a41f7d79d2bbb5d499d16322907",
      "03d36828a99547184452276116f1b5171861931ff439a6da2316fddf1f3f428850"
    ],
    "HttpInfoPort": 40333,
    "HttpInfoStart": true,    
    "HttpRestPort": 40334,
    "HttpWsPort": 40335,
    "HttpJsonPort": 40336,
    "HttpLocalPort": 40337,
    "NoticeServerUrl":"",
    "OauthServerUrl":"",
    "NodePort": 40338,
    ...

运行

以任意顺序运行每个节点node程序，并在出现Password:提示后输入节点的钱包密码

$ ./node
$ - 输入你的钱包口令

在开放公共环境中测试DNA

  1. 交易 :
./nodectl --ip 139.219.65.178 --port 10336 test -tx perf -num 10
  1. 注册,分发,交易资产 :
./nodectl --ip 139.219.65.178 --port 10336 test -tx full
  1. 查询区块信息 :
./nodectl --ip 139.219.65.178 --port 10336 info -height 10
  1. 查询交易信息 :
./nodectl --ip 139.219.65.178 --port 10336 info -txhash d438896f07786b74281bc70259b0caaccb87460171104ea17473b5e802033a98

......

了解更多请运行 ./nodectl --h.

测试环境

我们在云上部署了DNA供大家使用

主要功能包括：

  1. 区块链相关信息查询
    • 区块信息
    • 交易信息
    • 节点信息
  2. 资产操作
    • 注册资产
    • 发型资产
    • 转账
  3. 测试交易发送

使用方式参见：

forum.DNAProject.com/DNA节点控制工具

可用节点如下：

IP               PORT
----------------------
139.219.65.178:  10336
139.219.99.201:  10336
139.219.96.154:  10336

注：以上环境仅供测试使用，数据可能丢失或重置，我们不保证测试数据安全，请用户注意备份数据。

贡献代码

请您以签过名的commit发送pull request请求，我们期待您的加入！ 您也可以通过邮件的方式发送你的代码到开发者邮件列表，欢迎加入DNA邮件列表和开发者论坛。

另外，在您想为本项目贡献代码时请提供详细的提交信息，格式参考如下：

Header line: explain the commit in one line (use the imperative)

Body of commit message is a few lines of text, explaining things
in more detail, possibly giving some background about the issue
being fixed, etc etc.

The body of the commit message can be several paragraphs, and
please do proper word-wrap and keep columns shorter than about
74 characters or so. That way "git log" will show things
nicely even when it's indented.

Make sure you explain your solution and why you're doing what you're
doing, as opposed to describing what you're doing. Reviewers and your
future self can read the patch, but might not understand why a
particular solution was implemented.

Reported-by: whoever-reported-it
Signed-off-by: Your Name <[email protected]>

开源社区

邮件列表

我们为开发者提供了一下邮件列表

可以通过两种方式订阅并参与讨论

网站

论坛

Wiki

许可证

DNA遵守Apache License, 版本2.0。 详细信息请查看项目根目录下的LICENSE文件。