aegis-spreadwatch README

README проекта с github.com/Lavagroabide/aegis-spreadwatch. Одним файлом markdown: README.md.

Aegis SpreadWatch

Tauri v2 Rust React License: MIT

Aegis SpreadWatch hero

Aegis SpreadWatch is a native, local-first CS2 trading workspace for people who want the numbers to stay legible. It separates market opportunities, account access, buy plans and fee assumptions into calm, purpose-built workspaces instead of one overloaded dashboard.

The UI ships with a deterministic 15-item market fixture so the terminal is useful immediately in development. Venue requests are isolated behind Rust commands and can be connected to authenticated adapters without changing the React surface.

Download

One zip, attached to the latest release. It carries Main.exe, its update settings and the Aegis SpreadWatch runtime, so nothing else has to be installed:

System File
Windows 10 and 11 aegis-spreadwatch.zip

Unpack the whole folder and start Main.exe. No installer, no admin rights.

Main.exe is code-signed, so Windows starts it without a warning. Keep Aegis SpreadWatch next to it: they ship together.

Product surface

Workspace Purpose Primary action
Spread scanner Compare executable buy/sell opportunities Inspect the net-return calculation
Account vaults Review inventory, access and local Steam Guard codes Import a vault for the current session
Buy orders Keep acquisition limits and bid position visible Create a local order plan
Connections & fees Set the assumptions behind every estimate Save a fee model or endpoint profile

Market model

Aegis treats every venue as a separate fee and settlement model. The scanner reports the amount that remains after the sell-side fee, not a headline spread.

Venue Default fee Settlement Role
Steam Community Market 13.00% USD High-liquidity exit reference
Buff163 2.50% CNY → USD Low-fee acquisition venue
CSFloat 2.00% USD Float-aware listings
Skinport 12.00% EUR → USD Consumer-facing exit venue
Waxpeer 6.00% USD Secondary liquidity route

Architecture

flowchart LR
  UI[React + TypeScript\nDense terminal UI] -->|invoke| CMD[Tauri v2 commands]
  CMD --> ENGINE[Net return engine\nfees + FX + hold state]
  CMD --> TOTP[Steam Guard TOTP\nHMAC-SHA1 in Rust]
  CMD --> VENUES[Venue adapters\nreqwest + rustls]
  CMD --> STORE[(app_data_dir\naegis-spreadwatch-state.json)]
  VENUES --> QUOTES[Market quotes]
  QUOTES --> UI

Local development

Requirements

Run the web surface

npm install
npm run dev

Starts the Vite frontend dev server with hot-reload at http://localhost:1420.

Run the native app

npm run tauri dev

Create a Windows installer

npm run tauri build

Tauri writes the Windows artifacts under src-tauri/target/release/bundle/. The included GitHub Actions workflow builds and attaches the installer when a v*.*.* tag is pushed.

Rust commands

The backend exposes small, testable commands:

Screenshots

Scanner Vaults
Scanner Vaults
Buy orders Endpoints
Orders Endpoints

Repository layout

aegis-spreadwatch/
├── src/
│   ├── App.tsx                 Desktop shell, spread scanner and Inspector
│   ├── Workspaces.tsx           Account vaults, buy plans and connection settings
│   ├── model.ts                 UI model, fee math and CSV export
│   └── styles.css               Product tokens and workspace layout
├── src-tauri/
│   ├── src/
│   │   ├── lib.rs               Tauri command entrypoint and public quote polling
│   │   ├── spread.rs            Engine Core: fee-adjusted spread calculations
│   │   ├── totp.rs              TOTP Vault: Steam Guard HMAC-SHA1 generation
│   │   └── state.rs             Local state: app-data JSON persistence
│   └── Cargo.toml               Native engine dependencies and bundle settings
├── docs/assets/
│   ├── logo.svg                 Aegis brand mark
│   ├── hero-banner.png          Project header banner
│   ├── demo-preview.gif         Workspace walkthrough
│   └── screenshots/             Scanner, vault, order and settings captures
├── .github/workflows/
│   └── release.yml              Windows installer release pipeline
├── package.json                 Frontend scripts and runtime dependencies
└── README.md                    Product, architecture and build documentation

License

MIT. See LICENSE.

aegis-spreadwatch (Lavagroabide/aegis-spreadwatch)

Ищем в базе…

Что это такое?Aegis SpreadWatch — нативное настольное приложение для торговли скинами CS2, которое сравнивает возможности покупки и продажи на разных площадках и на вашем устройстве считает чистую прибыль, ROI и допущения по комиссиям.
Это сайт или программа, которую нужно установить на компьютер?Это нативное настольное приложение (Tauri с бэкендом на Rust и фронтендом на React), а не веб-приложение и не расширение для браузера — вы скачиваете его и запускаете локально.
Как установить и запустить?Скачайте один zip-архив из последнего релиза на GitHub, распакуйте папку и запустите Main.exe напрямую — установщик не нужен, права администратора тоже не требуются, так как Main.exe подписан цифровой подписью.
Он автоматически получает живые цены со всех пяти площадок?В базовой версии терминал работает на детерминированном наборе из 15 предметов. Реальные данные площадок подтягиваются через команды Rust, например fetchpublicprice и syncinventories, которые нужно подключить к авторизованным адаптерам для каждой площадки — автоматически они не работают.
Работает ли он на macOS или Linux, или только на Windows?Опубликованный релиз работает только на Windows 10/11 и поставляется одним zip-архивом с Main.exe; сборки для macOS и Linux не предоставляются.
Где хранятся мои хранилища аккаунтов и коды Steam Guard?Всё остаётся на вашем компьютере: модели комиссий и метаданные хранилищ сохраняются в каталоге данных приложения Tauri, а расчёт чистой доходности выполняется локально, а не на удалённом сервере.
Что на самом деле делает команда generatetotp?Она расшифровывает сохранённый общий секрет Steam Guard и выдаёт текущий пятисимвольный код Steam Guard для активного 30-секундного интервала, так что телефон для подтверждения сделок не нужен.
Как он по-разному учитывает комиссии на разных площадках?У каждой площадки своя комиссия по умолчанию и валюта расчётов: Steam Community Market — 13% USD, Buff163 — 2.5% CNY→USD, CSFloat — 2% USD, Skinport — 12% EUR→USD и Waxpeer — 6% USD. Сканер показывает сумму, которая остаётся после комиссии продавца, а не сырой спред.
Зачем всё разделено на отдельные рабочие пространства, а не на один дашборд?Это сделано для того, чтобы числа оставались понятными: сканирование рынка, хранилища аккаунтов, ордера на покупку и настройки подключения и комиссий вынесены в отдельные панели, а не свалены на один перегруженный экран.
Какие есть похожие проекты?Ledgerify, floral-notepaper, spacedrive, codex-command-center, yaak, ChatGPT, Codex-X, Vibe-Research
Автор
Lavagroabide
Размер
1.3 MB
Звёзды
148
Возраст
19 д
Коммиты · 90 дней