@lunatest/core 0.1.0 → 0.1.1

package/dist/presets/project-sources.node.ts

@@ -0,0 +1,57 @@
+import type { ProjectPresetSources, PresetSourceInput } from "./registry.js";
+
+async function readPresetDir(
+  root: string,
+  bucket: Record<string, PresetSourceInput>,
+  baseDir = root,
+): Promise<void> {
+  const { readdir } = await import("node:fs/promises");
+  const path = await import("node:path");
+  const entries = await readdir(root, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const absolutePath = path.join(root, entry.name);
+    if (entry.isDirectory()) {
+      await readPresetDir(absolutePath, bucket, baseDir);
+      continue;
+    }
+
+    if (!entry.isFile() || !entry.name.endsWith(".lua")) {
+      continue;
+    }
+
+    const relativePath = path.relative(baseDir, absolutePath).replace(/\\/g, "/");
+    const id = relativePath.replace(/\.lua$/u, "");
+    bucket[id] = absolutePath;
+  }
+}
+
+export async function loadProjectPresetSources(
+  projectRoot: string,
+): Promise<ProjectPresetSources> {
+  const path = await import("node:path");
+  const fs = await import("node:fs/promises");
+  const protocolRoot = path.join(projectRoot, "lunatest", "presets", "protocol");
+  const walletRoot = path.join(projectRoot, "lunatest", "presets", "wallet");
+  const protocol: Record<string, PresetSourceInput> = {};
+  const wallet: Record<string, PresetSourceInput> = {};
+
+  try {
+    await fs.access(protocolRoot);
+    await readPresetDir(protocolRoot, protocol);
+  } catch {
+    // ignore missing local protocol preset directory
+  }
+
+  try {
+    await fs.access(walletRoot);
+    await readPresetDir(walletRoot, wallet);
+  } catch {
+    // ignore missing local wallet preset directory
+  }
+
+  return {
+    protocol,
+    wallet,
+  };
+}

package/dist/presets/protocol/aave.lua

@@ -0,0 +1,82 @@
+return {
+  manifest = {
+    id = "aave",
+    label = "Aave",
+    description = "Built-in lending market preset.",
+    kind = "lending",
+    supportedChains = { 1 },
+    protocol = "aave",
+    version = "v3",
+    components = {
+      pool = "v3_pool",
+      oracle = "price_oracle",
+    },
+    defaultWalletPreset = {
+      id = "empty_wallet",
+    },
+    defaultInterceptState = {
+      protocol = {
+        id = "aave",
+      },
+    },
+    defaultRouteMocks = {},
+    builtinScenarios = {
+      {
+        id = "health_factor_warning",
+        label = "Health Factor Warning",
+        lua = "scenario { name = 'health_factor_warning', given = { wallet = { healthFactor = 1.02 } } }",
+      },
+    },
+    paramsSchema = {
+      {
+        key = "chainId",
+        label = "Chain",
+        type = "chainId",
+        required = true,
+        default = 1,
+        options = { 1 },
+      },
+      {
+        key = "reserve",
+        label = "Reserve",
+        type = "string",
+        required = true,
+        default = "USDC",
+      },
+    },
+    recommendedControls = { "reserve" },
+  },
+
+  materialize = function(params)
+    local chainId = tonumber(params.chainId or 1)
+    local reserve = tostring(params.reserve or "USDC")
+
+    return {
+      resolvedParams = {
+        chainId = chainId,
+        reserve = reserve,
+      },
+      walletPreset = {
+        id = "empty_wallet",
+        overrides = {
+          chainId = string.format("0x%x", chainId),
+        },
+      },
+      interceptState = {
+        chain = { id = chainId },
+        protocol = {
+          id = "aave",
+          version = "v3",
+          components = {
+            pool = "v3_pool",
+            oracle = "price_oracle",
+          },
+        },
+        market = {
+          reserve = reserve,
+        },
+      },
+      routeMocks = {},
+    }
+  end,
+}

package/dist/presets/protocol/curve.lua

