Про проєкт
Приватний продукт для автоматизації операцій із криптовалютами в мережі Base. Доступ за запрошеннями.
Проєкт / 04
VolGen
Приватний продукт для автоматизації операцій із криптовалютами в мережі Base. Доступ за запрошеннями.
Особистий внесок
- Розробив фінансове ядро торгової системи в мережі Base: взаємодія зі смарт-контрактами через Web3.py, свопи на Aerodrome DEX та інтеграція з API Binance.
- Спроєктував модуль керування транзакціями з контролем nonce, динамічним перерахунком газу та гарантією ідемпотентності.
- Реалізував збереження проміжних станів пайплайну в PostgreSQL, забезпечивши відновлення незавершених операцій при рестартах воркерів.
Python, FastAPI, Web3.py, EVM, Base, PostgreSQL, Redis, ARQ, Docker
02 / Екрани продукту
Панель оператора
Адміністративний інтерфейс об'єднує кампанії, стан гаманців, пошук leads, облік та операційні докази в одному workspace.
Admin dashboard
6 screens · 1920 × 1080Знято з реального Next.js dashboard із репрезентативними локальними mock-даними. Backend-сервіси, PostgreSQL і workers для зйомки не запускалися.
03 / Case study
Завершена операційна платформа для кампаній у Base
VolGen — керована оператором платформа для створення кампаній, генерації гаманців, їх фінансування та виконання swap-операцій через Aerodrome у мережі Base. Вона об'єднує надійний фінансовий стан і черги задач, роботу із зовнішньою біржею, адміністративну панель та production ops-контур.
Можливості продукту
Кампанії, похідні гаманці та керовані demo-акаунти
Прогнозування пулів Aerodrome, маршрутизація та swap-виконання
Фінансування, конвертація та виведення через Binance
Пошук leads, звіти, CSV-експорт і Telegram-сповіщення
Аудит, системні логи, метрики, алерти та зашифровані backup
Інженерні рішення
PostgreSQL зберігає надійну істину
Кампанії, задачі, ledger-записи та ідентичність EVM-транзакцій фіксуються до зовнішніх side effects. Redis лише доставляє команди й координує короткочасні lock.
Відновлювані фонові задачі
API створює надійні записи, scheduler відправляє готову роботу, а execution workers захоплюють задачі та зберігають результат. Втрачені повідомлення можна відправити повторно; дублікати відсікаються станом задачі.
Тонка HTTP-межа
FastAPI routes відповідають за авторизацію та протокол. Services володіють бізнес-переходами, repositories — SQLAlchemy-запитами, а Dishka надає вже відкритий Unit of Work.
Валідовані контракти dashboard
Next.js dashboard використовує httpOnly cookie та власний API proxy. Zod-схеми перевіряють відповіді backend, а OpenAPI contract tests синхронізують обидві сторони.
Runtime-компоненти
Окремо перезапускні процеси навколо єдиного надійного джерела стану.
Next.js
Admin UI та API proxy
FastAPI
Auth, кампанії та планування
PostgreSQL
Задачі, ledger та аудит
ARQ Scheduler
Dispatch і reconciliation задач
Execution Worker
Swap і операції з гаманцями
Redis
Черги, leases та lock
Структура проєкту
Monorepo з явними межами застосунку та operations.
VOLGEN / MONOREPO
apps/product applications
backend/FastAPI application and asynchronous execution
src/main.pyapplication factory · routers · Dishka container
src/core/shared application infrastructure
config.pytyped environment configuration
database/async engine · models · repositories · Unit of Work
security.pyJWT · password and access primitives
redis.pypool · transient coordination
job_queues.pyARQ queue names and dispatch contracts
providers.pyapplication-scoped Dishka dependencies
src/blockchain/Base network and DEX integration
accounts.pydeterministic EVM wallet derivation
clients/evm.pyRPC balances · broadcast · receipts
dex/aerodrome.pypool prediction · routes · swap calldata
prices.pyETH/USD quote access and freshness rules
src/modules/business capabilities with explicit boundaries
campaigns/campaign lifecycle · pricing · planning
wallets/derived wallets · balances · native gas
accounting/ledger transactions and balanced entries
evm_transactions/durable nonce · signed payload · receipt state
swap_jobs/ + swap_logs/durable execution queue and swap history
deposits/ + withdrawals/Binance funding and payout workflows
wallet_operations/batch wallet commands and progress
warmups/wallet warmup profiles and jobs
exchanges/ + proxies/encrypted operator-managed credentials
lead_finder/DexScreener discovery and enrichment
users/accounts · invites · temporary and demo access
audit_logs/ + logs/business audit and Loki-backed system logs
notifications/Telegram delivery and templates
src/presentation/api/routes/thin HTTP and authorization boundary
src/worker/separately running ARQ processes
main_worker.pyexecution worker entrypoint
orchestrator/scheduler · selection · reconciliation
tasks/swap · deposit · withdrawal · warmup · wallet tasks
locks.py + job_retry.pycoordination and retry policy
tests/unit · architecture · PostgreSQL integration tests
dashboard/Next.js operator and client interface
app/dashboard/campaigns · wallets · ledger · leads · users · logs
app/api/[...path]/authenticated browser-to-backend proxy
components/admin/operational forms, panels and data tables
entities/Zod contracts for backend responses
lib/typed API clients · plans · formatting · polling
tests/contract, hydration and business-format tests
infra/deployment and production operations
docker/local · staging · production Compose topologies
monitoring/Prometheus · Grafana · Loki · Alertmanager · Promtail
traefik/HTTPS edge and protected /ops routes
backup/encrypted PostgreSQL backup and restore drill
postgres/container entrypoint helpers
homepage/internal operations portal configuration
docs/architecture · backend · database · workers · runbooks
scripts/alembic.shmigration command wrapper
Makefilelocal · dev · stack · ops command surface
.gitlab-ci.ymlbackend · dashboard · Compose delivery gates
Production-поставка
Репозиторій містить local, staging і production Compose-топології. Traefik завершує HTTPS; Prometheus, Grafana, Loki, Alertmanager і Promtail забезпечують спостережуваність; CloudBeaver надає захищений доступ до бази; зашифровані backup підтримують offsite upload і restore drills. GitLab CI перевіряє backend quality та integration, dashboard quality і build, а також Compose.
07 / Архітектура системи
Відкрити інтерактивну схему ↗Архітектура системи
Оригінальна документація проєкту російською