Argos — Piattaforma di Tracciamento degli Asset Blockchain

Argos è una piattaforma di investigazione blockchain basata su più linguaggi per tracciare, analizzare e visualizzare i flussi di fondi su Ethereum e Bitcoin. Realizzata con Rust, OCaml e TypeScript/React.

Architettura

                     +-----------------------+
                     |  Frontend (React 19)  |
                     |  Vite + Tailwind CSS  |
                     +-----------+-----------+
                                 | HTTP/REST
                     +-----------v-----------+
                     |    REST API (Rust)    |
                     |   Axum — port 8990   |
                     |                       |
                     | in-process OCaml FFI  |
                     | (ocaml-interop):      |
                     |  database_ffi.so —    |
                     |  tracing + full decode|
                     +-----------+-----------+
                                 |
         +-----------------------v----------------------+
         |             PostgreSQL (11 DBs)              |
         |                   Redis                      |
         +----------------------------------------------+

  +------------------+          +------------------+
  | Ethereum node    |          | Bitcoin node     |
  +--------+---------+          +--------+---------+
           |                             |
  +--------v----------+        +--------v----------+
  | Rust indexers x2  |        | Rust indexers x2  |
  | (psql x           |        | (psql x           |
  |  latest/hist)     |        |  latest/hist)     |
  |                   |        |                   |
  | in-process OCaml  |        | in-process OCaml  |
  | FFI: analyses_ffi |        | FFI: analyses_ffi |
  | .so (decode +     |        | .so (decode +     |
  | defi_analyses)    |        | defi_analyses)    |
  +-------------------+        +-------------------+

Le operazioni di decodifica, analisi DeFi e tracciamento vengono eseguite in-process all'interno dei binari Rust tramite un'interfaccia FFI diretta Rust↔OCaml (ocaml-interop) — non ci sono microservizi separati né porte gRPC.

Avvio Rapido

Vedi Getting Started per le istruzioni complete di configurazione.

git clone [email protected]:functori/argos/argos.git
cd argos
cp argos.secret.env.example argos.secret.env  # Fill in secrets
set -o allexport && . ./argos.env && . ./argos.secret.env && set +o allexport
make install-deps
make create-tablespaces
make migrate-databases
make build

Documentazione

Documento	Descrizione
Getting Started	Prerequisiti, installazione, primo avvio
Architecture	Topologia di sistema e flussi di dati
REST API	Endpoint API e autenticazione
Indexers	Binari degli indicizzatori blockchain
Database	Schemi di database e partizionamento
Deployment	Docker, servizi, log, monitoraggio
Docker	Immagini Docker per servizio, ricette di build, configurazione runtime
Environment	Riferimento delle variabili d'ambiente
Tracing	Algoritmo di tracciamento dei flussi di fondi
Decode and Analysis	Decodifica e analisi (FFI OCaml in-process)
OSINT	Fonti di dati OSINT e ingestione
Analysis Algorithms	Analisi DeFi (arbitraggio, sandwich, ecc.)
Clustering	Pipeline di clustering e classificazione degli indirizzi
Decode Component	Decodifica ABI
Frontend	Applicazione React

Sviluppo

Vedi Developer Conventions:

Git Workflow — Pianificazione del progetto, commit, MR, revisioni
Code Guidelines — Standard di stile e qualità
Source Organization — Dove risiede il codice

Build

make install-deps      # Install all dependencies (OCaml, Rust, Node, Python)
make build             # Build backend (Rust + OCaml)
make build-front       # Build frontend
make create-tablespaces  # Create PostgreSQL tablespace directories
make migrate-databases   # Create databases and run migrations
make run-tests           # Run tests
make lint-backend        # Lint backend (clippy, ocamlformat)
make lint-frontend       # Lint frontend (eslint)
make format            # Auto-format all code

Licenza

Proprietaria — Functori

Argos — Updated!

Categorie