Skip to content
烫辣麻的麻辣烫 edited this page Mar 7, 2022 · 9 revisions

Hi there

Welcome to Crypto Address Tracker, the open source web application for tracking blockchain addresses!

Functionality Overview

As a visitor, you will be able to see the current information associated with your favorite crypto address of choice. Information like a list of crypto currencies such address owns will be available for query 24/7.

As our registered user, you will have exclusive access to our analytics and tracking service, in addition to query your selected crypto address. For the tracking service, we will continuously monitor address behavior and store relevant information to our database, so that later you can generate meaningful reports from them.

Installment

Our application is built with frontend framework React.js and backend framework Flask using Python and Javascript. Our repository is a monolithic codebase that stores both our frontend and backend code. Before start, please make sure you already have our project cloned to your local environment.

For frontend, please make sure you have npm installed, our package manager for React.js.

cd blockchain-tracker-frontend/
npm install
npm start

For backend, please make sure you have Anaconda installed, it helps us install some dependencies needed.

cd backend
nohup python3 -u flask_api.py &
cd user_info
export FLASK_APP=user_info_flask
flask init-db
flask run --host 0.0.0.0

Alternatively, you can install the dependency by manually install the pip dependencies:

pip install -r requrements.txt

For database, we are using embedded database SQLite, you need to run some scripts to start your local server.

cd user_info/user_info_flask
//find a file named schema.sql
//create a database named USER_INFO_DB and run the script above

Deployment

Our frontend application is deployed using AWS Amplify, any new changes made to our blockchain-tracker-frontend repository will trigger CI/CD process and re-deploy our application.

Our backend application is deployed using AWS EC2, with Travis CI setup for continuous integration.

Demo

The image below is a screenshot of the home page. It displays your selected address, a list of tracked addresses if you are a logged in user, and a search bar for changing your selected address. The update button allows you to update your tracked address list, which is of course only limited to registered user. Note that if the address you enter into the search bar is invalid, the application will notify you and your current selected address will not be replaced. Screen Shot 2022-03-06 at 3 41 16 PM

Below is an example when a visitor clicked the update button on the home page: ![Screen Shot 2022-03-06 at 3 43 19 PM](https://user-images.githubusercontent.com/46799106/156947418-c96c40f7-c0f0-4c16-9c0d-7e48150f9d38.png)

To register an account, click on the first button on the top right corner of the screen: Screen Shot 2022-03-06 at 3 47 18 PM

To login, click on the second button on the top right corner of the screen: Screen Shot 2022-03-06 at 3 47 48 PM

Now click on the second button on the navigation panel to the left of the screen, this is the place where everyone can search for an address' information. Simply click on the LOOKUP ADDRESS button, and you will be able to see data inside the data grid. Note that you can also start tracking current address for further analysis. This can be done by clicking on the TRACK ADDRESS button (limited to logged in user only) Screen Shot 2022-03-06 at 3 48 09 PM

Now click on the third button on the navigation panel to the left of the screen, you can generate analytics data for your selected address. Note that this data grid contains more information than the previous one, with detailed information about each crypto currency that current selected address owns Screen Shot 2022-03-06 at 3 51 43 PM

Lastly, click on the last button on the navigation panel to the left of the screen, you can generate report for the currently selected address. If this address if not your tracked address, the application will notify you. Screen Shot 2022-03-06 at 3 52 53 PM

You can also change your selected address by entering a new address into the search bar at any time. If such address is valid, the selected address field will be updated for all nested part of the home page. If the Address Information is followed with no address, it means you haven't select an address yet.

If you want to filter or sort our data grip, you can also do it easily: Screen Shot 2022-03-06 at 4 01 41 PM

Contact

Please contact nobody if you see an error in our project.

Clone this wiki locally