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

package/dist/esm/onchain/market/pricefeeds/index.js

@@ -1,26 +1,32 @@
-import { isUpdatablePriceFeed } from "./isUpdatablePriceFeed.js";
 import { PriceFeedRef } from "./PriceFeedRef.js";
 import { AbstractPriceFeedContract, PartialPriceFeedInitError } from "./AbstractPriceFeed.js";
 import { AbstractLPPriceFeedContract, isLPPriceFeed } from "./AbstractLPPriceFeed.js";
-import { BalancerStablePriceFeedContract } from "./BalancerStablePriceFeed.js";
-import { BalancerWeightedPriceFeedContract } from "./BalancerWeightedPriceFeed.js";
-import { BoundedPriceFeedContract } from "./BoundedPriceFeed.js";
-import { CompositePriceFeedContract } from "./CompositePriceFeed.js";
-import { CurveCryptoPriceFeedContract } from "./CurveCryptoPriceFeed.js";
-import { CurveStablePriceFeedContract } from "./CurveStablePriceFeed.js";
-import { CurveUSDPriceFeedContract } from "./CurveUSDPriceFeed.js";
-import { Erc4626PriceFeedContract } from "./Erc4626PriceFeed.js";
-import { ExternalPriceFeedContract } from "./ExternalPriceFeed.js";
-import { getRawPriceUpdates } from "./getRawPriceUpdates.js";
-import { MellowLRTPriceFeedContract } from "./MellowLRTPriceFeed.js";
-import { PendleTWAPPTPriceFeed } from "./PendleTWAPPTPriceFeed.js";
-import { PythPriceFeed } from "./PythPriceFeed.js";
-import { RedstonePriceFeedContract } from "./RedstonePriceFeed.js";
+import { BalancerStablePriceFeedContract } from "./feeds/BalancerStablePriceFeed.js";
+import { BalancerWeightedPriceFeedContract } from "./feeds/BalancerWeightedPriceFeed.js";
+import { BoundedPriceFeedContract } from "./feeds/BoundedPriceFeed.js";
+import { CompositePriceFeedContract } from "./feeds/CompositePriceFeed.js";
+import { ConstantPriceFeedContract } from "./feeds/ConstantPriceFeed.js";
+import { CurveCryptoPriceFeedContract } from "./feeds/CurveCryptoPriceFeed.js";
+import { CurveStablePriceFeedContract } from "./feeds/CurveStablePriceFeed.js";
+import { CurveUSDPriceFeedContract } from "./feeds/CurveUSDPriceFeed.js";
+import { Erc4626PriceFeedContract } from "./feeds/Erc4626PriceFeed.js";
+import { ExternalPriceFeedContract } from "./feeds/ExternalPriceFeed.js";
+import { MellowLRTPriceFeedContract } from "./feeds/MellowLRTPriceFeed.js";
+import { PendleTWAPPTPriceFeed } from "./feeds/PendleTWAPPTPriceFeed.js";
+import { PythPriceFeed } from "./feeds/PythPriceFeed.js";
+import { RedstonePriceFeedContract } from "./feeds/RedstonePriceFeed.js";
+import { WstETHPriceFeedContract } from "./feeds/WstETHPriceFeed.js";
+import { YearnPriceFeedContract } from "./feeds/YearnPriceFeed.js";
+import { ZeroPriceFeedContract } from "./feeds/ZeroPriceFeed.js";
+import "./feeds/index.js";
+import { PriceFeedRegistry } from "./PriceFeedRegistry.js";
+import "./types.js";
 import { fetchRedstonePayloads } from "./updates/fetchRedstonePayloads.js";
+import { getRawPriceUpdates } from "./updates/getRawPriceUpdates.js";
+import { isUpdatablePriceFeed } from "./updates/isUpdatablePriceFeed.js";
+import { PriceUpdatesCache } from "./updates/PriceUpdatesCache.js";
+import { RedstoneOptions, RedstoneUpdater } from "./updates/RedstoneUpdater.js";
+import { updatableDependencies } from "./updates/updatableDependencies.js";
+import { UpdatablePriceFeedRegistry } from "./updates/UpdatablePriceFeedRegistry.js";
 import "./updates/index.js";
