Block Tracker

Track your wallet's transactions and the portfolio's value over time

Table of contents

• Introduction
• Supported protocols
• Requirements
• Development
• Running application
• Stopping application
• Local bash
• Logs
• Tests
• Emails
• Workers
  • Blockbook websocket
  • Celery workers
• Exchange rates
• Screenshots
• Contact and Support

Introduction

This is an Open Source project with the goal to track wallet's transactions and the portfolio values over time.

Block Tracker uses Django, Celery and Postgresql.

Supported protocols

Initially it supports only Bitcoin with P2PKH/P2WPKH addresses. The project aims to support multiple assets in multiple protocols.

Requirements

To run this app you must have installed:

• docker
• docker-compose

Development

Before commiting new changes, make sure you have pre-commit installed:

pre-commit install

Running application

make start-local

For the first time, you can use make build to download and build the containers.

Stopping application

make stop

Local bash

make local-bash

Logs

make logs

Tests

make test # shortcut to e2e and unit tests
make unit
make e2e
make integration

Emails

We use mailhog to display the emails sent by SMTP on development server.

The emails sent to SMTP server on localhost:1025 gets available on localhost:8025.

Workers

Blockbook websocket

python manage.py wss_blockbook <ProtocolType attribute>
python manage.py wss_blockbook BITCOIN
python manage.py wss_blockbook BITCOIN_TESTNET

Celery workers

python -m celery -A app worker
python -m celery -A app beat

Exchange rates

We use Coingecko API to fetch exchange rates. We try to get a daily rate for the max period as possible and a 5 minutes rate using the celery beat & worker.

Screenshots

Dashboard

Dashboard with KPIs, Portfolio Overview, Asset Dominance and Last Transactions

Sent emails

Email sent for an user with a new transaction on his wallet

Contact and Support

Got interested and want to support our project? Reach me out by email on [email protected]