@gearbox-protocol/sdk 14.12.0-next.65 → 14.12.0-next.67

package/dist/cjs/sdk/market/pool/math.js

@@ -0,0 +1,44 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_constants_math = require("../../constants/math.js");
+//#region src/sdk/market/pool/math.ts
+const FULL = Number(require_sdk_constants_math.PERCENTAGE_FACTOR);
+/**
+* Base rate borrowers pay at a given utilization, in basis points, following
+* the linear interest rate model's three segments.
+*
+* The result excludes the per-credit-manager interest fee: the model belongs to
+* the pool, and every credit manager of a market can charge a different one.
+**/
+function borrowRateAtUtilization(utilization, params) {
+	const { U1, U2, Rbase, Rslope1, Rslope2, Rslope3 } = params;
+	const u = Math.min(Math.max(utilization, 0), FULL);
+	if (u <= 0) return Rbase;
+	if (u <= U1) return Math.round(Rbase + Rslope1 * u / U1);
+	if (u <= U2) return Math.round(Rbase + Rslope1 + Rslope2 * (u - U1) / Math.max(U2 - U1, 1));
+	return Math.round(Rbase + Rslope1 + Rslope2 + Rslope3 * (u - U2) / Math.max(FULL - U2, 1));
+}
+/**
+* Rate depositors earn at a given utilization, in basis points: the interest
+* borrowers pay, spread over the pool's whole liquidity.
+**/
+function supplyRateAtUtilization(utilization, params) {
+	const u = Math.min(Math.max(utilization, 0), FULL);
+	return Math.round(borrowRateAtUtilization(u, params) * u / FULL);
+}
+/**
+* Utilizations the rate curve is sampled at: a fixed grid plus both kinks of
+* the model, so the borrow leg is exact and the supply leg — which is
+* quadratic between kinks — is smooth.
+**/
+function rateCurveUtilizations(params) {
+	const step = FULL / 20;
+	const grid = /* @__PURE__ */ new Set();
+	for (let u = 0; u <= FULL; u += step) grid.add(u);
+	grid.add(params.U1);
+	grid.add(params.U2);
+	return [...grid].filter((u) => u >= 0 && u <= FULL).sort((a, b) => a - b);
+}
+//#endregion
+exports.borrowRateAtUtilization = borrowRateAtUtilization;
+exports.rateCurveUtilizations = rateCurveUtilizations;
+exports.supplyRateAtUtilization = supplyRateAtUtilization;

package/dist/cjs/sdk/market/pricefeeds/AbstractPriceFeed.js

@@ -89,6 +89,23 @@ var AbstractPriceFeedContract = class extends require_sdk_base_BaseContract.Base
 		const underlying = this.underlyingPriceFeeds.flatMap((f) => f.priceFeed.updatableDependencies());
 		return require_sdk_market_pricefeeds_isUpdatablePriceFeed.isUpdatablePriceFeed(this) ? [this, ...underlying] : underlying;
 	}
+	/**
+	* {@inheritDoc IPriceFeedContract.describe}
+	*/
+	describe() {
+		let dependencies = [];
+		try {
+			dependencies = this.underlyingPriceFeeds.map((ref) => ref.priceFeed.describe());
+		} catch {
+			dependencies = [];
+		}
+		return {
+			name: this.name,
+			type: this.contractType,
+			feedAddress: this.address,
+			dependencies
+		};
+	}
 };
 //#endregion
 exports.AbstractPriceFeedContract = AbstractPriceFeedContract;

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

