@seljs/runtime 1.0.0 → 1.0.1

package/dist/environment/error-wrapper.js

@@ -1,33 +0,0 @@
-import { TypeError as CelTypeError, EvaluationError, ParseError, } from "@marcbachmann/cel-js";
-import { SELContractError, SELEvaluationError, SELParseError, SELTypeError, } from "../errors/index.js";
-/**
- * Wraps an unknown error into a known SEL error type.
- * - If the error is already a SEL error, it is returned as is.
- * - If the error is a CEL error, it is wrapped into the corresponding SEL error type.
- * - If the error is an unknown type, it is wrapped into a generic Error.
- *
- * @param error The error to wrap.
- * @returns The wrapped error.
- */
-export const wrapError = (error) => {
-    if (error instanceof SELContractError) {
-        return error;
-    }
-    if (error instanceof ParseError) {
-        return new SELParseError(error.message, { cause: error });
-    }
-    if (error instanceof EvaluationError) {
-        const cause = error.cause;
-        if (cause instanceof SELContractError) {
-            return cause;
-        }
-        return new SELEvaluationError(error.message, { cause: error });
-    }
-    if (error instanceof CelTypeError) {
-        return new SELTypeError(error.message, { cause: error });
-    }
-    if (error instanceof Error) {
-        return error;
-    }
-    return new Error(String(error));
-};

package/dist/environment/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./environment.js";
-export * from "./types.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/environment/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/environment/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC"}

package/dist/environment/index.js

@@ -1,2 +0,0 @@
-export * from "./environment.js";
-export * from "./types.js";

package/dist/environment/replay-cache.d.ts

@@ -1,23 +0,0 @@
-import type { CollectedCall } from "../analysis/types.js";
-import type { CelCodecRegistry } from "@seljs/checker";
-/**
- * Builds a replay cache that maps unique identifiers for contract calls to their results.
- * This allows for efficient retrieval of results during execution replay, ensuring that the same inputs yield the same outputs without needing to re-execute the calls.
- *
- * @param calls An array of collected contract calls, each containing information about the contract, method, arguments, and dependencies.
- * @param results A map of call IDs to their corresponding results, which will be used to resolve arguments that depend on previous calls.
- * @param variables A record of variable names to their values, which will be used to resolve arguments that depend on variables.
- */
-export declare const buildExecutionReplayCache: (calls: CollectedCall[], results: Map<string, unknown>, variables: Record<string, unknown>, codecRegistry: CelCodecRegistry, getParamTypes: (contract: string, method: string) => string[]) => Map<string, unknown>;
-/**
- * Creates a unique identifier for a contract call based on contract name,
- * method, and arguments.
- *
- * IMPORTANT: Args must be pre-encoded via codecRegistry.encode() before
- * calling this function. The encode step normalizes types (e.g., sol_int
- * always produces bigint, sol_address always produces string), which
- * prevents type collisions in String() serialization. If args are NOT
- * pre-encoded, String(42n) === String(42) would cause cache key collisions.
- */
-export declare const createReplayCallId: (contract: string, method: string, args: unknown[]) => string;
-//# sourceMappingURL=replay-cache.d.ts.map

package/dist/environment/replay-cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"replay-cache.d.ts","sourceRoot":"","sources":["../../src/environment/replay-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAiCvD;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,GACrC,OAAO,aAAa,EAAE,EACtB,SAAS,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,eAAe,gBAAgB,EAC/B,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,EAAE,KAE3D,GAAG,CAAC,MAAM,EAAE,OAAO,CAsBrB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC9B,UAAU,MAAM,EAChB,QAAQ,MAAM,EACd,MAAM,OAAO,EAAE,KACb,MAIF,CAAC"}

package/dist/environment/replay-cache.js

