@seljs/runtime 1.3.0-beta.1 → 1.3.0-beta.3

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/analysis/dependency-analyzer.cjs

@@ -1,8 +1,7 @@
-const require_debug = require("../debug.cjs");
 const require_errors = require("../errors/errors.cjs");
 require("../errors/index.cjs");
 //#region src/analysis/dependency-analyzer.ts
-const debug = require_debug.createLogger("analysis:dependency");
+const debug = require("../debug.cjs").createLogger("analysis:dependency");
 /**
 * Detects circular dependencies in the graph using DFS with a recursion stack.
 *

package/dist/analysis/dependency-analyzer.mjs

@@ -1,6 +1,6 @@
-import { createLogger } from "../debug.mjs";
 import { CircularDependencyError } from "../errors/errors.mjs";
 import "../errors/index.mjs";
+import { createLogger } from "../debug.mjs";
 //#region src/analysis/dependency-analyzer.ts
 const debug = createLogger("analysis:dependency");
 /**

package/dist/analysis/round-planner.cjs

@@ -1,8 +1,7 @@
-const require_debug = require("../debug.cjs");
 const require_errors = require("../errors/errors.cjs");
 require("../errors/index.cjs");
 //#region src/analysis/round-planner.ts
-const debug = require_debug.createLogger("analysis:plan");
+const debug = require("../debug.cjs").createLogger("analysis:plan");
 /**
 * Plans execution rounds from a dependency graph using topological sorting.
 *

package/dist/analysis/round-planner.mjs

@@ -1,6 +1,6 @@
-import { createLogger } from "../debug.mjs";
 import { ExecutionLimitError } from "../errors/errors.mjs";
 import "../errors/index.mjs";
+import { createLogger } from "../debug.mjs";
 //#region src/analysis/round-planner.ts
 const debug = createLogger("analysis:plan");
 /**

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.cjs

@@ -0,0 +1,16 @@
+const require_errors = require("../errors/errors.cjs");
+require("../errors/index.cjs");
+//#region src/environment/client.ts
+/**
+* Validates that an object satisfies the SELClient interface.
+* Throws SELClientError if validation fails.
+* Called at construction time for fail-fast behavior.
+*/
+function validateClient(client) {
+	if (!client || typeof client !== "object") throw new require_errors.SELClientError("Client must be an object");
+	const c = client;
+	if (typeof c["call"] !== "function") throw new require_errors.SELClientError("Client must implement call({ to, data, blockNumber? }). ");
+	if (typeof c["getBlockNumber"] !== "function") throw new require_errors.SELClientError("Client must implement getBlockNumber(). ");
+}
+//#endregion
+exports.validateClient = validateClient;

package/dist/environment/client.d.cts

@@ -0,0 +1,33 @@
+//#region src/environment/client.d.ts
+/**
+ * Minimal client interface for SEL runtime contract execution.
+ *
+ * Framework-agnostic: works with viem PublicClient, ethers.js Provider,
+ * web3.js, or any object that can make eth_call and eth_blockNumber requests.
+ *
+ * A viem PublicClient structurally satisfies this interface.
+ */
+interface SELClient {
+  /**
+   * Execute an eth_call against a contract
+   */
+  call: (params: {
+    to: `0x${string}`;
+    data: `0x${string}`;
+    blockNumber?: bigint;
+  }) => Promise<{
+    data?: `0x${string}`;
+  }>;
+  /**
+   *  Get the current block number (eth_blockNumber) for pinning reads
+   */
+  getBlockNumber: () => Promise<bigint>;
+}
+/**
+ * Validates that an object satisfies the SELClient interface.
+ * Throws SELClientError if validation fails.
+ * Called at construction time for fail-fast behavior.
+ */
+declare function validateClient(client: unknown): asserts client is SELClient;
+//#endregion
+export { SELClient, validateClient };

package/dist/environment/client.d.mts

