Argos — 区块链资产追踪平台

Argos 是一个多语言区块链调查平台，用于在以太坊和比特币上追踪、分析和可视化资金流动。基于 Rust、OCaml 和 TypeScript/React 构建。

架构

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

解码、DeFi 分析和追踪通过直接的 Rust↔OCaml FFI（ocaml-interop）在 Rust 二进制文件内部以进程内方式运行——没有独立的微服务，也没有 gRPC 端口。

快速开始

完整设置说明请参阅快速入门。

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

文档

文档	描述
快速入门	先决条件、安装、首次运行
架构	系统拓扑与数据流
REST API	API 端点与认证
索引器	区块链索引器二进制文件
数据库	数据库模式与分区
部署	Docker、服务、日志、监控
Docker	各服务的 Docker 镜像、构建配方、运行时配置
环境	环境变量参考
追踪	资金流动追踪算法
解码与分析	解码与分析（进程内 OCaml FFI）
OSINT	OSINT 数据源与摄取
分析算法	DeFi 分析（套利、三明治等）
聚类	地址聚类与分类管道
解码组件	ABI 解码
前端	React 应用程序

开发

参见开发者约定：

• Git 工作流 — 项目规划、提交、MR、评审
• 代码指南 — 风格与质量标准
• 源代码组织 — 代码存放位置

构建

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

许可证

专有 — Functori