@moonwell-fi/moonwell-sdk 0.12.0 → 0.12.1

package/common/getBlockNumberAtTimestamp.ts

@@ -0,0 +1,59 @@
+import type { PublicClient } from "viem";
+
+/**
+ * Safety cap on interpolation iterations. With near-linear `ts(block)` the search
+ * converges in ~3–5 reads; 8 leaves headroom for chains with variable block times
+ * (e.g. Moonbeam) without unbounded RPC fan-out on pathological inputs.
+ */
+const MAX_ITERATIONS = 8;
+
+/**
+ * Find the block number on a chain whose timestamp is the latest one ≤ the target unix timestamp.
+ *
+ * Uses interpolation search anchored on the latest block and block 1: each iteration
+ * narrows the range by reading one block and projecting the target via the slope of the
+ * remaining range. Converges in ~3–5 RPC calls even on chains with variable block times.
+ *
+ * Assumes block 1 exists on the chain — true for every EVM chain Moonwell supports.
+ *
+ * Returns the latest block if `targetTimestamp` is at or after the head, and block 1
+ * if it is before block 1's timestamp. On a chain with only block 0, returns block 0.
+ */
+export async function getBlockNumberAtTimestamp(
+  publicClient: PublicClient,
+  targetTimestamp: bigint,
+): Promise<bigint> {
+  const latest = await publicClient.getBlock({ blockTag: "latest" });
+  if (targetTimestamp >= latest.timestamp) return latest.number;
+  if (latest.number === 0n) return latest.number;
+
+  const first = await publicClient.getBlock({ blockNumber: 1n });
+  if (targetTimestamp <= first.timestamp) return first.number;
+
+  let lo = first.number;
+  let loTs = first.timestamp;
+  let hi = latest.number;
+  let hiTs = latest.timestamp;
+
+  for (let i = 0; i < MAX_ITERATIONS; i += 1) {
+    if (hi - lo <= 1n) break;
+    const tsRange = hiTs - loTs;
+    if (tsRange <= 0n) break;
+
+    const offset = ((targetTimestamp - loTs) * (hi - lo)) / tsRange;
+    let mid = lo + offset;
+    if (mid <= lo) mid = lo + 1n;
+    if (mid >= hi) mid = hi - 1n;
+
+    const block = await publicClient.getBlock({ blockNumber: mid });
+    if (block.timestamp <= targetTimestamp) {
+      lo = mid;
+      loTs = block.timestamp;
+    } else {
+      hi = mid;
+      hiTs = block.timestamp;
+    }
+  }
+
+  return lo;
+}

package/common/index.ts

@@ -7,6 +7,7 @@ dayjs.extend(utc);
 export { Amount } from "./amount.js";
 export { BaseError, HttpRequestError } from "./error.js";
 export type { HttpRequestErrorType } from "./error.js";
+export { getBlockNumberAtTimestamp } from "./getBlockNumberAtTimestamp.js";
 export type { MultichainReturnType } from "./types.js";
 
 export const SECONDS_PER_DAY = 86400;

package/environments/types/config.ts

@@ -136,6 +136,37 @@ export type ContractsConfigReturnType = {
   morphoPublicAllocator: MorphoPublicAllocatorContractReturnType;
 };
 