@@ -1,51 +0,0 @@
-const resolveReplayArgs = (args, variables, results, paramTypes, codecRegistry) => args.map((arg, i) => {
-    const celType = paramTypes[i] ?? "dyn";
-    if (arg.type === "literal") {
-        return codecRegistry.encode(celType, arg.value);
-    }
-    if (arg.type === "variable") {
-        const name = arg.variableName;
-        if (!name) {
-            return undefined;
-        }
-        return codecRegistry.encode(celType, variables[name]);
-    }
-    const id = arg.dependsOnCallId;
-    if (!id) {
-        return undefined;
-    }
-    return codecRegistry.encode(celType, results.get(id));
-});
-/**
- * Builds a replay cache that maps unique identifiers for contract calls to their results.
- * This allows for efficient retrieval of results during execution replay, ensuring that the same inputs yield the same outputs without needing to re-execute the calls.
- *
- * @param calls An array of collected contract calls, each containing information about the contract, method, arguments, and dependencies.
- * @param results A map of call IDs to their corresponding results, which will be used to resolve arguments that depend on previous calls.
- * @param variables A record of variable names to their values, which will be used to resolve arguments that depend on variables.
- */
-export const buildExecutionReplayCache = (calls, results, variables, codecRegistry, getParamTypes) => {
-    const replayCache = new Map();
-    for (const call of calls) {
-        const result = results.get(call.id);
-        const paramTypes = getParamTypes(call.contract, call.method);
-        const resolvedArgs = resolveReplayArgs(call.args, variables, results, paramTypes, codecRegistry);
-        const replayCallId = createReplayCallId(call.contract, call.method, resolvedArgs);
-        replayCache.set(replayCallId, result);
-    }
-    return replayCache;
-};
-/**
- * Creates a unique identifier for a contract call based on contract name,
- * method, and arguments.
- *
- * IMPORTANT: Args must be pre-encoded via codecRegistry.encode() before
- * calling this function. The encode step normalizes types (e.g., sol_int
- * always produces bigint, sol_address always produces string), which
- * prevents type collisions in String() serialization. If args are NOT
- * pre-encoded, String(42n) === String(42) would cause cache key collisions.
- */
-export const createReplayCallId = (contract, method, args) => {
-    const argKey = args.map((arg) => String(arg)).join(",");
-    return `${contract}:${method}:${argKey}`;
-};

package/dist/environment/types.d.ts