@@ -0,0 +1,60 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_chain_chains = require("../chain/chains.js");
+const require_sdk_base_MultichainConstruct = require("../base/MultichainConstruct.js");
+require("../base/index.js");
+//#region src/sdk/opportunities/MultichainOpportunitiesService.ts
+/**
+* Cross-chain counterpart of {@link OpportunitiesService}.
+*
+* Fans out over every chain configured in {@link MultichainSDK}. A chain that
+* fails is logged and skipped so one dead RPC does not empty the list; its
+* failure is reported in {@link MultichainResult.meta}.
+*
+* Detail reads need no fan-out: an opportunity key names its chain.
+*
+* @typeParam Plugins - Map of attached plugin types.
+**/
+var MultichainOpportunitiesService = class extends require_sdk_base_MultichainConstruct.MultichainConstruct {
+	/**
+	* Opportunities of all queried chains, see {@link OpportunitiesService.list}.
+	*
+	* A filter that names chains narrows the fan-out itself, so chains whose rows
+	* would be discarded are never queried and never appear in the meta.
+	**/
+	async list(filter) {
+		return this.queryChains({
+			networks: this.#networksOf(filter),
+			label: "list opportunities",
+			run: (sdk) => sdk.opportunities.list(filter)
+		});
+	}
+	/**
+	* {@inheritDoc OpportunitiesService.getPool}
+	**/
+	async getPool(key) {
+		return this.sdk.chain(key.chainId).opportunities.getPool(key);
+	}
+	/**
+	* {@inheritDoc OpportunitiesService.getStrategy}
+	**/
+	async getStrategy(key) {
+		return this.sdk.chain(key.chainId).opportunities.getStrategy(key);
+	}
+	/**
+	* Chains named by the filter, or `undefined` to query all of them. Chain ids
+	* the SDK does not support are dropped here rather than reported as failures:
+	* a filter naming them is a narrowing, not a request.
+	**/
+	#networksOf(filter) {
+		if (!filter?.chainIds) return;
+		const networks = [];
+		for (const chainId of filter.chainIds) try {
+			networks.push(require_sdk_chain_chains.getNetworkType(chainId));
+		} catch {
+			this.sdk.logger?.debug(`ignoring unsupported chain ${chainId} in opportunities filter`);
+		}
+		return networks;
+	}
+};
+//#endregion
+exports.MultichainOpportunitiesService = MultichainOpportunitiesService;

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

@@ -0,0 +1,103 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_base_SDKConstruct = require("../base/SDKConstruct.js");
+require("../base/index.js");
+const require_sdk_market_math = require("../market/math.js");
+//#region src/sdk/opportunities/OpportunitiesService.ts
+/**
+* A lookup that knows of no strategy, used when a filter rules strategies out
+* and the credit-account query is skipped altogether.
+**/
+const NO_TOTALS = () => void 0;
+/**
+* Builds the `opportunities` read model from the chain.
+*
+* Everything except the credit-account totals comes from the market state the
+* SDK already holds, so a list costs one RPC round-trip at most. Yield figures
+* that fold in incentives, points or history are deliberately absent: they are
+* the backend's job, and this service never guesses them.
+*
+* The rows themselves are assembled by the market wrappers — see
+* {@link MarketSuite.opportunities} — because every value in them is market
+* state. What is left here is the one thing no single market can answer: how
+* much the credit accounts of a strategy are worth.
+**/
+var OpportunitiesService = class extends require_sdk_base_SDKConstruct.SDKConstruct {
+	/**
+	* Every pool and strategy of every loaded market on this chain.
+	*
+	* Strategies are measured by the value locked in their credit accounts, so
+	* the list issues one credit-account query unless the filter rules strategies
+	* out entirely.
+	*
+	* @param filter - Optional narrowing, applied to the built rows.
+	**/
+	async list(filter) {
+		if (filter?.chainIds && !filter.chainIds.includes(this.chainId)) return [];
+		const { markets } = this.sdk.marketRegister;
+		const totals = filter?.kind === "pool" ? NO_TOTALS : await this.#strategyTotals(markets);
+		return markets.flatMap((market) => market.opportunities(totals, filter));
+	}
+	/**
+	* A single pool opportunity plus its interest rate curve and quotas.
+	*
+	* @throws If no loaded market has this pool.
+	**/
+	async getPool(key) {
+		return this.sdk.marketRegister.findByPool(key.pool).poolOpportunityDetail();
+	}
+	/**
+	* A single strategy opportunity plus the rate curve of the pool it borrows
+	* from and the price feeds its liquidation price depends on.
+	*
+	* @throws If the credit manager is unknown, or does not accept the requested
+	* collateral as a strategy.
+	**/
+	async getStrategy(key) {
+		const market = this.sdk.marketRegister.findByCreditManager(key.creditManager);
+		const { suite } = market.mustFindStrategy(key.creditManager, key.targetCollateral);
+		const totals = await this.#strategyTotals([market]);
+		return suite.strategyOpportunityDetail(key.targetCollateral, totals(key.creditManager, key.targetCollateral));
+	}
+	/**
+	* Total value held by the credit accounts backing every strategy of the given
+	* markets.
+	*
+	* An account that holds several strategy collaterals counts in full towards
+	* each of them: the read model reports what a strategy's accounts are worth,
+	* not how that worth splits across the collaterals inside them.
+	**/
+	async #strategyTotals(markets) {
+		const wanted = /* @__PURE__ */ new Map();
+		for (const market of markets) for (const { suite, collateral } of market.strategies) {
+			const cm = suite.creditManager.address.toLowerCase();
+			const tokens = wanted.get(cm) ?? /* @__PURE__ */ new Set();
+			tokens.add(collateral.toLowerCase());
+			wanted.set(cm, tokens);
+		}
+		if (wanted.size === 0) return NO_TOTALS;
+		const accounts = await this.sdk.accounts.getCreditAccounts({ includeZeroDebt: true });
+		const totals = /* @__PURE__ */ new Map();
+		for (const account of accounts) {
+			const tokens = wanted.get(account.creditManager.toLowerCase());
+			if (!tokens) continue;
+			for (const token of account.tokens) {
+				if (token.balance <= 0n || !tokens.has(token.token.toLowerCase())) continue;
+				const key = strategyKey(account.creditManager, token.token);
+				const current = totals.get(key);
+				totals.set(key, {
+					value: (current?.value ?? 0n) + account.totalValue,
+					valueUsd: (current?.valueUsd ?? 0) + require_sdk_market_math.usdToNumber(account.totalValueUSD)
+				});
+			}
+		}
+		return (creditManager, collateral) => totals.get(strategyKey(creditManager, collateral));
+	}
+};
+/**
+* Both halves of a strategy key folded into one map key.
+**/
+function strategyKey(creditManager, collateral) {
+	return `${creditManager.toLowerCase()}:${collateral.toLowerCase()}`;
+}
+//#endregion
+exports.OpportunitiesService = OpportunitiesService;

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

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_market_math = require("../market/math.js");
+const require_sdk_opportunities_MultichainOpportunitiesService = require("./MultichainOpportunitiesService.js");
+const require_sdk_opportunities_OpportunitiesService = require("./OpportunitiesService.js");
+exports.MultichainOpportunitiesService = require_sdk_opportunities_MultichainOpportunitiesService.MultichainOpportunitiesService;
+exports.OpportunitiesService = require_sdk_opportunities_OpportunitiesService.OpportunitiesService;
+exports.additionalBorrowApyBps = require_sdk_market_math.additionalBorrowApyBps;
+exports.borrowApyBps = require_sdk_market_math.borrowApyBps;
+exports.maxLeverage = require_sdk_market_math.maxLeverage;
+exports.rayToBps = require_sdk_market_math.rayToBps;
+exports.usdToNumber = require_sdk_market_math.usdToNumber;
+exports.utilizationBps = require_sdk_market_math.utilizationBps;