@@ -0,0 +1,33 @@
+//#region src/environment/client.d.ts
+/**
+ * Minimal client interface for SEL runtime contract execution.
+ *
+ * Framework-agnostic: works with viem PublicClient, ethers.js Provider,
+ * web3.js, or any object that can make eth_call and eth_blockNumber requests.
+ *
+ * A viem PublicClient structurally satisfies this interface.
+ */
+interface SELClient {
+  /**
+   * Execute an eth_call against a contract
+   */
+  call: (params: {
+    to: `0x${string}`;
+    data: `0x${string}`;
+    blockNumber?: bigint;
+  }) => Promise<{
+    data?: `0x${string}`;
+  }>;
+  /**
+   *  Get the current block number (eth_blockNumber) for pinning reads
+   */
+  getBlockNumber: () => Promise<bigint>;
+}
+/**
+ * Validates that an object satisfies the SELClient interface.
+ * Throws SELClientError if validation fails.
+ * Called at construction time for fail-fast behavior.
+ */
+declare function validateClient(client: unknown): asserts client is SELClient;
+//#endregion
+export { SELClient, validateClient };

package/dist/environment/client.mjs

@@ -0,0 +1,16 @@
+import { SELClientError } from "../errors/errors.mjs";
+import "../errors/index.mjs";
+//#region src/environment/client.ts
+/**
+* Validates that an object satisfies the SELClient interface.
+* Throws SELClientError if validation fails.
+* Called at construction time for fail-fast behavior.
+*/
+function validateClient(client) {
+	if (!client || typeof client !== "object") throw new SELClientError("Client must be an object");
+	const c = client;
+	if (typeof c["call"] !== "function") throw new SELClientError("Client must implement call({ to, data, blockNumber? }). ");
+	if (typeof c["getBlockNumber"] !== "function") throw new SELClientError("Client must implement getBlockNumber(). ");
+}
+//#endregion
+export { validateClient };

package/dist/environment/contract-caller.cjs

@@ -1,9 +1,9 @@
 require("../_virtual/_rolldown/runtime.cjs");
-const require_replay_cache = require("./replay-cache.cjs");
-const require_debug = require("../debug.cjs");
 const require_errors = require("../errors/errors.cjs");
 require("../errors/index.cjs");
-let viem_actions = require("viem/actions");
+const require_replay_cache = require("./replay-cache.cjs");
+const require_debug = require("../debug.cjs");
+let ox = require("ox");
 //#region src/environment/contract-caller.ts
 const debug = require_debug.createLogger("contract-caller");
 /**
@@ -42,12 +42,16 @@ const executeContractCall = async (contract, method, args, options) => {
 	});
 	options.callCounter?.increment(contract.name, method.name);
 	try {
-		return await (0, viem_actions.readContract)(options.client, {
-			address: contract.address,
-			abi: [method.abi],
-			functionName: method.name,
-			args: normalizedArgs
+		const data = ox.AbiFunction.encodeData([method.abi], method.name, normalizedArgs);
+		const result = await options.client.call({
+			to: contract.address,
+			data
+		});
+		if (!result.data) throw new require_errors.SELContractError(`Contract call returned no data: ${contract.name}.${method.name}`, {
+			contractName: contract.name,
+			methodName: method.name
 		});
+		return ox.AbiFunction.decodeResult([method.abi], method.name, result.data);
 	} catch (error) {
 		if (error instanceof require_errors.SELContractError) throw error;
 		throw new require_errors.SELContractError(`Contract call failed: ${contract.name}.${method.name}`, {
@@ -58,10 +62,7 @@ const executeContractCall = async (contract, method, args, options) => {
 	}
 };
 const resolveExecutionBlockNumber = async (client) => {
-	const clientWithGetBlockNumber = client;
-	if (typeof clientWithGetBlockNumber.getBlockNumber === "function") return await clientWithGetBlockNumber.getBlockNumber();
-	if (typeof clientWithGetBlockNumber.request === "function") return;
-	return 0n;
+	return await client.getBlockNumber();
 };
 const buildContractInfoMap = (contracts) => {
 	const map = /* @__PURE__ */ new Map();

package/dist/environment/contract-caller.mjs

@@ -1,8 +1,8 @@
-import { createReplayCallId } from "./replay-cache.mjs";
-import { createLogger } from "../debug.mjs";
 import { ExecutionLimitError, SELContractError } from "../errors/errors.mjs";
 import "../errors/index.mjs";
