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 바이너리 내부에서 in-process로 실행됩니다. 별도의 마이크로서비스나 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 이미지, 빌드 레시피, 런타임 구성
환경	환경 변수 참조
추적	자금 흐름 추적 알고리즘
디코딩 및 분석	디코딩 및 분석(in-process 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

라이선스

Proprietary(사유) — Functori

Argos — Updated!

카테고리