package/dist/cjs/sdk/types/multichain.js

@@ -0,0 +1 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });

package/dist/cjs/{common-utils → sdk}/utils/bigint-math.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/common-utils/utils/bigint-math.ts
+//#region src/sdk/utils/bigint-math.ts
 /**
 * Utility namespace for common `bigint` operations.
 *
@@ -17,20 +17,20 @@ var BigIntMath = class {
 	static abs = (x) => x < 0n ? -x : x;
 	/**
 	* Returns the greater of two bigint values.
-	*
-	* @param a First candidate value.
-	* @param b Second candidate value.
-	* @returns The larger value between `a` and `b`.
+	* @param values - The values to find the maximum of.
+	* @returns The maximum value.
 	*/
-	static max = (a, b) => a > b ? a : b;
+	static max = (...values) => {
+		return values.reduce((max, v) => v > max ? v : max);
+	};
 	/**
 	* Returns the smaller of two bigint values.
-	*
-	* @param a First candidate value.
-	* @param b Second candidate value.
-	* @returns The smaller value between `a` and `b`.
+	* @param values - The values to find the minimum of.
+	* @returns The minimum value.
 	*/
-	static min = (a, b) => a < b ? a : b;
+	static min = (...values) => {
+		return values.reduce((min, v) => v < min ? v : min);
+	};
 	/**
 	* Returns the negative form of a bigint if it is currently positive.
 	*

package/dist/cjs/sdk/utils/index.js

@@ -4,6 +4,7 @@ const require_sdk_utils_AddressSet = require("./AddressSet.js");
 const require_sdk_utils_AssetsMap = require("./AssetsMap.js");
 const require_sdk_utils_json = require("./json.js");
 const require_sdk_utils_abi_decode = require("./abi-decode.js");
+const require_sdk_utils_bigint_math = require("./bigint-math.js");
 const require_sdk_utils_bytes32ToString = require("./bytes32ToString.js");
 const require_sdk_utils_childLogger = require("./childLogger.js");
 const require_sdk_utils_createRawTx = require("./createRawTx.js");
@@ -20,8 +21,10 @@ const require_sdk_utils_zod = require("./zod.js");
 exports.AddressMap = require_sdk_utils_AddressMap.AddressMap;
 exports.AddressSet = require_sdk_utils_AddressSet.AddressSet;
 exports.AssetsMap = require_sdk_utils_AssetsMap.AssetsMap;
+exports.BigIntMath = require_sdk_utils_bigint_math.BigIntMath;
 exports.TypedObjectUtils = require_sdk_utils_mappers.TypedObjectUtils;
 exports.ZodAddress = require_sdk_utils_zod.ZodAddress;
+exports.ZodHex = require_sdk_utils_zod.ZodHex;
 exports.bytes32ToString = require_sdk_utils_bytes32ToString.bytes32ToString;
 exports.childLogger = require_sdk_utils_childLogger.childLogger;
 exports.createRawTx = require_sdk_utils_createRawTx.createRawTx;

package/dist/cjs/sdk/utils/zod.js

@@ -13,5 +13,17 @@ const ZodAddress = () => zod_v4.z.string().transform((val, ctx) => {
 	});
 	return (0, viem.getAddress)(val);
 });
+/**
+* A `0x`-prefixed hex string, as viem's Hex.
+*/
+const ZodHex = () => zod_v4.z.string().transform((val, ctx) => {
+	if (!(0, viem.isHex)(val)) ctx.issues.push({
+		code: "custom",
+		message: `invalid hex string ${val}`,
+		input: ctx.value
+	});
+	return val;
+});
 //#endregion
 exports.ZodAddress = ZodAddress;
