@blackcube/xgate-sdk 0.20.0 → 0.21.1

package/dist/index.d.cts

@@ -660,6 +660,22 @@ declare class WalletService {
      * regarde autrement qu'une panne.
      */
     balances(...accesses: IWalletAccess[]): Promise<IBalance[]>;
+    /**
+     * LE COLLATÉRAL PERPÉTUEL, ajouté aux soldes comptant — sans lui, un portefeuille peut paraître VIDE.
+     *
+     * `getBalances` ne rend que le **comptant**, chez les huit venues : c'est leur convention, et la
+     * documentation de chacune le dit. Or l'argent qui sert à trader n'y est pas. Sur un compte
+     * pacifica dont tout le solde est en marge, `getBalances` rend `[]` — ce qui se lit « pas
+     * d'argent » alors qu'il y a 499 USDC. Sur hyperliquid, le comptant s'affiche mais la marge
+     * manque.
+     *
+     * La ligne est **marquée `scope: 'perp'`** dans `xtras` : elle s'additionne au comptant sans le
+     * doubler, et un appelant qui ne veut que l'un des deux peut trancher.
+     *
+     * Le champ diffère par venue et n'est pas devinable — d'où la lecture explicite, venue par venue,
+     * plutôt qu'un parcours à l'aveugle d'un objet `unknown`.
+     */
+    private perpCollateral;
     /**
      * Les mouvements d'argent, triés du plus ancien au plus récent, montants **signés**.
      *
@@ -885,6 +901,34 @@ interface ITrade {
     filledAt: Date;
     xtras?: Record<string, unknown>;
 }
+/**
+ * CE QU'ON DEMANDE POUR DÉPLACER LE STOP D'UNE POSITION OUVERTE.
+ *
+ * Le geste du point mort : une position qui a couru se sécurise en remontant son stop, sans jamais
+ * la laisser nue. Les SDK posent le NOUVEAU stop avant d'annuler l'ANCIEN — l'ordre compte, et il
+ * est tenu par la venue, pas par l'appelant.
+ *
+ * **Le sens est celui de la POSITION**, comme partout ailleurs ici : le stop se pose au sens opposé,
+ * et c'est le SDK de la venue qui s'en charge.
+ */
+interface IMoveStop {
+    xex: XgateEx;
+    /** Le symbole que la venue attend. */
+    symbolXex: string;
+    /** Sens de la POSITION protégée. */
+    direction: Direction;
+    /** L'identifiant du stop à remplacer, tel que la venue l'a rendu. */
+    stopId: string;
+    /** Le nouveau niveau de déclenchement. Arrondi au tick de la paire par XGate. */
+    triggerPrice: number;
+    /** Taille couverte — normalement la position entière. */
+    size: number;
+    /** Pas de prix et de quantité de la paire. */
+    tickSize?: string | null;
+    lotSize?: string | null;
+    /** Écart entre déclenchement et borne d'exécution du déclenché. Défaut 0,5 %. */
+    slippagePct?: number;
+}
 /**
  * CE QU'ON DEMANDE POUR OUVRIR UNE POSITION PROTÉGÉE.
  *
@@ -982,6 +1026,22 @@ declare class TradingService {
      * Rend `null` quand il n'y a rien à fermer — un appel sur une position déjà close n'est pas une erreur.
      */
     closePosition(access: ITradingAccess, symbolXex: string): Promise<IOrder | null>;
+    /**
+     * DÉPLACE LE STOP d'une position ouverte — le geste du point mort.
+     *
+     * Le SDK de la venue pose le NOUVEAU stop **avant** d'annuler l'ancien : la position n'est jamais
+     * nue, pas même une milliseconde. C'est le même invariant qu'à l'ouverture, appliqué au milieu de
+     * la vie de la position.
+     *
+     * **Un stop du mauvais côté est refusé ici**, avant l'appel réseau. Pour un long, un stop au-dessus
+     * du marché se déclenche immédiatement et solde la position — la venue l'accepte sans broncher, et
+     * l'erreur ne se voit qu'une fois l'argent parti. Ce refus n'est pas de la prudence décorative :
+     * il a été écrit après avoir vu le cas se produire.
+     */
+    moveStop(access: ITradingAccess, input: IMoveStop, markPrice: number): Promise<{
+        symbolXex: string;
+        id: string;
+    }>;
     /**
      * LE PRIX DE SORTIE RÉEL d'une position, lu dans l'historique de la venue.
      *
@@ -1045,4 +1105,4 @@ declare function canonicalFromXex(rawSymbol: string, xexId: string): string;
  */
 declare function canonicalFromBase(base: string): string;
 
-export { CandlesService, CatalogService, type Direction, type IBalance, type ICandle, type ICandlesQuery, type IEntryWithProtection, type IEquityPoint, type IMovement, type IOrder, type IPair, type IPosition, type IPrice, type IProtection, type IProtectionInput, type IProtectionLeg, type ITrade, type ITradingAccess, type IWalletAccess, type IXexAccess, type IXexSpotSource, type MarketKind, type MovementKind, type MovementStatus, ORDER_STATUSES, type OrderStatus, type OrderType, PricesService, SPOT_XEXES, type Side, SpotCatalogService, TIMEFRAME_MINUTES, type TimeInForce, Timeframe, TradingService, type Unsubscribe, WALLET_XEXES, WalletService, WsCandlesService, XGATE_EXCHANGES, XgateEx, XgateModule, buildLevels, buildProtection, canonicalFromBase, canonicalFromXex, roundPrice, roundToStep, servesNatively, servesSpot, sourceFor, timeframeMs };
+export { CandlesService, CatalogService, type Direction, type IBalance, type ICandle, type ICandlesQuery, type IEntryWithProtection, type IEquityPoint, type IMoveStop, type IMovement, type IOrder, type IPair, type IPosition, type IPrice, type IProtection, type IProtectionInput, type IProtectionLeg, type ITrade, type ITradingAccess, type IWalletAccess, type IXexAccess, type IXexSpotSource, type MarketKind, type MovementKind, type MovementStatus, ORDER_STATUSES, type OrderStatus, type OrderType, PricesService, SPOT_XEXES, type Side, SpotCatalogService, TIMEFRAME_MINUTES, type TimeInForce, Timeframe, TradingService, type Unsubscribe, WALLET_XEXES, WalletService, WsCandlesService, XGATE_EXCHANGES, XgateEx, XgateModule, buildLevels, buildProtection, canonicalFromBase, canonicalFromXex, roundPrice, roundToStep, servesNatively, servesSpot, sourceFor, timeframeMs };

package/dist/index.d.ts

@@ -660,6 +660,22 @@ declare class WalletService {
      * regarde autrement qu'une panne.
      */
     balances(...accesses: IWalletAccess[]): Promise<IBalance[]>;
+    /**
+     * LE COLLATÉRAL PERPÉTUEL, ajouté aux soldes comptant — sans lui, un portefeuille peut paraître VIDE.
+     *
+     * `getBalances` ne rend que le **comptant**, chez les huit venues : c'est leur convention, et la
+     * documentation de chacune le dit. Or l'argent qui sert à trader n'y est pas. Sur un compte
+     * pacifica dont tout le solde est en marge, `getBalances` rend `[]` — ce qui se lit « pas
+     * d'argent » alors qu'il y a 499 USDC. Sur hyperliquid, le comptant s'affiche mais la marge
+     * manque.
+     *
+     * La ligne est **marquée `scope: 'perp'`** dans `xtras` : elle s'additionne au comptant sans le
+     * doubler, et un appelant qui ne veut que l'un des deux peut trancher.
+     *
+     * Le champ diffère par venue et n'est pas devinable — d'où la lecture explicite, venue par venue,
+     * plutôt qu'un parcours à l'aveugle d'un objet `unknown`.
+     */
+    private perpCollateral;
     /**
      * Les mouvements d'argent, triés du plus ancien au plus récent, montants **signés**.
      *
@@ -885,6 +901,34 @@ interface ITrade {
     filledAt: Date;
     xtras?: Record<string, unknown>;
 }
+/**
+ * CE QU'ON DEMANDE POUR DÉPLACER LE STOP D'UNE POSITION OUVERTE.
+ *
+ * Le geste du point mort : une position qui a couru se sécurise en remontant son stop, sans jamais
+ * la laisser nue. Les SDK posent le NOUVEAU stop avant d'annuler l'ANCIEN — l'ordre compte, et il
+ * est tenu par la venue, pas par l'appelant.
+ *
+ * **Le sens est celui de la POSITION**, comme partout ailleurs ici : le stop se pose au sens opposé,
+ * et c'est le SDK de la venue qui s'en charge.
+ */
+interface IMoveStop {
+    xex: XgateEx;
+    /** Le symbole que la venue attend. */
+    symbolXex: string;
+    /** Sens de la POSITION protégée. */
+    direction: Direction;
+    /** L'identifiant du stop à remplacer, tel que la venue l'a rendu. */
+    stopId: string;
+    /** Le nouveau niveau de déclenchement. Arrondi au tick de la paire par XGate. */
+    triggerPrice: number;
+    /** Taille couverte — normalement la position entière. */
+    size: number;
+    /** Pas de prix et de quantité de la paire. */
+    tickSize?: string | null;
+    lotSize?: string | null;
+    /** Écart entre déclenchement et borne d'exécution du déclenché. Défaut 0,5 %. */
+    slippagePct?: number;
+}
 /**
  * CE QU'ON DEMANDE POUR OUVRIR UNE POSITION PROTÉGÉE.
  *
@@ -982,6 +1026,22 @@ declare class TradingService {
      * Rend `null` quand il n'y a rien à fermer — un appel sur une position déjà close n'est pas une erreur.
      */
     closePosition(access: ITradingAccess, symbolXex: string): Promise<IOrder | null>;
+    /**
+     * DÉPLACE LE STOP d'une position ouverte — le geste du point mort.
+     *
+     * Le SDK de la venue pose le NOUVEAU stop **avant** d'annuler l'ancien : la position n'est jamais
+     * nue, pas même une milliseconde. C'est le même invariant qu'à l'ouverture, appliqué au milieu de
+     * la vie de la position.
+     *
+     * **Un stop du mauvais côté est refusé ici**, avant l'appel réseau. Pour un long, un stop au-dessus
+     * du marché se déclenche immédiatement et solde la position — la venue l'accepte sans broncher, et
+     * l'erreur ne se voit qu'une fois l'argent parti. Ce refus n'est pas de la prudence décorative :
+     * il a été écrit après avoir vu le cas se produire.
+     */
+    moveStop(access: ITradingAccess, input: IMoveStop, markPrice: number): Promise<{
+        symbolXex: string;
+        id: string;
+    }>;
     /**
      * LE PRIX DE SORTIE RÉEL d'une position, lu dans l'historique de la venue.
      *
@@ -1045,4 +1105,4 @@ declare function canonicalFromXex(rawSymbol: string, xexId: string): string;
  */
 declare function canonicalFromBase(base: string): string;
 
-export { CandlesService, CatalogService, type Direction, type IBalance, type ICandle, type ICandlesQuery, type IEntryWithProtection, type IEquityPoint, type IMovement, type IOrder, type IPair, type IPosition, type IPrice, type IProtection, type IProtectionInput, type IProtectionLeg, type ITrade, type ITradingAccess, type IWalletAccess, type IXexAccess, type IXexSpotSource, type MarketKind, type MovementKind, type MovementStatus, ORDER_STATUSES, type OrderStatus, type OrderType, PricesService, SPOT_XEXES, type Side, SpotCatalogService, TIMEFRAME_MINUTES, type TimeInForce, Timeframe, TradingService, type Unsubscribe, WALLET_XEXES, WalletService, WsCandlesService, XGATE_EXCHANGES, XgateEx, XgateModule, buildLevels, buildProtection, canonicalFromBase, canonicalFromXex, roundPrice, roundToStep, servesNatively, servesSpot, sourceFor, timeframeMs };
+export { CandlesService, CatalogService, type Direction, type IBalance, type ICandle, type ICandlesQuery, type IEntryWithProtection, type IEquityPoint, type IMoveStop, type IMovement, type IOrder, type IPair, type IPosition, type IPrice, type IProtection, type IProtectionInput, type IProtectionLeg, type ITrade, type ITradingAccess, type IWalletAccess, type IXexAccess, type IXexSpotSource, type MarketKind, type MovementKind, type MovementStatus, ORDER_STATUSES, type OrderStatus, type OrderType, PricesService, SPOT_XEXES, type Side, SpotCatalogService, TIMEFRAME_MINUTES, type TimeInForce, Timeframe, TradingService, type Unsubscribe, WALLET_XEXES, WalletService, WsCandlesService, XGATE_EXCHANGES, XgateEx, XgateModule, buildLevels, buildProtection, canonicalFromBase, canonicalFromXex, roundPrice, roundToStep, servesNatively, servesSpot, sourceFor, timeframeMs };

package/dist/index.js

@@ -759,6 +759,7 @@ var ORDER_STATUSES = [
 
 // src/services/trading.service.ts
 var VENUES_PROUVEES = ["pacifica" /* Pacifica */, "hyperliquid" /* Hyperliquid */];
+var VENUES_MOVE_STOP = ["hyperliquid" /* Hyperliquid */, "pacifica" /* Pacifica */, "aster" /* Aster */];
 var TradingService = class {
   logger = new Logger(TradingService.name);
   /**
@@ -899,6 +900,45 @@ var TradingService = class {
     }
     return closed;
   }
+  /**
+   * DÉPLACE LE STOP d'une position ouverte — le geste du point mort.
+   *
+   * Le SDK de la venue pose le NOUVEAU stop **avant** d'annuler l'ancien : la position n'est jamais
+   * nue, pas même une milliseconde. C'est le même invariant qu'à l'ouverture, appliqué au milieu de
+   * la vie de la position.
+   *
+   * **Un stop du mauvais côté est refusé ici**, avant l'appel réseau. Pour un long, un stop au-dessus
+   * du marché se déclenche immédiatement et solde la position — la venue l'accepte sans broncher, et
+   * l'erreur ne se voit qu'une fois l'argent parti. Ce refus n'est pas de la prudence décorative :
+   * il a été écrit après avoir vu le cas se produire.
+   */
+  async moveStop(access, input, markPrice) {
+    const trigger = roundPrice(input.triggerPrice, input.tickSize, input.lotSize);
+    const perdant = input.direction === "long" ? trigger >= markPrice : trigger <= markPrice;
+    if (perdant === true) {
+      throw new Error(
+        `moveStop(${access.xex}/${input.symbolXex}) : un stop ${input.direction} \xE0 ${trigger} est du mauvais c\xF4t\xE9 du march\xE9 (${markPrice}) \u2014 il se d\xE9clencherait aussit\xF4t et solderait la position.`
+      );
+    }
+    const perp = this.perpOf(access);
+    if (typeof perp.moveStop !== "function") {
+      throw new Error(
+        `moveStop(${access.xex}) : cette venue ne sait pas d\xE9placer un stop. Disponible sur ${VENUES_MOVE_STOP.join(", ")}.`
+      );
+    }
+    const glissement = input.slippagePct ?? 5e-3;
+    const borne = input.direction === "long" ? 1 - glissement : 1 + glissement;
+    const moved = await perp.moveStop({
+      name: input.symbolXex,
+      side: input.direction === "long" ? "buy" : "sell",
+      stopId: input.stopId,
+      triggerPrice: String(trigger),
+      size: String(roundToStep(input.size, input.lotSize, "floor")),
+      price: String(roundPrice(trigger * borne, input.tickSize, input.lotSize))
+    });
+    this.logger.log(`moveStop(${access.xex}/${input.symbolXex}) : stop port\xE9 \xE0 ${trigger}`);
+    return { symbolXex: moved.name, id: moved.id };
+  }
   /**
    * LE PRIX DE SORTIE RÉEL d'une position, lu dans l'historique de la venue.
    *
@@ -971,8 +1011,9 @@ var WalletService = class {
    */
   async balances(...accesses) {
     return this.collect(accesses, "balances", async (access) => {
-      const balances = await createAccountXex(access.xex, access).account().getBalances();
-      return balances.map((balance) => ({
+      const source = createAccountXex(access.xex, access);
+      const balances = await source.account().getBalances();
+      const lignes = balances.map((balance) => ({
         xex: access.xex,
         asset: balance.asset,
         total: balance.total,
@@ -980,8 +1021,48 @@ var WalletService = class {
         usdValue: balance.usdValue,
         xtras: balance.xtras
       }));
+      const collateral = await this.perpCollateral(source, access.xex);
+      return collateral === null ? lignes : [...lignes, collateral];
     });
   }
+  /**
+   * LE COLLATÉRAL PERPÉTUEL, ajouté aux soldes comptant — sans lui, un portefeuille peut paraître VIDE.
+   *
+   * `getBalances` ne rend que le **comptant**, chez les huit venues : c'est leur convention, et la
+   * documentation de chacune le dit. Or l'argent qui sert à trader n'y est pas. Sur un compte
+   * pacifica dont tout le solde est en marge, `getBalances` rend `[]` — ce qui se lit « pas
+   * d'argent » alors qu'il y a 499 USDC. Sur hyperliquid, le comptant s'affiche mais la marge
+   * manque.
+   *
+   * La ligne est **marquée `scope: 'perp'`** dans `xtras` : elle s'additionne au comptant sans le
+   * doubler, et un appelant qui ne veut que l'un des deux peut trancher.
+   *
+   * Le champ diffère par venue et n'est pas devinable — d'où la lecture explicite, venue par venue,
+   * plutôt qu'un parcours à l'aveugle d'un objet `unknown`.
+   */
+  async perpCollateral(source, xex) {
+    const facade = source;
+    if (typeof facade.perp !== "function") {
+      return null;
+    }
+    const scope = facade.perp();
+    if (typeof scope.getAccountInfo !== "function") {
+      return null;
+    }
+    const info = await scope.getAccountInfo();
+    const total = info.balance ?? info.marginSummary?.accountValue;
+    if (total === void 0 || Number(total) === 0) {
+      return null;
+    }
+    return {
+      xex,
+      asset: "USDC",
+      total,
+      available: info.availableToSpend ?? info.withdrawable ?? null,
+      usdValue: total,
+      xtras: { scope: "perp" }
+    };
+  }
   /**
    * Les mouvements d'argent, triés du plus ancien au plus récent, montants **signés**.
    *