Repository files navigation

Copyright (c) 2017 Credits Developers

• Coin Suffix: CRDS
• PoW Mining Algorithm: Argon2d
• PoW Difficulty Algorithm: DELTA
• PoW Period: ~36 years
• PoW Target Spacing: 128 Seconds
• PoW Reward per Block: See Below
• Maturity: 10 Blocks
• PoW Blocks: ~675 per day
• Masternode Collateral Amount: 500 CRDS
• Masternode Min Confirmation: 16 Blocks
• Masternode Reward: See Below
• Total Coins: 95,000,000 (~36 Years)
• Min TX Fee: 0.0001 CRDS

Credits uses peer-to-peer technology to operate securly with no central authority (decentralisation): managing transactions and issuing currency (CRDS) are carried out collectively by the Credits network. Credits is the name of open source software which enables the use of the currency CRDS.

Credits utilises Masternodes, Privatesend and InstantSend to provide anonymous and near instant transaction confirmations.

Credits implements Gavin Andresens signature cache optimisation from Bitcoin for significantly faster transaction validation.

Masternode/Privatesend Network InformationUtilisation of InstantSend for near-instant transactions and PrivateSend for anonymous transactions.

MainNet ParametersP2P Port = 31000RPC Port = 31050Masternodes = 31000Magic Bytes: 0x3f 0x42 0x55 0x61

TestNet ParametersP2P Port = 31400RPC Port = 31450Masternodes = 31400Magic Bytes: 0x2f 0x32 0x15 0x40

RegTest ParametersP2P Port = 31500RPC Port = 31550Masternodes = 31500Magic Bytes = 0x2f 0x32 0x15 0x3f

Rewards Structure

Some notes on how to build Credits in Unix.

Always use absolute paths to configure and compile Credits and the dependencies,for example, when specifying the the path of the dependency:

../dist/configure --enable-cxx --disable-shared --with-pic --prefix=$BDB_PREFIX

Here BDB_PREFIX must absolute path - it is defined using $(pwd) which ensuresthe usage of the absolute path.

./autogen.sh./configuremakemake install# optional

This will build credits-qt as well if the dependencies are met.

These dependencies are required:

Optional dependencies:

For the versions used in the release, seerelease-process.md underFetch and build inputs.

C++ compilers are memory-hungry. It is recommended to have at least 3 GB ofmemory available when compiling Credits.

Build requirements:

sudo apt-get install build-essential libtool automake autotools-dev autoconf pkg-config libssl-dev libcrypto++-dev libevent-dev git

for Ubuntu 12.04 and later or Debian 7 and later libboost-all-dev has to be installed:

sudo apt-get install libboost-all-dev

db4.8 packages are availablehere.You can add the repository using the following command:

    sudo add-apt-repository ppa:bitcoin/bitcoin    sudo apt-get update

Ubuntu 12.04 and later have packages for libdb5.1-dev and libdb5.1++-dev,but using these will break binary wallet compatibility, and is not recommended.

for Debian 7 (Wheezy) and later:The oldstable repository contains db4.8 packages.Add the following line to /etc/apt/sources.list,replacing [mirror] with any official debian mirror.

deb http://[mirror]/debian/ oldstable main

To enable the change run

sudo apt-get update

for other Debian & Ubuntu (with ppa):

sudo apt-get install libdb4.8-dev libdb4.8++-dev

Optional (see --with-miniupnpc and --enable-upnp-default):

sudo apt-get install libminiupnpc-dev

ZMQ dependencies (provides ZMQ API 4.x):

    sudo apt-get install libzmq3-dev

If you want to build Credits-Qt, make sure that the required packages for Qt developmentare installed. Qt 5 is necessary to build the GUI.If both Qt 4 and Qt 5 are installed, Qt 5 will be used. Pass--with-gui=qt5 to configure to choose Qt5.To build without GUI pass--without-gui.

For Qt 5 you need the following:

sudo apt-get install libqt5gui5 libqt5core5a libqt5dbus5 qttools5-dev qttools5-dev-tools libprotobuf-dev protobuf-compiler libcrypto++-dev

libqrencode (optional) can be installed with:

sudo apt-get install libqrencode-dev

Once these are installed, they will be found by configure and a credits-qt executable will bebuilt by default.

The release is built with GCC and then "strip creditsd" to strip the debugsymbols, which reduces the executable size by about 90%.