@@ -0,0 +1,82 @@
+return {
+  manifest = {
+    id = "curve",
+    label = "Curve",
+    description = "Built-in stable swap preset.",
+    kind = "dex",
+    supportedChains = { 1 },
+    protocol = "curve",
+    version = "v1",
+    components = {
+      invariant = "stable_swap",
+      router = "pool_router",
+    },
+    defaultWalletPreset = {
+      id = "empty_wallet",
+    },
+    defaultInterceptState = {
+      protocol = {
+        id = "curve",
+      },
+    },
+    defaultRouteMocks = {},
+    builtinScenarios = {
+      {
+        id = "imbalanced_pool",
+        label = "Imbalanced Pool",
+        lua = "scenario { name = 'imbalanced_pool', given = { pool = { imbalance = true } } }",
+      },
+    },
+    paramsSchema = {
+      {
+        key = "chainId",
+        label = "Chain",
+        type = "chainId",
+        required = true,
+        default = 1,
+        options = { 1 },
+      },
+      {
+        key = "poolName",
+        label = "Pool",
+        type = "string",
+        required = true,
+        default = "3pool",
+      },
+    },
+    recommendedControls = { "poolName" },
+  },
+
+  materialize = function(params)
+    local chainId = tonumber(params.chainId or 1)
+    local poolName = tostring(params.poolName or "3pool")
+
+    return {
+      resolvedParams = {
+        chainId = chainId,
+        poolName = poolName,
+      },
+      walletPreset = {
+        id = "empty_wallet",
+        overrides = {
+          chainId = string.format("0x%x", chainId),
+        },
+      },
+      interceptState = {
+        chain = { id = chainId },
+        protocol = {
+          id = "curve",
+          version = "v1",
+          components = {
+            invariant = "stable_swap",
+            router = "pool_router",
+          },
+        },
+        pool = {
+          name = poolName,
+        },
+      },
+      routeMocks = {},
+    }
+  end,
+}

package/dist/presets/protocol/uniswap_v2.lua

@@ -0,0 +1,92 @@
+return {
+  manifest = {
+    id = "uniswap_v2",
+    label = "Uniswap V2",
+    description = "Built-in constant product DEX preset.",
+    kind = "dex",
+    supportedChains = { 1, 11155111 },
+    protocol = "uniswap",
+    version = "v2",
+    components = {
+      router = "router_02",
+      pricing = "pair_reserves",
+    },
+    defaultWalletPreset = {
+      id = "demo_sepolia",
+    },
+    defaultInterceptState = {
+      protocol = {
+        id = "uniswap_v2",
+      },
+    },
+    defaultRouteMocks = {},
+    builtinScenarios = {
+      {
+        id = "price_impact_warning",
+        label = "Price Impact Warning",
+        lua = "scenario { name = 'price_impact_warning', given = { chaos = { slippagePctOverride = 12 } } }",
+      },
+    },
+    paramsSchema = {
+      {
+        key = "chainId",
+        label = "Chain",
+        type = "chainId",
+        required = true,
+        default = 11155111,
+        options = { 1, 11155111 },
+      },
+      {
+        key = "tokenIn",
+        label = "Token In",
+        type = "address",
+        required = true,
+        default = "0xfff9976782d46cc05630d1f6ebab18b2324d6b14",
+      },
+      {
+        key = "tokenOut",
+        label = "Token Out",
+        type = "address",
+        required = true,
+        default = "0x1c7d4b196cb0c7b01d743fbc6116a902379c7238",
+      },
+    },
+    recommendedControls = { "chainId", "tokenIn", "tokenOut" },
+  },
+
+  materialize = function(params)
+    local chainId = tonumber(params.chainId or 11155111)
+    local tokenIn = tostring(params.tokenIn or "0xfff9976782d46cc05630d1f6ebab18b2324d6b14")
+    local tokenOut = tostring(params.tokenOut or "0x1c7d4b196cb0c7b01d743fbc6116a902379c7238")
+
+    return {
+      resolvedParams = {
+        chainId = chainId,
+        tokenIn = tokenIn,
+        tokenOut = tokenOut,
+      },
+      walletPreset = {
+        id = "demo_sepolia",
+        overrides = {
+          chainId = string.format("0x%x", chainId),
+        },
+      },
+      interceptState = {
+        chain = { id = chainId },
+        protocol = {
+          id = "uniswap_v2",
+          version = "v2",
+          components = {
+            router = "router_02",
+            pricing = "pair_reserves",
+          },
+        },
+        pair = {
+          tokenIn = tokenIn,
+          tokenOut = tokenOut,
+        },
+      },
+      routeMocks = {},
+    }
+  end,
+}

