Zcash 1.0 “发芽” 版本指南

欢迎！这个指导的意图是让你学会运行 Zcash 的官方网络。Zcash 当前有一些局限性：它仅支持 Linux 系统，并且需要 64 位系统，在某些情况下它需要大量的存储空间和 CPU 计算来创造交易。

如果你遇到困难，请告诉我们。我们计划在未来改进我们的软件，让它不需要如此高的存储空间和 CPU 算力，并且运行在更多的系统上。

软件升级？

如果你曾经在测试网络上使用过 alpha/beta/rc 等版本，请确保你的 ~/.zcash/zcash.conf 中并没有包涵 testnet=1 或是 addnode=betatestnet.z.cash 。如果你使用的是基于 Debian 的分发机制，你可以参考 Debian 指导来在你的系统上安装 Zcash。另外，你可以升级您本地对于我们代码的快照：

git fetch origin
git checkout v1.0.3
./zcutil/fetch-params.sh
./zcutil/build.sh -j$(nproc)

同时，请确保您的 ~/.zcash 目录仅含有 zcash.conf 的开头。

一个关于术语的快速笔记

Zcash 支持两种不同的地址，一个 z-addr (以 z 作为开头) 的地址，使用了零知识证明和其他密码学工具来保护用户隐私。同样有 t-addrs (以 t 作为开头)的地址，这些地址与比特币地址用法相同。

需要

目前，你将会需要：

Linux 系统 (具备基于 Debian 的分布式工具)
64 位
4GB 空余存储空间

目前的界面是命令行客户端 (zcash-cli) 和远程过程调用(RPC)接口，它们被记录在这里：

https://github.com/zcash/zcash/blob/v1.0.3/doc/payment-api.md

安全性

在安装，升级或运行 Zcash 之前，请确认你已经检查安全性问题。请查看安全页面：

https://z.cash/zh/support/security.html

开始

基于 Debian 的操作系统

在这里获得指导：
https://github.com/zcash/zcash/wiki/Debian-binary-packages

自己进行编译

在基于 Ubuntu 或者 Debian 的系统中:

sudo apt-get install \
build-essential pkg-config libc6-dev m4 g++-multilib \
autoconf libtool ncurses-dev unzip git python \
zlib1g-dev wget bsdmainutils automake

在基于 Fedora 的系统中：

sudo dnf install \
git pkgconfig automake autoconf ncurses-devel python wget \
gtest-devel gcc gcc-c++ libtool patch

通过使用 git 或运行 fetch-params.sh，来获取我们的程序库：

git clone https://github.com/zcash/zcash.git
cd zcash/
git checkout v1.0.3
./zcutil/fetch-params.sh

这将抓取我们发芽版本的验证密钥(最终的版本被建立在参数生成仪式)，并已经把它们放入 ~/.zcash-params/。这些密钥大约占用 911 MB 存储空间，因此下载它们需要一些时间。

这些由 git checkout 印制的信息是关于”分离的文件头部”，这些是正常的，并不指明存在问题。

建造

确保您已经完整安装了以上提到的所有系统补丁包。之后运行构建程序，比如：

./zcutil/build.sh -j$(nproc)

这样做会编译我们的从属文件，并建造 zcashd。(注意：如果你没有 nproc，那么需要代替你的处理器数量。)

测试

这项测试需要运行一段时间，也许会需要 8 GB 的 RAM。如果你想立即开始，你可以跳至下面的章节。如果你想要运行测试来验证 Zcash 的网络正在工作，请运行：

./qa/zcash/full-test-suite.sh

你同样可以运行 RPC 测试，那样做会花的时间更长一点：

./qa/pull-tester/rpc-tests.sh

这项测试需要许多存储器运行正确。内存不足的错误通常会导致失败或错误出现，同时在输出中出现 “std::bad_alloc” 。

配置

建立 ~/.zcash 目录，并在 ~/.zcash/zcash.conf 中使用以下命令行放置配置文件。

mkdir -p ~/.zcash
echo "addnode=mainnet.z.cash" >~/.zcash/zcash.conf
echo "rpcuser=username" >>~/.zcash/zcash.conf
echo "rpcpassword=`head -c 32 /dev/urandom | base64`" >>~/.zcash/zcash.conf

注意：这样做将覆盖所有你之前在测试网络中对 zcash.conf 内部的设置。你可以在测试网络中保留 zcash.conf ，但请注意 testnet=1 和 addnode=betatestnet.z.cash 的设置已经被删除了；请使用 addnode=mainnet.z.cash 。我们强烈建议您使用随机密码来避免在进入 RPC 接口时的潜在安全问题。

使能 CPU 挖矿:

如果你需要使能 CPU 挖矿，请运行以下命令行：

echo 'gen=1' >> ~/.zcash/zcash.conf
echo "genproclimit=$(nproc)" >> ~/.zcash/zcash.conf

