Argos — ブロックチェーン資産追跡プラットフォーム

Argos は、Ethereum および Bitcoin 上の資金の流れを追跡・分析・可視化するための多言語対応ブロックチェーン調査プラットフォームです。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

Argos — Updated!

カテゴリ