CampusCash [CCASH] 2020
What is the CampusCash [CCASH] Blockchain?
TODO: Update documentation regarding implemented tech as this section is out of date and much progress and upgrades have been made to mentioned sections...
CampusCash is a blockchain project with the goal of creating a blockchain for the student, one where your degrees are stored on the blockchain and can be validated by employers by the pubkey that sent you the degree.
The CampusCash [CCASH] Blockchain is an experimental smart contract platform that enables instant payments to anyone, anywhere in the world in a private, secure manner. CampusCash [CCASH] uses peer-to-peer blockchain technology developed by CryptoCoderz and SaltineChips to operate with no central authority: managing transactions, execution of contracts, and issuing money are carried out collectively by the network.
Custom Difficulty Retarget Algorithm “VRX”
VRX is designed from the ground up to integrate properly with the Velocity parameter enforcement system to ensure users no longer receive orphan blocks.
Velocity Block Constraint System
Ensuring CampusCash stays as secure and robust as possible, we have implemented what's known as the Velocity block constraint system (developed by CryptoCoderz & SaltineChips). This system acts as a third and final check for both mined and peer-accepted blocks, ensuring that all parameters are strictly enforced.
Wish (bmw512) Proof-of-Work Algorithm
Wish or bmw512 hashing algorithm is utilized for the Proof-of-Work function and also replaces much of the underlying codebase hashing functions as well that normally are SHA256. By doing so this codebase is able to be both exponentially lighter and more secure in comparison to reference implementations.
Specifications and General info
libsecp256k1, libgmp, Boost1.68, OR Boost1.58, Openssl1.02r, Berkeley DB 6.2.32, QT5.12.1, to compile
Block Spacing: 1 Minute +- 30 seconds Stake Minimum Age: 15 Confirmations (PoS-v3) | 30 Minutes (PoS-v2) Port: 19427 RPC Port: 18695
Compiling CampusCash "SatoshiCore" daemon on Ubunutu 18.04 LTS Bionic
Note: guide should be compatible with other Ubuntu versions from 14.04+
CREATE SWAP FILE FOR DAEMON BUILD (if system has less than 2GB of RAM)
cd ~; sudo fallocate -l 3G /swapfile; ls -lh /swapfile; sudo chmod 600 /swapfile; ls -lh /swapfile; sudo mkswap /swapfile; sudo swapon /swapfile; sudo swapon --show; sudo cp /etc/fstab /etc/fstab.bak; echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
cd ~; sudo apt-get install -y ntp git build-essential libssl-dev libdb-dev libdb++-dev libboost-all-dev libqrencode-dev libcurl4-openssl-dev curl libzip-dev; apt-get update -y; apt-get install -y git make automake build-essential libboost-all-dev; apt-get install -y yasm binutils libcurl4-openssl-dev openssl libssl-dev; sudo apt-get install -y libgmp-dev; sudo apt-get install -y libtool; sudo apt-get install qt5-default; sudo apt-get install qttools5-dev-tools;
Dependencies build and link
cd ~; wget http://download.oracle.com/berkeley-db/db-6.2.32.NC.tar.gz; tar zxf db-6.2.32.NC.tar.gz; cd db-6.2.32.NC/build_unix; ../dist/configure --enable-cxx --disable-shared; make; sudo make install; sudo ln -s /usr/local/BerkeleyDB.6.2/lib/libdb-6.2.so /usr/lib/libdb-6.2.so; sudo ln -s /usr/local/BerkeleyDB.6.2/lib/libdb_cxx-6.2.so /usr/lib/libdb_cxx-6.2.so; export BDB_INCLUDE_PATH="/usr/local/BerkeleyDB.6.2/include"; export BDB_LIB_PATH="/usr/local/BerkeleyDB.6.2/lib"
GitHub pull (Source Download)
cd ~; git clone https://github.com/CampusCash/CampusCash_Core CampusCash
Build CampusCash daemon
cd ~; cd ~/CampusCash/src; chmod a+x obj; chmod a+x leveldb/build_detect_platform; chmod a+x secp256k1; chmod a+x leveldb; chmod a+x ~/CampusCash/src; chmod a+x ~/CampusCash; make -f makefile.unix USE_UPNP=-; cd ~; cp -r ~/CampusCash/src/CampusCashd /usr/local/bin/CampusCashd;
(Optional) Build CampusCash-QT (GUI wallet) on Linux
All previous steps must be completed first.
If you recompiling some other time you don't have to repeat previous steps, but need to define those variables. Skip this command if this is your first build and previous steps were performed in current terminal session.
export BDB_INCLUDE_PATH="/usr/local/BerkeleyDB.6.2/include"; export BDB_LIB_PATH="/usr/local/BerkeleyDB.6.2/lib"
cd ~; cd ~/CampusCash; qmake -qt=qt5; make
Recommended Without UPNP:
cd ~; cd ~/CampusCash; qmake -qt=qt5 USE_UPNP=-; make
Create config file for daemon
cd ~; sudo ufw allow 19427/tcp; sudo ufw allow 18695/tcp; sudo ufw allow 22/tcp; sudo mkdir ~/.CCASH; cat << "CONFIG" >> ~/.CCASH/CampusCash.conf listen=1 server=1 daemon=1 testnet=0 rpcuser=CCASHrpcuser rpcpassword=SomeCrazyVeryVerySecurePasswordHere rpcport=18695 port=19427 rpcconnect=127.0.0.1 rpcallowip=127.0.0.1 addnode=220.127.116.11 addnode=18.104.22.168:19427 addnode=22.214.171.124 addnode=126.96.36.199:19427 addnode=192.168.1.14 addnode=192.168.1.14:19427 addnode=188.8.131.52 addnode=184.108.40.206:19427 addnode=220.127.116.11 addnode=18.104.22.168:19427 addnode=22.214.171.124 addnode=126.96.36.199:19427 addnode=188.8.131.52 addnode=184.108.40.206:19427 addnode=220.127.116.11 addnode=18.104.22.168:19427 addnode=22.214.171.124 addnode=126.96.36.199:19427 addnode=188.8.131.52 addnode=184.108.40.206:19427 addnode=220.127.116.11 addnode=18.104.22.168:19427 addnode=22.214.171.124 addnode=126.96.36.199:19427 addnode=188.8.131.52 addnode=184.108.40.206:19427 addnode=220.127.116.11 addnode=18.104.22.168:19427 CONFIG chmod 700 ~/.CCASH/CampusCash.conf; chmod 700 ~/.CCASH; ls -la ~/.CCASH
Run CampusCash daemon
cd ~; CampusCashd; CampusCashd getinfo
for basic troubleshooting run the following commands when compiling:
this is for minupnpc errors compiling
make clean -f makefile.unix USE_UPNP=- make -f makefile.unix USE_UPNP=-
Updating daemon in bin directory
cd ~; cp -r ~/CampusCash/src/CampusCashd /usr/local/bin
master branch is regularly built and tested, but is not guaranteed to be
completely stable. Tags are created
regularly to indicate new official, stable release versions of CampusCash [CCASH].
The contribution workflow is described in CONTRIBUTING.md.
The developer mailing list should be used to discuss complicated or controversial changes before working on a patch set.
Developer Discord can be found at https://discord.gg/Jp2ujYH.
Testing and code review is the bottleneck for development; we get more pull requests than we can review and test on short notice. Please be patient and help out by testing other people's pull requests, and remember this is a security-critical project where any mistake might cost people lots of money.
Developers are strongly encouraged to write unit tests for new code, and to
submit new unit tests for old code. Unit tests can be compiled and run
(assuming they weren't disabled in configure) with:
There are also regression and integration tests of the RPC interface, written in Python, that are run automatically on the build server.
Manual Quality Assurance (QA) Testing
Changes should be tested by somebody other than the developer who wrote the code. This is especially important for large or high-risk changes. It is useful to add a test plan to the pull request description if testing the changes is not straightforward.