@gearbox-protocol/sdk 17.3.0 → 17.4.0

package/dist/cjs/dev/index.js

@@ -78,6 +78,7 @@ exports.logSplitterTransport = require_dev_logSplitterTransport.logSplitterTrans
 exports.makePendingWithdrawalsClaimable = require_dev_withdrawalUtils.makePendingWithdrawalsClaimable;
 exports.migrateFaucet = require_dev_migrateFaucet.migrateFaucet;
 exports.providerConfigSchema = require_dev_RevolverTransport.providerConfigSchema;
+exports.rateLimitOptionsSchema = require_dev_resilientTransport.rateLimitOptionsSchema;
 exports.registerMidasInvestor = require_dev_kycUtils.registerMidasInvestor;
 exports.registerRWAInvestor = require_dev_kycUtils.registerRWAInvestor;
 exports.registerSecuritizeInvestor = require_dev_kycUtils.registerSecuritizeInvestor;

package/dist/cjs/dev/isRateLimitError.js

@@ -7,6 +7,16 @@ const RATE_LIMIT_PATTERNS = [
 	/exceeded its compute units/i,
 	/retry.{0,10}(in|after)\s+\d/i
 ];
+const RETRY_HINT_RE = /retry.{0,10}(?:in|after)\s+(\d+(?:\.\d+)?)\s*(ms|milliseconds?|s|secs?|seconds?|m|mins?|minutes?)?\b/i;
+function extractRetryHint(msg) {
+	const match = msg.match(RETRY_HINT_RE);
+	if (!match) return;
+	const value = Number(match[1]);
+	const unit = match[2]?.toLowerCase() ?? "s";
+	if (unit.startsWith("ms") || unit.startsWith("milli")) return value;
+	if (unit.startsWith("m")) return value * 6e4;
+	return value * 1e3;
+}
 function extractRetryAfter(headers) {
 	if (!headers) return;
 	const val = headers.get("retry-after");
@@ -17,24 +27,29 @@ function extractRetryAfter(headers) {
 	if (!Number.isNaN(date)) return Math.max(0, date - Date.now());
 }
 /**
-* Whether the error indicates rate limiting. Returns `retryAfterMs` from the `Retry-After` header when available.
+* Whether the error indicates rate limiting. Returns `retryAfterMs` from the `Retry-After` header when available,
+* otherwise from a retry hint in the error message (e.g. "retry in 10s").
 */
 function isRateLimitError(e) {
 	if (e instanceof viem.BaseError) {
 		let retryAfterMs;
 		if (e.walk((err) => {
 			if (err instanceof viem.HttpRequestError && err.status === 429) {
-				retryAfterMs = extractRetryAfter(err.headers);
+				retryAfterMs = extractRetryAfter(err.headers) ?? extractRetryHint(err.details);
 				return true;
 			}
 			return false;
 		}) !== null) return [true, retryAfterMs];
 		if (e.walk((err) => {
 			const msg = err.details ?? err.message ?? "";
-			return RATE_LIMIT_PATTERNS.some((re) => re.test(msg));
-		}) !== null) return [true, void 0];
+			if (RATE_LIMIT_PATTERNS.some((re) => re.test(msg))) {
+				retryAfterMs = extractRetryHint(msg);
+				return true;
+			}
+			return false;
+		}) !== null) return [true, retryAfterMs];
 	}
-	if (RATE_LIMIT_PATTERNS.some((re) => re.test(e.message))) return [true, void 0];
+	if (RATE_LIMIT_PATTERNS.some((re) => re.test(e.message))) return [true, extractRetryHint(e.message)];
 	return [false, void 0];
 }
 //#endregion

package/dist/cjs/dev/resilientTransport.js

@@ -5,6 +5,20 @@ const require_dev_isTransientError = require("./isTransientError.js");
 let viem = require("viem");
 let zod_v4 = require("zod/v4");
 //#region src/dev/resilientTransport.ts
