@mento-protocol/mento-sdk 3.2.0 → 3.2.1

package/dist/services/borrow/BorrowService.js

@@ -11,16 +11,18 @@ const borrowTransactionService_1 = require("./internal/borrowTransactionService"
  * handle interest rates and batch managers, and query position data.
  *
  * All `build*` methods return `CallParams` ({ to, data, value }) that can be
- * executed with any wallet client. The `debtTokenSymbol` parameter (e.g., 'USDm')
+ * executed with any wallet client. The `debtTokenSymbol` parameter (e.g., 'GBPm')
  * identifies which borrowing deployment to interact with.
  *
  * @example
  * ```typescript
  * const mento = await Mento.create(ChainId.CELO)
  *
+ * const ownerIndex = await mento.borrow.findNextAvailableOwnerIndex('GBPm', '0x...', '0x...')
+ *
  * // Open a trove
- * const tx = await mento.borrow.buildOpenTroveTransaction('USDm', {
- *   owner: '0x...', ownerIndex: 0,
+ * const tx = await mento.borrow.buildOpenTroveTransaction('GBPm', {
+ *   owner: '0x...', ownerIndex,
  *   collAmount: parseUnits('10', 18),
  *   boldAmount: parseUnits('1000', 18),
  *   annualInterestRate: parseUnits('0.05', 18),
@@ -40,7 +42,7 @@ class BorrowService {
      * Builds a transaction to open a new trove (borrowing position).
      * Requires prior collateral approval via `buildCollateralApprovalParams`.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param params - Trove opening parameters including collateral, debt amount, and interest rate
      * @returns Transaction parameters ready to send
      */
@@ -50,7 +52,7 @@ class BorrowService {
     /**
      * Builds a transaction to adjust an existing trove's collateral and/or debt.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param params - Adjustment parameters specifying collateral/debt changes
      * @returns Transaction parameters ready to send
      */
@@ -58,10 +60,13 @@ class BorrowService {
         return this.withContext(debtTokenSymbol, (ctx) => this.txService.buildAdjustTroveTransaction(ctx, params));
     }
     /**
-     * Builds a transaction to adjust a zombie trove (a trove that fell below minimum debt
-     * after a liquidation). Same parameters as `buildAdjustTroveTransaction`.
+     * Builds a transaction to adjust a zombie trove. Zombie troves are still-open troves whose
+     * debt fell below the branch minimum debt, typically after a redemption.
+     *
+     * Use this when `getTroveData()` or `getUserTroves()` returns `status === 'zombie'`.
+     * Same parameters as `buildAdjustTroveTransaction`.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param params - Adjustment parameters specifying collateral/debt changes
      * @returns Transaction parameters ready to send
      */
@@ -71,7 +76,7 @@ class BorrowService {
     /**
      * Builds a transaction to close a trove, repaying all debt and reclaiming collateral.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param troveId - The NFT token ID identifying the trove
      * @returns Transaction parameters ready to send
      */
@@ -82,7 +87,7 @@ class BorrowService {
      * Builds a transaction to add collateral to an existing trove.
      * Requires prior collateral approval via `buildCollateralApprovalParams`.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param troveId - The NFT token ID identifying the trove
      * @param amount - Amount of collateral to add (in wei)
      * @returns Transaction parameters ready to send
@@ -93,7 +98,7 @@ class BorrowService {
     /**
      * Builds a transaction to withdraw collateral from an existing trove.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param troveId - The NFT token ID identifying the trove
      * @param amount - Amount of collateral to withdraw (in wei)
      * @returns Transaction parameters ready to send
@@ -104,7 +109,7 @@ class BorrowService {
     /**
      * Builds a transaction to borrow additional debt against an existing trove.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param troveId - The NFT token ID identifying the trove
      * @param amount - Additional debt amount to borrow (in wei)
      * @param maxFee - Maximum upfront fee the borrower is willing to pay (in wei)
@@ -116,7 +121,7 @@ class BorrowService {
     /**
      * Builds a transaction to repay debt on an existing trove.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param troveId - The NFT token ID identifying the trove
      * @param amount - Amount of debt to repay (in wei)
      * @returns Transaction parameters ready to send
@@ -127,7 +132,7 @@ class BorrowService {
     /**
      * Builds a transaction to change the annual interest rate on a trove.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param troveId - The NFT token ID identifying the trove
      * @param newRate - New annual interest rate (18-decimal fixed-point, e.g., parseUnits('0.05', 18) for 5%)
      * @param maxFee - Maximum upfront fee the borrower is willing to pay (in wei)
@@ -138,8 +143,10 @@ class BorrowService {
     }
     /**
      * Builds a transaction to claim collateral surplus after a liquidation.
+     * This is for collateral held in the surplus pool after `closedByLiquidation`.
+     * Zombie troves with remaining collateral should usually be closed or adjusted instead.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @returns Transaction parameters ready to send
      */
     buildClaimCollateralTransaction(debtTokenSymbol) {
@@ -148,7 +155,7 @@ class BorrowService {
     /**
      * Builds a transaction to delegate interest rate management to a batch manager.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param troveId - The NFT token ID identifying the trove
      * @param manager - Address of the batch manager contract
      * @param maxFee - Maximum upfront fee the borrower is willing to pay (in wei)
@@ -160,7 +167,7 @@ class BorrowService {
     /**
      * Builds a transaction to remove a trove from a batch manager, setting a new individual rate.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param troveId - The NFT token ID identifying the trove
      * @param newRate - New individual annual interest rate (18-decimal fixed-point)
      * @param maxFee - Maximum upfront fee the borrower is willing to pay (in wei)
@@ -172,7 +179,7 @@ class BorrowService {
     /**
      * Builds a transaction to switch a trove to a different batch manager.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param troveId - The NFT token ID identifying the trove
      * @param newManager - Address of the new batch manager contract
      * @param maxFee - Maximum upfront fee the borrower is willing to pay (in wei)
@@ -185,7 +192,7 @@ class BorrowService {
      * Builds a transaction to delegate interest rate management to another address
      * with bounded rate constraints.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param troveId - The NFT token ID identifying the trove
      * @param delegate - Address to delegate interest rate management to
      * @param minRate - Minimum allowed annual interest rate (18-decimal fixed-point)
@@ -201,7 +208,7 @@ class BorrowService {
     /**
      * Builds a transaction to remove the interest rate delegate from a trove.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param troveId - The NFT token ID identifying the trove
      * @returns Transaction parameters ready to send
      */
@@ -212,7 +219,7 @@ class BorrowService {
      * Builds approval params to allow BorrowerOperations to spend collateral tokens.
      * Must be executed before `buildOpenTroveTransaction` or `buildAddCollTransaction`.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param amount - Amount of collateral to approve (in wei)
      * @returns Transaction parameters for the ERC-20 approve call
      */
@@ -222,7 +229,7 @@ class BorrowService {
     /**
      * Builds approval params for the debt token (e.g., for repayment or closing).
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param spender - Address to approve as spender
      * @param amount - Amount of debt tokens to approve (in wei)
      * @returns Transaction parameters for the ERC-20 approve call
@@ -233,7 +240,7 @@ class BorrowService {
     /**
      * Builds approval params for the gas compensation token (required when opening a trove).
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param amount - Amount to approve (in wei). If omitted, approves the gas compensation amount.
      * @returns Transaction parameters for the ERC-20 approve call
      */
@@ -243,7 +250,7 @@ class BorrowService {
     /**
      * Gets the current collateral token allowance for BorrowerOperations.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param owner - Address to check allowance for
      * @returns Current allowance in wei
      */
@@ -253,7 +260,7 @@ class BorrowService {
     /**
      * Gets the current debt token allowance for a specific spender.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param owner - Address to check allowance for
      * @param spender - Address of the approved spender
      * @returns Current allowance in wei
@@ -264,7 +271,7 @@ class BorrowService {
     /**
      * Gets the current gas compensation token allowance.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param owner - Address to check allowance for
      * @returns Current allowance in wei
      */
@@ -273,8 +280,10 @@ class BorrowService {
     }
     /**
      * Fetches on-chain data for a specific trove.
+     * The returned position reflects the trove's current lifecycle status, including
+     * zombie troves that may still hold collateral even when their debt is zero.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param troveId - The NFT token ID identifying the trove
      * @returns Trove position data including collateral, debt, interest rate, and status
      */
@@ -282,11 +291,14 @@ class BorrowService {
         return this.withContext(debtTokenSymbol, (ctx) => this.readService.getTroveData(ctx, troveId));
     }
     /**
-     * Fetches all troves owned by an address.
+     * Fetches troves currently owned by an address via the Trove NFT.
+     * This includes zombie troves that have been removed from `SortedTroves` but are still owned
+     * by the address. Closed or liquidated troves are not returned once their Trove NFT is burned
+     * or transferred away.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param owner - Address to query troves for
-     * @returns Array of trove positions owned by the address
+     * @returns Array of trove positions currently owned by the address
      */
     getUserTroves(debtTokenSymbol, owner) {
         return this.withContext(debtTokenSymbol, (ctx) => this.readService.getUserTroves(ctx, owner));
@@ -294,7 +306,7 @@ class BorrowService {
     /**
      * Gets the current collateral token price from the price feed.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @returns Collateral price in 18-decimal fixed-point format
      */
     getCollateralPrice(debtTokenSymbol) {
@@ -304,7 +316,7 @@ class BorrowService {
      * Gets the system parameters for a borrowing deployment.
      * Returns MCR, CCR, SCR, BCR, minimum debt, gas compensation, and minimum interest rate.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @returns System parameters (all values in 18-decimal fixed-point)
      */
     getSystemParams(debtTokenSymbol) {
@@ -313,7 +325,7 @@ class BorrowService {
     /**
      * Checks whether the borrowing system has been shut down (e.g., during a crisis).
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @returns true if the system is shut down, false otherwise
      */
     isSystemShutDown(debtTokenSymbol) {
@@ -322,7 +334,7 @@ class BorrowService {
     /**
      * Gets aggregate collateral and debt statistics for the borrowing branch.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @returns Total collateral and total debt across all troves (in wei)
      */
     getBranchStats(debtTokenSymbol) {
@@ -331,7 +343,7 @@ class BorrowService {
     /**
      * Gets the distribution of debt across interest rate brackets.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @returns Array of brackets, each with a rate and total debt at that rate
      */
     getInterestRateBrackets(debtTokenSymbol) {
@@ -340,7 +352,7 @@ class BorrowService {
     /**
      * Gets the weighted average interest rate across all active troves.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @returns Average annual interest rate in 18-decimal fixed-point
      */
     getAverageInterestRate(debtTokenSymbol) {
@@ -349,7 +361,7 @@ class BorrowService {
     /**
      * Gets information about a batch manager's configuration.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param address - Address of the batch manager
      * @returns Batch manager config (min/max rate, min change period), or null if not a valid manager
      */
@@ -359,7 +371,7 @@ class BorrowService {
     /**
      * Estimates the upfront fee for opening a new trove.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param amount - Debt amount to borrow (in wei)
      * @param rate - Annual interest rate (18-decimal fixed-point)
      * @returns Estimated upfront fee in wei
@@ -370,7 +382,7 @@ class BorrowService {
     /**
      * Estimates the upfront fee for increasing debt on an existing trove.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param troveId - The NFT token ID identifying the trove
      * @param debtIncrease - Amount of additional debt (in wei)
      * @returns Estimated upfront fee in wei
@@ -381,7 +393,7 @@ class BorrowService {
     /**
      * Estimates the upfront fee for changing a trove's interest rate.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param troveId - The NFT token ID identifying the trove
      * @param newRate - New annual interest rate (18-decimal fixed-point)
      * @returns Estimated upfront fee in wei
@@ -392,7 +404,7 @@ class BorrowService {
     /**
      * Estimates the upfront fee for joining a batch manager.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param troveId - The NFT token ID identifying the trove
      * @param batchAddress - Address of the batch manager to join
      * @returns Estimated upfront fee in wei
@@ -401,15 +413,40 @@ class BorrowService {
         return this.withContext(debtTokenSymbol, (ctx) => this.readService.predictJoinBatchUpfrontFee(ctx, troveId, batchAddress));
     }
     /**
-     * Gets the next available owner index for opening a new trove.
-     * Each owner can have multiple troves, indexed starting from 0.
+     * Gets the current number of troves owned by an address via the Trove NFT.
+     *
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
+     * @param owner - Address of the trove owner
+     * @returns The number of troves currently owned by the address
+     */
+    getOwnedTroveCount(debtTokenSymbol, owner) {
+        return this.withContext(debtTokenSymbol, (ctx) => this.readService.getOwnedTroveCount(ctx, owner));
+    }
+    /**
+     * Finds the first safe owner index for opening a trove with the given transaction sender.
+     *
+     * The `opener` must be the address that will call BorrowerOperations on-chain.
+     * For smart accounts, pass the smart account address rather than the controlling EOA.
+     *
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
+     * @param owner - Address that will own the trove NFT
+     * @param opener - Address that will submit the open-trove transaction on-chain
+     * @returns The first owner index that does not already map to an existing trove
+     */
+    findNextAvailableOwnerIndex(debtTokenSymbol, owner, opener) {
+        return this.withContext(debtTokenSymbol, (ctx) => this.readService.findNextAvailableOwnerIndex(ctx, owner, opener));
+    }
+    /**
+     * Gets the current number of troves owned by an address via the Trove NFT.
+     *
+     * @deprecated Use `findNextAvailableOwnerIndex` when preparing an open-trove transaction.
      *
-     * @param debtTokenSymbol - The debt token symbol (e.g., 'USDm')
+     * @param debtTokenSymbol - The debt token symbol (e.g., 'GBPm')
      * @param owner - Address of the trove owner
-     * @returns The next available index (pass to OpenTroveParams.ownerIndex)
+     * @returns The number of troves currently owned by the address
      */
     getNextOwnerIndex(debtTokenSymbol, owner) {
-        return this.withContext(debtTokenSymbol, (ctx) => this.readService.getNextOwnerIndex(ctx, owner));
+        return this.withContext(debtTokenSymbol, (ctx) => this.readService.getOwnedTroveCount(ctx, owner));
     }
     async withContext(debtTokenSymbol, callback) {
         const ctx = await this.ensureInitialized(debtTokenSymbol);

package/dist/services/borrow/borrowMath.d.ts

@@ -9,5 +9,13 @@ export declare function calculateDebtSuggestions(maxDebt: bigint, minDebt: bigin
     ltv: bigint;
     risk: RiskLevel;
 }[];
+/**
+ * Computes collateralization metrics from the supplied collateral, debt, price, and MCR.
+ *
+ * This helper is lifecycle-agnostic: it does not inspect trove status. For example, a zombie
+ * trove with `debt === 0` may still hold collateral on-chain, but this function only reports
+ * the math implied by the inputs. Combine its output with `BorrowPosition.status` when building
+ * UI for open, zombie, closed, or liquidated troves.
+ */
 export declare function getLoanDetails(collateral: bigint | null, debt: bigint | null, interestRate: bigint | null, collPrice: bigint | null, mcr: bigint): LoanDetails;
 //# sourceMappingURL=borrowMath.d.ts.map

package/dist/services/borrow/borrowMath.js

@@ -80,6 +80,14 @@ function calculateDebtSuggestions(maxDebt, minDebt) {
     }
     return suggestions;
 }
+/**
+ * Computes collateralization metrics from the supplied collateral, debt, price, and MCR.
+ *
+ * This helper is lifecycle-agnostic: it does not inspect trove status. For example, a zombie
+ * trove with `debt === 0` may still hold collateral on-chain, but this function only reports
+ * the math implied by the inputs. Combine its output with `BorrowPosition.status` when building
+ * UI for open, zombie, closed, or liquidated troves.
+ */
 function getLoanDetails(collateral, debt, interestRate, collPrice, mcr) {
     // maxLtv = 1 / MCR (MCR is e.g. 1.1e18 meaning 110%)
     const maxLtv = (DECIMAL_PRECISION * DECIMAL_PRECISION) / mcr;

package/dist/services/borrow/internal/borrowReadService.d.ts

@@ -23,6 +23,8 @@ export declare class BorrowReadService {
     predictAdjustUpfrontFee(ctx: DeploymentContext, troveId: string, debtIncrease: bigint): Promise<bigint>;
     predictAdjustInterestRateUpfrontFee(ctx: DeploymentContext, troveId: string, newRate: bigint): Promise<bigint>;
     predictJoinBatchUpfrontFee(ctx: DeploymentContext, troveId: string, batchAddress: string): Promise<bigint>;
+    getOwnedTroveCount(ctx: DeploymentContext, owner: string): Promise<number>;
+    findNextAvailableOwnerIndex(ctx: DeploymentContext, owner: string, opener: string): Promise<number>;
     getNextOwnerIndex(ctx: DeploymentContext, owner: string): Promise<number>;
     private readContractsInChunks;
 }

package/dist/services/borrow/internal/borrowReadService.js

@@ -9,6 +9,7 @@ const borrowValidation_1 = require("./borrowValidation");
 const TROVE_ID_BATCH_SIZE = 64;
 const TROVE_OWNER_BATCH_SIZE = 64;
 const TROVE_DETAIL_BATCH_SIZE = 64;
+const OWNER_INDEX_PROBE_BATCH_SIZE = 64;
 class BorrowReadService {
     constructor(publicClient) {
         this.publicClient = publicClient;
@@ -33,6 +34,10 @@ class BorrowReadService {
     }
     async getUserTroves(ctx, owner) {
         const ownerAddress = (0, borrowValidation_1.requireAddress)(owner, 'owner');
+        const ownedTroveCount = await this.getOwnedTroveCount(ctx, ownerAddress);
+        if (ownedTroveCount === 0) {
+            return [];
+        }
         const troveCount = (await this.publicClient.readContract({
             address: ctx.addresses.troveManager,
             abi: abis_1.TROVE_MANAGER_ABI,
@@ -212,7 +217,7 @@ class BorrowReadService {
             args: [constants_1.COLL_INDEX, parsedTroveId, managerAddress],
         }));
     }
-    async getNextOwnerIndex(ctx, owner) {
+    async getOwnedTroveCount(ctx, owner) {
         const ownerAddress = (0, borrowValidation_1.requireAddress)(owner, 'owner');
         const ownerTroveCount = (await this.publicClient.readContract({
             address: ctx.addresses.troveNFT,
@@ -225,6 +230,30 @@ class BorrowReadService {
         }
         return Number(ownerTroveCount);
     }
+    async findNextAvailableOwnerIndex(ctx, owner, opener) {
+        const ownerAddress = (0, borrowValidation_1.requireAddress)(owner, 'owner');
+        const openerAddress = (0, borrowValidation_1.requireAddress)(opener, 'opener');
+        let candidateIndex = await this.getOwnedTroveCount(ctx, ownerAddress);
+        while (candidateIndex <= Number.MAX_SAFE_INTEGER) {
+            const batchIndices = Array.from({ length: Math.min(OWNER_INDEX_PROBE_BATCH_SIZE, Number.MAX_SAFE_INTEGER - candidateIndex + 1) }, (_, offset) => candidateIndex + offset);
+            const statusContracts = batchIndices.map((ownerIndex) => ({
+                address: ctx.addresses.troveManager,
+                abi: abis_1.TROVE_MANAGER_ABI,
+                functionName: 'getTroveStatus',
+                args: [(0, borrowValidation_1.deriveTroveId)(openerAddress, ownerAddress, ownerIndex)],
+            }));
+            const statuses = await this.readContractsInChunks(statusContracts, OWNER_INDEX_PROBE_BATCH_SIZE);
+            const availableOffset = statuses.findIndex((status) => status === 0 || status === 0n);
+            if (availableOffset !== -1) {
+                return batchIndices[availableOffset];
+            }
+            candidateIndex += batchIndices.length;
+        }
+        throw new Error('Next available owner index exceeds Number.MAX_SAFE_INTEGER');
+    }
+    async getNextOwnerIndex(ctx, owner) {
+        return this.getOwnedTroveCount(ctx, owner);
+    }
     async readContractsInChunks(contracts, chunkSize) {
         if (contracts.length === 0) {
             return [];

package/dist/services/borrow/internal/borrowValidation.d.ts

@@ -5,6 +5,7 @@ export declare function requireAddress(address: string, fieldName: string): Addr
 export declare function optionalAddressOrZero(value: string | undefined, fieldName: string): Address;
 export declare function parseTroveId(troveId: string): bigint;
 export declare function formatTroveId(troveId: bigint): string;
+export declare function deriveTroveId(opener: string, owner: string, ownerIndex: number): bigint;
 export declare function requireNonNegativeInteger(value: number, fieldName: string): number;
 export declare function requireNonNegativeBigInt(value: bigint, fieldName: string): bigint;
 export declare function requirePositiveBigInt(value: bigint, fieldName: string): bigint;

package/dist/services/borrow/internal/borrowValidation.js

@@ -6,6 +6,7 @@ exports.requireAddress = requireAddress;
 exports.optionalAddressOrZero = optionalAddressOrZero;
 exports.parseTroveId = parseTroveId;
 exports.formatTroveId = formatTroveId;
+exports.deriveTroveId = deriveTroveId;
 exports.requireNonNegativeInteger = requireNonNegativeInteger;
 exports.requireNonNegativeBigInt = requireNonNegativeBigInt;
 exports.requirePositiveBigInt = requirePositiveBigInt;
@@ -15,6 +16,7 @@ const viem_1 = require("viem");
 const validation_1 = require("../../../utils/validation");
 const UINT128_MAX = (1n << 128n) - 1n;
 exports.MAX_SAFE_INTEGER_BIGINT = BigInt(Number.MAX_SAFE_INTEGER);
+const TROVE_ID_PARAMETERS = (0, viem_1.parseAbiParameters)('address opener, address owner, uint256 ownerIndex');
 function requireDebtTokenSymbol(symbol) {
     if (typeof symbol !== 'string' || symbol.trim().length === 0) {
         throw new Error('debtTokenSymbol must be a non-empty string');
@@ -49,6 +51,12 @@ function parseTroveId(troveId) {
 function formatTroveId(troveId) {
     return `0x${troveId.toString(16)}`;
 }
+function deriveTroveId(opener, owner, ownerIndex) {
+    const openerAddress = (0, viem_1.getAddress)(requireAddress(opener, 'opener'));
+    const ownerAddress = (0, viem_1.getAddress)(requireAddress(owner, 'owner'));
+    const validatedOwnerIndex = requireNonNegativeInteger(ownerIndex, 'ownerIndex');
+    return BigInt((0, viem_1.keccak256)((0, viem_1.encodeAbiParameters)(TROVE_ID_PARAMETERS, [openerAddress, ownerAddress, BigInt(validatedOwnerIndex)])));
+}
 function requireNonNegativeInteger(value, fieldName) {
     if (!Number.isSafeInteger(value) || value < 0) {
         throw new Error(`${fieldName} must be a non-negative safe integer`);

package/dist/services/routes/RouteService.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RouteService = void 0;
 const abis_1 = require("../../core/abis");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mento-protocol/mento-sdk",
   "description": "Official SDK for interacting with the Mento Protocol",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "license": "MIT",
   "author": "Mento Labs",
   "keywords": [