@gearbox-protocol/sdk 16.3.0-next.4 → 17.0.0-next.1

package/dist/esm/onchain/market/rwa/securitize/SecuritizeDegenNFT.js

@@ -1,23 +1,13 @@
-import { AddressSet } from "../../../utils/AddressSet.js";
-import "../../../utils/index.js";
 import { BaseContract } from "../../../base/BaseContract.js";
 import "../../../base/index.js";
-import { KYC_REGISTRATION_LINKS } from "../../../../model/rwa.js";
-import "../../../../model/index.js";
 import { DEGEN_NFT_SECURITIZE } from "./constants.js";
 import { iSecuritizeDegenNFTAbi } from "../../../../abi/rwa/iSecuritizeDegenNFT.js";
+import { isAddressEqual } from "viem";
 //#region src/onchain/market/rwa/securitize/SecuritizeDegenNFT.ts
 const abi = iSecuritizeDegenNFTAbi;
-/**
-* Securitize always has a factory, which deploys this NFT. DS-token data,
-* registrars and cached signatures live here; the factory only builds txs
-* and looks up investor/wallet addresses.
-*/
 var SecuritizeDegenNFT = class extends BaseContract {
 	protocol = "securitize";
-	registrationLink = KYC_REGISTRATION_LINKS.securitize;
 	factory;
-	#sdk;
 	constructor(sdk, address, factory) {
 		super(sdk, {
 			addr: address,
@@ -26,54 +16,19 @@ var SecuritizeDegenNFT = class extends BaseContract {
 			name: "SecuritizeDegenNFT",
 			abi
 		});
-		this.#sdk = sdk;
 		this.factory = factory;
 	}
-	async getTokens() {
-		return this.factory.getTokens();
-	}
-	/**
-	* Registration on Securitize is the protocol-side KYC step; pending
-	* EIP-712 signatures are tx-side leftover, not KYC.
-	*/
-	async getOpenAccountRequirements(wallet, props) {
-		const tokensToRegister = new AddressSet(this.factory.getTokens()).has(props.tokenOutAddress) ? new AddressSet([props.tokenOutAddress]) : new AddressSet();
-		if (tokensToRegister.size === 0) return {
-			protocol: "securitize",
-			factory: this.factory.address,
-			securitizeTokensToRegister: [],
-			tokensToRegister: [],
-			requiredSignatures: []
-		};
-		const [investorData] = await this.#sdk.rwa.getInvestorData(wallet, [this.factory.address]);
-		const registredTokens = new AddressSet(investorData.registeredTokens);
-		const signedTokens = new AddressSet(investorData.cachedSignatures.map((s) => s.token));
-		const unsignedTokens = tokensToRegister.difference(signedTokens);
-		const securitizeTokensToRegister = tokensToRegister.difference(registredTokens);
-		const requiredSignatures = investorData.registerVaultMessages.filter((m) => unsignedTokens.has(m.message.token));
-		return {
-			protocol: "securitize",
-			factory: this.factory.address,
-			securitizeTokensToRegister: Array.from(securitizeTokensToRegister),
-			tokensToRegister: Array.from(tokensToRegister),
-			requiredSignatures
+	/** Registration on Securitize is the only KYC step; pending EIP-712 signatures are not. */
+	async checkKyc(wallet, targetCollateral) {
+		const { factory } = this;
+		if (!factory.getTokens().some((t) => isAddressEqual(t, targetCollateral))) return {
+			eligible: true,
+			token: targetCollateral
 		};
-	}
-	isRegistered(requirements) {
-		return requirements.securitizeTokensToRegister.length === 0;
-	}
-	/**
-	* A required signature is omitted when `providedArgs.signaturesToCache`
-	* already carries a signature for the same token: the transaction caches it
-	* on-chain as part of the operation.
-	*/
-	getMissingRequirements(requirements, providedArgs) {
-		const providedTokens = new AddressSet((providedArgs?.signaturesToCache ?? []).map((s) => s.token));
-		const requiredSignatures = requirements.requiredSignatures.filter((message) => !providedTokens.has(message.message.token));
-		if (requiredSignatures.length === 0) return;
+		const req = await factory.getOpenAccountRequirements(wallet, { tokenOutAddress: targetCollateral });
 		return {
-			protocol: "securitize",
-			requiredSignatures
+			eligible: !req || req.securitizeTokensToRegister.length === 0,
+			token: req?.securitizeTokensToRegister[0] ?? targetCollateral
 		};
 	}
 };

package/dist/esm/onchain/market/rwa/securitize/SecuritizeRWAFactory.js

@@ -1,4 +1,5 @@
 import { AddressMap } from "../../../utils/AddressMap.js";
+import { AddressSet } from "../../../utils/AddressSet.js";
 import "../../../utils/index.js";
 import { BaseContract } from "../../../base/BaseContract.js";
 import "../../../base/index.js";
@@ -10,6 +11,7 @@ import { decodeAbiParameters } from "viem";
 //#region src/onchain/market/rwa/securitize/SecuritizeRWAFactory.ts
 const abi = iSecuritizeRWAFactoryAbi;
 var SecuritizeRWAFactory = class extends BaseContract {
+	#sdk;
 	#investorCache = new AddressMap();
 	degenNFT;
 	owner;
@@ -21,6 +23,7 @@ var SecuritizeRWAFactory = class extends BaseContract {
 			name: "SecuritizeRWAFactory",
 			abi
 		});
+		this.#sdk = sdk;
 		const decoded = decodeAbiParameters([
 			{
 				name: "owner",
@@ -181,6 +184,40 @@ var SecuritizeRWAFactory = class extends BaseContract {
 		});
 	}
 	/**
+	* {@inheritDoc IRWAFactory.getOpenAccountRequirements}
+	*/
+	async getOpenAccountRequirements(investor, props) {
+		const [investorData] = await this.#sdk.rwa.getInvestorData(investor, [this.address]);
+		const tokensToRegister = new AddressSet([props.tokenOutAddress]);
+		const registredTokens = new AddressSet(investorData.registeredTokens);
+		const signedTokens = new AddressSet(investorData.cachedSignatures.map((s) => s.token));
+		const unsignedTokens = tokensToRegister.difference(signedTokens);
+		const securitizeTokensToRegister = tokensToRegister.difference(registredTokens);
+		const requiredSignatures = investorData.registerVaultMessages.filter((m) => unsignedTokens.has(m.message.token));
+		return {
+			type: RWA_FACTORY_SECURITIZE,
+			securitizeTokensToRegister: Array.from(securitizeTokensToRegister),
+			tokensToRegister: Array.from(tokensToRegister),
+			requiredSignatures
+		};
+	}
+	/**
+	* {@inheritDoc IRWAFactory.getMissingRequirements}
+	*
+	* A required signature is omitted when `providedArgs.signaturesToCache`
+	* already carries a signature for the same token: the transaction caches it
+	* on-chain as part of the operation.
+	*/
+	getMissingRequirements(requirements, providedArgs) {
+		const providedTokens = new AddressSet((providedArgs?.signaturesToCache ?? []).map((s) => s.token));
+		const requiredSignatures = requirements.requiredSignatures.filter((message) => !providedTokens.has(message.message.token));
+		if (requiredSignatures.length === 0) return;
+		return {
+			type: RWA_FACTORY_SECURITIZE,
+			requiredSignatures
+		};
+	}
+	/**
 	* {@inheritDoc IRWAFactory.openCreditAccount}
 	*/
 	openCreditAccount(creditManager, calls, args) {

package/dist/esm/onchain/market/zapper/IETHZapperContract.js

@@ -1,5 +1,5 @@
-import { iethZapperAbi } from "../../../abi/iETHZapper.js";
 import { ZapperContract } from "./ZapperContract.js";
+import { iethZapperAbi } from "../../../abi/iETHZapper.js";
 //#region src/onchain/market/zapper/IETHZapperContract.ts
 const abi = iethZapperAbi;
 var IETHZapperContract = class extends ZapperContract {

package/dist/esm/onchain/market/zapper/ZapperContract.js

@@ -1,8 +1,8 @@
-import { iZapperAbi } from "../../../abi/iZapper.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
 import { sdkErr, sdkOk } from "../../../model/result.js";
 import "../../../model/index.js";
+import { iZapperAbi } from "../../../abi/iZapper.js";
 //#region src/onchain/market/zapper/ZapperContract.ts
 /**
 * Base contract for every Gearbox zapper. Specialized zappers (e.g.

package/dist/esm/onchain/opportunities/MultichainOpportunitiesService.js

@@ -37,18 +37,12 @@ var MultichainOpportunitiesService = class extends MultichainConstruct {
 	*
 	* See {@link MultichainOpportunitiesService.getPool}.
 	**/
-	async getStrategy(key) {
+	async getStrategy(key, wallet) {
 		return this.queryChain({
 			network: key.chainId,
-			run: (sdk) => sdk.opportunities.getStrategy(key)
+			run: (sdk) => sdk.opportunities.getStrategy(key, wallet)
 		});
 	}
-	/**
-	* {@inheritDoc OpportunitiesService.isEligibleForStrategy}
-	**/
-	async isEligibleForStrategy(key, wallet) {
-		return this.sdk.chain(key.chainId).opportunities.isEligibleForStrategy(key, wallet);
-	}
 };
 //#endregion
 export { MultichainOpportunitiesService };

package/dist/esm/onchain/opportunities/OpportunitiesService.js

@@ -36,34 +36,22 @@ var OpportunitiesService = class extends SDKConstruct {
 	* A single strategy opportunity plus the rate curve of the pool it borrows
 	* from and the price feeds its liquidation price depends on.
 	*
-	* `kyc` is the strategy's KYC gate, independent of any wallet.
+	* @param wallet - When given, `kyc` says whether this wallet must register
+	* with the strategy's KYC provider first; `null` otherwise.
 	*
 	* @throws If the credit manager is unknown, or does not currently offer a
 	* strategy.
 	**/
-	async getStrategy(key) {
+	async getStrategy(key, wallet) {
 		const suite = this.sdk.marketRegister.findCreditManager(key.creditManager);
 		const detail = suite.strategyOpportunityDetail();
 		if (!detail) throw new Error(`credit manager ${key.creditManager} does not currently offer a strategy`);
-		const kyc = await suite.kycRequirement(detail.targetCollateral.address);
+		const kyc = wallet ? await suite.kycRequirement(wallet, detail.targetCollateral.address) : null;
 		return {
 			...detail,
 			kyc
 		};
 	}
-	/**
-	* Whether `wallet` may open this strategy today: `true` when it is not
-	* KYC-gated or the wallet already passed the gate.
-	*
-	* @throws If the credit manager is unknown, or does not currently offer a
-	* strategy.
-	**/
-	async isEligibleForStrategy(key, wallet) {
-		const suite = this.sdk.marketRegister.findCreditManager(key.creditManager);
-		const opportunity = suite.strategyOpportunity();
-		if (!opportunity) throw new Error(`credit manager ${key.creditManager} does not currently offer a strategy`);
-		return suite.isEligibleForStrategy(wallet, opportunity.targetCollateral.address);
-	}
 };
 //#endregion
 export { OpportunitiesService };

package/dist/esm/onchain/preview/parse/parseRWAFactoryOperationCalldata.js

@@ -1,7 +1,7 @@
 import { hexEq } from "../../utils/hex.js";
 import { AbstractAdapterContract } from "../../market/adapters/contracts/AbstractAdapter.js";
 import { CreditFacadeV310Contract } from "../../market/credit/CreditFacadeV310Contract.js";
-import "../../../model/rwa.js";
+import { RWA_FACTORY_SECURITIZE } from "../../../model/rwa.js";
 import "../../../model/index.js";
 import { isRWAFactory } from "../../market/rwa/types.js";
 import { classifyInnerOperations } from "./classifyInnerOperations.js";
@@ -32,7 +32,7 @@ function parseSecuritizeOperationCalldata(sdk, factory, calldata) {
 	const { rawArgs } = parsed;
 	const innerCalls = rawArgs.calls ?? [];
 	const args = {
-		protocol: "securitize",
+		type: RWA_FACTORY_SECURITIZE,
 		tokensToRegister: [...rawArgs.tokensToRegister ?? []],
 		signaturesToCache: [...rawArgs.signaturesToCache ?? []]
 	};

package/dist/esm/onchain/preview/preview/previewPoolPositionOperation.js

@@ -1,8 +1,8 @@
-import { ierc20Abi } from "../../../abi/iERC20.js";
-import { iZapperAbi } from "../../../abi/iZapper.js";
 import { iPoolV310Abi } from "../../../abi/310/generated.js";
+import { ierc20Abi } from "../../../abi/iERC20.js";
 import { sdkErr, sdkOk } from "../../../model/result.js";
 import "../../../model/index.js";
+import { iZapperAbi } from "../../../abi/iZapper.js";
 //#region src/onchain/preview/preview/previewPoolPositionOperation.ts
 function previewRead(operation) {
 	switch (operation.operation) {

package/dist/esm/onchain/utils/viem/simulateWithPriceUpdates.js

@@ -1,6 +1,6 @@
 import { errorAbis } from "../../../abi/errors.js";
-import { iUpdatablePriceFeedAbi } from "../../../abi/iUpdatablePriceFeed.js";
 import { generateCastTraceCall } from "./cast.js";
+import { iUpdatablePriceFeedAbi } from "../../../abi/iUpdatablePriceFeed.js";
 import { simulateMulticall } from "./simulateMulticall.js";
 import { BaseError, CallExecutionError, ContractFunctionRevertedError, decodeFunctionData, decodeFunctionResult, encodeFunctionData, parseAbi } from "viem";
 import { getAction, parseAccount } from "viem/utils";

package/dist/esm/onchain/validation/bundles/checkCreditOperation.js

@@ -32,8 +32,7 @@ async function checkCreditOperation(args) {
 			minDebt: suite.creditFacade.minDebt,
 			maxDebt: suite.creditFacade.maxDebt,
 			underlying,
-			allowZero: !isOpening,
-			maxBorrowAmount: suite.maxBorrowAmount()
+			allowZero: !isOpening
 		}),
 		...checkDraw(suite, preview, underlying),
 		...checkObtained(suite, preview),
@@ -50,7 +49,7 @@ async function checkCreditOperation(args) {
 		preview,
 		sender,
 		blockNumber
-	}), preview.operation === "OpenCreditAccount" || preview.operation === "RWAOpenCreditAccount" ? checkRWAOpening({
+	}), preview.operation === "RWAOpenCreditAccount" ? checkRWAOpening({
 		sdk,
 		preview,
 		sender

package/dist/esm/onchain/validation/bundles/checkDraw.js

@@ -15,11 +15,11 @@ import "../checks/index.js";
 function checkDraw(suite, preview, underlying) {
 	const drawn = preview.operation === "AdjustCreditAccount" ? preview.totalDebtChange.value : preview.totalDebt.value;
 	if (drawn <= 0n) return [];
-	const maxBorrowAmount = suite.maxBorrowAmount();
+	const { value, limit } = suite.maxBorrowAmount();
 	return checkBorrowLimit({
 		requested: drawn,
-		available: maxBorrowAmount.amount.value,
-		limit: maxBorrowAmount.limit,
+		available: value,
+		limit,
 		underlying
 	});
 }

package/dist/esm/onchain/validation/bundles/checkRWAOpenRequirements.js

@@ -5,24 +5,24 @@ import { toToken } from "../helpers/token.js";
 import "../helpers/index.js";
 //#region src/onchain/validation/bundles/checkRWAOpenRequirements.ts
 /**
-* The degen NFT is satisfied that `wallet` may open on `token` with the
+* The RWA factory is satisfied that `wallet` may open on `token` with the
 * registration args already on the transaction.
 */
 async function checkRWAOpenRequirements(input) {
 	const { sdk, wallet, creditManager, token, providedArgs } = input;
 	try {
-		const nft = await sdk.marketRegister.findCreditManager(creditManager).degenNFT();
-		if (!nft) return [];
-		const requirements = await nft.getOpenAccountRequirements(wallet, { tokenOutAddress: token });
-		const missing = nft.getMissingRequirements(requirements, providedArgs);
-		if (!missing && nft.isRegistered(requirements)) return [];
+		const requirements = await sdk.accounts.getOpenAccountRequirements(wallet, creditManager, { tokenOutAddress: token });
+		if (!requirements) return [];
+		const { rwaFactory } = sdk.marketRegister.findByCreditManager(creditManager);
+		if (!rwaFactory) throw new Error(`no RWA factory for credit manager ${creditManager}`);
+		const missing = rwaFactory.getMissingRequirements(requirements, providedArgs);
+		if (!missing && requirements.securitizeTokensToRegister.length === 0) return [];
 		return [rwaOpenRequirementsNotMet({
 			token: toToken(sdk, token),
 			creditManager,
-			protocol: nft.protocol,
-			registrationLink: nft.registrationLink,
+			factory: rwaFactory.address,
 			requirements,
-			missing
+			...missing === void 0 ? {} : { missing }
 		})];
 	} catch (cause) {
 		return [unexpectedFailure(cause, "read the RWA opening requirements")];

package/dist/esm/onchain/validation/bundles/checkRWAOpening.js

@@ -2,22 +2,21 @@ import { AddressSet } from "../../utils/AddressSet.js";
 import { checkRWAOpenRequirements } from "./checkRWAOpenRequirements.js";
 //#region src/onchain/validation/bundles/checkRWAOpening.ts
 /**
-* Per KYC-gated token among `collateralAdded ∪ quotas`, whether the
+* Per factory-gated token among `collateralAdded ∪ quotas`, whether the
 * borrower still has to register or sign before this opening can land.
 */
 async function checkRWAOpening(input) {
 	const { sdk, preview, sender } = input;
-	const nft = await sdk.marketRegister.findCreditManager(preview.creditManager).degenNFT();
-	if (!nft) return [];
-	const gated = new AddressSet(await nft.getTokens());
+	const { rwaFactory } = sdk.marketRegister.findByCreditManager(preview.creditManager);
+	if (!rwaFactory) return [];
+	const gated = new AddressSet(rwaFactory.getTokens());
 	const candidates = new AddressSet([...preview.collateralAdded.map((a) => a.token.address), ...preview.quotas.map((q) => q.token.address)]);
-	const providedArgs = preview.operation === "RWAOpenCreditAccount" ? preview.rwaArgs : void 0;
 	return (await Promise.all([...candidates].filter((token) => gated.has(token)).map((token) => checkRWAOpenRequirements({
 		sdk,
 		wallet: sender,
 		creditManager: preview.creditManager,
 		token,
-		providedArgs
+		providedArgs: preview.rwaArgs
 	})))).flat();
 }
 //#endregion

package/dist/esm/onchain/validation/checkSimulation.js

@@ -1,7 +1,6 @@
 import { toToken } from "./helpers/token.js";
 import "./helpers/index.js";
 import { checkDebtLimits } from "./checks/checkDebtLimits.js";
-import { checkQuotaCount } from "./checks/checkQuotaCount.js";
 import "./checks/index.js";
 import { checkAccountQuotas } from "./bundles/checkAccountQuotas.js";
 import { checkHealthFactors } from "./bundles/checkHealthFactors.js";
@@ -27,10 +26,8 @@ import { checkMarket } from "./bundles/checkMarket.js";
 * touched. The engine performed all three during the walk, so a simulation that
 * came back `ok` has already passed them.
 *
-* A credit account only, opened or adjusted: a pool operation has no account
-* to weigh, and the three things its own state decides are read by `prepare`
-* before it answers. An opening names its quotas `averageQuota` — the branch
-* the planner already weighed it as.
+* A credit account only: a pool operation has no account to weigh, and the
+* three things its own state decides are read by `prepare` before it answers.
 */
 function checkSimulation(sdk, input, options = {}) {
 	const { state } = input;
@@ -42,13 +39,9 @@ function checkSimulation(sdk, input, options = {}) {
 			minDebt: suite.creditFacade.minDebt,
 			maxDebt: suite.creditFacade.maxDebt,
 			underlying: toToken(sdk, suite.market.pool.underlying),
-			allowZero: true,
-			maxBorrowAmount: suite.maxBorrowAmount()
+			allowZero: true
 		}),
-		..."averageQuota" in state ? checkQuotaCount({
-			count: state.averageQuota.filter((q) => q.balance > 0n).length,
-			max: suite.creditManager.maxEnabledTokens
-		}) : checkAccountQuotas(suite, state),
+		...checkAccountQuotas(suite, state),
 		...checkHealthFactors(state, options)
 	];
 }

package/dist/esm/onchain/validation/checks/checkDebtLimits.js

@@ -5,13 +5,12 @@ import "../helpers/index.js";
 //#region src/onchain/validation/checks/checkDebtLimits.ts
 /** A debt the facade would revert on. */
 function checkDebtLimits(args) {
-	const { debt, minDebt, maxDebt, underlying, allowZero, maxBorrowAmount } = args;
+	const { debt, minDebt, maxDebt, underlying, allowZero } = args;
 	if (!(debt > maxDebt || debt < minDebt && !(allowZero && debt === 0n))) return [];
 	return [debtOutOfRange({
 		requested: amountOf(underlying, debt),
 		minDebt: amountOf(underlying, minDebt),
-		maxDebt: amountOf(underlying, maxDebt),
-		maxBorrowAmount
+		maxDebt: amountOf(underlying, maxDebt)
 	})];
 }
 //#endregion

package/dist/esm/sdk/execute/ExecuteApi.js

@@ -73,9 +73,9 @@ async function openTx(sdk, request) {
 async function openRwaOptions(sdk, request) {
 	if (!request.targetToken) return;
 	const requirements = await sdk.accounts.getOpenAccountRequirements(request.wallet, request.creditManager, { tokenOutAddress: request.targetToken });
-	if (requirements?.protocol !== "securitize") return;
+	if (!requirements) return;
 	return {
-		protocol: "securitize",
+		type: requirements.type,
 		tokensToRegister: requirements.tokensToRegister,
 		signaturesToCache: request.signaturesToCache ?? []
 	};

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

@@ -70,21 +70,15 @@ var OpportunitiesNamespace = class extends AbstractNamespace {
 	/**
 	* {@inheritDoc IOpportunitiesBase.getStrategy}
 	**/
-	async getStrategy(key) {
+	async getStrategy(key, wallet) {
 		return this.merged("get strategy opportunity", {
 			chainIds: [key.chainId],
-			fromChain: (source) => source.getStrategy(key),
-			fromBackend: (source) => source.getStrategy(key),
+			fromChain: (source) => source.getStrategy(key, wallet),
+			fromBackend: (source) => source.getStrategy(key, wallet),
 			merge: this.merge.strategy
 		});
 	}
 	/**
-	* {@inheritDoc IOpportunitiesOnchainOnly.isEligibleForStrategy}
-	**/
-	async isEligibleForStrategy(key, wallet) {
-		return this.onchain.isEligibleForStrategy(key, wallet);
-	}
-	/**
 	* {@inheritDoc IOpportunitiesBase.filter}
 	**/
 	filter(response, filter) {

package/dist/types/model/errors/operation-errors.d.ts

@@ -1,8 +1,6 @@
 import { Bps, Token, TokenAmount } from "../primitives.js";
 import { IGearboxError } from "./base.js";
-import { RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAProtocol } from "../rwa.js";
-import { MaxBorrowAmount } from "../../onchain/market/credit/types.js";
-import "../../onchain/index.js";
+import { RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements } from "../rwa.js";
 import { Address } from "viem";
 //#region src/model/errors/operation-errors.d.ts
 /**
@@ -84,8 +82,6 @@ interface DebtOutOfRangeError extends IGearboxError {
   requested: TokenAmount;
   minDebt: TokenAmount;
   maxDebt: TokenAmount;
-  /** What the market will really lend; absent where the raiser only throws. */
-  maxBorrowAmount?: MaxBorrowAmount;
 }
 /** {@inheritDoc DebtOutOfRangeError} */
 declare function debtOutOfRange(args: Omit<DebtOutOfRangeError, "code" | "message">): DebtOutOfRangeError;
@@ -201,19 +197,17 @@ interface InsufficientAllowanceError extends IGearboxError {
 /** {@inheritDoc InsufficientAllowanceError} */
 declare function insufficientAllowance(args: Omit<InsufficientAllowanceError, "code" | "message">): InsufficientAllowanceError;
 /**
- * The RWA protocol still wants something from the borrower before this token
+ * The RWA factory still wants something from the borrower before this token
  * can be opened on.
  **/
 interface RWAOpenRequirementsError extends IGearboxError {
   code: "rwaOpenRequirementsNotMet";
   token: Token;
   creditManager: Address;
-  protocol: RWAProtocol;
-  /** Where the wallet completes registration with {@link protocol}. */
-  registrationLink: string;
+  factory: Address;
   /** Always present on the error. */
   requirements: RWAOpenAccountRequirements;
-  /** Absent when only issuer-side registration is pending (or Midas greenlist). */
+  /** Absent when only issuer-side registration is pending. */
   missing?: RWAMissingOpenAccountRequirements;
 }
 /** {@inheritDoc RWAOpenRequirementsError} */

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

@@ -5,7 +5,7 @@ import { Curator, CuratorName } from "./curators.js";
 import { DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedWithdrawCollateralIntent } from "./delayed-intents.js";
 import { IGearboxError } from "./errors/base.js";
 import { CreditAccountFrozenError, LiquidatorNotEligibleError, NotEmergencyLiquidatorError, creditAccountFrozen, liquidatorNotEligible, notEmergencyLiquidator } from "./errors/liquidation-errors.js";
-import { KYC_REGISTRATION_LINKS, KycProtocol, KycRequirement, MidasOpenAccountRequirements, RWAFactoryType, RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAOperationArgs, RWAProtocol, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RWA_PROTOCOLS, SECURITIZE_REGISTER_VAULT_TYPES, SecuritizeMissingOpenAccountRequirements, SecuritizeOpenAccountRequirements, SecuritizeOperationArgs, SecuritizeRegisterMessage, SecuritizeRegisterVaultMessage, SecuritizeSignature } from "./rwa.js";
+import { KYC_PROTOCOLS, KYC_REGISTRATION_LINKS, KycProtocol, KycRequirement, RWAFactoryType, RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAOperationArgs, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, SECURITIZE_REGISTER_VAULT_TYPES, SecuritizeMissingOpenAccountRequirements, SecuritizeOpenAccountRequirements, SecuritizeOperationArgs, SecuritizeRegisterMessage, SecuritizeRegisterVaultMessage, SecuritizeSignature } from "./rwa.js";
 import { BorrowLimitCause, CreditManagerPausedError, DebtOutOfRangeError, ForbiddenTokenError, InsufficientAllowanceError, InsufficientBalanceError, InsufficientCollateralError, InsufficientPoolLiquidityError, LeverageOutOfRangeError, MarketExpiredError, PoolPausedError, PoolSunsetError, QuotaCountExceededError, QuotaLimitReachedError, RWAOpenRequirementsError, creditManagerPaused, debtOutOfRange, forbiddenToken, insufficientAllowance, insufficientBalance, insufficientCollateral, insufficientPoolLiquidity, leverageOutOfRange, marketExpired, poolPaused, poolSunset, quotaCountExceeded, quotaLimitReached, rwaOpenRequirementsNotMet } from "./errors/operation-errors.js";
 import { UnpriceableTokenError, unpriceableTokenError } from "./errors/oracle-errors.js";
 import { CreditAccountNotEmptyError, CreditAccountNotFoundError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError, creditAccountNotEmpty, creditAccountNotFound, multipleDelayedWithdrawals, noDelayedRoute, noRecordedIntent, noStrategyTargetCollateral, unexpectedFailure, unsupportedCollateralToken, unsupportedTokenPair, withdrawalInProgress } from "./errors/prepare-errors.js";
@@ -30,7 +30,7 @@ import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema
 import { ChainFailed, ChainMetadata, ChainScoped, ChainSucceeded, DataResponse, DataSource, ResponseMetadata } from "./response.js";
 import { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourceSchema, responseMetadataSchema, responseSchema } from "./response.schema.js";
 import { SDKError, SDKResult, SDKReturn, SafeValue, safeValue, sdkErr, sdkOk } from "./result.js";
-import { kycRequirementSchema, rwaProtocolSchema } from "./rwa.schema.js";
+import { kycProtocolSchema, kycRequirementSchema } from "./rwa.schema.js";
 import { PositionClaimableWithdrawal, PositionPendingWithdrawal, PositionWithdrawals, WithdrawalOutputAmount } from "./withdrawals.js";
 import { positionClaimableWithdrawalSchema, positionPendingWithdrawalSchema, positionWithdrawalsSchema, withdrawalOutputAmountSchema } from "./withdrawals.schema.js";
-export { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, AccountHoldings, AccountMetrics, AccountProjection, AccountStateChange, AdjustStrategyPositionPreview, Amount, AnalyticsChartQuery, AnalyticsLiquidationPosition, AnalyticsPoolPosition, AnalyticsPosition, AnalyticsPositionListOptions, AnalyticsPositionOwner, AnalyticsPositionPage, AnalyticsPositionSortField, AnalyticsSortDirection, AnalyticsStrategyPosition, ApyBreakdown, Asset, AssetType, BorrowLimitCause, BorrowRateBreakdown, Bps, CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ChainFailed, ChainId, ChainMetadata, ChainScoped, ChainScopedFilter, ChainSucceeded, ChartBundle, ChartDenomination, ChartMetric, ChartQuery, ChartRange, ChartSeries, ChartSeriesOk, ChartSeriesUnavailable, ChartUnavailableCode, ChartUnit, ChartValue, ChartWindow, CompareTag, CompareTolerance, CreditAccountFrozenError, CreditAccountNotEmptyError, CreditAccountNotFoundError, CreditManagerPausedError, CreditOperationMarket, Curator, CuratorName, DataResponse, DataSource, DebtOutOfRangeError, DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedReceivedAsset, DelayedStrategyPositionOperationPreview, DelayedWithdrawCollateralIntent, Estimated, EstimatedProjection, ExitStrategyPositionPreview, FILTER_ALL, FilterAll, Filterable, ForbiddenTokenError, GridSampling, IGearboxError, InstantReceivedAsset, InstantStrategyPositionOperationPreview, InsufficientAllowanceError, InsufficientBalanceError, InsufficientCollateralError, InsufficientPoolLiquidityError, InvalidDelayedIntentError, KYC_REGISTRATION_LINKS, KycProtocol, KycRequirement, Leverage, LeverageOutOfRangeError, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, LiquidatorNotEligibleError, MalformedTransactionError, MarketExpiredError, MidasOpenAccountRequirements, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, NotEmergencyLiquidatorError, Notice, NoticeKind, NoticeSubject, OpenNonRWAStrategyPositionPreview, OpenRWAStrategyPositionPreview, OpenStrategyPositionPreview, OperationPreview, Opportunity, OpportunityBase, OpportunityChartMetric, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, OpportunityTotals, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PROTOCOL_CHART_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsRewardsPnL, PoolOperationPreviewError, PoolOperationType, PoolOpportunity, PoolOpportunityChartMetric, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPausedError, PoolPosition, PoolPositionChartMetric, PoolPositionKey, PoolPositionOperationPreview, PoolPositionRef, PoolSunsetError, Position, PositionChartMetric, PositionClaimableWithdrawal, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, PositionPendingWithdrawal, PositionTransaction, PositionTransactionKind, PositionWithdrawals, PositionsTotals, PreviewOperationInput, PreviewOperationOptions, PriceFeedData, PriceFeedSummary, ProtocolChartMetric, QuotaAsset, QuotaCountExceededError, QuotaLimitReachedError, RWAFactoryType, RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAOpenRequirementsError, RWAOperationArgs, RWAProtocol, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RWA_PROTOCOLS, RateCurve, RateCurvePoint, ReceivedAsset, RepayStrategyPositionPreview, ResponseMetadata, Rewards, RewardsPnL, RoutedField, SDKError, SDKResult, SDKReturn, SECURITIZE_REGISTER_VAULT_TYPES, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, STRATEGY_POSITION_COLLATERAL_ERROR, SafeValue, SecuritizeMissingOpenAccountRequirements, SecuritizeOpenAccountRequirements, SecuritizeOperationArgs, SecuritizeRegisterMessage, SecuritizeRegisterVaultMessage, SecuritizeSignature, StrategyOpportunity, StrategyOpportunityChartMetric, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, StrategyPositionChartMetric, StrategyPositionKey, StrategyPositionRef, Timestamp, Token, TokenAmount, TokenQuotaRate, TokenRewards, TokenRewardsPnL, ToleranceCompareTag, TxCall, UnderlyingToken, UnexpectedFailureError, UnpriceableTokenError, UnsupportedCollateralTokenError, UnsupportedOperationError, UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedTokenPairError, UnsupportedZapperFunctionError, WithdrawalInProgressError, WithdrawalOutputAmount, amountSchema, analyticsChartQueryOptionsSchema, analyticsChartQueryParamsSchema, analyticsChartQuerySchema, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema, apyBreakdownSchema, asEstimated, assetTypeSchema, backendPreferred, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, creditAccountFrozen, creditAccountNotEmpty, creditAccountNotFound, creditManagerPaused, curatorNameSchema, curatorSchema, dataSourceSchema, debtOutOfRange, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, forbiddenToken, instantReceivedAssetSchema, insufficientAllowance, insufficientBalance, insufficientCollateral, insufficientPoolLiquidity, isFilterSet, kycRequirementSchema, leverageOutOfRange, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, liquidatorNotEligible, malformedTransaction, marketExpired, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, multipleDelayedWithdrawals, noDelayedRoute, noRecordedIntent, noStrategyTargetCollateral, notEmergencyLiquidator, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPaused, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, poolSunset, positionClaimableWithdrawalSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionPendingWithdrawalSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionWithdrawalsSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, protocolChartMetricSchema, quotaAssetSchema, quotaCountExceeded, quotaLimitReached, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, rwaOpenRequirementsNotMet, rwaProtocolSchema, safeValue, sdkErr, sdkOk, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema, underlyingTokenSchema, unexpectedFailure, unpriceableTokenError, unsupportedCollateralToken, unsupportedTokenPair, withdrawalInProgress, withdrawalOutputAmountSchema };
+export { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, AccountHoldings, AccountMetrics, AccountProjection, AccountStateChange, AdjustStrategyPositionPreview, Amount, AnalyticsChartQuery, AnalyticsLiquidationPosition, AnalyticsPoolPosition, AnalyticsPosition, AnalyticsPositionListOptions, AnalyticsPositionOwner, AnalyticsPositionPage, AnalyticsPositionSortField, AnalyticsSortDirection, AnalyticsStrategyPosition, ApyBreakdown, Asset, AssetType, BorrowLimitCause, BorrowRateBreakdown, Bps, CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ChainFailed, ChainId, ChainMetadata, ChainScoped, ChainScopedFilter, ChainSucceeded, ChartBundle, ChartDenomination, ChartMetric, ChartQuery, ChartRange, ChartSeries, ChartSeriesOk, ChartSeriesUnavailable, ChartUnavailableCode, ChartUnit, ChartValue, ChartWindow, CompareTag, CompareTolerance, CreditAccountFrozenError, CreditAccountNotEmptyError, CreditAccountNotFoundError, CreditManagerPausedError, CreditOperationMarket, Curator, CuratorName, DataResponse, DataSource, DebtOutOfRangeError, DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedReceivedAsset, DelayedStrategyPositionOperationPreview, DelayedWithdrawCollateralIntent, Estimated, EstimatedProjection, ExitStrategyPositionPreview, FILTER_ALL, FilterAll, Filterable, ForbiddenTokenError, GridSampling, IGearboxError, InstantReceivedAsset, InstantStrategyPositionOperationPreview, InsufficientAllowanceError, InsufficientBalanceError, InsufficientCollateralError, InsufficientPoolLiquidityError, InvalidDelayedIntentError, KYC_PROTOCOLS, KYC_REGISTRATION_LINKS, KycProtocol, KycRequirement, Leverage, LeverageOutOfRangeError, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, LiquidatorNotEligibleError, MalformedTransactionError, MarketExpiredError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, NotEmergencyLiquidatorError, Notice, NoticeKind, NoticeSubject, OpenNonRWAStrategyPositionPreview, OpenRWAStrategyPositionPreview, OpenStrategyPositionPreview, OperationPreview, Opportunity, OpportunityBase, OpportunityChartMetric, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, OpportunityTotals, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PROTOCOL_CHART_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsRewardsPnL, PoolOperationPreviewError, PoolOperationType, PoolOpportunity, PoolOpportunityChartMetric, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPausedError, PoolPosition, PoolPositionChartMetric, PoolPositionKey, PoolPositionOperationPreview, PoolPositionRef, PoolSunsetError, Position, PositionChartMetric, PositionClaimableWithdrawal, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, PositionPendingWithdrawal, PositionTransaction, PositionTransactionKind, PositionWithdrawals, PositionsTotals, PreviewOperationInput, PreviewOperationOptions, PriceFeedData, PriceFeedSummary, ProtocolChartMetric, QuotaAsset, QuotaCountExceededError, QuotaLimitReachedError, RWAFactoryType, RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements, RWAOpenRequirementsError, RWAOperationArgs, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RateCurve, RateCurvePoint, ReceivedAsset, RepayStrategyPositionPreview, ResponseMetadata, Rewards, RewardsPnL, RoutedField, SDKError, SDKResult, SDKReturn, SECURITIZE_REGISTER_VAULT_TYPES, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, STRATEGY_POSITION_COLLATERAL_ERROR, SafeValue, SecuritizeMissingOpenAccountRequirements, SecuritizeOpenAccountRequirements, SecuritizeOperationArgs, SecuritizeRegisterMessage, SecuritizeRegisterVaultMessage, SecuritizeSignature, StrategyOpportunity, StrategyOpportunityChartMetric, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, StrategyPositionChartMetric, StrategyPositionKey, StrategyPositionRef, Timestamp, Token, TokenAmount, TokenQuotaRate, TokenRewards, TokenRewardsPnL, ToleranceCompareTag, TxCall, UnderlyingToken, UnexpectedFailureError, UnpriceableTokenError, UnsupportedCollateralTokenError, UnsupportedOperationError, UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedTokenPairError, UnsupportedZapperFunctionError, WithdrawalInProgressError, WithdrawalOutputAmount, amountSchema, analyticsChartQueryOptionsSchema, analyticsChartQueryParamsSchema, analyticsChartQuerySchema, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema, apyBreakdownSchema, asEstimated, assetTypeSchema, backendPreferred, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, creditAccountFrozen, creditAccountNotEmpty, creditAccountNotFound, creditManagerPaused, curatorNameSchema, curatorSchema, dataSourceSchema, debtOutOfRange, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, forbiddenToken, instantReceivedAssetSchema, insufficientAllowance, insufficientBalance, insufficientCollateral, insufficientPoolLiquidity, isFilterSet, kycProtocolSchema, kycRequirementSchema, leverageOutOfRange, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, liquidatorNotEligible, malformedTransaction, marketExpired, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, multipleDelayedWithdrawals, noDelayedRoute, noRecordedIntent, noStrategyTargetCollateral, notEmergencyLiquidator, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPaused, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, poolSunset, positionClaimableWithdrawalSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionPendingWithdrawalSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionWithdrawalsSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, protocolChartMetricSchema, quotaAssetSchema, quotaCountExceeded, quotaLimitReached, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, rwaOpenRequirementsNotMet, safeValue, sdkErr, sdkOk, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema, underlyingTokenSchema, unexpectedFailure, unpriceableTokenError, unsupportedCollateralToken, unsupportedTokenPair, withdrawalInProgress, withdrawalOutputAmountSchema };

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

@@ -591,10 +591,11 @@ interface StrategyOpportunityDetail extends StrategyOpportunity {
    **/
   priceFeeds: PriceFeedSummary;
   /**
-   * KYC gate of this strategy, independent of any wallet. `null` when the
-   * strategy is not KYC-gated. `undefined` only in `offchain` mode, until the
-   * backend serves it. In `both` mode `kyc` is taken from the chain whenever
-   * that leg succeeded.
+   * Registration the wallet passed to `getStrategy` still needs before it may
+   * open this strategy. `null` when the strategy is not KYC-gated, when no
+   * wallet was given, or when the wallet is already eligible. `undefined`
+   * only in `offchain` mode, where the backend does not evaluate it. In
+   * `both` mode `kyc` is taken from the chain whenever that leg succeeded.
    **/
   kyc?: KycRequirement | null;
 }