xync-db 0.6.1.dev1__tar.gz → 0.7.0__tar.gz

{xync_db-0.6.1.dev1 → xync_db-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: xync-db
-Version: 0.6.1.dev1
+Version: 0.7.0
 Summary: Xync DB schema: Tortoise ORM models, enums, pydantic DTOs.
 Author-email: Mike Artemiev <mixartemev@gmail.com>
 License: LicenseRef-EULA

{xync_db-0.6.1.dev1 → xync_db-0.7.0}/src/xync_db/enums.py

@@ -43,6 +43,17 @@ class W3SendStatus(IntEnum):
     done = 3
 
 
+class W3SwapStatus(IntEnum):
+    """Своп web3-монеты в фиат Xync (W3Swap, web3.md): pending — заявка, ждём монету с `frm`; received — external
+    поймал перевод (tx_hash, amount), api зачисляет фиат; done — зачислено (W3Swap.tx); manual — разбирает админ
+    (перевод без заявки или зачисление упало)."""
+
+    pending = 0
+    received = 1
+    done = 2
+    manual = 3
+
+
 class LinkType(IntEnum):
     ref = 0  # open or trusted
     request = 1  # open or personalized

{xync_db-0.6.1.dev1 → xync_db-0.7.0}/src/xync_db/migrations/models/0001_initial.py

@@ -39,6 +39,7 @@ from xync_db.enums import (
     TransactionStatus,
     UserStatus,
     W3SendStatus,
+    W3SwapStatus,
 )
 
 
@@ -1951,6 +1952,7 @@ class Migration(migrations.Migration):
                 ),
                 ("contract", fields.CharField(null=True, max_length=128)),
                 ("decimals", UInt1Field()),
+                ("scanned", fields.BigIntField(null=True)),
             ],
             options={
                 "table": "coin_net",
@@ -2602,6 +2604,81 @@ class Migration(migrations.Migration):
             options={"table": "transaction", "app": "models", "pk_attr": "id"},
             bases=["Model"],
         ),
