@seljs/runtime 1.0.0 → 1.0.1

package/dist/execution/result-cache.js

@@ -1,65 +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 class ResultCache {
-    cache = new Map();
-    /**
-     * 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, method, args) {
-        const argKey = JSON.stringify(args, (_, v) => {
-            if (typeof v === "bigint") {
-                return `${String(v)}n`;
-            }
-            if (typeof v === "object" && v !== null && !Array.isArray(v)) {
-                return Object.fromEntries(Object.entries(v).sort(([a], [b]) => a.localeCompare(b)));
-            }
-            return v;
-        });
-        return `${contract}:${method}:${argKey}`;
-    }
-    /**
-     * Store a result in the cache.
-     *
-     * @param callId - The call ID (from generateCallId)
-     * @param result - The result to cache
-     */
-    set(callId, result) {
-        this.cache.set(callId, result);
-    }
-    /**
-     * Retrieve a cached result.
-     *
-     * @param callId - The call ID to look up
-     * @returns The cached result, or undefined if not found
-     */
-    get(callId) {
-        return this.cache.get(callId);
-    }
-    /**
-     * Check if a result is cached.
-     *
-     * @param callId - The call ID to check
-     * @returns true if cached, false otherwise
-     */
-    has(callId) {
-        return this.cache.has(callId);
-    }
-    /**
-     * Clear all cached results.
-     */
-    clear() {
-        this.cache.clear();
-    }
-}

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

@@ -1,18 +0,0 @@
-import { type Abi, type Address } from "viem";
-import type { MulticallBatcher } from "./multicall-batcher.js";
-import type { ResultCache } from "./result-cache.js";
-import type { ExecutionContext } from "./types.js";
-import type { ExecutionRound } from "../analysis/types.js";
-export interface ContractInfo {
-    abi: Abi;
-    address: Address;
-}
-export declare class RoundExecutor {
-    private readonly contracts;
-    private readonly cache;
-    private readonly batcher;
-    constructor(contracts: Map<string, ContractInfo>, cache: ResultCache, batcher: MulticallBatcher);
-    executeRound(round: ExecutionRound, context: ExecutionContext): Promise<void>;
-    private resolveArgs;
-}
-//# sourceMappingURL=round-executor.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"round-executor.d.ts","sourceRoot":"","sources":["../../src/execution/round-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,GAAG,EACR,KAAK,OAAO,EAGZ,MAAM,MAAM,CAAC;AAKd,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAIzE,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,GAAG,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,aAAa;IAExB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACpC,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,gBAAgB;IAG9B,YAAY,CACxB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,gBAAgB,GACvB,OAAO,CAAC,IAAI,CAAC;IA2EhB,OAAO,CAAC,WAAW;CA2BnB"}

package/dist/execution/round-executor.js

@@ -1,95 +0,0 @@
-import { decodeFunctionResult, encodeFunctionData, } from "viem";
-import { createLogger } from "../debug.js";
-import { MulticallBatchError } from "../errors/index.js";
-const debug = createLogger("execute:round");
-export class RoundExecutor {
-    contracts;
-    cache;
-    batcher;
-    constructor(contracts, cache, batcher) {
-        this.contracts = contracts;
-        this.cache = cache;
-        this.batcher = batcher;
-    }
-    async executeRound(round, context) {
-        const encodedCalls = [];
-        let failedCallIndex;
-        let failedCallContract;
-        let failedCallMethod;
-        try {
-            for (const [i, call] of round.calls.entries()) {
-                failedCallIndex = i;
-                failedCallContract = call.contract;
-                failedCallMethod = call.method;
-                const contract = this.contracts.get(call.contract);
-                if (!contract) {
-                    throw new Error(`No ABI registered for contract "${call.contract}"`);
-                }
-                const resolvedArgs = this.resolveArgs(call.args, context);
-                encodedCalls.push({
-                    target: contract.address,
-                    allowFailure: false,
-                    callData: encodeFunctionData({
-                        abi: contract.abi,
-                        functionName: call.method,
-                        args: resolvedArgs,
-                    }),
-                });
-            }
-        }
-        catch (error) {
-            if (error instanceof MulticallBatchError) {
-                throw error;
-            }
-            throw new MulticallBatchError("Failed to encode call", {
-                cause: error,
-                failedCallIndex,
-                contractName: failedCallContract,
-                methodName: failedCallMethod,
-            });
-        }
-        debug("encoding %d calls for multicall", encodedCalls.length);
-        const results = await this.batcher.executeBatch(encodedCalls, context.blockNumber);
-        for (const [i, call] of round.calls.entries()) {
-            const contract = this.contracts.get(call.contract);
-            if (!contract) {
-                throw new Error(`No ABI registered for contract "${call.contract}"`);
-            }
-            const result = results[i];
-            if (!result?.success) {
-                throw new MulticallBatchError(`Call failed: ${call.contract}.${call.method}`, {
-                    failedCallIndex: i,
-                    contractName: call.contract,
-                    methodName: call.method,
-                });
-            }
-            const decoded = decodeFunctionResult({
-                abi: contract.abi,
-                functionName: call.method,
-                data: result.returnData,
-            });
-            debug("decoded %s.%s -> %o", call.contract, call.method, decoded);
-            this.cache.set(call.id, decoded);
-        }
-    }
-    resolveArgs(args, context) {
-        return args.map((arg) => {
-            if (arg.type === "literal") {
-                return arg.value;
-            }
-            if (arg.type === "variable") {
-                const name = arg.variableName;
-                if (!name) {
-                    return undefined;
-                }
-                return context.variables[name];
-            }
-            // arg.type === "call_result"
-            const id = arg.dependsOnCallId;
-            if (!id) {
-                return undefined;
-            }
-            return this.cache.get(id);
-        });
-    }
-}

