Argos — Plataforma de Rastreo de Activos Blockchain

Argos es una plataforma multilingüe de investigación blockchain para rastrear, analizar y visualizar flujos de fondos en Ethereum y Bitcoin. Construida con Rust, OCaml y TypeScript/React.

Arquitectura

                     +-----------------------+
                     |  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)    |
  +-------------------+        +-------------------+

La decodificación, los análisis DeFi y el rastreo se ejecutan en proceso dentro de los binarios de Rust mediante una FFI directa Rust↔OCaml (ocaml-interop) — no hay microservicios separados ni puertos gRPC.

Inicio rápido

Consulta Primeros pasos para las instrucciones completas de configuración.

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

Documentación

Documento	Descripción
Primeros pasos	Requisitos previos, instalación, primera ejecución
Arquitectura	Topología del sistema y flujos de datos
API REST	Endpoints de API y autenticación
Indexadores	Binarios del indexador de blockchain
Base de datos	Esquemas de base de datos y particionamiento
Despliegue	Docker, servicios, logs, monitoreo
Docker	Imágenes Docker por servicio, recetas de compilación, configuración en tiempo de ejecución
Entorno	Referencia de variables de entorno
Rastreo	Algoritmo de rastreo de flujos de fondos
Decodificación y análisis	Decodificación y análisis (FFI de OCaml en proceso)
OSINT	Fuentes de datos OSINT e ingesta
Algoritmos de análisis	Análisis DeFi (arbitraje, sandwich, etc.)
Agrupamiento	Pipeline de agrupamiento y clasificación de direcciones
Componente de decodificación	Decodificación ABI
Frontend	Aplicación React

Desarrollo

Ver Convenciones de desarrollo:

Flujo de trabajo Git — Planificación de proyectos, commits, MRs, revisiones
Guías de código — Estándares de estilo y calidad
Organización del código fuente — Dónde va el código

Compilación

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

Licencia

Propietario — Functori

Argos — Actualizado!

Categorías