@blackcube/xgate-sdk 0.56.2 → 0.56.3

package/dist/index.cjs

@@ -1623,6 +1623,8 @@ exports.TradingService = 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.
    */
   async accountInfo(access) {
     const perp = this.perpOf(access);
@@ -1632,7 +1634,42 @@ exports.TradingService = class TradingService {
       );
     }
     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.