+/** Schema for {@link RateLimitOptions}. */
+const rateLimitOptionsSchema = zod_v4.z.object({
+	/**
+	* Max retry attempts for rate-limit errors.
+	* @default 3
+	**/
+	retryCount: zod_v4.z.number().int().min(0).default(3),
+	/**
+	* Upper bound (ms) for rate-limit delay, applied both to backoff and to
+	* provider-supplied retry hints.
+	* @default 5_000
+	**/
+	maxDelay: zod_v4.z.number().min(0).default(5e3)
+});
 /** Schema for {@link ResilientTransportOptions}. */
 const resilientTransportOptionsSchema = zod_v4.z.object({
 	/**
@@ -28,10 +42,11 @@ const resilientTransportOptionsSchema = zod_v4.z.object({
 	**/
 	jitter: zod_v4.z.number().min(0).default(100),
 	/**
-	* Retry on rate-limit (HTTP 429) errors.
+	* Retry on rate-limit (HTTP 429) errors. `false` disables, `true` uses
+	* default {@link RateLimitOptions}, an object overrides them.
 	* @default true
 	**/
-	handleRateLimit: zod_v4.z.boolean().default(true),
+	handleRateLimit: zod_v4.z.union([zod_v4.z.boolean(), rateLimitOptionsSchema]).transform((v) => v === true ? rateLimitOptionsSchema.parse({}) : v).prefault(true),
 	/**
 	* Retry on transient network/infrastructure errors.
 	* @default true
@@ -52,17 +67,24 @@ function resilientTransport(underlyingTransport, options) {
 	return (transportOpts) => {
 		const base = underlyingTransport(transportOpts);
 		const rpcRequest = base.request;
+		const rateLimit = opts.handleRateLimit;
+		const retryCount = rateLimit ? Math.max(opts.retryCount, rateLimit.retryCount) : opts.retryCount;
 		const request = async (args) => (0, viem.withRetry)(() => rpcRequest(args), {
-			retryCount: opts.retryCount,
+			retryCount,
 			delay({ count, error }) {
-				if (opts.handleRateLimit) {
+				const jitter = Math.floor(Math.random() * opts.jitter);
+				if (rateLimit) {
 					const [isRate, retryAfterMs] = require_dev_isRateLimitError.isRateLimitError(error);
-					if (isRate && retryAfterMs !== void 0) return retryAfterMs + Math.floor(Math.random() * opts.jitter);
+					if (isRate) {
+						const base = retryAfterMs ?? opts.delay * 2 ** count;
+						return Math.min(rateLimit.maxDelay, base) + jitter;
+					}
 				}
-				return Math.min(opts.maxDelay, opts.delay * 2 ** count) + Math.floor(Math.random() * opts.jitter);
+				return Math.min(opts.maxDelay, opts.delay * 2 ** count) + jitter;
 			},
-			shouldRetry({ error }) {
-				if (opts.handleRateLimit && require_dev_isRateLimitError.isRateLimitError(error)[0]) return true;
+			shouldRetry({ count, error }) {
+				if (rateLimit && require_dev_isRateLimitError.isRateLimitError(error)[0]) return count < rateLimit.retryCount;
+				if (count >= opts.retryCount) return false;
 				if (opts.handleTransient && require_dev_isTransientError.isTransientError(error)) return true;
 				if (opts.handleOutOfSync && require_dev_isOutOfSyncError.isOutOfSyncError(error)) return true;
 				return false;
@@ -75,5 +97,6 @@ function resilientTransport(underlyingTransport, options) {
 	};
 }
 //#endregion
+exports.rateLimitOptionsSchema = rateLimitOptionsSchema;
 exports.resilientTransport = resilientTransport;
 exports.resilientTransportOptionsSchema = resilientTransportOptionsSchema;

package/dist/cjs/model/opportunities.schema.js

@@ -112,6 +112,8 @@ const strategyOpportunitySchema = zod_v4.z.object({
 	totalValue: require_model_compare_schema.offchainOnly(require_model_primitives_schema.amountSchema).optional(),
 	utilization: require_model_compare_schema.offchainOnly(require_model_primitives_schema.bpsSchema).optional(),
 	availableLiquidity: require_model_compare_schema.tolerance(require_model_primitives_schema.amountSchema, "amount"),
+	totalSupply: require_model_compare_schema.onchainOnly(require_model_primitives_schema.amountSchema).optional(),
+	feeInterest: require_model_compare_schema.onchainOnly(require_model_primitives_schema.bpsSchema).optional(),
 	minDebt: require_model_primitives_schema.amountSchema,
 	totalDebtLimit: require_model_primitives_schema.amountSchema,
 	maxBorrowAmount: require_model_compare_schema.tolerance(require_model_primitives_schema.amountSchema, "amount"),

package/dist/cjs/onchain/market/credit/CreditSuiteStrategy.js

@@ -132,6 +132,8 @@ var CreditSuiteStrategy = class {
 			borrowApy: require_onchain_market_math.calcBorrowApy(pool.baseInterestRate, cm.feeInterest),
 			quotaRate: require_onchain_market_math.calcQuotaRate(market.pool.pqk.quotaRate(targetCollateral), cm.feeInterest),
 			availableLiquidity: oracle.toAmount(pool.underlying, pool.availableLiquidity),
+			totalSupply: oracle.toAmount(pool.underlying, pool.expectedLiquidity),
+			feeInterest: cm.feeInterest,
 			minDebt: oracle.toAmount(pool.underlying, suite.creditFacade.minDebt),
 			totalDebtLimit: oracle.toAmount(pool.underlying, debtParams?.limit ?? 0n),
 			maxBorrowAmount: oracle.toAmount(pool.underlying, this.maxBorrowAmount().amount.value),

package/dist/cjs/sdk/opportunities/OpportunitiesNamespace.js

@@ -23,7 +23,7 @@ var OpportunitiesNamespace = class extends require_sdk_AbstractNamespace.Abstrac
 	merge = {
 		list: (onchain, offchain) => require_sdk_utils_mergeChains.mergeChainList(onchain, offchain, this.maxOffchainLagSeconds),
 		pool: (onchain, offchain) => require_sdk_utils_mergeChains.mergeChainOne(onchain, offchain, this.maxOffchainLagSeconds),
-		strategy: (onchain, offchain) => overlayOnchainKyc(require_sdk_utils_mergeChains.mergeChainOne(onchain, offchain, this.maxOffchainLagSeconds), onchain)
+		strategy: (onchain, offchain) => overlayOnchainFields(require_sdk_utils_mergeChains.mergeChainOne(onchain, offchain, this.maxOffchainLagSeconds), onchain)
 	};
 	#prepare;
 	#execute;
@@ -102,17 +102,20 @@ var OpportunitiesNamespace = class extends require_sdk_AbstractNamespace.Abstrac
 	}
 };
 /**
-* Freshness still picks the body; `kyc` is taken from a successful chain
-* response because the backend does not evaluate it.
+* Freshness still picks the body; fields the backend does not serve are taken
+* from a successful chain response.
 **/
-function overlayOnchainKyc(merged, onchain) {
+function overlayOnchainFields(merged, onchain) {
 	if (!merged || !onchain || onchain.meta.chains[0]?.status !== "success") return merged;
 	if (merged === onchain) return merged;
 	return {
 		...merged,
 		data: {
 			...merged.data,
-			kyc: onchain.data.kyc
+			kyc: onchain.data.kyc,
+			feeInterest: onchain.data.feeInterest,
+			totalSupply: onchain.data.totalSupply,
+			availableLiquidity: onchain.data.availableLiquidity
 		}
 	};
 }

package/dist/esm/dev/index.js

@@ -20,9 +20,9 @@ import { setLTZero, setLTs } from "./ltUtils.js";
 import { migrateFaucet } from "./migrateFaucet.js";
 import { SUPPORTED_RPC_PROVIDERS, getAlchemyUrl, getAnkrUrl, getDrpcUrl, getErpcKey, getRpcProviderUrl, getThirdWebUrl, rpcProvidersSchema } from "./providers.js";
 import { replaceStorage } from "./replaceStorage.js";
-import { resilientTransport, resilientTransportOptionsSchema } from "./resilientTransport.js";
+import { rateLimitOptionsSchema, resilientTransport, resilientTransportOptionsSchema } from "./resilientTransport.js";
 import { claimDSToken, claimDSTokens, enableDSTokenBackDating } from "./securitizeUtils.js";
 import "./types.js";
 import { ONCHAIN_EXECUTION_ID_ADDRESS, verifyTestnet } from "./verifyTestnet.js";
 import { makePendingWithdrawalsClaimable } from "./withdrawalUtils.js";
-export { AccountOpener, Create2Deployer, DEFAULT_CREATE2_SALT, DEFAULT_MIDAS_ADMIN, EthCallSpy, NoAvailableTransportsError, ONCHAIN_EXECUTION_ID_ADDRESS, OpenTxRevertedError, PUBLIC_CREATE2_FACTORY, RevolverTransport, SUPPORTED_RPC_PROVIDERS, SelectionStrategy, anvilNodeInfo, calcLiquidatableLTs, claimDSToken, claimDSTokens, claimFromFaucet, createAnvilClient, createMinter, deployUsingPublicCreate2, detectChain, discoverMidasCreditSuites, discoverMidasGateways, discoverMidasMTokens, enableDSTokenBackDating, evmMineDetailed, extendAnvilClient, getAlchemyUrl, getAnkrUrl, getDrpcUrl, getErpcKey, getPublicCreate2Address, getRpcProviderUrl, getSecuritizeAdmin, getThirdWebUrl, greenlistMidasGateway, httpTransportOptionsSchema, iDegenNftv2Abi, iFaucetAbi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi, isAnvil, isDeployedUsingPublicCreate2, isOutOfSyncError, isRangeError, isRateLimitError, isTransientError, logSplitterTransport, makePendingWithdrawalsClaimable, migrateFaucet, providerConfigSchema, registerMidasInvestor, registerRWAInvestor, registerSecuritizeInvestor, replaceStorage, resilientTransport, resilientTransportOptionsSchema, revolverTransportConfigBaseSchema, revolverTransportConfigSchema, rpcProvidersSchema, setLTZero, setLTs, unpauseMidasIssuanceVault, verifyTestnet, writeContractSync };
+export { AccountOpener, Create2Deployer, DEFAULT_CREATE2_SALT, DEFAULT_MIDAS_ADMIN, EthCallSpy, NoAvailableTransportsError, ONCHAIN_EXECUTION_ID_ADDRESS, OpenTxRevertedError, PUBLIC_CREATE2_FACTORY, RevolverTransport, SUPPORTED_RPC_PROVIDERS, SelectionStrategy, anvilNodeInfo, calcLiquidatableLTs, claimDSToken, claimDSTokens, claimFromFaucet, createAnvilClient, createMinter, deployUsingPublicCreate2, detectChain, discoverMidasCreditSuites, discoverMidasGateways, discoverMidasMTokens, enableDSTokenBackDating, evmMineDetailed, extendAnvilClient, getAlchemyUrl, getAnkrUrl, getDrpcUrl, getErpcKey, getPublicCreate2Address, getRpcProviderUrl, getSecuritizeAdmin, getThirdWebUrl, greenlistMidasGateway, httpTransportOptionsSchema, iDegenNftv2Abi, iFaucetAbi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi, isAnvil, isDeployedUsingPublicCreate2, isOutOfSyncError, isRangeError, isRateLimitError, isTransientError, logSplitterTransport, makePendingWithdrawalsClaimable, migrateFaucet, providerConfigSchema, rateLimitOptionsSchema, registerMidasInvestor, registerRWAInvestor, registerSecuritizeInvestor, replaceStorage, resilientTransport, resilientTransportOptionsSchema, revolverTransportConfigBaseSchema, revolverTransportConfigSchema, rpcProvidersSchema, setLTZero, setLTs, unpauseMidasIssuanceVault, verifyTestnet, writeContractSync };

package/dist/esm/dev/isRateLimitError.js

@@ -6,6 +6,16 @@ const RATE_LIMIT_PATTERNS = [
 	/exceeded its compute units/i,
 	/retry.{0,10}(in|after)\s+\d/i
 ];
+const RETRY_HINT_RE = /retry.{0,10}(?:in|after)\s+(\d+(?:\.\d+)?)\s*(ms|milliseconds?|s|secs?|seconds?|m|mins?|minutes?)?\b/i;
+function extractRetryHint(msg) {
+	const match = msg.match(RETRY_HINT_RE);
+	if (!match) return;
+	const value = Number(match[1]);
+	const unit = match[2]?.toLowerCase() ?? "s";
+	if (unit.startsWith("ms") || unit.startsWith("milli")) return value;
+	if (unit.startsWith("m")) return value * 6e4;
+	return value * 1e3;
+}
 function extractRetryAfter(headers) {
 	if (!headers) return;
 	const val = headers.get("retry-after");
@@ -16,24 +26,29 @@ function extractRetryAfter(headers) {
 	if (!Number.isNaN(date)) return Math.max(0, date - Date.now());
 }
 /**
-* Whether the error indicates rate limiting. Returns `retryAfterMs` from the `Retry-After` header when available.
+* Whether the error indicates rate limiting. Returns `retryAfterMs` from the `Retry-After` header when available,
+* otherwise from a retry hint in the error message (e.g. "retry in 10s").
 */
 function isRateLimitError(e) {
 	if (e instanceof BaseError) {
 		let retryAfterMs;
 		if (e.walk((err) => {
 			if (err instanceof HttpRequestError && err.status === 429) {
-				retryAfterMs = extractRetryAfter(err.headers);
+				retryAfterMs = extractRetryAfter(err.headers) ?? extractRetryHint(err.details);
 				return true;
 			}
 			return false;
 		}) !== null) return [true, retryAfterMs];
 		if (e.walk((err) => {
 			const msg = err.details ?? err.message ?? "";
-			return RATE_LIMIT_PATTERNS.some((re) => re.test(msg));
-		}) !== null) return [true, void 0];
+			if (RATE_LIMIT_PATTERNS.some((re) => re.test(msg))) {
+				retryAfterMs = extractRetryHint(msg);
+				return true;
+			}
+			return false;
+		}) !== null) return [true, retryAfterMs];
 	}
-	if (RATE_LIMIT_PATTERNS.some((re) => re.test(e.message))) return [true, void 0];
+	if (RATE_LIMIT_PATTERNS.some((re) => re.test(e.message))) return [true, extractRetryHint(e.message)];
 	return [false, void 0];
 }
 //#endregion

package/dist/esm/dev/resilientTransport.js

@@ -4,6 +4,20 @@ import { isTransientError } from "./isTransientError.js";
 import { withRetry } from "viem";
 import { z } from "zod/v4";
 //#region src/dev/resilientTransport.ts
+/** Schema for {@link RateLimitOptions}. */
+const rateLimitOptionsSchema = z.object({
+	/**
+	* Max retry attempts for rate-limit errors.
+	* @default 3
+	**/
+	retryCount: z.number().int().min(0).default(3),
+	/**
+	* Upper bound (ms) for rate-limit delay, applied both to backoff and to
+	* provider-supplied retry hints.
+	* @default 5_000
+	**/
+	maxDelay: z.number().min(0).default(5e3)
+});
 /** Schema for {@link ResilientTransportOptions}. */
 const resilientTransportOptionsSchema = z.object({
 	/**
@@ -27,10 +41,11 @@ const resilientTransportOptionsSchema = z.object({
 	**/
 	jitter: z.number().min(0).default(100),
 	/**
-	* Retry on rate-limit (HTTP 429) errors.
+	* Retry on rate-limit (HTTP 429) errors. `false` disables, `true` uses
+	* default {@link RateLimitOptions}, an object overrides them.
 	* @default true
 	**/
-	handleRateLimit: z.boolean().default(true),
+	handleRateLimit: z.union([z.boolean(), rateLimitOptionsSchema]).transform((v) => v === true ? rateLimitOptionsSchema.parse({}) : v).prefault(true),
 	/**
 	* Retry on transient network/infrastructure errors.
 	* @default true
@@ -51,17 +66,24 @@ function resilientTransport(underlyingTransport, options) {
 	return (transportOpts) => {
 		const base = underlyingTransport(transportOpts);
 		const rpcRequest = base.request;
+		const rateLimit = opts.handleRateLimit;
+		const retryCount = rateLimit ? Math.max(opts.retryCount, rateLimit.retryCount) : opts.retryCount;
 		const request = async (args) => withRetry(() => rpcRequest(args), {
-			retryCount: opts.retryCount,
+			retryCount,
 			delay({ count, error }) {
-				if (opts.handleRateLimit) {
+				const jitter = Math.floor(Math.random() * opts.jitter);
+				if (rateLimit) {
 					const [isRate, retryAfterMs] = isRateLimitError(error);
-					if (isRate && retryAfterMs !== void 0) return retryAfterMs + Math.floor(Math.random() * opts.jitter);
+					if (isRate) {
+						const base = retryAfterMs ?? opts.delay * 2 ** count;
+						return Math.min(rateLimit.maxDelay, base) + jitter;
+					}
 				}
-				return Math.min(opts.maxDelay, opts.delay * 2 ** count) + Math.floor(Math.random() * opts.jitter);
+				return Math.min(opts.maxDelay, opts.delay * 2 ** count) + jitter;
 			},
-			shouldRetry({ error }) {
-				if (opts.handleRateLimit && isRateLimitError(error)[0]) return true;
+			shouldRetry({ count, error }) {
+				if (rateLimit && isRateLimitError(error)[0]) return count < rateLimit.retryCount;
+				if (count >= opts.retryCount) return false;
 				if (opts.handleTransient && isTransientError(error)) return true;
 				if (opts.handleOutOfSync && isOutOfSyncError(error)) return true;
 				return false;
@@ -74,4 +96,4 @@ function resilientTransport(underlyingTransport, options) {
 	};
 }
 //#endregion
-export { resilientTransport, resilientTransportOptionsSchema };
+export { rateLimitOptionsSchema, resilientTransport, resilientTransportOptionsSchema };

package/dist/esm/model/opportunities.schema.js

@@ -1,5 +1,5 @@
 import { ZodAddress } from "../onchain/utils/zod.js";
-import { offchainOnly, tolerance } from "./compare.schema.js";
+import { offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
 import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenSchema, underlyingTokenSchema } from "./primitives.schema.js";
 import { isFilterSet } from "./filters.js";
 import { booleanParamSchema, encodeFlag, filterable } from "./filters.schema.js";
@@ -111,6 +111,8 @@ const strategyOpportunitySchema = z.object({
 	totalValue: offchainOnly(amountSchema).optional(),
 	utilization: offchainOnly(bpsSchema).optional(),
 	availableLiquidity: tolerance(amountSchema, "amount"),
+	totalSupply: onchainOnly(amountSchema).optional(),
+	feeInterest: onchainOnly(bpsSchema).optional(),
 	minDebt: amountSchema,
 	totalDebtLimit: amountSchema,
 	maxBorrowAmount: tolerance(amountSchema, "amount"),

package/dist/esm/onchain/market/credit/CreditSuiteStrategy.js

@@ -131,6 +131,8 @@ var CreditSuiteStrategy = class {
 			borrowApy: calcBorrowApy(pool.baseInterestRate, cm.feeInterest),
 			quotaRate: calcQuotaRate(market.pool.pqk.quotaRate(targetCollateral), cm.feeInterest),
 			availableLiquidity: oracle.toAmount(pool.underlying, pool.availableLiquidity),
+			totalSupply: oracle.toAmount(pool.underlying, pool.expectedLiquidity),
+			feeInterest: cm.feeInterest,
 			minDebt: oracle.toAmount(pool.underlying, suite.creditFacade.minDebt),
 			totalDebtLimit: oracle.toAmount(pool.underlying, debtParams?.limit ?? 0n),
 			maxBorrowAmount: oracle.toAmount(pool.underlying, this.maxBorrowAmount().amount.value),

package/dist/esm/sdk/opportunities/OpportunitiesNamespace.js

@@ -22,7 +22,7 @@ var OpportunitiesNamespace = class extends AbstractNamespace {
 	merge = {
 		list: (onchain, offchain) => mergeChainList(onchain, offchain, this.maxOffchainLagSeconds),
 		pool: (onchain, offchain) => mergeChainOne(onchain, offchain, this.maxOffchainLagSeconds),
-		strategy: (onchain, offchain) => overlayOnchainKyc(mergeChainOne(onchain, offchain, this.maxOffchainLagSeconds), onchain)
+		strategy: (onchain, offchain) => overlayOnchainFields(mergeChainOne(onchain, offchain, this.maxOffchainLagSeconds), onchain)
 	};
 	#prepare;
 	#execute;
@@ -101,17 +101,20 @@ var OpportunitiesNamespace = class extends AbstractNamespace {
 	}
 };
 /**
-* Freshness still picks the body; `kyc` is taken from a successful chain
-* response because the backend does not evaluate it.
+* Freshness still picks the body; fields the backend does not serve are taken
+* from a successful chain response.
 **/
-function overlayOnchainKyc(merged, onchain) {
+function overlayOnchainFields(merged, onchain) {
 	if (!merged || !onchain || onchain.meta.chains[0]?.status !== "success") return merged;
 	if (merged === onchain) return merged;
 	return {
 		...merged,
 		data: {
 			...merged.data,
-			kyc: onchain.data.kyc
+			kyc: onchain.data.kyc,
+			feeInterest: onchain.data.feeInterest,
+			totalSupply: onchain.data.totalSupply,
+			availableLiquidity: onchain.data.availableLiquidity
 		}
 	};
 }

package/dist/types/dev/index.d.ts

@@ -21,9 +21,9 @@ import { createMinter } from "./mint/factory.js";
 import "./mint/index.js";
 import { RpcProvider, SUPPORTED_RPC_PROVIDERS, getAlchemyUrl, getAnkrUrl, getDrpcUrl, getErpcKey, getRpcProviderUrl, getThirdWebUrl, rpcProvidersSchema } from "./providers.js";
 import { ReplaceStorageParams, replaceStorage } from "./replaceStorage.js";
-import { ResilientTransportOptions, resilientTransport, resilientTransportOptionsSchema } from "./resilientTransport.js";
+import { RateLimitOptions, ResilientTransportOptions, rateLimitOptionsSchema, resilientTransport, resilientTransportOptionsSchema } from "./resilientTransport.js";
 import { EnableDSTokenBackDatingProps, RestoreDSTokenBackDating, claimDSToken, claimDSTokens, enableDSTokenBackDating } from "./securitizeUtils.js";
 import { httpTransportOptionsSchema } from "./transports.js";
 import { ONCHAIN_EXECUTION_ID_ADDRESS, VerifyTestnetParams, verifyTestnet } from "./verifyTestnet.js";
 import { MakePendingWithdrawalsClaimableOptions, makePendingWithdrawalsClaimable } from "./withdrawalUtils.js";
-export { AccountOpener, AccountOpenerOptions, AnvilActions, AnvilClient, AnvilClientConfig, AnvilDealParameters, AnvilNodeInfo, AnvilRPCSchema, CheckMulticallFn, Create2Deployer, Create2Parameters, DEFAULT_CREATE2_SALT, DEFAULT_MIDAS_ADMIN, DetectedCall, EnableDSTokenBackDatingProps, EnsureExistsUsingPublicCreate2ReturnType, EthCallMethod, EthCallRequest, EthCallSpy, GetCreate2AddressParameters, GreenlistMidasGatewayProps, IMinter, type LogSplitterTransportOptions, MakePendingWithdrawalsClaimableOptions, MidasCreditSuite, NoAvailableTransportsError, ONCHAIN_EXECUTION_ID_ADDRESS, OpenAccountHumanizedPreview, OpenAccountResult, OpenAccountsResult, OpenTxRevertedError, PUBLIC_CREATE2_FACTORY, PoolDepositResult, ProviderConfig, ProviderStatus, RWAKycFailure, RegisterMidasInvestorProps, RegisterRWAInvestorProps, RegisterRWAInvestorResult, RegisterSecuritizeInvestorProps, ReplaceStorageParams, ResilientTransportOptions, RestoreDSTokenBackDating, RestoreMidasIssuanceVaultPause, RevolverTransport, RevolverTransportConfig, RevolverTransportValue, RpcErrorResult, RpcProvider, RpcResponse, RpcSuccessResult, SUPPORTED_RPC_PROVIDERS, SelectionStrategy, TargetAccount, UnpauseMidasIssuanceVaultProps, VerifyTestnetParams, anvilNodeInfo, calcLiquidatableLTs, claimDSToken, claimDSTokens, claimFromFaucet, createAnvilClient, createMinter, deployUsingPublicCreate2, detectChain, discoverMidasCreditSuites, discoverMidasGateways, discoverMidasMTokens, enableDSTokenBackDating, evmMineDetailed, extendAnvilClient, getAlchemyUrl, getAnkrUrl, getDrpcUrl, getErpcKey, getPublicCreate2Address, getRpcProviderUrl, getSecuritizeAdmin, getThirdWebUrl, greenlistMidasGateway, httpTransportOptionsSchema, iDegenNftv2Abi, iFaucetAbi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi, isAnvil, isDeployedUsingPublicCreate2, isOutOfSyncError, isRangeError, isRateLimitError, isTransientError, logSplitterTransport, makePendingWithdrawalsClaimable, migrateFaucet, providerConfigSchema, registerMidasInvestor, registerRWAInvestor, registerSecuritizeInvestor, replaceStorage, resilientTransport, resilientTransportOptionsSchema, revolverTransportConfigBaseSchema, revolverTransportConfigSchema, rpcProvidersSchema, setLTZero, setLTs, unpauseMidasIssuanceVault, verifyTestnet, writeContractSync };
+export { AccountOpener, AccountOpenerOptions, AnvilActions, AnvilClient, AnvilClientConfig, AnvilDealParameters, AnvilNodeInfo, AnvilRPCSchema, CheckMulticallFn, Create2Deployer, Create2Parameters, DEFAULT_CREATE2_SALT, DEFAULT_MIDAS_ADMIN, DetectedCall, EnableDSTokenBackDatingProps, EnsureExistsUsingPublicCreate2ReturnType, EthCallMethod, EthCallRequest, EthCallSpy, GetCreate2AddressParameters, GreenlistMidasGatewayProps, IMinter, type LogSplitterTransportOptions, MakePendingWithdrawalsClaimableOptions, MidasCreditSuite, NoAvailableTransportsError, ONCHAIN_EXECUTION_ID_ADDRESS, OpenAccountHumanizedPreview, OpenAccountResult, OpenAccountsResult, OpenTxRevertedError, PUBLIC_CREATE2_FACTORY, PoolDepositResult, ProviderConfig, ProviderStatus, RWAKycFailure, RateLimitOptions, RegisterMidasInvestorProps, RegisterRWAInvestorProps, RegisterRWAInvestorResult, RegisterSecuritizeInvestorProps, ReplaceStorageParams, ResilientTransportOptions, RestoreDSTokenBackDating, RestoreMidasIssuanceVaultPause, RevolverTransport, RevolverTransportConfig, RevolverTransportValue, RpcErrorResult, RpcProvider, RpcResponse, RpcSuccessResult, SUPPORTED_RPC_PROVIDERS, SelectionStrategy, TargetAccount, UnpauseMidasIssuanceVaultProps, VerifyTestnetParams, anvilNodeInfo, calcLiquidatableLTs, claimDSToken, claimDSTokens, claimFromFaucet, createAnvilClient, createMinter, deployUsingPublicCreate2, detectChain, discoverMidasCreditSuites, discoverMidasGateways, discoverMidasMTokens, enableDSTokenBackDating, evmMineDetailed, extendAnvilClient, getAlchemyUrl, getAnkrUrl, getDrpcUrl, getErpcKey, getPublicCreate2Address, getRpcProviderUrl, getSecuritizeAdmin, getThirdWebUrl, greenlistMidasGateway, httpTransportOptionsSchema, iDegenNftv2Abi, iFaucetAbi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi, isAnvil, isDeployedUsingPublicCreate2, isOutOfSyncError, isRangeError, isRateLimitError, isTransientError, logSplitterTransport, makePendingWithdrawalsClaimable, migrateFaucet, providerConfigSchema, rateLimitOptionsSchema, registerMidasInvestor, registerRWAInvestor, registerSecuritizeInvestor, replaceStorage, resilientTransport, resilientTransportOptionsSchema, revolverTransportConfigBaseSchema, revolverTransportConfigSchema, rpcProvidersSchema, setLTZero, setLTs, unpauseMidasIssuanceVault, verifyTestnet, writeContractSync };

package/dist/types/dev/isRateLimitError.d.ts

@@ -1,6 +1,7 @@
 //#region src/dev/isRateLimitError.d.ts
 /**
- * Whether the error indicates rate limiting. Returns `retryAfterMs` from the `Retry-After` header when available.
+ * Whether the error indicates rate limiting. Returns `retryAfterMs` from the `Retry-After` header when available,
+ * otherwise from a retry hint in the error message (e.g. "retry in 10s").
  */
 declare function isRateLimitError(e: Error): [checkResult: boolean, retryAfterMs?: number | undefined];
 //#endregion

package/dist/types/dev/resilientTransport.d.ts

@@ -1,13 +1,29 @@
 import { Transport } from "viem";
 import { z } from "zod/v4";
 //#region src/dev/resilientTransport.d.ts
+/** Schema for {@link RateLimitOptions}. */
+declare const rateLimitOptionsSchema: z.ZodObject<{
+  retryCount: z.ZodDefault<z.ZodNumber>;
+  maxDelay: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/** Rate-limit retry settings accepted by `handleRateLimit`. */
+type RateLimitOptions = z.input<typeof rateLimitOptionsSchema>;
 /** Schema for {@link ResilientTransportOptions}. */
 declare const resilientTransportOptionsSchema: z.ZodObject<{
   retryCount: z.ZodDefault<z.ZodNumber>;
   delay: z.ZodDefault<z.ZodNumber>;
   maxDelay: z.ZodDefault<z.ZodNumber>;
   jitter: z.ZodDefault<z.ZodNumber>;
-  handleRateLimit: z.ZodDefault<z.ZodBoolean>;
+  handleRateLimit: z.ZodPrefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+    retryCount: z.ZodDefault<z.ZodNumber>;
+    maxDelay: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>]>, z.ZodTransform<false | {
+    retryCount: number;
+    maxDelay: number;
+  }, boolean | {
+    retryCount: number;
+    maxDelay: number;
+  }>>>;
   handleTransient: z.ZodDefault<z.ZodBoolean>;
   handleOutOfSync: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
@@ -19,4 +35,4 @@ type ResilientTransportOptions = z.input<typeof resilientTransportOptionsSchema>
  */
 declare function resilientTransport(underlyingTransport: Transport, options?: ResilientTransportOptions): Transport;
 //#endregion
-export { ResilientTransportOptions, resilientTransport, resilientTransportOptionsSchema };
+export { RateLimitOptions, ResilientTransportOptions, rateLimitOptionsSchema, resilientTransport, resilientTransportOptionsSchema };

package/dist/types/model/opportunities.d.ts

@@ -325,6 +325,19 @@ interface StrategyOpportunity extends OpportunityBase {
    * underlying. Same value the market's {@link PoolOpportunity} reports.
    **/
   availableLiquidity: Amount;
+  /**
+   * Size of the pool the strategy borrows from, `pool.expectedLiquidity`.
+   * Same value the market's {@link PoolOpportunity} reports.
+   *
+   * @mode onchain
+   **/
+  totalSupply?: Amount;
+  /**
+   * Percentage of accrued interest in bps taken by the protocol as profit.
+   *
+   * @mode onchain
+   **/
+  feeInterest?: Bps;
   /**
    * Smallest debt a position in this credit manager may hold, denominated in
    * the underlying (`creditFacade.minDebt`).

package/dist/types/model/opportunities.schema.d.ts

@@ -425,6 +425,11 @@ declare const strategyOpportunitySchema: z.ZodObject<{
     value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
     valueUsd: z.ZodNullable<z.ZodNumber>;
   }, z.core.$strip>;
+  totalSupply: z.ZodOptional<z.ZodObject<{
+    value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
+    valueUsd: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>>;
+  feeInterest: z.ZodOptional<z.ZodNumber>;
   minDebt: z.ZodObject<{
     value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
     valueUsd: z.ZodNullable<z.ZodNumber>;
@@ -693,6 +698,11 @@ declare const opportunitySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
     valueUsd: z.ZodNullable<z.ZodNumber>;
   }, z.core.$strip>;
+  totalSupply: z.ZodOptional<z.ZodObject<{
+    value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
+    valueUsd: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>>;
+  feeInterest: z.ZodOptional<z.ZodNumber>;
   minDebt: z.ZodObject<{
     value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
     valueUsd: z.ZodNullable<z.ZodNumber>;
@@ -1080,6 +1090,11 @@ declare const strategyOpportunityDetailSchema: z.ZodObject<{
     value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
     valueUsd: z.ZodNullable<z.ZodNumber>;
   }, z.core.$strip>;
+  totalSupply: z.ZodOptional<z.ZodObject<{
+    value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
+    valueUsd: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>>;
+  feeInterest: z.ZodOptional<z.ZodNumber>;
   minDebt: z.ZodObject<{
     value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
     valueUsd: z.ZodNullable<z.ZodNumber>;
@@ -1396,6 +1411,11 @@ declare const opportunityDetailSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
     valueUsd: z.ZodNullable<z.ZodNumber>;
   }, z.core.$strip>;
+  totalSupply: z.ZodOptional<z.ZodObject<{
+    value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
+    valueUsd: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>>;
+  feeInterest: z.ZodOptional<z.ZodNumber>;
   minDebt: z.ZodObject<{
     value: z.ZodCodec<z.ZodUnion<[z.ZodString, z.ZodBigInt]>, z.ZodBigInt>;
     valueUsd: z.ZodNullable<z.ZodNumber>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "17.3.0",
+  "version": "17.4.0",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {