@mento-protocol/mento-sdk 3.2.0 → 3.2.1

package/dist/esm/services/borrow/BorrowService.js

@@ -8,16 +8,18 @@ import { BorrowTransactionService } from './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),
@@ -37,7 +39,7 @@ export 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
      */
@@ -47,7 +49,7 @@ export 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
      */
@@ -55,10 +57,13 @@ export 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
      */
@@ -68,7 +73,7 @@ export 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
      */
@@ -79,7 +84,7 @@ export 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
@@ -90,7 +95,7 @@ export 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
@@ -101,7 +106,7 @@ export 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)
@@ -113,7 +118,7 @@ export 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
@@ -124,7 +129,7 @@ export 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)
@@ -135,8 +140,10 @@ export 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) {
@@ -145,7 +152,7 @@ export 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)
@@ -157,7 +164,7 @@ export 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)
@@ -169,7 +176,7 @@ export 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)
@@ -182,7 +189,7 @@ export 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)
@@ -198,7 +205,7 @@ export 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
      */
@@ -209,7 +216,7 @@ export 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
      */
@@ -219,7 +226,7 @@ export 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
@@ -230,7 +237,7 @@ export 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
      */
@@ -240,7 +247,7 @@ export 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
      */
@@ -250,7 +257,7 @@ export 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
@@ -261,7 +268,7 @@ export 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
      */
@@ -270,8 +277,10 @@ export 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
      */
@@ -279,11 +288,14 @@ export 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));
@@ -291,7 +303,7 @@ export 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) {
@@ -301,7 +313,7 @@ export 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) {
@@ -310,7 +322,7 @@ export 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) {
@@ -319,7 +331,7 @@ export 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) {
@@ -328,7 +340,7 @@ export 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) {
@@ -337,7 +349,7 @@ export 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) {
@@ -346,7 +358,7 @@ export 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
      */
@@ -356,7 +368,7 @@ export 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
@@ -367,7 +379,7 @@ export 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
@@ -378,7 +390,7 @@ export 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
@@ -389,7 +401,7 @@ export 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
@@ -398,15 +410,40 @@ export 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/esm/services/borrow/borrowMath.js

@@ -71,6 +71,14 @@ export 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.
+ */
 export 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/esm/services/borrow/internal/borrowReadService.js

@@ -2,10 +2,11 @@ import { BORROWER_OPERATIONS_ABI, HINT_HELPERS_ABI, MULTI_TROVE_GETTER_ABI, PRIC
 import { COLL_INDEX } from '../../../core/constants';
 import { multicall } from '../../../utils/multicall';
 import { parseBorrowPosition } from './borrowPositionParser';
-import { formatTroveId, MAX_SAFE_INTEGER_BIGINT, parseTroveId, requireAddress, requireNonNegativeBigInt, } from './borrowValidation';
+import { deriveTroveId, formatTroveId, MAX_SAFE_INTEGER_BIGINT, parseTroveId, requireAddress, requireNonNegativeBigInt, } from './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;
 export class BorrowReadService {
     constructor(publicClient) {
         this.publicClient = publicClient;
@@ -30,6 +31,10 @@ export class BorrowReadService {
     }
     async getUserTroves(ctx, owner) {
         const ownerAddress = 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: TROVE_MANAGER_ABI,
@@ -209,7 +214,7 @@ export class BorrowReadService {
             args: [COLL_INDEX, parsedTroveId, managerAddress],
         }));
     }
-    async getNextOwnerIndex(ctx, owner) {
+    async getOwnedTroveCount(ctx, owner) {
         const ownerAddress = requireAddress(owner, 'owner');
         const ownerTroveCount = (await this.publicClient.readContract({
             address: ctx.addresses.troveNFT,
@@ -222,6 +227,30 @@ export class BorrowReadService {
         }
         return Number(ownerTroveCount);
     }
+    async findNextAvailableOwnerIndex(ctx, owner, opener) {
+        const ownerAddress = requireAddress(owner, 'owner');
+        const openerAddress = 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: TROVE_MANAGER_ABI,
+                functionName: 'getTroveStatus',
+                args: [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/esm/services/borrow/internal/borrowValidation.js

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