README.md

   1 ## VerusCoin version 0.4.0b
   2
   3 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).
   4 - [VerusCoin web site https://veruscoin.io/ Wallets and CLI tools](https://veruscoin.io/)
   5 - [VerusCoin Explorer](https://explorer.veruscoin.io/)
   6
   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.komodoplatform.com/](http://docs.komodoplatform.com/)
  24 - Blog: [http://blog.komodoplatform.com/](http://blog.komodoplatform.com/)
  25 - Whitepaper: [Komodo Whitepaper](https://komodoplatform.com/wp-content/uploads/2018/03/2018-03-12-Komodo-White-Paper-Full.pdf)
  26 - Komodo Platform public material: [Komodo Platform public material](https://docs.google.com/document/d/1AbhWrtagu4vYdkl-vsWz-HSNyNvK-W-ZasHCqe7CZy0)
  27
  28 ## List of Komodo Platform Technologies
  29
  30 - Delayed Proof of Work (dPoW) - Additional security layer and Komodos own consensus algorithm.
  31 - zk-SNARKs - Komodo Platform's privacy technology for shielded transactions
  32 - Tokens/Assets Technology - create "colored coins" on the Komodo Platform and use them as a layer for securites
  33 - Reward API - Komodo CC technology for securities
  34 - CC - Crypto Conditions to realize "smart contract" logic on top of the Komodo Platform
  35 - Jumblr - Decentralized tumbler for KMD and other cryptocurrencies
  36 - Assetchains - Create your own Blockchain that inherits all Komodo Platform functionalities and blockchain interoperability
  37 - Pegged Assets - Chains that maintain a peg to fiat currencies
  38 - Peerchains - Scalability solution where sibling chains form a network of blockchains
  39 - More in depth covered [here](https://docs.google.com/document/d/1AbhWrtagu4vYdkl-vsWz-HSNyNvK-W-ZasHCqe7CZy0)
  40 - Also note you receive 5% APR on your holdings.
  41 [See this article for more details](https://komodoplatform.atlassian.net/wiki/spaces/KPSD/pages/20480015/Claim+KMD+Interest+in+Agama)
  42
  43 ## Tech Specification
  44 - Max Supply: 200 million KMD.
  45 - Block Time: 1M 2s
  46 - Block Reward: 3KMD
  47 - Mining Algorithm: Equihash
  48
  49 ## About this Project
  50 Komodo is based on Zcash and has been extended 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, our assetchain capabilities (one click plug and play blockchain solutions) and a set of financial decentralization and interoperability technologies. More details are available under https://komodoplatform.com/ and https://blog.komodoplatform.com.
  51
  52 ## Getting started
  53
  54 ### Dependencies
  55
  56 ```shell
  57 #The following packages are needed:
  58 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-gnutls-dev bsdmainutils automake curl
  59 ```
  60
  61
  62 Building
  63 --------
  64
  65 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:
  66 ```
  67 ./zcutil/fetch-params.sh
  68 ```
  69 Building for Ubunutu/Mint:
  70 ```
  71 ./zcutil/build.sh
  72 ```
  73 Building for Mac OS/X (see README-MAC.md):
  74 ```
  75 ./zcutil/build-mac.sh
  76 ```
  77 Building for Windows:
  78 ```
  79 ./zcutil/build-win.sh
  80 ```
  81 VerusCoin
  82 ------
  83 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. The dev branch is considered the bleeding edge codebase, and may even be oncompatible from time to time, while the master-branch is considered tested (unit tests, runtime tests, functionality). At no point of time do the Komodo Platform developers or Verus Developers take any responsbility for any damage out of the usage of this software.
  84
  85 Verus builds for all operating systems out of the same codebase. Follow the OS specific instructions from below.
  86
  87 #### Linux
  88 ```shell
  89 git clone https://github.com/VerusCoin/VerusCoin
  90 cd VerusCoin
  91 #you might want to: git checkout <branch>; git pull
  92 ./zcutil/fetch-params.sh
  93 # -j8 = using 8 threads for the compilation - replace 8 with number of threads you want to use
  94 ./zcutil/build.sh -j8
  95 #This can take some time.
  96 ```
  97
  98 **The VerusCoin enhanced komodo is experimental and a work-in-progress.** Use at your own risk.
  99
 100
 101 #To view komodod output:
 102 tail -f ~/.komodo/debug.log
 103 #To view VRSC output:
 104 tail -f ~/.komodo/VRSC/debug.log
 105 Note that this directory is correct for Linux, not Mac or Windows
 106 #To view all command
 107 ./src/komodo-cli help
 108 **Zcash is unfinished and highly experimental.** Use at your own risk.
 109
 110 ####  :ledger: Deprecation Policy
 111
 112 This release is considered deprecated 16 weeks after the release day. There
 113 is an automatic deprecation shutdown feature which will halt the node some
 114 time after this 16 week time period. The automatic feature is based on block
 115 height.
 116
 117 #Older Komodo Details
 118 The remaining text is from the komodo source we forked when creating VerusCoin/Veruscoin.
 119
 120 **To change modes:**
 121
 122 a) backup all privkeys (launch komodod with `-exportdir=<path>` and `dumpwallet`)
 123 b) start a totally new sync including `wallet.dat`, launch with same `exportdir`
 124 c) stop it before it gets too far and import all the privkeys from a) using `komodo-cli importwallet filename`
 125 d) resume sync till it gets to chaintip
 126
 127 For example:
 128 ```shell
 129 ./verusd -exportdir=/tmp &
 130 ./verus dumpwallet example
 131 ./verus stop
 132 mv ~/.komodo/VRSC ~/.komodo/VRSC.old && mkdir ~/.komodo/VRSC && cp ~/.komodo/VRSC.old/VRSC.conf ~/.komodo/VRSC.old/peers.dat ~/.komodo/VRSC
 133 ./verusd -exchange -exportdir=/tmp &
 134 ./verus importwallet /tmp/example
 135 ```
 136 ---
 137
 138
 139 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 140
 141 The above copyright notices and this permission notice shall be included in all copies or substantial portions of the Software.
 142
 143 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.