@@ -1,57 +0,0 @@
-import type { SELSchema } from "@seljs/schema";
-import type { Address, PublicClient } from "viem";
-/**
- * Options for multicall3 batching of contract calls.
- *
- * When multiple independent contract calls are executed in the same round,
- * they are batched into a single multicall3 RPC request for efficiency.
- */
-export interface MulticallOptions {
-    /** Maximum number of calls per multicall3 batch. Unbounded if omitted. */
-    batchSize?: number;
-    /** Custom multicall3 contract address. Defaults to the canonical deployment. */
-    address?: Address;
-}
-/**
- * Limits for expression parsing and contract call execution.
- *
- * AST limits (`maxAstNodes`, `maxDepth`, `maxListElements`, `maxMapEntries`,
- * `maxCallArguments`) are forwarded to the underlying CEL parser to constrain
- * expression complexity.
- *
- * Execution limits (`maxRounds`, `maxCalls`) bound the multi-round contract
- * execution engine. An {@link ExecutionLimitError} is thrown when exceeded.
- */
-export interface SELLimits {
-    /** Maximum number of AST nodes allowed in a parsed expression */
-    maxAstNodes?: number;
-    /** Maximum nesting depth of the AST */
-    maxDepth?: number;
-    /** Maximum number of elements in a list literal */
-    maxListElements?: number;
-    /** Maximum number of entries in a map literal */
-    maxMapEntries?: number;
-    /** Maximum number of arguments in a single function call */
-    maxCallArguments?: number;
-    /** Maximum number of dependency-ordered execution rounds (default: 10) */
-    maxRounds?: number;
-    /** Maximum total number of contract calls across all rounds (default: 100) */
-    maxCalls?: number;
-}
-/**
- * Configuration for creating an immutable {@link SELRuntime}.
- *
- * All contracts and context must be declared here — the environment
- * cannot be mutated after construction.
- */
-export interface SELRuntimeConfig {
-    /** SEL schema describing contracts, variables, types, functions, and macros */
-    schema: SELSchema;
-    /** Viem public client for executing on-chain contract reads */
-    client?: PublicClient;
-    /** Multicall3 batching options for contract call execution */
-    multicall?: MulticallOptions;
-    /** AST parsing and execution limits */
-    limits?: SELLimits;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/environment/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/environment/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAChC,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACzB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAChC,+EAA+E;IAC/E,MAAM,EAAE,SAAS,CAAC;IAElB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B,uCAAuC;IACvC,MAAM,CAAC,EAAE,SAAS,CAAC;CACnB"}

package/dist/environment/types.js

@@ -1 +0,0 @@
-export {};

package/dist/errors/errors.d.ts

@@ -1,63 +0,0 @@
-import { SELError, SELParseError, SELTypeError } from "@seljs/common";
-export { SELError, SELParseError, SELTypeError };
-/**
- * Thrown when CEL expression evaluation fails.
- * Wraps cel-js EvaluationError with additional context.
- */
-export declare class SELEvaluationError extends SELError {
-}
-/**
- * Thrown when contract validation or execution fails.
- * Includes optional contract name and method name for context.
- */
-export declare class SELContractError extends SELError {
-    readonly contractName?: string;
-    readonly methodName?: string;
-    constructor(message: string, options?: {
-        cause?: unknown;
-        contractName?: string;
-        methodName?: string;
-    });
-}
-/**
- * Thrown when a circular dependency is detected in the call dependency graph.
- * Indicates that call A depends on call B which depends on call A (directly or transitively).
- */
-export declare class CircularDependencyError extends SELError {
-    readonly callIds: string[];
-    constructor(message: string, options?: {
-        cause?: unknown;
-        callIds?: string[];
-    });
-}
-/**
- * Thrown when execution limits are exceeded (maxRounds or maxCalls).
- * Prevents infinite loops and runaway execution.
- */
-export declare class ExecutionLimitError extends SELError {
-    readonly limitType: "maxRounds" | "maxCalls";
-    readonly limit: number;
-    readonly actual: number;
-    constructor(message: string, options?: {
-        cause?: unknown;
-        limitType?: "maxRounds" | "maxCalls";
-        limit?: number;
-        actual?: number;
-    });
-}
-/**
- * Thrown when a Multicall3 batch execution fails.
- * Includes the failed call index and optional contract name/method name for context.
- */
-export declare class MulticallBatchError extends SELError {
-    readonly failedCallIndex?: number;
-    readonly contractName?: string;
-    readonly methodName?: string;
-    constructor(message: string, options?: {
-        cause?: unknown;
-        failedCallIndex?: number;
-        contractName?: string;
-        methodName?: string;
-    });
-}
-//# sourceMappingURL=errors.d.ts.map

package/dist/errors/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGtE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;AAEjD;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;CAAG;AAEnD;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;IAC7C,SAAgB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGnC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAM1E;AAED;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,QAAQ;IACpD,SAAgB,OAAO,EAAE,MAAM,EAAE,CAAC;gBAGjC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;CAKlD;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IAChD,SAAgB,SAAS,EAAE,WAAW,GAAG,UAAU,CAAC;IACpD,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAG9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,SAAS,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;QACrC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB;CAOF;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IAChD,SAAgB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzC,SAAgB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGnC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACpB;CAOF"}

package/dist/errors/errors.js

@@ -1,63 +0,0 @@
-import { SELError, SELParseError, SELTypeError } from "@seljs/common";
-// Re-export shared errors from @seljs/common
-export { SELError, SELParseError, SELTypeError };
-/**
- * Thrown when CEL expression evaluation fails.
- * Wraps cel-js EvaluationError with additional context.
- */
-export class SELEvaluationError extends SELError {
-}
-/**
- * Thrown when contract validation or execution fails.
- * Includes optional contract name and method name for context.
- */
-export class SELContractError extends SELError {
-    contractName;
-    methodName;
-    constructor(message, options) {
-        super(message, { cause: options?.cause });
-        this.contractName = options?.contractName;
-        this.methodName = options?.methodName;
-    }
-}
-/**
- * Thrown when a circular dependency is detected in the call dependency graph.
- * Indicates that call A depends on call B which depends on call A (directly or transitively).
- */
-export class CircularDependencyError extends SELError {
-    callIds;
-    constructor(message, options) {
-        super(message, { cause: options?.cause });
-        this.callIds = options?.callIds ?? [];
-    }
-}
-/**
- * Thrown when execution limits are exceeded (maxRounds or maxCalls).
- * Prevents infinite loops and runaway execution.
- */
-export class ExecutionLimitError extends SELError {
-    limitType;
-    limit;
-    actual;
-    constructor(message, options) {
-        super(message, { cause: options?.cause });
-        this.limitType = options?.limitType ?? "maxRounds";
-        this.limit = options?.limit ?? 0;
-        this.actual = options?.actual ?? 0;
-    }
-}
-/**
- * Thrown when a Multicall3 batch execution fails.
- * Includes the failed call index and optional contract name/method name for context.
- */
-export class MulticallBatchError extends SELError {
-    failedCallIndex;
-    contractName;
-    methodName;
-    constructor(message, options) {
-        super(message, { cause: options?.cause });
-        this.failedCallIndex = options?.failedCallIndex;
-        this.contractName = options?.contractName;
-        this.methodName = options?.methodName;
-    }
-}

package/dist/errors/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./errors.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/errors/index.js

@@ -1 +0,0 @@
-export * from "./errors.js";

package/dist/execution/index.d.ts

@@ -1,2 +0,0 @@
-export type * from "./types.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/execution/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAC"}

