@morpho-org/evm-simulation 4.2.0 → 4.2.1

package/lib/cjs/errors.d.ts

@@ -19,11 +19,18 @@ interface RetainedAsset {
     token: string | undefined;
     netRetained: string;
 }
-/** Funds would flow to restricted standalone bundles contract addresses. Never bypassable. */
+/**
+ * Thrown when net value above the dust threshold is retained by a restricted bundles contract
+ * (VaultExitBundlesV1, VaultBundlesV1, BlueBundlesV1 or MidnightBundlesV1) after simulation;
+ * pass-through flows and net outflows are allowed. Never bypassable.
+ */
 export declare class BlacklistViolationError extends SimulationPackageError {
+    /** Per-asset net retained amounts keyed by restricted contract and token. */
     readonly assetChanges?: RetainedAsset[] | undefined;
     readonly code = "BLACKLIST_ERROR";
-    constructor(message: string, assetChanges?: RetainedAsset[] | undefined);
+    constructor(message: string, 
+    /** Per-asset net retained amounts keyed by restricted contract and token. */
+    assetChanges?: RetainedAsset[] | undefined);
 }
 /** Tenderly or RPC service is down. Bypassable — user can proceed. */
 export declare class ExternalServiceError extends SimulationPackageError {

package/lib/cjs/errors.js

@@ -24,11 +24,17 @@ class SimulationRevertedError extends SimulationPackageError {
     }
 }
 exports.SimulationRevertedError = SimulationRevertedError;
-/** Funds would flow to restricted standalone bundles contract addresses. Never bypassable. */
+/**
+ * Thrown when net value above the dust threshold is retained by a restricted bundles contract
+ * (VaultExitBundlesV1, VaultBundlesV1, BlueBundlesV1 or MidnightBundlesV1) after simulation;
+ * pass-through flows and net outflows are allowed. Never bypassable.
+ */
 class BlacklistViolationError extends SimulationPackageError {
     assetChanges;
     code = "BLACKLIST_ERROR";
-    constructor(message, assetChanges) {
+    constructor(message, 
+    /** Per-asset net retained amounts keyed by restricted contract and token. */
+    assetChanges) {
         super(message);
         this.assetChanges = assetChanges;
     }

package/lib/cjs/simulate/simulate.d.ts

@@ -7,7 +7,8 @@ import type { SimulateParams, SimulationConfig, SimulationResult } from "../type
  * budget → parses ERC20 transfers and WETH9 events from per-tx logs, restricting WETH9
  * events to the registered wrapped-native token, rejecting them on known tokenless chains,
  * and retaining signature-based parsing for unknown chains → asserts no funds are retained
- * by standalone `bundles` periphery contracts → returns the full result
+ * by the restricted standalone bundles contracts (VaultExitBundlesV1, VaultBundlesV1,
+ * BlueBundlesV1, MidnightBundlesV1) → returns the full result
  * set. The caller reads whichever fields they need:
  *
  * - `transfers` → user-facing preview / server-side verification.
@@ -35,7 +36,7 @@ import type { SimulateParams, SimulationConfig, SimulationResult } from "../type
  * @throws {SimulationRevertedError} when the bundle reverts on either backend.
  * @throws {BlacklistViolationError} when the simulation leaves value retained beyond
  *   the dust threshold by a `bundles` periphery contract (VaultExitBundlesV1,
- *   VaultBundlesV1, BlueBundlesV1). Never bypassable.
+ *   VaultBundlesV1, BlueBundlesV1, MidnightBundlesV1). Never bypassable.
  * @throws {ExternalServiceError} (a) when both backends are unavailable within the
  *   timeout budget, or (b) when a backend returns a `calls` array whose length does
  *   not match the resolved `simulationTxs` — refusing to map transfers with mismatched

package/lib/cjs/simulate/simulate.js

@@ -13,7 +13,8 @@ const index_js_2 = require("./pipeline/index.js");
  * budget → parses ERC20 transfers and WETH9 events from per-tx logs, restricting WETH9
  * events to the registered wrapped-native token, rejecting them on known tokenless chains,
  * and retaining signature-based parsing for unknown chains → asserts no funds are retained
- * by standalone `bundles` periphery contracts → returns the full result
+ * by the restricted standalone bundles contracts (VaultExitBundlesV1, VaultBundlesV1,
+ * BlueBundlesV1, MidnightBundlesV1) → returns the full result
  * set. The caller reads whichever fields they need:
  *
  * - `transfers` → user-facing preview / server-side verification.
@@ -41,7 +42,7 @@ const index_js_2 = require("./pipeline/index.js");
  * @throws {SimulationRevertedError} when the bundle reverts on either backend.
  * @throws {BlacklistViolationError} when the simulation leaves value retained beyond
  *   the dust threshold by a `bundles` periphery contract (VaultExitBundlesV1,
- *   VaultBundlesV1, BlueBundlesV1). Never bypassable.
+ *   VaultBundlesV1, BlueBundlesV1, MidnightBundlesV1). Never bypassable.
  * @throws {ExternalServiceError} (a) when both backends are unavailable within the
  *   timeout budget, or (b) when a backend returns a `calls` array whose length does
  *   not match the resolved `simulationTxs` — refusing to map transfers with mismatched

package/lib/esm/errors.d.ts

@@ -19,11 +19,18 @@ interface RetainedAsset {
     token: string | undefined;
     netRetained: string;
 }
