Transaction Forensics TUI
A Textual-based terminal UI for analyzing Ethereum transaction traces — detects balance divergence, decodes revert errors, and provides full forensic breakdowns from JSON forensic artifacts or CSV traces.
Features
- Forensic analysis from JSON artifacts (tx info, trace calls, token deltas, errors)
- CSV trace support (Etherscan trace exports)
- Balance divergence detection — spots vesting/rebasing token shortfalls
- Decoded revert errors — Error(string), Panic(uint256), and raw hex
- Export results to CSV and JSON
- Toggleable sections — trace, errors, gas analysis, token deltas
Installation
pip install tx-forensics
Usage
# Launch interactive TUI
tx-forensics
# Analyze a specific file (JSON or CSV)
tx-forensics --file trace.json
tx-forensics --file trace.csv
# Batch CLI mode with JSON output
tx-forensics --file trace.csv --json
# Quiet mode (exit code only)
tx-forensics --file trace.csv --quiet
Keyboard bindings (TUI)
| Key | Action |
|---|---|
q / Escape |
Quit / Go back |
t |
Toggle trace section |
e |
Toggle errors section |
g |
Toggle gas section |
d |
Toggle deltas section |
c |
Export CSV |
j |
Export JSON |
Input Formats
- JSON — full forensic artifacts (generated by VANTAGE
tx-forensic-gui.py) - CSV — Etherscan trace exports
License
All Rights Reserved — Copyright 2026 CE Hirschauer
1 maintainer
Metadata
1 maintainer
Release files for tx-forensics 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tx_forensics-0.1.0.tar.gz | 13.5 kB | Without provenance | Details for tx_forensics-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tx_forensics-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for tx_forensics-0.1.0-py3-none-any.whl |
Total release size: 26.4 kB
Release files / tx_forensics-0.1.0.tar.gz
| Download URL | tx_forensics-0.1.0.tar.gz |
|---|---|
| Size | 13.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8c52e09492cb92e86fd2979869082d7f264423ab40de50bed2443fc547f37160
|
|
BLAKE2b-256 checksum How to use checksums |
ef583762867d7ebc15f5e352f2290ba0cf60b1601fecd7595c0487be59b080c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Release files / tx_forensics-0.1.0-py3-none-any.whl
| Download URL | tx_forensics-0.1.0-py3-none-any.whl |
|---|---|
| Size | 12.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c018e9c5b2fe37aa0dafe80058b9016d2a102a17897a3f5bfb453e8c3a8fdeae
|
|
BLAKE2b-256 checksum How to use checksums |
520c1034a43781e2dc7c7f14371e4876e64cbfc39c0019661f960c50c2d520d1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Security for tx-forensics 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
