@seljs/runtime 1.3.0-beta.28 → 1.3.0-beta.32

package/dist/errors/errors.mjs

@@ -1,32 +1,108 @@
-import { SELError as SELError$1, SELEvaluationError } from "@seljs/common";
+import { SELError as SELError$1, SELEvaluationError as SELEvaluationError$1, SELRuntimeError, SELStaticError } from "@seljs/common";
 //#region src/errors/errors.ts
 /**
-* Thrown when contract validation or execution fails.
-* Includes optional contract name and method name for context.
-* When the failure is a contract revert, the decoded revert reason and raw
-* revert data are exposed on `revertReason` / `revertData`, and `decodedError`
-* carries any matched custom-error name + args from the contract's ABI.
+* Thrown when a contract-layer call fails after execution reached the
+* chain (unknown method, ABI decode mismatch, etc.). Reverts are reported
+* as {@link SELContractRevertError}, a subclass; batch-level Multicall3
+* failures as {@link SELMulticallBatchError}.
 */
-var SELContractError = class extends SELError$1 {
+var SELContractError = class extends SELRuntimeError {
 	contractName;
 	methodName;
-	revertReason;
-	revertData;
-	decodedError;
 	constructor(message, options) {
 		super(message, { cause: options?.cause });
 		this.contractName = options?.contractName;
 		this.methodName = options?.methodName;
+	}
+};
+/**
+* Thrown when a contract call reverted. Carries the decoded revert
+* reason, raw revert data, and — when the selector matched a custom
+* error in the contract's ABI — the decoded custom-error name and args.
+*/
+var SELContractRevertError = class extends SELContractError {
+	revertReason;
+	revertData;
+	decodedError;
+	constructor(message, options) {
+		super(message, {
+			cause: options?.cause,
+			contractName: options?.contractName,
+			methodName: options?.methodName
+		});
 		this.revertReason = options?.revertReason;
 		this.revertData = options?.revertData;
 		this.decodedError = options?.decodedError;
 	}
 };
 /**
-* 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).
+* Thrown when a Multicall3 batch fails at the batch level — the aggregate
+* call itself reverted, or individual calls could not be encoded/decoded.
+* Individual sub-call reverts surface as {@link SELContractRevertError},
+* not as this class.
+*/
+var SELMulticallBatchError = class extends SELContractError {
+	failedCallIndex;
+	constructor(message, options) {
+		super(message, {
+			cause: options?.cause,
+			contractName: options?.contractName,
+			methodName: options?.methodName
+		});
+		this.failedCallIndex = options?.failedCallIndex;
+	}
+};
+/**
+* Base for failures from the JSON-RPC transport or node — the call never
+* reached the contract. Transport errors (HTTP, WebSocket, timeout) use
+* {@link SELProviderTransportError}; node-reported JSON-RPC errors use
+* {@link SELProviderRpcError}. Catch the base to retry safely against an
+* alternate RPC.
+*/
+var SELProviderError = class extends SELRuntimeError {};
+/**
+* Thrown when the transport layer (HTTP, WebSocket) or a timeout
+* prevented the request from reaching the node.
+*/
+var SELProviderTransportError = class extends SELProviderError {
+	httpStatus;
+	url;
+	body;
+	constructor(message, options) {
+		super(message, { cause: options?.cause });
+		this.httpStatus = options?.httpStatus;
+		this.url = options?.url;
+		this.body = options?.body;
+	}
+};
+/**
+* Thrown when the node returned a JSON-RPC error response (rate limit,
+* invalid params, unsupported method, user rejection, etc.).
 */
-var CircularDependencyError = class extends SELError$1 {
+var SELProviderRpcError = class extends SELProviderError {
+	rpcCode;
+	rpcData;
+	method;
+	constructor(message, options) {
+		super(message, { cause: options?.cause });
+		this.rpcCode = options?.rpcCode;
+		this.rpcData = options?.rpcData;
+		this.method = options?.method;
+	}
+};
+/**
+* Base for failures from the execution-framework layer that sits between
+* parsed expressions and contract calls (dependency analysis, round
+* planning). Concrete subclasses: {@link SELExecutionLimitError},
+* {@link SELCircularDependencyError}.
+*/
+var SELExecutionError = class extends SELRuntimeError {};
+/**
+* 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).
+*/
+var SELCircularDependencyError = class extends SELExecutionError {
 	callIds;
 	constructor(message, options) {
 		super(message, { cause: options?.cause });
@@ -37,7 +113,7 @@ var CircularDependencyError = class extends SELError$1 {
 * Thrown when execution limits are exceeded (maxRounds or maxCalls).
 * Prevents infinite loops and runaway execution.
 */
-var ExecutionLimitError = class extends SELError$1 {
+var SELExecutionLimitError = class extends SELExecutionError {
 	limitType;
 	limit;
 	actual;
@@ -49,40 +125,16 @@ var ExecutionLimitError = class extends SELError$1 {
 	}
 };
 /**
-* Thrown when a Multicall3 batch execution fails.
-* Includes the failed call index and optional contract name/method name for context.
-* When an individual sub-call reverts, `revertReason` / `revertData` carry the
-* decoded reason text and raw return data, and `decodedError` carries any
-* matched custom-error name + args from the contract's ABI.
-*/
-var MulticallBatchError = class extends SELError$1 {
-	failedCallIndex;
-	contractName;
-	methodName;
-	revertReason;
-	revertData;
-	decodedError;
-	constructor(message, options) {
-		super(message, { cause: options?.cause });
-		this.failedCallIndex = options?.failedCallIndex;
-		this.contractName = options?.contractName;
-		this.methodName = options?.methodName;
-		this.revertReason = options?.revertReason;
-		this.revertData = options?.revertData;
-		this.decodedError = options?.decodedError;
-	}
-};
-/**
 * Thrown when the provided client fails validation or is misconfigured.
 */
-var SELClientError = class extends SELError$1 {
+var SELClientError = class extends SELStaticError {
 	name = "SELClientError";
 };
 /**
 * Thrown when lint rules with error severity detect violations.
 * Contains the diagnostics that caused the failure.
 */
-var SELLintError = class extends SELError$1 {
+var SELLintError = class extends SELStaticError {
 	diagnostics;
 	constructor(diagnostics, options) {
 		const messages = diagnostics.map((d) => d.message).join("; ");
@@ -91,4 +143,4 @@ var SELLintError = class extends SELError$1 {
 	}
 };
 //#endregion
-export { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError$1 as SELError, SELEvaluationError, SELLintError };
+export { SELCircularDependencyError, SELClientError, SELContractError, SELContractRevertError, SELError$1 as SELError, SELEvaluationError$1 as SELEvaluationError, SELExecutionError, SELExecutionLimitError, SELLintError, SELMulticallBatchError, SELProviderError, SELProviderRpcError, SELProviderTransportError, SELRuntimeError, SELStaticError };

package/dist/errors/index.d.mts

@@ -1 +1 @@
-import { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError } from "./errors.mjs";
+import { SELCircularDependencyError, SELClientError, SELContractError, SELContractRevertError, SELError, SELEvaluationError, SELExecutionError, SELExecutionLimitError, SELLintError, SELMulticallBatchError, SELProviderError, SELProviderRpcError, SELProviderTransportError, SELRuntimeError, SELStaticError } from "./errors.mjs";

package/dist/execution/multicall-batcher.cjs

@@ -38,14 +38,14 @@ var MulticallBatcher = class {
 				data,
 				blockNumber
 			});
-			if (!response.data) throw new require_errors.MulticallBatchError("Multicall3 aggregate3 returned no data");
+			if (!response.data) throw new require_errors.SELMulticallBatchError("Multicall3 aggregate3 returned no data");
 			return ox.AbiFunction.decodeResult(require_multicall.multicall3Function, response.data).map((r) => ({
 				success: r.success,
 				returnData: r.returnData
 			}));
 		} catch (error) {
-			if (error instanceof require_errors.MulticallBatchError) throw error;
-			throw new require_errors.MulticallBatchError("Multicall3 aggregate3 call failed", { cause: error });
+			if (error instanceof require_errors.SELMulticallBatchError) throw error;
+			throw new require_errors.SELMulticallBatchError("Multicall3 aggregate3 call failed", { cause: error });
 		}
 	}
 };

package/dist/execution/multicall-batcher.mjs

@@ -1,5 +1,5 @@
 import { multicall3Function } from "./multicall.mjs";
-import { MulticallBatchError } from "../errors/errors.mjs";
+import { SELMulticallBatchError } from "../errors/errors.mjs";
 import "../errors/index.mjs";
 import { createLogger } from "../debug.mjs";
 import { AbiFunction } from "ox";
@@ -37,14 +37,14 @@ var MulticallBatcher = class {
 				data,
 				blockNumber
 			});
-			if (!response.data) throw new MulticallBatchError("Multicall3 aggregate3 returned no data");
+			if (!response.data) throw new SELMulticallBatchError("Multicall3 aggregate3 returned no data");
 			return AbiFunction.decodeResult(multicall3Function, response.data).map((r) => ({
 				success: r.success,
 				returnData: r.returnData
 			}));
 		} catch (error) {
-			if (error instanceof MulticallBatchError) throw error;
-			throw new MulticallBatchError("Multicall3 aggregate3 call failed", { cause: error });
+			if (error instanceof SELMulticallBatchError) throw error;
+			throw new SELMulticallBatchError("Multicall3 aggregate3 call failed", { cause: error });
 		}
 	}
 };

package/dist/execution/round-executor.cjs

@@ -4,6 +4,7 @@ require("../errors/index.cjs");
 const require_debug = require("../debug.cjs");
 const require_decode_revert = require("./decode-revert.cjs");
 let ox = require("ox");
+let _seljs_common = require("@seljs/common");
 //#region src/execution/round-executor.ts
 const debug = require_debug.createLogger("execute:round");
 var RoundExecutor = class {
@@ -23,7 +24,7 @@ var RoundExecutor = class {
 				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}"`);
+				if (!contract) throw new _seljs_common.SELConfigError(`No ABI registered for contract "${call.contract}"`, { setting: "abi" });
 				const resolvedArgs = this.resolveArgs(call.args, context);
 				encodedCalls.push({
 					target: contract.address,
@@ -32,8 +33,8 @@ var RoundExecutor = class {
 				});
 			}
 		} catch (error) {
-			if (error instanceof require_errors.MulticallBatchError) throw error;
-			throw new require_errors.MulticallBatchError("Failed to encode call", {
+			if (error instanceof require_errors.SELMulticallBatchError || error instanceof _seljs_common.SELConfigError) throw error;
+			throw new require_errors.SELMulticallBatchError("Failed to encode call", {
 				cause: error,
 				failedCallIndex,
 				contractName: failedCallContract,
@@ -44,13 +45,12 @@ var RoundExecutor = class {
 		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}"`);
+			if (!contract) throw new _seljs_common.SELConfigError(`No ABI registered for contract "${call.contract}"`, { setting: "abi" });
 			const result = results[i];
 			if (!result?.success) {
 				const decoded = require_decode_revert.decodeRevertData(result?.returnData ?? "0x", contract.abi);
 				const suffix = decoded.reason ? ` — ${decoded.reason}` : "";
-				throw new require_errors.MulticallBatchError(`Call failed: ${call.contract}.${call.method}${suffix}`, {
-					failedCallIndex: i,
+				throw new require_errors.SELContractRevertError(`Call reverted: ${call.contract}.${call.method}${suffix}`, {
 					contractName: call.contract,
 					methodName: call.method,
 					revertReason: decoded.reason,

package/dist/execution/round-executor.mjs

@@ -1,8 +1,9 @@
-import { MulticallBatchError } from "../errors/errors.mjs";
+import { SELContractRevertError, SELMulticallBatchError } from "../errors/errors.mjs";
 import "../errors/index.mjs";
 import { createLogger } from "../debug.mjs";
 import { decodeRevertData } from "./decode-revert.mjs";
 import { AbiFunction } from "ox";
+import { SELConfigError } from "@seljs/common";
 //#region src/execution/round-executor.ts
 const debug = createLogger("execute:round");
 var RoundExecutor = class {
@@ -22,7 +23,7 @@ var RoundExecutor = class {
 				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}"`);
+				if (!contract) throw new SELConfigError(`No ABI registered for contract "${call.contract}"`, { setting: "abi" });
 				const resolvedArgs = this.resolveArgs(call.args, context);
 				encodedCalls.push({
 					target: contract.address,
@@ -31,8 +32,8 @@ var RoundExecutor = class {
 				});
 			}
 		} catch (error) {
-			if (error instanceof MulticallBatchError) throw error;
-			throw new MulticallBatchError("Failed to encode call", {
+			if (error instanceof SELMulticallBatchError || error instanceof SELConfigError) throw error;
+			throw new SELMulticallBatchError("Failed to encode call", {
 				cause: error,
 				failedCallIndex,
 				contractName: failedCallContract,
@@ -43,13 +44,12 @@ var RoundExecutor = class {
 		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}"`);
+			if (!contract) throw new SELConfigError(`No ABI registered for contract "${call.contract}"`, { setting: "abi" });
 			const result = results[i];
 			if (!result?.success) {
 				const decoded = decodeRevertData(result?.returnData ?? "0x", contract.abi);
 				const suffix = decoded.reason ? ` — ${decoded.reason}` : "";
-				throw new MulticallBatchError(`Call failed: ${call.contract}.${call.method}${suffix}`, {
-					failedCallIndex: i,
+				throw new SELContractRevertError(`Call reverted: ${call.contract}.${call.method}${suffix}`, {
 					contractName: call.contract,
 					methodName: call.method,
 					revertReason: decoded.reason,

package/dist/index.cjs

@@ -7,14 +7,21 @@ const require_environment = require("./environment/environment.cjs");
 require("./environment/index.cjs");
 const require_factory = require("./factory.cjs");
 let _seljs_common = require("@seljs/common");
-exports.CircularDependencyError = require_errors.CircularDependencyError;
-exports.ExecutionLimitError = require_errors.ExecutionLimitError;
-exports.MulticallBatchError = require_errors.MulticallBatchError;
+exports.SELCircularDependencyError = require_errors.SELCircularDependencyError;
 exports.SELClientError = require_errors.SELClientError;
 exports.SELContractError = require_errors.SELContractError;
+exports.SELContractRevertError = require_errors.SELContractRevertError;
 exports.SELError = _seljs_common.SELError;
 exports.SELEvaluationError = _seljs_common.SELEvaluationError;
+exports.SELExecutionError = require_errors.SELExecutionError;
+exports.SELExecutionLimitError = require_errors.SELExecutionLimitError;
 exports.SELLintError = require_errors.SELLintError;
+exports.SELMulticallBatchError = require_errors.SELMulticallBatchError;
+exports.SELProviderError = require_errors.SELProviderError;
+exports.SELProviderRpcError = require_errors.SELProviderRpcError;
+exports.SELProviderTransportError = require_errors.SELProviderTransportError;
 exports.SELRuntime = require_environment.SELRuntime;
+exports.SELRuntimeError = _seljs_common.SELRuntimeError;
+exports.SELStaticError = _seljs_common.SELStaticError;
 exports.createSEL = require_factory.createSEL;
 exports.validateClient = require_client.validateClient;

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import { SELClient, validateClient } from "./environment/client.cjs";
 import { MulticallOptions, SELLimits, SELRuntimeConfig } from "./environment/types.cjs";
 import { EvaluateOptions, EvaluateResult, ExecutionContext, ExecutionMeta, ExecutionResult } from "./execution/types.cjs";
 import { SELRuntime } from "./environment/environment.cjs";
-import { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError } from "./errors/errors.cjs";
+import { SELCircularDependencyError, SELClientError, SELContractError, SELContractRevertError, SELError, SELEvaluationError, SELExecutionError, SELExecutionLimitError, SELLintError, SELMulticallBatchError, SELProviderError, SELProviderRpcError, SELProviderTransportError, SELRuntimeError, SELStaticError } from "./errors/errors.cjs";
 import { createSEL } from "./factory.cjs";
 import { CallArgument, CollectedCall, DependencyGraph, ExecutionPlan, ExecutionRound, GraphNode } from "./analysis/types.cjs";
-export { CallArgument, CircularDependencyError, CollectedCall, DependencyGraph, EvaluateOptions, EvaluateResult, ExecutionContext, ExecutionLimitError, ExecutionMeta, ExecutionPlan, ExecutionResult, ExecutionRound, GraphNode, MulticallBatchError, MulticallOptions, SELClient, SELClientError, SELContractError, SELError, SELEvaluationError, SELLimits, SELLintError, SELRuntime, SELRuntimeConfig, createSEL, validateClient };
+export { CallArgument, CollectedCall, DependencyGraph, EvaluateOptions, EvaluateResult, ExecutionContext, ExecutionMeta, ExecutionPlan, ExecutionResult, ExecutionRound, GraphNode, MulticallOptions, SELCircularDependencyError, SELClient, SELClientError, SELContractError, SELContractRevertError, SELError, SELEvaluationError, SELExecutionError, SELExecutionLimitError, SELLimits, SELLintError, SELMulticallBatchError, SELProviderError, SELProviderRpcError, SELProviderTransportError, SELRuntime, SELRuntimeConfig, SELRuntimeError, SELStaticError, createSEL, validateClient };

package/dist/index.d.mts

@@ -2,7 +2,7 @@ import { SELClient, validateClient } from "./environment/client.mjs";
 import { MulticallOptions, SELLimits, SELRuntimeConfig } from "./environment/types.mjs";
 import { EvaluateOptions, EvaluateResult, ExecutionContext, ExecutionMeta, ExecutionResult } from "./execution/types.mjs";
 import { SELRuntime } from "./environment/environment.mjs";
-import { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError } from "./errors/errors.mjs";
+import { SELCircularDependencyError, SELClientError, SELContractError, SELContractRevertError, SELError, SELEvaluationError, SELExecutionError, SELExecutionLimitError, SELLintError, SELMulticallBatchError, SELProviderError, SELProviderRpcError, SELProviderTransportError, SELRuntimeError, SELStaticError } from "./errors/errors.mjs";
 import { createSEL } from "./factory.mjs";
 import { CallArgument, CollectedCall, DependencyGraph, ExecutionPlan, ExecutionRound, GraphNode } from "./analysis/types.mjs";
-export { CallArgument, CircularDependencyError, CollectedCall, DependencyGraph, EvaluateOptions, EvaluateResult, ExecutionContext, ExecutionLimitError, ExecutionMeta, ExecutionPlan, ExecutionResult, ExecutionRound, GraphNode, MulticallBatchError, MulticallOptions, SELClient, SELClientError, SELContractError, SELError, SELEvaluationError, SELLimits, SELLintError, SELRuntime, SELRuntimeConfig, createSEL, validateClient };
+export { CallArgument, CollectedCall, DependencyGraph, EvaluateOptions, EvaluateResult, ExecutionContext, ExecutionMeta, ExecutionPlan, ExecutionResult, ExecutionRound, GraphNode, MulticallOptions, SELCircularDependencyError, SELClient, SELClientError, SELContractError, SELContractRevertError, SELError, SELEvaluationError, SELExecutionError, SELExecutionLimitError, SELLimits, SELLintError, SELMulticallBatchError, SELProviderError, SELProviderRpcError, SELProviderTransportError, SELRuntime, SELRuntimeConfig, SELRuntimeError, SELStaticError, createSEL, validateClient };

package/dist/index.mjs

@@ -1,7 +1,7 @@
-import { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError } from "./errors/errors.mjs";
+import { SELCircularDependencyError, SELClientError, SELContractError, SELContractRevertError, SELError, SELEvaluationError, SELExecutionError, SELExecutionLimitError, SELLintError, SELMulticallBatchError, SELProviderError, SELProviderRpcError, SELProviderTransportError, SELRuntimeError, SELStaticError } from "./errors/errors.mjs";
 import "./errors/index.mjs";
 import { validateClient } from "./environment/client.mjs";
 import { SELRuntime } from "./environment/environment.mjs";
 import "./environment/index.mjs";
 import { createSEL } from "./factory.mjs";
-export { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError, SELRuntime, createSEL, validateClient };
+export { SELCircularDependencyError, SELClientError, SELContractError, SELContractRevertError, SELError, SELEvaluationError, SELExecutionError, SELExecutionLimitError, SELLintError, SELMulticallBatchError, SELProviderError, SELProviderRpcError, SELProviderTransportError, SELRuntime, SELRuntimeError, SELStaticError, createSEL, validateClient };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seljs/runtime",
-  "version": "1.3.0-beta.28",
+  "version": "1.3.0-beta.32",
   "repository": {
     "url": "https://github.com/abinnovision/seljs"
   },
@@ -50,13 +50,14 @@
   },
   "dependencies": {
     "@marcbachmann/cel-js": "^7.5.3",
-    "@seljs/checker": "1.3.0-beta.28",
-    "@seljs/common": "1.3.0-beta.28",
-    "@seljs/env": "1.3.0-beta.28",
+    "@seljs/checker": "1.3.0-beta.32",
+    "@seljs/common": "1.3.0-beta.32",
+    "@seljs/env": "1.3.0-beta.32",
     "@seljs/schema": "1.2.0",
-    "@seljs/types": "1.3.0-beta.28",
+    "@seljs/types": "1.3.0-beta.32",
     "debug": "^4.4.3",
-    "ox": "^0.14.10"
+    "ox": "^0.14.10",
+    "viem": "^2.47.6"
   },
   "devDependencies": {
     "@abinnovision/eslint-config-base": "^3.2.2",