Про проєкт
Архівний прототип P2P-біржі з ledger-обліком і замінними блокчейн-адаптерами.
Проєкт / 08
CryptoExchange
Архівний прототип P2P-біржі з ledger-обліком і замінними блокчейн-адаптерами.
02 / Архітектурний розбір
P2P-біржа навколо інваріантів обліку
CryptoExchange є незавершеною white-label P2P-біржею для Telegram. Цінна частина проєкту: backend-модель, де offers, deals, disputes та reputation побудовані навколо double-entry ledger і замінних блокчейн-клієнтів.
03 / Ідея продукту
Мейкери публікують фіатні offers, тейкери відкривають deals, а криптоактив утримується у внутрішньому ledger до завершення, скасування або вирішення спору. Network indexers знаходять депозити, окремі workers обробляють облік, виведення та сповіщення.
Транзакційна межа
Бізнес-стан фіксується у PostgreSQL; зовнішні мережі обробляються через адаптери та workers.
Telegram Mini App
Користувацькі сценарії
FastAPI
Auth і команди
P2P modules
Offers, deals, disputes
Ledger + UoW
Холди й атомарні переходи
Chain registry
Адаптери TON, EVM і TRON
Workers
Депозити, виведення, сповіщення
Архітектурні рішення
Ledger як source of truth
Доступні та утримані кошти представлені збалансованими проводками замість змінюваних balance columns.
Атомарні переходи угоди
Unit of Work і row locks утримують статус угоди, обсяг offer та облікові зміни в одній транзакції.
Уніфіковані бізнес-модулі
Users, offers, deals, disputes та reputation мають однакову структуру model, schema, repository, service і provider.
Замінні chain-клієнти
BaseRPC і BaseIndexer ізолюють логіку застосунку від реалізацій TON, EVM і TRON, обраних через registry.
Окремі операційні процеси
Deposit, withdrawal, ledger і notification workers можуть перезапускатися та масштабуватися незалежно від API.
Карта проєкту
Межі модулів описують задуманий lifecycle біржі чіткіше, ніж незавершений інтерфейс.
CRYPTOEXCHANGE / BACKEND
backend/srcapplication root
core/database/async engine · UoW · base repository
modules/accounting/ledger · holds · settlements
modules/p2p/exchange domain
offers/maker listings and available volume
deals/paid · complete · cancel lifecycle
disputes/review and resolution
reputation/post-deal reviews
payment_methods/fiat requisites
blockchain/registry and chain interfaces
clients/ton/TON RPC and indexer
clients/evm/Ethereum and BNB adapters
clients/tron/TRX and TRC20 adapter prototype
modules/notification/templates and delivery
infra/docker/four independent workers
frontend/Next.js Telegram Mini App prototype
Межі прототипу
Core domain і ledger розвинені далі за presentation layer. Frontend усе ще містить mock-oriented екрани, а deposit sweeping, withdrawal processing і ledger validation не були завершені як перевірений end-to-end release.