默认的挖矿程序并不高效，但已经被很好的审阅过了。如果想要运行更加高效但并没有被审阅过的求解器，你可以运行以下命令行：

echo 'equihashsolver=tromp' >> ~/.zcash/zcash.conf

注意，你也许想要阅读挖矿指导来了解更多挖矿的细节。

运行 Zcash:

现在，运行 zcashd！

./src/zcashd

想要在后台运行程序 (并没有通常可见的节点指示屏幕)，可以使用 ./src/zcashd --daemon。

你可以在 RPC 加载完毕后使用它。以下是一个快速测试它的方法：

./src/zcash-cli getinfo

注意: 如果你对于比特币的 RPC 接口熟悉，你可以使用很多其中的命令来在 t-addr 的地址之间发送 ZEC。我们并不支持 ‘账户’ 特性(这项功能同样被 bitcoind 所启用) — 仅仅空串 "" 可以命名一个账户。

注意: 在 mainnet.z.cash 的主网节点同样可以通过 Tor 的隐藏服务 zcmaintvsivr7pcn.onion 所访问。

想要看到你链接到的节点：

./src/zcash-cli getpeerinfo

使用 Zcash

第一，如果你想要得到 Zcash ，你可以从交易所、普通用户或服务供应商处购买。如果(安全地)得到 Zcash，并不在本文的讨论范畴，但你需要保持警惕。避免被骗！

生成一个 t-addr

让我们首先生成一个 t-addr。

$ ./src/zcash-cli getnewaddress
tb4oHp2v54vfmdgQ3v3SNuQga8JKHTNi2a1

使用 z-addr 接收 Zcash

现在，让我们生成一个 z-addr.

$ ./src/zcash-cli z_getnewaddress
ztbqWB8VDjVER7uLKb4oHp2v54v2a1jKd9o4FY7mdgQ3gDfG8MiZLvdQga8JK3t58yjXGjQHzMzkGUxSguSs6ZzqpgTNiZG

这些命令生成了隐私的地址，并将私钥存储于您的本地钱包文件中。可以把这个地址交付给要发币给您的人！

一个 z-addr 是非常庞大的，因此使用它很可能会犯错误。让我们把它变成一个环境变量来避免错误：

$ ZADDR='ztbqWB8VDjVER7uLKb4oHp2v54v2a1jKd9o4FY7mdgQ3gDfG8MiZLvdQga8JK3t58yjXGjQHzMzkGUxSguSs6ZzqpgTNiZG'

为了得到你钱包中所有的地址列表，这些地址你都掌握这花费密钥，可以运行以下命令：

$ ./src/zcash-cli z_listaddresses

你应该可以看到以下的内容：

[
"zta6qngiR3U7HxYopyTWkaDLwYBd83D5MT7Jb9gpgTzPLMZytzRbtdPP1Syv4RvRgHeoZrJWSask3DyfwXG9DGPMWMvX7aC",
"ztbqWB8VDjVER7uLKb4oHp2v54v2a1jKd9o4FY7mdgQ3gDfG8MiZLvdQga8JK3t58yjXGjQHzMzkGUxSguSs6ZzqpgTNiZG"
]

很好！现在，发送你的 z-addr 给要给你发币的人。你可以检查下面的信息来最终看到他们发送的转账：

$ ./src/zcash-cli z_listreceivedbyaddress "$ZADDR"

[
{
"txid" : "af1665b317abe538148114a45322f28151925501c081949cc7a5207ef21cb750",
"amount" : 1.23,
"memo" : "48656c6c6f20ceb2210000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
}
]

使用 z-addr 发送你的货币

如果某个人给你了他们的 z-addr…

$ FRIEND='ztcDe8krwEt1ozWmGZhBDWrcUfmK3Ue5D5z1f6u2EZLLCjQq7mBRkaAPb45FUH4Tca91rF4R1vf983ukR71kHyXeED4quGV'

你可以发送 0.8 个 ZEC 给他，步骤如下…

$ ./src/zcash-cli z_sendmany "$ZADDR" "[{\"amount\": 0.8, \"address\": \"$FRIEND\"}]"

在等待了大约 1 分钟之后，你可以查看进程是否结束，预期的结果是：

$ ./src/zcash-cli z_getoperationresult

[
{
"id" : "opid-4eafcaf3-b028-40e0-9c29-137da5612f63",
"status" : "success",
"creation_time" : 1473439760,
"result" : {
"txid" : "3b85cab48629713cc0caae99a49557d7b906c52a4ade97b944f57b81d9b0852d"
},
"execution_secs" : 51.64785629
}
]

了解安全问题

每一个版本更新都包涵一个名为 ./doc/security-warnings.md 的文档，它描述了这个版本所包涵的已知安全问题。你可以在这里找到最新版本的文档：

https://github.com/zcash/zcash/blob/master/doc/security-warnings.md

请同时查看我们的安全页面来了解近期的通知和其他资源：