+exports.ZodHex = ZodHex;

package/dist/esm/common-utils/index.js

@@ -1,5 +1,6 @@
 import { AxiosCache } from "./axios-cache/AxiosCache.js";
 import "./axios-cache/index.js";
+import { BigIntMath } from "../sdk/utils/bigint-math.js";
 import { ChartsCreditManagerData } from "./charts/credit-manager.js";
 import { CREDIT_SESSION_ID_BY_STATUS, CREDIT_SESSION_STATUS_BY_ID, CreditSession, CreditSessionFiltered, UserCreditSessionsBuilder } from "./charts/credit-session.js";
 import { ChartsPoolData, UserPoolData } from "./charts/pool.js";
@@ -11,7 +12,6 @@ import { calculateBorrowRateFromUtilization } from "./utils/apy/calculate-borrow
 import { PriceUtils } from "./utils/price-math.js";
 import { calculateEarnings } from "./utils/apy/calculate-earnings.js";
 import { calculateEffectiveBorrowRate } from "./utils/apy/calculate-effective-borrow-rate.js";
-import { BigIntMath } from "./utils/bigint-math.js";
 import { calculateSafeBorrowRate } from "./utils/apy/calculate-safe-borrow-rate.js";
 import { getComplexAPYList } from "./utils/apy/get-complex-apy-list.js";
 import { getRateWithFee } from "./utils/apy/get-rate-with-fee.js";

package/dist/esm/common-utils/utils/apy/calculate-safe-borrow-rate.js

@@ -1,6 +1,6 @@
+import { BigIntMath } from "../../../sdk/utils/bigint-math.js";
 import { PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR } from "../../../sdk/constants/math.js";
 import { calculateBorrowRateFromUtilization } from "./calculate-borrow-rate-from-utilization.js";
