@gearbox-protocol/sdk 15.1.0-next.1 → 15.1.0-next.2

package/dist/esm/sdk/market/MarketRegister.js

@@ -94,29 +94,38 @@ var MarketRegister = class extends ZapperRegister {
 	* Otherwise only prices are refreshed.
 	*
 	* @param ignoreUpdateablePrices - When `true`, skips off-chain price updates.
+	* @param extra - Additional multicalls to execute in the same batch, so that
+	*   other registries can be synced without an extra request.
+	* @returns `true` when markets were fully reloaded, so that callers can
+	*   refresh the caches derived from the market set.
 	**/
-	async syncState(ignoreUpdateablePrices) {
+	async syncState(ignoreUpdateablePrices, extra = []) {
 		const dirty = this.markets.some((m) => m.dirty) || this.marketConfigurators.some((c) => c.dirty);
 		let multicalls;
 		let txs = [];
 		if (dirty) {
 			this.logger?.debug("some markets or market configurators are dirty, reloading everything");
-			multicalls = this.getLoadMulticalls([...this.marketFilter.configurators]);
+			multicalls = [...this.getLoadMulticalls([...this.marketFilter.configurators]), ...extra];
 			if (!ignoreUpdateablePrices) {
 				const updatables = await this.sdk.priceFeeds.getPartialUpdatablePriceFeeds([...this.marketFilter.configurators]);
 				txs = (await this.sdk.priceFeeds.generatePriceFeedsUpdateTxs(updatables)).txs;
 			}
 		} else if (!ignoreUpdateablePrices) {
-			multicalls = this.#getOracleSyncMulticalls();
-			if (!multicalls.length) return;
-			this.logger?.debug(`syncing prices on ${multicalls.length} oracles`);
-			txs = (await this.sdk.priceFeeds.generatePriceFeedsUpdateTxs()).txs;
-		} else return;
+			const oracles = this.#getOracleSyncMulticalls();
+			multicalls = [...oracles, ...extra];
+			if (!multicalls.length) return false;
+			if (oracles.length) {
+				this.logger?.debug(`syncing prices on ${oracles.length} oracles`);
+				txs = (await this.sdk.priceFeeds.generatePriceFeedsUpdateTxs()).txs;
+			}
+		} else if (extra.length) multicalls = extra;
+		else return false;
 		await executeDelegatedMulticalls(this.client, multicalls, {
 			priceUpdates: txs,
 			blockNumber: this.sdk.currentBlock,
 			gas: this.sdk.gasLimit
 		});
+		return dirty;
 	}
 	#getOracleSyncMulticalls(oracles) {
 		const uniqOracles = new AddressMap();

package/dist/esm/sdk/market/ZapperRegister.js

@@ -4,53 +4,84 @@ import { VERSION_RANGE_310 } from "../constants/versions.js";
 import "../constants/index.js";
 import { hexEq } from "../utils/hex.js";
 import "../utils/index.js";
+import { executeMulticallBatches } from "../utils/viem/executeMulticallBatches.js";
 import { SDKConstruct } from "../base/SDKConstruct.js";
 import "../base/index.js";
 import { peripheryCompressorAbi } from "../../abi/compressors/peripheryCompressor.js";
+import "../utils/viem/index.js";
 import { createZapper } from "./zapper/createZapper.js";
 import "./zapper/index.js";
 //#region src/sdk/market/ZapperRegister.ts
 var ZapperRegister = class extends SDKConstruct {
 	/**
 	* Mapping pool.address -> Zapper[]
-	* Needs to be loaded explicitly using loadZappers method
+	* Loaded during SDK attach, or restored by hydration
 	*/
 	#zappers;
 	/**
-	* Load zappers for all pools using periphery compressor, adds hardcoded zappers
-	*/
-	async loadZappers(force) {
-		if (!force && this.#zappers) return;
-		const [pcAddr] = this.sdk.addressProvider.mustGetLatest(AP_PERIPHERY_COMPRESSOR, VERSION_RANGE_310);
+	* @internal
+	*
+	* Returns the multicall batch that loads zappers of all pools from the
+	* periphery compressor. Used by the SDK to warm this cache together with
+	* other loaders in a single multicall.
+	*
+	* Returns an empty batch when zappers are already loaded and `force` is not set.
+	*
+	* @param force - reload zappers even when they are already loaded
+	**/
+	getLoadZappersMulticall(force) {
+		if (!force && this.#zappers) return {
+			contracts: [],
+			onResults: () => {}
+		};
+		this.#zappers = new AddressMap(void 0, "zappers");
+		const compressor = this.sdk.addressProvider.getLatest(AP_PERIPHERY_COMPRESSOR, VERSION_RANGE_310);
+		if (!compressor) {
+			this.logger?.warn("no periphery compressor on this chain, skipping zappers");
+			return {
+				contracts: [],
+				onResults: () => {}
+			};
+		}
+		const [pcAddr] = compressor;
 		this.logger?.debug(`loading zappers with periphery compressor ${pcAddr}`);
 		const markets = this.sdk.marketRegister.markets;
-		const resp = await this.client.multicall({
+		return {
 			contracts: markets.map((m) => ({
 				abi: peripheryCompressorAbi,
 				address: pcAddr,
 				functionName: "getZappers",
 				args: [m.configurator.address, m.pool.pool.address]
 			})),
-			allowFailure: true,
-			batchSize: 0
-		});
-		this.#zappers = new AddressMap(void 0, "zappers");
-		for (let i = 0; i < resp.length; i++) {
-			const { status, result, error } = resp[i];
-			const marketConfigurator = markets[i].configurator.address;
-			const pool = markets[i].pool.pool.address;
-			if (status === "success") for (const z of result) this.#addZapper({
-				...z,
-				pool,
-				type: "base"
-			});
-			else this.logger?.error(`failed to load zapper for market configurator ${this.labelAddress(marketConfigurator)} and pool ${this.labelAddress(pool)}: ${error}`);
-		}
+			onResults: (resps) => {
+				for (let i = 0; i < resps.length; i++) {
+					const { status, result, error } = resps[i];
+					const marketConfigurator = markets[i].configurator.address;
+					const pool = markets[i].pool.pool.address;
+					if (status === "success") for (const z of result) this.#addZapper({
+						...z,
+						pool,
+						type: "base"
+					});
+					else this.logger?.error(`failed to load zapper for market configurator ${this.labelAddress(marketConfigurator)} and pool ${this.labelAddress(pool)}: ${error}`);
+				}
+			}
+		};
+	}
+	/**
+	* Load zappers for all pools using periphery compressor, adds hardcoded zappers
+	*
+	* Zappers loaded during SDK attach or restored by hydration are kept unless
+	* `force` is set, so calling this after either is a no-op.
+	*/
+	async loadZappers(force) {
+		await executeMulticallBatches(this.client, [this.getLoadZappersMulticall(force)]);
 	}
 	/**
 	* Serializable snapshot of all loaded zappers, suitable for hydration.
-	* Returns `undefined` when zappers were never loaded (i.e. `loadZappers` was
-	* not called), so the not-loaded state round-trips cleanly.
+	* Returns `undefined` when zappers were never loaded (i.e. the SDK was
+	* attached without market configurators), so the not-loaded state round-trips
+	* cleanly.
 	**/
 	get zappersState() {
 		if (!this.#zappers) return;
@@ -102,7 +133,7 @@ var ZapperRegister = class extends SDKConstruct {
 		}
 	}
 	get zappers() {
-		if (!this.#zappers) throw new Error("zappers not loaded, call loadZappers first");
+		if (!this.#zappers) throw new Error("zappers are not loaded, check if the sdk was properly attached or hydrated");
 		return this.#zappers;
 	}
 	poolZappers(pool) {

package/dist/esm/sdk/market/credit/CreditFacadeV310BaseContract.js

@@ -1,7 +1,7 @@
+import { iPausableAbi } from "../../../abi/iPausable.js";
 import { iCreditFacadeMulticallV310Abi, iCreditFacadeV310Abi } from "../../../abi/310/generated.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
-import { iPausableAbi } from "../../../abi/iPausable.js";
 //#region src/sdk/market/credit/CreditFacadeV310BaseContract.ts
 const abi = [
 	...iCreditFacadeV310Abi,

package/dist/esm/sdk/market/pool/PoolV310Contract.js

@@ -1,3 +1,4 @@
+import { iPausableAbi } from "../../../abi/iPausable.js";
 import { iPoolV310Abi } from "../../../abi/310/generated.js";
 import { AddressMap } from "../../utils/AddressMap.js";
 import { RAY } from "../../constants/math.js";
@@ -6,7 +7,6 @@ import { formatBN, formatBNvalue, percentFmt } from "../../utils/formatter.js";
 import "../../utils/index.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
-import { iPausableAbi } from "../../../abi/iPausable.js";
 import { utilizationBps } from "../math.js";
 //#region src/sdk/market/pool/PoolV310Contract.ts
 const abi = [...iPoolV310Abi, ...iPausableAbi];

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

@@ -24,6 +24,11 @@ var RWARegistry = class extends SDKConstruct {
 	#state;
 	#factories = new AddressMap();
 	/**
+	* Factories requested during attach; `undefined` when the registry was
+	* hydrated instead, in which case the request was never made on this instance.
+	**/
+	#requestedFactories;
+	/**
 	* @internal
 	*
 	* Returns delegated multicalls for loading all RWA underlying tokens from the on-chain RWA compressor.
@@ -33,6 +38,7 @@ var RWARegistry = class extends SDKConstruct {
 	* @param rwaFactories - RWA factory contracts to query.
 	*/
 	getLoadMulticalls(configurators, rwaFactories = []) {
+		this.#requestedFactories = rwaFactories;
 		if (!rwaFactories.length) return [];
 		const [rwaCompressorAddress] = this.sdk.addressProvider.mustGetLatest(AP_RWA_COMPRESSOR, VERSION_RANGE_310);
 		return [{
@@ -46,6 +52,22 @@ var RWARegistry = class extends SDKConstruct {
 		}];
 	}
 	/**
+	* @internal
+	*
+	* Returns delegated multicalls that refresh the RWA state. Unlike the other
+	* warmed caches, RWA data carries values that change between blocks (e.g. the
+	* deposit allowance and claimable amount of an on-demand liquidity provider),
+	* so it is refreshed on every SDK sync.
+	*
+	* Factories are the ones requested during attach; after hydration the chain
+	* defaults are used, since the snapshot does not carry the requested list.
+	* An attach that explicitly requested no factories stays disabled.
+	**/
+	getSyncMulticalls() {
+		const factories = this.#requestedFactories ?? this.sdk.chain.rwaFactories;
+		return this.getLoadMulticalls([...this.sdk.marketRegister.marketFilter.configurators], factories);
+	}
+	/**
 	* Fetches decoded investor data from the on-chain RWA compressor.
 	*
 	* Each factory produces its own investor data (e.g. registered tokens,

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

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

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

@@ -1,6 +1,6 @@
+import { iZapperAbi } from "../../../abi/iZapper.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
-import { iZapperAbi } from "../../../abi/iZapper.js";
 import { UnsupportedZapperFunctionError } from "./errors.js";
 //#region src/sdk/market/zapper/ZapperContract.ts
 /**

package/dist/esm/sdk/options.js

@@ -60,11 +60,7 @@ const attachOptionsSchema = z.object({
 	/**
 	* Options for Redstone price-feed updates.
 	**/
-	redstone: RedstoneOptions.optional(),
-	/**
-	* When `true`, automatically load zappers during attach.
-	**/
-	loadZappers: z.boolean().optional()
+	redstone: RedstoneOptions.optional()
 });
 //#endregion
 export { attachOptionsSchema, onchainSDKOptionsSchema };

package/dist/esm/sdk/pools/PoolService.js

@@ -1,5 +1,5 @@
-import { AddressSet } from "../utils/AddressSet.js";
 import { ierc20Abi } from "../../abi/iERC20.js";
+import { AddressSet } from "../utils/AddressSet.js";
 import "../constants/addresses.js";
 import { RAY } from "../constants/math.js";
 import "../constants/index.js";

package/dist/esm/sdk/utils/viem/executeMulticallBatches.js

@@ -0,0 +1,31 @@
+//#region src/sdk/utils/viem/executeMulticallBatches.ts
+/**
+* Executes the calls of several {@link MulticallBatch}es as a single multicall
+* aggregate and dispatches each batch its own slice of the results.
+*
+* Failures are allowed per call: loaders in a batch decide themselves how to
+* treat a reverted call (e.g. `contractType()` reverting on a plain ERC-20 is
+* expected). Use {@link executeDelegatedMulticalls} instead when the calls need
+* price updates applied first.
+*
+* @param client - Viem public client.
+* @param batches - Batches to execute together, empty ones are allowed.
+* @param opts - Block number forwarded to the multicall.
+**/
+async function executeMulticallBatches(client, batches, opts = {}) {
+	const contracts = batches.flatMap((b) => b.contracts);
+	if (!contracts.length) return;
+	const results = await client.multicall({
+		contracts,
+		allowFailure: true,
+		batchSize: 0,
+		blockNumber: opts.blockNumber
+	});
+	let offset = 0;
+	for (const batch of batches) {
+		batch.onResults(results.slice(offset, offset + batch.contracts.length));
+		offset += batch.contracts.length;
+	}
+}
+//#endregion
+export { executeMulticallBatches };

package/dist/esm/sdk/utils/viem/index.js

@@ -1,8 +1,9 @@
 import { generateCastTraceCall, getCastTraceArgs } from "./cast.js";
 import { SimulationError, simulateCall } from "./simulateCall.js";
+import { executeMulticallBatches } from "./executeMulticallBatches.js";
 import { simulateMulticall } from "./simulateMulticall.js";
 import { SimulateWithPriceUpdatesError, getSimulateWithPriceUpdatesError, simulateWithPriceUpdates } from "./simulateWithPriceUpdates.js";
 import { executeDelegatedMulticalls } from "./executeDelegatedMulticalls.js";
 import { estimateRawTxGas, sendRawTx } from "./sendRawTx.js";
 import { watchBlocksAsync } from "./watchBlocksAsync.js";
-export { SimulateWithPriceUpdatesError, SimulationError, estimateRawTxGas, executeDelegatedMulticalls, generateCastTraceCall, getCastTraceArgs, getSimulateWithPriceUpdatesError, sendRawTx, simulateCall, simulateMulticall, simulateWithPriceUpdates, watchBlocksAsync };
+export { SimulateWithPriceUpdatesError, SimulationError, estimateRawTxGas, executeDelegatedMulticalls, executeMulticallBatches, generateCastTraceCall, getCastTraceArgs, getSimulateWithPriceUpdatesError, sendRawTx, simulateCall, simulateMulticall, simulateWithPriceUpdates, watchBlocksAsync };

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

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

package/dist/types/abi/iExpirable.d.ts

@@ -0,0 +1,14 @@
+//#region src/abi/iExpirable.d.ts
+declare const iExpirableAbi: readonly [{
+  readonly type: "function";
+  readonly inputs: readonly [];
+  readonly name: "isExpired";
+  readonly outputs: readonly [{
+    readonly name: "";
+    readonly internalType: "bool";
+    readonly type: "bool";
+  }];
+  readonly stateMutability: "view";
+}];
+//#endregion
+export { iExpirableAbi };

package/dist/types/sdk/MultichainSDK.d.ts

@@ -63,11 +63,6 @@ interface MultichainAttachOptions {
    * Options for Redstone price-feed updates (shared cache across chains).
    **/
   redstone?: RedstoneOptions;
-  /**
-   * When `true`, automatically load zappers after markets are loaded during
-   * attach on every chain.
-   **/
-  loadZappers?: boolean;
 }
 /**
  * Options for {@link MultichainSDK.hydrate}.

package/dist/types/sdk/OnchainSDK.d.ts

@@ -38,7 +38,7 @@ import { HttpRpcClientOptions } from "viem/utils";
  * Serialised state format version, checked during hydration to detect
  * incompatible snapshots.
  **/
-declare const STATE_VERSION = 1;
+declare const STATE_VERSION = 2;
 /**
  * Connection options for the underlying JSON-RPC provider.
  *
@@ -132,10 +132,6 @@ interface AttachOptions {
    * Options for Redstone price-feed updates.
    **/
   redstone?: RedstoneOptions;
-  /**
-   * When `true`, automatically call {@link MarketRegister.loadZappers} during attach.
-   **/
-  loadZappers?: boolean;
 }
 /**
  * Options accepted by {@link OnchainSDK.hydrate}.

package/dist/types/sdk/accounts/withdrawal-compressor/AbstractWithdrawalCompressorContract.d.ts

@@ -1,4 +1,6 @@
 import { iWithdrawalCompressorV313Abi } from "../../../abi/IWithdrawalCompressorV313.js";
+import { MulticallBatch } from "../../utils/viem/executeMulticallBatches.js";
+import "../../utils/viem/index.js";
 import { ClaimableWithdrawal, CurrentWithdrawals, GetExternalAccountCurrentWithdrawalsProps, GetWithdrawalRequestResultProps, IWithdrawalCompressorContract, PendingWithdrawal, RequestableWithdrawal, WithdrawableAsset, WithdrawalStatus, WithdrawalsState } from "./types.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
 import { BaseContract, BaseContractArgs } from "../../base/BaseContract.js";
@@ -52,6 +54,10 @@ declare abstract class AbstractWithdrawalCompressorContract<abi extends Abi> ext
    * {@inheritDoc IWithdrawalCompressorContract.getWithdrawableAssets}
    **/
   getWithdrawableAssets(...creditManagers: Address[]): WithdrawableAsset[];
+  /**
+   * {@inheritDoc IWithdrawalCompressorContract.getLoadWithdrawableAssetsMulticall}
+   **/
+  getLoadWithdrawableAssetsMulticall(force?: boolean): MulticallBatch;
   /**
    * {@inheritDoc IWithdrawalCompressorContract.loadWithdrawableAssets}
    **/

package/dist/types/sdk/accounts/withdrawal-compressor/types.d.ts

@@ -1,3 +1,5 @@
+import { MulticallBatch } from "../../utils/viem/executeMulticallBatches.js";
+import "../../utils/viem/index.js";
 import { IBaseContract } from "../../base/types.js";
 import { MultiCall } from "../../types/transactions.js";
 import "../../types/index.js";
@@ -357,11 +359,27 @@ interface IWithdrawalCompressorContract extends IBaseContract {
    * or state hydration).
    **/
   getWithdrawableAssets(...creditManagers: Address[]): WithdrawableAsset[];
+  /**
+   * @internal
+   *
+   * Returns the multicall batch that loads withdrawable assets of all credit
+   * managers known to the SDK's market register. Used by the SDK to warm this
+   * cache together with other loaders in a single multicall.
+   *
+   * Returns an empty batch when the cache is already loaded and `force` is not set.
+   *
+   * @param force - Invalidate the cache and refetch even if already loaded.
+   **/
+  getLoadWithdrawableAssetsMulticall(force?: boolean): MulticallBatch;
   /**
    * Loads withdrawable assets of all credit managers known to the SDK's
    * market register into the cache (a single multicall, only once per SDK
    * lifetime) and returns them. Failed per-manager calls are logged and
    * skipped.
+   *
+   * Assets loaded during SDK attach or restored by state hydration are kept
+   * unless `force` is set, so calling this after either is a no-op.
+   *
    * @param force - Invalidate the cache and refetch even if already loaded.
    * @param blockNumber - Block to read at. Defaults to the latest block.
    **/

package/dist/types/sdk/base/TokensMeta.d.ts

@@ -1,5 +1,6 @@
 import { ILogger } from "../types/logger.js";
 import { Token } from "../../model/primitives.js";
+import { MulticallBatch } from "../utils/viem/executeMulticallBatches.js";
 import { AddressMap } from "../utils/AddressMap.js";
 import { Asset } from "./types.js";
 import "../utils/index.js";
@@ -19,6 +20,20 @@ interface FormatBNOptions {
    **/
   symbol?: boolean;
 }
+/**
+ * Serializable snapshot of the token metadata registry.
+ **/
+interface TokensMetaState {
+  /**
+   * Metadata of all known tokens.
+   **/
+  tokens: TokenMetaData[];
+  /**
+   * Tokens whose extended data (`contractType`, `serialize()`) was loaded,
+   * so that the loaded/not-loaded distinction round-trips through hydration.
+   **/
+  extendedLoaded: Address[];
+}
 /**
  * Registry of token metadata (symbol, decimals, phantom type) keyed by address.
  *
@@ -122,13 +137,41 @@ declare class TokensMeta extends AddressMap<TokenMetaData> {
    * @throws If no token matches the symbol.
    */
   mustFindBySymbol(symbol: string): TokenMetaData;
+  /**
+   * @internal
+   *
+   * Returns the multicall batch that loads extended token data (`contractType`
+   * and `serialize()`) for the tokens that do not have it yet. Used by the SDK
+   * to warm this cache together with other loaders in a single multicall.
+   *
+   * @param tokens - tokens to load data for, defaults to all tokens
+   **/
+  getLoadTokenDataMulticall(...tokens: Address[]): MulticallBatch;
   /**
    * Loads token information about phantom tokens
    * In future other custom tokens types that do not have compressors might be handled here
    *
+   * Tokens loaded during SDK attach or restored by {@link hydrate} are skipped,
+   * so calling this after either is a no-op.
+   *
    * @param tokens - tokens to load data for, defaults to all tokens
    */
   loadTokenData(...tokens: Address[]): Promise<void>;
+  /**
+   * Serializable snapshot of all token metadata, suitable for hydration.
+   **/
+  get state(): TokensMetaState;
+  /**
+   * Restores token metadata from a previously serialized snapshot,
+   * bypassing on-chain reads.
+   *
+   * Entries are merged into the ones already registered by markets, zappers and
+   * the RWA registry (see {@link upsert}), so the snapshot must be applied last
+   * for its augmented fields to win.
+   *
+   * @param state - Token metadata snapshot.
+   **/
+  hydrate(state: TokensMetaState): void;
 }
 //#endregion
-export { FormatBNOptions, TokensMeta };
+export { FormatBNOptions, TokensMeta, TokensMetaState };

package/dist/types/sdk/base/index.d.ts

@@ -1,6 +1,6 @@
 import { AdapterData, AssertAssignable, Asset, BaseParams, BaseState, ConnectedBotData, CreditAccountData, CreditAccountDataPayload, CreditAccountTokensSlice, CreditConfiguratorState, CreditFacadeState, CreditManagerDebtParams, CreditManagerState, CreditSuiteState, GaugeData, IBaseContract, MarketData, MarketFilter, ParsedCall, ParsedCallArgs, ParsedCallV2, PermitResult, PoolState, PriceFeedAnswer, PriceFeedMapEntry, PriceFeedTreeNode, PriceOracleData, QuotaKeeperState, QuotaState, RateKeeperState, RelaxedBaseParams, RewardInfo, TokenInfo, Unarray, VotingContractStatus } from "./types.js";
 import { LPMonopolizedPoolMeta, PHANTOM_TOKEN_CONTRACT_TYPES, PhantomTokenContractType, PhantomTokenMeta, RWADefaultTokenMeta, RWAOnDemandLPMeta, RWAOnDemandLPMonopolizedMeta, RWAOnDemandLpContractType, RWAOnDemandTokenMeta, RWATokenMeta, RWAUnderlyingContractType, RWA_ON_DEMAND_LP_MONOPOLIZED, RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND, SimpleTokenMeta, TokenMetaData } from "./token-types.js";
-import { FormatBNOptions, TokensMeta } from "./TokensMeta.js";
+import { FormatBNOptions, TokensMeta, TokensMetaState } from "./TokensMeta.js";
 import { ChainContractsRegister, ContractOrInterface } from "./ChainContractsRegister.js";
 import { Construct, ConstructOptions } from "./Construct.js";
 import { BaseContract, BaseContractArgs, ContractParseError, ContractParseErrorOptions } from "./BaseContract.js";
@@ -8,4 +8,4 @@ import { MissingSerializedParamsError } from "./errors.js";
 import { ChainBlock, ChainBlockPin, ChainBlockSource, ChainQueryOneProps, ChainQueryProps, MultichainConstruct } from "./MultichainConstruct.js";
 import { PlaceholderContract } from "./PlaceholderContract.js";
 import { SDKConstruct } from "./SDKConstruct.js";
-export { AdapterData, AssertAssignable, Asset, BaseContract, BaseContractArgs, BaseParams, BaseState, ChainBlock, ChainBlockPin, ChainBlockSource, ChainContractsRegister, ChainQueryOneProps, ChainQueryProps, ConnectedBotData, Construct, ConstructOptions, ContractOrInterface, ContractParseError, ContractParseErrorOptions, CreditAccountData, CreditAccountDataPayload, CreditAccountTokensSlice, CreditConfiguratorState, CreditFacadeState, CreditManagerDebtParams, CreditManagerState, CreditSuiteState, FormatBNOptions, GaugeData, IBaseContract, LPMonopolizedPoolMeta, MarketData, MarketFilter, MissingSerializedParamsError, MultichainConstruct, PHANTOM_TOKEN_CONTRACT_TYPES, ParsedCall, ParsedCallArgs, ParsedCallV2, PermitResult, PhantomTokenContractType, PhantomTokenMeta, PlaceholderContract, PoolState, PriceFeedAnswer, PriceFeedMapEntry, PriceFeedTreeNode, PriceOracleData, QuotaKeeperState, QuotaState, RWADefaultTokenMeta, RWAOnDemandLPMeta, RWAOnDemandLPMonopolizedMeta, RWAOnDemandLpContractType, RWAOnDemandTokenMeta, RWATokenMeta, RWAUnderlyingContractType, RWA_ON_DEMAND_LP_MONOPOLIZED, RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND, RateKeeperState, RelaxedBaseParams, RewardInfo, SDKConstruct, SimpleTokenMeta, TokenInfo, TokenMetaData, TokensMeta, Unarray, VotingContractStatus };
+export { AdapterData, AssertAssignable, Asset, BaseContract, BaseContractArgs, BaseParams, BaseState, ChainBlock, ChainBlockPin, ChainBlockSource, ChainContractsRegister, ChainQueryOneProps, ChainQueryProps, ConnectedBotData, Construct, ConstructOptions, ContractOrInterface, ContractParseError, ContractParseErrorOptions, CreditAccountData, CreditAccountDataPayload, CreditAccountTokensSlice, CreditConfiguratorState, CreditFacadeState, CreditManagerDebtParams, CreditManagerState, CreditSuiteState, FormatBNOptions, GaugeData, IBaseContract, LPMonopolizedPoolMeta, MarketData, MarketFilter, MissingSerializedParamsError, MultichainConstruct, PHANTOM_TOKEN_CONTRACT_TYPES, ParsedCall, ParsedCallArgs, ParsedCallV2, PermitResult, PhantomTokenContractType, PhantomTokenMeta, PlaceholderContract, PoolState, PriceFeedAnswer, PriceFeedMapEntry, PriceFeedTreeNode, PriceOracleData, QuotaKeeperState, QuotaState, RWADefaultTokenMeta, RWAOnDemandLPMeta, RWAOnDemandLPMonopolizedMeta, RWAOnDemandLpContractType, RWAOnDemandTokenMeta, RWATokenMeta, RWAUnderlyingContractType, RWA_ON_DEMAND_LP_MONOPOLIZED, RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND, RateKeeperState, RelaxedBaseParams, RewardInfo, SDKConstruct, SimpleTokenMeta, TokenInfo, TokenMetaData, TokensMeta, TokensMetaState, Unarray, VotingContractStatus };

package/dist/types/sdk/base/token-types.d.ts

@@ -1,5 +1,5 @@
 import { MarketData, Unarray } from "./types.js";
-import { Address } from "viem";
+import { Address, Hex } from "viem";
 //#region src/sdk/base/token-types.d.ts
 type TokenData = Unarray<MarketData["tokens"]>;
 declare const PHANTOM_TOKEN_CONTRACT_TYPES: readonly ["PHANTOM_TOKEN::CONVEX", "PHANTOM_TOKEN::INFINIFI_UNWIND", "PHANTOM_TOKEN::INFRARED", "PHANTOM_TOKEN::MELLOW_WITHDRAWAL", "PHANTOM_TOKEN::MIDAS_REDEMPTION", "PHANTOM_TOKEN::SECURITIZE_RD", "PHANTOM_TOKEN::STAKING_REWARDS", "PHANTOM_TOKEN::UPSHIFT_WITHDRAW"];
@@ -11,6 +11,17 @@ type RWAOnDemandLpContractType = typeof RWA_ON_DEMAND_LP_MONOPOLIZED;
 type PhantomTokenContractType = (typeof PHANTOM_TOKEN_CONTRACT_TYPES)[number];
 interface SimpleTokenMeta extends TokenData {
   contractType?: string;
+  /**
+   * Raw output of the token's `serialize()` call, when it implements
+   * `IStateSerializer`. Decoding is left to the consumer that knows the
+   * layout of the given {@link contractType}.
+   **/
+  serializedParams?: Hex;
+  /**
+   * Result of the token's `isExpired()` call, when it implements it
+   * (e.g. Pendle PT tokens). Undefined for tokens without this method.
+   **/
+  isExpired?: boolean;
 }
 type PhantomTokenMeta = SimpleTokenMeta & {
   contractType: PhantomTokenContractType;