-import { WstETHPriceFeedContract } from "./WstETHPriceFeed.js";
-import { YearnPriceFeedContract } from "./YearnPriceFeed.js";
-import { ZeroPriceFeedContract } from "./ZeroPriceFeed.js";
-import { PriceFeedRegister } from "./PriceFeedsRegister.js";
-import "./types.js";
-export { AbstractLPPriceFeedContract, AbstractPriceFeedContract, BalancerStablePriceFeedContract, BalancerWeightedPriceFeedContract, BoundedPriceFeedContract, CompositePriceFeedContract, CurveCryptoPriceFeedContract, CurveStablePriceFeedContract, CurveUSDPriceFeedContract, Erc4626PriceFeedContract, ExternalPriceFeedContract, MellowLRTPriceFeedContract, PartialPriceFeedInitError, PendleTWAPPTPriceFeed, PriceFeedRef, PriceFeedRegister, PythPriceFeed, RedstonePriceFeedContract, WstETHPriceFeedContract, YearnPriceFeedContract, ZeroPriceFeedContract, fetchRedstonePayloads, getRawPriceUpdates, isLPPriceFeed, isUpdatablePriceFeed };
+export { AbstractLPPriceFeedContract, AbstractPriceFeedContract, BalancerStablePriceFeedContract, BalancerWeightedPriceFeedContract, BoundedPriceFeedContract, CompositePriceFeedContract, ConstantPriceFeedContract, CurveCryptoPriceFeedContract, CurveStablePriceFeedContract, CurveUSDPriceFeedContract, Erc4626PriceFeedContract, ExternalPriceFeedContract, MellowLRTPriceFeedContract, PartialPriceFeedInitError, PendleTWAPPTPriceFeed, PriceFeedRef, PriceFeedRegistry, PriceUpdatesCache, PythPriceFeed, RedstoneOptions, RedstonePriceFeedContract, RedstoneUpdater, UpdatablePriceFeedRegistry, WstETHPriceFeedContract, YearnPriceFeedContract, ZeroPriceFeedContract, fetchRedstonePayloads, getRawPriceUpdates, isLPPriceFeed, isUpdatablePriceFeed, updatableDependencies };

package/dist/esm/onchain/market/pricefeeds/updates/UpdatablePriceFeedRegistry.js

