]>
Commit | Line | Data |
---|---|---|
30853e4a | 1 | <<<<<<< HEAD |
d7426190 | 2 | |
c2ec2f53 DH |
3 | Zcash |
4 | ===== | |
d7426190 | 5 | |
293e4f01 | 6 | https://z.cash/ |
d7426190 | 7 | |
559ab225 SB |
8 | Where do I begin? |
9 | ----------------- | |
10 | ||
2f15f588 | 11 | We have a guide for joining the public testnet: https://github.com/zcash/zcash/wiki/Beta-Guide |
559ab225 | 12 | |
293e4f01 | 13 | What is Zcash? |
c2ec2f53 | 14 | -------------- |
d7426190 | 15 | |
45d7a9b4 | 16 | Zcash is an implementation of the "Zerocash" protocol. Based on Bitcoin's code, it intends to |
293e4f01 | 17 | offer a far higher standard of privacy and anonymity through a sophisticiated zero-knowledge |
08388dbc | 18 | proving scheme which preserves confidentiality of transaction metadata. |
d7426190 | 19 | |
293e4f01 | 20 | **Zcash is unfinished and highly experimental.** Use at your own risk. |
d7426190 | 21 | |
254c16dd | 22 | Participation in the Zcash project is subject to a [Code of Conduct](code_of_conduct.md). |
d7426190 | 23 | |
30853e4a | 24 | ======= |
998202ba JG |
25 | Zcash 1.0.0 |
26 | =========== | |
559ab225 | 27 | |
293e4f01 | 28 | What is Zcash? |
c2ec2f53 | 29 | -------------- |
20d59455 | 30 | |
666a401f DH |
31 | [Zcash](https://z.cash/) is an implementation of the "Zerocash" protocol. |
32 | Based on Bitcoin's code, it intends to offer a far higher standard of privacy | |
5c23abb1 | 33 | and anonymity through a sophisticated zero-knowledge proving scheme that |
666a401f | 34 | preserves confidentiality of transaction metadata. Technical details are |
c8756289 | 35 | available in our [Protocol Specification](https://github.com/zcash/zips/raw/master/protocol/protocol.pdf). |
20d59455 | 36 | |
666a401f DH |
37 | This software is the Zcash client. It downloads and stores the entire history |
38 | of Zcash transactions; depending on the speed of your computer and network | |
39 | connection, the synchronization process could take a day or more once the | |
40 | block chain has reached a significant size. | |
254c16dd | 41 | |
8fb1005c TH |
42 | Security Warnings |
43 | ----------------- | |
d7426190 | 44 | |
8fb1005c TH |
45 | See important security warnings in |
46 | [doc/security-warnings.md](doc/security-warnings.md). | |
47 | ||
20d59455 CD |
48 | License |
49 | ------- | |
d7426190 | 50 | |
c2ec2f53 | 51 | Zcash is released under the terms of the MIT license. See [COPYING](COPYING) for more |
20d59455 | 52 | information or see http://opensource.org/licenses/MIT. |
d7426190 | 53 | |
54 | ||
55 | Komodo Specific Notes | |
56 | ===================== | |
57 | ||
d7426190 | 58 | Dependencies |
59 | ------------ | |
60 | ||
61 | ``` | |
62 | #The following packages are needed: | |
67e8ca1c | 63 | 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 libboost-all-dev libssl-dev libprotobuf-dev protobuf-compiler libqt4-dev libqrencode-dev libdb++-dev ntp ntpdate |
d7426190 | 64 | ``` |
65 | ||
66 | Komodo | |
67 | ------ | |
68 | ||
69 | ``` | |
f3ae714c | 70 | git clone https://github.com/jl777/komodo |
71 | cd komodo | |
99f7333a | 72 | #./autogen.sh |
73 | #./configure --with-incompatible-bdb --with-gui | |
3bb1d82c | 74 | # This command might finish with: configure: error: libgmp headers missing. This can be ignored. so can libsnark directory missing error |
f3ae714c | 75 | ./zcutil/fetch-params.sh |
6c4dfa1c | 76 | |
77 | # -j8 uses 8 threads - replace 8 with number of threads you want to use | |
78 | ./zcutil/build.sh -j8 | |
d7426190 | 79 | #This can take some time. |
80 | ``` | |
81 | ||
3bb1d82c | 82 | # to update an existing version, git checkout dPoW if not on that branch already |
83 | ||
84 | git pull | |
85 | ||
86 | ./zcutil/fetch-params.sh | |
87 | ||
88 | ./zcutil/build.sh -j8 | |
89 | ||
9f0df400 | 90 | To reset the blockchain, from ~/.komodo rm -rf blocks chainstate debug.log komodostate db.log |
3bb1d82c | 91 | |
d7426190 | 92 | Create komodo.conf |
93 | ------------------ | |
94 | ||
95 | ``` | |
96 | cd ~ | |
97 | mkdir .komodo | |
98 | cd .komodo | |
8aeb7db1 | 99 | pico komodo.conf |
d7426190 | 100 | #Add the following lines to the komodo.conf file: |
8aeb7db1 | 101 | |
f3ae714c | 102 | rpcuser=bitcoinrpc |
0032bbb5 | 103 | rpcpassword=password |
a0413d6a | 104 | txindex=1 |
8aeb7db1 | 105 | addnode=5.9.102.210 |
106 | addnode=78.47.196.146 | |
107 | addnode=178.63.69.164 | |
108 | addnode=88.198.65.74 | |
109 | addnode=5.9.122.241 | |
110 | addnode=144.76.94.38 | |
67e8ca1c | 111 | addnode=89.248.166.91 |
d7426190 | 112 | ``` |
113 | ||
114 | Start mining | |
115 | ------------ | |
116 | ||
117 | ``` | |
870e3556 | 118 | #iguana documentation shows how to get the btcpubkey and wifstrs that need to be used |
119 | ||
120 | #bitcoin also need to be installed with txindex=1 and with rpc enabled | |
121 | ||
d7426190 | 122 | cd ~ |
123 | cd komodo | |
c6444836 | 124 | |
c6444836 | 125 | |
c6444836 | 126 | #This will return your pubkey eg. "0259e137e5594cf8287195d13aed816af75bd5c04ae673296b51f66e7e8346e8d8" for your address |
67e8ca1c Y |
127 | ./src/komodo-cli validateaddress <yourwalletaddres> |
128 | ||
129 | #This will give the privkey of your wallet address | |
130 | ./src/komodo-cli dumpprivkey <yourwalletaddres> | |
131 | ||
132 | #This will import the privkey to be sure the mined coins are placed into your wallet address | |
133 | ./src/komodo-cli importprivkey <yourwalletprivkey> | |
af7b3566 | 134 | |
d5a5f0f3 | 135 | #To stop the daemon: |
af7b3566 | 136 | ./src/komodo-cli stop |
c6444836 | 137 | |
67e8ca1c | 138 | #This starts komodo notary - replace genproclimit with number of threads you want to use and add your pubkey |
c6444836 | 139 | ./src/komodod -gen -genproclimit=2 -notary -pubkey="0259e137e5594cf8287195d13aed816af75bd5c04ae673296b51f66e7e8346e8d8" & |
8aeb7db1 | 140 | |
141 | #This will get the stats: | |
142 | ./src/komodo-cli getinfo | |
143 | ||
d7426190 | 144 | #To view the process: |
8aeb7db1 | 145 | ps -ef | grep komodod |
6c4dfa1c | 146 | |
d2438574 | 147 | #To stop the daemon: |
af7b3566 | 148 | ./src/komodo-cli stop |
d7426190 | 149 | |
150 | #To view komodod output: | |
aae8f281 | 151 | tail -f ~/.komodo/debug.log |
67e8ca1c Y |
152 | |
153 | #To view all command | |
154 | ./src/komodo-cli help | |
9fc60fe3 | 155 | |
156 | ASSETCHAINS: -ac_name=name -ac_supply=nnnnn | |
157 | ||
158 | Both komodod and komodo-cli recognize -ac_name=option so you can create a zcash fork from the commandline | |
159 | ||
0032bbb5 | 160 | ``` |
1e613927 | 161 | |
30853e4a | 162 | ======= |
163 | ||
666a401f DH |
164 | **Zcash is unfinished and highly experimental.** Use at your own risk. |
165 | ||
166 | Where do I begin? | |
167 | ----------------- | |
168 | ||
169 | We have a guide for joining the public testnet: | |
170 | https://github.com/zcash/zcash/wiki/Beta-Guide | |
171 | ||
172 | ### Need Help? | |
173 | ||
174 | * See the documentation at the [Zcash Wiki](https://github.com/zcash/zcash/wiki) | |
175 | for help and more information. | |
176 | * Ask for help on the [Zcash](https://forum.z.cash/) forum. | |
177 | ||
178 | Participation in the Zcash project is subject to a | |
179 | [Code of Conduct](code_of_conduct.md). | |
180 | ||
181 | Building | |
182 | -------- | |
183 | ||
184 | Build Zcash along with most dependencies from source by running | |
185 | ./zcutil/build.sh. Currently only Linux is supported. | |
186 | ||
20d59455 CD |
187 | License |
188 | ------- | |
189 | ||
666a401f | 190 | For license information see the file [COPYING](COPYING). |