@blackcube/xgate-sdk 0.23.0 → 0.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -9,6 +9,7 @@ import { Hyperliquid } from '@blackcube/hyperliquid-sdk';
9
9
  import { Lighter } from '@blackcube/lighter-sdk';
10
10
  import { Pacifica } from '@blackcube/pacifica-sdk';
11
11
  import { Paradex } from '@blackcube/paradex-sdk';
12
+ import { randomUUID } from 'crypto';
12
13
 
13
14
  var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
14
15
  var __decorateClass = (decorators, target, key, kind) => {
@@ -1167,7 +1168,8 @@ var ORDER_STATUSES = [
1167
1168
  ];
1168
1169
 
1169
1170
  // src/services/trading.service.ts
1170
- var VENUES_PROUVEES = ["pacifica" /* Pacifica */, "hyperliquid" /* Hyperliquid */];
1171
+ var VENUES_PROUVEES = ["pacifica" /* Pacifica */, "hyperliquid" /* Hyperliquid */, "aster" /* Aster */];
1172
+ var ASTER_TIMEOUT = "The request has timed out.";
1171
1173
  var VENUES_MOVE_STOP = ["hyperliquid" /* Hyperliquid */, "pacifica" /* Pacifica */, "aster" /* Aster */];
1172
1174
  var TradingService = class {
1173
1175
  logger = new Logger(TradingService.name);
@@ -1204,26 +1206,76 @@ var TradingService = class {
1204
1206
  `openWithProtection(${access.xex}) : cette venue n'expose pas l'ouverture prot\xE9g\xE9e atomique.`
1205
1207
  );
1206
1208
  }
1207
- const orders = await perp.createEntryWithProtection(
1208
- {
1209
- name: input.symbolXex,
1210
- side,
1211
- type: "limit",
1212
- size: String(input.size),
1213
- price: String(input.entry),
1214
- tif: input.tif ?? "ioc",
1215
- reduceOnly: false,
1216
- clientId: input.clientId
1217
- },
1218
- {
1219
- name: input.symbolXex,
1220
- side,
1221
- sl: protection.sl,
1222
- tps: protection.tps,
1223
- clientId: input.clientId
1209
+ const entry = {
1210
+ name: input.symbolXex,
1211
+ side,
1212
+ type: "limit",
1213
+ size: String(input.size),
1214
+ price: String(input.entry),
1215
+ tif: input.tif ?? "ioc",
1216
+ reduceOnly: false,
1217
+ clientId: input.clientId
1218
+ };
1219
+ const consigne = {
1220
+ name: input.symbolXex,
1221
+ side,
1222
+ sl: protection.sl,
1223
+ tps: protection.tps,
1224
+ clientId: input.clientId
1225
+ };
1226
+ try {
1227
+ const orders = await perp.createEntryWithProtection(entry, consigne);
1228
+ return orders.map((order) => this.toOrder(order, access.xex));
1229
+ } catch (error) {
1230
+ const message = error instanceof Error ? error.message : String(error);
1231
+ if (message.includes(ASTER_TIMEOUT) === false) {
1232
+ throw error;
1233
+ }
1234
+ this.logger.warn(
1235
+ `openWithProtection(${access.xex}) : la venue a coup\xE9 avant de r\xE9pondre. Statut inconnu \u2014 relecture de l'\xE9tat r\xE9el.`
1236
+ );
1237
+ return await this.etatApres(access, input.symbolXex);
1238
+ }
1239
+ }
1240
+ /**
1241
+ * CE QUE LA VENUE A RÉELLEMENT FAIT, après une réponse perdue.
1242
+ *
1243
+ * Un timeout ne dit pas « rien n'a été créé » : mesuré sur aster, deux exécutions identiques ont
1244
+ * produit deux sous-ensembles différents — une fois le stop et un take-profit, une fois l'entrée
1245
+ * seule. La seule vérité est au carnet, donc on va l'y chercher.
1246
+ *
1247
+ * **Lève si la position est nue** : une entrée remplie sans stop est exactement ce que ce service
1248
+ * existe pour empêcher, et le silence serait pire que l'erreur. L'appelant doit savoir qu'il a une
1249
+ * position à protéger, tout de suite.
1250
+ */
1251
+ async etatApres(access, symbolXex) {
1252
+ const perp = this.perpOf(access);
1253
+ const [ouverts, positions] = await Promise.all([
1254
+ perp.getOpens(),
1255
+ perp.getPositions({ name: symbolXex })
1256
+ ]);
1257
+ const surLaPaire = ouverts.filter((order) => order.name === symbolXex);
1258
+ const position = positions.find(
1259
+ (candidate) => candidate.name === symbolXex && Number(candidate.size) !== 0
1260
+ );
1261
+ const protege = surLaPaire.some((order) => order.reduceOnly === true);
1262
+ if (position !== void 0 && protege === false) {
1263
+ throw new Error(
1264
+ `openWithProtection(${access.xex}/${symbolXex}) : POSITION NUE \u2014 ${position.size} ouvert sans stop au carnet apr\xE8s une r\xE9ponse perdue. \xC0 prot\xE9ger imm\xE9diatement.`
1265
+ );
1266
+ }
1267
+ if (position === void 0 && surLaPaire.length > 0) {
1268
+ for (const orphelin of surLaPaire) {
1269
+ await perp.cancel({ name: symbolXex, id: orphelin.id }).catch(() => void 0);
1224
1270
  }
1271
+ throw new Error(
1272
+ `openWithProtection(${access.xex}/${symbolXex}) : r\xE9ponse perdue, lot incomplet \u2014 ${surLaPaire.length} ordre(s) orphelin(s) ANNUL\xC9(S). Rien n'est ouvert, rien ne tra\xEEne.`
1273
+ );
1274
+ }
1275
+ this.logger.log(
1276
+ `openWithProtection(${access.xex}/${symbolXex}) : ${surLaPaire.length} ordre(s) au carnet, position ${position === void 0 ? "absente" : position.size}.`
1225
1277
  );
1226
- return orders.map((order) => this.toOrder(order, access.xex));
1278
+ return surLaPaire.map((order) => this.toOrder(order, access.xex));
1227
1279
  }
1228
1280
  /** Les positions ouvertes d'un compte. */
1229
1281
  async positions(access, symbolXex) {
@@ -1365,6 +1417,193 @@ var TradingService = class {
1365
1417
  const last = exits[0];
1366
1418
  return last === void 0 ? null : last.price;
1367
1419
  }
1420
+ /**
1421
+ * L'HISTORIQUE DES ORDRES du compte — ce qui a été soumis, rempli, annulé ou expiré.
1422
+ *
1423
+ * À distinguer de {@link trades} : un ordre est une **intention**, une exécution est un **fait**.
1424
+ * Un ordre `filled` peut avoir été rempli en plusieurs fois, à des prix différents.
1425
+ *
1426
+ * Servi par les huit venues qui tradent.
1427
+ */
1428
+ async orderHistory(access, symbolXex) {
1429
+ const orders = await this.perpOf(access).getHistory(
1430
+ symbolXex === void 0 ? void 0 : { name: symbolXex }
1431
+ );
1432
+ return orders.map((order) => this.toOrder(order, access.xex));
1433
+ }
1434
+ /**
1435
+ * L'ÉTAT DU COMPTE — équité, disponible, marge immobilisée, marge de maintenance, PnL latent.
1436
+ *
1437
+ * Les venues rangent ces valeurs sous des noms qui n'ont rien à voir : `marginSummary.accountValue`
1438
+ * chez hyperliquid, `accountEquity` chez pacifica, `totalMarginBalance` chez aster — **mais elles
1439
+ * disent la même chose**. La forme native complète reste dans `xtras`, rien n'est perdu.
1440
+ *
1441
+ * **blofin ne l'expose pas** et lève ; les sept autres le servent.
1442
+ */
1443
+ async accountInfo(access) {
1444
+ const perp = this.perpOf(access);
1445
+ if (typeof perp.getAccountInfo !== "function") {
1446
+ throw new Error(
1447
+ `accountInfo(${access.xex}) : cette venue n'expose pas l'\xE9tat de son compte.`
1448
+ );
1449
+ }
1450
+ const brut = await perp.getAccountInfo();
1451
+ return this.toAccountState(brut, access.xex);
1452
+ }
1453
+ /**
1454
+ * RÈGLE LE LEVIER d'une paire, avant d'ouvrir.
1455
+ *
1456
+ * Le levier détermine la marge immobilisée, donc la taille tenable : le changer après l'ouverture
1457
+ * ne rejoue pas la position déjà prise. C'est un réglage préalable, pas un ajustement.
1458
+ *
1459
+ * **bullet ne l'expose pas** — son levier se fixe au compte, pas à la position — et lève.
1460
+ */
1461
+ async setLeverage(access, symbolXex, leverage) {
1462
+ const perp = this.perpOf(access);
1463
+ if (typeof perp.updateLeverage !== "function") {
1464
+ throw new Error(`setLeverage(${access.xex}) : cette venue ne r\xE8gle pas le levier par paire.`);
1465
+ }
1466
+ await perp.updateLeverage({ name: symbolXex, leverage });
1467
+ this.logger.log(`setLeverage(${access.xex}/${symbolXex}) : levier port\xE9 \xE0 ${leverage}`);
1468
+ }
1469
+ /**
1470
+ * CHOISIT LE MODE DE MARGE d'une paire : **isolée** ou **croisée**.
1471
+ *
1472
+ * En **croisée**, tout le solde du compte garantit la position : elle tient plus longtemps, mais
1473
+ * une liquidation emporte l'ensemble. En **isolée**, seule la marge affectée est en jeu : la perte
1474
+ * est bornée à ce montant, la liquidation arrive plus tôt.
1475
+ *
1476
+ * **À régler AVANT d'ouvrir.** Changer le mode d'une position vivante est refusé par la plupart
1477
+ * des venues, et là où c'est accepté, cela redistribue la garantie sous les pieds de la position.
1478
+ *
1479
+ * Servi par les trois venues de référence.
1480
+ */
1481
+ async setMarginMode(access, symbolXex, isolated) {
1482
+ const perp = this.perpOf(access);
1483
+ if (typeof perp.setMarginMode !== "function") {
1484
+ throw new Error(
1485
+ `setMarginMode(${access.xex}) : cette venue ne choisit pas son mode de marge.`
1486
+ );
1487
+ }
1488
+ await perp.setMarginMode({ name: symbolXex, isolated });
1489
+ this.logger.log(
1490
+ `setMarginMode(${access.xex}/${symbolXex}) : marge ${isolated === true ? "ISOL\xC9E" : "CROIS\xC9E"}`
1491
+ );
1492
+ }
1493
+ /**
1494
+ * AJOUTE DE LA MARGE à une position isolée — pour éloigner le prix de liquidation.
1495
+ *
1496
+ * C'est le geste qui sauve une position sous pression sans la réduire : on renforce la garantie
1497
+ * plutôt que de couper. **N'a de sens qu'en marge isolée** ; en croisée, tout le solde garantit
1498
+ * déjà la position et il n'y a rien à ajouter.
1499
+ *
1500
+ * Servi par les trois venues de référence.
1501
+ */
1502
+ async addMargin(access, symbolXex, amount) {
1503
+ const perp = this.perpOf(access);
1504
+ if (typeof perp.addIsolatedMargin !== "function") {
1505
+ throw new Error(`addMargin(${access.xex}) : cette venue n'ajoute pas de marge isol\xE9e.`);
1506
+ }
1507
+ await perp.addIsolatedMargin({ name: symbolXex, amount });
1508
+ this.logger.log(`addMargin(${access.xex}/${symbolXex}) : +${amount} de marge isol\xE9e`);
1509
+ }
1510
+ /**
1511
+ * RETIRE DE LA MARGE d'une position isolée — pour libérer du capital.
1512
+ *
1513
+ * L'inverse d'{@link addMargin} : la garantie diminue, donc le prix de liquidation **se rapproche**.
1514
+ * La venue refuse ce qui mettrait la position sous son seuil de maintenance.
1515
+ *
1516
+ * ⚠️ **pacifica ne l'expose pas** et lève : chez elle, la marge s'ajoute mais ne se retire pas.
1517
+ * Fermer partiellement la position libère alors le capital.
1518
+ */
1519
+ async removeMargin(access, symbolXex, amount) {
1520
+ const perp = this.perpOf(access);
1521
+ if (typeof perp.removeIsolatedMargin !== "function") {
1522
+ throw new Error(
1523
+ `removeMargin(${access.xex}) : cette venue ne retire pas de marge isol\xE9e \u2014 ferme partiellement la position pour lib\xE9rer du capital.`
1524
+ );
1525
+ }
1526
+ await perp.removeIsolatedMargin({ name: symbolXex, amount });
1527
+ this.logger.log(`removeMargin(${access.xex}/${symbolXex}) : \u2212${amount} de marge isol\xE9e`);
1528
+ }
1529
+ /**
1530
+ * L'HISTORIQUE DU FUNDING **PAYÉ** sur une paire — ce qui a réellement été prélevé ou reçu.
1531
+ *
1532
+ * À ne pas confondre avec le taux courant, que rend `PricesService` : celui-ci annonce ce qui
1533
+ * *sera* payé, celui-là dit ce qui *l'a été*. Un backtest qui ignore le funding réel surestime le
1534
+ * résultat d'une position tenue longtemps.
1535
+ *
1536
+ * Servi par les huit venues qui tradent.
1537
+ */
1538
+ async fundingHistory(access, symbolXex, range) {
1539
+ const perp = this.perpOf(access);
1540
+ if (typeof perp.getFundingHistory !== "function") {
1541
+ throw new Error(
1542
+ `fundingHistory(${access.xex}) : cette venue ne publie pas son historique de funding.`
1543
+ );
1544
+ }
1545
+ const rates = await perp.getFundingHistory({
1546
+ name: symbolXex,
1547
+ startTime: range?.startTime === void 0 ? void 0 : toXexDate(range.startTime),
1548
+ endTime: range?.endTime === void 0 ? void 0 : toXexDate(range.endTime),
1549
+ limit: range?.limit
1550
+ });
1551
+ return rates.map((rate) => ({
1552
+ xex: access.xex,
1553
+ symbolXex: rate.name,
1554
+ rate: rate.rate,
1555
+ appliedAt: rate.appliedAt,
1556
+ xtras: rate.xtras
1557
+ }));
1558
+ }
1559
+ /**
1560
+ * UN IDENTIFIANT APPLICATIF pour un ordre, **au format que la venue accepte**.
1561
+ *
1562
+ * C'est lui qui relie un ordre à la décision qui l'a produit : la venue le rend tel quel dans
1563
+ * `IOrder.clientId`, ce qui permet de retrouver son origine sans tenir de table de correspondance.
1564
+ *
1565
+ * **hyperliquid exige un hexadécimal préfixé `0x`** (128 bits) là où les autres acceptent un UUID
1566
+ * ordinaire. Passer le mauvais format fait rejeter l'ordre — d'où cette méthode plutôt qu'un
1567
+ * `randomUUID()` chez l'appelant.
1568
+ */
1569
+ newClientOrderId(xex) {
1570
+ const uuid = randomUUID();
1571
+ return xex === "hyperliquid" /* Hyperliquid */ ? `0x${uuid.replace(/-/gu, "")}` : uuid;
1572
+ }
1573
+ /**
1574
+ * LE COUPE-CIRCUIT : annule TOUS les ordres d'une paire, d'un geste.
1575
+ *
1576
+ * À réserver aux situations où l'on veut reprendre la main sans discuter — un état incohérent, un
1577
+ * arrêt d'urgence, une reprise après incident. Annuler un par un laisse une fenêtre pendant
1578
+ * laquelle certains ordres vivent encore.
1579
+ *
1580
+ * ⚠️ **Cela retire aussi les PROTECTIONS.** Stops et take-profits sont des ordres comme les
1581
+ * autres : une position ouverte se retrouve **nue** après ce geste. À n'employer que si la
1582
+ * position est fermée, ou si l'on repose une protection immédiatement — jamais pour « faire le
1583
+ * ménage » sur une position vivante.
1584
+ *
1585
+ * Rend le nombre d'ordres annulés quand la venue le publie, `null` sinon.
1586
+ */
1587
+ async cancelAll(access, symbolXex) {
1588
+ const perp = this.perpOf(access);
1589
+ if (typeof perp.cancelAll !== "function") {
1590
+ throw new Error(`cancelAll(${access.xex}) : cette venue n'annule pas en masse.`);
1591
+ }
1592
+ const positions = await perp.getPositions({ name: symbolXex });
1593
+ const ouverte = positions.find(
1594
+ (candidate) => candidate.name === symbolXex && Number(candidate.size) !== 0
1595
+ );
1596
+ if (ouverte !== void 0) {
1597
+ this.logger.warn(
1598
+ `cancelAll(${access.xex}/${symbolXex}) : ${ouverte.size} EN POSITION \u2014 ses protections partent avec. La position sera NUE.`
1599
+ );
1600
+ }
1601
+ const { cancelled } = await perp.cancelAll({ name: symbolXex });
1602
+ this.logger.log(
1603
+ `cancelAll(${access.xex}/${symbolXex}) : ${cancelled ?? "?"} ordre(s) annul\xE9(s)`
1604
+ );
1605
+ return cancelled;
1606
+ }
1368
1607
  /** Annule un ordre par son identifiant de venue. */
1369
1608
  async cancel(access, symbolXex, orderId) {
1370
1609
  await this.perpOf(access).cancel({ name: symbolXex, id: orderId });
@@ -1374,6 +1613,27 @@ var TradingService = class {
1374
1613
  const source = createAccountXex(access.xex, access);
1375
1614
  return source.perp();
1376
1615
  }
1616
+ /**
1617
+ * L'état natif d'une venue → {@link IAccountState}.
1618
+ *
1619
+ * Une lecture EXPLICITE par venue plutôt qu'un parcours à l'aveugle : les noms ne se devinent pas,
1620
+ * et prendre le premier champ qui ressemble à une équité produirait un chiffre faux sans que rien
1621
+ * ne le signale. `null` là où la venue ne publie pas la valeur — pas `0`, qui se lirait comme
1622
+ * « rien » alors que personne n'a rien dit.
1623
+ */
1624
+ toAccountState(brut, xex) {
1625
+ const texte = (valeur) => valeur === void 0 || valeur === null ? null : String(valeur);
1626
+ const marge = brut.marginSummary;
1627
+ return {
1628
+ xex,
1629
+ equity: texte(marge?.accountValue) ?? texte(brut.accountEquity) ?? texte(brut.totalMarginBalance) ?? "0",
1630
+ available: texte(brut.withdrawable) ?? texte(brut.availableToSpend) ?? texte(brut.availableBalance),
1631
+ marginUsed: texte(marge?.totalMarginUsed) ?? texte(brut.totalMarginUsed) ?? texte(brut.totalInitialMargin),
1632
+ maintenanceMargin: texte(brut.crossMaintenanceMarginUsed) ?? texte(brut.crossMmr) ?? texte(brut.totalMaintMargin),
1633
+ unrealizedPnl: texte(brut.totalUnrealizedProfit),
1634
+ xtras: brut
1635
+ };
1636
+ }
1377
1637
  /**
1378
1638
  * Le statut de la venue, VALIDÉ — jamais casté. Une venue qui inventerait un statut rendrait sinon
1379
1639
  * une valeur absente de tous les `switch` en aval, et personne ne la rattraperait.
@@ -1404,6 +1664,9 @@ var TradingService = class {
1404
1664
  TradingService = __decorateClass([
1405
1665
  Injectable()
1406
1666
  ], TradingService);
1667
+ function toXexDate(date) {
1668
+ return date.toISOString().slice(0, 19).replace("T", " ");
1669
+ }
1407
1670
  var WalletService = class {
1408
1671
  logger = new Logger(WalletService.name);
1409
1672
  /** Les venues dont le portefeuille est lisible aujourd'hui. */
@@ -1607,6 +1870,176 @@ var WsCandlesService = class {
1607
1870
  WsCandlesService = __decorateClass([
1608
1871
  Injectable()
1609
1872
  ], WsCandlesService);
1873
+ var WsTradesService = class {
1874
+ logger = new Logger(WsTradesService.name);
1875
+ /**
1876
+ * S'abonne aux exécutions d'un compte. Rend la fonction de désabonnement.
1877
+ *
1878
+ * Le handler reçoit **une exécution à la fois**, au format unifié, et **uniquement celles
1879
+ * survenues après l'abonnement** — le rejeu d'historique de la venue est écarté.
1880
+ */
1881
+ subscribe(access, handler) {
1882
+ const source = createAccountXex(access.xex, access);
1883
+ if (typeof source.ws !== "function") {
1884
+ throw new Error(`userTrades(${access.xex}) : cette venue n'expose pas de temps r\xE9el.`);
1885
+ }
1886
+ const ws = source.ws();
1887
+ if (typeof ws.subscribeUserTrades !== "function") {
1888
+ throw new Error(
1889
+ `userTrades(${access.xex}) : cette venue ne diffuse pas les ex\xE9cutions du compte.`
1890
+ );
1891
+ }
1892
+ const depuis = Date.now();
1893
+ let ecartees = 0;
1894
+ this.logger.log(`souscription ex\xE9cutions sur ${access.xex}`);
1895
+ return ws.subscribeUserTrades((trade) => {
1896
+ if (trade.filledAt.getTime() < depuis) {
1897
+ ecartees += 1;
1898
+ if (ecartees === 1) {
1899
+ this.logger.log(`${access.xex} : rejeu d'historique \xE9cart\xE9 (ant\xE9rieur \xE0 l'abonnement).`);
1900
+ }
1901
+ return;
1902
+ }
1903
+ handler(this.toTrade(trade, access.xex));
1904
+ });
1905
+ }
1906
+ /**
1907
+ * S'abonne aux exécutions de PLUSIEURS comptes, avec un seul handler.
1908
+ *
1909
+ * Chaque exécution porte son `xex` : l'appelant sait toujours de quelle venue elle vient. La
1910
+ * fonction rendue coupe tous les flux d'un coup — sinon il faudrait en garder N et n'en oublier
1911
+ * aucun.
1912
+ *
1913
+ * Une venue qui refuse est journalisée et ignorée : le reste des comptes doit continuer d'être
1914
+ * suivi. Sur un seul accès, l'échec est celui de l'appel.
1915
+ */
1916
+ subscribeAll(accesses, handler) {
1917
+ if (accesses.length === 0) {
1918
+ throw new Error("userTrades() : aucun compte demand\xE9 \u2014 pr\xE9cise au moins un acc\xE8s.");
1919
+ }
1920
+ const solo = accesses.length === 1;
1921
+ const stops = [];
1922
+ for (const access of accesses) {
1923
+ try {
1924
+ stops.push(this.subscribe(access, handler));
1925
+ } catch (error) {
1926
+ if (solo === true) {
1927
+ throw error;
1928
+ }
1929
+ const message = error instanceof Error ? error.message : String(error);
1930
+ this.logger.error(`souscription ${access.xex} refus\xE9e, venue ignor\xE9e : ${message}`);
1931
+ }
1932
+ }
1933
+ return () => {
1934
+ for (const stop of stops) {
1935
+ try {
1936
+ stop();
1937
+ } catch {
1938
+ }
1939
+ }
1940
+ };
1941
+ }
1942
+ /**
1943
+ * S'abonne aux ORDRES du compte — leur naissance, leur remplissage, leur mort.
1944
+ *
1945
+ * À distinguer des exécutions : un ordre est une **intention** dont on suit le cycle de vie
1946
+ * (`open` → `partiallyFilled` → `filled`, ou `canceled`), une exécution est un **fait** ponctuel.
1947
+ * Pour savoir qu'un stop vient de se déclencher, c'est ici qu'il faut écouter ; pour savoir à quel
1948
+ * prix, c'est {@link subscribe}.
1949
+ *
1950
+ * **Même règle que pour les exécutions** : seuls les ordres postérieurs à l'abonnement sont
1951
+ * transmis, le rejeu d'historique est écarté.
1952
+ */
1953
+ subscribeOrders(access, handler) {
1954
+ const ws = this.wsOf(access);
1955
+ if (typeof ws.subscribeOrders !== "function") {
1956
+ throw new Error(`orders(${access.xex}) : cette venue ne diffuse pas ses ordres.`);
1957
+ }
1958
+ const depuis = Date.now();
1959
+ this.logger.log(`souscription ordres sur ${access.xex}`);
1960
+ return ws.subscribeOrders((order) => {
1961
+ if (order.placedAt.getTime() >= depuis) {
1962
+ handler(this.toOrder(order, access.xex));
1963
+ }
1964
+ });
1965
+ }
1966
+ /**
1967
+ * S'abonne aux TRANSACTIONS PUBLIQUES d'un marché — celles de tout le monde, pas les siennes.
1968
+ *
1969
+ * C'est le flux qui dit ce qui se négocie réellement : prix, taille, sens agresseur. Il sert à
1970
+ * mesurer l'activité d'une paire, pas à suivre son compte — pour cela, {@link subscribe}.
1971
+ *
1972
+ * **Aucun filtre temporel ici** : un trade public est daté de son exécution et arrive en direct,
1973
+ * il n'y a pas d'historique rejoué à écarter.
1974
+ */
1975
+ subscribePublicTrades(access, symbolXex, handler) {
1976
+ const ws = this.wsOf(access);
1977
+ if (typeof ws.subscribeTrades !== "function") {
1978
+ throw new Error(`publicTrades(${access.xex}) : cette venue ne diffuse pas les transactions.`);
1979
+ }
1980
+ this.logger.log(`souscription transactions ${symbolXex} sur ${access.xex}`);
1981
+ return ws.subscribeTrades({ name: symbolXex }, (trade) => {
1982
+ handler({
1983
+ xex: access.xex,
1984
+ symbolXex: trade.name,
1985
+ price: trade.price,
1986
+ size: trade.size,
1987
+ side: trade.side,
1988
+ tradedAt: trade.tradedAt,
1989
+ xtras: trade.xtras
1990
+ });
1991
+ });
1992
+ }
1993
+ /** Le client temps réel d'un compte, avec ses souscriptions signées. */
1994
+ wsOf(access) {
1995
+ const source = createAccountXex(access.xex, access);
1996
+ if (typeof source.ws !== "function") {
1997
+ throw new Error(`${access.xex} : cette venue n'expose pas de temps r\xE9el.`);
1998
+ }
1999
+ return source.ws();
2000
+ }
2001
+ toOrder(order, xex) {
2002
+ return {
2003
+ xex,
2004
+ symbolXex: order.name,
2005
+ kind: order.kind,
2006
+ id: order.id,
2007
+ clientId: order.clientId,
2008
+ side: order.side,
2009
+ type: order.type,
2010
+ price: order.price,
2011
+ size: order.size,
2012
+ filled: order.filled,
2013
+ status: ORDER_STATUSES.includes(order.status) ? order.status : "other",
2014
+ tif: order.tif,
2015
+ reduceOnly: order.reduceOnly,
2016
+ placedAt: order.placedAt,
2017
+ xtras: order.xtras
2018
+ };
2019
+ }
2020
+ toTrade(trade, xex) {
2021
+ return {
2022
+ xex,
2023
+ symbolXex: trade.name,
2024
+ kind: trade.kind,
2025
+ id: trade.id,
2026
+ orderId: trade.orderId,
2027
+ side: trade.side,
2028
+ price: trade.price,
2029
+ size: trade.size,
2030
+ fee: trade.fee,
2031
+ feeAsset: trade.feeAsset,
2032
+ grossPnl: trade.grossPnl,
2033
+ netPnl: trade.netPnl,
2034
+ maker: trade.maker,
2035
+ filledAt: trade.filledAt,
2036
+ xtras: trade.xtras
2037
+ };
2038
+ }
2039
+ };
2040
+ WsTradesService = __decorateClass([
2041
+ Injectable()
2042
+ ], WsTradesService);
1610
2043
 
1611
2044
  // src/xgate.module.ts
1612
2045
  var XgateModule = class {
@@ -1618,6 +2051,7 @@ XgateModule = __decorateClass([
1618
2051
  CandlesService,
1619
2052
  CandlesStreamRegistry,
1620
2053
  WsCandlesService,
2054
+ WsTradesService,
1621
2055
  PricesService,
1622
2056
  SpotCatalogService,
1623
2057
  SpotCandlesService,
@@ -1630,6 +2064,7 @@ XgateModule = __decorateClass([
1630
2064
  CandlesService,
1631
2065
  CandlesStreamRegistry,
1632
2066
  WsCandlesService,
2067
+ WsTradesService,
1633
2068
  PricesService,
1634
2069
  SpotCatalogService,
1635
2070
  SpotCandlesService,
@@ -1640,6 +2075,6 @@ XgateModule = __decorateClass([
1640
2075
  })
1641
2076
  ], XgateModule);
1642
2077
 
1643
- export { CandlesService, CandlesStreamRegistry, CandlesStreamService, CatalogService, ORDER_STATUSES, PricesService, SPOT_XEXES, SpotCandlesService, SpotCatalogService, SpotPricesService, SpotWsCandlesService, TIMEFRAME_MINUTES, Timeframe, TradingService, WALLET_XEXES, WS_SUBSCRIPTION_LIMITS, WalletService, WsCandlesService, XGATE_EXCHANGES, XgateEx, XgateModule, buildLevels, buildProtection, canonicalFromBase, canonicalFromXex, expiryOf, isDated, multiplierFromXex, roundPrice, roundToStep, servesNatively, servesSpot, sourceFor, subscriptionLimitOf, timeframeMs };
2078
+ export { CandlesService, CandlesStreamRegistry, CandlesStreamService, CatalogService, ORDER_STATUSES, PricesService, SPOT_XEXES, SpotCandlesService, SpotCatalogService, SpotPricesService, SpotWsCandlesService, TIMEFRAME_MINUTES, Timeframe, TradingService, WALLET_XEXES, WS_SUBSCRIPTION_LIMITS, WalletService, WsCandlesService, WsTradesService, XGATE_EXCHANGES, XgateEx, XgateModule, buildLevels, buildProtection, canonicalFromBase, canonicalFromXex, expiryOf, isDated, multiplierFromXex, roundPrice, roundToStep, servesNatively, servesSpot, sourceFor, subscriptionLimitOf, timeframeMs };
1644
2079
  //# sourceMappingURL=index.js.map
1645
2080
  //# sourceMappingURL=index.js.map