@blackcube/xgate-sdk 0.21.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**.
      *

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**.
      *

package/dist/index.js

@@ -1011,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,
@@ -1020,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**.
    *