xync-db 0.0.2__py3-none-any.whl

xync_db/__init__.py

@@ -0,0 +1,28 @@
+from os import getenv as env
+
+from dotenv import load_dotenv
+
+load_dotenv()
+
+TORM = {
+    "connections": {"default": env("DB_URL")},
+    "apps": {"models": {"models": ["xync_db.models"]}},
+    "use_tz": False,
+    "timezone": "UTC",
+}
+
+
+async def main():
+    import logging
+    from logging import DEBUG
+
+    from x_model import init_db
+
+    logging.basicConfig(level=DEBUG)
+    await init_db(TORM, create_tables=True)
+
+
+if __name__ == "__main__":
+    from asyncio import run
+
+    run(main())

xync_db/config.py

@@ -0,0 +1,18 @@
+"""Tortoise ORM configuration. Used by the CLI and by service lifecycle hooks."""
+
+from __future__ import annotations
+
+import os
+
+POSTGRES_DSN = os.getenv("POSTGRES_DSN", "postgres://xync:xync@localhost:5432/xync")
+
+TORTOISE_ORM: dict = {
+    "connections": {"default": POSTGRES_DSN},
+    "apps": {
+        "models": {
+            "models": ["xync_db.models", "xync_db.migrations.models"],
+            "default_connection": "default",
+            "migrations": "xync_db.migrations.models",
+        },
+    },
+}

xync_db/enums.py