package/dist/execution/index.js

@@ -1 +0,0 @@
-export {};

package/dist/execution/multi-round-executor.d.ts

@@ -1,17 +0,0 @@
-import type { ExecutionResult } from "./types.js";
-import type { ExecutionPlan } from "../analysis/types.js";
-import type { Abi, Address, PublicClient } from "viem";
-export declare class MultiRoundExecutor {
-    private readonly client;
-    private readonly multicallOptions?;
-    private readonly contracts;
-    constructor(client: PublicClient, contracts: Map<string, {
-        abi: Abi;
-        address: Address;
-    }>, multicallOptions?: {
-        address?: Address;
-        batchSize?: number;
-    } | undefined);
-    execute(plan: ExecutionPlan, variables?: Record<string, unknown>, blockNumber?: bigint): Promise<ExecutionResult>;
-}
-//# sourceMappingURL=multi-round-executor.d.ts.map

package/dist/execution/multi-round-executor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"multi-round-executor.d.ts","sourceRoot":"","sources":["../../src/execution/multi-round-executor.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAIvD,qBAAa,kBAAkB;IAI7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IALnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;gBAGpC,MAAM,EAAE,YAAY,EACrC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,GAAG,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,EACrC,gBAAgB,CAAC,EAAE;QACnC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB,YAAA;IAKW,OAAO,CACnB,IAAI,EAAE,aAAa,EACnB,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACvC,WAAW,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC;CA4C3B"}

package/dist/execution/multi-round-executor.js

@@ -1,47 +0,0 @@
-import { getBlockNumber } from "viem/actions";
-import { MulticallBatcher } from "./multicall-batcher.js";
-import { ResultCache } from "./result-cache.js";
-import { RoundExecutor } from "./round-executor.js";
-import { createLogger } from "../debug.js";
-const debug = createLogger("execute");
-export class MultiRoundExecutor {
-    client;
-    multicallOptions;
-    contracts;
-    constructor(client, contracts, multicallOptions) {
-        this.client = client;
-        this.multicallOptions = multicallOptions;
-        this.contracts = contracts;
-    }
-    async execute(plan, variables = {}, blockNumber) {
-        const lockedBlockNumber = blockNumber ?? (await getBlockNumber(this.client));
-        debug("start: %d rounds, %d calls, block=%s", plan.rounds.length, plan.totalCalls, String(lockedBlockNumber));
-        const cache = new ResultCache();
-        const batcher = new MulticallBatcher(this.client, this.multicallOptions);
-        const executor = new RoundExecutor(this.contracts, cache, batcher);
-        const context = {
-            client: this.client,
-            blockNumber: lockedBlockNumber,
-            variables,
-        };
-        for (const round of plan.rounds) {
-            debug("round %d: %d calls", round.roundNumber, round.calls.length);
-            await executor.executeRound(round, context);
-        }
-        const results = new Map();
-        for (const round of plan.rounds) {
-            for (const call of round.calls) {
-                results.set(call.id, cache.get(call.id));
-            }
-        }
-        debug("complete: %d results collected", results.size);
-        return {
-            results,
-            meta: {
-                roundsExecuted: plan.rounds.length,
-                totalCalls: plan.totalCalls,
-                blockNumber: lockedBlockNumber,
-            },
-        };
-    }
-}

