@mysten/deepbook-v3 0.20.2 → 0.20.4

package/dist/esm/client.js

@@ -940,13 +940,13 @@ class DeepBookClient {
   // === Margin Manager Read-Only Functions ===
   /**
    * @description Get the owner address of a margin manager
-   * @param {string} poolKey The key to identify the pool
-   * @param {string} marginManagerId The ID of the margin manager
+   * @param {string} marginManagerKey The key to identify the margin manager
    * @returns {Promise<string>} The owner address
    */
-  async getMarginManagerOwner(poolKey, marginManagerId) {
+  async getMarginManagerOwner(marginManagerKey) {
+    const manager = __privateGet(this, _config).getMarginManager(marginManagerKey);
     const tx = new Transaction();
-    tx.add(this.marginManager.ownerByPoolKey(poolKey, marginManagerId));
+    tx.add(this.marginManager.ownerByPoolKey(manager.poolKey, manager.address));
     const res = await this.client.devInspectTransactionBlock({
       sender: normalizeSuiAddress(__privateGet(this, _address)),
       transactionBlock: tx
@@ -956,13 +956,13 @@ class DeepBookClient {
   }
   /**
    * @description Get the DeepBook pool ID associated with a margin manager
-   * @param {string} poolKey The key to identify the pool
-   * @param {string} marginManagerId The ID of the margin manager
+   * @param {string} marginManagerKey The key to identify the margin manager
    * @returns {Promise<string>} The DeepBook pool ID
    */
-  async getMarginManagerDeepbookPool(poolKey, marginManagerId) {
+  async getMarginManagerDeepbookPool(marginManagerKey) {
+    const manager = __privateGet(this, _config).getMarginManager(marginManagerKey);
     const tx = new Transaction();
-    tx.add(this.marginManager.deepbookPool(poolKey, marginManagerId));
+    tx.add(this.marginManager.deepbookPool(manager.poolKey, manager.address));
     const res = await this.client.devInspectTransactionBlock({
       sender: normalizeSuiAddress(__privateGet(this, _address)),
       transactionBlock: tx
@@ -972,13 +972,13 @@ class DeepBookClient {
   }
   /**
    * @description Get the margin pool ID (if any) associated with a margin manager
-   * @param {string} poolKey The key to identify the pool
-   * @param {string} marginManagerId The ID of the margin manager
+   * @param {string} marginManagerKey The key to identify the margin manager
    * @returns {Promise<string | null>} The margin pool ID or null if no active loan
    */
-  async getMarginManagerMarginPoolId(poolKey, marginManagerId) {
+  async getMarginManagerMarginPoolId(marginManagerKey) {
+    const manager = __privateGet(this, _config).getMarginManager(marginManagerKey);
     const tx = new Transaction();
-    tx.add(this.marginManager.marginPoolId(poolKey, marginManagerId));
+    tx.add(this.marginManager.marginPoolId(manager.poolKey, manager.address));
     const res = await this.client.devInspectTransactionBlock({
       sender: normalizeSuiAddress(__privateGet(this, _address)),
       transactionBlock: tx
@@ -989,13 +989,13 @@ class DeepBookClient {
   }
   /**
    * @description Get borrowed shares for both base and quote assets
-   * @param {string} poolKey The key to identify the pool
-   * @param {string} marginManagerId The ID of the margin manager
+   * @param {string} marginManagerKey The key to identify the margin manager
    * @returns {Promise<{baseShares: string, quoteShares: string}>} The borrowed shares
    */
-  async getMarginManagerBorrowedShares(poolKey, marginManagerId) {
+  async getMarginManagerBorrowedShares(marginManagerKey) {
+    const manager = __privateGet(this, _config).getMarginManager(marginManagerKey);
     const tx = new Transaction();
-    tx.add(this.marginManager.borrowedShares(poolKey, marginManagerId));
+    tx.add(this.marginManager.borrowedShares(manager.poolKey, manager.address));
     const res = await this.client.devInspectTransactionBlock({
       sender: normalizeSuiAddress(__privateGet(this, _address)),
       transactionBlock: tx
@@ -1008,13 +1008,13 @@ class DeepBookClient {
   }
   /**
    * @description Get borrowed base shares
-   * @param {string} poolKey The key to identify the pool
-   * @param {string} marginManagerId The ID of the margin manager
+   * @param {string} marginManagerKey The key to identify the margin manager
    * @returns {Promise<string>} The borrowed base shares
    */
-  async getMarginManagerBorrowedBaseShares(poolKey, marginManagerId) {
+  async getMarginManagerBorrowedBaseShares(marginManagerKey) {
+    const manager = __privateGet(this, _config).getMarginManager(marginManagerKey);
     const tx = new Transaction();
-    tx.add(this.marginManager.borrowedBaseShares(poolKey, marginManagerId));
+    tx.add(this.marginManager.borrowedBaseShares(manager.poolKey, manager.address));
     const res = await this.client.devInspectTransactionBlock({
       sender: normalizeSuiAddress(__privateGet(this, _address)),
       transactionBlock: tx
@@ -1024,13 +1024,13 @@ class DeepBookClient {
   }
   /**
    * @description Get borrowed quote shares
-   * @param {string} poolKey The key to identify the pool
-   * @param {string} marginManagerId The ID of the margin manager
+   * @param {string} marginManagerKey The key to identify the margin manager
    * @returns {Promise<string>} The borrowed quote shares
    */
-  async getMarginManagerBorrowedQuoteShares(poolKey, marginManagerId) {
+  async getMarginManagerBorrowedQuoteShares(marginManagerKey) {
+    const manager = __privateGet(this, _config).getMarginManager(marginManagerKey);
     const tx = new Transaction();
-    tx.add(this.marginManager.borrowedQuoteShares(poolKey, marginManagerId));
+    tx.add(this.marginManager.borrowedQuoteShares(manager.poolKey, manager.address));
     const res = await this.client.devInspectTransactionBlock({
       sender: normalizeSuiAddress(__privateGet(this, _address)),
       transactionBlock: tx
@@ -1040,13 +1040,13 @@ class DeepBookClient {
   }
   /**
    * @description Check if margin manager has base asset debt
-   * @param {string} poolKey The key to identify the pool
-   * @param {string} marginManagerId The ID of the margin manager
+   * @param {string} marginManagerKey The key to identify the margin manager
    * @returns {Promise<boolean>} True if has base debt, false otherwise
    */
-  async getMarginManagerHasBaseDebt(poolKey, marginManagerId) {
+  async getMarginManagerHasBaseDebt(marginManagerKey) {
+    const manager = __privateGet(this, _config).getMarginManager(marginManagerKey);
     const tx = new Transaction();
-    tx.add(this.marginManager.hasBaseDebt(poolKey, marginManagerId));
+    tx.add(this.marginManager.hasBaseDebt(manager.poolKey, manager.address));
     const res = await this.client.devInspectTransactionBlock({
       sender: normalizeSuiAddress(__privateGet(this, _address)),
       transactionBlock: tx
@@ -1056,13 +1056,13 @@ class DeepBookClient {
   }
   /**
    * @description Get the balance manager ID for a margin manager
-   * @param {string} poolKey The key to identify the pool
-   * @param {string} marginManagerId The ID of the margin manager
+   * @param {string} marginManagerKey The key to identify the margin manager
    * @returns {Promise<string>} The balance manager ID
    */
-  async getMarginManagerBalanceManagerId(poolKey, marginManagerId) {
+  async getMarginManagerBalanceManagerId(marginManagerKey) {
+    const manager = __privateGet(this, _config).getMarginManager(marginManagerKey);
     const tx = new Transaction();
-    tx.add(this.marginManager.balanceManager(poolKey, marginManagerId));
+    tx.add(this.marginManager.balanceManager(manager.poolKey, manager.address));
     const res = await this.client.devInspectTransactionBlock({
       sender: normalizeSuiAddress(__privateGet(this, _address)),
       transactionBlock: tx
@@ -1072,21 +1072,21 @@ class DeepBookClient {
   }
   /**
    * @description Calculate assets (base and quote) for a margin manager
-   * @param {string} poolKey The key to identify the pool
-   * @param {string} marginManagerId The ID of the margin manager
+   * @param {string} marginManagerKey The key to identify the margin manager
    * @param {number} decimals Number of decimal places to show (default: 6)
    * @returns {Promise<{baseAsset: string, quoteAsset: string}>} The base and quote assets
    */
-  async getMarginManagerAssets(poolKey, marginManagerId, decimals = 6) {
+  async getMarginManagerAssets(marginManagerKey, decimals = 6) {
+    const manager = __privateGet(this, _config).getMarginManager(marginManagerKey);
     const tx = new Transaction();
-    tx.add(this.marginManager.calculateAssets(poolKey, marginManagerId));
+    tx.add(this.marginManager.calculateAssets(manager.poolKey, manager.address));
     const res = await this.client.devInspectTransactionBlock({
       sender: normalizeSuiAddress(__privateGet(this, _address)),
       transactionBlock: tx
     });
     const baseBytes = res.results[0].returnValues[0][0];
     const quoteBytes = res.results[0].returnValues[1][0];
-    const pool = __privateGet(this, _config).getPool(poolKey);
+    const pool = __privateGet(this, _config).getPool(manager.poolKey);
     const baseCoin = __privateGet(this, _config).getCoin(pool.baseCoin);
     const quoteCoin = __privateGet(this, _config).getCoin(pool.quoteCoin);
     const baseAsset = __privateMethod(this, _DeepBookClient_instances, formatTokenAmount_fn).call(this, BigInt(bcs.U64.parse(new Uint8Array(baseBytes))), baseCoin.scalar, decimals);
@@ -1097,17 +1097,17 @@ class DeepBookClient {
    * @description Calculate debts (base and quote) for a margin manager
    * NOTE: This function automatically determines whether to use base or quote margin pool
    * based on hasBaseDebt. You don't need to specify the debt coin type.
-   * @param {string} poolKey The key to identify the pool
-   * @param {string} marginManagerId The ID of the margin manager
+   * @param {string} marginManagerKey The key to identify the margin manager
    * @param {number} decimals Number of decimal places to show (default: 6)
    * @returns {Promise<{baseDebt: string, quoteDebt: string}>} The base and quote debts
    */
-  async getMarginManagerDebts(poolKey, marginManagerId, decimals = 6) {
-    const hasBaseDebt = await this.getMarginManagerHasBaseDebt(poolKey, marginManagerId);
-    const pool = __privateGet(this, _config).getPool(poolKey);
+  async getMarginManagerDebts(marginManagerKey, decimals = 6) {
+    const hasBaseDebt = await this.getMarginManagerHasBaseDebt(marginManagerKey);
+    const manager = __privateGet(this, _config).getMarginManager(marginManagerKey);
+    const pool = __privateGet(this, _config).getPool(manager.poolKey);
     const debtCoinKey = hasBaseDebt ? pool.baseCoin : pool.quoteCoin;
     const tx = new Transaction();
-    tx.add(this.marginManager.calculateDebts(poolKey, debtCoinKey, marginManagerId));
+    tx.add(this.marginManager.calculateDebts(manager.poolKey, debtCoinKey, manager.address));
     const res = await this.client.devInspectTransactionBlock({
       sender: normalizeSuiAddress(__privateGet(this, _address)),
       transactionBlock: tx
@@ -1124,6 +1124,73 @@ class DeepBookClient {
     const quoteDebt = __privateMethod(this, _DeepBookClient_instances, formatTokenAmount_fn).call(this, BigInt(bcs.U64.parse(new Uint8Array(quoteBytes))), debtCoin.scalar, decimals);
     return { baseDebt, quoteDebt };
   }
+  /**
+   * @description Get comprehensive state information for a margin manager
+   * @param {string} marginManagerKey The key to identify the margin manager
+   * @param {number} decimals Number of decimal places to show (default: 6)
+   * @returns {Promise<{
+   *   managerId: string,
+   *   deepbookPoolId: string,
+   *   riskRatio: number,
+   *   baseAsset: string,
+   *   quoteAsset: string,
+   *   baseDebt: string,
+   *   quoteDebt: string,
+   *   basePythPrice: string,
+   *   basePythDecimals: number,
+   *   quotePythPrice: string,
+   *   quotePythDecimals: number
+   * }>} Comprehensive margin manager state
+   */
+  async getMarginManagerState(marginManagerKey, decimals = 6) {
+    const manager = __privateGet(this, _config).getMarginManager(marginManagerKey);
+    const tx = new Transaction();
+    tx.add(this.marginManager.managerState(manager.poolKey, manager.address));
+    const res = await this.client.devInspectTransactionBlock({
+      sender: normalizeSuiAddress(__privateGet(this, _address)),
+      transactionBlock: tx
+    });
+    if (!res.results || !res.results[0] || !res.results[0].returnValues) {
+      throw new Error(
+        `Failed to get margin manager state: ${res.effects?.status?.error || "Unknown error"}`
+      );
+    }
+    const pool = __privateGet(this, _config).getPool(manager.poolKey);
+    const baseCoin = __privateGet(this, _config).getCoin(pool.baseCoin);
+    const quoteCoin = __privateGet(this, _config).getCoin(pool.quoteCoin);
+    const managerId = normalizeSuiAddress(
+      bcs.Address.parse(new Uint8Array(res.results[0].returnValues[0][0]))
+    );
+    const deepbookPoolId = normalizeSuiAddress(
+      bcs.Address.parse(new Uint8Array(res.results[0].returnValues[1][0]))
+    );
+    const riskRatio = Number(bcs.U64.parse(new Uint8Array(res.results[0].returnValues[2][0]))) / FLOAT_SCALAR;
+    const baseAsset = __privateMethod(this, _DeepBookClient_instances, formatTokenAmount_fn).call(this, BigInt(bcs.U64.parse(new Uint8Array(res.results[0].returnValues[3][0]))), baseCoin.scalar, decimals);
+    const quoteAsset = __privateMethod(this, _DeepBookClient_instances, formatTokenAmount_fn).call(this, BigInt(bcs.U64.parse(new Uint8Array(res.results[0].returnValues[4][0]))), quoteCoin.scalar, decimals);
+    const baseDebt = __privateMethod(this, _DeepBookClient_instances, formatTokenAmount_fn).call(this, BigInt(bcs.U64.parse(new Uint8Array(res.results[0].returnValues[5][0]))), baseCoin.scalar, decimals);
+    const quoteDebt = __privateMethod(this, _DeepBookClient_instances, formatTokenAmount_fn).call(this, BigInt(bcs.U64.parse(new Uint8Array(res.results[0].returnValues[6][0]))), quoteCoin.scalar, decimals);
+    const basePythPrice = bcs.U64.parse(new Uint8Array(res.results[0].returnValues[7][0]));
+    const basePythDecimals = Number(
+      bcs.u8().parse(new Uint8Array(res.results[0].returnValues[8][0]))
+    );
+    const quotePythPrice = bcs.U64.parse(new Uint8Array(res.results[0].returnValues[9][0]));
+    const quotePythDecimals = Number(
+      bcs.u8().parse(new Uint8Array(res.results[0].returnValues[10][0]))
+    );
+    return {
+      managerId,
+      deepbookPoolId,
+      riskRatio,
+      baseAsset,
+      quoteAsset,
+      baseDebt,
+      quoteDebt,
+      basePythPrice: basePythPrice.toString(),
+      basePythDecimals,
+      quotePythPrice: quotePythPrice.toString(),
+      quotePythDecimals
+    };
+  }
   // === Margin Registry Functions ===
   /**
    * @description Check if a deepbook pool is enabled for margin trading