@mento-protocol/mento-sdk 3.2.3 → 3.2.5

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

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BorrowApprovalService = void 0;
+const viem_1 = require("viem");
+const abis_1 = require("../../../core/abis");
+const borrowErc20_1 = require("./borrowErc20");
+const borrowValidation_1 = require("./borrowValidation");
+const ZERO_VALUE = '0';
+class BorrowApprovalService {
+    constructor(publicClient) {
+        this.publicClient = publicClient;
+    }
+    buildCollateralApprovalParams(ctx, amount) {
+        const approvalAmount = (0, borrowValidation_1.requireNonNegativeBigInt)(amount, 'amount');
+        return (0, borrowErc20_1.buildErc20ApprovalParams)(ctx.addresses.collToken, ctx.addresses.borrowerOperations, approvalAmount);
+    }
+    buildDebtApprovalParams(ctx, spender, amount) {
+        const spenderAddress = (0, borrowValidation_1.requireAddress)(spender, 'spender');
+        const approvalAmount = (0, borrowValidation_1.requireNonNegativeBigInt)(amount, 'amount');
+        const data = (0, viem_1.encodeFunctionData)({
+            abi: abis_1.ERC20_ABI,
+            functionName: 'approve',
+            args: [spenderAddress, approvalAmount],
+        });
+        return { to: ctx.addresses.debtToken, data, value: ZERO_VALUE };
+    }
+    buildGasCompensationApprovalParams(ctx, amount) {
+        const approvalAmount = amount === undefined
+            ? ctx.systemParams.ethGasCompensation
+            : (0, borrowValidation_1.requireNonNegativeBigInt)(amount, 'amount');
+        return (0, borrowErc20_1.buildErc20ApprovalParams)(ctx.addresses.gasToken, ctx.addresses.borrowerOperations, approvalAmount);
+    }
+    async getCollateralAllowance(ctx, owner) {
+        const ownerAddress = (0, borrowValidation_1.requireAddress)(owner, 'owner');
+        return (0, borrowErc20_1.readErc20Allowance)(this.publicClient, ctx.addresses.collToken, ownerAddress, ctx.addresses.borrowerOperations);
+    }
+    async getDebtAllowance(ctx, owner, spender) {
+        const ownerAddress = (0, borrowValidation_1.requireAddress)(owner, 'owner');
+        const spenderAddress = (0, borrowValidation_1.requireAddress)(spender, 'spender');
+        return (await this.publicClient.readContract({
+            address: ctx.addresses.debtToken,
+            abi: abis_1.ERC20_ABI,
+            functionName: 'allowance',
+            args: [ownerAddress, spenderAddress],
+        }));
+    }
+    async getGasTokenAllowance(ctx, owner) {
+        const ownerAddress = (0, borrowValidation_1.requireAddress)(owner, 'owner');
+        return (0, borrowErc20_1.readErc20Allowance)(this.publicClient, ctx.addresses.gasToken, ownerAddress, ctx.addresses.borrowerOperations);
+    }
+}
+exports.BorrowApprovalService = BorrowApprovalService;
+//# sourceMappingURL=borrowApprovalService.js.map

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

@@ -0,0 +1,11 @@
+import { PublicClient } from 'viem';
+import { DeploymentContext } from './borrowTypes';
+export declare class BorrowContextStore {
+    private publicClient;
+    private chainId;
+    private deployments;
+    private initializing;
+    constructor(publicClient: PublicClient, chainId: number);
+    ensureInitialized(debtTokenSymbol: string): Promise<DeploymentContext>;
+}
+//# sourceMappingURL=borrowContextStore.d.ts.map

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

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BorrowContextStore = void 0;
+const constants_1 = require("../../../core/constants");
+const borrowRegistryReader_1 = require("./borrowRegistryReader");
+const borrowValidation_1 = require("./borrowValidation");
+class BorrowContextStore {
+    constructor(publicClient, chainId) {
+        this.publicClient = publicClient;
+        this.chainId = chainId;
+        this.deployments = new Map();
+        this.initializing = new Map();
+    }
+    async ensureInitialized(debtTokenSymbol) {
+        const symbol = (0, borrowValidation_1.requireDebtTokenSymbol)(debtTokenSymbol);
+        const cached = this.deployments.get(symbol);
+        if (cached)
+            return cached;
+        const inFlight = this.initializing.get(symbol);
+        if (inFlight)
+            return inFlight;
+        const initPromise = (async () => {
+            const registryAddress = (0, constants_1.getBorrowRegistry)(this.chainId, symbol);
+            const addresses = await (0, borrowRegistryReader_1.resolveAddressesFromRegistry)(this.publicClient, registryAddress);
+            const systemParams = await (0, borrowRegistryReader_1.readSystemParams)(this.publicClient, addresses.borrowerOperations);
+            const ctx = { addresses, systemParams };
+            this.deployments.set(symbol, ctx);
+            return ctx;
+        })();
+        this.initializing.set(symbol, initPromise);
+        try {
+            return await initPromise;
+        }
+        finally {
+            this.initializing.delete(symbol);
+        }
+    }
+}
+exports.BorrowContextStore = BorrowContextStore;
+//# sourceMappingURL=borrowContextStore.js.map

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

