https://github.com/blockworks-foundation/solana-bankingstage-dashboard
Frontend written in Flask to expose an Explorer-like view into banking stage transaction errors
https://github.com/blockworks-foundation/solana-bankingstage-dashboard
Last synced: 4 months ago
JSON representation
Frontend written in Flask to expose an Explorer-like view into banking stage transaction errors
- Host: GitHub
- URL: https://github.com/blockworks-foundation/solana-bankingstage-dashboard
- Owner: blockworks-foundation
- Created: 2023-11-22T14:43:57.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-15T17:37:46.000Z (9 months ago)
- Last Synced: 2024-11-28T04:09:27.336Z (6 months ago)
- Language: CSS
- Size: 2.14 MB
- Stars: 2
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Solana Banking Stage Inspection Dashboard
### Status
Production - contact us for Link
### Screenshots
#### List of Transaction errors
##### Transaction details with heavily write-locked accounts
##### List of Blocks with fill ratio / errors / total tx
##### Block details
##### Block details with heavily write-locked accounts
#### Search for a Block/Transaction by Slot Number/Signature
### Recent Blocks - stop refreshing
The auto-refresh can be stopped by appending parameter `to_slot` to the URL: `/recent-blocks?to_slot=232135000`
### Tx Errors List - show more rows
The number of rows requested from Database can be changed by appending parameter `limit` to the URL: `/tx-errors?limit=300`.
A value for `limit` restricted to 1-10000. Default is 50.
### Local Development
**Caution:** Port `5000` cannot be used on MacOS.
```
# Unix/macOS
python3 -m venv .venv
source .venv/bin/activate
SOLANA_CLUSTER=testnet POOLED_DB_MAX_SIZE=4 PGDATABASE=da11copy PGUSER=query_user PGPASSWORD=secret TEMPLATES_AUTO_RELOAD=True flask run --port 5050 --debug --reload
```
Use this to test with _gunicorn_:
* ___CAUTION___: did not figure out how to enable template reloading
```
SOLANA_CLUSTER=testnet POOLED_DB_MAX_SIZE=4 PGDATABASE=da11copy PGPORT=5432 PGUSER=query_user PGPASSWORD=secret gunicorn app:webapp --workers 1 --threads 30 --bind :5050 --reload
```
Open Firefox Browser and navigate to ...
* [Dashboard](http://localhost:5050/dashboard)
* [Tx Errors](http://localhost:5050/tx-errors)
* [Recent Blocks](http://localhost:5050/recent-blocks)
* [Search for one Block or Transaction](http://localhost:5050/search)
### Deployment
#### Limits
| Description | System | Variable | Config |
|-------------------------------------|-------------|------------------------|------------|
| Max number of PostgreSQL connections | Application | POOLED_DB_MAX_SIZE | fly.toml |
| Limit of HTTP Requests | fly.io | soft_limit | fly.toml |
| Hard Limit of HTTP Requests | fly.io | hard_limit | fly.toml |
| Python HTTP Server | gunicorn | --workers, --threads | Dockerfile |
### Data Model
* transaction data (irrespective of block inclusion):
* transaction_slot: (banking stage only!), transaction from banking stage plugin; reflecting errors trying to include transaction in block (block is designated by slot)
* accounts_map_transaction: mapping of accounts to transactions irrespective of block inclusion
* related to a produced block (happens _after_ transaction data):
* transaction_infos: transaction in blocks
* accounts_map_blocks: accounts mentioned in block
Conventions:
| Table Name | Alias |
|------------------|---------|
| transaction_slot | tx_slot |
| accounts_map_blocks | amb |
| transaction_infos | txi |
| blocks | blocks |
| accounts_map_transaction | amt |
| transaction_slot | tx_slot |