-import { BigIntMath } from "../bigint-math.js";
 //#region src/common-utils/utils/apy/calculate-safe-borrow-rate.ts
 /**
 * Returns borrow rate multiplied by feeInterest

package/dist/esm/common-utils/utils/assets-math.js

@@ -1,5 +1,5 @@
+import { BigIntMath } from "../../sdk/utils/bigint-math.js";
 import { PriceUtils } from "./price-math.js";
-import { BigIntMath } from "./bigint-math.js";
 import { sortBalances } from "./creditAccount/sort.js";
 //#region src/common-utils/utils/assets-math.ts
 /**

package/dist/esm/common-utils/utils/creditAccount/calc-health-factor.js

@@ -1,7 +1,7 @@
+import { BigIntMath } from "../../../sdk/utils/bigint-math.js";
 import { PERCENTAGE_FACTOR, PRICE_DECIMALS } from "../../../sdk/constants/math.js";
 import "../../../sdk/index.js";
 import { PriceUtils } from "../price-math.js";
-import { BigIntMath } from "../bigint-math.js";
 //#region src/common-utils/utils/creditAccount/calc-health-factor.ts
 const MAX_UINT16 = 65535;
 /**

package/dist/esm/common-utils/utils/creditAccount/debt.js

@@ -1,7 +1,7 @@
+import { BigIntMath } from "../../../sdk/utils/bigint-math.js";
 import { PERCENTAGE_FACTOR } from "../../../sdk/constants/math.js";
 import "../../../sdk/index.js";
 import { PriceUtils } from "../price-math.js";
-import { BigIntMath } from "../bigint-math.js";
 //#region src/common-utils/utils/creditAccount/debt.ts
 /**
 * Calculates additional debt that can be borrowed while targeting

package/dist/esm/common-utils/utils/creditAccount/quota-utils.js

@@ -1,6 +1,6 @@
+import { BigIntMath } from "../../../sdk/utils/bigint-math.js";
 import { MIN_INT96, PERCENTAGE_FACTOR } from "../../../sdk/constants/math.js";
 import "../../../sdk/index.js";
-import { BigIntMath } from "../bigint-math.js";
 //#region src/common-utils/utils/creditAccount/quota-utils.ts
 /**
 * Rounds quota deltas to protocol precision step (`PERCENTAGE_FACTOR`).

package/dist/esm/common-utils/utils/index.js

@@ -1,9 +1,9 @@
+import { BigIntMath } from "../../sdk/utils/bigint-math.js";
 import { BONUS_APY_FROM_POINTS } from "./apy/bonus-apy-from-points.js";
 import { calculateBorrowRateFromUtilization } from "./apy/calculate-borrow-rate-from-utilization.js";
 import { PriceUtils } from "./price-math.js";
 import { calculateEarnings } from "./apy/calculate-earnings.js";
 import { calculateEffectiveBorrowRate } from "./apy/calculate-effective-borrow-rate.js";
-import { BigIntMath } from "./bigint-math.js";
 import { calculateSafeBorrowRate } from "./apy/calculate-safe-borrow-rate.js";
 import { getComplexAPYList } from "./apy/get-complex-apy-list.js";
 import { getRateWithFee } from "./apy/get-rate-with-fee.js";

package/dist/esm/common-utils/utils/strategies/leverage/calculate-max-leverage-factor.js

@@ -1,6 +1,6 @@
+import { BigIntMath } from "../../../../sdk/utils/bigint-math.js";
 import { PERCENTAGE_FACTOR } from "../../../../sdk/constants/math.js";
 import "../../../../sdk/index.js";
-import { BigIntMath } from "../../bigint-math.js";
 import { calculateLossCoefficient } from "./calculate-loss-coefficient.js";
 import { maxLeverage } from "./max-leverage.js";
 //#region src/common-utils/utils/strategies/leverage/calculate-max-leverage-factor.ts

package/dist/esm/common-utils/utils/strategies/leverage/calculate-max-strategy-debt.js

@@ -1,5 +1,5 @@
+import { BigIntMath } from "../../../../sdk/utils/bigint-math.js";
 import { LEVERAGE_DECIMALS, PERCENTAGE_FACTOR } from "../../../../sdk/constants/math.js";
-import { BigIntMath } from "../../bigint-math.js";
 import { calculateLossCoefficient } from "./calculate-loss-coefficient.js";
 import { maxLeverage } from "./max-leverage.js";
 //#region src/common-utils/utils/strategies/leverage/calculate-max-strategy-debt.ts

package/dist/esm/common-utils/utils/strategies/strategy-info/calculate-total-points.js

@@ -1,6 +1,6 @@
+import { BigIntMath } from "../../../../sdk/utils/bigint-math.js";
 import { LEVERAGE_DECIMALS, PERCENTAGE_FACTOR, PRICE_DECIMALS } from "../../../../sdk/constants/math.js";
 import { PriceUtils } from "../../price-math.js";
-import { BigIntMath } from "../../bigint-math.js";
 import { getPointsRates } from "../points/get-points-rates.js";
 //#region src/common-utils/utils/strategies/strategy-info/calculate-total-points.ts
 const THRESHOLD_POINTS = 1e3;

package/dist/esm/common-utils/utils/strategies/strategy-info/get-cm-you-can-earn.js

@@ -1,9 +1,9 @@
+import { BigIntMath } from "../../../../sdk/utils/bigint-math.js";
 import { LEVERAGE_DECIMALS } from "../../../../sdk/constants/math.js";
 import { formatBN, toBN, toBigInt } from "../../../../sdk/utils/formatter.js";
 import { PriceUtils } from "../../price-math.js";
 import { calculateEarnings } from "../../apy/calculate-earnings.js";
 import { calculateEffectiveBorrowRate } from "../../apy/calculate-effective-borrow-rate.js";
-import { BigIntMath } from "../../bigint-math.js";
 import { getComplexAPYList } from "../../apy/get-complex-apy-list.js";
 import { getSafeBaseBorrowRate } from "../../apy/get-safe-base-borrow-rate.js";
 import { getCollateralByDebt } from "../leverage/get-collateral-by-debt.js";

package/dist/esm/common-utils/utils/validation/validate-open-account-pool-status.js

@@ -1,4 +1,4 @@
-import { BigIntMath } from "../bigint-math.js";
+import { BigIntMath } from "../../../sdk/utils/bigint-math.js";
 import { validateOpenAccountPoolQuotaStatus } from "./validate-open-account-pool-quota-status.js";
 //#region src/common-utils/utils/validation/validate-open-account-pool-status.ts
 function validateOpenAccountPoolStatus(props) {

package/dist/esm/dev/AccountOpener.js

@@ -1,9 +1,9 @@
+import { ierc20Abi } from "../abi/iERC20.js";
 import { iCreditFacadeV310Abi } from "../abi/310/generated.js";
 import { AddressMap } from "../sdk/utils/AddressMap.js";
 import { AddressSet } from "../sdk/utils/AddressSet.js";
 import { AssetsMap } from "../sdk/utils/AssetsMap.js";
 import { childLogger } from "../sdk/utils/childLogger.js";
-import { ierc20Abi } from "../abi/iERC20.js";
 import "../sdk/constants/addresses.js";
 import { MAX_UINT256, PERCENTAGE_FACTOR } from "../sdk/constants/math.js";
 import { SDKConstruct } from "../sdk/base/SDKConstruct.js";

package/dist/esm/dev/index.js

@@ -1,7 +1,8 @@
 import { faucetAbi, iDegenNftv2Abi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi } from "./abi.js";
 import { claimFromFaucet } from "./claimFromFaucet.js";
 import { anvilNodeInfo, createAnvilClient, evmMineDetailed, extendAnvilClient, isAnvil } from "./createAnvilClient.js";
-import { prependMidasReceiveGreenlist } from "./midasUtils.js";
+import { greenlistMidasGateway, registerMidasInvestor, registerRWAInvestor, registerSecuritizeInvestor, writeAndWait } from "./kycUtils.js";
+import { prependMidasReceiveGreenlist, unpauseMidasIssuanceVault } from "./midasUtils.js";
 import { createMinter } from "./mint/factory.js";
 import "./mint/index.js";
 import { AccountOpener, OpenTxRevertedError } from "./AccountOpener.js";
@@ -14,7 +15,6 @@ import { detectChain } from "./detectChain.js";
 import { isOutOfSyncError } from "./isOutOfSyncError.js";
 import { isRateLimitError } from "./isRateLimitError.js";
 import { isTransientError } from "./isTransientError.js";
-import { greenlistMidasGateway, registerMidasInvestor, registerRWAInvestor, registerSecuritizeInvestor, writeAndWait } from "./kycUtils.js";
 import { isRangeError, logSplitterTransport } from "./logSplitterTransport.js";
 import { setLTZero, setLTs } from "./ltUtils.js";
 import { migrateFaucet } from "./migrateFaucet.js";
@@ -25,4 +25,4 @@ import { claimDSToken, claimDSTokens, enableDSTokenBackDating } from "./securiti
 import "./types.js";
 import { ONCHAIN_EXECUTION_ID_ADDRESS, verifyTestnet } from "./verifyTestnet.js";
 import { makePendingWithdrawalsClaimable } from "./withdrawalUtils.js";
-export { AccountOpener, Create2Deployer, DEFAULT_CREATE2_SALT, EthCallSpy, NoAvailableTransportsError, ONCHAIN_EXECUTION_ID_ADDRESS, OpenTxRevertedError, PUBLIC_CREATE2_FACTORY, RevolverTransport, SUPPORTED_RPC_PROVIDERS, SelectionStrategy, anvilNodeInfo, calcLiquidatableLTs, claimDSToken, claimDSTokens, claimFromFaucet, createAnvilClient, createMinter, deployUsingPublicCreate2, detectChain, enableDSTokenBackDating, evmMineDetailed, extendAnvilClient, faucetAbi, getAlchemyUrl, getAnkrUrl, getDrpcUrl, getErpcKey, getPublicCreate2Address, getRpcProviderUrl, getThirdWebUrl, greenlistMidasGateway, httpTransportOptionsSchema, iDegenNftv2Abi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi, isAnvil, isDeployedUsingPublicCreate2, isOutOfSyncError, isRangeError, isRateLimitError, isTransientError, logSplitterTransport, makePendingWithdrawalsClaimable, migrateFaucet, prependMidasReceiveGreenlist, providerConfigSchema, registerMidasInvestor, registerRWAInvestor, registerSecuritizeInvestor, replaceStorage, resilientTransport, resilientTransportOptionsSchema, revolverTransportConfigBaseSchema, revolverTransportConfigSchema, rpcProvidersSchema, setLTZero, setLTs, verifyTestnet, writeAndWait };
+export { AccountOpener, Create2Deployer, DEFAULT_CREATE2_SALT, EthCallSpy, NoAvailableTransportsError, ONCHAIN_EXECUTION_ID_ADDRESS, OpenTxRevertedError, PUBLIC_CREATE2_FACTORY, RevolverTransport, SUPPORTED_RPC_PROVIDERS, SelectionStrategy, anvilNodeInfo, calcLiquidatableLTs, claimDSToken, claimDSTokens, claimFromFaucet, createAnvilClient, createMinter, deployUsingPublicCreate2, detectChain, enableDSTokenBackDating, evmMineDetailed, extendAnvilClient, faucetAbi, getAlchemyUrl, getAnkrUrl, getDrpcUrl, getErpcKey, getPublicCreate2Address, getRpcProviderUrl, getThirdWebUrl, greenlistMidasGateway, httpTransportOptionsSchema, iDegenNftv2Abi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi, isAnvil, isDeployedUsingPublicCreate2, isOutOfSyncError, isRangeError, isRateLimitError, isTransientError, logSplitterTransport, makePendingWithdrawalsClaimable, migrateFaucet, prependMidasReceiveGreenlist, providerConfigSchema, registerMidasInvestor, registerRWAInvestor, registerSecuritizeInvestor, replaceStorage, resilientTransport, resilientTransportOptionsSchema, revolverTransportConfigBaseSchema, revolverTransportConfigSchema, rpcProvidersSchema, setLTZero, setLTs, unpauseMidasIssuanceVault, verifyTestnet, writeAndWait };

package/dist/esm/dev/kycUtils.js

@@ -2,9 +2,9 @@ import { AddressSet } from "../sdk/utils/AddressSet.js";
 import { MAX_UINT256 } from "../sdk/constants/math.js";
 import { OnchainSDK } from "../sdk/OnchainSDK.js";
 import "../sdk/index.js";
-import { midasGatewayAbi } from "./withdrawalAbi.js";
 import { iDSRegistryServiceAbi } from "../abi/rwa/iDSRegistryService.js";
 import { iDSTokenAbi } from "../abi/rwa/iDSToken.js";
+import { midasGatewayAbi } from "./withdrawalAbi.js";
 import { isAddressEqual, parseAbi, parseEther, zeroAddress } from "viem";
 import { privateKeyToAccount } from "viem/accounts";
 //#region src/dev/kycUtils.ts

package/dist/esm/dev/midasUtils.js

@@ -1,5 +1,6 @@
 import { midasGatewayAbi } from "./withdrawalAbi.js";
-import { encodeFunctionData, isAddressEqual, parseAbi } from "viem";
+import { writeAndWait } from "./kycUtils.js";
+import { encodeFunctionData, isAddressEqual, parseAbi, parseEther } from "viem";
 //#region src/dev/midasUtils.ts
 const ADAPTER_MIDAS_GATEWAY = "ADAPTER::MIDAS_GATEWAY";
 const ADAPTER_MIDAS_ISSUANCE_VAULT = "ADAPTER::MIDAS_ISSUANCE_VAULT";
@@ -15,6 +16,18 @@ const MIDAS_MODE_PERMISSIONLESS = 0;
 */
 const iMidasMTokenAbi = parseAbi(["function mToken() external view returns (address)"]);
 const iMidasGatewayAdapterExtAbi = parseAbi(["function receiveGreenlist() external returns (bool)"]);