+        ops.CreateModel(
+            name="W3Swap",
+            fields=[
+                ("id", fields.IntField(generated=True, primary_key=True, unique=True, db_index=True)),
+                ("created_at", DatetimeSecField(db_default=Now(), auto_now=False, auto_now_add=True)),
+                ("updated_at", DatetimeSecField(db_default=Now(), auto_now=True, auto_now_add=False)),
+                (
+                    "user",
+                    fields.ForeignKeyField(
+                        "models.User",
+                        source_field="user_id",
+                        null=True,
+                        db_constraint=True,
+                        to_field="id",
+                        related_name="w3_swaps",
+                        on_delete=OnDelete.CASCADE,
+                    ),
+                ),
+                (
+                    "coin_net",
+                    fields.ForeignKeyField(
+                        "models.CoinNet",
+                        source_field="coin_net_id",
+                        db_constraint=True,
+                        to_field="id",
+                        related_name="w3_swaps",
+                        on_delete=OnDelete.CASCADE,
+                    ),
+                ),
+                (
+                    "cur",
+                    fields.ForeignKeyField(
+                        "models.Cur",
+                        source_field="cur_id",
+                        null=True,
+                        db_constraint=True,
+                        to_field="id",
+                        related_name="w3_swaps",
+                        on_delete=OnDelete.CASCADE,
+                    ),
+                ),
+                ("frm", fields.CharField(max_length=128)),
+                ("rate", fields.FloatField(null=True)),
+                (
+                    "status",
+                    fields.IntEnumField(
+                        description="pending: 0\nreceived: 1\ndone: 2\nmanual: 3",
+                        db_default=W3SwapStatus.pending,
+                        enum_type=W3SwapStatus,
+                        generated=False,
+                    ),
+                ),
+                ("tx_hash", fields.CharField(null=True, unique=True, max_length=128)),
+                ("amount", UInt16Field(null=True)),
+                (
+                    "tx",
+                    fields.ForeignKeyField(
+                        "models.Transaction",
+                        source_field="tx_id",
+                        null=True,
+                        db_constraint=True,
+                        to_field="id",
+                        related_name="w3_swaps",
+                        on_delete=OnDelete.CASCADE,
+                    ),
+                ),
+            ],
+            options={
+                "table": "w3_swap",
+                "app": "models",
+                "pk_attr": "id",
+                "table_description": "Web3 coin → Xync fiat swap",
+            },
+            bases=["Model", "TsTrait"],
+        ),
         ops.CreateModel(
             name="Sign",
             fields=[

{xync_db-0.6.1.dev1 → xync_db-0.7.0}/src/xync_db/migrations/models/0002_triggers.py

@@ -16,6 +16,7 @@ Channels emitted:
     ads_upd / mads_upd        -- ad row changed (diff payload)
     creds_new/creds_del/creds_upd, credexs_del, credexs_orphan -- cred/credex lifecycle
     w3addr_wanted / w3addr_filled -- web3 address handshake
+    w3swap_received           -- w3_swap: монета свопа пришла (received) → api зачисляет фиат
 
 Guards (RAISE, без NOTIFY): tx_before (баланс/иммутабельность/монотонность), tx_no_delete,
 ad_exid_ex_uniq (exid уникален per-exchange), ad_cond_side_uniq/cond_txt_side_uniq (unique
@@ -475,6 +476,21 @@ $net_addr_upd$ LANGUAGE plpgsql;
 CREATE OR REPLACE TRIGGER net_addr_upd AFTER UPDATE ON "net_addr" FOR EACH ROW EXECUTE FUNCTION net_addr_upd();
 """
 
+# своп web3→фиат: external пишет пришедший перевод в заявку (status → received) — api зачисляет фиат. Каждый
+# UPDATE received-строки шлёт заново: так external рекикает потерянный NOTIFY (рестарт api), а зачисление
+# идемпотентно (claim received→done).
+W3SWAP_SQL = """
+CREATE OR REPLACE FUNCTION w3_swap_upd() RETURNS trigger AS $w3_swap_upd$
+BEGIN
+    IF NEW.status = 1 THEN
+        PERFORM pg_notify('w3swap_received', NEW.id::varchar);
+    END IF;
+    RETURN NULL;
+END
+$w3_swap_upd$ LANGUAGE plpgsql;
+CREATE OR REPLACE TRIGGER w3_swap_upd AFTER UPDATE ON "w3_swap" FOR EACH ROW EXECUTE FUNCTION w3_swap_upd();
+"""
+
 
 class Migration(BaseMigration):
     dependencies: ClassVar = [("models", "0001_initial")]
@@ -495,4 +511,5 @@ class Migration(BaseMigration):
         RunSQL(COND_SIDE_UNIQ_SQL),
         RunSQL(COND_GC_SQL),
         RunSQL(NET_ADDR_TRIGGERS_SQL),
+        RunSQL(W3SWAP_SQL),
     ]

{xync_db-0.6.1.dev1 → xync_db-0.7.0}/src/xync_db/migrations/models/seed/c_net_seed.py

@@ -1,6 +1,6 @@
 from tortoise import BaseDBAsyncClient
 
-from xync_db.models import Coin, Net
+from xync_db.models import Coin, CoinNet, Net
 
 # Сети web3-модуля фронта (ChainId, см. xync-web/src/web3/types.ts) → тикер их нативной монеты.
 # `Net.name` = идентификатор сети во фронте. id=0 — домашняя сеть Xync (как Coin/Ex id=0).
@@ -17,6 +17,18 @@ NETS: list[tuple[int, str, str]] = [
     (9, "btc", "BTC"),
 ]
 
+# Токены в сетях (CoinNet, `GET /public/coin-nets`, своп web3→фиат): (тикер, сеть, контракт, decimals) — как
+# в xync-pay/src/web3/tokens.ts.
+COIN_NETS: list[tuple[str, str, str, int]] = [
+    ("USDT", "eth", "0xdAC17F958D2ee523a2206206994597C13D831ec7", 6),
+    ("USDT", "bsc", "0x55d398326f99059fF775485246999027B3197955", 18),
+    ("USDT", "polygon", "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", 6),
+    ("USDT", "arbitrum", "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9", 6),
+    ("USDT", "gram", "EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs", 6),
+    ("USDT", "sol", "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB", 6),
+    ("USDT", "trx", "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", 6),
+]
+
 
 async def net_seed(db: BaseDBAsyncClient) -> str:
     # ARB/BASE/POL (нативные токены arbitrum/base/polygon, 18 decimals) не заводятся в
@@ -31,4 +43,9 @@ async def net_seed(db: BaseDBAsyncClient) -> str:
     coins = dict(await Coin.all().values_list("ticker", "id"))
     for nid, name, ticker in NETS:
         await Net.update_or_create({"name": name, "native_coin_id": coins[ticker]}, id=nid)
+    nets = dict(await Net.all().values_list("name", "id"))
+    for ticker, net, contract, decimals in COIN_NETS:
+        await CoinNet.update_or_create(
+            {"contract": contract, "decimals": decimals}, coin_id=coins[ticker], net_id=nets[net]
+        )
     return ""

{xync_db-0.6.1.dev1 → xync_db-0.7.0}/src/xync_db/models/__init__.py

@@ -97,6 +97,7 @@ from xync_db.enums import (
     TaskType,
     UserStatus,
     W3SendStatus,
+    W3SwapStatus,
 )
 from xync_db.enums import (
     TransactionStatus as TS,
@@ -201,6 +202,9 @@ class CoinNet(Model):
     net_id: int
     contract: str | None = CharField(128, null=True)
     decimals: int = UInt1Field()
+    # курсор скана входящих на адрес Xync (W3Swap): блок (EVM) / мс (trx) / unix-время (gram) / слот (sol);
+    # None — ещё не сканировали (первый скан ставит «сейчас»)
+    scanned: int | None = BigIntField(null=True)
 
     class Meta:
         table = "coin_net"
@@ -373,6 +377,64 @@ class W3Send(Model, TsTrait):
         table_description = "Outbound web3 send (NetAddr → NetAddr)"
 
 
+class W3Swap(Model, TsTrait):
+    """Своп web3-монеты в фиат Xync (web3.md): юзер шлёт токен `coin_net` с адреса `frm` на адрес Xync этой сети
+    (NetAddr user#0); external ловит входящий перевод (`tx_hash`, `amount` → received), api зачисляет `cur` от
+    user#0 по курсу `W3Swap.rates()` (курса нет — по котировке заявки `rate`) → done, `tx`. Перевод без заявки —
+    строка без user/cur со статусом manual (разбирает админ)."""
+
+    user: ForeignKeyNullableRelation[User] = ForeignKeyField("models.User", "w3_swaps", on_update=CASCADE, null=True)
+    user_id: int | None
+    coin_net: ForeignKeyRelation[CoinNet] = ForeignKeyField("models.CoinNet", "w3_swaps", on_update=CASCADE)
+    coin_net_id: int
+    cur: ForeignKeyNullableRelation[Cur] = ForeignKeyField("models.Cur", "w3_swaps", on_update=CASCADE, null=True)
+    cur_id: int | None
+    frm: str = CharField(128)  # адрес отправителя, нормализованный (common.chains.norm)
+    rate: float | None = FloatField(null=True)  # котировка при заявке: сколько cur за 1 монету
+    status: W3SwapStatus = IntEnumField(W3SwapStatus, db_default=W3SwapStatus.pending)
+    tx_hash: str | None = CharField(128, unique=True, null=True)
+    amount: int | None = UInt16Field(null=True)  # пришло on-chain, /10^coin_net.decimals (у BSC-USDT 18 знаков)
+    tx: ForeignKeyNullableRelation[Transaction] = ForeignKeyField(
+        "models.Transaction", "w3_swaps", on_update=CASCADE, null=True
+    )
+    tx_id: UUID | None
+
+    class Meta:
+        table = "w3_swap"
+        table_description = "Web3 coin → Xync fiat swap"
+
+    @staticmethod
+    async def rates() -> dict[tuple[int, int], float]:
+        """{(coin_id, cur_id): сколько cur за 1 монету} — курс свопа монеты в фиат по активным hot-объявам (как их
+        видит тейкер), без оглядки на лимиты и объёмы: есть покупные — самая дорогая; нет — зеркало самой дешёвой
+        продажной: цена, которую ads_fresh дал бы покупной объяве её слота (`mid·price_k`). Нет объяв — нет свопа."""
+        mads = await MyAd.hot_mads_query([]).exclude(Q(hex__isnull=True, ad__maker__ex_id__in=SHARE_HEX_EX_IDS))
+        curexs = {
+            (cx.ex_id, cx.cur_id): cx
+            for cx in await CurEx.filter(
+                ex_id__in={m.ad.maker.ex_id for m in mads}, cur_id__in={m.ad.pair_side.pair.cur_id for m in mads}
+            ).prefetch_related("cur")
+        }
+        rates: dict[tuple[int, int], float] = {}  # сначала — лучшие покупные
+        sells: dict[tuple[int, int], tuple[float, MyAd, tuple[int, int]]] = {}  # лучшая продажная + её слот
+        for m in mads:
+            pair = m.ad.pair_side.pair
+            cx = curexs[(m.ad.maker.ex_id, pair.cur_id)]
+            key, price = (pair.coin_id, pair.cur_id), m.ad.price * 10**-cx.scale
+            if not m.ad.pair_side.is_sell:
+                rates[key] = max(rates.get(key, 0), price)
+            elif (slot := Ad.slot_of(m.ad.min_fiat, m.ad.filtered, cx.minimum)) and (
+                key not in sells or price < sells[key][0]
+            ):
+                sells[key] = price, m, slot
+        for key, (_, m, (k_min, fltrd)) in sells.items():
+            if key not in rates:
+                ticker = curexs[(m.ad.maker.ex_id, key[1])].cur.ticker
+                k = m.ad.maker.ex.agent_cls().price_k(k_min, bool(fltrd), False, ticker)
+                rates[key] = m.ad.pair_side.pair.real() * k
+        return rates
+
+
 class PairEx(Model, TsTrait):
     pair: ForeignKeyRelation[Pair] = ForeignKeyField("models.Pair", "pairexs", on_update=CASCADE)
     pair_id: int