Scope Blockchain Analysis

A production-grade command-line tool for blockchain data analysis, portfolio tracking, transaction investigation, and compliance-grade risk assessment.

Features

• Address Analysis: Query balances (with USD valuation), transaction history, and token holdings for blockchain addresses
• Transaction Analysis: Look up and decode blockchain transactions across all supported chains
• Token Crawling: Crawl DEX data for any token -- price, volume, liquidity, holder analysis, and risk scoring with markdown report generation
• Live Monitoring: Real-time TUI dashboard with price/volume/candlestick charts, buy/sell gauges, and activity logs
• Portfolio Management: Track multiple addresses across chains with labels, tags, and aggregated balance views
• Compliance & Risk Assessment: Risk scoring, transaction pattern detection, taint analysis, and compliance reporting
• Interactive Mode: REPL with preserved context between commands for faster workflow
• USD Valuation: Native token balances enriched with real-time USD prices via DexScreener
• Multi-Chain Support:
  • EVM chains: Ethereum, Polygon, Arbitrum, Optimism, Base, BSC, Aegis
  • Non-EVM chains: Solana, Tron

Installation

# Clone the repository
git clone https://github.com/robot-accomplice/scope-blockchain-analysis.git
cd bca

# Build and install
cargo install --path .

Quick Start

# Analyze an Ethereum address (auto-detects chain from address format)
scope address 0x742d35Cc6634C0532925a3b844Bc9e7595f1b3c2

# Include transaction history and token balances
scope address 0x742d35Cc6634C0532925a3b844Bc9e7595f1b3c2 --include-txs --include-tokens

# Analyze addresses on other chains (auto-detected or explicit)
scope address DRpbCBMxVnDK7maPM5tGv6MvB3v1sRMC86PZ8okm21hy --chain solana
scope address TDqSquXBgUCLYvYC4XZgrprLK589dkhSCf --chain tron

# Look up a transaction
scope tx 0xabc123def456789012345678901234567890123456789012345678901234abcd

# Risk assessment for compliance
export ETHERSCAN_API_KEY="your_key_here"
scope risk 0x742d35Cc6634C0532925a3b844Bc9e7595f1b3c2 --detailed

# Pattern detection
scope analyze 0xabc... --patterns structuring,layering

# Token crawling with report generation
scope crawl 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 --chain ethereum

# Live monitor with real-time dashboard
scope monitor 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 --chain ethereum

# Interactive mode
scope interactive

Compliance Features

Scope includes enterprise-grade compliance and risk analysis:

Risk Assessment

# Basic risk score
scope risk 0x742d35Cc6634C0532925a3b844Bc9e7595f1b3c2

# Detailed breakdown with evidence
scope risk 0xabc... --detailed --format markdown

# Export for compliance records
scope risk 0xabc... --output risk-report.json

Pattern Detection

# Detect structuring, layering, velocity anomalies
scope analyze 0xabc... --patterns structuring,layering,velocity

# Time-range analysis
scope analyze 0xabc... --range 30d

Transaction Tracing

# Trace fund flow through multiple hops
scope trace 0xtxhash... --depth 5 --flag-suspicious

Note: Set ETHERSCAN_API_KEY environment variable for full compliance analysis. Without it, basic scoring is used.

Interactive Mode

Launch a REPL where context persists between commands:

$ scope interactive

scope:ethereum> chain solana
Chain set to: solana

scope:solana> address 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
# Uses solana chain automatically

scope:solana> format json
Format set to: json

scope:solana> exit

Configuration

Create ~/.config/scope/config.yaml:

chains:
  ethereum_rpc: "https://mainnet.infura.io/v3/YOUR_KEY"
  solana_rpc: "https://api.mainnet-beta.solana.com"
  
  api_keys:
    etherscan: "YOUR_ETHERSCAN_KEY"
    solscan: "YOUR_SOLSCAN_KEY"

output:
  format: table
  color: true

Environment Variables

• ETHERSCAN_API_KEY - Required for compliance features
• SCOPE_CONFIG - Path to custom config file
• RUST_LOG - Log level override

Development

# Run tests
cargo test

# Format code
cargo fmt

# Run lints
cargo clippy -- -D warnings

# Build release
cargo build --release

Or use just:

just test      # Run all tests
just ci-test   # Full CI workflow
just format    # Format code
just lint      # Run lints

Supported Chains

CI/CD

GitHub Actions workflow runs:

• Check - Fast compilation
• Format - Code style
• Clippy - Linting
• Test - Unit and integration tests
• Docs - Documentation build
• Build - Release binaries (Linux, macOS)
• Security - Dependency audit

License

MIT License - see LICENSE for details.

Built with Rust. Designed for analysts, compliance officers, and blockchain researchers.