@@ -0,0 +1,5 @@
+import { Address, PublicClient } from 'viem';
+import { CallParams } from '../../../core/types';
+export declare function buildErc20ApprovalParams(token: Address, spender: Address, amount: bigint): CallParams;
+export declare function readErc20Allowance(publicClient: PublicClient, token: Address, owner: Address, spender: Address): Promise<bigint>;
+//# sourceMappingURL=borrowErc20.d.ts.map

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

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildErc20ApprovalParams = buildErc20ApprovalParams;
+exports.readErc20Allowance = readErc20Allowance;
+const viem_1 = require("viem");
+const abis_1 = require("../../../core/abis");
+const validation_1 = require("../../../utils/validation");
+const ZERO_VALUE = '0';
+function requireBigInt(value, fieldName) {
+    if (typeof value !== 'bigint') {
+        throw new Error(`${fieldName} must be a bigint`);
+    }
+    if (value < 0n) {
+        throw new Error(`${fieldName} cannot be negative`);
+    }
+    return value;
+}
+function buildErc20ApprovalParams(token, spender, amount) {
+    (0, validation_1.validateAddress)(token, 'token');
+    (0, validation_1.validateAddress)(spender, 'spender');
+    if (amount < 0n) {
+        throw new Error('Approval amount cannot be negative');
+    }
+    const data = (0, viem_1.encodeFunctionData)({
+        abi: abis_1.ERC20_ABI,
+        functionName: 'approve',
+        args: [spender, amount],
+    });
+    return { to: token, data, value: ZERO_VALUE };
+}
+async function readErc20Allowance(publicClient, token, owner, spender) {
+    (0, validation_1.validateAddress)(token, 'token');
+    (0, validation_1.validateAddress)(owner, 'owner');
+    (0, validation_1.validateAddress)(spender, 'spender');
+    const allowanceRaw = await publicClient.readContract({
+        address: token,
+        abi: abis_1.ERC20_ABI,
+        functionName: 'allowance',
+        args: [owner, spender],
+    });
+    return requireBigInt(allowanceRaw, 'allowance');
+}
+//# sourceMappingURL=borrowErc20.js.map

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

@@ -0,0 +1,7 @@
+import { PublicClient } from 'viem';
+import { DeploymentContext } from './borrowTypes';
+export declare function getTroveOperationHints(publicClient: PublicClient, ctx: DeploymentContext, interestRate: bigint): Promise<{
+    upper: bigint;
+    lower: bigint;
+}>;
+//# sourceMappingURL=borrowHints.d.ts.map

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

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTroveOperationHints = getTroveOperationHints;
+const abis_1 = require("../../../core/abis");
+const constants_1 = require("../../../core/constants");
+const borrowValidation_1 = require("./borrowValidation");
+async function getTroveOperationHints(publicClient, ctx, interestRate) {
+    const annualInterestRate = (0, borrowValidation_1.requireNonNegativeBigInt)(interestRate, 'interestRate');
+    const troveCount = (await publicClient.readContract({
+        address: ctx.addresses.sortedTroves,
+        abi: abis_1.SORTED_TROVES_ABI,
+        functionName: 'getSize',
+        args: [],
+    }));
+    const sqrtCount = (0, borrowValidation_1.ceilSqrt)(troveCount);
+    const numTrials = 10n * (sqrtCount > 0n ? sqrtCount : 1n);
+    const [approxHint] = (await publicClient.readContract({
+        address: ctx.addresses.hintHelpers,
+        abi: abis_1.HINT_HELPERS_ABI,
+        functionName: 'getApproxHint',
+        args: [constants_1.COLL_INDEX, annualInterestRate, numTrials, 42n],
+    }));
+    const [upperHint, lowerHint] = (await publicClient.readContract({
+        address: ctx.addresses.sortedTroves,
+        abi: abis_1.SORTED_TROVES_ABI,
+        functionName: 'findInsertPosition',
+        args: [annualInterestRate, approxHint, approxHint],
+    }));
+    return { upper: upperHint, lower: lowerHint };
+}
+//# sourceMappingURL=borrowHints.js.map

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