@@ -0,0 +1,311 @@
+from enum import IntEnum
+
+ZERO_TS = 1770000000  # Feb 02 2026 02:40:00 (UTC)
+
+
+class PersonStatus(IntEnum):
+    VIP = 2
+    DEFAULT = 1
+    ANONYMOUS = 0
+    USER_DEF = -1
+    BLOCKED = -2
+
+
+class Side(IntEnum):
+    BUY = 0
+    SALE = 1
+
+
+class PriceType(IntEnum):
+    FIX = 0
+    FLOAT = 1
+
+
+class TransactionStatus(IntEnum):
+    request = 0  # no proof
+    signed = 1  # in proof: sender sign for transfer
+    verified = 2  # in proof: validator sign for transfer is valid
+
+
+class LinkType(IntEnum):
+    ref = 0  # open or trusted
+    request = 1  # open or personalized
+    receipt = 2  # signed or verified
+    contract = 3  # todo
+
+
+class UserStatus(IntEnum):
+    SLEEP = 0
+    PAY = 1
+    HOT_PARTNER = 2  # partner
+    XYNC_TEAM = 3
+
+
+class AdStatus(IntEnum):
+    defActive = 0
+    active = 1
+    soldOut = 2
+    old = 3
+    notFound = 9
+
+
+class HotStatus(IntEnum):
+    closed = 0
+    opened = 1
+
+
+class OrderStatus(IntEnum):
+    created = 1
+    paid = 2
+    completed = 3
+    cancel_requested_by_seller = 4
+    canceled = 5
+    appealed_by_seller = 6
+    appealed_by_buyer = 7
+    appeal_disputed = 8
+    # todo: 8T - один вирт экшн на бездействие обеих сторон, а 12T и 13T - по отдельности?
+    # COMPLETED, PENDING, TRADING, BUYER_PAYED, DISTRIBUTING, COMPLETED, IN_APPEAL, CANCELLED, CANCELLED_BY_SYSTEM
+
+
+class OrderErr(IntEnum):
+    ok = 0
+    i_wait_for_release = 1
+    payments_exists_on_cancel = 2
+    taker_balance_deficit = 3
+    # negative results is for agent
+    maker_balance_deficit = -4
+    uncompleted_orders = 5
+    wrong_status_for_hot = -6
+    cant_cancel = 7
+
+
+class OrderAction(IntEnum):
+    # requested
+    taker_create = 1
+    wait_for_cancel = 0
+    # created
+    buyer_pay = 2
+    seller_confirm = 3
+    buyer_cancel = 4
+    # paid
+    wait_for_pay = 5
+    seller_appeal = 6
+    buyer_appeal = 7
+    # appealed by seller
+    buyer_dispute_appeal_s = 8
+    buyer_agree_appeal_s = 10  # cancel
+    wait_appeal_s = 12  # -> cancel
+    # appealed by buyer
+    seller_dispute_appeal_b = 9
+    seller_agree_appeal_b = 11  # confirm
+    wait_appeal_b = 13  # -> confirm
+    wait_disputed_appeal = 14  # ?
+
+
+class CoinType(IntEnum):
+    normal = 1
+    game = 2
+    corp = 3
+    stock = 4
+
+
+class ExType(IntEnum):
+    p2p = 1
+    cex = 2
+    main = 3  # p2p+cex
+    dex = 4
+    tg = 5
+    futures = 8
+
+
+class DepType(IntEnum):
+    earn = 1
+    stake = 2
+    beth = 3
+    lend = 4
+
+
+class AddrExType(IntEnum):
+    spot = 1
+    earn = 2
+    found = 3
+
+
+class TradeType(IntEnum):
+    BUY = 0
+    SELL = 1
+
+
+class PmType(IntEnum):
+    common = 0
+    bank_acc = 1  # no. or IBAN
+    emoney = 2  # QR / phone-based
+    cash = 3  # ваучеры / агентские
+    card = 4  # fintech/processing
+    local = 5  # региональные: bank_routing-based: IFSC(Индия), CLABE(Мексика), банк.коды ЛатАм
+
+
+class TaskType(IntEnum):
+    invite_approve = 1
+    order_user_define = 2
+
+
+class FileType(IntEnum):
+    pdf = 1
+    jpg = 2
+    png = 3
+    webp = 4
+    mov = 5
+    mp4 = 6
+    gif = 7
+    svg = 8
+    tgs = 9
+    jpeg = 10
+
+
+class AgentStatus(IntEnum):
+    off = 0
+    race = 1
+    listen = 2
+    race_listen = 3
+    # ... = 4
+
+
+class SynonymType(IntEnum):
+    name = 1
+    ppo = 2
+    from_party = 3
+    to_party = 4
+    slip_req = 5
+    slip_send = 6
+    abuser = 7
+    scale = 8
+    slavic = 9
+    mtl_like = 10
+    bank = 11
+    bank_side = 12
+    sbp_strict = 13
+    contact = 14
+
+
+class Boundary(IntEnum):
+    no = 0
+    left_word = 1
+    right_word = 2
+    both_word = 3
+    left_all = 4
+    right_all = 5
+    both_all = 6
+
+
+class SbpStrict(IntEnum):
+    no = 0
+    sbp = 1
+    card = 2
+
+
+class Party(IntEnum):
+    fst = 0
+    fam = 1
+    lk = 2  # lk-photo/video/comment
+    trd = 3
+
+
+class Slip(IntEnum):
+    no = 0
+    screen = 1
+    pdf = 2
+    pdf_mail = 3
+
+
+class NameType(IntEnum):
+    no_slavic = 0
+    slavic = 1
+    fake = 2
+
+
+class AbuserType(IntEnum):
+    no = 0
+    rating = 1  # рейтинг: жмет "Оплачено" сразу, "Отмена" по апелляции
+    fake = 2  # реклама
+    cash = 3  # типа кэш обменник, но хз
+
+
+class ExStatus(IntEnum):
+    plan = 0
+    parted = 1
+    full = 2
+
+
+class ExAction(IntEnum):
+    """Order"""
+
+    get_orders = 0  # Получение заявок за заданное время, в статусе, по валюте, монете, направлению: `get_orders(status=OrderStatus.active, coin='USDT', cur='RUB', is_sell=False) => [order]`
+    order_request = 1  # [T] Запрос на старт сделки
+    order_request_ask = -1  # [M] - Запрос мейкеру на сделку
+    cancel_request = 2  # [T] Отмена запроса на сделку
+    request_canceled = -2  # [M] - Уведомление об отмене запроса на сделку
+    accept_request = 3  # [M] Одобрить запрос на сделку
+    request_accepted = -3  # [T] Уведомление об одобрении запроса на сделку
+    reject_request = 4  # [M] Отклонить запрос на сделку
+    request_rejected = -4  # [T] Уведомление об отклонении запроса на сделку
+    mark_payed = 5  # [B] Перевод сделки в состояние "оплачено", с отправкой чека
+    payed = -5  # [S] Уведомление продавца об оплате
+    cancel_order = 6  # [B] Отмена сделки
+    order_canceled = -6  # [S] Уведомление продавцу об отмене ордера покупателем
+    confirm = 7  # [S] Подтвердить получение оплаты
+    order_completed = -7  # [B] Уведомление покупателю об успешном завершении продавцом
+    appeal_available = -8  # [S, B] Уведомление о наступлении возможности подать апелляцию
+    start_appeal = 9  # , 10 # [S, B] Подать апелляцию со скриншотом/видео/файлом
+    appeal_started = -9  # , -10 # [S, B] Уведомление о поданной на меня апелляции
+    dispute_appeal = 11  # , 12 # [S, B] Встречное оспаривание полученной апелляции со скриншотом/видео/файлом
+    appeal_disputed = -11  # , -12 # [S, B] Уведомление о встречном оспаривание поданной апелляции
+    order_completed_by_appeal = -13  # [S, B] Уведомление о завершении сделки по апелляции
+    order_canceled_by_appeal = -14  # [B, S] Уведомление об отмене сделки по апелляции
+    cancel_appeal = 15  # [B, S] Отмена апелляции
+    appeal_canceled = -15  # [B, S] Уведомление об отмене апелляции против меня
+    send_order_msg = 16  # Отправка сообщения юзеру в чат по ордеру с приложенным файлом
+    got_order_msg = -16  # Получение сообщения в чате по ордеру
+    send_appeal_msg = 17  # Отправка сообщения по апелляции
+    got_appeal_msg = -17  # Получение сообщения по апелляции
+    """ Ex: Public """
+    # curs = 19 # Список поддерживаемых валют тейкера
+    pms = 20  # Список платежных методов по каждой валюте
+    cur_pms_map = 21  # Мэппинг валюта => платежные методы
+    coins = 22  # Список торгуемых монет (с ограничениями по валютам, если есть)
+    pairs = 23  # Список пар валюта/монет
+    ads = 24  # Список объяв по покупке/продаже, валюте, монете, платежному методу (buy/sell, cur, coin, pm)
+    set_coins = 44  # обновление монет биржи в бд
+    set_curs = 19  # обновление валют и платежек биржи в бд
+    set_pms = 45  # обновление валют и платежек биржи в бд
+    set_pairs = 46  # обновление пар биржи в бд
+    ad = 42  # Чужая объява по id
+    """ Agent: Fiat """
+    my_creds = 25  # Список реквизитов моих платежных методов
+    cred_new = 26  # Создание реквизита моего платежного метода
+    cred_upd = 27  # Редактирование реквизита моего платежного метода
+    cred_del = 28  # Удаление реквизита моего платежного метода
+    """ Agent: Ad """
+    my_ads = 29  # Список моих объявлений
+    my_ad = 43  # Моя объява по id
+    ad_new = 30  # Создание объявления
+    ad_upd = 31  # Редактирование объявления
+    ad_del = 32  # Удаление объявления
+    ad_switch = 33  # Вкл/выкл объявления
+    ads_switch = 34  # Вкл/выкл всех объявлений
+    """ Agent: Taker """
+    get_user = 35  # Получить объект юзера по его id
+    send_user_msg = 36  # Отправка сообщения юзеру с приложенным файлом
+    block_user = 37  # [Раз]Блокировать пользователя
+    rate_user = 38  # Поставить отзыв пользователю
+    """ Agent: Inbound """
+    got_user_msg = -36  # Получение сообщения от пользователя
+    got_blocked = -37  # Получение уведомления о [раз]блокировке пользователем
+    got_rated = -38  # Получение уведомления о полученном отзыве
+
+    """ Assets """
+    assets = 39  # Балансы моих монет
+    deposit = 40  # Получить реквизиты для депозита монеты
+    deposited = -40  # Получена монета
+    withdraw = 41  # Вывести монету
+    withdrew = -41  # Монета выведена

