README.md

   1 ## VerusCoin version 0.3.12-beta
   2 VerusCoin is a new, mineable and stakeable cryptocurrency. It is a live fork of Komodo that retains its Zcash lineage and improves it. VerusCoin will leverage the Komodo platform and dPoW notarization for enhanced security and cross-chain interoperability. We have added a variation of a zawy12, lwma difficulty algorithm, a new CPU-optimized hash algorithm and a new algorithm for fair proof of stake. We describe these changes and vision going forward in a [our Phase I white paper](http://185.25.51.16/papers/VerusPhaseI.pdf) and [our Vision](http://185.25.51.16/papers/VerusVision.pdf).
   3 - [VerusCoin web site https://veruscoin.io/ Wallets and CLI tools](https://veruscoin.io/)
   4 - [VerusCoin Explorer](https://explorer.veruscoin.io/)
   5
   6 Version 0.3.12-beta has portable mining working.
   7
   8 ## Komodo with Bitcore
   9 This version of Komodo contains Bitcore support for komodo and all its assetchains.
  10
  11 ## Komodod
  12 This software is the VerusCoin enhanced Komodo client. Generally, you will use this if you want to mine VRSC or setup a full node. When you run the wallet it launches komodod automatically. On first launch it downloads Zcash parameters, roughly 1GB, which is mildly slow.
  13 The wallet downloads and stores the block chain or asset chain of the coin you select. It downloads and stores the entire history of the coins transactions; depending on the speed of your computer and network connection, the synchronization process could take a day or more once the blockchain has reached a significant size.
  14
  15 ## Development Resources
  16 - VerusCoin:[https://veruscoin.io/](https://veruscoin.io/) Wallets and CLI tools
  17 - Komodo Web: [https://komodoplatform.com/](https://komodoplatform.com/)
  18 - Organization web: [https://komodoplatform.com/](https://komodoplatform.com/)
  19 - Forum: [https://forum.komodoplatform.com/](https://forum.komodoplatform.com/)
  20 - Mail: [[email protected]](mailto:[email protected])
  21 - Support: [https://support.komodoplatform.com/support/home](https://support.komodoplatform.com/support/home)
  22 - Knowledgebase & How-to: [https://komodoplatform.atlassian.net/wiki/spaces/KPSD/pages](https://komodoplatform.atlassian.net/wiki/spaces/KPSD/pages)
  23 - API references: [http://docs.supernet.org/](http://docs.supernet.org/) #Not up to date.
  24 - Whitepaper: [Komodo Whitepaper](https://komodoplatform.com/wp-content/uploads/2018/06/Komodo-Whitepaper-June-3.pdf)
  25 - Komodo Platform public material: [Komodo Platform public material](https://docs.google.com/document/d/1AbhWrtagu4vYdkl-vsWz-HSNyNvK-W-ZasHCqe7CZy0)
  26
  27 ## List of Komodo Platform Technologies
  28 - Delayed Proof of Work (dPoW) - Additional security layer.
  29 - zk-SNARKs - Komodo Platform's privacy technology
  30 - Jumblr - Decentralized tumbler for KMD and other cryptocurrencies
  31 - Assetchains - Easy way to fork Komodo coin
  32 - Pegged Assets - Chains that maintain a peg to fiat currencies
  33 - Peerchains - Scalability solution where sibling chains form a network of blockchains
  34 - More in depth covered [here](https://docs.google.com/document/d/1AbhWrtagu4vYdkl-vsWz-HSNyNvK-W-ZasHCqe7CZy0)
  35 - Also note you receive 5% APR on your holdings.
  36 [See this article for more details](https://komodoplatform.atlassian.net/wiki/spaces/KPSD/pages/20480015/Claim+KMD+Interest+in+Agama)
  37
  38 ## Tech Specification
  39 - Max Supply: 200 million KMD.
  40 - Block Time: 1M 2s
  41 - Block Reward: 3KMD
  42 - Mining Algorithm: Equihash
  43
  44 ## About this Project
  45 Komodo is based on Zcash and has been  by our innovative consensus algorithm called dPoW which utilizes Bitcoin's hashrate to store Komodo blockchain information into the Bitcoin blockchain. Other new and native Komodo features are the privacy technology called JUMBLR or our assetchain capabilities (one click plug and play blockchain solutions). More details are available under https://komodoplatform.com/.
  46
  47 ## Getting started
  48 Dependencies
  49 ------------
  50
  51 ```shell
  52 #The following packages are needed:
  53 sudo apt-get install build-essential pkg-config libc6-dev m4 g++-multilib autoconf libtool ncurses-dev unzip git python python-zmq zlib1g-dev wget libcurl4-openssl-dev bsdmainutils automake curl
  54 ```
  55
  56
  57 Building
  58 --------
  59
  60 First time you'll need to get assorted startup values downloaded. This takes a moderate amount of time once but then does not need to be repeated unless you bring a new system up. The command is:
  61 ```
  62 ./zcutil/fetch-params.sh
  63 ```
  64 Building for Ubunutu/Mint:
  65 ```
  66 ./zcutil/build.sh
  67 ```
  68 Building for Mac OS/X (see README-MAC.md):
  69 ```
  70 ./zcutil/build-mac.sh
  71 ```
  72 Building for Windows:
  73 ```
  74 ./zcutil/build-win.sh
  75 ```
  76 VerusCoin
  77 ------
  78 We develop on dev and some other branches and produce releases of of the master branch, using pull requests to manage what goes into master.
  79
  80
  81 ```shell
  82 git clone https://github.com/VerusCoin/VerusCoin
  83 cd VerusCoin
  84 #you might want to: git checkout <branch>; git pull
  85 ./zcutil/fetch-params.sh
  86 # -j8 uses 8 threads - replace 8 with number of threads you want to use
  87 ./zcutil/build.sh -j8
  88 #This can take some time.
  89 ```
  90
  91 **The VerusCoin enhanced komodo is experimental and a work-in-progress.** Use at your own risk.
  92
  93
  94 #To view komodod output:
  95 tail -f ~/.komodo/debug.log
  96 #To view VRSC output:
  97 tail -f ~/.komodo/VRSC/debug.log
  98 Note that this directory is correct for Linux, not Mac or Windows
  99 #To view all command
 100 ./src/komodo-cli help
 101 **Zcash is unfinished and highly experimental.** Use at your own risk.
 102
 103 Where do I begin?
 104 -----------------
 105 We have a guide for joining the main Zcash network:
 106 https://github.com/zcash/zcash/wiki/1.0-User-Guide
 107
 108 #Older Komodo Details
 109 The remaining text is from the komodo source we forked when creating VerusCoin/Veruscoin.
 110 **To change modes:**
 111
 112 a) backup all privkeys (launch komodod with `-exportdir=<path>` and `dumpwallet`)
 113
 114 b) start a totally new sync including `wallet.dat`, launch with same `exportdir`
 115
 116 c) stop it before it gets too far and import all the privkeys from a) using `komodo-cli importwallet filename`
 117
 118 d) resume sync till it gets to chaintip
 119
 120 For example:
 121 ```shell
 122 ./komodod -exportdir=/tmp &
 123 ./komodo-cli dumpwallet example
 124 ./komodo-cli stop
 125 mv ~/.komodo ~/.komodo.old && mkdir ~/.komodo && cp ~/.komodo.old/komodo.conf ~/.komodo.old/peers.dat ~/.komodo
 126 ./komodod -exchange -exportdir=/tmp &
 127 ./komodo-cli importwallet /tmp/example
 128 ```
 129
 130 ## JUMBLR
 131 komodod now has `jumblr_deposit` and `jumblr_secret` RPC calls.
 132
 133 Jumblr works like described previously where all the nodes with jumblr active synchronize their tx activity during the same block to maximize the mixing effect. However, unlike all other mixers/tumblers, you never give up control of your coins to anybody else. JUMBLR uses a one to many allocation of funds, ie. one deposit address and many secret addresses. You can always run multiple komodod daemons to get multiple active deposit addresses.
 134
 135 JUMBLR implements t -> z, z -> z and z -> t transactions to maximize privacy of the destination t (transparent) address. So while it is transparent, its first activity is funds coming from an untracable z address.
 136
 137 Which of the three stages is done is randomly selected at each turn. Also when there is more than one possible transaction at the selected stage, a random one is selected. This randomization prevents analyzing incoming z ->t transactions by its size to correlate it to the originating address.
 138
 139 `jumblr_deposit <depositaddr>` designates the deposit address as the jumblr deposit address for that session. You can select an address that already has funds in it and it will immediately start jumblr process. If there are no funds, it will wait until you send funds to it.
 140
 141 There are three sizes of a jumblr transaction: 10 KMD, 100 KMD and 1000 KMD. There is also a fixed interval of blocks where all jumblr nodes are active. Currently it is set to be 10, but this is subject to change. Only during every 10*10 blocks are the largest 1000 KMD transactions processed, so this concentrates all the large transactions every N*N blocks.
 142
 143 `jumblr_secret <secretaddress>` notifies JUMBLR where to send the final z -> t transactions. In order to allow larger accounts to obtain privacy, up to 777 secret addresses are supported. Whenever a z -> t stage is activated, a random secret address from the list of the then active secret addresses is selected.
 144
 145 #### Practical Advice:
 146 Obtaining privacy used to be very difficult. JUMBLR makes it as simple as issuing two command line calls. Higher level layers can be added to help manage the addresses, ie. linking them at the passphrase level. Such matters are left to each implementation.
 147
 148 Once obtained, it is very easy to lose all the privacy. With a single errant transaction that combines some previously used address and the secretaddress, well, the secretaddress is no longer so private.
 149
 150 The advice is to setup a totally separate node!
 151
 152 This might seem a bit drastic, but if you want to maintain privacy, it is best to make it look like all the transactions are coming from a different node. The easiest way for most people to do this is to actually have a different node.
 153
 154 It can be a dedicated laptop (recommended) or a VPS (for smaller amounts) with a totally fresh komodod wallet. Generate an address on this wallet and use that as the jumblr_secret address on your main node. As the JUMBLR operates funds will teleport into your secret node's address. If you are careful and never use the same IP address for both your nodes, you will be able to maintain very good privacy.
 155
 156 Of course, don't send emails that link the two accounts together! Dont use secret address funds for home delivery purchases! Etc. There are many ways to lose the privacy, just think about what linkages can be dont at the IP and blockchain level and that should be a useful preparation.
 157
 158 What if you have 100,000 KMD and you dont want others to know you are such a whale?
 159 Instead of generating 1 secret address, generate 100 and make a script file with:
 160 ```shell
 161 ./komodo-cli jumblr_secret <addr0>
 162 ./komodo-cli jumblr_secret <addr1>
 163 ...
 164 ./komodo-cli jumblr_secret <addr99>
 165 ```
 166 And make sure to delete all traces of this when the JUMBLR is finished. You will end up with 100 addresses that have an average of 1000 KMD each. So as long as you are careful and dont do a 10,000 KMD transaction (that will link 10 of your secret addresses together), you can appear as 100 different people each with 1000 KMD.