package/dist/execution/types.d.ts

@@ -1,55 +0,0 @@
-import type { PublicClient } from "viem";
-/**
- * Metadata about the execution.
- * Contains statistics and block information from the execution run.
- */
-export interface ExecutionMeta {
-    /** Number of rounds executed (topological depth) */
-    roundsExecuted: number;
-    /** Total number of contract calls executed */
-    totalCalls: number;
-    /** Block number at which calls were executed */
-    blockNumber: bigint;
-}
-/**
- * Result of executing an SEL expression with contract calls.
- * Maps call IDs to their decoded results.
- */
-export interface ExecutionResult {
-    /** Map of callId to decoded result value */
-    results: Map<string, unknown>;
-    /** Execution metadata */
-    meta: ExecutionMeta;
-}
-/**
- * Context passed to the executor for running contract calls.
- * Contains the client, block number, and variable bindings.
- */
-export interface ExecutionContext {
-    /** Viem public client for making contract calls */
-    client: PublicClient;
-    /** Block number for consistent reads across all calls */
-    blockNumber: bigint;
-    /** Variable name to value mapping from evaluate() context */
-    variables: Record<string, unknown>;
-}
-/**
- * Options for the evaluate() call.
- */
-export interface EvaluateOptions {
-    /** Override viem client for this evaluation */
-    client?: PublicClient;
-}
-/**
- * Result of evaluating a SEL expression.
- *
- * Always returned by `evaluate()`. The `meta` field is present when
- * contract calls were executed, absent for pure CEL expressions.
- */
-export interface EvaluateResult<T = unknown> {
-    /** The evaluated result value */
-    value: T;
-    /** Execution metadata, present when contract calls were executed */
-    meta?: ExecutionMeta;
-}
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/execution/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEzC;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,oDAAoD;IACpD,cAAc,EAAE,MAAM,CAAC;IAEvB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IAEnB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC/B,4CAA4C;IAC5C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9B,yBAAyB;IACzB,IAAI,EAAE,aAAa,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAChC,mDAAmD;IACnD,MAAM,EAAE,YAAY,CAAC;IAErB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IAEpB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,+CAA+C;IAC/C,MAAM,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IAC1C,iCAAiC;IACjC,KAAK,EAAE,CAAC,CAAC;IAET,oEAAoE;IACpE,IAAI,CAAC,EAAE,aAAa,CAAC;CACrB"}

package/dist/execution/types.js

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

package/dist/factory.d.ts

@@ -1,3 +0,0 @@
-import { SELRuntime, type SELRuntimeConfig } from "./environment/index.js";
-export declare const createSEL: (config: SELRuntimeConfig) => SELRuntime;
-//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE3E,eAAO,MAAM,SAAS,GAAI,QAAQ,gBAAgB,KAAG,UAC9B,CAAC"}

package/dist/factory.js

@@ -1,2 +0,0 @@
-import { SELRuntime } from "./environment/index.js";
-export const createSEL = (config) => new SELRuntime(config);

package/dist/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * SEL (Solidity Expression Language) - CEL-based queries for EVM contracts.
- * @module @seljs/runtime
- */
-export * from "./environment/index.js";
-export * from "./errors/index.js";
-export * from "./factory.js";
-export type * from "./analysis/index.js";
-export type * from "./execution/index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAG7B,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,7 +0,0 @@
-/**
- * SEL (Solidity Expression Language) - CEL-based queries for EVM contracts.
- * @module @seljs/runtime
- */
-export * from "./environment/index.js";
-export * from "./errors/index.js";
-export * from "./factory.js";