@blackcube/xgate-sdk 0.56.1 → 0.56.3

package/dist/index.d.cts

@@ -1682,8 +1682,29 @@ declare class TradingService {
      * disent la même chose**. La forme native complète reste dans `xtras`, rien n'est perdu.
      *
      * **blofin ne l'expose pas** et lève ; les sept autres le servent.
+     *
+     * **hyperliquid en compte unifié lit le spot** (`unifiedAccountState`) : son état perp y vaut 0.
      */
     accountInfo(access: ITradingAccess): Promise<IAccountState>;
+    /**
+     * HYPERLIQUID EN COMPTE UNIFIÉ — l'argent vit dans le spot, et l'état perp affiche 0.
+     *
+     * La doc HL : « unified account and portfolio margin show all balances and holds in the spot
+     * clearinghouse state. Individual perp dex user states are not meaningful ». Lu côté perp, un
+     * compte unifié de 101 USDC rend une équité de 0 — et tout appelant qui dimensionne une mise sur
+     * l'équité refuse d'ouvrir (Blips, 2026-10-01 : « plafond d'engagement » sur un compte financé).
+     *
+     * Le mode est DEMANDÉ à HL (`getAbstraction`), jamais déduit des soldes : en mode standard
+     * (`disabled`), le spot ne finance pas les perps, et le compter fausserait l'équité dans l'autre
+     * sens. Hors `unifiedAccount`/`portfolioMargin`, l'état perp est rendu tel quel.
+     *
+     * L'équité est le total USDC du spot, le disponible ce total moins ce que HL bloque (`hold`).
+     * **Le PnL latent n'y est pas ajouté** (décision Philippe, 2026-10-01) : la doc ne dit pas si le
+     * total spot le contient déjà, et l'ajouter risquerait de le compter deux fois. En portfolio
+     * margin, les autres actifs éligibles (HYPE, BTC, USDT) ne sont pas comptés non plus : seul l'USDC
+     * finance ici. Le mode et le solde lu restent dans `xtras`.
+     */
+    private unifiedAccountState;
     /**
      * RÈGLE LE LEVIER d'une paire, avant d'ouvrir.
      *

package/dist/index.d.ts

@@ -1682,8 +1682,29 @@ declare class TradingService {
      * disent la même chose**. La forme native complète reste dans `xtras`, rien n'est perdu.
      *
      * **blofin ne l'expose pas** et lève ; les sept autres le servent.
+     *
+     * **hyperliquid en compte unifié lit le spot** (`unifiedAccountState`) : son état perp y vaut 0.
      */
     accountInfo(access: ITradingAccess): Promise<IAccountState>;
+    /**
+     * HYPERLIQUID EN COMPTE UNIFIÉ — l'argent vit dans le spot, et l'état perp affiche 0.
+     *
+     * La doc HL : « unified account and portfolio margin show all balances and holds in the spot
+     * clearinghouse state. Individual perp dex user states are not meaningful ». Lu côté perp, un
+     * compte unifié de 101 USDC rend une équité de 0 — et tout appelant qui dimensionne une mise sur
+     * l'équité refuse d'ouvrir (Blips, 2026-10-01 : « plafond d'engagement » sur un compte financé).
+     *
+     * Le mode est DEMANDÉ à HL (`getAbstraction`), jamais déduit des soldes : en mode standard
+     * (`disabled`), le spot ne finance pas les perps, et le compter fausserait l'équité dans l'autre
+     * sens. Hors `unifiedAccount`/`portfolioMargin`, l'état perp est rendu tel quel.
+     *
+     * L'équité est le total USDC du spot, le disponible ce total moins ce que HL bloque (`hold`).
+     * **Le PnL latent n'y est pas ajouté** (décision Philippe, 2026-10-01) : la doc ne dit pas si le
+     * total spot le contient déjà, et l'ajouter risquerait de le compter deux fois. En portfolio
+     * margin, les autres actifs éligibles (HYPE, BTC, USDT) ne sont pas comptés non plus : seul l'USDC
+     * finance ici. Le mode et le solde lu restent dans `xtras`.
+     */
+    private unifiedAccountState;
     /**
      * RÈGLE LE LEVIER d'une paire, avant d'ouvrir.
      *

package/dist/index.js

@@ -1621,6 +1621,8 @@ var TradingService = class {
    * disent la même chose**. La forme native complète reste dans `xtras`, rien n'est perdu.
    *
    * **blofin ne l'expose pas** et lève ; les sept autres le servent.
+   *
+   * **hyperliquid en compte unifié lit le spot** (`unifiedAccountState`) : son état perp y vaut 0.
    */
   async accountInfo(access) {
     const perp = this.perpOf(access);
@@ -1630,7 +1632,42 @@ var TradingService = class {
       );
     }
     const brut = await perp.getAccountInfo();
-    return this.toAccountState(brut, access.xex);
+    const etat = this.toAccountState(brut, access.xex);
+    return access.xex === "hyperliquid" /* Hyperliquid */ ? this.unifiedAccountState(access, etat) : etat;
+  }
+  /**
+   * HYPERLIQUID EN COMPTE UNIFIÉ — l'argent vit dans le spot, et l'état perp affiche 0.
+   *
+   * La doc HL : « unified account and portfolio margin show all balances and holds in the spot
+   * clearinghouse state. Individual perp dex user states are not meaningful ». Lu côté perp, un
+   * compte unifié de 101 USDC rend une équité de 0 — et tout appelant qui dimensionne une mise sur
+   * l'équité refuse d'ouvrir (Blips, 2026-10-01 : « plafond d'engagement » sur un compte financé).
+   *
+   * Le mode est DEMANDÉ à HL (`getAbstraction`), jamais déduit des soldes : en mode standard
+   * (`disabled`), le spot ne finance pas les perps, et le compter fausserait l'équité dans l'autre
+   * sens. Hors `unifiedAccount`/`portfolioMargin`, l'état perp est rendu tel quel.
+   *
+   * L'équité est le total USDC du spot, le disponible ce total moins ce que HL bloque (`hold`).
+   * **Le PnL latent n'y est pas ajouté** (décision Philippe, 2026-10-01) : la doc ne dit pas si le
+   * total spot le contient déjà, et l'ajouter risquerait de le compter deux fois. En portfolio
+   * margin, les autres actifs éligibles (HYPE, BTC, USDT) ne sont pas comptés non plus : seul l'USDC
+   * finance ici. Le mode et le solde lu restent dans `xtras`.
+   */
+  async unifiedAccountState(access, etat) {
+    const source = createAccountXex(access.xex, access);
+    const abstraction = await source.native.account().getAbstraction();
+    if (abstraction.mode !== "unifiedAccount" && abstraction.mode !== "portfolioMargin") {
+      return etat;
+    }
+    const usdc = (await source.account().getBalances()).find((balance) => balance.asset === "USDC");
+    const total = usdc?.total ?? "0";
+    const hold = Number(usdc?.xtras?.hold ?? 0);
+    return {
+      ...etat,
+      equity: total,
+      available: String(Math.max(0, Number(total) - hold)),
+      xtras: { ...etat.xtras, abstraction: abstraction.mode, spotUsdc: usdc ?? null }
+    };
   }
   /**
    * RÈGLE LE LEVIER d'une paire, avant d'ouvrir.