xync_db/exceptions.py

@@ -0,0 +1,18 @@
+from enum import IntEnum
+from json import loads
+
+from asyncpg.exceptions import RaiseError
+
+
+class ExcType(IntEnum):
+    InsufficientBalance = 1
+    TxIdPackMismatch = 2
+
+
+class PgRaiseError(ValueError):
+    typ: ExcType
+
+    def __init__(self, e: RaiseError) -> None:
+        typ, msg = e.args[0].split(": ")
+        self.typ = ExcType[typ]
+        super().__init__(typ, loads(msg))

xync_db/graph.py

@@ -0,0 +1,65 @@
+from xync_db.enums import OrderAction, OrderStatus
+
+acts = (
+    {  # buyer
+        # 1
+        OrderStatus.created: {
+            OrderAction.buyer_cancel: OrderStatus.canceled,
+            OrderAction.buyer_pay: OrderStatus.paid,
+        },
+        # 2
+        OrderStatus.paid: {
+            OrderAction.buyer_cancel: OrderStatus.canceled,
+            OrderAction.buyer_appeal: OrderStatus.appealed_by_buyer,
+        },
+        # 5
+        OrderStatus.appealed_by_seller: {
+            OrderAction.buyer_cancel: OrderStatus.canceled,
+            OrderAction.buyer_dispute_appeal_s: OrderStatus.appeal_disputed,
+        },
+        # 6
+        OrderStatus.appealed_by_buyer: {
+            OrderAction.buyer_cancel: OrderStatus.canceled,
+        },
+        # 7
+        OrderStatus.appeal_disputed: {
+            OrderAction.buyer_cancel: OrderStatus.canceled,
+        },
+    },
+    {  # seller
+        # 2
+        OrderStatus.paid: {
+            OrderAction.seller_confirm: OrderStatus.completed,
+            OrderAction.seller_appeal: OrderStatus.appealed_by_seller,
+        },
+        # 5
+        OrderStatus.appealed_by_seller: {
+            OrderAction.seller_confirm: OrderStatus.completed,
+        },
+        # 6
+        OrderStatus.appealed_by_buyer: {
+            OrderAction.seller_dispute_appeal_b: OrderStatus.appeal_disputed,
+            OrderAction.seller_confirm: OrderStatus.completed,
+        },
+        # 7
+        OrderStatus.appeal_disputed: {
+            OrderAction.seller_confirm: OrderStatus.completed,
+        },
+    },
+)
+
+
+waits: dict[OrderStatus, dict[OrderAction, OrderStatus]] = {
+    # 1
+    OrderStatus.created: {
+        OrderAction.wait_for_cancel: OrderStatus.canceled,
+    },
+    # 5
+    OrderStatus.appealed_by_seller: {
+        OrderAction.wait_appeal_s: OrderStatus.canceled,
+    },
+    # 6
+    OrderStatus.appealed_by_buyer: {
+        OrderAction.wait_appeal_b: OrderStatus.completed,
+    },
+}

