2017-12-24 12:26:15 -08:00
|
|
|
Bitcoin Private v1.0.10-1
|
2017-05-12 13:00:56 -07:00
|
|
|
|
2017-05-27 21:41:02 -07:00
|
|
|
NOTICE, the default ports have changed! The p2p port is now 8033 and rpcport is 8023
|
2016-11-04 22:24:27 -07:00
|
|
|
|
2017-12-24 12:26:15 -08:00
|
|
|
What is Bitcoin Private?
|
2016-11-04 22:24:27 -07:00
|
|
|
----------------
|
2017-12-24 12:26:15 -08:00
|
|
|
Bitcoin Private is financial freedom.
|
2016-01-20 08:15:36 -08:00
|
|
|
|
2017-04-07 17:07:34 -07:00
|
|
|
Install
|
|
|
|
-----------------
|
|
|
|
### Linux
|
|
|
|
|
|
|
|
Get dependencies
|
2016-11-05 01:34:09 -07:00
|
|
|
```{r, engine='bash'}
|
|
|
|
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
|
|
|
|
```
|
|
|
|
|
|
|
|
Install
|
|
|
|
```{r, engine='bash'}
|
|
|
|
# Build
|
2017-12-27 23:12:59 -08:00
|
|
|
./btcputil/build.sh -j$(nproc)
|
2016-11-06 00:49:09 -07:00
|
|
|
# fetch key
|
2017-12-27 23:12:59 -08:00
|
|
|
./btcputil/fetch-params.sh
|
2016-11-06 00:05:18 -07:00
|
|
|
# Run
|
2017-12-27 23:12:59 -08:00
|
|
|
./src/btcpd
|
2016-11-05 01:34:09 -07:00
|
|
|
```
|
|
|
|
|
2017-04-07 17:07:34 -07:00
|
|
|
### Windows
|
|
|
|
Get dependencies
|
|
|
|
```{r, engine='bash'}
|
|
|
|
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 mingw-w64
|
|
|
|
```
|
|
|
|
|
|
|
|
Install (Cross-Compiled, building on Windows is not supported yet)
|
|
|
|
```{r, engine='bash'}
|
|
|
|
# Build
|
2017-12-27 23:12:59 -08:00
|
|
|
./btcputil/build-win.sh -j$(nproc)
|
2017-04-07 17:07:34 -07:00
|
|
|
```
|
|
|
|
The exe will save to `src` which you can then move to a windows machine
|
|
|
|
|
|
|
|
### Mac
|
|
|
|
Get dependencies
|
|
|
|
```{r, engine='bash'}
|
|
|
|
#install xcode
|
|
|
|
xcode-select --install
|
|
|
|
|
|
|
|
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
|
|
|
|
brew install cmake autoconf libtool automake coreutils pkgconfig gmp wget
|
|
|
|
|
2017-08-23 16:53:41 -07:00
|
|
|
brew install gcc5 --without-multilib
|
2017-04-07 17:07:34 -07:00
|
|
|
```
|
|
|
|
|
|
|
|
Install
|
|
|
|
```{r, engine='bash'}
|
|
|
|
# Build
|
2017-12-27 23:12:59 -08:00
|
|
|
./btcputil/build-mac.sh -j$(nproc)
|
2017-04-07 17:07:34 -07:00
|
|
|
# fetch key
|
2017-12-27 23:12:59 -08:00
|
|
|
./btcputil/fetch-params.sh
|
2017-04-07 17:07:34 -07:00
|
|
|
# Run
|
2017-12-27 23:12:59 -08:00
|
|
|
./src/btcpd
|
2017-04-07 17:07:34 -07:00
|
|
|
```
|
2016-11-19 14:11:20 -08:00
|
|
|
|
2016-11-19 14:21:53 -08:00
|
|
|
About
|
2016-07-11 05:38:54 -07:00
|
|
|
--------------
|
2012-12-12 18:27:58 -08:00
|
|
|
|
2017-12-24 12:26:15 -08:00
|
|
|
[Bitcoin Private](http://zclassic.org/), like [Zcash](https://z.cash/), is an implementation of the "Zerocash" protocol.
|
2016-10-25 08:14:38 -07:00
|
|
|
Based on Bitcoin's code, it intends to offer a far higher standard of privacy
|
2016-11-03 21:07:56 -07:00
|
|
|
through a sophisticated zero-knowledge proving scheme that preserves
|
|
|
|
confidentiality of transaction metadata. Technical details are available
|
2016-11-19 14:21:53 -08:00
|
|
|
in the Zcash [Protocol Specification](https://github.com/zcash/zips/raw/master/protocol/protocol.pdf).
|
2012-12-12 18:27:58 -08:00
|
|
|
|
2017-12-24 12:26:15 -08:00
|
|
|
This software is the Bitcoin Private client. It downloads and stores the entire history
|
|
|
|
of Bitcoin Private transactions; depending on the speed of your computer and network
|
2016-10-25 08:14:38 -07:00
|
|
|
connection, the synchronization process could take a day or more once the
|
2016-11-19 14:21:53 -08:00
|
|
|
blockchain has reached a significant size.
|
2016-03-31 17:35:52 -07:00
|
|
|
|
2016-07-12 12:34:34 -07:00
|
|
|
Security Warnings
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
See important security warnings in
|
|
|
|
[doc/security-warnings.md](doc/security-warnings.md).
|
|
|
|
|
2017-12-24 12:26:15 -08:00
|
|
|
**Bitcoin Private and Zcash are unfinished and highly experimental.** Use at your own risk.
|
2016-10-25 08:14:38 -07:00
|
|
|
|
2017-05-24 07:37:10 -07:00
|
|
|
Deprecation Policy
|
|
|
|
------------------
|
|
|
|
|
|
|
|
This release is considered deprecated 16 weeks after the release day. There
|
2017-05-24 08:15:03 -07:00
|
|
|
is an automatic deprecation shutdown feature which will halt the node some
|
|
|
|
time after this 16 week time period. The automatic feature is based on block
|
|
|
|
height and can be explicitly disabled.
|
2017-05-24 07:37:10 -07:00
|
|
|
|
2016-10-25 08:14:38 -07:00
|
|
|
Where do I begin?
|
|
|
|
-----------------
|
2017-12-24 12:26:15 -08:00
|
|
|
We have a guide for joining the main Bitcoin Private network:
|
|
|
|
https://github.com/BTCPrivate/BitcoinPrivate/wiki/1.0-User-Guide
|
2016-10-25 08:14:38 -07:00
|
|
|
|
|
|
|
### Need Help?
|
|
|
|
|
2017-12-24 12:26:15 -08:00
|
|
|
* See the documentation at the [Bitcoin Private Wiki](https://github.com/BTCPrivate/BitcoinPrivate/wiki)
|
2016-10-25 08:14:38 -07:00
|
|
|
for help and more information.
|
2017-12-24 12:26:15 -08:00
|
|
|
* Ask for help on the [Bitcoin Private](http://zcltalk.tech/index.php) forum.
|
2016-10-25 08:14:38 -07:00
|
|
|
|
2016-11-19 14:21:53 -08:00
|
|
|
### Want to participate in development?
|
|
|
|
|
2016-11-19 14:51:21 -08:00
|
|
|
* Code review is welcome!
|
2016-11-19 14:21:53 -08:00
|
|
|
* If you want to get to know us join our slack: http://zclassic.herokuapp.com/
|
2016-10-25 08:14:38 -07:00
|
|
|
|
|
|
|
|
2016-11-19 14:21:53 -08:00
|
|
|
Participation in the Zcash project is subject to a
|
|
|
|
[Code of Conduct](code_of_conduct.md).
|
2016-10-25 08:14:38 -07:00
|
|
|
|
Merge: v1.0.4 into master (#42)
* Add getlocalsolps and getnetworksolps RPC calls, show them in getmininginfo
* Add benchmark for attempting decryption of notes
* Add benchmark for incrementing note witnesses
* Add -metricsui flag to toggle between persistent screen and rolling metrics
Defaults to true if stdout is a TTY, else false.
* Add -metricsrefreshtime option
* Only show metrics by default if stdout is a TTY
* Document metrics screen options
* Fix stale comment referencing upstream block interval
* Add checkpoint at block height 15000
* Added mainnet, testnet, and onion nodes
* Make command line option to show all debugging consistent with similar options
Most people expect a value of 1 to enable all for command line arguments.
However to do this for the -debug option you must type "-debug=".
This has been changed to allow "-debug=1" as well as "-debug=" to
enable all debug logging
* Update documentation to match the #4219 change
* Update help message to match the #4219 change
* Clarify that metrics options are only useful without -daemon and -printtoconsole
* Increase length of metrics divider
* Closes #1857. Fixes bug where tx spending only notes had priority of 0.
* Closes #1901. Increase default settings for the max block size when
mining and the amount of space available for priority transactions.
* Write witness caches when writing the best block
For steady-state operation, this reduces the average time between wallet disk
writes from once per block to once per hour.
On -rescan, witness caches are only written out at the end along with the best
block, increasing speed while ensuring that on-disk state is kept consistent.
Witness caches are now never recreated during a -reindex, on the assumption that
the blocks themselves are not changing (the chain is just being reconstructed),
and so the witnesses will remain valid.
Part of #1749.
* Add porter dev overrides for CC, CXX, MAKE, BUILD, HOST
* Apply miniupnpc patches to enable compilation on Solaris 11
These can be removed after the next MiniUPnP release.
Closes #1835.
* Closes #1903. Add fee parameter to z_sendmany.
* Add an upstream miniupnpc patch revision
* Metrics - Don't exclaim unless > 1
"You have validated 0 transactions!" sounds a little less enthusiastic that intended. Also, only says "1 transaction".
* Address review comments, tweak strings
* bash-completion: Adapt for 0.12 and 0.13
* separate completion for bitcoind and bitcoin-cli
* remove RPC support from bitcoind completion
* add completion for bitcoin-tx and bitcoin-qt
* rely on autoloading of completions
* Change function names to not clash with Bitcoin, apply to correct binaries
* Add bash completion files to Debian package
* Always bash-complete the default account
* Add Zcash RPC commands to CLI argument completion
* Fixes #1823. Witness anchors for input notes no longer cross block boundaries.
* Edit for grammar: "block chain"
At this point, I believe it is universally accepted that "blockchain" is one word, and should not be separated into two.
* Increase timeout as laptops on battery power have cpu throttling.
* Isolate verification to a `ProofVerifier` context object that allows verification behavior to be tuned by the caller.
* Regression test.
* Ensure cache contains valid entry when anchor is popped.
* Ensure ProofVerifier cannot be accidentally copied.
* Document behaviour of CWallet::SetBestChain
* WitnessAnchorData only needs to store one witness per JSOutPoint.
* Rename Dummy to Disabled.
* Add more tests for ProofVerifier.
* Fix indentation
* Generate JS for trydecryptnotes, make number of addresses a variable
* Add JS to second block to ensure witnesses are incremented
* ASSERT_TRUE -> ASSERT_FALSE
* Skip JoinSplit verification before the last checkpoint
Part of #1749
* Gather release notes from previous release to HEAD
Also update release-process.md to replace git shortlog command with
release-notes.py script.
* Add a reindex test that fails because of a bug in decrementing witness caches
Ref: https://github.com/zcash/zcash/pull/1904#issuecomment-265992988
* Make the test pass by fixing the bug!
* Only check cache validity for witnesses being incremented or decremented
Fixes the bug resulting from #1904.
* Check that E' points are actually in G2 by ensuring they are of order r.
* Fix bug in wallet tests
* Extract block-generation wallet test code into a function
* Rewrite reindex test to check beyond the max witness cache size
* Fix bug in IncrementNoteWitness()
* Update payment API docs to recommend -rescan for fixing witness errors
* Update version to 1.0.4
* Update man pages
* Release notes, authors, changelog
* Update seed nodes
* Bugfix #14 - getblocksubsidy RPC command is incorrect
2016-12-19 04:59:58 -08:00
|
|
|
Building
|
|
|
|
--------
|
|
|
|
|
|
|
|
Build Zcash along with most dependencies from source by running
|
2017-12-27 23:12:59 -08:00
|
|
|
./btcputil/build.sh. Currently only Linux is officially supported.
|
Merge: v1.0.4 into master (#42)
* Add getlocalsolps and getnetworksolps RPC calls, show them in getmininginfo
* Add benchmark for attempting decryption of notes
* Add benchmark for incrementing note witnesses
* Add -metricsui flag to toggle between persistent screen and rolling metrics
Defaults to true if stdout is a TTY, else false.
* Add -metricsrefreshtime option
* Only show metrics by default if stdout is a TTY
* Document metrics screen options
* Fix stale comment referencing upstream block interval
* Add checkpoint at block height 15000
* Added mainnet, testnet, and onion nodes
* Make command line option to show all debugging consistent with similar options
Most people expect a value of 1 to enable all for command line arguments.
However to do this for the -debug option you must type "-debug=".
This has been changed to allow "-debug=1" as well as "-debug=" to
enable all debug logging
* Update documentation to match the #4219 change
* Update help message to match the #4219 change
* Clarify that metrics options are only useful without -daemon and -printtoconsole
* Increase length of metrics divider
* Closes #1857. Fixes bug where tx spending only notes had priority of 0.
* Closes #1901. Increase default settings for the max block size when
mining and the amount of space available for priority transactions.
* Write witness caches when writing the best block
For steady-state operation, this reduces the average time between wallet disk
writes from once per block to once per hour.
On -rescan, witness caches are only written out at the end along with the best
block, increasing speed while ensuring that on-disk state is kept consistent.
Witness caches are now never recreated during a -reindex, on the assumption that
the blocks themselves are not changing (the chain is just being reconstructed),
and so the witnesses will remain valid.
Part of #1749.
* Add porter dev overrides for CC, CXX, MAKE, BUILD, HOST
* Apply miniupnpc patches to enable compilation on Solaris 11
These can be removed after the next MiniUPnP release.
Closes #1835.
* Closes #1903. Add fee parameter to z_sendmany.
* Add an upstream miniupnpc patch revision
* Metrics - Don't exclaim unless > 1
"You have validated 0 transactions!" sounds a little less enthusiastic that intended. Also, only says "1 transaction".
* Address review comments, tweak strings
* bash-completion: Adapt for 0.12 and 0.13
* separate completion for bitcoind and bitcoin-cli
* remove RPC support from bitcoind completion
* add completion for bitcoin-tx and bitcoin-qt
* rely on autoloading of completions
* Change function names to not clash with Bitcoin, apply to correct binaries
* Add bash completion files to Debian package
* Always bash-complete the default account
* Add Zcash RPC commands to CLI argument completion
* Fixes #1823. Witness anchors for input notes no longer cross block boundaries.
* Edit for grammar: "block chain"
At this point, I believe it is universally accepted that "blockchain" is one word, and should not be separated into two.
* Increase timeout as laptops on battery power have cpu throttling.
* Isolate verification to a `ProofVerifier` context object that allows verification behavior to be tuned by the caller.
* Regression test.
* Ensure cache contains valid entry when anchor is popped.
* Ensure ProofVerifier cannot be accidentally copied.
* Document behaviour of CWallet::SetBestChain
* WitnessAnchorData only needs to store one witness per JSOutPoint.
* Rename Dummy to Disabled.
* Add more tests for ProofVerifier.
* Fix indentation
* Generate JS for trydecryptnotes, make number of addresses a variable
* Add JS to second block to ensure witnesses are incremented
* ASSERT_TRUE -> ASSERT_FALSE
* Skip JoinSplit verification before the last checkpoint
Part of #1749
* Gather release notes from previous release to HEAD
Also update release-process.md to replace git shortlog command with
release-notes.py script.
* Add a reindex test that fails because of a bug in decrementing witness caches
Ref: https://github.com/zcash/zcash/pull/1904#issuecomment-265992988
* Make the test pass by fixing the bug!
* Only check cache validity for witnesses being incremented or decremented
Fixes the bug resulting from #1904.
* Check that E' points are actually in G2 by ensuring they are of order r.
* Fix bug in wallet tests
* Extract block-generation wallet test code into a function
* Rewrite reindex test to check beyond the max witness cache size
* Fix bug in IncrementNoteWitness()
* Update payment API docs to recommend -rescan for fixing witness errors
* Update version to 1.0.4
* Update man pages
* Release notes, authors, changelog
* Update seed nodes
* Bugfix #14 - getblocksubsidy RPC command is incorrect
2016-12-19 04:59:58 -08:00
|
|
|
|
2012-12-12 18:27:58 -08:00
|
|
|
License
|
|
|
|
-------
|
|
|
|
|
2016-10-25 08:14:38 -07:00
|
|
|
For license information see the file [COPYING](COPYING).
|