@gearbox-protocol/sdk 14.12.0-next.64 → 14.12.0-next.66

package/dist/cjs/dev/index.js

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_dev_abi = require("./abi.js");
 const require_dev_claimFromFaucet = require("./claimFromFaucet.js");
 const require_dev_createAnvilClient = require("./createAnvilClient.js");
+const require_dev_kycUtils = require("./kycUtils.js");
 const require_dev_midasUtils = require("./midasUtils.js");
 const require_dev_mint_factory = require("./mint/factory.js");
 require("./mint/index.js");
@@ -15,7 +16,6 @@ const require_dev_detectChain = require("./detectChain.js");
 const require_dev_isOutOfSyncError = require("./isOutOfSyncError.js");
 const require_dev_isRateLimitError = require("./isRateLimitError.js");
 const require_dev_isTransientError = require("./isTransientError.js");
-const require_dev_kycUtils = require("./kycUtils.js");
 const require_dev_logSplitterTransport = require("./logSplitterTransport.js");
 const require_dev_ltUtils = require("./ltUtils.js");
 const require_dev_migrateFaucet = require("./migrateFaucet.js");
@@ -46,6 +46,7 @@ exports.createAnvilClient = require_dev_createAnvilClient.createAnvilClient;
 exports.createMinter = require_dev_mint_factory.createMinter;
 exports.deployUsingPublicCreate2 = require_dev_create2.deployUsingPublicCreate2;
 exports.detectChain = require_dev_detectChain.detectChain;
+exports.enableDSTokenBackDating = require_dev_securitizeUtils.enableDSTokenBackDating;
 exports.evmMineDetailed = require_dev_createAnvilClient.evmMineDetailed;
 exports.extendAnvilClient = require_dev_createAnvilClient.extendAnvilClient;
 exports.faucetAbi = require_dev_abi.faucetAbi;
@@ -84,5 +85,6 @@ exports.revolverTransportConfigSchema = require_dev_RevolverTransport.revolverTr
 exports.rpcProvidersSchema = require_dev_providers.rpcProvidersSchema;
 exports.setLTZero = require_dev_ltUtils.setLTZero;
 exports.setLTs = require_dev_ltUtils.setLTs;
+exports.unpauseMidasIssuanceVault = require_dev_midasUtils.unpauseMidasIssuanceVault;
 exports.verifyTestnet = require_dev_verifyTestnet.verifyTestnet;
 exports.writeAndWait = require_dev_kycUtils.writeAndWait;

package/dist/cjs/dev/kycUtils.js

@@ -3,9 +3,9 @@ const require_sdk_utils_AddressSet = require("../sdk/utils/AddressSet.js");
 const require_sdk_constants_math = require("../sdk/constants/math.js");
 const require_sdk_OnchainSDK = require("../sdk/OnchainSDK.js");
 require("../sdk/index.js");
-const require_dev_withdrawalAbi = require("./withdrawalAbi.js");
 const require_abi_rwa_iDSRegistryService = require("../abi/rwa/iDSRegistryService.js");
 const require_abi_rwa_iDSToken = require("../abi/rwa/iDSToken.js");
+const require_dev_withdrawalAbi = require("./withdrawalAbi.js");
 let viem = require("viem");
 let viem_accounts = require("viem/accounts");
 //#region src/dev/kycUtils.ts

package/dist/cjs/dev/midasUtils.js

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_dev_withdrawalAbi = require("./withdrawalAbi.js");
+const require_dev_kycUtils = require("./kycUtils.js");
 let viem = require("viem");
 //#region src/dev/midasUtils.ts
 const ADAPTER_MIDAS_GATEWAY = "ADAPTER::MIDAS_GATEWAY";