xync_db/models/CLAUDE.md

@@ -0,0 +1,125 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+All Tortoise ORM models (~60) are defined in `__init__.py`. Models are organized into domain groups listed below.
+
+## Base Classes
+
+- **`Model`** (from `x_auth.models`) — primary base with `_name`, `_icon`, `PydanticMeta` support
+- **`BaseModel`** (tortoise) — used for through-tables (`CurEx`, `CoinEx`, `PmEx`, `PmExBank`) that don't need full model features
+- **`TgUser`** (from `x_auth.models`) — Telegram user base, extended by `User`
+- **`TsTrait`** (from `x_model.models`) — mixin adding auto `created_at`/`updated_at`
+
+Re-exported models from `x_auth`: `Username`, `Proxy`, `Dc`, `Fcm`, `App`, `Session`, `Peer`, `UpdateState`, `Version`, `Country` (as `BaseCountry`).
+
+## Field Conventions
+
+- **UInt fields**: `UInt1Field` (1 byte), `UInt2Field` (2), `UInt4Field` (4), `UInt8Field` (8) — custom unsigned integers from `x_model.field`
+- **Monetary integers**: amounts stored as `int / 10^scale` where `scale` comes from the related `Cur` or `Coin`
+- **Percentages**: stored as `/10_000` (basis points) — fields: `premium`, `fee`, `apr`
+- **Binary**: `BinaryField` for keys/proofs, `UniqBinaryField` for unique binary (e.g., `File.ref`)
+- **Timestamps**: `DatetimeSecField` for second-precision datetimes (`shared_at`, `payed_at`, etc.)
+- **FK convention**: all `ForeignKeyField` / `OneToOneField` use `on_update=CASCADE`
+- **Composite uniqueness**: via `Meta.unique_together`, commonly `(ex_id, exid)` for exchange-mapped entities
+
+## Model Attributes
+
+- **`_name`**: set of field paths for string representation (supports `__` traversal, e.g. `"pair_side__pairex__coin__ticker"`)
+- **`_icon`**: UI icon identifier (e.g. `"ad"`, `"seeding"`, `"file"`)
+- **`repr()`**: human-readable formatting on select models (`Cred`, `Dep`, `Investment`, `ExStat`, `Vpn`, `Invite`, `Credit`)
+
+## Domain Groups
+
+### Currency & Exchange
+`Cur` -> `CurEx` <- `Ex`, `Coin` -> `CoinEx` <- `Ex`, `Net`, `Pair` -> `PairSide` -> `PairEx`
+
+- `Cur.id` = `UInt1Field` (max 255 fiat currencies)
+- `Coin.id` = `SmallIntField`
+- `Ex.id` = `UInt1Field` (max 255 exchanges)
+- Through-tables (`CurEx`, `CoinEx`) carry `exid` (exchange's internal ID string) and exchange-specific `scale`/`minimum`
+
+### Users & Auth
+`Person` -> `User` (extends `TgUser`), `Actor` -> `Agent`
+
+- `Person` groups actors/credentials under a human identity; `status` via `PersonStatus`
+- `User` holds Ed25519 keypair (`prv`/`pub` as raw bytes) for signing `Transaction`s
+- `Actor` = exchange account `(ex_id, exid)` unique; links to `Person`
+- `Agent` = authenticated session (one-to-one with `Actor`); holds `auth` JSON blob + expiry
+- `Addr` = crypto deposit address `(coin_id, actor_id)` unique; linked to `Net`s via `NetAddr`
+- `Asset` = balance snapshot `(addr_id, agent_id, typ)` unique; amounts `free`/`freeze`/`lock`/`target`
+
+actor.set_user(username_id):
+При создании юзера(User) в sql-триггере автоматически создается персона(Person) с его user_id.
+А при создании актора(Actor) создается персона без user_id, но в actor.person_id = id этой персоны.
+И когда юзер заходит в объявление одного из агентов(Agent) первый раз, создается его актор для биржи (на которой 
+размещено это объявление) и новая персона этого актора.
+Если к персоне юзера еще не "привязано" ни одного актора, 2 персоны для юзера с одним актором избыточны, их нужно 
+смерджить: т.е старой персоне юзера назначить имя, креды(creds) и актора этой новой персоны, а новую "осиротевшую" 
+персону удалить.
+Далее, если этот же юзер будет заходить с других акторов:
+- других бирж, но с тем же именем: это та же персона нужно так же смерджить новую персону нового актора с существующей.
+- с другим именем: значит это уже другая персона, и существующая персона(ы) уже "занята" существующим(и) актором(ами), 
+тогда уже не надо мержить новую персону нового актора, оставляем новую.
+
+### Payment Methods
+`PmGroup` -> `Pm` -> `PmCur` <- `Cur`, `PmEx` <- `Ex`, `PmExBank`
+
+- `Pm.norm` — normalized name (used in dynamic client path: `xync_client.Pms.{norm}.agent`)
+- `Cred` = user's payment credential `(person_id, pmcur_id, ovr_pm_id)` unique
+- `CredEx` = credential registered on exchange `(ex_id, exid)` unique
+- `Fiat` = balance tracker (one-to-one with `Cred`): `amount`, `target`, `min_deposit`
+- `PmAgent` = automation account for a PM `(pm_id, user_id)` unique
+
+### P2P Trading
+`Ad` -> `MyAd` -> `Race` -> `RaceStat`, `Order` -> `Msg`/`Transfer`/`Task`, `Hot`
+
+- `Ad` = exchange advertisement `(exid, maker_id)` unique; carries `price`, `premium`, `amount`, `min_fiat`/`max_fiat`, `status` (`AdStatus`), optional `Cond`
+- `MyAd` = our managed ad (one-to-one with `Ad`); adds race tracking, share URLs, linked `CredEx`s
+- `Order` = P2P trade `(exid)` unique; references `Ad`, `Cred`, taker/maker `Actor`s; `status` via `OrderStatus`
+- `Hot` = warm-up trading session; many-to-many with `Actor`s and `Order`s
+- `Msg` = order chat message with optional `File` attachment
+- `Transfer` = order payment record with `amount`, optional `File` (receipt)
+
+### Conditions (Ad parsing)
+`Cond` -> `CondParsed`, `Synonym`, `CondSim`
+
+- `Cond.raw_txt` = original ad conditions text (4095 chars max, unique)
+- `CondParsed` = structured parse result: `to_party`/`from_party` (`Party`), `ppo`, `slip_req`/`slip_send` (`Slip`), abuse flags, linked bank `Pm`s
+- `Synonym` = condition term with `typ` (`SynonymType`), optional regex (`is_re`), boundary matching
+
+### Transactions (XyncPay)
+`Transaction`, `Sign`
+
+- `Transaction.id` = deterministic UUID packed from: `type(2bit) + ts(30bit) + cur_id(1byte) + receiver_id(3bytes) + amount(5bytes) + sender_id(3bytes)` = 16 bytes
+- `Transaction.proof` = 128 bytes (64 sender signature + 64 validator signature), Ed25519
+- `Transaction.status` progresses: `request` -> `signed` -> `verified`
+- Key methods: `pack` (property), `sign(front_sign)`, `approve(prv)`, `check(vld_pub)`, `snapshot(ts)` (raw SQL)
+- DB-level PL/pgSQL triggers enforce: balance checks on insert, immutability on update, no deletes
+
+### Financial Products
+`Dep` -> `Investment`, `TopUpAble` -> `TopUp`
+
+### Management
+`Limit`, `ExStat`, `Vpn`, `Invite`, `Credit`, `File`
+
+## Dynamic Client Loading
+
+Models delegate exchange-specific logic to `xync_client` via runtime imports:
+
+```
+Ex.client()       -> xync_client.{ex.name}.ex.ExClient
+Agent.client()    -> xync_client.{ex.name}.agent.AgentClient
+Actor.asset_client() -> xync_client.{ex.name}.asset.AssetClient
+Order.client()    -> xync_client.{ex.name}.order.OrderClient
+Pm.client()       -> xync_client.Pms.{pm.norm}
+PmAgent.client()  -> xync_client.Pms.{pm.norm}.agent
+```
+
+## Enums
+
+All enums are in `xync_db/enums.py` (all `IntEnum`). Key ones: `AdStatus`, `OrderStatus`, `OrderAction`, `OrderErr`, `ExType`, `ExStatus`, `ExAction` (~50 actions), `PmType`, `TransactionStatus`, `PersonStatus`, `UserStatus`, `HotStatus`, `FileType`, `DepType`, `AgentStatus`.
+
+`TransactionStatus` is imported as `TS` alias in this file.