ARCHIVE/hpcore
1
0
Fork 0
mirror of https://github.com/EvernodeXRPL/hpcore.git synced 2026-04-29 15:37:59 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
61b38bb0a00da7b0fdb2c3979cb778812fd71dc2
hpcore/README.md
Asanka Indrajith 7ed1466ad9 p2p connection, message handling, validation and serialization (#38) 
Implement basic peer to peer connection establishment and maintenance.
Message serialization and parsing using FlatBuffer(Including defining message schema).
Validating incoming proposal messages.
2019-10-21 08:32:25 -04:00

3.7 KiB
Raw Blame History

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

Hot Pocket Wiki

Libraries

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 FlatBuffers

Instructions are based on this.

  1. Clone the git respository into a new directory from here.
  2. Build with CMake
git clone https://github.com/google/flatbuffers.git
cd flatbuffers
cmake -G "Unix Makefiles"
make
  1. Run sudo cp -r include/flatbuffers /usr/local/include/
  2. Run sudo snap install flatbuffers --edge
Compiling FlatBuffers message definitions

When you make a change to message.fbc defnition file, you need to run this:

flatc -o src/p2p/ --gen-mutable --cpp src/p2p/message.fbs

Run ldconfig

sudo ldconfig

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

Install CMAKE

If you use apt, run sudo apt install cmake or follow this.

Build and run Hot Pocket

  1. Navigate to hotpocket repo root.
  2. Run cmake . (You only have to do this once)
  3. Run make (Hot Pocket binary will be created as ./build/hpcore)
  4. Refer to Running Hot Pocket in the Wiki.

Refer to Hot Pocket Wiki for more info.

Code structure

Code is divided into subsystems via namespaces.

conf:: Handles contract configuration. Loads and holds the central configuration object. Used by most of the subsystems.

crypto:: Handles cryptographic activities. Wraps libsodium and offers convenience functions.

proc:: Handles contract process execution and managing user/SC I/O and npl I/O. Makes use of usr and p2p.

usr:: Handles user connections. Makes use of crypto and sock.

p2p:: Handles peer-to-peer connections and message exchange between nodes. Makes use of crypto and sock.

cons:: Handles consensus and proposal rounds. Makes use of usr, p2p and proc

sock:: Handles generic web sockets functionality. Mainly acts as a wrapper for boost/beast.

util:: Contains shared data structures/helper functions used by multiple subsystems.