@@ -0,0 +1,4 @@
+import { BorrowPosition, TroveStatus } from '../../../core/types';
+export declare function mapTroveStatus(statusNum: number): TroveStatus;
+export declare function parseBorrowPosition(troveId: string, latestData: unknown, trovesData: unknown): BorrowPosition;
+//# sourceMappingURL=borrowPositionParser.d.ts.map

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

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapTroveStatus = mapTroveStatus;
+exports.parseBorrowPosition = parseBorrowPosition;
+const viem_1 = require("viem");
+const validation_1 = require("../../../utils/validation");
+const MAX_SAFE_INTEGER_BIGINT = BigInt(Number.MAX_SAFE_INTEGER);
+function requireAddress(value, fieldName) {
+    if (typeof value !== 'string') {
+        throw new Error(`${fieldName} must be a string address`);
+    }
+    (0, validation_1.validateAddress)(value, fieldName);
+    return value;
+}
+function requireBigInt(value, fieldName) {
+    if (typeof value !== 'bigint') {
+        throw new Error(`${fieldName} must be a bigint`);
+    }
+    if (value < 0n) {
+        throw new Error(`${fieldName} cannot be negative`);
+    }
+    return value;
+}
+function requireNonNegativeInteger(value, fieldName) {
+    if (typeof value === 'bigint') {
+        if (value < 0n) {
+            throw new Error(`${fieldName} cannot be negative`);
+        }
+        if (value > MAX_SAFE_INTEGER_BIGINT) {
+            throw new Error(`${fieldName} exceeds Number.MAX_SAFE_INTEGER`);
+        }
+        return Number(value);
+    }
+    if (typeof value === 'number') {
+        if (!Number.isSafeInteger(value)) {
+            throw new Error(`${fieldName} must be a safe integer`);
+        }
+        if (value < 0) {
+            throw new Error(`${fieldName} cannot be negative`);
+        }
+        return value;
+    }
+    throw new Error(`${fieldName} must be a number or bigint`);
+}
+function mapTroveStatus(statusNum) {
+    if (!Number.isSafeInteger(statusNum) || statusNum < 0) {
+        throw new Error(`Invalid trove status: ${statusNum}`);
+    }
+    switch (statusNum) {
+        case 0:
+            return 'nonExistent';
+        case 1:
+            return 'active';
+        case 2:
+            return 'closedByOwner';
+        case 3:
+            return 'closedByLiquidation';
+        case 4:
+            return 'zombie';
+        default:
+            throw new Error(`Unknown trove status: ${statusNum}`);
+    }
+}
+function parseBorrowPosition(troveId, latestData, trovesData) {
+    if (typeof troveId !== 'string' || troveId.length === 0) {
+        throw new Error('troveId must be a non-empty string');
+    }
+    const latest = latestData;
+    const trove = trovesData;
+    const interestBatchManager = requireAddress(trove.interestBatchManager, 'trovesData.interestBatchManager');
+    return {
+        troveId,
+        collateral: requireBigInt(latest.entireColl, 'latestData.entireColl'),
+        debt: requireBigInt(latest.entireDebt, 'latestData.entireDebt'),
+        annualInterestRate: requireBigInt(latest.annualInterestRate, 'latestData.annualInterestRate'),
+        status: mapTroveStatus(requireNonNegativeInteger(trove.status, 'trovesData.status')),
+        interestBatchManager: interestBatchManager.toLowerCase() === viem_1.zeroAddress ? null : interestBatchManager,
+        lastDebtUpdateTime: requireNonNegativeInteger(trove.lastDebtUpdateTime, 'trovesData.lastDebtUpdateTime'),
+        lastInterestRateAdjTime: requireNonNegativeInteger(latest.lastInterestRateAdjTime, 'latestData.lastInterestRateAdjTime'),
+        redistBoldDebtGain: requireBigInt(latest.redistBoldDebtGain, 'latestData.redistBoldDebtGain'),
+        redistCollGain: requireBigInt(latest.redistCollGain, 'latestData.redistCollGain'),
+        accruedInterest: requireBigInt(latest.accruedInterest, 'latestData.accruedInterest'),
+        recordedDebt: requireBigInt(latest.recordedDebt, 'latestData.recordedDebt'),
+        accruedBatchManagementFee: requireBigInt(latest.accruedBatchManagementFee, 'latestData.accruedBatchManagementFee'),
+    };
+}
+//# sourceMappingURL=borrowPositionParser.js.map

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

