AmberChain

AmberChain is the blockchain implementation for the AmberTime platform. AmberTime blockchain is focused on providing a platform for education + travel applications.

AmberChain is based on the popular open source MultiChain, customized with a host of innovative features including new API calls, support for an ecommerce marketplace, automated escrow management, and additional transaction fee parameters.

Copyright (c) 2018 Apsaras Group Ltd
License: GNU General Public License version 3, see COPYING

Portions copyright (c) 2014-2017 Coin Sciences Ltd
Portions copyright (c) 2009-2016 The Bitcoin Core developers
Portions copyright many others - see individual files

Documentation

Details on the API calls developed for AmberTime Blockhain can be found here.

Setup instructions

Refer to the original multichain instructions here

Linux Build Notes (on Ubuntu 14.04 x64)

1. Clone the AmberChain repository on your local directory

   # if git is not installed
   sudo apt-get install git
   git clone https://github.com/ambertime/amberchain.git

2. Install the required tools and libraries

   sudo apt-get update
   sudo apt-get install build-essential libtool autotools-dev automake pkg-config libssl-dev libevent-dev bsdmainutils
   sudo apt-get install libboost-all-dev
   sudo apt-get install software-properties-common
   sudo add-apt-repository ppa:bitcoin/bitcoin
   sudo apt-get update
   sudo apt-get install libdb4.8-dev libdb4.8++-dev

3. Build the Chain

   Compile Amberchain for Ubuntu (64-bit)

   # amberchain >
   ./autogen.sh
   ./configure
   make
   # this will take a few minutes  to build the chain

   • This will build amberchaind, amberchain-cli and amberchain-util in the src directory.

• The release is built with GCC after which strip amberchaind strings the debug symbols, which reduces the executable size by about 90%.

4. Connect to the AmberChain testnet or AmberChain mainnet

   *To connect to the currently deployed amber-testnet chain, run any of the following:

   • ./amberchaind amber-testnet@13.250.176.149:7362
   • ./amberchaind amber-testnet@13.124.35.92:7362
   • ./amberchaind amber-testnet@47.75.251.94:7362

   *To connect to the currently deployed ambertime (mainnet) chain, run any of the following:

   • ./amberchaind ambertime@13.251.21.213:7362
   • ./amberchaind ambertime@52.220.101.207:7362
   • ./amberchaind ambertime@13.114.69.248:7362
   • ./amberchaind ambertime@52.78.32.33:7362
   • ./amberchaind ambertime@52.79.183.164:7362
   • ./amberchaind ambertime@47.88.220.28:7362
   • ./amberchaind ambertime@47.244.33.129:7362
   • ./amberchaind ambertime@47.91.17.246:7362
   • ./amberchaind ambertime@47.74.181.39:7362
   • ./amberchaind ambertime@149.129.223.190:7362
   • ./amberchaind ambertime@137.116.137.133:7362
   • ./amberchaind ambertime@40.115.176.120:7362
   • ./amberchaind ambertime@52.231.158.148:7362
   • ./amberchaind ambertime@13.76.197.197:7362
   • ./amberchaind ambertime@52.231.76.73:7362

5. Run the Chain CLI

   
   # amberchain/src >
   ./amberchain-cli <chain name>
   # ie: ./amberchain-cli amber-testchain

6. Stop the Chain

   • You can stop the chain by running the stop command from outside the CLI

     # amberchain/src >
     ./amberchain-cli <chain name> stop
     # ie. ./amberchain-cli amber-testchain stop

   • Inside the CLI

     # amber-testchain >
     stop
     bye

Deploy the Cron Job

• To automatically restart the ambertime chain, follow the steps below.
• If setting this up for amber-testnet, please replace ambertime to amber-testnet in restart_chain.sh.
• check_chain.sh assumes that there is only one amberchaind process running on your machine.
• These steps assume that the amberchain directory is under your $HOME|~ folder.

1. Create the cron_logs directory under $HOME

   mkdir ~/cron_logs

2. Install the cron job
   • Run command below

     crontab -e

   • Append your entry at the end of the file
   • (Note that the command below runs the check_chain.sh script every 5 minutes)

     */5 * * * * $HOME/amberchain/check_chain.sh