@morpho-org/evm-simulation 4.2.0 → 5.0.0

package/lib/cjs/simulate/authorizations/resolve.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveAuthorizations = resolveAuthorizations;
-const viem_1 = require("viem");
-/**
- * Resolve SimulationAuthorization[] into SimulationTransaction[].
- *
- * - "approval" → use authorization.transaction as-is
- * - "signature" → encode approve(spender, amount) on the token contract
- */
-function resolveAuthorizations(authorizations, sender) {
-    return authorizations.map((auth) => {
-        if (auth.type === "approval") {
-            return auth.transaction;
-        }
-        const amount = auth.amount ?? viem_1.maxUint256;
-        const data = (0, viem_1.encodeFunctionData)({
-            abi: viem_1.erc20Abi,
-            functionName: "approve",
-            args: [auth.spender, amount],
-        });
-        return {
-            from: sender,
-            to: auth.token,
-            data,
-            value: 0n,
-        };
-    });
-}

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

@@ -1,6 +0,0 @@
-import type { SimulationAuthorization } from "../../types.js";
-/**
- * Validate all signature authorizations have non-zero token and spender.
- * Returns an array of error strings (empty if valid).
- */
-export declare function validateAuthorizations(authorizations: SimulationAuthorization[]): string[];

package/lib/cjs/simulate/authorizations/validate.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateAuthorizations = validateAuthorizations;
-const viem_1 = require("viem");
-/**
- * Validate all signature authorizations have non-zero token and spender.
- * Returns an array of error strings (empty if valid).
- */
-function validateAuthorizations(authorizations) {
-    const errors = [];
-    for (let i = 0; i < authorizations.length; i++) {
-        const auth = authorizations[i];
-        if (auth.type === "signature") {
-            if (!auth.token || auth.token === viem_1.zeroAddress) {
-                errors.push(`authorizations[${i}]: signature authorization has zero-address token`);
-            }
-            if (!auth.spender || auth.spender === viem_1.zeroAddress) {
-                errors.push(`authorizations[${i}]: signature authorization has zero-address spender`);
-            }
-        }
-    }
-    return errors;
-}

package/lib/cjs/simulate/backends/tenderly-rpc.d.ts

@@ -1,23 +0,0 @@
-import { type BlockTag } from "viem";
-import type { RawSimulationResult, SimulationTransaction, TenderlyRpcConfig } from "../../types.js";
-/**
- * Simulate one or more transactions via Tenderly's Node Web3 Gateway.
- * Dispatches to `tenderly_simulateTransaction` for a single call and
- * `tenderly_simulateBundle` for a multi-call bundle.
- *
- * @param params.config - Tenderly RPC config (URL with access key embedded).
- * @param params.transactions - Bundle to simulate, in execution order.
- * @param params.blockNumber - Optional pinned block number or `BlockTag`. Defaults to `latest`.
- * @param params.signal - Optional `AbortSignal` for cancellation / timeout.
- * @returns A {@link RawSimulationResult} with one `RawCall` per input transaction.
- * @throws {SimulationValidationError} when `transactions` is empty.
- * @throws {SimulationRevertedError} when any simulated tx reports `status: false`.
- * @throws {ExternalServiceError} on non-2xx response, JSON-RPC envelope error,
- *   schema-validation failure, or fetch-layer failure.
- */
-export declare function simulateTenderlyRpc(params: {
-    config: TenderlyRpcConfig;
-    transactions: SimulationTransaction[];
-    blockNumber?: bigint | BlockTag;
-    signal?: AbortSignal;
-}): Promise<RawSimulationResult>;

package/lib/cjs/simulate/backends/tenderly-rpc.js