-import { readContract } from "viem/actions";
+import { createReplayCallId } from "./replay-cache.mjs";
+import { createLogger } from "../debug.mjs";
+import { AbiFunction } from "ox";
 //#region src/environment/contract-caller.ts
 const debug = createLogger("contract-caller");
 /**
@@ -41,12 +41,16 @@ const executeContractCall = async (contract, method, args, options) => {
 	});
 	options.callCounter?.increment(contract.name, method.name);
 	try {
-		return await readContract(options.client, {
-			address: contract.address,
-			abi: [method.abi],
-			functionName: method.name,
-			args: normalizedArgs
+		const data = AbiFunction.encodeData([method.abi], method.name, normalizedArgs);
+		const result = await options.client.call({
+			to: contract.address,
+			data
+		});
+		if (!result.data) throw new SELContractError(`Contract call returned no data: ${contract.name}.${method.name}`, {
+			contractName: contract.name,
+			methodName: method.name
 		});
+		return AbiFunction.decodeResult([method.abi], method.name, result.data);
 	} catch (error) {
 		if (error instanceof SELContractError) throw error;
 		throw new SELContractError(`Contract call failed: ${contract.name}.${method.name}`, {
@@ -57,10 +61,7 @@ const executeContractCall = async (contract, method, args, options) => {
 	}
 };
 const resolveExecutionBlockNumber = async (client) => {
-	const clientWithGetBlockNumber = client;
-	if (typeof clientWithGetBlockNumber.getBlockNumber === "function") return await clientWithGetBlockNumber.getBlockNumber();
-	if (typeof clientWithGetBlockNumber.request === "function") return;
-	return 0n;
+	return await client.getBlockNumber();
 };
 const buildContractInfoMap = (contracts) => {
 	const map = /* @__PURE__ */ new Map();

package/dist/environment/environment.cjs

@@ -1,9 +1,11 @@
 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");
 const require_context = require("./context.cjs");
 const require_replay_cache = require("./replay-cache.cjs");
 const require_debug = require("../debug.cjs");
-const require_errors = require("../errors/errors.cjs");
-require("../errors/index.cjs");
 const require_contract_caller = require("./contract-caller.cjs");
 const require_error_wrapper = require("./error-wrapper.cjs");
 const require_call_collector = require("../analysis/call-collector.cjs");
