deocoin-explorer

Deocoin Explorer

A Deocoin blockchain explorer web application service for Deocoincore Node using the Deocoin API.

Getting Started

• Install nvm https://github.com/creationix/nvm
  We need Node 8. Nvm is a nice utility that allows easy switching between node versions.

  nvm i v8
  nvm use v8
  

• Install mongo https://docs.mongodb.com/manual/tutorial/install-mongodb-on-ubuntu/

  Then open a Mongodb client window and create a user and database:

  use deocoin-api-livenet
  db.createUser(
    {
      user: "deocoin",
      pwd: "mynewpassword",
      roles: [ "readWrite", "dbAdmin" ]
    }
  )
  

• Deocoin wallet installation

  Compile the addressindex branch and make sure you have ZMQ installed

  # Dependencies
  sudo apt-get install build-essential libtool autotools-dev automake pkg-config libssl-dev libevent-dev bsdmainutils git cmake 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
  # with ZMQ
  sudo apt-get install libzmq3-dev
  
  # If you want to build the Qt GUI:
  sudo apt-get install libqt5gui5 libqt5core5a libqt5dbus5 qttools5-dev qttools5-dev-tools libprotobuf-dev protobuf-compiler qrencode
  
  # Get the Deocoin wallet
  git clone https://github.com/deocoincore/deocoin
  cd deocoin
  git fetch origin
  git checkout addressindex
  
  # Note autogen will prompt to install some more dependencies if needed
  ./autogen.sh
  ./configure
  make -j2
  
  

• Install deocoincore-node

  mkdir deocoinnode
  cd deocoinnode
  
  npm i deocoincore-node
  
  ./node_modules/.bin/deocoincore-node create mynode
  cd mynode
  
  ../node_modules/.bin/deocoincore-node install https://github.com/deocoincore/deocoin-insight-api.git#master
  ../node_modules/.bin/deocoincore-node install https://github.com/deocoincore/deocoin-explorer.git#master
  

• Edit deocoincore-node.json to be similar to this (replace user with your username):

    {
      "network": "livenet",
      "port": 3001,
      "services": [
        "deocoind",
        "web",
        "deocoin-insight-api",
        "deocoin-explorer"
      ],
      "servicesConfig": {
        "deocoin-explorer": {
          "apiPrefix": "deocoin-insight-api",
          "routePrefix": "deocoin-explorer",
          "nodemapLink": "https://deocoin.org/en/nodemap"
      },
        "deocoin-insight-api": {
          "routePrefix": "deocoin-insight-api",
          "db": {
            "user": "deocoin",
            "password": "mynewpassword",
            "host": "localhost",
            "port": 27017,
            "database": "deocoin-api-livenet"
          },
          "erc20": {
            "updateFromBlockHeight": 5000
          }
        },
        "deocoind": {
          "spawn": {
            "datadir": "/home/user/.deocoin",
            "exec": "/home/user/deocoin/src/deocoind"
          }
        }
      }
    }
  

• Configure Deocoin and sync the blockchain

  cd ~
  mkdir .deocoin
  cd .deocoin
  touch deocoin.conf
  

  Edit deocoin.conf:

  server=1
  whitelist=127.0.0.1
  logevents=1
  txindex=1
  addressindex=1
  timestampindex=1
  spentindex=1
  par=2
  onlynet=ipv4
  maxconnections=24
  zmqpubrawtx=tcp://127.0.0.1:28332
  zmqpubhashblock=tcp://127.0.0.1:28332
  rpcallowip=127.0.0.1
  rpcuser=user
  rpcpassword=password
  rpcport=8332
  addrindex=1
  reindex=1
  

  Run deocoind and sync the chain:

  cd ~/deocoin/src
  ./deocoind &
  

  You can check the progress of the sync with the deocoin-cli command. Kill the daemon once the chain is synchronized.

  ./deocoin-cli getInfo
  
  pkill deocoind
  

  You only need to run deocoind once with reindex=1 enabled. Once the chain is synced you can kill deocoind and comment the reindex setting in ~/.deocoin/deocoin.conf #reindex=1

• Run Node (from the mynode folder):

  ../node_modules/.bin/deocoincore-node start
  

• Open a web browser to http://localhost:3001/deocoin-explorer or http://localhost:3001/deocoin-insight-api

Development

To run Insight UI locally in development mode:

Install dependencies:

npm install

To compile and minify the web application's assets:

grunt compile

There is a convenient Gruntfile.js for automation during editing the code

grunt

Multi language support

Insight UI uses angular-gettext for multi language support.

To enable a text to be translated, add the translate directive to html tags. See more details here. Then, run:

grunt compile

This action will create a template.pot file in po/ folder. You can open it with some PO editor (Poedit). Read this guide to learn how to edit/update/import PO files from a generated POT file. PO file will be generated inside po/ folder.

If you make new changes, simply run grunt compile again to generate a new .pot template and the angular javascript js/translations.js. Then (if use Poedit), open .po file and choose update from POT File from Catalog menu.

Finally changes your default language from public/src/js/config

gettextCatalog.currentLanguage = 'es';

This line will take a look at any *.po files inside po/ folder, e.g. po/es.po, po/nl.po. After any change do not forget to run grunt compile.

Note

For more details about the Deocoin API configuration and end-points, go to Deocoin API.