126 lines
6.1 KiB
Markdown
126 lines
6.1 KiB
Markdown
# 狗狗币核心 （Dogecoin Core） [DOGE, Ð]
|
||
|
||
|
||
|
||
[](https://travis-ci.com/dogecoin/dogecoin)
|
||
|
||
选择文档语言: [英文](../README.md) | 简体中文 | [其他语言...](./README_zh_CN.md)
|
||
|
||
尽管狗狗币不使用SHA256作为它的工作量证明（POW），狗狗币也是一款类似Bitcoin的加密货币。受到Tenebrix和Litecoin的影响，狗狗币目前采用一种更简洁的加密方式。
|
||
- **网址:** [dogecoin.com.](https://dogecoin.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 Dogecoin
|
||
|
||
100,000–144,999: 0–500,000 Dogecoin
|
||
|
||
145,000–199,999: 250,000 Dogecoin
|
||
|
||
200,000–299,999: 125,000 Dogecoin
|
||
|
||
300,000–399,999: 62,500 Dogecoin
|
||
|
||
400,000–499,999: 31,250 Dogecoin
|
||
|
||
500,000–599,999: 15,625 Dogecoin
|
||
|
||
600,000+: 10,000 Dogecoin
|
||
|
||
**原先的区块奖励机制（一分钟区块和四小时难度调整）:**
|
||
|
||
1–99,999: 0–1,000,000 Dogecoin
|
||
|
||
100,000–199,999: 0–500,000 Dogecoin
|
||
|
||
200,000–299,999: 0–250,000 Dogecoin
|
||
|
||
300,000–399,999: 0–125,000 Dogecoin
|
||
|
||
400,000–499,999: 0–62,500 Dogecoin
|
||
|
||
500,000–599,999: 0–31,250 Dogecoin
|
||
|
||
600,000+: 10,000 Dogecoin
|
||
|
||
### 请编译我吧 / Wow plz make dogecoind/dogecoin-cli/dogecoin-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文件中。
|