package/dist/presets/protocol/uniswap_v3.lua

@@ -0,0 +1,144 @@
+return {
+  manifest = {
+    id = "uniswap_v3",
+    label = "Uniswap V3",
+    description = "Built-in concentrated liquidity DEX preset.",
+    kind = "dex",
+    supportedChains = { 1, 11155111 },
+    protocol = "uniswap",
+    version = "v3",
+    components = {
+      quoter = "v2",
+      router = "swap_router_02",
+    },
+    defaultWalletPreset = {
+      id = "demo_sepolia",
+    },
+    defaultInterceptState = {
+      chain = {
+        id = 11155111,
+        gasPriceGwei = 30,
+      },
+      protocol = {
+        id = "uniswap_v3",
+      },
+    },
+    defaultRouteMocks = {},
+    builtinScenarios = {
+      {
+        id = "approval_required",
+        label = "Approval Required",
+        lua = "scenario { name = 'approval_required', given = { wallet = { connected = true } } }",
+      },
+      {
+        id = "swap_pending",
+        label = "Swap Pending",
+        lua = "scenario { name = 'swap_pending', given = { chaos = { pendingForMs = 600000 } } }",
+      },
+    },
+    paramsSchema = {
+      {
+        key = "chainId",
+        label = "Chain",
+        type = "chainId",
+        required = true,
+        default = 11155111,
+        options = { 1, 11155111 },
+      },
+      {
+        key = "tokenIn",
+        label = "Token In",
+        type = "address",
+        required = true,
+        default = "0xfff9976782d46cc05630d1f6ebab18b2324d6b14",
+      },
+      {
+        key = "tokenOut",
+        label = "Token Out",
+        type = "address",
+        required = true,
+        default = "0x1c7d4b196cb0c7b01d743fbc6116a902379c7238",
+      },
+      {
+        key = "feeTier",
+        label = "Fee Tier",
+        type = "enum",
+        required = true,
+        default = 3000,
+        options = { 500, 3000, 10000 },
+      },
+      {
+        key = "quoter",
+        label = "Quoter",
+        type = "enum",
+        required = true,
+        default = "v2",
+        options = { "v1", "v2" },
+      },
+    },
+    recommendedControls = { "chainId", "tokenIn", "tokenOut", "feeTier", "quoter" },
+  },
+
+  materialize = function(params)
+    local chainId = tonumber(params.chainId or 11155111)
+    local tokenIn = tostring(params.tokenIn or "0xfff9976782d46cc05630d1f6ebab18b2324d6b14")
+    local tokenOut = tostring(params.tokenOut or "0x1c7d4b196cb0c7b01d743fbc6116a902379c7238")
+    local feeTier = tonumber(params.feeTier or 3000)
+    local quoter = tostring(params.quoter or "v2")
+
+    return {
+      resolvedParams = {
+        chainId = chainId,
+        tokenIn = tokenIn,
+        tokenOut = tokenOut,
+        feeTier = feeTier,
+        quoter = quoter,
+      },
+      walletPreset = {
+        id = "demo_sepolia",
+        overrides = {
+          chainId = string.format("0x%x", chainId),
+        },
+      },
+      walletSessionOverrides = {
+        assets = {
+          nativeBalance = "1",
+          tokens = {
+            [string.lower(tokenIn)] = {
+              balance = "25",
+              allowance = "0",
+              symbol = "TOKEN_IN",
+              decimals = 18,
+            },
+            [string.lower(tokenOut)] = {
+              balance = "0",
+              allowance = "0",
+              symbol = "TOKEN_OUT",
+              decimals = 18,
+            },
+          },
+        },
+      },
+      interceptState = {
+        chain = {
+          id = chainId,
+          gasPriceGwei = 30,
+        },
+        protocol = {
+          id = "uniswap_v3",
+          version = "v3",
+          components = {
+            quoter = quoter,
+            router = "swap_router_02",
+          },
+        },
+        pool = {
+          tokenIn = tokenIn,
+          tokenOut = tokenOut,
+          feeTier = feeTier,
+        },
+      },
+      routeMocks = {},
+    }
+  end,
+}

