О проекте
Приватный продукт для автоматизации операций с криптовалютами в сети Base. Доступ по приглашениям.
Проект / 04
VolGen
Приватный продукт для автоматизации операций с криптовалютами в сети Base. Доступ по приглашениям.
Личный вклад
- Разработал финансовое ядро торговой системы в сети Base: операции со смарт-контрактами через Web3.py, свопы на Aerodrome DEX и интеграция с API Binance.
- Спроектировал модуль управления транзакциями с контролем nonce, динамическим пересчетом газа и гарантией идемпотентности.
- Реализовал сохранение промежуточных состояний пайплайна в PostgreSQL, обеспечив восстановление незавершенных операций при рестартах воркеров.
Python, FastAPI, Web3.py, EVM, Base, PostgreSQL, Redis, ARQ, Docker
02 / Экраны продукта
Панель оператора
Административный интерфейс объединяет кампании, состояние кошельков, поиск лидов, учёт и операционные данные в одном 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
Поиск лидов, отчёты, CSV-экспорт и Telegram-уведомления
Аудит, системные логи, метрики, алерты и зашифрованные резервные копии
Инженерные решения
PostgreSQL хранит надёжную истину
Кампании, задачи, ledger-записи и идентичность EVM-транзакций фиксируются до внешних side effects. Redis только доставляет команды и координирует краткосрочные блокировки.
Восстанавливаемые фоновые задачи
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 и блокировки
Структура проекта
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 предоставляет защищённый доступ к базе; зашифрованные резервные копии поддерживают offsite upload и restore drills. GitLab CI проверяет backend quality и integration, dashboard quality и build, а также Compose.
07 / Архитектура системы
Открыть интерактивную схему ↗Архитектура системы
Оригинальная документация проекта на русском