+type EnvironmentContractsReturnType = {
+  stakingToken: StakingTokenContractReturnType;
+  wrappedNativeToken: WrappedNativeTokenContractReturnType;
+  governanceToken: GovernanceTokenContractReturnType;
+  comptroller: ComptrollerContractReturnType;
+  maximillion: MaximillionContractReturnType;
+  views: CoreViewsContractReturnType;
+  tokenSale: TokenSaleContractReturnType;
+  morphoViews: MorphoViewsContractReturnType;
+  morphoViewsV2: MorphoViewsContractReturnType;
+  multiRewardDistributor: MultiRewardDistributorContractReturnType;
+  temporalGovernor: TemporalGovernorContractReturnType;
+  voteCollector: VoteCollectorContractReturnType;
+  governor: GovernorContractReturnType;
+  multichainGovernor: MultichainGovernorContractReturnType;
+  oracle: ChainLinkOracleContractReturnType;
+  router: CoreRouterContractReturnType;
+  morphoBlue: MorphoBlueContractReturnType;
+  morphoBundler: MorphoBundlerContractReturnType;
+  morphoBaseBundler: MorphoBundlerContractReturnType;
+  morphoPublicAllocator: MorphoPublicAllocatorContractReturnType;
+};
+
+type EnvironmentContracts<contracts> = {
+  [K in keyof contracts as K extends keyof EnvironmentContractsReturnType
+    ? K
+    : never]: K extends keyof EnvironmentContractsReturnType
+    ? EnvironmentContractsReturnType[K]
+    : never;
+};
+
 export type CustomConfigType = {
   morpho?: {
     minimalDeployment?: boolean;
@@ -242,7 +273,7 @@ export const createEnvironmentConfig = <
   contracts: ContractsConfig<contracts, tokens>;
   custom: CustomConfig<custom>;
 }) => {
-  const publicClient = createPublicClient({
+  const publicClient: PublicClient = createPublicClient({
     chain: config.chain,
     batch: {
       multicall: {
@@ -387,109 +418,7 @@ export const createEnvironmentConfig = <
       ...prev,
       [curr]: createContract(contractAddress, abi),
     };
-  }, {}) as Prettify<
-    {
-      [name in keyof contracts as Extract<
-        name,
-        "stakingToken"
-      >]: StakingTokenContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "wrappedNativeToken"
-      >]: WrappedNativeTokenContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "governanceToken"
-      >]: GovernanceTokenContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "comptroller"
-      >]: ComptrollerContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "maximillion"
-      >]: MaximillionContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "views"
-      >]: CoreViewsContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "tokenSale"
-      >]: TokenSaleContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "morphoViews"
-      >]: MorphoViewsContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "morphoViewsV2"
-      >]: MorphoViewsContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "multiRewardDistributor"
-      >]: MultiRewardDistributorContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "temporalGovernor"
-      >]: TemporalGovernorContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "voteCollector"
-      >]: VoteCollectorContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "governor"
-      >]: GovernorContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "multichainGovernor"
-      >]: MultichainGovernorContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "oracle"
-      >]: ChainLinkOracleContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "router"
-      >]: CoreRouterContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "morphoBlue"
-      >]: MorphoBlueContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "morphoBundler"
-      >]: MorphoBundlerContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "morphoBaseBundler"
-      >]: MorphoBundlerContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "morphoPublicAllocator"
-      >]: MorphoPublicAllocatorContractReturnType;
-    }
-  >;
+  }, {}) as EnvironmentContracts<contracts>;
 
   return {
     key: config.key,
@@ -551,109 +480,7 @@ export type Environment<
   vaults: {
     [name in keyof vaults]: MorphoVaultContractReturnType;
   };
-  contracts: Prettify<
-    {
-      [name in keyof contracts as Extract<
-        name,
-        "stakingToken"
-      >]: StakingTokenContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "wrappedNativeToken"
-      >]: WrappedNativeTokenContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "governanceToken"
-      >]: GovernanceTokenContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "comptroller"
-      >]: ComptrollerContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "maximillion"
-      >]: MaximillionContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "views"
-      >]: CoreViewsContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "tokenSale"
-      >]: TokenSaleContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "morphoViews"
-      >]: MorphoViewsContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "morphoViewsV2"
-      >]: MorphoViewsContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "multiRewardDistributor"
-      >]: MultiRewardDistributorContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "temporalGovernor"
-      >]: TemporalGovernorContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "voteCollector"
-      >]: VoteCollectorContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "governor"
-      >]: GovernorContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "multichainGovernor"
-      >]: MultichainGovernorContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "oracle"
-      >]: ChainLinkOracleContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "router"
-      >]: CoreRouterContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "morphoBlue"
-      >]: MorphoBlueContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "morphoBundler"
-      >]: MorphoBundlerContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "morphoBaseBundler"
-      >]: MorphoBundlerContractReturnType;
-    } & {
-      [name in keyof contracts as Extract<
-        name,
-        "morphoPublicAllocator"
-      >]: MorphoPublicAllocatorContractReturnType;
-    }
-  >;
+  contracts: EnvironmentContracts<contracts>;
   custom: custom;
   config: {
     tokens: {

package/errors/version.ts

@@ -1 +1 @@
-export const version = '0.12.0'
+export const version = '0.12.1'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@moonwell-fi/moonwell-sdk",
   "description": "TypeScript Interface for Moonwell",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",
@@ -77,7 +77,7 @@
     "@types/lodash": "^4.17.9",
     "@types/node": "^22.13.10",
     "axios": "^1.7.7",
-    "dayjs": "^1.11.13",
+    "dayjs": "^1.11.20",
     "lodash": "^4.17.21",
     "viem": "^2.26.2"
   },