package/dist/execution/multicall-batcher.d.ts

@@ -1,14 +0,0 @@
-import { type MulticallCall, type MulticallResult } from "./multicall.js";
-import type { Address, PublicClient } from "viem";
-export declare class MulticallBatcher {
-    private readonly client;
-    private readonly address;
-    private readonly batchSize;
-    constructor(client: PublicClient, options?: {
-        address?: Address;
-        batchSize?: number;
-    });
-    executeBatch(calls: MulticallCall[], blockNumber: bigint): Promise<MulticallResult[]>;
-    private executeChunk;
-}
-//# sourceMappingURL=multicall-batcher.d.ts.map

package/dist/execution/multicall-batcher.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"multicall-batcher.d.ts","sourceRoot":"","sources":["../../src/execution/multicall-batcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAEN,KAAK,aAAa,EAClB,KAAK,eAAe,EAEpB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,KAAK,EAAE,OAAO,EAAO,YAAY,EAAE,MAAM,MAAM,CAAC;AAIvD,qBAAa,gBAAgB;IAK3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAGjB,MAAM,EAAE,YAAY,EACrC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAMvC,YAAY,CACxB,KAAK,EAAE,aAAa,EAAE,EACtB,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,EAAE,CAAC;YA+Bf,YAAY;CAuB1B"}

package/dist/execution/multicall-batcher.js

@@ -1,53 +0,0 @@
-import { readContract } from "viem/actions";
-import { MULTICALL3_ADDRESS, multicall3Abi, } from "./multicall.js";
-import { createLogger } from "../debug.js";
-import { MulticallBatchError } from "../errors/index.js";
-const debug = createLogger("execute:multicall");
-export class MulticallBatcher {
-    client;
-    address;
-    batchSize;
-    constructor(client, options) {
-        this.client = client;
-        this.address = options?.address ?? MULTICALL3_ADDRESS;
-        this.batchSize = options?.batchSize ?? 200;
-    }
-    async executeBatch(calls, blockNumber) {
-        if (calls.length === 0) {
-            return [];
-        }
-        if (calls.length <= this.batchSize) {
-            debug("batch: %d calls (single chunk)", calls.length);
-            return await this.executeChunk(calls, blockNumber);
-        }
-        debug("batch: %d calls (chunked, batchSize=%d)", calls.length, this.batchSize);
-        const results = [];
-        for (let i = 0; i < calls.length; i += this.batchSize) {
-            const chunk = calls.slice(i, i + this.batchSize);
-            debug("chunk %d/%d", i / this.batchSize + 1, Math.ceil(calls.length / this.batchSize));
-            const chunkResults = await this.executeChunk(chunk, blockNumber);
-            results.push(...chunkResults);
-        }
-        return results;
-    }
-    async executeChunk(calls, blockNumber) {
-        try {
-            const result = (await readContract(this.client, {
-                address: this.address,
-                abi: multicall3Abi,
-                functionName: "aggregate3",
-                args: [calls],
-                blockNumber,
-            }));
-            return result.map((r) => ({
-                success: r.success,
-                returnData: r.returnData,
-            }));
-        }
-        catch (error) {
-            throw new MulticallBatchError("Multicall3 aggregate3 call failed", {
-                cause: error,
-            });
-        }
-    }
-}

package/dist/execution/multicall.d.ts