+/**
+* Midas vaults inherit their own `Pausable`, whose global pause is guarded by
+* `pauseAdminRole()` in the vault's access control instead of `Ownable`
+*/
+const iMidasPausableVaultAbi = parseAbi([
+	"function paused() external view returns (bool)",
+	"function pause() external",
+	"function unpause() external",
+	"function pauseAdminRole() external view returns (bytes32)",
+	"function accessControl() external view returns (address)"
+]);
+const iMidasAccessControlAbi = parseAbi(["function hasRole(bytes32 role, address account) external view returns (bool)", "function grantRole(bytes32 role, address account) external"]);
 const receiveGreenlistCallData = encodeFunctionData({
 	abi: iMidasGatewayAdapterExtAbi,
 	functionName: "receiveGreenlist"
@@ -85,6 +98,96 @@ async function prependMidasReceiveGreenlist(props) {
 	}
 	return prepended.length > 0 ? [...prepended, ...calls] : calls;
 }
+/**
+* Unpauses a globally paused Midas issuance vault on an anvil fork, so that
+* `depositInstant` stops reverting with `Pausable: paused`, and returns a
+* callback that restores the original pause state.
+*
+* Impersonates `admin` and grants it `pauseAdminRole()` when missing, same as
+* `greenlistMidasGateway` does with the greenlist roles. The grant is not
+* reverted by the callback, only the pause state is.
+*/
+async function unpauseMidasIssuanceVault(props) {
+	const { anvil, vault, admin, logger } = props;
+	if (!await anvil.readContract({
+		address: vault,
+		abi: iMidasPausableVaultAbi,
+		functionName: "paused"
+	})) {
+		logger?.debug(`midas: issuance vault ${vault} is not paused`);
+		return async () => {};
+	}
+	const [accessControl, pauseAdminRole] = await anvil.multicall({
+		allowFailure: false,
+		contracts: [{
+			address: vault,
+			abi: iMidasPausableVaultAbi,
+			functionName: "accessControl"
+		}, {
+			address: vault,
+			abi: iMidasPausableVaultAbi,
+			functionName: "pauseAdminRole"
+		}]
+	});
+	const isPauseAdmin = await anvil.readContract({
+		address: accessControl,
+		abi: iMidasAccessControlAbi,
+		functionName: "hasRole",
+		args: [pauseAdminRole, admin]
+	});
+	logger?.debug(`midas: unpausing issuance vault ${vault} as ${admin}, access control ${accessControl}, pause admin role ${pauseAdminRole}`);
+	await anvil.impersonateAccount({ address: admin });
+	try {
+		await anvil.setBalance({
+			address: admin,
+			value: parseEther("100")
+		});
+		if (!isPauseAdmin) {
+			await writeAndWait(anvil, {
+				account: admin,
+				chain: anvil.chain,
+				address: accessControl,
+				abi: iMidasAccessControlAbi,
+				functionName: "grantRole",
+				args: [pauseAdminRole, admin]
+			});
+			logger?.debug(`midas: granted pause admin role to ${admin}`);
+		}
+		await writeAndWait(anvil, {
+			account: admin,
+			chain: anvil.chain,
+			address: vault,
+			abi: iMidasPausableVaultAbi,
+			functionName: "unpause"
+		});
+	} finally {
+		await anvil.stopImpersonatingAccount({ address: admin });
+	}
+	let toRestore = true;
+	return async () => {
+		if (!toRestore) return;
+		toRestore = false;
+		logger?.debug(`midas: pausing issuance vault ${vault} back`);
+		await anvil.impersonateAccount({ address: admin });
+		try {
+			await anvil.setBalance({
+				address: admin,
+				value: parseEther("100")
+			});
+			await writeAndWait(anvil, {
+				account: admin,
+				chain: anvil.chain,
+				address: vault,
+				abi: iMidasPausableVaultAbi,
+				functionName: "pause"
+			});
+		} catch (e) {
+			logger?.warn(`midas: failed to pause issuance vault ${vault} back: ${e}`);
+		} finally {
+			await anvil.stopImpersonatingAccount({ address: admin });
+		}
+	};
+}
 async function readMTokens(client, adapters) {
 	return await client.multicall({
 		allowFailure: false,
@@ -96,4 +199,4 @@ async function readMTokens(client, adapters) {
 	});
 }
 //#endregion
-export { prependMidasReceiveGreenlist };
+export { prependMidasReceiveGreenlist, unpauseMidasIssuanceVault };

package/dist/esm/dev/withdrawalUtils.js

@@ -1,6 +1,6 @@
+import { iWithdrawalCompressorV313Abi } from "../abi/IWithdrawalCompressorV313.js";
 import { getNetworkType } from "../sdk/chain/chains.js";
 import { getWithdrawalCompressorAddress } from "../sdk/accounts/withdrawal-compressor/addresses.js";
-import { iWithdrawalCompressorV313Abi } from "../abi/IWithdrawalCompressorV313.js";
 import "../sdk/index.js";
 import { iMidasDataFeedAbi, iMidasRedemptionVaultAbi, midasGatewayAbi, midasRedeemerAbi, midasRedemptionVaultPhantomTokenAbi, securitizeRedeemerAbi, securitizeRedemptionGatewayAbi, securitizeRedemptionPhantomTokenAbi } from "./withdrawalAbi.js";
 import { erc20Abi, hexToString, parseAbi, parseEther } from "viem";