package/dist/presets/registry.d.ts

@@ -0,0 +1,59 @@
+import { type PresetDiagnostic, type PresetSource, type ProtocolPresetCatalogEntry, type ProtocolPresetMaterialization, type WalletPresetCatalogEntry, type WalletPresetMaterialization } from "@lunatest/contracts";
+export type PresetSourceInput = string | URL;
+export type ProjectPresetSources = {
+    protocol?: Record<string, PresetSourceInput>;
+    wallet?: Record<string, PresetSourceInput>;
+};
+export type PresetRegistry = {
+    protocolSources: Record<string, {
+        source: PresetSource;
+        input: PresetSourceInput;
+        localId: string;
+    }>;
+    walletSources: Record<string, {
+        source: PresetSource;
+        input: PresetSourceInput;
+        localId: string;
+    }>;
+    protocolCache: Map<string, Promise<LoadedProtocolPreset | null>>;
+    walletCache: Map<string, Promise<LoadedWalletPreset | null>>;
+    diagnostics: Map<string, PresetDiagnostic>;
+    protocolQualifiedOwners: Map<string, string>;
+    walletQualifiedOwners: Map<string, string>;
+    hasProjectSources: boolean;
+};
+export type PresetRegistryOptions = {
+    projectSources?: ProjectPresetSources;
+};
+export type ValidatePresetContext = {
+    source: PresetSource;
+    expectedId: string;
+    registry?: PresetRegistry;
+};
+type LoadedProtocolPreset = {
+    entry: ProtocolPresetCatalogEntry;
+    materialize: (params?: Record<string, unknown>) => Promise<Record<string, unknown>>;
+};
+type LoadedWalletPreset = {
+    entry: WalletPresetCatalogEntry;
+    materialize: (params?: Record<string, unknown>) => Promise<Record<string, unknown>>;
+};
+export declare function validateProtocolPresetSource(source: PresetSourceInput, context: ValidatePresetContext): Promise<{
+    entry: ProtocolPresetCatalogEntry | null;
+    diagnostics: PresetDiagnostic[];
+    materialize?: LoadedProtocolPreset["materialize"];
+}>;
+export declare function validateWalletPresetSource(source: PresetSourceInput, context: ValidatePresetContext): Promise<{
+    entry: WalletPresetCatalogEntry | null;
+    diagnostics: PresetDiagnostic[];
+    materialize?: LoadedWalletPreset["materialize"];
+}>;
+export declare function createPresetRegistry(options?: PresetRegistryOptions): PresetRegistry;
+export declare function getPresetDiagnostics(registry?: PresetRegistry): Promise<PresetDiagnostic[]>;
+export declare function listProtocolPresets(registry?: PresetRegistry): Promise<ProtocolPresetCatalogEntry[]>;
+export declare function getProtocolPreset(id: string, registry?: PresetRegistry): Promise<ProtocolPresetCatalogEntry | null>;
+export declare function listWalletPresets(registry?: PresetRegistry): Promise<WalletPresetCatalogEntry[]>;
+export declare function getWalletPreset(id: string, registry?: PresetRegistry): Promise<WalletPresetCatalogEntry | null>;
+export declare function materializeWalletPreset(id: string, params?: Record<string, unknown>, registry?: PresetRegistry): Promise<WalletPresetMaterialization>;
+export declare function materializeProtocolPreset(id: string, params?: Record<string, unknown>, registry?: PresetRegistry): Promise<ProtocolPresetMaterialization>;
+export {};