@seljs/runtime 1.3.0-beta.2 → 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/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/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");
@@ -73,16 +74,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,
@@ -247,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,3 +1,4 @@
+import { getBuiltinContracts } from "./builtin-contracts.mjs";
 import { MulticallBatchError, SELContractError, SELLintError, SELTypeError } from "../errors/errors.mjs";
 import "../errors/index.mjs";
 import { validateClient } from "./client.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,
@@ -245,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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seljs/runtime",
-  "version": "1.3.0-beta.2",
+  "version": "1.3.0-beta.3",
   "repository": {
     "url": "https://github.com/abinnovision/seljs"
   },
@@ -50,11 +50,11 @@
   },
   "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.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.2",
+    "@seljs/types": "1.3.0-beta.3",
     "debug": "^4.4.3",
     "ox": "^0.14.7"
   },