@seljs/runtime 1.3.0-beta.2 → 1.3.0-beta.24

package/dist/analysis/call-collector.cjs

@@ -196,6 +196,25 @@ const collectCalls = (ast, registry) => {
 			return;
 		}
 		if (!receiverName || !registry.get(receiverName)) {
+			if (method === "balance" && args.length === 0) {
+				const receiverNode = node.args[1];
+				const { arg: receiverArg, traversed } = classifyArg(receiverNode);
+				if (receiverArg) {
+					const call = {
+						id: generateCallId("__multicall3", "getEthBalance", [receiverArg]),
+						contract: "__multicall3",
+						method: "getEthBalance",
+						args: [receiverArg],
+						astNode: node
+					};
+					calls.push(call);
+					debug("found address accessor %s (id=%s)", "balance", call.id);
+					return call;
+				}
+				deferredNodes.add(node);
+				if (!traversed) traverse(receiverNode);
+				return;
+			}
 			handleNonContractRCall(node, method, args);
 			return;
 		}

package/dist/analysis/call-collector.mjs

@@ -195,6 +195,25 @@ const collectCalls = (ast, registry) => {
 			return;
 		}
 		if (!receiverName || !registry.get(receiverName)) {
+			if (method === "balance" && args.length === 0) {
+				const receiverNode = node.args[1];
+				const { arg: receiverArg, traversed } = classifyArg(receiverNode);
+				if (receiverArg) {
+					const call = {
+						id: generateCallId("__multicall3", "getEthBalance", [receiverArg]),
+						contract: "__multicall3",
+						method: "getEthBalance",
+						args: [receiverArg],
+						astNode: node
+					};
+					calls.push(call);
+					debug("found address accessor %s (id=%s)", "balance", call.id);
+					return call;
+				}
+				deferredNodes.add(node);
+				if (!traversed) traverse(receiverNode);
+				return;
+			}
 			handleNonContractRCall(node, method, args);
 			return;
 		}

package/dist/environment/builtin-contracts.cjs

@@ -0,0 +1,22 @@
+const require_multicall = require("../execution/multicall.cjs");
+//#region src/environment/builtin-contracts.ts
+/**
+* Returns built-in contract schemas that are always available in the runtime.
+* These are internal contracts not defined by the user schema but required
+* for built-in features like address accessors.
+*/
+const getBuiltinContracts = (multicall) => [{
+	name: "__multicall3",
+	address: multicall?.address ?? "0xcA11bde05977b3631167028862bE2a173976CA11",
+	methods: [{
+		name: "getEthBalance",
+		params: [{
+			name: "addr",
+			type: "sol_address"
+		}],
+		returns: "sol_int",
+		abi: require_multicall.getEthBalanceAbi
+	}]
+}];
+//#endregion
+exports.getBuiltinContracts = getBuiltinContracts;

package/dist/environment/builtin-contracts.mjs

@@ -0,0 +1,22 @@
+import { getEthBalanceAbi } from "../execution/multicall.mjs";
+//#region src/environment/builtin-contracts.ts
+/**
+* Returns built-in contract schemas that are always available in the runtime.
+* These are internal contracts not defined by the user schema but required
+* for built-in features like address accessors.
+*/
+const getBuiltinContracts = (multicall) => [{
+	name: "__multicall3",
+	address: multicall?.address ?? "0xcA11bde05977b3631167028862bE2a173976CA11",
+	methods: [{
+		name: "getEthBalance",
+		params: [{
+			name: "addr",
+			type: "sol_address"
+		}],
+		returns: "sol_int",
+		abi: getEthBalanceAbi
+	}]
+}];
+//#endregion
+export { getBuiltinContracts };

package/dist/environment/client.d.cts

