@seljs/env 1.3.0-beta.3 → 1.3.0-beta.32

package/dist/builder.cjs

@@ -238,8 +238,10 @@ const buildSchema = (config) => {
 		version: "1.0.0",
 		contracts,
 		variables: [...contextVariables, ...featureVariables],
+		constants: require_builtins.CEL_BUILTIN_CONSTANTS,
 		types: [
 			...require_builtins.SOLIDITY_PRIMITIVE_TYPES,
+			require_builtins.SEL_NAMESPACE_TYPE,
 			...acc.types,
 			...featureTypes
 		],

package/dist/builder.mjs

@@ -1,4 +1,4 @@
-import { CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SOLIDITY_PRIMITIVE_TYPES } from "./builtins.mjs";
+import { CEL_BUILTIN_CONSTANTS, CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SEL_NAMESPACE_TYPE, SOLIDITY_PRIMITIVE_TYPES } from "./builtins.mjs";
 import { getFeatureDefinition } from "./feature-registry.mjs";
 import { structTypeName } from "@seljs/common";
 import { mapSolidityTypeToCEL } from "@seljs/types";
@@ -238,8 +238,10 @@ const buildSchema = (config) => {
 		version: "1.0.0",
 		contracts,
 		variables: [...contextVariables, ...featureVariables],
+		constants: CEL_BUILTIN_CONSTANTS,
 		types: [
 			...SOLIDITY_PRIMITIVE_TYPES,
+			SEL_NAMESPACE_TYPE,
 			...acc.types,
 			...featureTypes
 		],

package/dist/builtins.cjs

@@ -149,27 +149,27 @@ const CEL_BUILTIN_FUNCTIONS = [
 	},
 	{
 		name: "parseUnits",
-		signature: "parseUnits(string|int|double|sol_int, int): sol_int",
-		description: "Scales a human-readable value by 10^decimals, producing a sol_int. Mirrors viem/ethers parseUnits.",
+		signature: "parseUnits(string|int|double|sol_int, int|sol_int): sol_int",
+		description: "Scales a human-readable value by 10^decimals, producing a sol_int. Mirrors viem/ethers parseUnits. The decimals argument accepts either a plain int or a sol_int (e.g. the return of token.decimals()).",
 		params: [{
 			name: "value",
 			type: "string|int|double|sol_int"
 		}, {
 			name: "decimals",
-			type: "int"
+			type: "int|sol_int"
 		}],
 		returns: "sol_int"
 	},
 	{
 		name: "formatUnits",
-		signature: "formatUnits(sol_int|int, int): double",
-		description: "Scales a sol_int down by 10^decimals, producing a double for readable comparisons.",
+		signature: "formatUnits(sol_int|int, int|sol_int): double",
+		description: "Scales a sol_int down by 10^decimals, producing a double for readable comparisons. The decimals argument accepts either a plain int or a sol_int (e.g. the return of token.decimals()).",
 		params: [{
 			name: "value",
 			type: "sol_int|int"
 		}, {
 			name: "decimals",
-			type: "int"
+			type: "int|sol_int"
 		}],
 		returns: "double"
 	},
@@ -217,6 +217,30 @@ const CEL_BUILTIN_FUNCTIONS = [
 		returns: "sol_int",
 		receiverType: "sol_address"
 	},
+	{
+		name: "sum",
+		signature: "list<sol_int>.sum(): sol_int",
+		description: "Returns the sum of all elements. An empty list sums to 0.",
+		params: [],
+		returns: "sol_int",
+		receiverType: "list<sol_int>"
+	},
+	{
+		name: "min",
+		signature: "list<sol_int>.min(): sol_int",
+		description: "Returns the smallest element. Throws when the list is empty.",
+		params: [],
+		returns: "sol_int",
+		receiverType: "list<sol_int>"
+	},
+	{
+		name: "max",
+		signature: "list<sol_int>.max(): sol_int",
+		description: "Returns the largest element. Throws when the list is empty.",
+		params: [],
+		returns: "sol_int",
+		receiverType: "list<sol_int>"
+	},
 	{
 		name: "isZeroAddress",
 		signature: "isZeroAddress(sol_address|string): bool",
@@ -227,6 +251,49 @@ const CEL_BUILTIN_FUNCTIONS = [
 		}],
 		returns: "bool"
 	},
+	{
+		name: "hexBytes",
+		signature: "hexBytes(string): bytes",
+		description: "Decodes a 0x-prefixed hex string into a bytes value. For pasting pre-computed hashes, role constants, merkle roots, signatures.",
+		params: [{
+			name: "hex",
+			type: "string"
+		}],
+		returns: "bytes"
+	},
+	{
+		name: "hexBytes",
+		signature: "hexBytes(string, int): bytes",
+		description: "Decodes a hex string and asserts the result is exactly N bytes. Use when a bytesN ABI parameter requires a specific length (bytes4 selectors, bytes32 namehashes / EIP-712 digests, bytes65 signatures).",
+		params: [{
+			name: "hex",
+			type: "string"
+		}, {
+			name: "length",
+			type: "int"
+		}],
+		returns: "bytes"
+	},
+	{
+		name: "keccak256",
+		signature: "keccak256(string): bytes",
+		description: "Keccak-256 hash of the UTF-8 encoded string. Use for role identifiers (e.g. keccak256(\"MINTER_ROLE\")), event topic hashes, and EIP-712 type hashes.",
+		params: [{
+			name: "value",
+			type: "string"
+		}],
+		returns: "bytes"
+	},
+	{
+		name: "keccak256",
+		signature: "keccak256(bytes): bytes",
+		description: "Keccak-256 hash of the bytes value.",
+		params: [{
+			name: "value",
+			type: "bytes"
+		}],
+		returns: "bytes"
+	},
 	{
 		name: "timestamp",
 		signature: "timestamp(string): timestamp",
@@ -375,7 +442,36 @@ const SOLIDITY_PRIMITIVE_TYPES = [
 		description: "32-byte fixed array"
 	}
 ];
+/**
+* Struct type backing the `sel.*` namespace — one field per entry in
+* `EVM_CONSTANTS` (e.g. `sel.WAD`, `sel.ZERO_ADDRESS`). Surfacing this in
+* `schema.types` lets editor autocomplete populate member completions on
+* dot-access against `sel`.
+*/
+const SEL_NAMESPACE_TYPE = {
+	name: "SelNamespace",
+	kind: "struct",
+	description: "Namespace for SEL library-provided conveniences.",
+	fields: _seljs_types.EVM_CONSTANTS.map((c) => ({
+		name: c.name,
+		type: c.type,
+		description: c.description
+	}))
+};
+/**
+* Runtime-registered identifiers exposed by every SEL environment. Kept
+* in a dedicated bucket (not `schema.variables`) so the schema-hydration
+* path doesn't try to re-register what `registerSolidityTypes` already
+* bound via `registerConstant`.
+*/
+const CEL_BUILTIN_CONSTANTS = [{
+	name: "sel",
+	type: "SelNamespace",
+	description: "SEL library-provided conveniences: scaling factors, fixed-point divisors, and sentinel addresses."
+}];
 //#endregion
+exports.CEL_BUILTIN_CONSTANTS = CEL_BUILTIN_CONSTANTS;
 exports.CEL_BUILTIN_FUNCTIONS = CEL_BUILTIN_FUNCTIONS;
 exports.CEL_BUILTIN_MACROS = CEL_BUILTIN_MACROS;
+exports.SEL_NAMESPACE_TYPE = SEL_NAMESPACE_TYPE;
 exports.SOLIDITY_PRIMITIVE_TYPES = SOLIDITY_PRIMITIVE_TYPES;

package/dist/builtins.d.cts

@@ -1,4 +1,4 @@
-import { FunctionSchema, MacroSchema, TypeSchema } from "@seljs/schema";
+import { FunctionSchema, MacroSchema, TypeSchema, VariableSchema } from "@seljs/schema";
 
 //#region src/builtins.d.ts
 /**
@@ -16,5 +16,19 @@ declare const CEL_BUILTIN_MACROS: MacroSchema[];
  * These are the basic type building blocks for the schema.
  */
 declare const SOLIDITY_PRIMITIVE_TYPES: TypeSchema[];
+/**
+ * Struct type backing the `sel.*` namespace — one field per entry in
+ * `EVM_CONSTANTS` (e.g. `sel.WAD`, `sel.ZERO_ADDRESS`). Surfacing this in
+ * `schema.types` lets editor autocomplete populate member completions on
+ * dot-access against `sel`.
+ */
+declare const SEL_NAMESPACE_TYPE: TypeSchema;
+/**
+ * Runtime-registered identifiers exposed by every SEL environment. Kept
+ * in a dedicated bucket (not `schema.variables`) so the schema-hydration
+ * path doesn't try to re-register what `registerSolidityTypes` already
+ * bound via `registerConstant`.
+ */
+declare const CEL_BUILTIN_CONSTANTS: VariableSchema[];
 //#endregion
-export { CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SOLIDITY_PRIMITIVE_TYPES };
+export { CEL_BUILTIN_CONSTANTS, CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SEL_NAMESPACE_TYPE, SOLIDITY_PRIMITIVE_TYPES };

package/dist/builtins.d.mts

@@ -1,4 +1,4 @@
-import { FunctionSchema, MacroSchema, TypeSchema } from "@seljs/schema";
+import { FunctionSchema, MacroSchema, TypeSchema, VariableSchema } from "@seljs/schema";
 
 //#region src/builtins.d.ts
 /**
@@ -16,5 +16,19 @@ declare const CEL_BUILTIN_MACROS: MacroSchema[];
  * These are the basic type building blocks for the schema.
  */
 declare const SOLIDITY_PRIMITIVE_TYPES: TypeSchema[];
+/**
+ * Struct type backing the `sel.*` namespace — one field per entry in
+ * `EVM_CONSTANTS` (e.g. `sel.WAD`, `sel.ZERO_ADDRESS`). Surfacing this in
+ * `schema.types` lets editor autocomplete populate member completions on
+ * dot-access against `sel`.
+ */
+declare const SEL_NAMESPACE_TYPE: TypeSchema;
+/**
+ * Runtime-registered identifiers exposed by every SEL environment. Kept
+ * in a dedicated bucket (not `schema.variables`) so the schema-hydration
+ * path doesn't try to re-register what `registerSolidityTypes` already
+ * bound via `registerConstant`.
+ */
+declare const CEL_BUILTIN_CONSTANTS: VariableSchema[];
 //#endregion
-export { CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SOLIDITY_PRIMITIVE_TYPES };
+export { CEL_BUILTIN_CONSTANTS, CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SEL_NAMESPACE_TYPE, SOLIDITY_PRIMITIVE_TYPES };

package/dist/builtins.mjs

@@ -1,4 +1,4 @@
-import { SOLIDITY_TYPES } from "@seljs/types";
+import { EVM_CONSTANTS, SOLIDITY_TYPES } from "@seljs/types";
 //#region src/builtins.ts
 /**
 * Built-in CEL functions available in SEL expressions.
@@ -149,27 +149,27 @@ const CEL_BUILTIN_FUNCTIONS = [
 	},
 	{
 		name: "parseUnits",
-		signature: "parseUnits(string|int|double|sol_int, int): sol_int",
-		description: "Scales a human-readable value by 10^decimals, producing a sol_int. Mirrors viem/ethers parseUnits.",
+		signature: "parseUnits(string|int|double|sol_int, int|sol_int): sol_int",
+		description: "Scales a human-readable value by 10^decimals, producing a sol_int. Mirrors viem/ethers parseUnits. The decimals argument accepts either a plain int or a sol_int (e.g. the return of token.decimals()).",
 		params: [{
 			name: "value",
 			type: "string|int|double|sol_int"
 		}, {
 			name: "decimals",
-			type: "int"
+			type: "int|sol_int"
 		}],
 		returns: "sol_int"
 	},
 	{
 		name: "formatUnits",
-		signature: "formatUnits(sol_int|int, int): double",
-		description: "Scales a sol_int down by 10^decimals, producing a double for readable comparisons.",
+		signature: "formatUnits(sol_int|int, int|sol_int): double",
+		description: "Scales a sol_int down by 10^decimals, producing a double for readable comparisons. The decimals argument accepts either a plain int or a sol_int (e.g. the return of token.decimals()).",
 		params: [{
 			name: "value",
 			type: "sol_int|int"
 		}, {
 			name: "decimals",
-			type: "int"
+			type: "int|sol_int"
 		}],
 		returns: "double"
 	},
@@ -217,6 +217,30 @@ const CEL_BUILTIN_FUNCTIONS = [
 		returns: "sol_int",
 		receiverType: "sol_address"
 	},
+	{
+		name: "sum",
+		signature: "list<sol_int>.sum(): sol_int",
+		description: "Returns the sum of all elements. An empty list sums to 0.",
+		params: [],
+		returns: "sol_int",
+		receiverType: "list<sol_int>"
+	},
+	{
+		name: "min",
+		signature: "list<sol_int>.min(): sol_int",
+		description: "Returns the smallest element. Throws when the list is empty.",
+		params: [],
+		returns: "sol_int",
+		receiverType: "list<sol_int>"
+	},
+	{
+		name: "max",
+		signature: "list<sol_int>.max(): sol_int",
+		description: "Returns the largest element. Throws when the list is empty.",
+		params: [],
+		returns: "sol_int",
+		receiverType: "list<sol_int>"
+	},
 	{
 		name: "isZeroAddress",
 		signature: "isZeroAddress(sol_address|string): bool",
@@ -227,6 +251,49 @@ const CEL_BUILTIN_FUNCTIONS = [
 		}],
 		returns: "bool"
 	},
+	{
+		name: "hexBytes",
+		signature: "hexBytes(string): bytes",
+		description: "Decodes a 0x-prefixed hex string into a bytes value. For pasting pre-computed hashes, role constants, merkle roots, signatures.",
+		params: [{
+			name: "hex",
+			type: "string"
+		}],
+		returns: "bytes"
+	},
+	{
+		name: "hexBytes",
+		signature: "hexBytes(string, int): bytes",
+		description: "Decodes a hex string and asserts the result is exactly N bytes. Use when a bytesN ABI parameter requires a specific length (bytes4 selectors, bytes32 namehashes / EIP-712 digests, bytes65 signatures).",
+		params: [{
+			name: "hex",
+			type: "string"
+		}, {
+			name: "length",
+			type: "int"
+		}],
+		returns: "bytes"
+	},
+	{
+		name: "keccak256",
+		signature: "keccak256(string): bytes",
+		description: "Keccak-256 hash of the UTF-8 encoded string. Use for role identifiers (e.g. keccak256(\"MINTER_ROLE\")), event topic hashes, and EIP-712 type hashes.",
+		params: [{
+			name: "value",
+			type: "string"
+		}],
+		returns: "bytes"
+	},
+	{
+		name: "keccak256",
+		signature: "keccak256(bytes): bytes",
+		description: "Keccak-256 hash of the bytes value.",
+		params: [{
+			name: "value",
+			type: "bytes"
+		}],
+		returns: "bytes"
+	},
 	{
 		name: "timestamp",
 		signature: "timestamp(string): timestamp",
@@ -375,5 +442,32 @@ const SOLIDITY_PRIMITIVE_TYPES = [
 		description: "32-byte fixed array"
 	}
 ];
+/**
+* Struct type backing the `sel.*` namespace — one field per entry in
+* `EVM_CONSTANTS` (e.g. `sel.WAD`, `sel.ZERO_ADDRESS`). Surfacing this in
+* `schema.types` lets editor autocomplete populate member completions on
+* dot-access against `sel`.
+*/
+const SEL_NAMESPACE_TYPE = {
+	name: "SelNamespace",
+	kind: "struct",
+	description: "Namespace for SEL library-provided conveniences.",
+	fields: EVM_CONSTANTS.map((c) => ({
+		name: c.name,
+		type: c.type,
+		description: c.description
+	}))
+};
+/**
+* Runtime-registered identifiers exposed by every SEL environment. Kept
+* in a dedicated bucket (not `schema.variables`) so the schema-hydration
+* path doesn't try to re-register what `registerSolidityTypes` already
+* bound via `registerConstant`.
+*/
+const CEL_BUILTIN_CONSTANTS = [{
+	name: "sel",
+	type: "SelNamespace",
+	description: "SEL library-provided conveniences: scaling factors, fixed-point divisors, and sentinel addresses."
+}];
 //#endregion
-export { CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SOLIDITY_PRIMITIVE_TYPES };
+export { CEL_BUILTIN_CONSTANTS, CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SEL_NAMESPACE_TYPE, SOLIDITY_PRIMITIVE_TYPES };

package/dist/index.cjs

@@ -1,7 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_builtins = require("./builtins.cjs");
 const require_builder = require("./builder.cjs");
+exports.CEL_BUILTIN_CONSTANTS = require_builtins.CEL_BUILTIN_CONSTANTS;
 exports.CEL_BUILTIN_FUNCTIONS = require_builtins.CEL_BUILTIN_FUNCTIONS;
 exports.CEL_BUILTIN_MACROS = require_builtins.CEL_BUILTIN_MACROS;
+exports.SEL_NAMESPACE_TYPE = require_builtins.SEL_NAMESPACE_TYPE;
 exports.SOLIDITY_PRIMITIVE_TYPES = require_builtins.SOLIDITY_PRIMITIVE_TYPES;
 exports.buildSchema = require_builder.buildSchema;

package/dist/index.d.cts

@@ -1,3 +1,3 @@
 import { ContractInput, SchemaBuilderConfig, buildSchema } from "./builder.cjs";
-import { CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SOLIDITY_PRIMITIVE_TYPES } from "./builtins.cjs";
-export { CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, ContractInput, SOLIDITY_PRIMITIVE_TYPES, SchemaBuilderConfig, buildSchema };
+import { CEL_BUILTIN_CONSTANTS, CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SEL_NAMESPACE_TYPE, SOLIDITY_PRIMITIVE_TYPES } from "./builtins.cjs";
+export { CEL_BUILTIN_CONSTANTS, CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, ContractInput, SEL_NAMESPACE_TYPE, SOLIDITY_PRIMITIVE_TYPES, SchemaBuilderConfig, buildSchema };

package/dist/index.d.mts

@@ -1,3 +1,3 @@
 import { ContractInput, SchemaBuilderConfig, buildSchema } from "./builder.mjs";
-import { CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SOLIDITY_PRIMITIVE_TYPES } from "./builtins.mjs";
-export { CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, ContractInput, SOLIDITY_PRIMITIVE_TYPES, SchemaBuilderConfig, buildSchema };
+import { CEL_BUILTIN_CONSTANTS, CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SEL_NAMESPACE_TYPE, SOLIDITY_PRIMITIVE_TYPES } from "./builtins.mjs";
+export { CEL_BUILTIN_CONSTANTS, CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, ContractInput, SEL_NAMESPACE_TYPE, SOLIDITY_PRIMITIVE_TYPES, SchemaBuilderConfig, buildSchema };

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SOLIDITY_PRIMITIVE_TYPES } from "./builtins.mjs";
+import { CEL_BUILTIN_CONSTANTS, CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SEL_NAMESPACE_TYPE, SOLIDITY_PRIMITIVE_TYPES } from "./builtins.mjs";
 import { buildSchema } from "./builder.mjs";
-export { CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SOLIDITY_PRIMITIVE_TYPES, buildSchema };
+export { CEL_BUILTIN_CONSTANTS, CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SEL_NAMESPACE_TYPE, SOLIDITY_PRIMITIVE_TYPES, buildSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seljs/env",
-  "version": "1.3.0-beta.3",
+  "version": "1.3.0-beta.32",
   "repository": {
     "url": "https://github.com/abinnovision/seljs"
   },
@@ -48,14 +48,14 @@
     ]
   },
   "dependencies": {
-    "@seljs/common": "1.3.0-beta.3",
+    "@seljs/common": "1.3.0-beta.32",
     "@seljs/schema": "1.2.0",
-    "@seljs/types": "1.3.0-beta.3",
+    "@seljs/types": "1.3.0-beta.32",
     "abitype": "^1.2.3",
-    "viem": "^2.47.2"
+    "viem": "^2.47.6"
   },
   "devDependencies": {
-    "@abinnovision/eslint-config-base": "^3.2.0",
+    "@abinnovision/eslint-config-base": "^3.2.2",
     "@abinnovision/prettier-config": "^2.1.5",
     "@seljs-internal/tsconfig": "^0.0.0",
     "eslint": "^9.39.4",