@@ -16,6 +17,18 @@ const MIDAS_MODE_PERMISSIONLESS = 0;
 */
 const iMidasMTokenAbi = (0, viem.parseAbi)(["function mToken() external view returns (address)"]);
 const iMidasGatewayAdapterExtAbi = (0, viem.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 = (0, viem.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 = (0, viem.parseAbi)(["function hasRole(bytes32 role, address account) external view returns (bool)", "function grantRole(bytes32 role, address account) external"]);
 const receiveGreenlistCallData = (0, viem.encodeFunctionData)({
 	abi: iMidasGatewayAdapterExtAbi,
 	functionName: "receiveGreenlist"
@@ -86,6 +99,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: (0, viem.parseEther)("100")
+		});
+		if (!isPauseAdmin) {
+			await require_dev_kycUtils.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 require_dev_kycUtils.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: (0, viem.parseEther)("100")
+			});
+			await require_dev_kycUtils.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,
@@ -98,3 +201,4 @@ async function readMTokens(client, adapters) {
 }
 //#endregion
 exports.prependMidasReceiveGreenlist = prependMidasReceiveGreenlist;
+exports.unpauseMidasIssuanceVault = unpauseMidasIssuanceVault;

package/dist/cjs/dev/securitizeUtils.js

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_utils_AddressSet = require("../sdk/utils/AddressSet.js");
 const require_sdk_OnchainSDK = require("../sdk/OnchainSDK.js");
 require("../sdk/index.js");
 const require_abi_rwa_iDSToken = require("../abi/rwa/iDSToken.js");
@@ -14,7 +15,9 @@ const iDSComplianceConfigurationServiceAbi = (0, viem.parseAbi)([
 	"function getUSLockPeriod() external view returns (uint256)",
 	"function getNonUSLockPeriod() external view returns (uint256)",
 	"function setUSLockPeriod(uint256) external",
-	"function setNonUSLockPeriod(uint256) external"
+	"function setNonUSLockPeriod(uint256) external",
+	"function getDisallowBackDating() external view returns (bool)",
+	"function setDisallowBackDating(bool) external"
 ]);
 /**
 * Returns the longest of US and non-US compliance lock periods, or `undefined`
@@ -62,7 +65,7 @@ async function issueDSTokens(props) {
 		const { timestamp } = await anvil.getBlock();
 		const issuanceTime = timestamp - lockPeriod - 1n;
 		try {
-			await require_dev_kycUtils.writeAndWait(anvil, {
+			const hash = await require_dev_kycUtils.writeAndWait(anvil, {
 				account,
 				chain: anvil.chain,
 				address: token,
@@ -82,6 +85,7 @@ async function issueDSTokens(props) {
 				investor,
 				amount
 			}, "issueTokensCustom successful");
+			return hash;
 		} catch (e) {
 			logger?.debug(`issueTokensCustom failed: ${e}`);
 		}
@@ -99,6 +103,94 @@ async function issueDSTokens(props) {
 		args: [investor, amount]
 	});
 }
+/**
+* Resolves unique compliance configuration services of `tokens`: several
+* DSTokens can share one service, and it's the service that holds the flags.
+* Tokens without one (e.g. MockDSToken) are skipped
+*/
+async function getComplianceConfigurationServices({ anvil, tokens, logger }) {
+	const services = new require_sdk_utils_AddressSet.AddressSet();
+	for (const token of new require_sdk_utils_AddressSet.AddressSet(tokens)) try {
+		const service = await anvil.readContract({
+			address: token,
+			abi: require_abi_rwa_iDSToken.iDSTokenAbi,
+			functionName: "getDSService",
+			args: [COMPLIANCE_CONFIGURATION_SERVICE]
+		});
+		if ((0, viem.isAddressEqual)(service, viem.zeroAddress)) {
+			logger?.debug(`${token} has no compliance configuration service`);
+			continue;
+		}
+		services.add(service);
+	} catch (e) {
+		logger?.debug(`Failed to get compliance configuration service of ${token}: ${e}`);
+	}
+	return [...services];
+}
+/**
+* Sets `disallowBackDating` to false on compliance configuration services of
+* `tokens`, so that the issuance time passed to `issueTokensCustom` is
+* honoured: DS protocol silently replaces it with `block.timestamp` otherwise,
+* and freshly minted tokens stay under lock-up.
+*
+* Must be signed by a DS admin with sufficient trust (same key as
+* `issueTokens` / registerInvestor); Ownable `owner()` alone is not enough.
+*
+* The flag is only read while tokens are issued, so restoring it does not
+* re-lock tokens minted in the meantime.
+*/
+async function enableDSTokenBackDating(props) {
+	const { anvil, adminPrivateKey, logger } = props;
+	const account = (0, viem_accounts.privateKeyToAccount)(adminPrivateKey);
+	const services = await getComplianceConfigurationServices(props);
+	let toRestore = [];
+	for (const service of services) {
+		let disallowBackDating;
+		try {
+			disallowBackDating = await anvil.readContract({
+				address: service,
+				abi: iDSComplianceConfigurationServiceAbi,
+				functionName: "getDisallowBackDating"
+			});
+		} catch (e) {
+			logger?.debug(`Failed to read disallowBackDating of ${service}: ${e}`);
+			continue;
+		}
+		if (!disallowBackDating) {
+			logger?.debug(`Back-dating is already allowed by ${service}`);
+			continue;
+		}
+		logger?.info(`Allowing back-dating on ${service}`);
+		await require_dev_kycUtils.writeAndWait(anvil, {
+			account,
+			chain: anvil.chain,
+			address: service,
+			abi: iDSComplianceConfigurationServiceAbi,
+			functionName: "setDisallowBackDating",
+			args: [false]
+		});
+		toRestore.push(service);
+	}
+	return async () => {
+		const services = toRestore;
+		toRestore = [];
+		for (const service of services) {
+			logger?.info(`Disallowing back-dating on ${service}`);
+			try {
+				await require_dev_kycUtils.writeAndWait(anvil, {
+					account,
+					chain: anvil.chain,
+					address: service,
+					abi: iDSComplianceConfigurationServiceAbi,
+					functionName: "setDisallowBackDating",
+					args: [true]
+				});
+			} catch (e) {
+				logger?.warn(`Failed to restore disallowBackDating on ${service}: ${e}`);
+			}
+		}
+	};
+}
 async function claimDSToken(props) {
 	const { anvil, investor, adminPrivateKey, token, marketConfigurators, rwaFactories, usdAmount: usdAmountProp = "100000" } = props;
 	const account = (0, viem_accounts.privateKeyToAccount)(adminPrivateKey);
@@ -164,3 +256,4 @@ async function claimDSTokens(props) {
 //#endregion
 exports.claimDSToken = claimDSToken;
 exports.claimDSTokens = claimDSTokens;
+exports.enableDSTokenBackDating = enableDSTokenBackDating;

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,15 +15,14 @@ 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";
 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 { claimDSToken, claimDSTokens } from "./securitizeUtils.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, EthCallSpy, NoAvailableTransportsError, ONCHAIN_EXECUTION_ID_ADDRESS, OpenTxRevertedError, PUBLIC_CREATE2_FACTORY, RevolverTransport, SUPPORTED_RPC_PROVIDERS, SelectionStrategy, anvilNodeInfo, calcLiquidatableLTs, claimDSToken, claimDSTokens, claimFromFaucet, createAnvilClient, createMinter, deployUsingPublicCreate2, detectChain, 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/securitizeUtils.js

@@ -1,3 +1,4 @@
+import { AddressSet } from "../sdk/utils/AddressSet.js";
 import { OnchainSDK } from "../sdk/OnchainSDK.js";
 import "../sdk/index.js";
 import { iDSTokenAbi } from "../abi/rwa/iDSToken.js";
@@ -13,7 +14,9 @@ const iDSComplianceConfigurationServiceAbi = parseAbi([
 	"function getUSLockPeriod() external view returns (uint256)",
 	"function getNonUSLockPeriod() external view returns (uint256)",
 	"function setUSLockPeriod(uint256) external",
-	"function setNonUSLockPeriod(uint256) external"
+	"function setNonUSLockPeriod(uint256) external",
+	"function getDisallowBackDating() external view returns (bool)",
+	"function setDisallowBackDating(bool) external"
 ]);
 /**
 * Returns the longest of US and non-US compliance lock periods, or `undefined`
@@ -61,7 +64,7 @@ async function issueDSTokens(props) {
 		const { timestamp } = await anvil.getBlock();
 		const issuanceTime = timestamp - lockPeriod - 1n;
 		try {
-			await writeAndWait(anvil, {
+			const hash = await writeAndWait(anvil, {
 				account,
 				chain: anvil.chain,
 				address: token,
@@ -81,6 +84,7 @@ async function issueDSTokens(props) {
 				investor,
 				amount
 			}, "issueTokensCustom successful");
+			return hash;
 		} catch (e) {
 			logger?.debug(`issueTokensCustom failed: ${e}`);
 		}
@@ -98,6 +102,94 @@ async function issueDSTokens(props) {
 		args: [investor, amount]
 	});
 }
+/**
+* Resolves unique compliance configuration services of `tokens`: several
+* DSTokens can share one service, and it's the service that holds the flags.
+* Tokens without one (e.g. MockDSToken) are skipped
+*/
+async function getComplianceConfigurationServices({ anvil, tokens, logger }) {
+	const services = new AddressSet();
+	for (const token of new AddressSet(tokens)) try {
+		const service = await anvil.readContract({
+			address: token,
+			abi: iDSTokenAbi,
+			functionName: "getDSService",
+			args: [COMPLIANCE_CONFIGURATION_SERVICE]
+		});
+		if (isAddressEqual(service, zeroAddress)) {
+			logger?.debug(`${token} has no compliance configuration service`);
+			continue;
+		}
+		services.add(service);
+	} catch (e) {
+		logger?.debug(`Failed to get compliance configuration service of ${token}: ${e}`);
+	}
+	return [...services];
+}
+/**
+* Sets `disallowBackDating` to false on compliance configuration services of
+* `tokens`, so that the issuance time passed to `issueTokensCustom` is
+* honoured: DS protocol silently replaces it with `block.timestamp` otherwise,
+* and freshly minted tokens stay under lock-up.
+*
+* Must be signed by a DS admin with sufficient trust (same key as
+* `issueTokens` / registerInvestor); Ownable `owner()` alone is not enough.
+*
+* The flag is only read while tokens are issued, so restoring it does not
+* re-lock tokens minted in the meantime.
+*/
+async function enableDSTokenBackDating(props) {
+	const { anvil, adminPrivateKey, logger } = props;
+	const account = privateKeyToAccount(adminPrivateKey);
+	const services = await getComplianceConfigurationServices(props);
+	let toRestore = [];
+	for (const service of services) {
+		let disallowBackDating;
+		try {
+			disallowBackDating = await anvil.readContract({
+				address: service,
+				abi: iDSComplianceConfigurationServiceAbi,
+				functionName: "getDisallowBackDating"
+			});
+		} catch (e) {
+			logger?.debug(`Failed to read disallowBackDating of ${service}: ${e}`);
+			continue;
+		}
+		if (!disallowBackDating) {
+			logger?.debug(`Back-dating is already allowed by ${service}`);
+			continue;
+		}
+		logger?.info(`Allowing back-dating on ${service}`);
+		await writeAndWait(anvil, {
+			account,
+			chain: anvil.chain,
+			address: service,
+			abi: iDSComplianceConfigurationServiceAbi,
+			functionName: "setDisallowBackDating",
+			args: [false]
+		});
+		toRestore.push(service);
+	}
+	return async () => {
+		const services = toRestore;
+		toRestore = [];
+		for (const service of services) {
+			logger?.info(`Disallowing back-dating on ${service}`);
+			try {
+				await writeAndWait(anvil, {
+					account,
+					chain: anvil.chain,
+					address: service,
+					abi: iDSComplianceConfigurationServiceAbi,
+					functionName: "setDisallowBackDating",
+					args: [true]
+				});
+			} catch (e) {
+				logger?.warn(`Failed to restore disallowBackDating on ${service}: ${e}`);
+			}
+		}
+	};
+}
 async function claimDSToken(props) {
 	const { anvil, investor, adminPrivateKey, token, marketConfigurators, rwaFactories, usdAmount: usdAmountProp = "100000" } = props;
 	const account = privateKeyToAccount(adminPrivateKey);
@@ -161,4 +253,4 @@ async function claimDSTokens(props) {
 	});
 }
 //#endregion
-export { claimDSToken, claimDSTokens };
+export { claimDSToken, claimDSTokens, enableDSTokenBackDating };

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

@@ -14,7 +14,7 @@ import { isTransientError } from "./isTransientError.js";
 import { GreenlistMidasGatewayProps, RWAKycFailure, RegisterMidasInvestorProps, RegisterRWAInvestorProps, RegisterRWAInvestorResult, RegisterSecuritizeInvestorProps, greenlistMidasGateway, registerMidasInvestor, registerRWAInvestor, registerSecuritizeInvestor, writeAndWait } from "./kycUtils.js";
 import { LogSplitterTransportOptions, isRangeError, logSplitterTransport } from "./logSplitterTransport.js";
 import { setLTZero, setLTs } from "./ltUtils.js";
-import { PrependMidasReceiveGreenlistProps, prependMidasReceiveGreenlist } from "./midasUtils.js";
+import { PrependMidasReceiveGreenlistProps, RestoreMidasIssuanceVaultPause, UnpauseMidasIssuanceVaultProps, prependMidasReceiveGreenlist, unpauseMidasIssuanceVault } from "./midasUtils.js";
 import { migrateFaucet } from "./migrateFaucet.js";
 import { IMinter } from "./mint/types.js";
 import { createMinter } from "./mint/factory.js";
@@ -22,8 +22,8 @@ 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 { DisableDSTokenLockPeriodsProps, claimDSToken, claimDSTokens } from "./securitizeUtils.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, DetectedCall, DisableDSTokenLockPeriodsProps, EnsureExistsUsingPublicCreate2ReturnType, EthCallMethod, EthCallRequest, EthCallSpy, GetCreate2AddressParameters, GreenlistMidasGatewayProps, IMinter, type LogSplitterTransportOptions, MakePendingWithdrawalsClaimableOptions, NoAvailableTransportsError, ONCHAIN_EXECUTION_ID_ADDRESS, OpenAccountHumanizedPreview, OpenAccountResult, OpenAccountsResult, OpenTxRevertedError, PUBLIC_CREATE2_FACTORY, PoolDepositResult, PrependMidasReceiveGreenlistProps, ProviderConfig, ProviderStatus, RWAKycFailure, RegisterMidasInvestorProps, RegisterRWAInvestorProps, RegisterRWAInvestorResult, RegisterSecuritizeInvestorProps, ReplaceStorageParams, ResilientTransportOptions, RevolverTransport, RevolverTransportConfig, RevolverTransportValue, RpcErrorResult, RpcProvider, RpcResponse, RpcSuccessResult, SUPPORTED_RPC_PROVIDERS, SelectionStrategy, TargetAccount, VerifyTestnetParams, anvilNodeInfo, calcLiquidatableLTs, claimDSToken, claimDSTokens, claimFromFaucet, createAnvilClient, createMinter, deployUsingPublicCreate2, detectChain, 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, AccountOpenerOptions, AnvilActions, AnvilClient, AnvilClientConfig, AnvilDealParameters, AnvilNodeInfo, AnvilRPCSchema, CheckMulticallFn, Create2Deployer, Create2Parameters, DEFAULT_CREATE2_SALT, DetectedCall, EnableDSTokenBackDatingProps, EnsureExistsUsingPublicCreate2ReturnType, EthCallMethod, EthCallRequest, EthCallSpy, GetCreate2AddressParameters, GreenlistMidasGatewayProps, IMinter, type LogSplitterTransportOptions, MakePendingWithdrawalsClaimableOptions, NoAvailableTransportsError, ONCHAIN_EXECUTION_ID_ADDRESS, OpenAccountHumanizedPreview, OpenAccountResult, OpenAccountsResult, OpenTxRevertedError, PUBLIC_CREATE2_FACTORY, PoolDepositResult, PrependMidasReceiveGreenlistProps, 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, 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/types/dev/midasUtils.d.ts

@@ -2,7 +2,8 @@ import { ILogger } from "../sdk/types/logger.js";
 import { CreditSuite } from "../sdk/market/credit/CreditSuite.js";
 import { MultiCall } from "../sdk/types/transactions.js";
 import "../sdk/index.js";
-import { PublicClient } from "viem";
+import { AnvilClient } from "./createAnvilClient.js";
+import { Address, PublicClient } from "viem";
 //#region src/dev/midasUtils.d.ts
 interface PrependMidasReceiveGreenlistProps {
   /**
@@ -35,5 +36,33 @@ interface PrependMidasReceiveGreenlistProps {
  * the gateway is permissionless, or the call is already there.
  */
 declare function prependMidasReceiveGreenlist(props: PrependMidasReceiveGreenlistProps): Promise<MultiCall[]>;
+interface UnpauseMidasIssuanceVaultProps {
+  anvil: AnvilClient;
+  /**
+   * Midas issuance vault (deposit vault) to unpause
+   */
+  vault: Address;
+  /**
+   * Midas access control admin, impersonated on the fork
+   * (MIDAS_ACL_ADMIN in periphery-v3/router-v3 foundry tests)
+   */
+  admin: Address;
+  logger?: ILogger;
+}
+/**
+ * Pauses the vault back when it was unpaused by `unpauseMidasIssuanceVault`,
+ * and does nothing otherwise. Safe to call more than once.
+ */
+type RestoreMidasIssuanceVaultPause = () => Promise<void>;
+/**
+ * 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.
+ */
+declare function unpauseMidasIssuanceVault(props: UnpauseMidasIssuanceVaultProps): Promise<RestoreMidasIssuanceVaultPause>;
 //#endregion
-export { PrependMidasReceiveGreenlistProps, prependMidasReceiveGreenlist };
+export { PrependMidasReceiveGreenlistProps, RestoreMidasIssuanceVaultPause, UnpauseMidasIssuanceVaultProps, prependMidasReceiveGreenlist, unpauseMidasIssuanceVault };

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

@@ -22,7 +22,7 @@ interface ClaimDSTokenProps {
 type ClaimDSTokensProps = Omit<ClaimDSTokenProps, "token"> & {
   tokens: Address[];
 };
-interface DisableDSTokenLockPeriodsProps {
+interface EnableDSTokenBackDatingProps {
   anvil: AnvilClient;
   /**
    * Securitize DS admin with sufficient trust to call compliance setters
@@ -30,11 +30,29 @@ interface DisableDSTokenLockPeriodsProps {
    */
   adminPrivateKey: Hex;
   /**
-   * DSToken addresses whose compliance lock periods should be zeroed
+   * DSToken addresses whose compliance configuration should allow back-dating
    */
   tokens: Address[];
   logger?: ILogger;
 }
+/**
+ * Restores `disallowBackDating` to its previous value on every compliance
+ * configuration service that was changed. Safe to call more than once.
+ */
+type RestoreDSTokenBackDating = () => Promise<void>;
+/**
+ * Sets `disallowBackDating` to false on compliance configuration services of
+ * `tokens`, so that the issuance time passed to `issueTokensCustom` is
+ * honoured: DS protocol silently replaces it with `block.timestamp` otherwise,
+ * and freshly minted tokens stay under lock-up.
+ *
+ * Must be signed by a DS admin with sufficient trust (same key as
+ * `issueTokens` / registerInvestor); Ownable `owner()` alone is not enough.
+ *
+ * The flag is only read while tokens are issued, so restoring it does not
+ * re-lock tokens minted in the meantime.
+ */
+declare function enableDSTokenBackDating(props: EnableDSTokenBackDatingProps): Promise<RestoreDSTokenBackDating>;
 declare function claimDSToken(props: ClaimDSTokenProps): Promise<void>;
 /**
  * Helper function to claim DSToken from the faucet.
@@ -46,4 +64,4 @@ declare function claimDSToken(props: ClaimDSTokenProps): Promise<void>;
  */
 declare function claimDSTokens(props: ClaimDSTokensProps): Promise<void>;
 //#endregion
-export { DisableDSTokenLockPeriodsProps, claimDSToken, claimDSTokens };
+export { EnableDSTokenBackDatingProps, RestoreDSTokenBackDating, claimDSToken, claimDSTokens, enableDSTokenBackDating };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "14.12.0-next.64",
+  "version": "14.12.0-next.66",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {