Skip to content

PupaCoin/PupaCoin-Core

Repository files navigation

PupaCoin [PPCN] 2021 - 2023

http://pupacoin.com/

What is the PupaCoin [PPCN] Blockchain?

Overview

PupaCoin 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.

Blockchain Technology

The PupaCoin [PPCN] Blockchain is an experimental smart contract platform that enables instant payments to anyone, anywhere in the world in a private, secure manner. PupaCoin [PPCN] 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 PupaCoin 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

PupaCoin uses

libsecp256k1,
libgmp,
Boost1.73, OR Boost1.6,  
Openssl1.02u,
Berkeley DB 6.2.32,
QT5.14,
to compile

General Specs

Coin Name: PupaCoin
Ticker: PPCN
Block Spacing: 5 Minutes
Stake Minimum Age: 80 Confirmations (PoS-v3) | 6 Hours (PoS-v2)
PoW/PoS Reward: 1 PPCN (Per-block)
MasterNode Reward: 3.5 PPCN (Per-block)
DevOps Fees: 0.25 PPCN (Per-block)
Maximum Coin Count: 21 Million PPCN
Premine Coin Count: 14 Million PPCN (used for - Airdrop (mostly), Graphics, Coding, and operating costs)
Mineable/Mintable Coin Count: 7 Million PPCN
Port: 20205
RPC Port: 20083

BUILD LINUX

Compiling PupaCoin "SatoshiCore" daemon on Ubunutu 18.04 LTS Bionic

Note: guide should be compatible with other Ubuntu versions from 14.04+

Become poweruser

sudo -i

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

Dependencies install

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;

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/PupaCoin/PupaCoin-Core PupaCoin

Build PupaCoin daemon

cd ~; cd ~/PupaCoin/src; chmod a+x obj; chmod a+x leveldb/build_detect_platform; chmod a+x secp256k1; chmod a+x leveldb; chmod a+x ~/PupaCoin/src; chmod a+x ~/PupaCoin; make -f makefile.unix USE_UPNP=-; cd ~; cp -r ~/PupaCoin/src/PupaCoind /usr/local/bin/PupaCoind;

(Optional) Build PupaCoin-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"

With UPNP:

cd ~; cd ~/PupaCoin; qmake -qt=qt5; make

Recommended Without UPNP:

cd ~; cd ~/PupaCoin; qmake -qt=qt5 USE_UPNP=-; make

Create config file for daemon

cd ~; sudo ufw allow 20205/tcp; sudo ufw allow 20083/tcp; sudo ufw allow 22/tcp; sudo mkdir ~/.PPCN; cat << "CONFIG" >> ~/.PPCN/PupaCoin.conf
listen=1
server=1
daemon=1
testnet=0
rpcuser=PPCNrpcuser
rpcpassword=SomeCrazyVeryVerySecurePasswordHere
rpcport=20083
port=20205
rpcconnect=127.0.0.1
rpcallowip=127.0.0.1
addnode=143.198.232.91:20205
addnode=159.65.145.86:20205
CONFIG
chmod 700 ~/.PPCN/PupaCoin.conf; chmod 700 ~/.PPCN; ls -la ~/.PPCN

Run PupaCoin daemon

cd ~; PupaCoind; PupaCoind getinfo

Troubleshooting

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 ~/PupaCoin/src/PupaCoind /usr/local/bin

License

PupaCoin [PPCN] is released under the terms of the MIT license. See COPYING for more information or see https://opensource.org/licenses/MIT.

Development Process

The 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 PupaCoin [PPCN].

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

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.

Automated Testing

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: make check

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.