@@ -1,42 +0,0 @@
-import type { Address, Hex } from "viem";
-export declare const MULTICALL3_ADDRESS: Address;
-export declare const multicall3Abi: readonly [{
-    readonly name: "aggregate3";
-    readonly type: "function";
-    readonly stateMutability: "payable";
-    readonly inputs: readonly [{
-        readonly name: "calls";
-        readonly type: "tuple[]";
-        readonly components: readonly [{
-            readonly name: "target";
-            readonly type: "address";
-        }, {
-            readonly name: "allowFailure";
-            readonly type: "bool";
-        }, {
-            readonly name: "callData";
-            readonly type: "bytes";
-        }];
-    }];
-    readonly outputs: readonly [{
-        readonly name: "returnData";
-        readonly type: "tuple[]";
-        readonly components: readonly [{
-            readonly name: "success";
-            readonly type: "bool";
-        }, {
-            readonly name: "returnData";
-            readonly type: "bytes";
-        }];
-    }];
-}];
-export interface MulticallCall {
-    target: Address;
-    allowFailure: boolean;
-    callData: Hex;
-}
-export interface MulticallResult {
-    success: boolean;
-    returnData: Hex;
-}
-//# sourceMappingURL=multicall.d.ts.map

package/dist/execution/multicall.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"multicall.d.ts","sourceRoot":"","sources":["../../src/execution/multicall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEzC,eAAO,MAAM,kBAAkB,EAAE,OACY,CAAC;AAE9C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BhB,CAAC;AAEX,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,GAAG,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,GAAG,CAAC;CAChB"}

package/dist/execution/multicall.js

@@ -1,29 +0,0 @@
-export const MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
-export const multicall3Abi = [
-    {
-        name: "aggregate3",
-        type: "function",
-        stateMutability: "payable",
-        inputs: [
-            {
-                name: "calls",
-                type: "tuple[]",
-                components: [
-                    { name: "target", type: "address" },
-                    { name: "allowFailure", type: "bool" },
-                    { name: "callData", type: "bytes" },
-                ],
-            },
-        ],
-        outputs: [
-            {
-                name: "returnData",
-                type: "tuple[]",
-                components: [
-                    { name: "success", type: "bool" },
-                    { name: "returnData", type: "bytes" },
-                ],
-            },
-        ],
-    },
-];

package/dist/execution/result-cache.d.ts

@@ -1,47 +0,0 @@
-/**
- * Cache for storing contract call results during expression evaluation.
- *
- * Uses Map-based storage with deterministic call IDs for efficient
- * lookup and deduplication of repeated contract calls.
- */
-export declare class ResultCache {
-    private readonly cache;
-    /**
-     * Generate a deterministic call ID from contract details.
-     *
-     * The ID format is `contract:method:serializedArgs` where args are
-     * JSON-stringified with special handling for bigint values.
-     *
-     * @param contract - Contract name (e.g., "token", "vault")
-     * @param method - Method name (e.g., "balanceOf", "totalSupply")
-     * @param args - Method arguments
-     * @returns Deterministic call ID string
-     */
-    generateCallId(contract: string, method: string, args: unknown[]): string;
-    /**
-     * Store a result in the cache.
-     *
-     * @param callId - The call ID (from generateCallId)
-     * @param result - The result to cache
-     */
-    set(callId: string, result: unknown): void;
-    /**
-     * Retrieve a cached result.
-     *
-     * @param callId - The call ID to look up
-     * @returns The cached result, or undefined if not found
-     */
-    get(callId: string): unknown;
-    /**
-     * Check if a result is cached.
-     *
-     * @param callId - The call ID to check
-     * @returns true if cached, false otherwise
-     */
-    has(callId: string): boolean;
-    /**
-     * Clear all cached results.
-     */
-    clear(): void;
-}
-//# sourceMappingURL=result-cache.d.ts.map

package/dist/execution/result-cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"result-cache.d.ts","sourceRoot":"","sources":["../../src/execution/result-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IAEpD;;;;;;;;;;OAUG;IACI,cAAc,CACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EAAE,GACb,MAAM;IAoBT;;;;;OAKG;IACI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAIjD;;;;;OAKG;IACI,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAInC;;;;;OAKG;IACI,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAInC;;OAEG;IACI,KAAK,IAAI,IAAI;CAGpB"}