Overview

Griffin is a sophisticated trading system designed to enable anonymous, cross-chain trading through a secure, proxy-routed architecture. The system combines:

• Multi-chain liquidity aggregation via SimpleSwap API
• Privacy-preserving execution through Mullvad/Tor networks
• Institutional-grade asset management using OKX's Web3 SDK

Core Trading Pairs

Role	Assets
Profit Anchor	USDT (Solana, TRC20)
Volatile Targets	SOL, SUI, DOT, etc...
Value Reserve	Bitcoin (On-chain settlement)

Key Features

• Abstraction Layer: Unified blockchain access via OKX Web3 SDK
• Liquidity Routing: Optimized swaps through SimpleSwap API
• Stealth Execution:
  • Tor bridges (obfs4/meek)
  • Mullvad SOCKS5 proxy support
• Market Intelligence:
  • Python-based volatility analysis
  • Multi-exchange price aggregation

Components & Stack

Component	Technology
web app (Django Operational Settings App)	Python
daemon (Core Process)	Python
griffin gateway (Privacy Layer - Tor, Mullvad VPN)	Rust
harpie (Wallet Interface/OKX wallet SKD)	TypeScript
seyeon (Market Analysis)	Python

Simplified System Workflow Example

graph LR
    A[Market Analysis] --> B{Trading Signal}
    B -->|Buy| C[USDT→Volatile]
    B -->|Sell| D[Volatile→USDT]
    B -->|Hodl| E[Wait]
    C & D --> F[OKX SDK Execution]
    F --> G[Mullvad/Tor Routing]

Loading

Configuration

Privacy Setup

Choose either Tor or Mullvad proxy:

privacy:
  method: mullvad # or 'tor'
  mullvad:
    socks5_host: 10.8.0.1
    socks5_port: 1080
  tor_bridges:
    - obfs4
    - meek

Wallet Configuration

To be written

API Integrations

• SimpleSwap API Documentation
• OKX Web3 Wallet SDK
• Mullvad Proxy Setup
• Tor Bridges

Installation

# Clone repository (private)
git clone [email protected]:0x2fycy3/griffin.git

# Build core components
cd griffin/core
cargo build --release

# Install dependencies
npm install  # for wallet interface
pip install -r requirements.txt  # for analysis engine

Running the Project

Griffin consists of multiple services that work together. We've included shell scripts to easily start and stop all components.

Starting All Services

# Make the script executable (first time only)
chmod +x run_griffin.sh

# Run all Griffin services
./run_griffin.sh

This will start:

• Griffin Gateway (Rust) with proper logging http://127.0.0.1:3000
• Harpie Service (Node.js) on http://127.0.0.1:8081
• Django Application http://127.0.0.1:8000
• Main Daemon with the Python virtual environment

Each service will run in its own terminal window, and logs will be saved to the logs directory for troubleshooting.

Stopping All Services

# Make the script executable (first time only)
chmod +x stop_griffin.sh

# Stop all Griffin services
./stop_griffin.sh

The stop script will gracefully terminate all running Griffin services, including those running on specific ports and background processes. It will also attempt to close any terminal windows opened by the start script if you have wmctrl or xdotool installed (sudo apt install wmctrl or sudo apt install xdotool).

Development Team / Core Contributors

• @0x2fycy3

  • Lead Architecture & Strategy
  • Market analysis algorithms
  • SimpleSwap API integration
  • Anonymity layer & proxy implementation

• @ry-diffusion

  • System Architecture & Review
  • Core infrastructure design
  • Anonymity layer & proxy implementation

• @ggsantoss

  • OKX Web3 Wallet SDK integration
  • Multi-chain wallet security

• @Levi-de-Souza-Cavalcanti-Dev

  • Market Analysis Strategy Developer

---

Disclaimer: All trade decisions made by this system are made autonomously based on market conditions.