@@ -0,0 +1,188 @@
+import { createRawTx } from "../../../utils/createRawTx.js";
+import { AP_PRICE_FEED_COMPRESSOR, AP_PRICE_FEED_STORE } from "../../../constants/address-provider.js";
+import { ADDRESS_0X0 } from "../../../constants/addresses.js";
+import { VERSION_RANGE_310 } from "../../../constants/versions.js";
+import "../../../constants/index.js";
+import "../../../utils/index.js";
+import { priceFeedCompressorAbi } from "../../../../abi/compressors/priceFeedCompressor.js";
+import { PriceFeedRegistry } from "../PriceFeedRegistry.js";
+import { getRawPriceUpdates } from "./getRawPriceUpdates.js";
+import { isUpdatablePriceFeed } from "./isUpdatablePriceFeed.js";
+import { RedstoneUpdater } from "./RedstoneUpdater.js";
+import { Hooks } from "../../../utils/internal/Hooks.js";
+import "../../../utils/internal/index.js";
+import { updatableDependencies } from "./updatableDependencies.js";
+import { parseAbi } from "viem";
+//#region src/onchain/market/pricefeeds/updates/UpdatablePriceFeedRegistry.ts
+/**
+* {@link PriceFeedRegistry} that also orchestrates off-chain price updates
+* (Redstone, etc.).
+**/
+var UpdatablePriceFeedRegistry = class extends PriceFeedRegistry {
+	#hooks = new Hooks();
+	#updaters;
+	#latestUpdate;
+	constructor(sdk, opts = {}) {
+		super(sdk);
+		this.#updaters = [new RedstoneUpdater(sdk, opts.redstone)];
+	}
+	/**
+	* @internal
+	* Registers a callback for price-feed registry lifecycle events.
+	* @param event - Event name.
+	* @param handler - Callback to invoke.
+	**/
+	addHook = this.#hooks.addHook.bind(this.#hooks);
+	/**
+	* @internal
+	* Removes a previously registered hook.
+	* @param event - Event name.
+	* @param handler - Callback to remove.
+	**/
+	removeHook = this.#hooks.removeHook.bind(this.#hooks);
+	/**
+	* Generates transactions to push fresh off-chain prices to updatable feeds.
+	*
+	* @param priceFeeds - Top-level price feeds whose updatable dependencies
+	*   will be resolved, or a filter (`{ main: true }` / `{ reserve: true }`)
+	*   to gather feeds from all oracles. When omitted, all registered feeds
+	*   are used.
+	**/
+	async generatePriceFeedsUpdateTxs(priceFeeds) {
+		let updateables = this.feeds;
+		let filterRemark = "";
+		if (priceFeeds) {
+			if (Array.isArray(priceFeeds)) updateables = priceFeeds.flatMap((pf) => updatableDependencies(pf));
+			else if ("main" in priceFeeds && priceFeeds.main) {
+				filterRemark = " main";
+				updateables = this.sdk.marketRegister.priceOracles.flatMap((o) => o.mainPriceFeeds.values()).flatMap((pf) => updatableDependencies(pf.priceFeed));
+			} else if ("reserve" in priceFeeds && priceFeeds.reserve) {
+				filterRemark = " reserve";
+				updateables = this.sdk.marketRegister.priceOracles.flatMap((o) => o.reservePriceFeeds.values()).flatMap((pf) => updatableDependencies(pf.priceFeed));
+			}
+		}
+		return this.#generateUpdateTxs(updateables, filterRemark);
+	}
+	/**
+	* Similar to {@link generatePriceFeedsUpdateTxs}, but returns raw structures instead of transactions
+	* @param priceFeeds
+	* @returns
+	*/
+	async generatePriceFeedsUpdates(priceFeeds) {
+		const updates = await this.generatePriceFeedsUpdateTxs(priceFeeds);
+		return getRawPriceUpdates(updates);
+	}
+	/**
+	* Similar to {@link generatePriceFeedsUpdates}, but returns raw transaction to PriceFeedStore.updatePrices
+	* @param priceFeeds
+	* @returns
+	*/
+	async getPriceFeedStoreUpdateTx(priceFeeds) {
+		const pfs = this.sdk.addressProvider.getAddress(AP_PRICE_FEED_STORE);
+		const updates = await this.generatePriceFeedsUpdates(priceFeeds);
+		return createRawTx(pfs, {
+			abi: parseAbi(["function updatePrices((address,bytes)[])"]),
+			functionName: "updatePrices",
+			args: [updates.map((u) => [u.priceFeed, u.data])]
+		});
+	}
+	/**
+	* Similar to {@link generatePriceFeedsUpdateTxs}, but will generate necessary price update transactions for external price feeds (not known to sdk)
+	* This does not add feeds to this registry, so they won't be implicitly included in future generatePriceFeedsUpdateTxs calls
+	* @param feeds
+	* @param block
+	* @returns
+	*/
+	async generateExternalPriceFeedsUpdateTxs(feeds, block) {
+		const [priceFeedCompressorAddress] = this.sdk.addressProvider.mustGetLatest(AP_PRICE_FEED_COMPRESSOR, VERSION_RANGE_310);
+		const blockParam = block ?? { blockNumber: this.sdk.currentBlock };
+		const leaves = (await this.client.readContract({
+			address: priceFeedCompressorAddress,
+			abi: priceFeedCompressorAbi,
+			functionName: "loadPriceFeedTree",
+			args: [feeds],
+			...blockParam,
+			gas: this.sdk.gasLimit
+		})).map((node) => this.get(node.baseParams.addr) ?? this.create(node)).filter(isUpdatablePriceFeed);
+		return this.#generateUpdateTxs(leaves, "");
+	}
+	/**
+	* Similar to {@link generateExternalPriceFeedsUpdateTxs}, but returns raw structures instead of transactions
+	* @param feeds
+	* @param block
+	* @returns
+	*/
+	async generateExternalPriceFeedsUpdates(feeds, block) {
+		const updates = await this.generateExternalPriceFeedsUpdateTxs(feeds, block);
+		return getRawPriceUpdates(updates);
+	}
+	/**
+	* Loads PARTIAL information about all updatable price feeds from MarketCompressor
+	* Discovered price feeds are not saved anywhere in PriceFeedRegistry, and can later be used to load price feed updates
+	*/
+	async getPartialUpdatablePriceFeeds(configurators) {
+		const [priceFeedCompressorAddress] = this.sdk.addressProvider.mustGetLatest(AP_PRICE_FEED_COMPRESSOR, VERSION_RANGE_310);
+		this.logger?.debug({ configurators }, `calling getUpdatablePriceFeeds in block ${this.sdk.currentBlock}`);
+		const result = await this.client.readContract({
+			address: priceFeedCompressorAddress,
+			abi: priceFeedCompressorAbi,
+			functionName: "getUpdatablePriceFeeds",
+			args: [{
+				configurators,
+				pools: [],
+				underlying: ADDRESS_0X0
+			}],
+			blockNumber: this.sdk.currentBlock,
+			gas: this.sdk.gasLimit
+		});
+		this.logger?.debug(`loaded ${result.length} partial updatable price feeds in block ${this.sdk.currentBlock}`);
+		return result.map((baseParams) => this.create({ baseParams }));
+	}
+	/**
+	* @internal
+	* Diagnostic snapshot of the most recent price-update round, or
+	* `undefined` if no updates have been generated yet.
+	**/
+	get latestUpdate() {
+		return this.#latestUpdate;
+	}
+	/**
+	* @internal
+	* Returns true if any of the updaters are in historical mode
+	*/
+	get historical() {
+		return this.#updaters.some((u) => u.historical);
+	}
+	async #generateUpdateTxs(updateables, filterRemark) {
+		if (updateables.length === 0) return {
+			txs: [],
+			timestamp: 0
+		};
+		const txs = [];
+		const latestUpdate = {
+			updates: [],
+			timestamp: Math.floor(Date.now() / 1e3)
+		};
+		const updates = (await Promise.all(this.#updaters.map((u) => u.getUpdateTxs([...updateables]).catch(() => [])))).flat();
+		let maxTimestamp = 0;
+		for (const tx of updates) {
+			const { data } = tx;
+			const { timestamp } = data;
+			if (timestamp > maxTimestamp) maxTimestamp = timestamp;
+			txs.push(tx);
+			latestUpdate.updates.push(data);
+		}
+		txs.sort((a, b) => a.raw.to.toLowerCase().localeCompare(b.raw.to.toLowerCase()));
+		const result = {
+			txs,
+			timestamp: maxTimestamp
+		};
+		const tsDelta = BigInt(maxTimestamp) - this.sdk.timestamp;
+		this.logger?.debug(`generated ${txs.length}${filterRemark} price feed update transactions, timestamp: ${maxTimestamp} (delta ${tsDelta})`);
+		if (txs.length) await this.#hooks.triggerHooks("updatesGenerated", result);
+		this.#latestUpdate = latestUpdate;
+		return result;
+	}
+};
+//#endregion
+export { UpdatablePriceFeedRegistry };

package/dist/esm/onchain/market/pricefeeds/{getRawPriceUpdates.js → updates/getRawPriceUpdates.js}

@@ -1,6 +1,6 @@
-import { iUpdatablePriceFeedAbi } from "../../../abi/iUpdatablePriceFeed.js";
+import { iUpdatablePriceFeedAbi } from "../../../../abi/iUpdatablePriceFeed.js";
 import { decodeFunctionData } from "viem";
-//#region src/onchain/market/pricefeeds/getRawPriceUpdates.ts
+//#region src/onchain/market/pricefeeds/updates/getRawPriceUpdates.ts
 function getRawPriceUpdates(updates) {
 	return updates.txs.map((tx) => {
 		const data = decodeFunctionData({

package/dist/esm/onchain/market/pricefeeds/updates/index.js

@@ -1,4 +1,8 @@
 import { fetchRedstonePayloads } from "./fetchRedstonePayloads.js";
+import { getRawPriceUpdates } from "./getRawPriceUpdates.js";
+import { isUpdatablePriceFeed } from "./isUpdatablePriceFeed.js";
 import { PriceUpdatesCache } from "./PriceUpdatesCache.js";
 import { RedstoneOptions, RedstoneUpdater } from "./RedstoneUpdater.js";
-export { PriceUpdatesCache, RedstoneOptions, RedstoneUpdater, fetchRedstonePayloads };
+import { updatableDependencies } from "./updatableDependencies.js";
+import { UpdatablePriceFeedRegistry } from "./UpdatablePriceFeedRegistry.js";
+export { PriceUpdatesCache, RedstoneOptions, RedstoneUpdater, UpdatablePriceFeedRegistry, fetchRedstonePayloads, getRawPriceUpdates, isUpdatablePriceFeed, updatableDependencies };

package/dist/esm/onchain/market/pricefeeds/{isUpdatablePriceFeed.js → updates/isUpdatablePriceFeed.js}

@@ -1,4 +1,4 @@
-//#region src/onchain/market/pricefeeds/isUpdatablePriceFeed.ts
+//#region src/onchain/market/pricefeeds/updates/isUpdatablePriceFeed.ts
 function isUpdatablePriceFeed(pf) {
 	return pf.updatable;
 }

package/dist/esm/onchain/market/pricefeeds/updates/updatableDependencies.js

@@ -0,0 +1,13 @@
+import { isUpdatablePriceFeed } from "./isUpdatablePriceFeed.js";
+//#region src/onchain/market/pricefeeds/updates/updatableDependencies.ts
+/**
+* Collects updatable feeds in this feed's dependency tree, including this
+* feed itself when it is updatable.
+**/
+function updatableDependencies(feed) {
+	if (!feed.loaded) return [feed];
+	const underlying = feed.underlyingPriceFeeds.flatMap((ref) => updatableDependencies(ref.priceFeed));
+	return isUpdatablePriceFeed(feed) ? [feed, ...underlying] : underlying;
+}
+//#endregion
+export { updatableDependencies };

package/dist/esm/onchain/market/rwa/RWARegistry.js

@@ -1,8 +1,5 @@
 import { AddressMap } from "../../utils/AddressMap.js";
 import { bytes32ToString } from "../../utils/bytes32ToString.js";
-import { AP_RWA_COMPRESSOR } from "../../constants/address-provider.js";
-import { VERSION_RANGE_310 } from "../../constants/versions.js";
-import "../../constants/index.js";
 import "../../utils/index.js";
 import { SDKConstruct } from "../../base/SDKConstruct.js";
 import { RWA_ON_DEMAND_LP_MONOPOLIZED, RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND } from "../../base/token-types.js";
@@ -14,6 +11,7 @@ import { SecuritizeRWAFactory } from "./securitize/SecuritizeRWAFactory.js";
 import "./securitize/index.js";
 import { decodeAbiParameters } from "viem";
 //#region src/onchain/market/rwa/RWARegistry.ts
+const RWA_COMPRESSOR_ADDRESS = "0x9Bff226505632930BA1897E7943e90A2f7D0D9f7";
 /**
 * Registry of RWA underlying tokens and RWA factory contracts.
 *
@@ -41,11 +39,10 @@ var RWARegistry = class extends SDKConstruct {
 	getLoadMulticalls(configurators, rwaFactories = []) {
 		this.#requestedFactories = rwaFactories;
 		if (!rwaFactories.length) return [];
-		const [rwaCompressorAddress] = this.sdk.addressProvider.mustGetLatest(AP_RWA_COMPRESSOR, VERSION_RANGE_310);
 		return [{
 			call: {
 				abi: iRWACompressorAbi,
-				address: rwaCompressorAddress,
+				address: RWA_COMPRESSOR_ADDRESS,
 				functionName: "getRWAMarketsData",
 				args: [configurators, rwaFactories]
 			},
@@ -83,10 +80,9 @@ var RWARegistry = class extends SDKConstruct {
 		let factories = this.#factories.values();
 		if (factories_?.length) factories = factories_.map((f) => this.#factories.mustGet(f));
 		if (!factories.length) return [];
-		const [rwaCompressorAddress] = this.sdk.addressProvider.mustGetLatest(AP_RWA_COMPRESSOR, VERSION_RANGE_310);
 		const resp = await this.client.readContract({
 			abi: iRWACompressorAbi,
-			address: rwaCompressorAddress,
+			address: RWA_COMPRESSOR_ADDRESS,
 			functionName: "getRWAInvestorData",
 			args: [investor, factories.map((f) => f.address)],
 			blockNumber
@@ -284,4 +280,4 @@ var RWARegistry = class extends SDKConstruct {
 	}
 };
 //#endregion
-export { RWARegistry };
+export { RWARegistry, RWA_COMPRESSOR_ADDRESS };

package/dist/esm/onchain/market/rwa/index.js

@@ -7,6 +7,6 @@ import { SecuritizeDegenNFT } from "./securitize/SecuritizeDegenNFT.js";
 import { SecuritizeLiquidatorContract } from "./securitize/SecuritizeLiquidatorContract.js";
 import { SecuritizeRWAFactory } from "./securitize/SecuritizeRWAFactory.js";
 import "./securitize/index.js";
-import { RWARegistry } from "./RWARegistry.js";
+import { RWARegistry, RWA_COMPRESSOR_ADDRESS } from "./RWARegistry.js";
 import { isRWAFactory } from "./types.js";
-export { DEGEN_NFT_MIDAS, DEGEN_NFT_SECURITIZE, MidasDegenNFT, MidasLiquidatorContract, PHANTOM_TOKEN_MIDAS_REDEMPTION, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, RWARegistry, RWA_LIQUIDATOR_MIDAS, RWA_LIQUIDATOR_SECURITIZE, SecuritizeDegenNFT, SecuritizeLiquidatorContract, SecuritizeRWAFactory, isRWAFactory };
+export { DEGEN_NFT_MIDAS, DEGEN_NFT_SECURITIZE, MidasDegenNFT, MidasLiquidatorContract, PHANTOM_TOKEN_MIDAS_REDEMPTION, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, RWARegistry, RWA_COMPRESSOR_ADDRESS, RWA_LIQUIDATOR_MIDAS, RWA_LIQUIDATOR_SECURITIZE, SecuritizeDegenNFT, SecuritizeLiquidatorContract, SecuritizeRWAFactory, isRWAFactory };

package/dist/esm/onchain/market/rwa/midas/MidasDegenNFT.js

@@ -5,14 +5,23 @@ import "../../adapters/abi/index.js";
 import { iMidasDegenNFTAbi } from "../../../../abi/rwa/iMidasDegenNFT.js";
 import "./constants.js";
 import { iMidasAccessControlAbi } from "../../../../abi/rwa/iMidasAccessControl.js";
+import { KYC_REGISTRATION_LINKS } from "../../../../model/rwa.js";
+import "../../../../model/index.js";
 import { decodeAbiParameters } from "viem";
 //#region src/onchain/market/rwa/midas/MidasDegenNFT.ts
 const abi = iMidasDegenNFTAbi;
+/**
+* Midas is an RWA protocol without a factory: accounts open through the plain
+* facade. Only a Permissioned-mode gateway deploys a degen NFT, so a Midas
+* strategy that does not require KYC has no NFT at all.
+*/
 var MidasDegenNFT = class extends BaseContract {
 	protocol = "midas";
+	registrationLink = KYC_REGISTRATION_LINKS.midas;
 	gateway;
 	accessControl;
 	greenlistedRole;
+	#mToken;
 	constructor(sdk, baseParams) {
 		super(sdk, {
 			...baseParams,
@@ -30,9 +39,26 @@ var MidasDegenNFT = class extends BaseContract {
 		this.accessControl = accessControl;
 		this.greenlistedRole = greenlistedRole;
 	}
-	/** Same predicate `MidasDegenNFT.burn` reverts on; the mToken rides along in the batch. */
-	async checkKyc(wallet, _targetCollateral) {
-		const [eligible, token] = await this.client.multicall({
+	async getTokens() {
+		return [await this.#mTokenAddress()];
+	}
+	/**
+	* Same predicate `MidasDegenNFT.burn` reverts on; the mToken rides along in
+	* the batch until it is cached.
+	*/
+	async getOpenAccountRequirements(wallet, _props) {
+		const token = this.#mToken;
+		if (token !== void 0) return {
+			protocol: "midas",
+			token,
+			greenlisted: await this.client.readContract({
+				abi: iMidasAccessControlAbi,
+				address: this.accessControl,
+				functionName: "hasRole",
+				args: [this.greenlistedRole, wallet]
+			})
+		};
+		const [greenlisted, mToken] = await this.client.multicall({
 			allowFailure: false,
 			contracts: [{
 				abi: iMidasAccessControlAbi,
@@ -45,11 +71,25 @@ var MidasDegenNFT = class extends BaseContract {
 				functionName: "mToken"
 			}]
 		});
+		this.#mToken = mToken;
 		return {
-			eligible,
-			token
+			protocol: "midas",
+			token: mToken,
+			greenlisted
 		};
 	}
+	isRegistered(requirements) {
+		return requirements.greenlisted;
+	}
+	getMissingRequirements() {}
+	async #mTokenAddress() {
+		if (this.#mToken === void 0) this.#mToken = await this.client.readContract({
+			abi: iMidasGatewayV311Abi,
+			address: this.gateway,
+			functionName: "mToken"
+		});
+		return this.#mToken;
+	}
 };
 //#endregion
 export { MidasDegenNFT };

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

@@ -1,13 +1,23 @@
+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,
@@ -16,19 +26,54 @@ var SecuritizeDegenNFT = class extends BaseContract {
 			name: "SecuritizeDegenNFT",
 			abi
 		});
+		this.#sdk = sdk;
 		this.factory = factory;
 	}
-	/** 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
+	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
 		};
-		const req = await factory.getOpenAccountRequirements(wallet, { tokenOutAddress: 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;
 		return {
-			eligible: !req || req.securitizeTokensToRegister.length === 0,
-			token: req?.securitizeTokensToRegister[0] ?? targetCollateral
+			protocol: "securitize",
+			requiredSignatures
 		};
 	}
 };

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

@@ -1,5 +1,4 @@
 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";
@@ -11,7 +10,6 @@ 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;
@@ -23,7 +21,6 @@ var SecuritizeRWAFactory = class extends BaseContract {
 			name: "SecuritizeRWAFactory",
 			abi
 		});
-		this.#sdk = sdk;
 		const decoded = decodeAbiParameters([
 			{
 				name: "owner",
@@ -184,40 +181,6 @@ 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/opportunities/MultichainOpportunitiesService.js

@@ -37,12 +37,18 @@ var MultichainOpportunitiesService = class extends MultichainConstruct {
 	*
 	* See {@link MultichainOpportunitiesService.getPool}.
 	**/
-	async getStrategy(key, wallet) {
+	async getStrategy(key) {
 		return this.queryChain({
 			network: key.chainId,
-			run: (sdk) => sdk.opportunities.getStrategy(key, wallet)
+			run: (sdk) => sdk.opportunities.getStrategy(key)
 		});
 	}
+	/**
+	* {@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,22 +36,34 @@ 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.
 	*
-	* @param wallet - When given, `kyc` says whether this wallet must register
-	* with the strategy's KYC provider first; `null` otherwise.
+	* `kyc` is the strategy's KYC gate, independent of any wallet.
 	*
 	* @throws If the credit manager is unknown, or does not currently offer a
 	* strategy.
 	**/
-	async getStrategy(key, wallet) {
+	async getStrategy(key) {
 		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 = wallet ? await suite.kycRequirement(wallet, detail.targetCollateral.address) : null;
+		const kyc = await suite.kycRequirement(detail.targetCollateral.address);
 		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/positions/calcHealthFactor.js

@@ -35,7 +35,7 @@ function calcHealthFactor(props) {
 		const scale = 10n ** BigInt(decimalsByToken.get(token) ?? 18);
 		return amount * price / scale;
 	};
-	const assetMoney = snapshot.assets.reduce((acc, { token, balance }) => {
+	const assetValue = snapshot.assets.reduce((acc, { token, balance }) => {
 		if (balance <= 10n) return acc;
 		const lt = BigInt(lts.get(token) ?? 0);
 		const tokenLtWeighted = (convertToUSD(token, balance, true) ?? 0n) * lt;
@@ -44,8 +44,8 @@ function calcHealthFactor(props) {
 		const quotaWeighted = (convertToUSD(underlying, quotaBalance) ?? 0n) * PERCENTAGE_FACTOR;
 		return acc + (quota ? BigIntMath.min(quotaWeighted, tokenLtWeighted) : tokenLtWeighted);
 	}, 0n);
-	const borrowedMoney = convertToUSD(underlying, snapshot.totalDebt) ?? 0n;
-	const hf = borrowedMoney > 0n ? assetMoney / borrowedMoney : 0n;
+	const borrowedValue = convertToUSD(underlying, snapshot.totalDebt) ?? 0n;
+	const hf = borrowedValue > 0n ? assetValue / borrowedValue : 0n;
 	return Number(hf);
 }
 //#endregion