blockchain-sonar / explorer

Blockchain Sonar's Explorer

This is workspace branch of Blockchain Sonar's Explorer multi project repository based on orphan branches.

Branches (sub-projects):

• docs - Documentation
• backend - Sources of API service
• frontend - Sources of Web application

Get Started

1. Clone the repository

   git clone [email protected]:blockchain-sonar/explorer.git blockchain-sonar.explorer

2. Enter into cloned directory

   cd blockchain-sonar.explorer

3. Initialize worktree by execute following commands

   for BRANCH in backend-python backend-dart docs frontend; do git worktree add "${BRANCH}" "${BRANCH}"; done

4. Open VSCode Workspace

   code "Blockchain Sonar Explorer.code-workspace" 

Notes

Add new orphan branch

NEW_ORPHAN_BRANCH=mybranch
git switch --orphan  "${NEW_ORPHAN_BRANCH}"
git commit --allow-empty -m "Initial Commit"
git push origin "${NEW_ORPHAN_BRANCH}"

explorer's Issues

Initial sources for `docs`

• Backend API documentation
• Deployment Zones
• Local launch via Docker
• README

---

Story: #8

Init Repository

Init Repository

• #3
• #4
• #5
• #6

Initial sources for `frontend`

Just web app stub

• index.html
• index.js
• README

Define Blockchains dictionary

Setup orphan branch `docs`

Setup orphan branch `backend`

BlockchainAddress classes

We have to represent each type of blockchain address as derived class from base class BlockchainAddress

Implementation checklist

• Method BlockchainAddress.parse should be able to parse string representation of blockchain address
• Each derived class should implement as_string method that returns string representation of blockchain address
• Unit Test for each derived class

Derived classes checklist

• BitcoinBlockchainAddress represents Bitcoin address
• EthereumBlockchainAddress represents Ethereum Account address that used by Ethereum, Ethereum Classic, Binance Smart Chain, Polygon and other Ethereum-based blockchains
• DashBlockchainAddress represents DASH address
• DogecoinBlockchainAddress represents Dogecoin address
• LitecoinBlockchainAddress represents Litecoin address
• TronBlockchainAddress represents Tron address

References

Bitcoin Address Format

• https://en.bitcoin.it/wiki/List_of_address_prefixes
• https://en.bitcoin.it/wiki/Bech32
• https://coin.space/all-about-address-types/
• http://lenschulwitz.com/base58

Litecoin Address Format

• https://coin.space/all-about-address-types/
• https://bitcoin.stackexchange.com/questions/62781/litecoin-constants-and-prefixes
• https://en.bitcoin.it/wiki/Bech32

Dogecoin Address Format

• https://support.ledger.com/hc/ru/articles/115005174025-Dogecoin-DOGE-?docs=true

Tron Address Format

• https://developers.tron.network/docs/account

Dash Address Format

• https://bitcoin.stackexchange.com/questions/83507/dash-constants-and-prefixes

Ethereum Address Format

• https://eips.ethereum.org/EIPS/eip-55
• https://eips.ethereum.org/EIPS/eip-3770
• https://en.wikipedia.org/wiki/Ethereum#:~:text=Ethereum%20addresses%20are%20composed%20of,the%20so%2Dcalled%20secp256k1).
• https://info.etherscan.com/what-is-an-ethereum-address/

Initial sources for `workspace`

• VSCode Workspace
• README.md

Setup default branch `workspace`

Default branch workspace to be used as VSCode Workspace and git-worktree root

Define Assets dictionary

Minimum viable product

• #2

Minimum viable product

• All user's requests for address and transaction redirect to another existing blockchain explorers.
• Ability to deploy the product on own domain to provide imitation of blockchain explorer to second party products.

MVP of frontend

• #22

Create database scripts

Setup orphan branch `frontend`

Setup Development Process

• #7
• #8

Make minimal codebase

• #9
• #10
• #11
• #12

MVP of backend

• #16
• #17
• #18
• #24

MVP

• #15
• #21

Initial sources for `backend`

Minimal Flask app

• Fake response for /v1/asset
• Fake response for /v1/address
• Fake response for /v1/transaction
• Serve static content of frontend compiled app

Create address page

Create address page

We have to implement minimal functionality address page

To Do

• Create address.html
• Create address.js
• (Optionally) Create assess.css, etc.

Implement interaction with backend to represent address details

Notes

When your start backend locally, address page available on URL:

• http://127.0.0.1:5000/webapp/address/0xd3cda913deb6f67967b99d67acdfa1712c293601
• http://127.0.0.1:5000/webapp/address/DRSqEwcnJX3GZWH9Twtwk8D5ewqdJzi13k

References

• https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input
• https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest
• https://learn.javascript.ru/xmlhttprequest
• Masonry Layout