
UpdatedAug 7, 2026
Argos — Updated!
تحليل وتمثيل الرسوم البيانية للعمليات المشبوهة (Analyse et Représentation des Graphes des Opérations Suspectes)
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 الثنائية عبر واجهة Rust↔OCaml FFI المباشرة (ocaml-interop) — لا توجد خدمات مصغّرة منفصلة ولا منافذ 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 — تخطيط المشروع، والالتزامات، وطلبات الدمج، والمراجعات
- إرشادات الكود — معايير الأسلوب والجودة
- تنظيم المصدر — أين يذهب الكود
البناء
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