aboutsummaryrefslogtreecommitdiff
path: root/README_zh_CN.md
blob: 24f77f390c7534bf8d32ca2a56ddb48f5a704979 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
# 狗狗币核心 (Discoin Core) [DIS, Ð]

![Discoin](https://static.tumblr.com/ppdj5y9/Ae9mxmxtp/300coin.png)

[![Build Status](https://travis-ci.com/discoin/discoin.svg?branch=master)](https://travis-ci.com/discoin/discoin)

选择文档语言: [英文](../README.md) | 简体中文 | [其他语言...](./README_zh_CN.md)

尽管狗狗币不使用SHA256作为它的工作量证明(POW),狗狗币也是一款类似Bitcoin的加密货币。受到Tenebrix和Litecoin的影响,狗狗币目前采用一种更简洁的加密方式。
- **网址:** [discoin.com.](https://discoin.com)

## 证书 – 炫酷的证书 ⚖️
狗狗币在MIT liscence的条款下发行。详情请参见
[COPYING](COPYING) 或者
[opensource.org](https://opensource.org/licenses/MIT)。

## 开发和贡献 – omg 开发者
目前的研发还在进行中,开发团队以及其他志愿者可以随意通过自己的代码库分支发布pull request。

#### 版本说明
版本号码遵循以下语法:```major.minor.patch```。

#### 代码库分支(branch)
本代码库有3个branch:

- **master(主代码库):** 稳定。包含最新版本的release,以*major.minor*形式呈现。
- **maintenance(维护代码库):** 稳定。包含正在维护中的上一个release的最新版本。格式: ```<version>-maint```
- **development(正在开发代码库):** 不稳定。包含下一个release的最新代码。格式: ```<version>-dev```

*Master 和 maintenance 互不干扰。最新release永远包含一个development分支。新的 pull request 应该发布于此。Maintenance 分支**只能用于调试程序**。请将新开发的功能发布在 development 分支的最高版本。*

#### 贡献 ✍️

鼓励开发者为新代码来创建自己的[单元测试](src/test/README.md),或者为旧代码发布新的单元测试。用如下指令编译并运行单元测试(仅限于单元测试在配置中没有被禁用):`make check`。更多关于运行和开发单元测试的信息请查看:[/src/test/README.md](/src/test/README.md).

RPC界面上还有由Python编写的[回归和整合测试(regression and integration tests)](/qa) ,可以在build服务器上自动运行。这些测试还可以通过以下指令来运行:`qa/pull-tester/rpc-tests.py`(前提是已经安装了[测试依赖文件(test dependencies)](/qa))。

代码的改变还应该由除开发者之外的其他人员进行测试。这一点对于大段改动和高危变化尤其重要。建议在pull request的描述中加入测试文档(test plan),如果测试方式并不很直接。

## 灰常常见的问题 ❓

### 到底一共可以有多少狗狗币? – 狗狗多多! 🐕
截至2015年初(大概发行一年半的时间)会有100,000,000,000狗狗币。
之后的每个区块(block)将会带来10,000狗狗币来激励矿工们持续输出,增加挖矿的安全性并且对因丢失的钱包、硬盘、手机、密码等而丢失的狗狗币做出相应弥补。 

### 挖矿须知 ⛏

狗狗币采用一种简化版的密钥派生函数作为它的工作量证明。目标时间为每分钟产出一个区块,每产出一个区块后都会进行难度值调整。区块奖励是固定的,且每产出100,000个区块就会减半。从第600,000个区块开始,每产出一个区块的奖励会固定在10,000个狗狗币。

起初,我们设想了一种不同的支付方式,由Mersenne Twister伪随机数生成器在0到区块计划相应的最大区块奖励中生成一个随机数作为区块奖励。

然而在第145,000区块上,为了防止大矿池钻空子只挖高奖励的区块,这种方案就不适用了。与此同时,难度值调整也从每4小时变为每个区块产生(每分钟)更改一次,使用的是DigiByte Coin开发团队的一个算法,以减少狗狗币网络中哈希率突然增大或减少带来的影响。

**目前的区块奖励机制:**

1–99,999: 0–1,000,000 Discoin

100,000–144,999: 0–500,000 Discoin

145,000–199,999: 250,000 Discoin

200,000–299,999: 125,000 Discoin

300,000–399,999: 62,500 Discoin

400,000–499,999: 31,250 Discoin

500,000–599,999: 15,625 Discoin

600,000+: 10,000 Discoin

**原先的区块奖励机制(一分钟区块和四小时难度调整):**

1–99,999: 0–1,000,000 Discoin

100,000–199,999: 0–500,000 Discoin

200,000–299,999: 0–250,000 Discoin

300,000–399,999: 0–125,000 Discoin

400,000–499,999: 0–62,500 Discoin

500,000–599,999: 0–31,250 Discoin

600,000+: 10,000 Discoin

### 请编译我吧 / Wow plz make discoind/discoin-cli/discoin-qt

  以下是开发者的笔记,教你如何在你自己的平台上搭建狗狗币。这些不是什么权威指南,但包含了必要的libary, 编译flag 等等。

  - [OSX Build Notes](doc/build-osx.md)
  - [Unix Build Notes](doc/build-unix.md)
  - [Windows Build Notes](doc/build-windows.md)

### 端口们

- RPC 22555
- P2P 22556

## 开发贴士与技巧

**调试编译**

运行 `configure`, 应用 `--enable-debug` 选项, 然后 `make`. 或者运行 `configure` 应用
`CXXFLAGS="-g -ggdb -O0"` 或者其他你需要的flag。

**debug.log**

如果代码表现得很诡异,看一眼data路径下的debug.log;错误信息和调试消息都在这里。

`-debug=...`这个选项代表调试模式;带着这个flag去运行会打开所有的类别(并输出一个非常大的debug.log文件)。

Qt代码把 `qDebug()` 放到qt类别下的debug.log文件里;使用方式`-debug=qt`。

**测试链(testnet)和私有网络(regtest)模式**

如果你在通过因特网测试跨机代码,在测试链上运行`-testnet`来运行“开始使用狗狗币”。

如果你在测试单机代码,用`-regtest`运行。
在回归测试模式下,区块可以随时被按需制造出来;参见qa/rpc-tests/。

**DEBUG_LOCKORDER**

狗狗币核心是一个多线程应用,碰到死锁和其他多线程问题都会很难找到原因。如果在代码中发现了不一致的地方,使用-DDEBUG_LOCKORDER编译 (configure CXXFLAGS="-DDEBUG_LOCKORDER -g")会在运行时插入检查语句来检测哪些进程被锁定,并把警告加入debug.log文件中。