Fragarach

Modular OSINT framework for blockchain forensics and investigations

Overview

Fragarach is a modular OSINT framework designed for blockchain investigations and forensics, implemented in Rust. The framework provides a comprehensive suite of tools for building and analyzing blockchain intelligence data lakes.

Features & Integrations

Current Integrations

• Transpose API

  • Ethereum blockchain data retrieval

• URLScan API

  • Domain scanning with private visibility
  • Screenshot capture
  • DOM snapshot storage

Supported Networks

• Ethereum
  • Account analysis
• Bitcoin (Under Development)
• Solana (Planned)

Installation & Setup

Prerequisites

1. Rust Installation

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   

Installation Methods

1. Via Cargo

   cargo install fragarach
   

2. From Source

   git clone https://github.com/DB14734/fragarach.git
   cd fragarach
   cargo build --release
   

Usage

Configuration

1. Environment Setup

   fragarach setup
   

   This will create a .env file with:

   • TRANSPOSE_API_KEY: Transpose API authentication
   • URLSCAN_API_KEY: URLScan API authentication

2. Database

   • DuckDB database is automatically created at `data/fragarach.duckdd

Dependencies

Core dependencies:

• tokio: Async runtime and utilities
• duckdb: Embedded database operations
• reqwest: HTTP client
• serde: Serialization/deserialization
• clap: CLI argument parsing
• dotenv: Environment variable management

UI dependencies:

• colored: Terminal coloring
• dialoguer: Interactive prompts
• console: Terminal utilities

Core Components

Storage Layer

Uses DuckDB as an embedded analytical database.

Schema Design

Database tables:

1. ethereum_accounts

   • Primary account information
   • Creation timestamps
   • Activity tracking
   • Account typing

2. ethereum_transactions

   • Transaction details
   • Gas metrics
   • Fee calculations
   • Internal transaction tracking

3. urlscan_domain_data

   • Domain scan results
   • Verdict analysis
   • Screenshot references
   • Geographical data

4. urlscan_dom_snapshot

   • DOM state storage
   • Temporal tracking
   • UUID referencing

Contributing

Development Setup

1. Fork & Clone

   git clone https://github.com/your-username/fragarach.git
   cd fragarach
   

2. Build

   cargo build
   

3. Environment Configuration

   cp .env.example .env
   # Edit .env with your API keys
   

License

This project is licensed under the MIT License - see the LICENSE file for details.