miniupnpc may be used for UPnP port mapping. It can be downloaded fromhere. UPnP support is compiled in andturned off by default. See the configure options for upnp behavior desired:

--without-miniupnpc      No UPnP support miniupnp not required--disable-upnp-default   (the default) UPnP support turned off by default at runtime--enable-upnp-default    UPnP support turned on by default at runtime

To build:

tar -xzvf miniupnpc-1.6.tar.gzcd miniupnpc-1.6makesudo sumake install

It is recommended to use Berkeley DB 4.8. If you have to build it yourself:

CREDITS_ROOT=$(pwd)# Pick some path to install BDB to, here we create a directory within the credits directoryBDB_PREFIX="${CREDITS_ROOT}/db4"mkdir -p$BDB_PREFIX# Fetch the source and verify that it is not tampered withwget'http://download.oracle.com/berkeley-db/db-4.8.30.NC.tar.gz'echo'12edc0df75bf9abd7f82f821795bcee50f42cb2e5f76a6a281b85732798364ef  db-4.8.30.NC.tar.gz'| sha256sum -c# -> db-4.8.30.NC.tar.gz: OKtar -xzvf db-4.8.30.NC.tar.gz# Build the library and install to our prefixcd db-4.8.30.NC/build_unix/#  Note: Do a static build so that it can be embedded into the exectuable, instead of having to find a .so at runtime../dist/configure --prefix=/usr/local --enable-cxxmake sudo make install# Configure Credits to use our own-built instance of BDBcd$CREDITS_ROOT./configure (other args...) LDFLAGS="-L${BDB_PREFIX}/lib/" CPPFLAGS="-I${BDB_PREFIX}/include/"

Note: You only need Berkeley DB if the wallet is enabled (see the sectionDisable-Wallet mode below).

If you need to build Boost yourself:

sudo su./bootstrap.sh./bjam install

To help make your Credits installation more secure by making certain attacks impossible toexploit even if a vulnerability is found, binaries are hardened by default.This can be disabled with:

Hardening Flags:

./configure --enable-hardening./configure --disable-hardening

Hardening enables the following features:

• Position Independent ExecutableBuild position independent code to take advantage of Address Space Layout Randomizationoffered by some kernels. An attacker who is able to cause execution of code at an arbitrarymemory location is thwarted if he doesn't know where anything useful is located.The stack and heap are randomly located by default but this allows the code section to berandomly located as well.

  On an Amd64 processor where a library was not compiled with -fPIC, this will cause an errorsuch as: "relocation R_X86_64_32 against `......' can not be used when making a shared object;"

  To test that you have built PIE executable, install scanelf, part of paxutils, and use:

    scanelf -e ./creditsd

  The output should contain:TYPEET_DYN

• Non-executable StackIf the stack is executable then trivial stack based buffer overflow exploits are possible ifvulnerable buffers are found. By default, credits should be built with a non-executable stackbut if one of the libraries it uses asks for an executable stack or someone makes a mistakeand uses a compiler extension which requires an executable stack, it will silently build anexecutable without the non-executable stack protection.

  To verify that the stack is non-executable after compiling use:scanelf -e ./creditsd

  the output should contain:STK/REL/PTLRW- R-- RW-

  The STK RW- means that the stack is readable and writeable but not executable.

When the intention is to run only a P2P node without a wallet, credits may be compiled indisable-wallet mode with:

./configure --disable-wallet

In this case there is no dependency on Berkeley DB 4.8.

Mining is also possible in disable-wallet mode, but only using thegetblocktemplate RPC call.

For increased performance when mining, AVX2 optimisations can be enabled.

Prior to running the build commands:

CPPFLAGS=-march=native

CPU's with AVX2 support:

Intel    Haswell processor, Q2 2013    Haswell E processor, Q3 2014    Broadwell processor, Q4 2014    Broadwell E processor, Q3 2016    Skylake processor, Q3 2015    Kaby Lake processor, Q3 2016(ULV mobile)/Q1 2017(desktop/mobile)    Coffee Lake processor, expected in 2017    Cannonlake processor, expected in 2017AMD    Carrizo processor, Q2 2015    Ryzen processor, Q1 2017

Qt Wallet and Deamon, CLI version build:

./autogen.sh && ./configure --with-gui && make

CLI and Deamon Only Buld:

./autogen.sh && ./configure --without-gui && make