@@ -70,17 +72,22 @@ var SELRuntime = class {
 		this.maxRounds = limits?.maxRounds ?? 10;
 		this.maxCalls = limits?.maxCalls ?? 100;
 		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,
@@ -207,6 +214,7 @@ var SELRuntime = class {
 	async doEvaluate(expression, context, options) {
 		debug("evaluate: %s", expression);
 		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 ?? {});
 			let executionMeta;
@@ -244,6 +252,22 @@ var SELRuntime = class {
 			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

@@ -79,6 +79,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

@@ -79,6 +79,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,8 +1,10 @@
+import { getBuiltinContracts } from "./builtin-contracts.mjs";
+import { MulticallBatchError, SELContractError, SELLintError, SELTypeError } from "../errors/errors.mjs";
+import "../errors/index.mjs";
+import { validateClient } from "./client.mjs";
 import { normalizeContextForEvaluation } from "./context.mjs";
 import { buildExecutionReplayCache } from "./replay-cache.mjs";
 import { createLogger } from "../debug.mjs";
-import { MulticallBatchError, SELContractError, SELLintError, SELTypeError } from "../errors/errors.mjs";
-import "../errors/index.mjs";
 import { CallCounter, buildContractInfoMap, executeContractCall, resolveExecutionBlockNumber } from "./contract-caller.mjs";
 import { wrapError } from "./error-wrapper.mjs";
 import { collectCalls } from "../analysis/call-collector.mjs";
@@ -68,17 +70,22 @@ var SELRuntime = class {
 		this.maxRounds = limits?.maxRounds ?? 10;
 		this.maxCalls = limits?.maxCalls ?? 100;
 		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,
@@ -205,6 +212,7 @@ var SELRuntime = class {
 	async doEvaluate(expression, context, options) {
 		debug("evaluate: %s", expression);
 		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 ?? {});
 			let executionMeta;
@@ -242,6 +250,22 @@ var SELRuntime = class {
 			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/index.cjs

@@ -1 +1,2 @@
+require("./client.cjs");
 require("./environment.cjs");

package/dist/environment/index.d.mts

@@ -1,2 +1,3 @@
+import { SELClient, validateClient } from "./client.mjs";
 import { MulticallOptions, SELLimits, SELRuntimeConfig } from "./types.mjs";
 import { SELRuntime } from "./environment.mjs";

package/dist/environment/index.mjs

@@ -1,2 +1,3 @@
+import "./client.mjs";
 import "./environment.mjs";
 export {};

package/dist/environment/types.d.cts

@@ -1,6 +1,6 @@
+import { SELClient } from "./client.cjs";
 import { SELCheckerOptions } from "@seljs/checker";
 import { SELSchema } from "@seljs/schema";
-import { Address, PublicClient } from "viem";
 
 //#region src/environment/types.d.ts
 /**
@@ -13,7 +13,7 @@ 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;
+  address?: `0x${string}`;
 }
 /**
  * Limits for contract call execution.
@@ -36,8 +36,8 @@ interface SELLimits {
 interface SELRuntimeConfig extends SELCheckerOptions {
   /** SEL schema describing contracts, variables, types, functions, and macros */
   schema: SELSchema;
-  /** Viem public client for executing on-chain contract reads */
-  client?: PublicClient;
+  /** Client for on-chain reads. Any viem PublicClient or SELClient-compatible object. */
+  client?: SELClient;
   /** Multicall3 batching options for contract call execution */
   multicall?: MulticallOptions;
   /** Execution limits for contract call rounds and total calls */

package/dist/environment/types.d.mts

@@ -1,5 +1,5 @@
+import { SELClient } from "./client.mjs";
 import { SELCheckerOptions } from "@seljs/checker";
-import { Address, PublicClient } from "viem";
 import { SELSchema } from "@seljs/schema";
 
 //#region src/environment/types.d.ts
@@ -13,7 +13,7 @@ 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;
+  address?: `0x${string}`;
 }
 /**
  * Limits for contract call execution.
@@ -36,8 +36,8 @@ interface SELLimits {
 interface SELRuntimeConfig extends SELCheckerOptions {
   /** SEL schema describing contracts, variables, types, functions, and macros */
   schema: SELSchema;
-  /** Viem public client for executing on-chain contract reads */
-  client?: PublicClient;
+  /** Client for on-chain reads. Any viem PublicClient or SELClient-compatible object. */
+  client?: SELClient;
   /** Multicall3 batching options for contract call execution */
   multicall?: MulticallOptions;
   /** Execution limits for contract call rounds and total calls */

package/dist/errors/errors.cjs

@@ -61,6 +61,12 @@ var MulticallBatchError = class extends _seljs_common.SELError {
 	}
 };
 /**
+* Thrown when the provided client fails validation or is misconfigured.
+*/
+var SELClientError = class extends _seljs_common.SELError {
+	name = "SELClientError";
+};
+/**
 * Thrown when lint rules with error severity detect violations.
 * Contains the diagnostics that caused the failure.
 */
@@ -76,6 +82,7 @@ var SELLintError = class extends _seljs_common.SELError {
 exports.CircularDependencyError = CircularDependencyError;
 exports.ExecutionLimitError = ExecutionLimitError;
 exports.MulticallBatchError = MulticallBatchError;
+exports.SELClientError = SELClientError;
 exports.SELContractError = SELContractError;
 exports.SELEvaluationError = SELEvaluationError;
 exports.SELLintError = SELLintError;

package/dist/errors/errors.d.cts

@@ -61,6 +61,12 @@ declare class MulticallBatchError extends SELError {
     methodName?: string;
   });
 }
+/**
+ * Thrown when the provided client fails validation or is misconfigured.
+ */
+declare class SELClientError extends SELError {
+  readonly name = "SELClientError";
+}
 /**
  * Thrown when lint rules with error severity detect violations.
  * Contains the diagnostics that caused the failure.
@@ -72,4 +78,4 @@ declare class SELLintError extends SELError {
   });
 }
 //#endregion
-export { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELContractError, SELError, SELEvaluationError, SELLintError, SELParseError, SELTypeError };
+export { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError, SELParseError, SELTypeError };

package/dist/errors/errors.d.mts

@@ -61,6 +61,12 @@ declare class MulticallBatchError extends SELError {
     methodName?: string;
   });
 }
+/**
+ * Thrown when the provided client fails validation or is misconfigured.
+ */
+declare class SELClientError extends SELError {
+  readonly name = "SELClientError";
+}
 /**
  * Thrown when lint rules with error severity detect violations.
  * Contains the diagnostics that caused the failure.
@@ -72,4 +78,4 @@ declare class SELLintError extends SELError {
   });
 }
 //#endregion
-export { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELContractError, SELError, SELEvaluationError, SELLintError, SELParseError, SELTypeError };
+export { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError, SELParseError, SELTypeError };

package/dist/errors/errors.mjs

@@ -60,6 +60,12 @@ var MulticallBatchError = class extends SELError {
 	}
 };
 /**
+* Thrown when the provided client fails validation or is misconfigured.
+*/
+var SELClientError = class extends SELError {
+	name = "SELClientError";
+};
+/**
 * Thrown when lint rules with error severity detect violations.
 * Contains the diagnostics that caused the failure.
 */
@@ -72,4 +78,4 @@ var SELLintError = class extends SELError {
 	}
 };
 //#endregion
-export { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELContractError, SELError, SELEvaluationError, SELLintError, SELParseError, SELTypeError };
+export { CircularDependencyError, ExecutionLimitError, MulticallBatchError, SELClientError, SELContractError, SELError, SELEvaluationError, SELLintError, SELParseError, SELTypeError };

package/dist/errors/index.d.mts

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

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

@@ -1,9 +1,7 @@
-require("../_virtual/_rolldown/runtime.cjs");
 const require_debug = require("../debug.cjs");
 const require_multicall_batcher = require("./multicall-batcher.cjs");
 const require_result_cache = require("./result-cache.cjs");
 const require_round_executor = require("./round-executor.cjs");
-let viem_actions = require("viem/actions");
 //#region src/execution/multi-round-executor.ts
 const debug = require_debug.createLogger("execute");
 var MultiRoundExecutor = class {
@@ -14,13 +12,12 @@ var MultiRoundExecutor = class {
 		this.contracts = contracts;
 	}
 	async execute(plan, variables = {}, blockNumber) {
-		const lockedBlockNumber = blockNumber ?? await (0, viem_actions.getBlockNumber)(this.client);
+		const lockedBlockNumber = blockNumber ?? await this.client.getBlockNumber();
 		debug("start: %d rounds, %d calls, block=%s", plan.rounds.length, plan.totalCalls, String(lockedBlockNumber));
 		const cache = new require_result_cache.ResultCache();
 		const batcher = new require_multicall_batcher.MulticallBatcher(this.client, this.multicallOptions);
 		const executor = new require_round_executor.RoundExecutor(this.contracts, cache, batcher);
 		const context = {
-			client: this.client,
 			blockNumber: lockedBlockNumber,
 			variables
 		};

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

@@ -2,7 +2,6 @@ import { createLogger } from "../debug.mjs";
 import { MulticallBatcher } from "./multicall-batcher.mjs";
 import { ResultCache } from "./result-cache.mjs";
 import { RoundExecutor } from "./round-executor.mjs";
-import { getBlockNumber } from "viem/actions";
 //#region src/execution/multi-round-executor.ts
 const debug = createLogger("execute");
 var MultiRoundExecutor = class {
@@ -13,13 +12,12 @@ var MultiRoundExecutor = class {
 		this.contracts = contracts;
 	}
 	async execute(plan, variables = {}, blockNumber) {
-		const lockedBlockNumber = blockNumber ?? await getBlockNumber(this.client);
+		const lockedBlockNumber = blockNumber ?? await this.client.getBlockNumber();
 		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
 		};

package/dist/execution/multicall-batcher.cjs

@@ -1,9 +1,9 @@
 require("../_virtual/_rolldown/runtime.cjs");
-const require_debug = require("../debug.cjs");
+const require_multicall = require("./multicall.cjs");
 const require_errors = require("../errors/errors.cjs");
 require("../errors/index.cjs");
-const require_multicall = require("./multicall.cjs");
-let viem_actions = require("viem/actions");
+const require_debug = require("../debug.cjs");
+let ox = require("ox");
 //#region src/execution/multicall-batcher.ts
 const debug = require_debug.createLogger("execute:multicall");
 var MulticallBatcher = class {
@@ -32,17 +32,19 @@ var MulticallBatcher = class {
 	}
 	async executeChunk(calls, blockNumber) {
 		try {
-			return (await (0, viem_actions.readContract)(this.client, {
-				address: this.address,
-				abi: require_multicall.multicall3Abi,
-				functionName: "aggregate3",
-				args: [calls],
+			const data = ox.AbiFunction.encodeData(require_multicall.multicall3Function, [calls]);
+			const response = await this.client.call({
+				to: this.address,
+				data,
 				blockNumber
-			})).map((r) => ({
+			});
+			if (!response.data) throw new require_errors.MulticallBatchError("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 });
 		}
 	}

package/dist/execution/multicall-batcher.mjs

@@ -1,8 +1,8 @@
-import { createLogger } from "../debug.mjs";
+import { multicall3Function } from "./multicall.mjs";
 import { MulticallBatchError } from "../errors/errors.mjs";
 import "../errors/index.mjs";
-import { multicall3Abi } from "./multicall.mjs";
-import { readContract } from "viem/actions";
+import { createLogger } from "../debug.mjs";
+import { AbiFunction } from "ox";
 //#region src/execution/multicall-batcher.ts
 const debug = createLogger("execute:multicall");
 var MulticallBatcher = class {
@@ -31,17 +31,19 @@ var MulticallBatcher = class {
 	}
 	async executeChunk(calls, blockNumber) {
 		try {
-			return (await readContract(this.client, {
-				address: this.address,
-				abi: multicall3Abi,
-				functionName: "aggregate3",
-				args: [calls],
+			const data = AbiFunction.encodeData(multicall3Function, [calls]);
+			const response = await this.client.call({
+				to: this.address,
+				data,
 				blockNumber
-			})).map((r) => ({
+			});
+			if (!response.data) throw new MulticallBatchError("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 });
 		}
 	}

package/dist/execution/multicall.cjs

@@ -1,6 +1,7 @@
+require("../_virtual/_rolldown/runtime.cjs");
+let ox = require("ox");
 //#region src/execution/multicall.ts
-const MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
-const multicall3Abi = [{
+const aggregate3Abi = {
 	name: "aggregate3",
 	type: "function",
 	stateMutability: "payable",
@@ -33,7 +34,30 @@ const multicall3Abi = [{
 			type: "bytes"
 		}]
 	}]
-}];
+};
+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.multicall3Abi = multicall3Abi;
+exports.getEthBalanceAbi = getEthBalanceAbi;
+exports.multicall3Function = multicall3Function;

package/dist/execution/multicall.mjs

@@ -1,6 +1,6 @@
+import { AbiFunction } from "ox";
 //#region src/execution/multicall.ts
-const MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
-const multicall3Abi = [{
+const aggregate3Abi = {
 	name: "aggregate3",
 	type: "function",
 	stateMutability: "payable",
@@ -33,6 +33,28 @@ const multicall3Abi = [{
 			type: "bytes"
 		}]
 	}]
-}];
+};
+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, multicall3Abi };
+export { MULTICALL3_ADDRESS, getEthBalanceAbi, multicall3Function };

package/dist/execution/round-executor.cjs

@@ -1,8 +1,8 @@
 require("../_virtual/_rolldown/runtime.cjs");
-const require_debug = require("../debug.cjs");
 const require_errors = require("../errors/errors.cjs");
 require("../errors/index.cjs");
-let viem = require("viem");
+const require_debug = require("../debug.cjs");
+let ox = require("ox");
 //#region src/execution/round-executor.ts
 const debug = require_debug.createLogger("execute:round");
 var RoundExecutor = class {
@@ -27,11 +27,7 @@ var RoundExecutor = class {
 				encodedCalls.push({
 					target: contract.address,
 					allowFailure: false,
-					callData: (0, viem.encodeFunctionData)({
-						abi: contract.abi,
-						functionName: call.method,
-						args: resolvedArgs
-					})
+					callData: ox.AbiFunction.encodeData(contract.abi, call.method, resolvedArgs)
 				});
 			}
 		} catch (error) {
@@ -54,11 +50,7 @@ var RoundExecutor = class {
 				contractName: call.contract,
 				methodName: call.method
 			});
-			const decoded = (0, viem.decodeFunctionResult)({
-				abi: contract.abi,
-				functionName: call.method,
-				data: result.returnData
-			});
+			const decoded = ox.AbiFunction.decodeResult(contract.abi, call.method, result.returnData);
 			debug("decoded %s.%s -> %o", call.contract, call.method, decoded);
 			this.cache.set(call.id, decoded);
 		}

package/dist/execution/round-executor.mjs

@@ -1,7 +1,7 @@
-import { createLogger } from "../debug.mjs";
 import { MulticallBatchError } from "../errors/errors.mjs";
 import "../errors/index.mjs";
-import { decodeFunctionResult, encodeFunctionData } from "viem";
+import { createLogger } from "../debug.mjs";
+import { AbiFunction } from "ox";
 //#region src/execution/round-executor.ts
 const debug = createLogger("execute:round");
 var RoundExecutor = class {
@@ -26,11 +26,7 @@ var RoundExecutor = class {
 				encodedCalls.push({
 					target: contract.address,
 					allowFailure: false,
-					callData: encodeFunctionData({
-						abi: contract.abi,
-						functionName: call.method,
-						args: resolvedArgs
-					})
+					callData: AbiFunction.encodeData(contract.abi, call.method, resolvedArgs)
 				});
 			}
 		} catch (error) {
@@ -53,11 +49,7 @@ var RoundExecutor = class {
 				contractName: call.contract,
 				methodName: call.method
 			});
-			const decoded = decodeFunctionResult({
-				abi: contract.abi,
-				functionName: call.method,
-				data: result.returnData
-			});
+			const decoded = AbiFunction.decodeResult(contract.abi, call.method, result.returnData);
 			debug("decoded %s.%s -> %o", call.contract, call.method, decoded);
 			this.cache.set(call.id, decoded);
 		}

package/dist/execution/types.d.cts

@@ -1,5 +1,5 @@
+import { SELClient } from "../environment/client.cjs";
 import { SELDiagnostic } from "@seljs/checker";
-import { PublicClient } from "viem";
 
 //#region src/execution/types.d.ts
 /**
@@ -26,11 +26,9 @@ interface ExecutionResult {
 }
 /**
  * Context passed to the executor for running contract calls.
- * Contains the client, block number, and variable bindings.
+ * Contains the block number and variable bindings.
  */
 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 */
@@ -40,8 +38,8 @@ interface ExecutionContext {
  * Options for the evaluate() call.
  */
 interface EvaluateOptions {
-  /** Override viem client for this evaluation */
-  client?: PublicClient;
+  /** Override client for this evaluation */
+  client?: SELClient;
 }
 /**
  * Result of evaluating a SEL expression.

package/dist/execution/types.d.mts

@@ -1,5 +1,5 @@
+import { SELClient } from "../environment/client.mjs";
 import { SELDiagnostic } from "@seljs/checker";
-import { PublicClient } from "viem";
 
 //#region src/execution/types.d.ts
 /**
@@ -26,11 +26,9 @@ interface ExecutionResult {
 }
 /**
  * Context passed to the executor for running contract calls.
- * Contains the client, block number, and variable bindings.
+ * Contains the block number and variable bindings.
  */
 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 */
@@ -40,8 +38,8 @@ interface ExecutionContext {
  * Options for the evaluate() call.
  */
 interface EvaluateOptions {
-  /** Override viem client for this evaluation */
-  client?: PublicClient;
+  /** Override client for this evaluation */
+  client?: SELClient;
 }
 /**
  * Result of evaluating a SEL expression.

package/dist/index.cjs

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("./_virtual/_rolldown/runtime.cjs");
 const require_errors = require("./errors/errors.cjs");
 require("./errors/index.cjs");
+const require_client = require("./environment/client.cjs");
 const require_environment = require("./environment/environment.cjs");
 require("./environment/index.cjs");
 const require_factory = require("./factory.cjs");
@@ -9,6 +10,7 @@ let _seljs_common = require("@seljs/common");
 exports.CircularDependencyError = require_errors.CircularDependencyError;
 exports.ExecutionLimitError = require_errors.ExecutionLimitError;
 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;
@@ -17,3 +19,4 @@ 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

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

package/dist/index.d.mts

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

package/dist/index.mjs

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

package/package.json

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