@@ -0,0 +1,31 @@
+import { PublicClient } from 'viem';
+import { BorrowPosition, InterestRateBracket } from '../../../core/types';
+import { DeploymentContext } from './borrowTypes';
+export declare class BorrowReadService {
+    private publicClient;
+    constructor(publicClient: PublicClient);
+    getTroveData(ctx: DeploymentContext, troveId: string): Promise<BorrowPosition>;
+    getUserTroves(ctx: DeploymentContext, owner: string): Promise<BorrowPosition[]>;
+    getCollateralPrice(ctx: DeploymentContext): Promise<bigint>;
+    isSystemShutDown(ctx: DeploymentContext): Promise<boolean>;
+    getBranchStats(ctx: DeploymentContext): Promise<{
+        totalColl: bigint;
+        totalDebt: bigint;
+    }>;
+    getInterestRateBrackets(ctx: DeploymentContext): Promise<InterestRateBracket[]>;
+    getAverageInterestRate(ctx: DeploymentContext): Promise<bigint>;
+    getBatchManagerInfo(ctx: DeploymentContext, address: string): Promise<{
+        minRate: bigint;
+        maxRate: bigint;
+        minChangePeriod: bigint;
+    } | null>;
+    predictOpenTroveUpfrontFee(ctx: DeploymentContext, amount: bigint, rate: bigint): Promise<bigint>;
+    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;
+}
+//# sourceMappingURL=borrowReadService.d.ts.map

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