@@ -16,7 +16,7 @@ interface SELClient {
     data: `0x${string}`;
     blockNumber?: bigint;
   }) => Promise<{
-    data?: `0x${string}`;
+    data?: `0x${string}` | undefined;
   }>;
   /**
    *  Get the current block number (eth_blockNumber) for pinning reads

package/dist/environment/client.d.mts

@@ -16,7 +16,7 @@ interface SELClient {
     data: `0x${string}`;
     blockNumber?: bigint;
   }) => Promise<{
-    data?: `0x${string}`;
+    data?: `0x${string}` | undefined;
   }>;
   /**
    *  Get the current block number (eth_blockNumber) for pinning reads

package/dist/environment/environment.cjs

@@ -1,4 +1,5 @@
 require("../_virtual/_rolldown/runtime.cjs");
+const require_builtin_contracts = require("./builtin-contracts.cjs");
 const require_errors = require("../errors/errors.cjs");
 require("../errors/index.cjs");
 const require_client = require("./client.cjs");
@@ -12,7 +13,6 @@ const require_dependency_analyzer = require("../analysis/dependency-analyzer.cjs
 const require_round_planner = require("../analysis/round-planner.cjs");
 const require_multi_round_executor = require("../execution/multi-round-executor.cjs");
 let _seljs_checker = require("@seljs/checker");
-let _seljs_common = require("@seljs/common");
 //#region src/environment/environment.ts
 /**
 * Core SEL runtime that bridges CEL expression evaluation with EVM contract reads.
@@ -73,16 +73,20 @@ var SELRuntime = class {
 		this.multicallOptions = config.multicall;
 		if (config.client) require_client.validateClient(config.client);
 		this.client = config.client;
-		this.schema = config.schema;
+		this.schema = {
+			...config.schema,
+			contracts: [...config.schema.contracts, ...require_builtin_contracts.getBuiltinContracts(config.multicall)]
+		};
 		const handler = (contractName, methodName, args) => {
-			const contract = this.findContract(contractName);
-			if (!contract) throw new require_errors.SELContractError(`Unknown contract "${contractName}"`, { contractName });
-			const method = contract.methods.find((m) => m.name === methodName);
-			if (!method) throw new require_errors.SELContractError(`Unknown method "${contractName}.${methodName}"`, {
-				contractName,
-				methodName
+			const resolved = this.resolveCall(contractName, methodName, args);
+			const contract = this.findContract(resolved.contractName);
+			if (!contract) throw new require_errors.SELContractError(`Unknown contract "${resolved.contractName}"`, { contractName: resolved.contractName });
+			const method = contract.methods.find((m) => m.name === resolved.methodName);
+			if (!method) throw new require_errors.SELContractError(`Unknown method "${resolved.contractName}.${resolved.methodName}"`, {
+				contractName: resolved.contractName,
+				methodName: resolved.methodName
 			});
-			return require_contract_caller.executeContractCall(contract, method, args, {
+			return require_contract_caller.executeContractCall(contract, method, resolved.args, {
 				executionCache: this.currentCache,
 				client: this.currentClient ?? this.client,
 				codecRegistry: this.codecRegistry,
@@ -101,7 +105,7 @@ var SELRuntime = class {
 	*
 	* @param expression - A CEL expression string to type-check
 	* @returns The type-check result containing validity, inferred type, and any errors
-	* @throws {@link SELTypeError} If the expression contains unrecoverable type errors
+	* @throws {@link SELEvaluationError} If the expression contains unrecoverable type errors
 	*/
 	check(expression) {
 		try {
@@ -125,8 +129,7 @@ var SELRuntime = class {
 	* @param context Variable bindings for evaluation
 	* @param options Optional client override
 	* @returns An {@link EvaluateResult} containing the value and optional execution metadata
-	* @throws {@link SELParseError} If the expression has invalid syntax
-	* @throws {@link SELTypeError} If type-checking fails
+	* @throws {@link SELLintError} If the expression fails parse, type-check, or lint rules
 	* @throws {@link SELContractError} If a contract call fails or no client is available
 	* @throws {@link SELEvaluationError} If CEL evaluation fails
 	*/
@@ -144,23 +147,21 @@ var SELRuntime = class {
 		}
 	}
 	planExecution(expression, evaluationContext) {
+		const checkResult = this.checker.check(expression);
+		if (!checkResult.valid) throw new require_errors.SELLintError(checkResult.diagnostics.filter((d) => d.severity === "error"));
 		const parseResult = this.env.parse(expression);
 		const collectedCalls = require_call_collector.collectCalls(parseResult.ast, { get: (name) => this.findContract(name) });
 		debug("evaluate: collected %d calls", collectedCalls.length);
 		const normalizedContext = Object.keys(evaluationContext).length ? require_context.normalizeContextForEvaluation(evaluationContext, this.variableTypes, this.codecRegistry) : void 0;
 		const executionVariables = Object.keys(evaluationContext).length ? evaluationContext : {};
-		const typeCheckResult = parseResult.check();
-		if (!typeCheckResult.valid) throw new _seljs_common.SELTypeError(typeCheckResult.error?.message ?? "Type check failed", { cause: typeCheckResult.error });
-		const lintResult = this.checker.check(expression);
-		const lintErrors = lintResult.diagnostics.filter((d) => d.severity === "error");
-		if (lintErrors.length > 0) throw new require_errors.SELLintError(lintErrors);
+		const diagnostics = checkResult.diagnostics.filter((d) => d.severity !== "error");
 		return {
 			parseResult,
 			collectedCalls,
 			normalizedContext,
 			executionVariables,
-			typeCheckResult,
-			diagnostics: lintResult.diagnostics.filter((d) => d.severity !== "error")
+			resolvedType: checkResult.type,
+			diagnostics
 		};
 	}
 	async executeContractCalls(collectedCalls, executionVariables, resolvedClient) {
@@ -211,7 +212,7 @@ var SELRuntime = class {
 		const resolvedClient = options?.client ?? this.client;
 		if (resolvedClient && resolvedClient !== this.client) require_client.validateClient(resolvedClient);
 		try {
-			const { parseResult, collectedCalls, normalizedContext, executionVariables, typeCheckResult, diagnostics } = this.planExecution(expression, context ?? {});
+			const { parseResult, collectedCalls, normalizedContext, executionVariables, resolvedType, diagnostics } = this.planExecution(expression, context ?? {});
 			let executionMeta;
 			let executionCache;
 			if (collectedCalls.length > 0) {
@@ -235,18 +236,35 @@ var SELRuntime = class {
 				this.currentClient = void 0;
 				this.currentCallCounter = void 0;
 			}
-			const value = typeCheckResult.type ? this.codecRegistry.encode(typeCheckResult.type, result) : result;
+			const value = resolvedType ? this.codecRegistry.encode(resolvedType, result) : result;
 			debug("evaluate: result type=%s", typeof value);
 			const evalResult = executionMeta ? {
 				value,
 				meta: executionMeta
 			} : { value };
+			if (resolvedType) evalResult.type = resolvedType;
 			if (diagnostics.length > 0) evalResult.diagnostics = diagnostics;
 			return evalResult;
 		} catch (error) {
 			throw require_error_wrapper.wrapError(error);
 		}
 	}
+	/**
+	* Remaps receiver method calls to their underlying contract calls.
+	* e.g., sol_address.balance() → __multicall3.getEthBalance(addr)
+	*/
+	resolveCall(contractName, methodName, args) {
+		if (contractName === "sol_address" && methodName === "balance") return {
+			contractName: "__multicall3",
+			methodName: "getEthBalance",
+			args
+		};
+		return {
+			contractName,
+			methodName,
+			args
+		};
+	}
 	findContract(name) {
 		return this.schema.contracts.find((c) => c.name === name);
 	}

package/dist/environment/environment.d.cts

@@ -52,7 +52,7 @@ declare class SELRuntime {
    *
    * @param expression - A CEL expression string to type-check
    * @returns The type-check result containing validity, inferred type, and any errors
-   * @throws {@link SELTypeError} If the expression contains unrecoverable type errors
+   * @throws {@link SELEvaluationError} If the expression contains unrecoverable type errors
    */
   check(expression: string): TypeCheckResult;
   /**
@@ -70,8 +70,7 @@ declare class SELRuntime {
    * @param context Variable bindings for evaluation
    * @param options Optional client override
    * @returns An {@link EvaluateResult} containing the value and optional execution metadata
-   * @throws {@link SELParseError} If the expression has invalid syntax
-   * @throws {@link SELTypeError} If type-checking fails
+   * @throws {@link SELLintError} If the expression fails parse, type-check, or lint rules
    * @throws {@link SELContractError} If a contract call fails or no client is available
    * @throws {@link SELEvaluationError} If CEL evaluation fails
    */
@@ -79,6 +78,11 @@ declare class SELRuntime {
   private planExecution;
   private executeContractCalls;
   private doEvaluate;
+  /**
+   * Remaps receiver method calls to their underlying contract calls.
+   * e.g., sol_address.balance() → __multicall3.getEthBalance(addr)
+   */
+  private resolveCall;
   private findContract;
 }
 //#endregion

package/dist/environment/environment.d.mts

@@ -52,7 +52,7 @@ declare class SELRuntime {
    *
    * @param expression - A CEL expression string to type-check
    * @returns The type-check result containing validity, inferred type, and any errors
-   * @throws {@link SELTypeError} If the expression contains unrecoverable type errors
+   * @throws {@link SELEvaluationError} If the expression contains unrecoverable type errors
    */
   check(expression: string): TypeCheckResult;
   /**
@@ -70,8 +70,7 @@ declare class SELRuntime {
    * @param context Variable bindings for evaluation
    * @param options Optional client override
    * @returns An {@link EvaluateResult} containing the value and optional execution metadata
-   * @throws {@link SELParseError} If the expression has invalid syntax
-   * @throws {@link SELTypeError} If type-checking fails
+   * @throws {@link SELLintError} If the expression fails parse, type-check, or lint rules
    * @throws {@link SELContractError} If a contract call fails or no client is available
    * @throws {@link SELEvaluationError} If CEL evaluation fails
    */
@@ -79,6 +78,11 @@ declare class SELRuntime {
   private planExecution;
   private executeContractCalls;
   private doEvaluate;
+  /**
+   * Remaps receiver method calls to their underlying contract calls.
+   * e.g., sol_address.balance() → __multicall3.getEthBalance(addr)
+   */
+  private resolveCall;
   private findContract;
 }
 //#endregion

package/dist/environment/environment.mjs

@@ -1,4 +1,5 @@
-import { MulticallBatchError, SELContractError, SELLintError, SELTypeError } from "../errors/errors.mjs";
+import { getBuiltinContracts } from "./builtin-contracts.mjs";
+import { MulticallBatchError, SELContractError, SELLintError } from "../errors/errors.mjs";
 import "../errors/index.mjs";
 import { validateClient } from "./client.mjs";
 import { normalizeContextForEvaluation } from "./context.mjs";
@@ -71,16 +72,20 @@ var SELRuntime = class {
 		this.multicallOptions = config.multicall;
 		if (config.client) validateClient(config.client);
 		this.client = config.client;
-		this.schema = config.schema;
+		this.schema = {
+			...config.schema,
+			contracts: [...config.schema.contracts, ...getBuiltinContracts(config.multicall)]
+		};
 		const handler = (contractName, methodName, args) => {
-			const contract = this.findContract(contractName);
-			if (!contract) throw new SELContractError(`Unknown contract "${contractName}"`, { contractName });
-			const method = contract.methods.find((m) => m.name === methodName);
-			if (!method) throw new SELContractError(`Unknown method "${contractName}.${methodName}"`, {
-				contractName,
-				methodName
+			const resolved = this.resolveCall(contractName, methodName, args);
+			const contract = this.findContract(resolved.contractName);
+			if (!contract) throw new SELContractError(`Unknown contract "${resolved.contractName}"`, { contractName: resolved.contractName });
+			const method = contract.methods.find((m) => m.name === resolved.methodName);
+			if (!method) throw new SELContractError(`Unknown method "${resolved.contractName}.${resolved.methodName}"`, {
+				contractName: resolved.contractName,
+				methodName: resolved.methodName
 			});
-			return executeContractCall(contract, method, args, {
+			return executeContractCall(contract, method, resolved.args, {
 				executionCache: this.currentCache,
 				client: this.currentClient ?? this.client,
 				codecRegistry: this.codecRegistry,
@@ -99,7 +104,7 @@ var SELRuntime = class {
 	*
 	* @param expression - A CEL expression string to type-check
 	* @returns The type-check result containing validity, inferred type, and any errors
-	* @throws {@link SELTypeError} If the expression contains unrecoverable type errors
+	* @throws {@link SELEvaluationError} If the expression contains unrecoverable type errors
 	*/
 	check(expression) {
 		try {
@@ -123,8 +128,7 @@ var SELRuntime = class {
 	* @param context Variable bindings for evaluation
 	* @param options Optional client override
 	* @returns An {@link EvaluateResult} containing the value and optional execution metadata
-	* @throws {@link SELParseError} If the expression has invalid syntax
-	* @throws {@link SELTypeError} If type-checking fails
+	* @throws {@link SELLintError} If the expression fails parse, type-check, or lint rules
 	* @throws {@link SELContractError} If a contract call fails or no client is available
 	* @throws {@link SELEvaluationError} If CEL evaluation fails
 	*/
@@ -142,23 +146,21 @@ var SELRuntime = class {
 		}
 	}
 	planExecution(expression, evaluationContext) {
+		const checkResult = this.checker.check(expression);
+		if (!checkResult.valid) throw new SELLintError(checkResult.diagnostics.filter((d) => d.severity === "error"));
 		const parseResult = this.env.parse(expression);
 		const collectedCalls = collectCalls(parseResult.ast, { get: (name) => this.findContract(name) });
 		debug("evaluate: collected %d calls", collectedCalls.length);
 		const normalizedContext = Object.keys(evaluationContext).length ? normalizeContextForEvaluation(evaluationContext, this.variableTypes, this.codecRegistry) : void 0;
 		const executionVariables = Object.keys(evaluationContext).length ? evaluationContext : {};
-		const typeCheckResult = parseResult.check();
-		if (!typeCheckResult.valid) throw new SELTypeError(typeCheckResult.error?.message ?? "Type check failed", { cause: typeCheckResult.error });
-		const lintResult = this.checker.check(expression);
-		const lintErrors = lintResult.diagnostics.filter((d) => d.severity === "error");
-		if (lintErrors.length > 0) throw new SELLintError(lintErrors);
+		const diagnostics = checkResult.diagnostics.filter((d) => d.severity !== "error");
 		return {
 			parseResult,
 			collectedCalls,
 			normalizedContext,
 			executionVariables,
-			typeCheckResult,
-			diagnostics: lintResult.diagnostics.filter((d) => d.severity !== "error")
+			resolvedType: checkResult.type,
+			diagnostics
 		};
 	}
 	async executeContractCalls(collectedCalls, executionVariables, resolvedClient) {
@@ -209,7 +211,7 @@ var SELRuntime = class {
 		const resolvedClient = options?.client ?? this.client;
 		if (resolvedClient && resolvedClient !== this.client) validateClient(resolvedClient);
 		try {
-			const { parseResult, collectedCalls, normalizedContext, executionVariables, typeCheckResult, diagnostics } = this.planExecution(expression, context ?? {});
+			const { parseResult, collectedCalls, normalizedContext, executionVariables, resolvedType, diagnostics } = this.planExecution(expression, context ?? {});
 			let executionMeta;
 			let executionCache;
 			if (collectedCalls.length > 0) {
@@ -233,18 +235,35 @@ var SELRuntime = class {
 				this.currentClient = void 0;
 				this.currentCallCounter = void 0;
 			}
-			const value = typeCheckResult.type ? this.codecRegistry.encode(typeCheckResult.type, result) : result;
+			const value = resolvedType ? this.codecRegistry.encode(resolvedType, result) : result;
 			debug("evaluate: result type=%s", typeof value);
 			const evalResult = executionMeta ? {
 				value,
 				meta: executionMeta
 			} : { value };
+			if (resolvedType) evalResult.type = resolvedType;
 			if (diagnostics.length > 0) evalResult.diagnostics = diagnostics;
 			return evalResult;
 		} catch (error) {
 			throw wrapError(error);
 		}
 	}
+	/**
+	* Remaps receiver method calls to their underlying contract calls.
+	* e.g., sol_address.balance() → __multicall3.getEthBalance(addr)
+	*/
+	resolveCall(contractName, methodName, args) {
+		if (contractName === "sol_address" && methodName === "balance") return {
+			contractName: "__multicall3",
+			methodName: "getEthBalance",
+			args
+		};
+		return {
+			contractName,
+			methodName,
+			args
+		};
+	}
 	findContract(name) {
 		return this.schema.contracts.find((c) => c.name === name);
 	}

package/dist/environment/error-wrapper.cjs

@@ -1,8 +1,7 @@
 require("../_virtual/_rolldown/runtime.cjs");
-const require_errors = require("../errors/errors.cjs");
 require("../errors/index.cjs");
-let _marcbachmann_cel_js = require("@marcbachmann/cel-js");
 let _seljs_common = require("@seljs/common");
+let _marcbachmann_cel_js = require("@marcbachmann/cel-js");
 //#region src/environment/error-wrapper.ts
 /**
 * Wraps an unknown error into a known SEL error type.
@@ -14,14 +13,14 @@ let _seljs_common = require("@seljs/common");
 * @returns The wrapped error.
 */
 const wrapError = (error) => {
-	if (error instanceof require_errors.SELContractError) return error;
-	if (error instanceof _marcbachmann_cel_js.ParseError) return new _seljs_common.SELParseError(error.message, { cause: error });
+	if (error instanceof _seljs_common.SELError) return error;
 	if (error instanceof _marcbachmann_cel_js.EvaluationError) {
 		const cause = error.cause;
-		if (cause instanceof require_errors.SELContractError) return cause;
-		return new require_errors.SELEvaluationError(error.message, { cause: error });
+		if (cause instanceof _seljs_common.SELError) return cause;
+		return new _seljs_common.SELEvaluationError(error.message, { cause: error });
 	}
-	if (error instanceof _marcbachmann_cel_js.TypeError) return new _seljs_common.SELTypeError(error.message, { cause: error });
+	if (error instanceof _marcbachmann_cel_js.ParseError) return new _seljs_common.SELEvaluationError(error.message, { cause: error });
+	if (error instanceof _marcbachmann_cel_js.TypeError) return new _seljs_common.SELEvaluationError(error.message, { cause: error });
 	if (error instanceof Error) return error;
 	return new Error(String(error));
 };

package/dist/environment/error-wrapper.mjs

@@ -1,5 +1,6 @@
-import { SELContractError, SELEvaluationError, SELParseError, SELTypeError } from "../errors/errors.mjs";
+import { SELEvaluationError } from "../errors/errors.mjs";
 import "../errors/index.mjs";
+import { SELError } from "@seljs/common";
 import { EvaluationError, ParseError, TypeError } from "@marcbachmann/cel-js";
 //#region src/environment/error-wrapper.ts
 /**
@@ -12,14 +13,14 @@ import { EvaluationError, ParseError, TypeError } from "@marcbachmann/cel-js";
 * @returns The wrapped error.
 */
 const wrapError = (error) => {
-	if (error instanceof SELContractError) return error;
-	if (error instanceof ParseError) return new SELParseError(error.message, { cause: error });
+	if (error instanceof SELError) return error;
 	if (error instanceof EvaluationError) {
 		const cause = error.cause;
-		if (cause instanceof SELContractError) return cause;
+		if (cause instanceof SELError) return cause;
 		return new SELEvaluationError(error.message, { cause: error });
 	}
-	if (error instanceof TypeError) return new SELTypeError(error.message, { cause: error });
+	if (error instanceof ParseError) return new SELEvaluationError(error.message, { cause: error });
+	if (error instanceof TypeError) return new SELEvaluationError(error.message, { cause: error });
 	if (error instanceof Error) return error;
 	return new Error(String(error));
 };

package/dist/errors/errors.cjs

@@ -2,11 +2,6 @@ require("../_virtual/_rolldown/runtime.cjs");
 let _seljs_common = require("@seljs/common");
 //#region src/errors/errors.ts
 /**
-* Thrown when CEL expression evaluation fails.
-* Wraps cel-js EvaluationError with additional context.
-*/
-var SELEvaluationError = class extends _seljs_common.SELError {};
-/**
 * Thrown when contract validation or execution fails.
 * Includes optional contract name and method name for context.
 */
@@ -84,5 +79,4 @@ exports.ExecutionLimitError = ExecutionLimitError;
 exports.MulticallBatchError = MulticallBatchError;
 exports.SELClientError = SELClientError;
 exports.SELContractError = SELContractError;
-exports.SELEvaluationError = SELEvaluationError;
 exports.SELLintError = SELLintError;

package/dist/errors/errors.d.cts

@@ -1,12 +1,7 @@
 import { SELDiagnostic } from "@seljs/checker";
-import { SELError, SELParseError, SELTypeError } from "@seljs/common";
+import { SELError, SELEvaluationError } from "@seljs/common";
 
 //#region src/errors/errors.d.ts
-/**
- * Thrown when CEL expression evaluation fails.
- * Wraps cel-js EvaluationError with additional context.
- */
-declare class SELEvaluationError extends SELError {}
 /**
  * Thrown when contract validation or execution fails.
  * Includes optional contract name and method name for context.
@@ -78,4 +73,4 @@ declare class SELLintError extends SELError {
   });
 }
 //#endregion
-export { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError, SELParseError, SELTypeError };
+export { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError };

package/dist/errors/errors.d.mts

@@ -1,17 +1,12 @@
 import { SELDiagnostic } from "@seljs/checker";
-import { SELError, SELParseError, SELTypeError } from "@seljs/common";
+import { SELError as SELError$1, SELEvaluationError } from "@seljs/common";
 
 //#region src/errors/errors.d.ts
-/**
- * Thrown when CEL expression evaluation fails.
- * Wraps cel-js EvaluationError with additional context.
- */
-declare class SELEvaluationError extends SELError {}
 /**
  * Thrown when contract validation or execution fails.
  * Includes optional contract name and method name for context.
  */
-declare class SELContractError extends SELError {
+declare class SELContractError extends SELError$1 {
   readonly contractName?: string;
   readonly methodName?: string;
   constructor(message: string, options?: {
@@ -24,7 +19,7 @@ declare class SELContractError extends SELError {
  * 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).
  */
-declare class CircularDependencyError extends SELError {
+declare class CircularDependencyError extends SELError$1 {
   readonly callIds: string[];
   constructor(message: string, options?: {
     cause?: unknown;
@@ -35,7 +30,7 @@ declare class CircularDependencyError extends SELError {
  * Thrown when execution limits are exceeded (maxRounds or maxCalls).
  * Prevents infinite loops and runaway execution.
  */
-declare class ExecutionLimitError extends SELError {
+declare class ExecutionLimitError extends SELError$1 {
   readonly limitType: "maxRounds" | "maxCalls";
   readonly limit: number;
   readonly actual: number;
@@ -50,7 +45,7 @@ declare class ExecutionLimitError extends SELError {
  * Thrown when a Multicall3 batch execution fails.
  * Includes the failed call index and optional contract name/method name for context.
  */
-declare class MulticallBatchError extends SELError {
+declare class MulticallBatchError extends SELError$1 {
   readonly failedCallIndex?: number;
   readonly contractName?: string;
   readonly methodName?: string;
@@ -64,18 +59,18 @@ declare class MulticallBatchError extends SELError {
 /**
  * Thrown when the provided client fails validation or is misconfigured.
  */
-declare class SELClientError extends SELError {
+declare class SELClientError extends SELError$1 {
   readonly name = "SELClientError";
 }
 /**
  * Thrown when lint rules with error severity detect violations.
  * Contains the diagnostics that caused the failure.
  */
-declare class SELLintError extends SELError {
+declare class SELLintError extends SELError$1 {
   readonly diagnostics: SELDiagnostic[];
   constructor(diagnostics: SELDiagnostic[], options?: {
     cause?: unknown;
   });
 }
 //#endregion
-export { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError, SELParseError, SELTypeError };
+export { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError$1 as SELError, SELEvaluationError, SELLintError };

package/dist/errors/errors.mjs

@@ -1,15 +1,10 @@
-import { SELError, SELParseError, SELTypeError } from "@seljs/common";
+import { SELError as SELError$1, SELEvaluationError } from "@seljs/common";
 //#region src/errors/errors.ts
 /**
-* Thrown when CEL expression evaluation fails.
-* Wraps cel-js EvaluationError with additional context.
-*/
-var SELEvaluationError = class extends SELError {};
-/**
 * Thrown when contract validation or execution fails.
 * Includes optional contract name and method name for context.
 */
-var SELContractError = class extends SELError {
+var SELContractError = class extends SELError$1 {
 	contractName;
 	methodName;
 	constructor(message, options) {
@@ -22,7 +17,7 @@ var SELContractError = class extends SELError {
 * 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 CircularDependencyError = class extends SELError {
+var CircularDependencyError = class extends SELError$1 {
 	callIds;
 	constructor(message, options) {
 		super(message, { cause: options?.cause });
@@ -33,7 +28,7 @@ var CircularDependencyError = class extends SELError {
 * Thrown when execution limits are exceeded (maxRounds or maxCalls).
 * Prevents infinite loops and runaway execution.
 */
-var ExecutionLimitError = class extends SELError {
+var ExecutionLimitError = class extends SELError$1 {
 	limitType;
 	limit;
 	actual;
@@ -48,7 +43,7 @@ var ExecutionLimitError = class extends SELError {
 * Thrown when a Multicall3 batch execution fails.
 * Includes the failed call index and optional contract name/method name for context.
 */
-var MulticallBatchError = class extends SELError {
+var MulticallBatchError = class extends SELError$1 {
 	failedCallIndex;
 	contractName;
 	methodName;
@@ -62,14 +57,14 @@ var MulticallBatchError = class extends SELError {
 /**
 * Thrown when the provided client fails validation or is misconfigured.
 */
-var SELClientError = class extends SELError {
+var SELClientError = class extends SELError$1 {
 	name = "SELClientError";
 };
 /**
 * Thrown when lint rules with error severity detect violations.
 * Contains the diagnostics that caused the failure.
 */
-var SELLintError = class extends SELError {
+var SELLintError = class extends SELError$1 {
 	diagnostics;
 	constructor(diagnostics, options) {
 		const messages = diagnostics.map((d) => d.message).join("; ");
@@ -78,4 +73,4 @@ var SELLintError = class extends SELError {
 	}
 };
 //#endregion
-export { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError, SELParseError, SELTypeError };
+export { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError$1 as SELError, SELEvaluationError, SELLintError };

package/dist/errors/index.d.mts

@@ -1 +1 @@
-import { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError, SELParseError, SELTypeError } from "./errors.mjs";
+import { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError } from "./errors.mjs";

package/dist/execution/multicall-batcher.cjs

@@ -1,8 +1,8 @@
 require("../_virtual/_rolldown/runtime.cjs");
+const require_multicall = require("./multicall.cjs");
 const require_errors = require("../errors/errors.cjs");
 require("../errors/index.cjs");
 const require_debug = require("../debug.cjs");
-const require_multicall = require("./multicall.cjs");
 let ox = require("ox");
 //#region src/execution/multicall-batcher.ts
 const debug = require_debug.createLogger("execute:multicall");

package/dist/execution/multicall-batcher.mjs

@@ -1,7 +1,7 @@
+import { multicall3Function } from "./multicall.mjs";
 import { MulticallBatchError } from "../errors/errors.mjs";
 import "../errors/index.mjs";
 import { createLogger } from "../debug.mjs";
-import { multicall3Function } from "./multicall.mjs";
 import { AbiFunction } from "ox";
 //#region src/execution/multicall-batcher.ts
 const debug = createLogger("execute:multicall");

package/dist/execution/multicall.cjs

@@ -40,6 +40,24 @@ const MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
 * Pre-parsed Multicall3 aggregate3 ABI function for ox encoding/decoding.
 */
 const multicall3Function = ox.AbiFunction.from(aggregate3Abi);
+/**
+* Multicall3 getEthBalance ABI — returns native ETH balance for an address.
+* Used by the sol_address.balance() accessor.
+*/
+const getEthBalanceAbi = {
+	name: "getEthBalance",
+	type: "function",
+	stateMutability: "view",
+	inputs: [{
+		name: "addr",
+		type: "address"
+	}],
+	outputs: [{
+		name: "balance",
+		type: "uint256"
+	}]
+};
 //#endregion
 exports.MULTICALL3_ADDRESS = MULTICALL3_ADDRESS;
+exports.getEthBalanceAbi = getEthBalanceAbi;
 exports.multicall3Function = multicall3Function;

package/dist/execution/multicall.mjs

@@ -39,5 +39,22 @@ const MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
 * Pre-parsed Multicall3 aggregate3 ABI function for ox encoding/decoding.
 */
 const multicall3Function = AbiFunction.from(aggregate3Abi);
+/**
+* Multicall3 getEthBalance ABI — returns native ETH balance for an address.
+* Used by the sol_address.balance() accessor.
+*/
+const getEthBalanceAbi = {
+	name: "getEthBalance",
+	type: "function",
+	stateMutability: "view",
+	inputs: [{
+		name: "addr",
+		type: "address"
+	}],
+	outputs: [{
+		name: "balance",
+		type: "uint256"
+	}]
+};
 //#endregion
-export { MULTICALL3_ADDRESS, multicall3Function };
+export { MULTICALL3_ADDRESS, getEthBalanceAbi, multicall3Function };

package/dist/execution/types.d.cts

@@ -7,11 +7,17 @@ import { SELDiagnostic } from "@seljs/checker";
  * Contains statistics and block information from the execution run.
  */
 interface ExecutionMeta {
-  /** Number of rounds executed (topological depth) */
+  /**
+   * Number of rounds executed (topological depth)
+   */
   roundsExecuted: number;
-  /** Total number of contract calls executed */
+  /**
+   *  Total number of contract calls executed
+   */
   totalCalls: number;
-  /** Block number at which calls were executed */
+  /**
+   * Block number at which calls were executed
+   */
   blockNumber: bigint;
 }
 /**
@@ -19,9 +25,13 @@ interface ExecutionMeta {
  * Maps call IDs to their decoded results.
  */
 interface ExecutionResult {
-  /** Map of callId to decoded result value */
+  /**
+   * Map of callId to decoded result value
+   */
   results: Map<string, unknown>;
-  /** Execution metadata */
+  /**
+   *  Execution metadata
+   */
   meta: ExecutionMeta;
 }
 /**
@@ -29,16 +39,22 @@ interface ExecutionResult {
  * Contains the block number and variable bindings.
  */
 interface ExecutionContext {
-  /** Block number for consistent reads across all calls */
+  /**
+   *  Block number for consistent reads across all calls
+   */
   blockNumber: bigint;
-  /** Variable name to value mapping from evaluate() context */
+  /**
+   *  Variable name to value mapping from evaluate() context
+   */
   variables: Record<string, unknown>;
 }
 /**
  * Options for the evaluate() call.
  */
 interface EvaluateOptions {
-  /** Override client for this evaluation */
+  /**
+   * Override client for this evaluation
+   */
   client?: SELClient;
 }
 /**
@@ -48,11 +64,21 @@ interface EvaluateOptions {
  * contract calls were executed, absent for pure CEL expressions.
  */
 interface EvaluateResult<T = unknown> {
-  /** The evaluated result value */
+  /**
+   *  The evaluated result value
+   */
   value: T;
-  /** Execution metadata, present when contract calls were executed */
+  /**
+   *  The inferred type of the expression, when available
+   */
+  type?: string;
+  /**
+   *  Execution metadata, present when contract calls were executed
+   */
   meta?: ExecutionMeta;
-  /** Advisory diagnostics (warnings/info) from lint rules, when non-empty */
+  /**
+   *  Advisory diagnostics (warnings/info) from lint rules, when non-empty
+   */
   diagnostics?: SELDiagnostic[];
 }
 //#endregion

package/dist/execution/types.d.mts

@@ -7,11 +7,17 @@ import { SELDiagnostic } from "@seljs/checker";
  * Contains statistics and block information from the execution run.
  */
 interface ExecutionMeta {
-  /** Number of rounds executed (topological depth) */
+  /**
+   * Number of rounds executed (topological depth)
+   */
   roundsExecuted: number;
-  /** Total number of contract calls executed */
+  /**
+   *  Total number of contract calls executed
+   */
   totalCalls: number;
-  /** Block number at which calls were executed */
+  /**
+   * Block number at which calls were executed
+   */
   blockNumber: bigint;
 }
 /**
@@ -19,9 +25,13 @@ interface ExecutionMeta {
  * Maps call IDs to their decoded results.
  */
 interface ExecutionResult {
-  /** Map of callId to decoded result value */
+  /**
+   * Map of callId to decoded result value
+   */
   results: Map<string, unknown>;
-  /** Execution metadata */
+  /**
+   *  Execution metadata
+   */
   meta: ExecutionMeta;
 }
 /**
@@ -29,16 +39,22 @@ interface ExecutionResult {
  * Contains the block number and variable bindings.
  */
 interface ExecutionContext {
-  /** Block number for consistent reads across all calls */
+  /**
+   *  Block number for consistent reads across all calls
+   */
   blockNumber: bigint;
-  /** Variable name to value mapping from evaluate() context */
+  /**
+   *  Variable name to value mapping from evaluate() context
+   */
   variables: Record<string, unknown>;
 }
 /**
  * Options for the evaluate() call.
  */
 interface EvaluateOptions {
-  /** Override client for this evaluation */
+  /**
+   * Override client for this evaluation
+   */
   client?: SELClient;
 }
 /**
@@ -48,11 +64,21 @@ interface EvaluateOptions {
  * contract calls were executed, absent for pure CEL expressions.
  */
 interface EvaluateResult<T = unknown> {
-  /** The evaluated result value */
+  /**
+   *  The evaluated result value
+   */
   value: T;
-  /** Execution metadata, present when contract calls were executed */
+  /**
+   *  The inferred type of the expression, when available
+   */
+  type?: string;
+  /**
+   *  Execution metadata, present when contract calls were executed
+   */
   meta?: ExecutionMeta;
-  /** Advisory diagnostics (warnings/info) from lint rules, when non-empty */
+  /**
+   *  Advisory diagnostics (warnings/info) from lint rules, when non-empty
+   */
   diagnostics?: SELDiagnostic[];
 }
 //#endregion

package/dist/index.cjs

@@ -13,10 +13,8 @@ exports.MulticallBatchError = require_errors.MulticallBatchError;
 exports.SELClientError = require_errors.SELClientError;
 exports.SELContractError = require_errors.SELContractError;
 exports.SELError = _seljs_common.SELError;
-exports.SELEvaluationError = require_errors.SELEvaluationError;
+exports.SELEvaluationError = _seljs_common.SELEvaluationError;
 exports.SELLintError = require_errors.SELLintError;
-exports.SELParseError = _seljs_common.SELParseError;
 exports.SELRuntime = require_environment.SELRuntime;
-exports.SELTypeError = _seljs_common.SELTypeError;
 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, SELParseError, SELTypeError } from "./errors/errors.cjs";
+import { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError } 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, SELParseError, SELRuntime, SELRuntimeConfig, SELTypeError, createSEL, validateClient };
+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 };

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, SELParseError, SELTypeError } from "./errors/errors.mjs";
+import { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError } 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, SELParseError, SELRuntime, SELRuntimeConfig, SELTypeError, createSEL, validateClient };
+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 };

package/dist/index.mjs

@@ -1,7 +1,7 @@
-import { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError, SELParseError, SELTypeError } from "./errors/errors.mjs";
+import { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError } 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, SELParseError, SELRuntime, SELTypeError, createSEL, validateClient };
+export { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError, SELRuntime, createSEL, validateClient };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seljs/runtime",
-  "version": "1.3.0-beta.2",
+  "version": "1.3.0-beta.24",
   "repository": {
     "url": "https://github.com/abinnovision/seljs"
   },
@@ -50,16 +50,16 @@
   },
   "dependencies": {
     "@marcbachmann/cel-js": "^7.5.3",
-    "@seljs/checker": "1.3.0-beta.2",
-    "@seljs/common": "1.3.0-beta.2",
-    "@seljs/env": "1.3.0-beta.2",
+    "@seljs/checker": "1.3.0-beta.24",
+    "@seljs/common": "1.3.0-beta.24",
+    "@seljs/env": "1.3.0-beta.24",
     "@seljs/schema": "1.2.0",
-    "@seljs/types": "1.3.0-beta.2",
+    "@seljs/types": "1.3.0-beta.24",
     "debug": "^4.4.3",
-    "ox": "^0.14.7"
+    "ox": "^0.14.10"
   },
   "devDependencies": {
-    "@abinnovision/eslint-config-base": "^3.2.0",
+    "@abinnovision/eslint-config-base": "^3.2.2",
     "@abinnovision/prettier-config": "^2.1.5",
     "@seljs-internal/fixtures": "0.0.0",
     "@seljs-internal/tsconfig": "^0.0.0",