hpcore/README.md

Hot Pocket Consensus Engine

What's here?

In development

A C++ version of hotpocket designed for production envrionments, original prototype here: https://github.com/codetsunami/hotpocket

Libraries

• Crypto - Libsodium https://github.com/jedisct1/libsodium
• Websockets - Boost|Beast https://github.com/boostorg/beast
• RapidJSON - http://rapidjson.org
• Protocol - https://github.com/protocolbuffers/protobuf

Steps to setup Hot Pocket

Install Libsodium

Instructions are based on this.

1. Download and extract Libsodium 1.0.18 from here.
2. Navigate to the extracted libsodium directory in a terminal.
3. Run ./configure
4. Run make && make check
5. Run sudo make install

Install Boost

Following Instructions are based on Boost getting started

1. Download and extract boost 1.71 package from here.
2. Navigate to the extracted boost directory in a terminal.
3. Run ./bootstrap.sh
4. Run sudo ./b2 install (This will compile and install boost libraries into your /usr/local/lib)

Install RapidJSON

1. Download and extract RapidJSON 1.1 source from here.
2. Navigate to the extracted directory.
3. Run sudo cp -r include/rapidjson /usr/local/include/

Install Protocol buffers

Instructions are based on this.

1. Download and extract Protobuf 3.10.0 from here.
2. Navigate to the extracted Protobuf directory in a terminal.
3. Run ./configure
4. Run make && make check
5. Run sudo make install

Compile Protocol buffers

1. Run protoc -I=./src/p2p --cpp_out=./src/p2p ./src/p2p/message.proto Ex - For message protobuf protoc -I=./src/p2p --cpp_out=./src/p2p ./src/p2p/message.proto

Run ldconfig

1. Run sudo ldconfig

This will update your library cache and avoid potential issues when running your compiled C++ program which links to newly installed libraries.

Build and run Hot Pocket

1. navigate to hotpocket repo root.
2. Run make
3. Run ./build/hpcore new ~/mycontract. This will initialize a new contract directory mycontract in your home directory.
4. Take a look at ~/mycontract/cfg/hp.cfg. This is your new contract config file. You can modify it according to your contract hosting requirements.
5. Optional: Run ./build/hpcore rekey ~/mycontract to generate new public/private key pair.
6. Run ./build/hpcore run ~/mycontract to run your smart contract (to do).