Skip to content

blessingblockchain/Decentralized-Expense-Tracker

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌌 Tracking Expenses Securely!

License: MIT Open Source Love


Jarvis is A web application backed by the power of Decentralization! The motive of the application is to assist the user in managing and maintaining his/her transactions. A transaction can be either in form of income or expense. This application provides visualizations in form of graphs giving users the ability to track by visualizing his/her expenses over a period of time. The application provides the functionality to export the transactions in an excel file. The user can also add transactions through voice commands with a simple click of a button. In addition all data that the user generates is stored on the blockchain in a decentralized manner powered by Ethereum, which prevents the risks of illegal tampering with the data.

❄️ Features:

  • Data Security
  • Graphical Visualization
  • Top Diversifications
  • Exporting Data to Excel
  • Voice Recognition

❄️ Demo

🛠️ Technology Stack

  • Website TypeScript Next JS React Bootstrap Chart.js

  • Backend Solidity Ethereum Hardhat 

  • Hosting Fleek  Goerli Etherscan  Alchemy 

❄️ ScreenShots

  1. Overview

  • Input form
  • Current Balance and Transaction Overview
  • drawing
  1. Transactions

  • List of Transaction sorted by date
  • Download Transaction Option
  • Graphical Analysis of Incomes & Expenses
  • drawing
  1. Performance

  • Line Graph for analysing transactions throught the year
  • drawing
  1. Diversification

  • Graphical Analysis of Top Incomes and Expenses
  • drawing

🏃 Local setup - Frontend

Before starting 🏁, you need to have Git and Node installed.

# Clone this repository
$ git clone https://github.com/J0SAL/Decentralized-Expense-Tracker.git
# Go into the repository
$ cd Decentralized-Expense-Tracker
$ cd frontend
# Install Dependencies
$ npm install
# Run Application
$ npm dev
# The server will start at <http://localhost:3000>

🏃 Local setup - Backend

Before starting 🏁, you need to have Git and Node installed.

# Clone this repository
$ git clone https://github.com/J0SAL/Decentralized-Expense-Tracker
# Go into the repository
$ cd Decentralized-Expense-Tracker
$ cd backend
# Install dependencies
yarn
# Code Compile
yarn hardhat compile
# testing (optional)
yarn hardhat test
# Run the nodes (*terminal-1*)
yarn hardhat node
# Deploy contract to localhost (*terminal-2*)
yarn hardhat deploy --network localhost

To run this project, you will need to add the following environment variables to your .env file inside your backend folder.

Environment Varaibles
GOERLI_RPC_URL=<ALCHEMY_URL> # (https://www.alchemy.com/)

PRIVATE_KEY=<YOUR_ACCOUNT_PRIVATE_KEY> # (https://www.alchemy.com/)

ETHERSCAN_API_KEY=<YOUR_KEY> # (https://goerli.etherscan.io/)

UPDATE_FRONT_END=true # (true: dynamically update ABI and contract address frontend)

🤠 Contributors

About

Solving gas optimization issues

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 90.4%
  • CSS 5.1%
  • Solidity 4.3%
  • JavaScript 0.2%