@@ -1,234 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.simulateTenderlyRpc = simulateTenderlyRpc;
-const viem_1 = require("viem");
-const zod_1 = require("zod");
-const errors_js_1 = require("../../errors.js");
-const asset_changes_js_1 = require("../asset-changes.js");
-const addressSchema = zod_1.z.custom((val) => typeof val === "string" && (0, viem_1.isAddress)(val));
-const hexSchema = zod_1.z.custom((val) => typeof val === "string" && (0, viem_1.isHex)(val));
-const traceFrameSchema = zod_1.z
-    .object({
-    output: hexSchema.optional(),
-    error: zod_1.z.string().optional(),
-    errorReason: zod_1.z.string().optional(),
-})
-    .passthrough();
-const logSchema = zod_1.z
-    .object({
-    raw: zod_1.z
-        .object({
-        address: addressSchema,
-        topics: zod_1.z.array(hexSchema).optional(),
-        data: hexSchema.optional(),
-    })
-        .passthrough()
-        .optional(),
-})
-    .passthrough();
-const assetChangeSchema = zod_1.z
-    .object({
-    assetInfo: zod_1.z
-        .object({
-        contractAddress: addressSchema.optional(),
-        symbol: zod_1.z.string().optional(),
-        decimals: zod_1.z.number().optional(),
-    })
-        .passthrough(),
-    from: addressSchema.optional(),
-    to: addressSchema.optional(),
-    rawAmount: hexSchema,
-})
-    .passthrough();
-const simResultSchema = zod_1.z
-    .object({
-    status: zod_1.z.boolean(),
-    gasUsed: hexSchema,
-    logs: zod_1.z.array(logSchema).optional(),
-    trace: zod_1.z.array(traceFrameSchema).optional(),
-    assetChanges: zod_1.z.array(assetChangeSchema).optional(),
-    error: zod_1.z.string().optional(),
-    errorMessage: zod_1.z.string().optional(),
-})
-    .passthrough();
-const rpcErrorSchema = zod_1.z
-    .object({
-    code: zod_1.z.number().optional(),
-    message: zod_1.z.string(),
-    data: zod_1.z.unknown().optional(),
-})
-    .passthrough();
-function rpcEnvelope(result) {
-    return zod_1.z
-        .object({ result: result.optional(), error: rpcErrorSchema.optional() })
-        .passthrough();
-}
-const singleEnvelope = rpcEnvelope(simResultSchema);
-const bundleEnvelope = rpcEnvelope(zod_1.z.array(simResultSchema).min(1));
-/**
- * Simulate one or more transactions via Tenderly's Node Web3 Gateway.
- * Dispatches to `tenderly_simulateTransaction` for a single call and
- * `tenderly_simulateBundle` for a multi-call bundle.
- *
- * @param params.config - Tenderly RPC config (URL with access key embedded).
- * @param params.transactions - Bundle to simulate, in execution order.
- * @param params.blockNumber - Optional pinned block number or `BlockTag`. Defaults to `latest`.
- * @param params.signal - Optional `AbortSignal` for cancellation / timeout.
- * @returns A {@link RawSimulationResult} with one `RawCall` per input transaction.
- * @throws {SimulationValidationError} when `transactions` is empty.
- * @throws {SimulationRevertedError} when any simulated tx reports `status: false`.
- * @throws {ExternalServiceError} on non-2xx response, JSON-RPC envelope error,
- *   schema-validation failure, or fetch-layer failure.
- */
-async function simulateTenderlyRpc(params) {
-    const { config, transactions, blockNumber, signal } = params;
-    const firstTx = transactions[0];
-    if (!firstTx) {
-        throw new errors_js_1.SimulationValidationError("At least one transaction is required", []);
-    }
-    const block = encodeBlock(blockNumber);
-    // Inflate sender ETH balance to avoid false "insufficient funds for gas"
-    // reverts on wallets low on native gas token — mirrors simulateV1.
-    const stateOverrides = buildStateOverrides(firstTx.from);
-    try {
-        if (transactions.length === 1) {
-            const json = await rpcRequest({
-                rpcUrl: config.rpcUrl,
-                method: "tenderly_simulateTransaction",
-                params: [buildCall(firstTx), block, stateOverrides],
-                signal,
-            });
-            const result = unwrapResult(singleEnvelope.parse(json));
-            return {
-                calls: [toRawCall(result)],
-                assetChanges: toAssetChanges([result]),
-            };
-        }
-        const json = await rpcRequest({
-            rpcUrl: config.rpcUrl,
-            method: "tenderly_simulateBundle",
-            params: [transactions.map(buildCall), block, stateOverrides],
-            signal,
-        });
-        const results = unwrapResult(bundleEnvelope.parse(json));
-        return {
-            calls: results.map(toRawCall),
-            assetChanges: toAssetChanges(results),
-        };
-    }
-    catch (error) {
-        if (error instanceof errors_js_1.SimulationRevertedError)
-            throw error;
-        if (error instanceof errors_js_1.ExternalServiceError)
-            throw error;
-        throw new errors_js_1.ExternalServiceError(`Tenderly RPC error: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-    }
-}
-async function rpcRequest(params) {
-    const { rpcUrl, method, params: rpcParams, signal } = params;
-    const response = await fetch(rpcUrl, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ jsonrpc: "2.0", id: 1, method, params: rpcParams }),
-        signal,
-    });
-    if (!response.ok) {
-        throw new errors_js_1.ExternalServiceError(`Tenderly RPC returned ${response.status}: ${response.statusText}`);
-    }
-    return await response.json();
-}
-function unwrapResult(envelope) {
-    if (envelope.error) {
-        throw new errors_js_1.ExternalServiceError(`Tenderly RPC error: ${envelope.error.message}`);
-    }
-    if (envelope.result === undefined) {
-        throw new errors_js_1.ExternalServiceError("Tenderly RPC returned no result");
-    }
-    return envelope.result;
-}
-function buildCall(tx) {
-    return {
-        from: tx.from,
-        to: tx.to,
-        input: tx.data,
-        data: tx.data,
-        value: (0, viem_1.numberToHex)(tx.value ?? 0n),
-    };
-}
-function buildStateOverrides(sender) {
-    // Half of uint256 (not the ceiling) so the override leaves headroom for
-    // inbound native ETH — a WETH.withdraw refund or swap payout would overflow
-    // the recipient balance and revert the value transfer if the sender were
-    // pinned at maxUint256.
-    return { [sender]: { balance: (0, viem_1.numberToHex)(viem_1.maxUint256 / 2n) } };
-}
-function encodeBlock(blockNumber) {
-    if (blockNumber === undefined)
-        return "latest";
-    return typeof blockNumber === "bigint"
-        ? (0, viem_1.numberToHex)(blockNumber)
-        : blockNumber;
-}
-function toRawCall(data) {
-    if (data.status !== true) {
-        // Tenderly RPC surfaces the revert reason on the trace frame; the
-        // top-level fields are checked as a defensive fallback.
-        const traceError = data.trace?.find((f) => f.errorReason || f.error);
-        const message = traceError?.errorReason ||
-            traceError?.error ||
-            data.errorMessage ||
-            data.error ||
-            "Transaction simulation reverted";
-        throw new errors_js_1.SimulationRevertedError(message, data);
-    }
-    const logs = [];
-    for (const log of data.logs ?? []) {
-        if (log.raw) {
-            logs.push({
-                address: log.raw.address,
-                topics: log.raw.topics ?? [],
-                data: log.raw.data ?? "0x",
-            });
-        }
-    }
-    return {
-        logs,
-        status: true,
-        returnData: data.trace?.[0]?.output ?? "0x",
-        gasUsed: BigInt(data.gasUsed),
-    };
-}
-/**
- * Reduce Tenderly's per-transfer asset changes to net per-token balance changes
- * grouped by account. Both endpoints of each transfer are accounted (sender,
- * counterparties, and the zero address for mints/burns).
- */
-function toAssetChanges(results) {
-    const entries = [];
-    for (const result of results) {
-        for (const change of result.assetChanges ?? []) {
-            const amount = BigInt(change.rawAmount);
-            const token = change.assetInfo.contractAddress
-                ? (0, asset_changes_js_1.normalizeAssetToken)(change.assetInfo.contractAddress)
-                : viem_1.ethAddress;
-            const { symbol, decimals } = change.assetInfo;
-            if (change.to)
-                entries.push({
-                    account: change.to,
-                    token,
-                    diff: amount,
-                    symbol,
-                    decimals,
-                });
-            if (change.from)
-                entries.push({
-                    account: change.from,
-                    token,
-                    diff: -amount,
-                    symbol,
-                    decimals,
-                });
-        }
-    }
-    return (0, asset_changes_js_1.groupAssetChanges)(entries);
-}

package/lib/cjs/simulate/pipeline/build-simulation-txs.d.ts

@@ -1,17 +0,0 @@
-import type { SimulateParams, SimulationTransaction } from "../../types.js";
-/**
- * Stage 3 of the simulate() pipeline.
- *
- * Prepends any resolved authorizations (e.g. ERC20 `approve` calls generated from
- * `{ type: 'signature' }` entries) to the user's transactions. If no authorizations
- * were supplied, returns the user's transactions unchanged.
- *
- * Defense-in-depth: after prepending, verifies EVERY resolved tx shares the user
- * sender. This catches an `{ type: 'approval', transaction }` auth where the
- * caller-provided `transaction.from` does not match the bundle sender — the
- * `approval` variant otherwise passes through without validation. Rejecting here
- * keeps the "all simulationTxs share one `from`" invariant the downstream
- * backends (eth_simulateV1) assume, and prevents a malicious or buggy caller
- * from prepending a tx on behalf of an unexpected address.
- */
-export declare function buildSimulationTxs(params: SimulateParams): SimulationTransaction[];

package/lib/cjs/simulate/pipeline/build-simulation-txs.js

@@ -1,50 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildSimulationTxs = buildSimulationTxs;
-const viem_1 = require("viem");
-const errors_js_1 = require("../../errors.js");
-const index_js_1 = require("../authorizations/index.js");
-/**
- * Stage 3 of the simulate() pipeline.
- *
- * Prepends any resolved authorizations (e.g. ERC20 `approve` calls generated from
- * `{ type: 'signature' }` entries) to the user's transactions. If no authorizations
- * were supplied, returns the user's transactions unchanged.
- *
- * Defense-in-depth: after prepending, verifies EVERY resolved tx shares the user
- * sender. This catches an `{ type: 'approval', transaction }` auth where the
- * caller-provided `transaction.from` does not match the bundle sender — the
- * `approval` variant otherwise passes through without validation. Rejecting here
- * keeps the "all simulationTxs share one `from`" invariant the downstream
- * backends (eth_simulateV1) assume, and prevents a malicious or buggy caller
- * from prepending a tx on behalf of an unexpected address.
- */
-function buildSimulationTxs(params) {
-    const { transactions, authorizations } = params;
-    if (!authorizations || authorizations.length === 0) {
-        return transactions;
-    }
-    const sender = transactions[0].from;
-    const resolved = (0, index_js_1.resolveAuthorizations)(authorizations, sender);
-    const simulationTxs = [...resolved, ...transactions];
-    const senderChecksum = (0, viem_1.getAddress)(sender);
-    const mismatches = [];
-    for (let i = 0; i < simulationTxs.length; i++) {
-        const tx = simulationTxs[i];
-        let txFromChecksum;
-        try {
-            txFromChecksum = (0, viem_1.getAddress)(tx.from);
-        }
-        catch {
-            mismatches.push(`simulationTxs[${i}].from: not a valid address (${tx.from})`);
-            continue;
-        }
-        if (txFromChecksum !== senderChecksum) {
-            mismatches.push(`simulationTxs[${i}].from: expected ${senderChecksum}, got ${txFromChecksum}`);
-        }
-    }
-    if (mismatches.length > 0) {
-        throw new errors_js_1.SimulationValidationError("Authorization transaction(s) must share the user sender", mismatches);
-    }
-    return simulationTxs;
-}

package/lib/cjs/simulate/pipeline/execute-simulation.d.ts

@@ -1,22 +0,0 @@
-import type { Address, BlockTag } from "viem";
-import type { RawSimulationResult, SimulationConfig, SimulationTransaction } from "../../types.js";
-/**
- * Stage 4 of the simulate() pipeline.
- *
- * Dispatches the transaction bundle to the available backend with a shared timeout
- * budget:
- * - If a Tenderly RPC URL is configured for the chain, it gets
- *   `TENDERLY_BUDGET_RATIO` (60%) of the timeout. On `ExternalServiceError`,
- *   falls back to `eth_simulateV1` with `max(remaining, FALLBACK_MIN_BUDGET_MS)`
- *   so the fallback still has a viable window when Tenderly eats its full slice.
- *   `SimulationRevertedError` (contract revert) propagates immediately without
- *   retry — a revert is a property of the bundle, not the backend.
- * - If only `eth_simulateV1` is configured, it gets the full timeout.
- */
-export declare function executeSimulation(params: {
-    config: SimulationConfig;
-    chainId: number;
-    transactions: SimulationTransaction[];
-    blockNumber?: bigint | BlockTag;
-    wNative?: Address | null;
-}): Promise<RawSimulationResult>;

package/lib/cjs/simulate/pipeline/execute-simulation.js

@@ -1,82 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.executeSimulation = executeSimulation;
-const errors_js_1 = require("../../errors.js");
-const index_js_1 = require("../backends/index.js");
-const resolve_chain_js_1 = require("./resolve-chain.js");
-/** Total budget for a single `simulate()` call across both backends. */
-const DEFAULT_TIMEOUT_MS = 5000;
-/** Fraction of `timeoutMs` given to Tenderly before falling back to `eth_simulateV1`. */
-const TENDERLY_BUDGET_RATIO = 0.6;
-/**
- * Minimum budget (ms) handed to the `eth_simulateV1` fallback when Tenderly fails.
- *
- * Without a floor, if Tenderly exhausts its slice and dies at the deadline, the
- * fallback would get ~0 ms and abort immediately — turning a degraded-Tenderly
- * scenario into a total outage even when the fallback backend is healthy. A
- * modest floor keeps the fallback viable at the cost of the overall
- * `timeoutMs` being treated as a soft ceiling.
- */
-const FALLBACK_MIN_BUDGET_MS = 1500;
-/**
- * Stage 4 of the simulate() pipeline.
- *
- * Dispatches the transaction bundle to the available backend with a shared timeout
- * budget:
- * - If a Tenderly RPC URL is configured for the chain, it gets
- *   `TENDERLY_BUDGET_RATIO` (60%) of the timeout. On `ExternalServiceError`,
- *   falls back to `eth_simulateV1` with `max(remaining, FALLBACK_MIN_BUDGET_MS)`
- *   so the fallback still has a viable window when Tenderly eats its full slice.
- *   `SimulationRevertedError` (contract revert) propagates immediately without
- *   retry — a revert is a property of the bundle, not the backend.
- * - If only `eth_simulateV1` is configured, it gets the full timeout.
- */
-async function executeSimulation(params) {
-    const { config, chainId, transactions, blockNumber, wNative } = params;
-    const chain = (0, resolve_chain_js_1.resolveChain)(config, chainId);
-    const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-    const deadline = Date.now() + timeoutMs;
-    if (chain.tenderlyRpc) {
-        const tenderlyTimeout = Math.floor(timeoutMs * TENDERLY_BUDGET_RATIO);
-        try {
-            return await (0, index_js_1.simulateTenderlyRpc)({
-                config: chain.tenderlyRpc,
-                transactions,
-                blockNumber,
-                signal: AbortSignal.timeout(tenderlyTimeout),
-            });
-        }
-        catch (error) {
-            if (!(error instanceof errors_js_1.ExternalServiceError))
-                throw error;
-            config.logger?.warn("Tenderly simulation failed, attempting fallback", {
-                chainId,
-                error: error.message,
-                cause: error.cause,
-            });
-            if (!chain.simulateV1Url)
-                throw error;
-            const fallbackBudget = Math.max(deadline - Date.now(), FALLBACK_MIN_BUDGET_MS);
-            return await (0, index_js_1.simulateV1)({
-                rpcUrl: chain.simulateV1Url,
-                chainId,
-                transactions,
-                blockNumber,
-                wNative,
-                signal: AbortSignal.timeout(fallbackBudget),
-            });
-        }
-    }
-    /* v8 ignore next: resolveChain rejects this state before executeSimulation reaches the fallback path. */
-    if (!chain.simulateV1Url) {
-        throw new errors_js_1.UnsupportedChainError(chainId);
-    }
-    return await (0, index_js_1.simulateV1)({
-        rpcUrl: chain.simulateV1Url,
-        chainId,
-        transactions,
-        blockNumber,
-        wNative,
-        signal: AbortSignal.timeout(timeoutMs),
-    });
-}

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

@@ -1,4 +0,0 @@
-export { buildSimulationTxs } from "./build-simulation-txs.js";
-export { assertNoBundlesRetention } from "./bundles-retention.js";
-export { executeSimulation } from "./execute-simulation.js";
-export { validateInput } from "./validate-input.js";

package/lib/cjs/simulate/pipeline/index.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateInput = exports.executeSimulation = exports.assertNoBundlesRetention = exports.buildSimulationTxs = void 0;
-var build_simulation_txs_js_1 = require("./build-simulation-txs.js");
-Object.defineProperty(exports, "buildSimulationTxs", { enumerable: true, get: function () { return build_simulation_txs_js_1.buildSimulationTxs; } });
-var bundles_retention_js_1 = require("./bundles-retention.js");
-Object.defineProperty(exports, "assertNoBundlesRetention", { enumerable: true, get: function () { return bundles_retention_js_1.assertNoBundlesRetention; } });
-var execute_simulation_js_1 = require("./execute-simulation.js");
-Object.defineProperty(exports, "executeSimulation", { enumerable: true, get: function () { return execute_simulation_js_1.executeSimulation; } });
-var validate_input_js_1 = require("./validate-input.js");
-Object.defineProperty(exports, "validateInput", { enumerable: true, get: function () { return validate_input_js_1.validateInput; } });

package/lib/cjs/simulate/pipeline/validate-input.d.ts

@@ -1,10 +0,0 @@
-import type { SimulateParams } from "../../types.js";
-/**
- * Stage 1 of the simulate() pipeline.
- *
- * Throws `SimulationValidationError` with a `fieldErrors[]` list on any invalid input:
- * empty transactions, malformed / zero-addr fields, missing `data`, negative `value`,
- * bad `chainId`, or mixed senders (all txs in a bundle must share the same `from`).
- * Also runs `validateAuthorizations` on the optional authorizations array.
- */
-export declare function validateInput(params: SimulateParams): void;

package/lib/cjs/simulate/pipeline/validate-input.js

@@ -1,55 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateInput = validateInput;
-const viem_1 = require("viem");
-const errors_js_1 = require("../../errors.js");
-const index_js_1 = require("../authorizations/index.js");
-/**
- * Stage 1 of the simulate() pipeline.
- *
- * Throws `SimulationValidationError` with a `fieldErrors[]` list on any invalid input:
- * empty transactions, malformed / zero-addr fields, missing `data`, negative `value`,
- * bad `chainId`, or mixed senders (all txs in a bundle must share the same `from`).
- * Also runs `validateAuthorizations` on the optional authorizations array.
- */
-function validateInput(params) {
-    const errors = [];
-    if (!Number.isInteger(params.chainId) || params.chainId <= 0) {
-        errors.push(`chainId: must be a positive integer (got ${params.chainId})`);
-    }
-    const transactions = params.transactions ?? [];
-    if (transactions.length === 0) {
-        errors.push("transactions: must contain at least 1 transaction");
-    }
-    for (let i = 0; i < transactions.length; i++) {
-        const tx = transactions[i];
-        if (!tx.from || !(0, viem_1.isAddress)(tx.from) || tx.from === viem_1.zeroAddress) {
-            errors.push(`transactions[${i}].from: must be a valid non-zero address`);
-        }
-        if (!tx.to || !(0, viem_1.isAddress)(tx.to) || tx.to === viem_1.zeroAddress) {
-            errors.push(`transactions[${i}].to: must be a valid non-zero address`);
-        }
-        if (!tx.data) {
-            errors.push(`transactions[${i}].data: must be provided`);
-        }
-        if (tx.value !== undefined && tx.value < 0n) {
-            errors.push(`transactions[${i}].value: must be non-negative`);
-        }
-    }
-    // Same-sender check uses RAW `.from` strings (lowercased) so the invariant
-    // fires even when some tx `from`s are malformed — individual txs already
-    // flagged above, but we still want one loud signal that the bundle's
-    // senders don't match.
-    if (transactions.length > 1) {
-        const distinct = new Set(transactions.map((tx) => (tx.from ?? "").toLowerCase()));
-        if (distinct.size > 1) {
-            errors.push("transactions: all transactions must share the same from address");
-        }
-    }
-    if (params.authorizations) {
-        errors.push(...(0, index_js_1.validateAuthorizations)(params.authorizations));
-    }
-    if (errors.length > 0) {
-        throw new errors_js_1.SimulationValidationError("Invalid simulation input", errors);
-    }
-}

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

@@ -1,2 +0,0 @@
-export { resolveAuthorizations } from "./resolve.js";
-export { validateAuthorizations } from "./validate.js";

package/lib/esm/simulate/authorizations/index.js

@@ -1,2 +0,0 @@
-export { resolveAuthorizations } from "./resolve.js";
-export { validateAuthorizations } from "./validate.js";

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

@@ -1,9 +0,0 @@
-import { type Address } from "viem";
-import type { SimulationAuthorization, SimulationTransaction } from "../../types.js";
-/**
- * Resolve SimulationAuthorization[] into SimulationTransaction[].
- *
- * - "approval" → use authorization.transaction as-is
- * - "signature" → encode approve(spender, amount) on the token contract
- */
-export declare function resolveAuthorizations(authorizations: SimulationAuthorization[], sender: Address): SimulationTransaction[];

package/lib/esm/simulate/authorizations/resolve.js

@@ -1,26 +0,0 @@
-import { encodeFunctionData, erc20Abi, maxUint256 } from "viem";
-/**
- * Resolve SimulationAuthorization[] into SimulationTransaction[].
- *
- * - "approval" → use authorization.transaction as-is
- * - "signature" → encode approve(spender, amount) on the token contract
- */
-export function resolveAuthorizations(authorizations, sender) {
-    return authorizations.map((auth) => {
-        if (auth.type === "approval") {
-            return auth.transaction;
-        }
-        const amount = auth.amount ?? maxUint256;
-        const data = encodeFunctionData({
-            abi: erc20Abi,
-            functionName: "approve",
-            args: [auth.spender, amount],
-        });
-        return {
-            from: sender,
-            to: auth.token,
-            data,
-            value: 0n,
-        };
-    });
-}

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

@@ -1,6 +0,0 @@
-import type { SimulationAuthorization } from "../../types.js";
-/**
- * Validate all signature authorizations have non-zero token and spender.
- * Returns an array of error strings (empty if valid).
- */
-export declare function validateAuthorizations(authorizations: SimulationAuthorization[]): string[];

package/lib/esm/simulate/authorizations/validate.js

@@ -1,20 +0,0 @@
-import { zeroAddress } from "viem";
-/**
- * Validate all signature authorizations have non-zero token and spender.
- * Returns an array of error strings (empty if valid).
- */
-export function validateAuthorizations(authorizations) {
-    const errors = [];
-    for (let i = 0; i < authorizations.length; i++) {
-        const auth = authorizations[i];
-        if (auth.type === "signature") {
-            if (!auth.token || auth.token === zeroAddress) {
-                errors.push(`authorizations[${i}]: signature authorization has zero-address token`);
-            }
-            if (!auth.spender || auth.spender === zeroAddress) {
-                errors.push(`authorizations[${i}]: signature authorization has zero-address spender`);
-            }
-        }
-    }
-    return errors;
-}