From 7ac57982d679e5b72cb27f667b7465e5b56a901e Mon Sep 17 00:00:00 2001 From: Paige Peterson Date: Tue, 25 Oct 2016 16:24:01 -0400 Subject: [PATCH 1/4] add zcash.config --- contrib/DEBIAN/examples/zcash.conf | 131 +++++++++++++++++++++++++++++ 1 file changed, 131 insertions(+) create mode 100644 contrib/DEBIAN/examples/zcash.conf diff --git a/contrib/DEBIAN/examples/zcash.conf b/contrib/DEBIAN/examples/zcash.conf new file mode 100644 index 000000000..b0c5be104 --- /dev/null +++ b/contrib/DEBIAN/examples/zcash.conf @@ -0,0 +1,131 @@ +## +## zcash.conf configuration file. Lines beginning with # are comments. +## + +# Network-related settings: + +# Run on the test network instead of the real zcash network. +#testnet=0 + +# Run a regression test network +#regtest=0 + +# Connect via a SOCKS5 proxy +#proxy=127.0.0.1:9050 + +# Bind to given address and always listen on it. Use [host]:port notation for IPv6 +#bind= + +# Bind to given address and whitelist peers connecting to it. Use [host]:port notation for IPv6 +#whitebind= + +############################################################## +## Quick Primer on addnode vs connect ## +## Let's say for instance you use addnode=4.2.2.4 ## +## addnode will connect you to and tell you about the ## +## nodes connected to 4.2.2.4. In addition it will tell ## +## the other nodes connected to it that you exist so ## +## they can connect to you. ## +## connect will not do the above when you 'connect' to it. ## +## It will *only* connect you to 4.2.2.4 and no one else.## +## ## +## So if you're behind a firewall, or have other problems ## +## finding nodes, add some using 'addnode'. ## +## ## +## If you want to stay private, use 'connect' to only ## +## connect to "trusted" nodes. ## +## ## +## If you run multiple nodes on a LAN, there's no need for ## +## all of them to open lots of connections. Instead ## +## 'connect' them all to one node that is port forwarded ## +## and has lots of connections. ## +## Thanks goes to [Noodle] on Freenode. ## +############################################################## + +# Use as many addnode= settings as you like to connect to specific peers +#addnode=69.164.218.197 +#addnode=10.0.0.2:8233 + +# Alternatively use as many connect= settings as you like to connect ONLY to specific peers +#connect=69.164.218.197 +#connect=10.0.0.1:8233 + +# Listening mode, enabled by default except when 'connect' is being used +#listen=1 + +# Maximum number of inbound+outbound connections. +#maxconnections= + +# +# JSON-RPC options (for controlling a running Zcash/zcashd process) +# + +# server=1 tells zcashd to accept JSON-RPC commands +#server=0 + +# Bind to given address to listen for JSON-RPC connections. Use [host]:port notation for IPv6. +# This option can be specified multiple times (default: bind to all interfaces) +#rpcbind= + +# You must set rpcuser and rpcpassword to secure the JSON-RPC api +#rpcuser=Ulysseys +#rpcpassword=YourSuperGreatPasswordNumber_DO_NOT_USE_THIS_OR_YOU_WILL_GET_ROBBED_385593 + +# How many seconds zcash will wait for a complete RPC HTTP request. +# after the HTTP connection is established. +#rpctimeout=30 + +# By default, only RPC connections from localhost are allowed. +# Specify as many rpcallowip= settings as you like to allow connections from other hosts, +# either as a single IPv4/IPv6 or with a subnet specification. + +# NOTE: opening up the RPC port to hosts outside your local trusted network is NOT RECOMMENDED, +# because the rpcpassword is transmitted over the network unencrypted. + +#rpcallowip=10.1.1.34/255.255.255.0 +#rpcallowip=1.2.3.4/24 +#rpcallowip=2001:db8:85a3:0:0:8a2e:370:7334/96 + +# Listen for RPC connections on this TCP port: +#rpcport=8232 + +# You can use Zcash or zcashd to send commands to Zcash/zcashd +# running on another host using this option: +#rpcconnect=127.0.0.1 + +# Use Secure Sockets Layer (also known as TLS or HTTPS) to communicate +# with Zcash -server or zcashd +#rpcssl=1 + +# OpenSSL settings used when rpcssl=1 +#rpcsslciphers=TLSv1+HIGH:!SSLv2:!aNULL:!eNULL:!AH:!3DES:@STRENGTH +#rpcsslcertificatechainfile=server.cert +#rpcsslprivatekeyfile=server.pem + +# Transaction Fee Changes in 0.10.0 + +# Send transactions as zero-fee transactions if possible (default: 0) +#sendfreetransactions=0 + +# Create transactions that have enough fees (or priority) so they are likely to begin confirmation within n blocks (default: 1). +# This setting is over-ridden by the -paytxfee option. +#txconfirmtarget=n + +# Miscellaneous options + +# Enable attempt to generate zcash. +#gen=1 + +# Enable use of SSE instructions to try to generate zcash faster. +#4way=1 + +# Pre-generate this many public/private key pairs, so wallet backups will be valid for +# both prior transactions and several dozen future transactions. +#keypool=100 + +# Pay an optional transaction fee every time you send zcash. Transactions with fees +# are more likely than free transactions to be included in generated blocks, so may +# be validated sooner. +#paytxfee=0.00 + + From 473389dfb470c8fd4eae5290018b5df34366dc49 Mon Sep 17 00:00:00 2001 From: Paige Peterson Date: Tue, 25 Oct 2016 20:35:59 -0400 Subject: [PATCH 2/4] fix per Jack's mod suggestions --- contrib/DEBIAN/examples/zcash.conf | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/contrib/DEBIAN/examples/zcash.conf b/contrib/DEBIAN/examples/zcash.conf index b0c5be104..d85c016cd 100644 --- a/contrib/DEBIAN/examples/zcash.conf +++ b/contrib/DEBIAN/examples/zcash.conf @@ -60,8 +60,8 @@ # JSON-RPC options (for controlling a running Zcash/zcashd process) # -# server=1 tells zcashd to accept JSON-RPC commands -#server=0 +# server=1 tells zcashd to accept JSON-RPC commands (set as default if not specified) +#server=1 # Bind to given address to listen for JSON-RPC connections. Use [host]:port notation for IPv6. # This option can be specified multiple times (default: bind to all interfaces) @@ -102,7 +102,7 @@ #rpcsslcertificatechainfile=server.cert #rpcsslprivatekeyfile=server.pem -# Transaction Fee Changes in 0.10.0 +# Transaction Fee # Send transactions as zero-fee transactions if possible (default: 0) #sendfreetransactions=0 @@ -116,8 +116,8 @@ # Enable attempt to generate zcash. #gen=1 -# Enable use of SSE instructions to try to generate zcash faster. -#4way=1 +# Enable use of a different Equihash solver to try to generate zcash faster. +#equihashsolver=default # Pre-generate this many public/private key pairs, so wallet backups will be valid for # both prior transactions and several dozen future transactions. From 4340a34de83bcf99f86134011fd636dcf82e38be Mon Sep 17 00:00:00 2001 From: Paige Peterson Date: Tue, 25 Oct 2016 20:55:53 -0400 Subject: [PATCH 3/4] fix per Daira's suggestions --- contrib/DEBIAN/examples/zcash.conf | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/contrib/DEBIAN/examples/zcash.conf b/contrib/DEBIAN/examples/zcash.conf index d85c016cd..1d6d27acd 100644 --- a/contrib/DEBIAN/examples/zcash.conf +++ b/contrib/DEBIAN/examples/zcash.conf @@ -1,7 +1,7 @@ ## ## zcash.conf configuration file. Lines beginning with # are comments. ## - + # Network-related settings: # Run on the test network instead of the real zcash network. @@ -68,7 +68,7 @@ #rpcbind= # You must set rpcuser and rpcpassword to secure the JSON-RPC api -#rpcuser=Ulysseys +#rpcuser=Ulysses #rpcpassword=YourSuperGreatPasswordNumber_DO_NOT_USE_THIS_OR_YOU_WILL_GET_ROBBED_385593 # How many seconds zcash will wait for a complete RPC HTTP request. @@ -80,7 +80,9 @@ # either as a single IPv4/IPv6 or with a subnet specification. # NOTE: opening up the RPC port to hosts outside your local trusted network is NOT RECOMMENDED, -# because the rpcpassword is transmitted over the network unencrypted. +# because the rpcpassword is transmitted over the network unencrypted and also because anyone +# that can authenticate on the RPC port can steal your keys + take over the account running zcashd +# For more information see https://github.com/zcash/zcash/issues/1497 #rpcallowip=10.1.1.34/255.255.255.0 #rpcallowip=1.2.3.4/24 @@ -107,8 +109,8 @@ # Send transactions as zero-fee transactions if possible (default: 0) #sendfreetransactions=0 -# Create transactions that have enough fees (or priority) so they are likely to begin confirmation within n blocks (default: 1). -# This setting is over-ridden by the -paytxfee option. +# Create transactions that have enough fees (or priority) so they are likely to # begin confirmation within n blocks (default: 1). +# This setting is overridden by the -paytxfee option. #txconfirmtarget=n # Miscellaneous options @@ -125,7 +127,8 @@ # Pay an optional transaction fee every time you send zcash. Transactions with fees # are more likely than free transactions to be included in generated blocks, so may -# be validated sooner. +# be validated sooner. This setting does not affect private transactions created with +# 'z_sendmany'. #paytxfee=0.00 From d79ef011c1d87e05989e1014f186738df55dcd7a Mon Sep 17 00:00:00 2001 From: Daira Hopwood Date: Wed, 26 Oct 2016 03:18:32 +0100 Subject: [PATCH 4/4] Tweak descriptions of mining parameters for example zcash.conf. Signed-off-by: Daira Hopwood --- contrib/DEBIAN/examples/zcash.conf | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/contrib/DEBIAN/examples/zcash.conf b/contrib/DEBIAN/examples/zcash.conf index 1d6d27acd..e9935a872 100644 --- a/contrib/DEBIAN/examples/zcash.conf +++ b/contrib/DEBIAN/examples/zcash.conf @@ -115,10 +115,14 @@ # Miscellaneous options -# Enable attempt to generate zcash. -#gen=1 +# Enable attempt to mine zcash. +#gen=0 -# Enable use of a different Equihash solver to try to generate zcash faster. +# Set the number of threads to be used for mining zcash (-1 = all cores). +#genproclimit=1 + +# Specify a different Equihash solver (e.g. "tromp") to try to mine zcash +# faster when gen=1. #equihashsolver=default # Pre-generate this many public/private key pairs, so wallet backups will be valid for