@@ -0,0 +1,276 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BorrowReadService = void 0;
+const abis_1 = require("../../../core/abis");
+const constants_1 = require("../../../core/constants");
+const multicall_1 = require("../../../utils/multicall");
+const borrowPositionParser_1 = require("./borrowPositionParser");
+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;
+    }
+    async getTroveData(ctx, troveId) {
+        const parsedTroveId = (0, borrowValidation_1.parseTroveId)(troveId);
+        const [latestData, trovesData] = await this.readContractsInChunks([
+            {
+                address: ctx.addresses.troveManager,
+                abi: abis_1.TROVE_MANAGER_ABI,
+                functionName: 'getLatestTroveData',
+                args: [parsedTroveId],
+            },
+            {
+                address: ctx.addresses.troveManager,
+                abi: abis_1.TROVE_MANAGER_ABI,
+                functionName: 'Troves',
+                args: [parsedTroveId],
+            },
+        ], 2);
+        return (0, borrowPositionParser_1.parseBorrowPosition)((0, borrowValidation_1.formatTroveId)(parsedTroveId), latestData, trovesData);
+    }
+    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,
+            functionName: 'getTroveIdsCount',
+            args: [],
+        }));
+        if (troveCount === 0n) {
+            return [];
+        }
+        const troveIdContracts = [];
+        for (let i = 0n; i < troveCount; i++) {
+            troveIdContracts.push({
+                address: ctx.addresses.troveManager,
+                abi: abis_1.TROVE_MANAGER_ABI,
+                functionName: 'getTroveFromTroveIdsArray',
+                args: [i],
+            });
+        }
+        const troveIds = (await this.readContractsInChunks(troveIdContracts, TROVE_ID_BATCH_SIZE)).map((troveId) => troveId);
+        const ownerContracts = troveIds.map((troveId) => ({
+            address: ctx.addresses.troveNFT,
+            abi: abis_1.TROVE_NFT_ABI,
+            functionName: 'ownerOf',
+            args: [troveId],
+        }));
+        const troveOwners = await this.readContractsInChunks(ownerContracts, TROVE_OWNER_BATCH_SIZE);
+        const matchedTroveIds = troveIds.filter((troveId, index) => troveOwners[index].toLowerCase() === ownerAddress.toLowerCase());
+        if (matchedTroveIds.length === 0) {
+            return [];
+        }
+        const troveDetailContracts = matchedTroveIds.flatMap((troveId) => ([
+            {
+                address: ctx.addresses.troveManager,
+                abi: abis_1.TROVE_MANAGER_ABI,
+                functionName: 'getLatestTroveData',
+                args: [troveId],
+            },
+            {
+                address: ctx.addresses.troveManager,
+                abi: abis_1.TROVE_MANAGER_ABI,
+                functionName: 'Troves',
+                args: [troveId],
+            },
+        ]));
+        const detailResults = await this.readContractsInChunks(troveDetailContracts, TROVE_DETAIL_BATCH_SIZE * 2);
+        return matchedTroveIds.map((troveId, index) => {
+            const offset = index * 2;
+            return (0, borrowPositionParser_1.parseBorrowPosition)((0, borrowValidation_1.formatTroveId)(troveId), detailResults[offset], detailResults[offset + 1]);
+        });
+    }
+    async getCollateralPrice(ctx) {
+        return (await this.publicClient.readContract({
+            address: ctx.addresses.priceFeed,
+            abi: abis_1.PRICE_FEED_ABI,
+            functionName: 'fetchPrice',
+            args: [],
+        }));
+    }
+    async isSystemShutDown(ctx) {
+        return (await this.publicClient.readContract({
+            address: ctx.addresses.borrowerOperations,
+            abi: abis_1.BORROWER_OPERATIONS_ABI,
+            functionName: 'hasBeenShutDown',
+            args: [],
+        }));
+    }
+    async getBranchStats(ctx) {
+        const [totalColl, totalDebt] = await Promise.all([
+            this.publicClient.readContract({
+                address: ctx.addresses.borrowerOperations,
+                abi: abis_1.BORROWER_OPERATIONS_ABI,
+                functionName: 'getEntireBranchColl',
+                args: [],
+            }),
+            this.publicClient.readContract({
+                address: ctx.addresses.borrowerOperations,
+                abi: abis_1.BORROWER_OPERATIONS_ABI,
+                functionName: 'getEntireBranchDebt',
+                args: [],
+            }),
+        ]);
+        return { totalColl: totalColl, totalDebt: totalDebt };
+    }
+    async getInterestRateBrackets(ctx) {
+        const result = (await this.publicClient.readContract({
+            address: ctx.addresses.multiTroveGetter,
+            abi: abis_1.MULTI_TROVE_GETTER_ABI,
+            functionName: 'getDebtPerInterestRateAscending',
+            args: [constants_1.COLL_INDEX, 0n, 500n],
+        }));
+        const entries = result[0] ?? [];
+        const grouped = new Map();
+        for (const item of entries) {
+            const rate = (0, borrowValidation_1.requireNonNegativeBigInt)(item.interestRate, 'interestRate');
+            const debt = (0, borrowValidation_1.requireNonNegativeBigInt)(item.debt, 'debt');
+            const key = rate.toString();
+            grouped.set(key, (grouped.get(key) ?? 0n) + debt);
+        }
+        return Array.from(grouped.entries())
+            .map(([rate, totalDebt]) => ({
+            rate: BigInt(rate),
+            totalDebt,
+        }))
+            .sort((a, b) => (a.rate < b.rate ? -1 : a.rate > b.rate ? 1 : 0));
+    }
+    async getAverageInterestRate(ctx) {
+        const brackets = await this.getInterestRateBrackets(ctx);
+        if (brackets.length === 0)
+            return 0n;
+        let weightedRateSum = 0n;
+        let totalDebt = 0n;
+        for (const bracket of brackets) {
+            weightedRateSum += bracket.rate * bracket.totalDebt;
+            totalDebt += bracket.totalDebt;
+        }
+        return totalDebt === 0n ? 0n : weightedRateSum / totalDebt;
+    }
+    async getBatchManagerInfo(ctx, address) {
+        const batchManagerAddress = (0, borrowValidation_1.requireAddress)(address, 'address');
+        const exists = (await this.publicClient.readContract({
+            address: ctx.addresses.borrowerOperations,
+            abi: abis_1.BORROWER_OPERATIONS_ABI,
+            functionName: 'checkBatchManagerExists',
+            args: [batchManagerAddress],
+        }));
+        if (!exists)
+            return null;
+        const manager = (await this.publicClient.readContract({
+            address: ctx.addresses.borrowerOperations,
+            abi: abis_1.BORROWER_OPERATIONS_ABI,
+            functionName: 'getInterestBatchManager',
+            args: [batchManagerAddress],
+        }));
+        return {
+            minRate: (0, borrowValidation_1.requireNonNegativeBigInt)(manager.minInterestRate, 'minInterestRate'),
+            maxRate: (0, borrowValidation_1.requireNonNegativeBigInt)(manager.maxInterestRate, 'maxInterestRate'),
+            minChangePeriod: (0, borrowValidation_1.requireNonNegativeBigInt)(manager.minInterestRateChangePeriod, 'minInterestRateChangePeriod'),
+        };
+    }
+    async predictOpenTroveUpfrontFee(ctx, amount, rate) {
+        const borrowedAmount = (0, borrowValidation_1.requireNonNegativeBigInt)(amount, 'amount');
+        const annualInterestRate = (0, borrowValidation_1.requireNonNegativeBigInt)(rate, 'rate');
+        return (await this.publicClient.readContract({
+            address: ctx.addresses.hintHelpers,
+            abi: abis_1.HINT_HELPERS_ABI,
+            functionName: 'predictOpenTroveUpfrontFee',
+            args: [constants_1.COLL_INDEX, borrowedAmount, annualInterestRate],
+        }));
+    }
+    async predictAdjustUpfrontFee(ctx, troveId, debtIncrease) {
+        const parsedTroveId = (0, borrowValidation_1.parseTroveId)(troveId);
+        const debtIncreaseAmount = (0, borrowValidation_1.requireNonNegativeBigInt)(debtIncrease, 'debtIncrease');
+        return (await this.publicClient.readContract({
+            address: ctx.addresses.hintHelpers,
+            abi: abis_1.HINT_HELPERS_ABI,
+            functionName: 'predictAdjustTroveUpfrontFee',
+            args: [constants_1.COLL_INDEX, parsedTroveId, debtIncreaseAmount],
+        }));
+    }
+    async predictAdjustInterestRateUpfrontFee(ctx, troveId, newRate) {
+        const parsedTroveId = (0, borrowValidation_1.parseTroveId)(troveId);
+        const newAnnualInterestRate = (0, borrowValidation_1.requireNonNegativeBigInt)(newRate, 'newRate');
+        return (await this.publicClient.readContract({
+            address: ctx.addresses.hintHelpers,
+            abi: abis_1.HINT_HELPERS_ABI,
+            functionName: 'predictAdjustInterestRateUpfrontFee',
+            args: [constants_1.COLL_INDEX, parsedTroveId, newAnnualInterestRate],
+        }));
+    }
+    async predictJoinBatchUpfrontFee(ctx, troveId, batchAddress) {
+        const parsedTroveId = (0, borrowValidation_1.parseTroveId)(troveId);
+        const managerAddress = (0, borrowValidation_1.requireAddress)(batchAddress, 'batchAddress');
+        return (await this.publicClient.readContract({
+            address: ctx.addresses.hintHelpers,
+            abi: abis_1.HINT_HELPERS_ABI,
+            functionName: 'predictJoinBatchInterestRateUpfrontFee',
+            args: [constants_1.COLL_INDEX, parsedTroveId, managerAddress],
+        }));
+    }
+    async getOwnedTroveCount(ctx, owner) {
+        const ownerAddress = (0, borrowValidation_1.requireAddress)(owner, 'owner');
+        const ownerTroveCount = (await this.publicClient.readContract({
+            address: ctx.addresses.troveNFT,
+            abi: abis_1.TROVE_NFT_ABI,
+            functionName: 'balanceOf',
+            args: [ownerAddress],
+        }));
+        if (ownerTroveCount > borrowValidation_1.MAX_SAFE_INTEGER_BIGINT) {
+            throw new Error('Owner trove count exceeds Number.MAX_SAFE_INTEGER');
+        }
+        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 [];
+        }
+        const results = [];
+        for (let index = 0; index < contracts.length; index += chunkSize) {
+            const chunk = contracts.slice(index, index + chunkSize);
+            const chunkResults = await (0, multicall_1.multicall)(this.publicClient, chunk, { allowFailure: false });
+            for (const result of chunkResults) {
+                if (result.status === 'failure') {
+                    throw result.error;
+                }
+                results.push(result.result);
+            }
+        }
+        return results;
+    }
+}
+exports.BorrowReadService = BorrowReadService;
+//# sourceMappingURL=borrowReadService.js.map

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

@@ -0,0 +1,5 @@
+import { Address, PublicClient } from 'viem';
+import { BorrowContractAddresses, SystemParams } from '../../../core/types';
+export declare function resolveAddressesFromRegistry(publicClient: PublicClient, registryAddress: string): Promise<BorrowContractAddresses>;
+export declare function readSystemParams(publicClient: PublicClient, borrowerOperations: Address): Promise<SystemParams>;
+//# sourceMappingURL=borrowRegistryReader.d.ts.map