IOP Hydra Core

Table of Contents

• Maintainers
• Introduction
• Changelog
• Contributing
• Documentation
  • Developing IoP Hydra Core
    • Prerequisites
    • Cloning & Setup for hydra-core repo
• Credits
• License

Maintainers

• mudlee
• wigy
• bartmoss

Introduction

This repository contains the code for the IOP Hydra Blockchain. The IOP Hydra Blockchain is an ARK bridgechain and follows upstream changes as closely as possible. Changes to naming schemes, documentation and other auxiliary files are thus kept to a minimum. If you want to learn more about the code, check out the original code base at @ARKEcosystem.

Changelog

Below we describe what were the changes we made release by release compared to the original Ark code.

2.7.24+p9

• Use new hydraledger.tech domain.

2.7.24+p8

• Remove transaction asset's size limit
• Add transaction length limit

2.7.24+p7

• Upgraded SSI/DNS plugin to 5.0.4

2.7.24+p6

• Upgraded SSI/DNS plugin to 5.0.2

2.7.24+p5

• Upgraded SSI/DNS plugin to 5.0.1

2.7.24+p4

• Upgraded SSI/DNS plugin to 5.0.0

2.7.24+p3

• Fixed: snapshot restore

2.7.24+p2

• Upgraded SSI/DNS plugin to 4.0.6

2.7.24+p1

• Upgraded Hydra Core to 2.7.24

2.6.31+p3

• IOP SSI updated to 4.0.2
• Introduced IOP DNS (project Coeus).

2.6.31+p2

• IOP SSI updated to 3.1.0

2.6.31+p1

• IOP SSI updated to 2.0.6
• Rate limiter settings changed
• Wallet API emits event when started

2.6.31

• Hydra Core updated to 2.6.31 (jemalloc can now be used as a default memory manager)
• Jemalloc is used by the Docker images
• IOP SSI updated to 2.0.5

2.6.10

• IOP SSI added as a submodule (hence plugins.js config files were updated as well)
• Custom Docker scripts and images are updated
• Fix: During BlockApplied and BlockReverted events the block's data must contain the transactions:
  • at: https://github.com/ArkEcosystem/core/blob/master/packages/core-database/src/database-service.ts#L92
  • and: https://github.com/ArkEcosystem/core/blob/master/packages/core-database/src/database-service.ts#L448

Important Notes

This is a mandatory upgrade. To be able to use Hydra, you must upgrade your plugins.js file in order to be part of the consensus.

Core Controller

If you are using core-controler, we have now there a develop and soon a master branch where you can read how you can upgrade your code.

Docker

If you are using Docker, we provide a mountpoints.tar.gz file for each network which you can unpack (and overwrite) as it's described in our Docker documentation.

2.5.9

• Custom Docker scripts added
• Chain network (p2p, api, webhook ports), config (database password/user/dbname, peers, delegates) and crypto (milestones, exceptions, genesis block, network) parameters are changed
• Added a delegate guide
• Fix: Removed genesis block hacking from https://github.com/ArkEcosystem/core/blob/master/packages/crypto/src/blocks/block.ts#L100

Contributing

PRs that are inline with our goals to the core IOP user experience are more than welcome. To avoid losing precious time you spend on coding, you could open an issue first and discuss what you are up to before forking and sending us a PR.

Small note: If editing the README, please conform to the standard-readme specification.

Documentation

Please visit our Developer Portal.

Developing IOP Hydra Core Locally

In the following section we help you to setup a local testnet where you update Hydra Core's code and test locally with a testnet setup.

Prerequisites

The following packages are required before you clone this repository.

1. Nodejs
2. Git
3. Docker
4. Docker Compose
5. Yarn

Step 1. Clone & Setup hydra-core Repo

# Clone the hydra core repo.
$ git clone git@github.com:Internet-of-People/hydra-core.git
$ cd hydra-core

# Install Python 2 if you don't have it, due to this bug: https://github.com/JoshuaWise/better-sqlite3/issues/310

# On Ubuntu
$ sudo apt install python2

# Move into the repo and run setup. `setup` hook will install all necessary Javascript dependencies to get you up and running with Hydra core.
$ yarn setup

Step 2. Start PostgreSQL via Docker

$ docker run -it --rm --name postgres-hydra -p 5432:5432 -e POSTGRES_DB=hydra_testnet -e POSTGRES_USER=hydra -e POSTGRES_PASSWORD=password postgres:11-alpine

Step 3. Start Hydra Core

# Reset/Create the config
$ ./packages/core/bin/run config:reset --network=testnet

# Start a local testnet
$ ./packages/core/bin/run core:run --network=testnet --ignoreMinimumNetworkReach --networkStart --env=test

Credits

This project exists thanks to all the people who contribute.

License

Ark Core is released under the MIT © ARK Ecosystem Changes for IOP Hydra are released under the MIT © 2020 Decentralized Society Foundation PA