How s0md3v/orbit works
Orbit is a command-line blockchain wallet investigation tool. A user supplies seed addresses and crawl options; the runtime ranks addresses, recursively fetches transaction histories, builds a weighted wallet graph, then prepares it for Quark visualization and optionally exports JSON or GraphML. The in-memory wallet map is the central state. README capabilities include adjustable depth, per-address limits, top-wallet selection, graph viewing, and export formats. Quark is downloaded at runtime when absent; its implementation is not in this repository, so viewer internals are not represented.
Main entry points: orbit.py CLI workflow · getTransactions.py Transaction parsing · utils.py Wallet ranking · requester.py Blockchain requester
Components 18
Crawl orchestration
- CLI workflow
orbit.py - Wallet map
orbit.py - Wallet ranking
core/utils.py - Address discovery
core/utils.py - Concurrent crawl
orbit.py
Transaction collection
- Transaction parsing
core/getTransactions.py - Page calculation
core/utils.py - Blockchain requester
core/requester.py
Graph preparation
- Wallet graph build
orbit.py - Node placement
core/utils.py
Visualization and export
- Viewer data setup
core/prepareGraph.py - Quark setup
core/getQuark.py - Quark viewer
- JSON / GraphML export
core/exporter.py
Other components
- Investigator
- Blockchain.info
- Web browser
- Export file
Connections 23
- Investigator → CLI workflow: supplies seeds/options
- CLI workflow → Quark setup: ensures viewer
- CLI workflow → Wallet ranking: ranks wallets
- Wallet ranking → Wallet map: returns ranked map
- CLI workflow → Address discovery: finds unprocessed
- Address discovery → Wallet map: reads addresses
- CLI workflow → Concurrent crawl: dispatches crawl
- Concurrent crawl → Transaction parsing: submits addresses
- Transaction parsing → Page calculation: calculates pages
- Transaction parsing → Blockchain requester: requests address history
- Blockchain requester → Blockchain.info: fetches transactions
- Transaction parsing → Wallet map: records interactions
- Transaction parsing → Wallet map: marks processed
- CLI workflow → Wallet graph build: builds graph data
- Wallet graph build → Wallet map: reads ranked map
- Wallet graph build → Node placement: assigns coordinates
- CLI workflow → Viewer data setup: prepares viewer data
- Viewer data setup → Quark viewer: sets graph source
- Quark setup → Quark viewer: installs if missing
- CLI workflow → Web browser: opens viewer
- Quark viewer → Web browser: renders graph
- CLI workflow → JSON / GraphML export: exports graph
- JSON / GraphML export → Export file: writes JSON or GraphML