-/** Funds would flow to restricted standalone bundles contract addresses. Never bypassable. */
+/**
+ * Thrown when net value above the dust threshold is retained by a restricted bundles contract
+ * (VaultExitBundlesV1, VaultBundlesV1, BlueBundlesV1 or MidnightBundlesV1) after simulation;
+ * pass-through flows and net outflows are allowed. Never bypassable.
+ */
 export declare class BlacklistViolationError extends SimulationPackageError {
+    /** Per-asset net retained amounts keyed by restricted contract and token. */
     readonly assetChanges?: RetainedAsset[] | undefined;
     readonly code = "BLACKLIST_ERROR";
-    constructor(message: string, assetChanges?: RetainedAsset[] | undefined);
+    constructor(message: string, 
+    /** Per-asset net retained amounts keyed by restricted contract and token. */
+    assetChanges?: RetainedAsset[] | undefined);
 }
 /** Tenderly or RPC service is down. Bypassable — user can proceed. */
 export declare class ExternalServiceError extends SimulationPackageError {

package/lib/esm/errors.js

@@ -19,11 +19,17 @@ export class SimulationRevertedError extends SimulationPackageError {
         this.details = details;
     }
 }
-/** Funds would flow to restricted standalone bundles contract addresses. Never bypassable. */
+/**
+ * Thrown when net value above the dust threshold is retained by a restricted bundles contract
+ * (VaultExitBundlesV1, VaultBundlesV1, BlueBundlesV1 or MidnightBundlesV1) after simulation;
+ * pass-through flows and net outflows are allowed. Never bypassable.
+ */
 export class BlacklistViolationError extends SimulationPackageError {
     assetChanges;
     code = "BLACKLIST_ERROR";
-    constructor(message, assetChanges) {
+    constructor(message, 
+    /** Per-asset net retained amounts keyed by restricted contract and token. */
+    assetChanges) {
         super(message);
         this.assetChanges = assetChanges;
     }

package/lib/esm/simulate/simulate.d.ts

@@ -7,7 +7,8 @@ import type { SimulateParams, SimulationConfig, SimulationResult } from "../type
  * budget → parses ERC20 transfers and WETH9 events from per-tx logs, restricting WETH9
  * events to the registered wrapped-native token, rejecting them on known tokenless chains,
  * and retaining signature-based parsing for unknown chains → asserts no funds are retained
- * by standalone `bundles` periphery contracts → returns the full result
+ * by the restricted standalone bundles contracts (VaultExitBundlesV1, VaultBundlesV1,
+ * BlueBundlesV1, MidnightBundlesV1) → returns the full result
  * set. The caller reads whichever fields they need:
  *
  * - `transfers` → user-facing preview / server-side verification.
@@ -35,7 +36,7 @@ import type { SimulateParams, SimulationConfig, SimulationResult } from "../type
  * @throws {SimulationRevertedError} when the bundle reverts on either backend.
  * @throws {BlacklistViolationError} when the simulation leaves value retained beyond
  *   the dust threshold by a `bundles` periphery contract (VaultExitBundlesV1,
- *   VaultBundlesV1, BlueBundlesV1). Never bypassable.
+ *   VaultBundlesV1, BlueBundlesV1, MidnightBundlesV1). Never bypassable.
  * @throws {ExternalServiceError} (a) when both backends are unavailable within the
  *   timeout budget, or (b) when a backend returns a `calls` array whose length does
  *   not match the resolved `simulationTxs` — refusing to map transfers with mismatched

package/lib/esm/simulate/simulate.js

@@ -10,7 +10,8 @@ import { assertNoBundlesRetention, buildSimulationTxs, executeSimulation, valida
  * budget → parses ERC20 transfers and WETH9 events from per-tx logs, restricting WETH9
  * events to the registered wrapped-native token, rejecting them on known tokenless chains,
  * and retaining signature-based parsing for unknown chains → asserts no funds are retained
- * by standalone `bundles` periphery contracts → returns the full result
+ * by the restricted standalone bundles contracts (VaultExitBundlesV1, VaultBundlesV1,
+ * BlueBundlesV1, MidnightBundlesV1) → returns the full result
  * set. The caller reads whichever fields they need:
  *
  * - `transfers` → user-facing preview / server-side verification.
@@ -38,7 +39,7 @@ import { assertNoBundlesRetention, buildSimulationTxs, executeSimulation, valida
  * @throws {SimulationRevertedError} when the bundle reverts on either backend.
  * @throws {BlacklistViolationError} when the simulation leaves value retained beyond
  *   the dust threshold by a `bundles` periphery contract (VaultExitBundlesV1,
- *   VaultBundlesV1, BlueBundlesV1). Never bypassable.
+ *   VaultBundlesV1, BlueBundlesV1, MidnightBundlesV1). Never bypassable.
  * @throws {ExternalServiceError} (a) when both backends are unavailable within the
  *   timeout budget, or (b) when a backend returns a `calls` array whose length does
  *   not match the resolved `simulationTxs` — refusing to map transfers with mismatched

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@morpho-org/evm-simulation",
   "description": "EVM simulation engine for Morpho transactions.",
-  "version": "4.2.0",
+  "version": "4.2.1",
   "author": "Morpho Association <contact@morpho.org>",
   "repository": {
     "type": "git",
@@ -22,8 +22,8 @@
   ],
   "dependencies": {
     "zod": "^4.4.3",
-    "@morpho-org/blue-sdk": "^7.0.0",
-    "@morpho-org/morpho-ts": "^3.0.0"
+    "@morpho-org/blue-sdk": "^7.1.0",
+    "@morpho-org/morpho-ts": "^3.1.0"
   },
   "peerDependencies": {
     "viem": "^2.0.0"