Giter VIP home page Giter VIP logo

explorer's Introduction

Nebulas Blockchain Explorer

A Java web app for users to explore and analyze the nebulas blockchain.

Its frontend is a single page application using vuejs and its backend uses Spring.

Please visit https://explorer.nebulas.io/ to view all data in Nebulas.

Design Overview

Nebulas Explorer Design Overview

Explorer Frontend

It's a web app using vuejs serves as the presentation layer for the nebulas blockchain explorer.

More details at https://github.com/nebulasio/explorer/blob/develop/explorer-front/readme.md.

Explorer Backend

  1. Data access REST APIs

Exposes the REST APIs for frontend to get blockchain data.

  1. Data Loader

Loads the blockchain data from Nebulas Node and transform and store the data in a way the frontend can consume.

MySQL

Data Storage for the loaded and transformed data.

Nebulas Node

The explorer make RPCs to Nebulas nodes remote endpoints to load the blockchain data.

How to Contribute

Decide what to do

As a beginner, you may want to pick an issue from issues with help wanted or good first issue tag and make a pull request for your changes.

After being more familiar with the explorer and the code, you can submit improvement ideas and work on those ideas.

Git workflow

Step 1: Clone git repo to your local

You can clone https://github.com/nebulasio/explorer.git and commit to it if you are a key contributor.

git clone https://github.com/nebulasio/explorer.git

Or you can fork git clone https://github.com/nebulasio/explorer.git and clone your forked repo.

Step 2: Make some changes

  1. Create a new branch for your change, use prefix "hotfix/" for bug fix, "feature/" for feature.
  2. Make the change and commit with good commit message

Step 3: Get the change merged

  1. Push your local changes to remote repo
  2. Create the pull request if you are using forked repo
  3. Address review feedback and get the change merged

Environment Setup

Run the explorer frontend locally

Step 1: Install Node.js

  1. Install lastest node.js so you can execute 'npm' command by either downloading zip or installer from https://nodejs.org/en/download/ or via package manager

Step 2: Build and Run

# install dependency
cd explorer/explorer-front
npm i

# run webpack dev build on localhost
npm run dev

# open http://localhost:8080/ in browser
# config port number in explorer-front/config/index.js!dev.port

# run webpack production build, results will output to 'dist' folder
npm run build

Run explorer backend locally

Step 1: Install JDK 8, MySQL and Redis

Step 2: Build, Run and Stop

cd explorer/explorer-backend
source build-expl.sh
source start-expl.sh
source stop-expl.sh

License

The Nebulas explorer uses LGPL license

explorer's People

Contributors

15010159959 avatar 1c7 avatar brandonbevans avatar fbzhong avatar fzxa avatar kemicza avatar luoam avatar nebulashub avatar qywang2012 avatar raphaelfeng avatar wanghn avatar xiwangzishi avatar yanxisir avatar yupnano avatar yuxizhe avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.