zksync-sso 0.5.0-beta.3 → 1.0.0-beta.2

package/dist/_esm/client/session/account.js

@@ -1,41 +1,122 @@
-import { hashTypedData } from "viem";
-import { toAccount } from "viem/accounts";
-import { serializeTransaction } from "viem/zksync";
-import { getEip712Domain } from "../utils/getEip712Domain.js";
-export function toSessionAccount(parameters) {
-    const { address, signTransaction } = parameters;
-    const account = toAccount({
-        address,
-        async signTransaction(transaction) {
-            const signableTransaction = {
-                ...transaction,
-                from: this.address,
-                type: "eip712",
-            };
-            const eip712DomainAndMessage = getEip712Domain(signableTransaction);
-            const digest = hashTypedData(eip712DomainAndMessage);
-            return serializeTransaction({
-                ...signableTransaction,
-                customSignature: await signTransaction({
-                    hash: digest,
-                    to: signableTransaction.to,
-                    callData: signableTransaction.data,
-                }),
+import {} from "viem";
+import { entryPoint08Abi, entryPoint08Address, getUserOperationHash, toSmartAccount, } from "viem/account-abstraction";
+import { decode_nonce_result, encode_get_nonce_call_data, encode_session_execute_call_data, generate_session_stub_signature_wasm, keyed_nonce_decimal, session_signature_no_validation_wasm, } from "zksync-sso-web-sdk/bundler";
+import { sessionSpecToJSON } from "./utils.js";
+/**
+ * Builds a SSO SmartAccount instance which uses a session key for signing within policy limits.
+ * This allows delegated transaction signing with enforced limits on gas fees, transfer values, and call parameters.
+ */
+export async function toSessionSmartAccount({ client, sessionKeyPrivateKey, address, contracts, sessionSpec, currentTimestamp, entryPointAddress, }) {
+    // Precompute session spec JSON once
+    const sessionSpecJSON = sessionSpecToJSON(sessionSpec);
+    const epAddress = entryPointAddress ?? entryPoint08Address;
+    return toSmartAccount({
+        client,
+        entryPoint: {
+            abi: entryPoint08Abi,
+            address: epAddress,
+            version: "0.8",
+        },
+        async getNonce() {
+            const sender = await this.getAddress();
+            // Get the nonce key for this session signer
+            const nonceKeyDecimal = keyed_nonce_decimal(sessionSpec.signer);
+            // Encode the getNonce call with the session's nonce key
+            const calldata = encode_get_nonce_call_data(sender, nonceKeyDecimal);
+            const result = await client.request({
+                method: "eth_call",
+                params: [{
+                        from: sender,
+                        to: epAddress,
+                        data: calldata,
+                    }],
             });
+            const nonceStr = decode_nonce_result(result);
+            return BigInt(nonceStr);
+        },
+        // --- Calls encoding (session execute only - batch not supported yet) ---
+        async encodeCalls(calls) {
+            // Only support single calls (no batch operations)
+            if (calls.length !== 1) {
+                throw new Error("Batch transactions are not supported for session accounts. Only single execute() calls are allowed.");
+            }
+            const call = calls[0];
+            // Use Rust SDK for encoding session execute
+            const valueStr = (call.value ?? 0n).toString();
+            const encoded = encode_session_execute_call_data(call.to, valueStr, call.data ?? "0x");
+            return encoded;
+        },
+        async decodeCalls() {
+            throw new Error("decodeCalls is not supported yet for session accounts.");
+        },
+        // --- Address & factory args ---
+        async getAddress() {
+            // Return the provided address (no counterfactual support yet)
+            return address;
         },
-        sign: async () => {
-            throw new Error(`account.sign not supported for SSO Session Client`);
+        async getFactoryArgs() {
+            // No counterfactual deployment support yet
+            throw new Error("getFactoryArgs is not supported for session accounts. Deploy the account first and provide the address.");
         },
-        signMessage: async () => {
-            throw new Error(`account.signMessage not supported for SSO Session Client`);
+        // --- Stubs & signing ---
+        async getStubSignature() {
+            // Generate session stub signature for gas estimation
+            const timestampStr = currentTimestamp?.toString();
+            return generate_session_stub_signature_wasm(contracts.sessionValidator, sessionSpecJSON, timestampStr);
         },
-        signTypedData: async () => {
-            throw new Error(`account.signTypedData not supported for SSO Session Client`);
+        async signMessage({ message }) {
+            throw new Error(`signMessage is not supported for session accounts. Message: ${String(message)}`);
+        },
+        async signTypedData() {
+            throw new Error("signTypedData is not supported for session accounts");
+        },
+        async signUserOperation(params) {
+            const sender = await this.getAddress();
+            // Default undefined fields to 0n to avoid runtime errors during early signing.
+            const nonce = params.nonce ?? 0n;
+            const callGasLimit = params.callGasLimit ?? 0n;
+            const verificationGasLimit = params.verificationGasLimit ?? 0n;
+            const preVerificationGas = params.preVerificationGas ?? 0n;
+            const maxFeePerGas = params.maxFeePerGas ?? 0n;
+            const maxPriorityFeePerGas = params.maxPriorityFeePerGas ?? 0n;
+            const paymasterAndData = (params.paymasterAndData ?? "0x");
+            // Debug: Log effective gas & nonce passed into signing to diagnose zero-gas AA23 issues
+            console.debug("[toSessionSmartAccount] signUserOperation params:", {
+                nonce: nonce.toString(),
+                callGasLimit: callGasLimit.toString(),
+                verificationGasLimit: verificationGasLimit.toString(),
+                preVerificationGas: preVerificationGas.toString(),
+                maxFeePerGas: maxFeePerGas.toString(),
+                maxPriorityFeePerGas: maxPriorityFeePerGas.toString(),
+            });
+            // Compute user operation hash locally using viem helper (includes paymasterAndData)
+            const userOpHash = getUserOperationHash({
+                chainId: Number(client.chain.id),
+                entryPointAddress: this.entryPoint.address,
+                entryPointVersion: "0.8",
+                userOperation: {
+                    sender,
+                    nonce,
+                    initCode: (params.initCode ?? "0x"),
+                    callData: (params.callData ?? "0x"),
+                    callGasLimit,
+                    verificationGasLimit,
+                    preVerificationGas,
+                    maxFeePerGas,
+                    maxPriorityFeePerGas,
+                    paymasterAndData,
+                    signature: "0x",
+                },
+            });
+            // Parse target and selector from callData for validation
+            // The callData is already encoded by encodeCalls, so we need to extract execute() params
+            // For now, we'll trust that the session policies are validated at contract level
+            // In a full implementation, you'd decode the execute call to validate against session spec
+            const timestampStr = currentTimestamp?.toString();
+            // Sign using session key with no validation (contract will validate)
+            const signature = session_signature_no_validation_wasm(sessionKeyPrivateKey, contracts.sessionValidator, sessionSpecJSON, userOpHash, timestampStr);
+            return signature;
         },
     });
-    return {
-        ...account,
-        source: "ssoSessionAccount",
-    };
 }
 //# sourceMappingURL=account.js.map

package/dist/_esm/client/session/account.js.map

@@ -1 +1 @@
-{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../../src/client/session/account.ts"],"names":[],"mappings":"AACA,OAAO,EAAgC,aAAa,EAA+B,MAAM,MAAM,CAAC;AAChG,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAA4C,MAAM,aAAa,CAAC;AAE7F,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAY9D,MAAM,UAAU,gBAAgB,CAC9B,UAAsC;IAEtC,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,UAAU,CAAC;IAEhD,MAAM,OAAO,GAAG,SAAS,CAAC;QACxB,OAAO;QACP,KAAK,CAAC,eAAe,CAAC,WAAW;YAC/B,MAAM,mBAAmB,GAAG;gBAC1B,GAAG,WAAW;gBACd,IAAI,EAAE,IAAI,CAAC,OAAQ;gBACnB,IAAI,EAAE,QAAQ;aACwB,CAAC;YAEzC,MAAM,sBAAsB,GAAG,eAAe,CAAC,mBAAmB,CAAC,CAAC;YACpE,MAAM,MAAM,GAAG,aAAa,CAAC,sBAAsB,CAAC,CAAC;YAErD,OAAO,oBAAoB,CAAC;gBAC1B,GAAG,mBAAmB;gBACtB,eAAe,EAAE,MAAM,eAAe,CAAC;oBACrC,IAAI,EAAE,MAAM;oBACZ,EAAE,EAAE,mBAAmB,CAAC,EAAG;oBAC3B,QAAQ,EAAE,mBAAmB,CAAC,IAAI;iBACnC,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QACD,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,WAAW,EAAE,KAAK,IAAI,EAAE;YACtB,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,CAAC;QACD,aAAa,EAAE,KAAK,IAAI,EAAE;YACxB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,OAAO;QACV,MAAM,EAAE,mBAAmB;KACV,CAAC;AACtB,CAAC"}
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../../src/client/session/account.ts"],"names":[],"mappings":"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"}

package/dist/_esm/client/session/client-actions.js

@@ -0,0 +1,20 @@
+import { smartAccountClientActions, } from "../common/smart-account-client-actions.js";
+import { toSessionSmartAccount } from "./account.js";
+/**
+ * Decorator providing session-specific client actions
+ */
+export function sessionClientActions(config) {
+    const base = smartAccountClientActions({
+        bundler: config.bundler,
+        accountFactory: () => toSessionSmartAccount(config.sessionAccount),
+        client: config.client,
+        accountAddress: config.accountAddress,
+        paymaster: config.paymaster,
+    });
+    return {
+        ...base,
+        // Remove addPasskey (not valid for session-only signing)
+        addPasskey: undefined,
+    };
+}
+//# sourceMappingURL=client-actions.js.map

package/dist/_esm/client/session/client-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-actions.js","sourceRoot":"","sources":["../../../../src/client/session/client-actions.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,yBAAyB,GAC1B,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAoC,MAAM,cAAc,CAAC;AAwBvF;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAKlC,MAAgG;IAEhG,MAAM,IAAI,GAAG,yBAAyB,CAA+B;QACnE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,cAAc,EAAE,GAAG,EAAE,CAAC,qBAAqB,CAAC,MAAM,CAAC,cAAc,CAAC;QAClE,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,IAAI;QACP,yDAAyD;QACzD,UAAU,EAAE,SAAkB;KACgD,CAAC;AACnF,CAAC"}

package/dist/_esm/client/session/client.js

@@ -1,92 +1,42 @@
-import { createClient, createPublicClient, encodeAbiParameters, getAddress, publicActions } from "viem";
-import { privateKeyToAccount } from "viem/accounts";
-import { zksyncInMemoryNode } from "viem/chains";
-import { encodeSessionTx } from "../../utils/encoding.js";
-import { toSessionAccount } from "./account.js";
-import { getSessionState, sessionStateNotify } from "./actions/session.js";
-import { publicActionsRewrite } from "./decorators/publicActionsRewrite.js";
-import { zksyncSsoWalletActions } from "./decorators/wallet.js";
-export const signSessionTransaction = (args) => {
-    return encodeAbiParameters([
-        { type: "bytes", name: "sessionKeySignedHash" },
-        { type: "address", name: "sessionContract" },
-        { type: "bytes", name: "validatorData" },
-    ], [
-        args.sessionKeySignedHash,
-        args.sessionContract,
-        encodeSessionTx({
-            sessionConfig: args.sessionConfig,
-            to: args.to,
-            callData: args.callData,
-            timestamp: args.timestamp,
-        }),
-    ]);
-};
-export function createZksyncSessionClient(_parameters) {
-    const parameters = {
-        ..._parameters,
-        address: getAddress(_parameters.address),
-        key: _parameters.key || "zksync-sso-session-wallet",
-        name: _parameters.name || "ZKsync SSO Session Client",
+import { createClient, createPublicClient, publicActions, walletActions, } from "viem";
+import { sessionClientActions } from "./client-actions.js";
+/**
+ * Create a client wrapping a session smart account. Provides wallet-like API
+ * plus helpers for session creation & state queries. Transactions sent via
+ * sendTransaction or sendSessionTransaction are encoded as session execute() calls.
+ */
+export function createSessionClient(params) {
+    const { address, contracts, sessionKeyPrivateKey, sessionSpec, bundlerClient, chain, transport, currentTimestamp, paymaster, } = params;
+    const publicClient = createPublicClient({ chain, transport });
+    const sessionAccountParams = {
+        client: publicClient,
+        address,
+        contracts,
+        sessionKeyPrivateKey,
+        sessionSpec,
+        currentTimestamp,
+        entryPointAddress: params.entryPointAddress,
     };
-    const getInMemoryNodeTimestamp = async () => {
-        const publicClient = createPublicClient({ chain: parameters.chain, transport: parameters.transport });
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const timestamp = await publicClient.request({ method: "config_getCurrentTimestamp" });
-        return BigInt(timestamp);
-    };
-    const account = toSessionAccount({
-        address: parameters.address,
-        signTransaction: async ({ hash, to, callData }) => {
-            // In Memory Node uses a different timestamp mechanism which isn't equal to actual timestamp
-            const timestamp = parameters.chain.id === zksyncInMemoryNode.id
-                ? await getInMemoryNodeTimestamp()
-                : undefined;
-            const sessionKeySigner = privateKeyToAccount(parameters.sessionKey);
-            const hashSignature = await sessionKeySigner.sign({ hash });
-            return signSessionTransaction({
-                sessionKeySignedHash: hashSignature,
-                sessionContract: parameters.contracts.session,
-                sessionConfig: parameters.sessionConfig,
-                to,
-                callData,
-                timestamp,
-            });
-        },
-    });
     const client = createClient({
-        ...parameters,
-        account,
+        chain,
+        transport,
+        account: undefined,
         type: "walletClient",
+        key: params.key || "zksync-sso-session-client",
+        name: params.name || "ZKsync SSO Session Client",
     })
-        .extend(() => ({
-        sessionKey: parameters.sessionKey,
-        sessionConfig: parameters.sessionConfig,
-        contracts: parameters.contracts,
-        paymasterHandler: parameters.paymasterHandler,
-        onSessionStateChange: parameters.onSessionStateChange,
-        _sessionNotifyTimeout: undefined,
-    }))
         .extend(publicActions)
-        .extend(publicActionsRewrite)
-        .extend(zksyncSsoWalletActions);
-    // Check session state on initialization if callback is provided
-    if (client.onSessionStateChange) {
-        getSessionState(client, {
-            account: client.account.address,
-            sessionConfig: client.sessionConfig,
-            contracts: client.contracts,
-        }).then(({ sessionState }) => {
-            sessionStateNotify({
-                sessionConfig: client.sessionConfig,
-                sessionState,
-                onSessionStateChange: client.onSessionStateChange,
-                sessionNotifyTimeout: client._sessionNotifyTimeout,
-            });
-        }).catch((error) => {
-            console.error("Failed to get session state on initialization:", error);
-        });
-    }
+        .extend(walletActions)
+        .extend((client) => sessionClientActions({
+        client,
+        bundler: bundlerClient,
+        sessionAccount: sessionAccountParams,
+        accountAddress: address,
+        paymaster,
+    }))
+        .extend(() => ({
+        bundler: bundlerClient,
+    }));
     return client;
 }
 //# sourceMappingURL=client.js.map

package/dist/_esm/client/session/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/client/session/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/client/session/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,YAAY,EACZ,kBAAkB,EAIlB,aAAa,EAIb,aAAa,GAEd,MAAM,MAAM,CAAC;AAKd,OAAO,EAA6B,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAqDtF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAKjC,MAAqD;IAErD,MAAM,EACJ,OAAO,EACP,SAAS,EACT,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,KAAK,EACL,SAAS,EACT,gBAAgB,EAChB,SAAS,GACV,GAAG,MAAM,CAAC;IAEX,MAAM,YAAY,GAAG,kBAAkB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAE9D,MAAM,oBAAoB,GAAgC;QACxD,MAAM,EAAE,YAAqD;QAC7D,OAAO;QACP,SAAS;QACT,oBAAoB;QACpB,WAAW;QACX,gBAAgB;QAChB,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;KAC5C,CAAC;IAEF,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,KAAK;QACL,SAAS;QACT,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,cAAc;QACpB,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,2BAA2B;QAC9C,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,2BAA2B;KACjD,CAAC;SACC,MAAM,CAAC,aAAa,CAAC;SACrB,MAAM,CAAC,aAAa,CAAC;SACrB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CACjB,oBAAoB,CAAC;QACnB,MAAM;QACN,OAAO,EAAE,aAAa;QACtB,cAAc,EAAE,oBAAoB;QACpC,cAAc,EAAE,OAAO;QACvB,SAAS;KACV,CAAC,CACH;SACA,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;QACb,OAAO,EAAE,aAAa;KACvB,CAAC,CAAC,CAAC;IAEN,OAAO,MAAuD,CAAC;AACjE,CAAC"}

package/dist/_esm/client/session/formatSessionPreferences.js

@@ -0,0 +1,283 @@
+import { encodeAbiParameters, getAddress, toFunctionSelector, toHex, } from "viem";
+import { ConstraintCondition, LimitType, LimitUnlimited, LimitZero, } from "./types.js";
+// Typesafety helper function
+export const callPolicy = (policy) => policy;
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Convert ms string format (e.g. "1h", "24h", "7d") to seconds as bigint
+ * Supports formats: ms, s, m, h, d, w, y
+ */
+export const msStringToSeconds = (value) => {
+    const units = {
+        ms: 0.001,
+        s: 1,
+        m: 60,
+        h: 3600,
+        d: 86400,
+        w: 604800,
+        y: 31536000,
+    };
+    const match = value.match(/^(\d+(?:\.\d+)?)(ms|s|m|h|d|w|y)$/);
+    if (!match) {
+        throw new Error(`Invalid date format: ${value}. Expected format like "1h", "24h", "7d"`);
+    }
+    const [, numStr, unit] = match;
+    const num = parseFloat(numStr);
+    const seconds = num * units[unit];
+    if (seconds < 0)
+        throw new Error(`Date can't be in the past: ${value}`);
+    if (seconds === 0)
+        throw new Error(`Date can't be zero: ${value}`);
+    return BigInt(Math.floor(seconds));
+};
+const DYNAMIC_ABI_INPUT_TYPES = ["bytes", "string"];
+export const isDynamicInputType = (inputType) => {
+    return inputType.endsWith("[]") || DYNAMIC_ABI_INPUT_TYPES.includes(inputType);
+};
+const includesDynamicInputType = (abiParameters) => {
+    return abiParameters.some((input) => {
+        const isDynamicType = isDynamicInputType(input.type);
+        if (isDynamicType)
+            return true;
+        if (input.type.startsWith("tuple")) {
+            const components = input.components;
+            if (!components)
+                throw new Error("Tuple without components is unsupported");
+            return includesDynamicInputType(components);
+        }
+        return false;
+    });
+};
+export const isFollowedByDynamicInputType = (abiFunction, targetInputIndex) => {
+    if (targetInputIndex >= abiFunction.inputs.length) {
+        throw new Error(`Input index ${targetInputIndex} is out of bounds`);
+    }
+    return includesDynamicInputType(abiFunction.inputs.slice(0, targetInputIndex));
+};
+export const encodedInputToAbiChunks = (encodedInput) => {
+    if (!encodedInput.startsWith("0x")) {
+        throw new Error("Input is not a valid hex string");
+    }
+    return (encodedInput.slice(2).match(/.{1,64}/g) || []).map((e) => `0x${e}`); // 32 bytes abi chunks
+};
+const getDummyBytesValue = (type) => {
+    const size = parseInt(type.slice(5)) || 32;
+    return toHex("", { size });
+};
+// Function to generate dummy values for ABI types
+const getDummyValue = (type) => {
+    if (type === "address")
+        return "0x36615Cf349d7F6344891B1e7CA7C72883F5dc049";
+    if (type.startsWith("uint") || type.startsWith("int"))
+        return 0n; // BigInt for numbers
+    if (type.startsWith("bytes"))
+        return getDummyBytesValue(type); // Empty bytes
+    if (type === "bool")
+        return false;
+    if (type === "string")
+        return ""; // Empty string
+    throw new Error(`Unsupported ABI type: ${type}`);
+};
+function getArrayComponents(type) {
+    const matches = type.match(/^(.*)\[(\d+)?\]$/);
+    return matches
+        ? [matches[2] ? Number(matches[2]) : null, matches[1]]
+        : undefined;
+}
+// Recursive function to fill dummy values for complex types like tuples
+const getDummyValues = (inputs) => {
+    return inputs.map((input) => {
+        const arrayComponents = getArrayComponents(input.type);
+        if (arrayComponents) {
+            // Recursively fill array components
+            const [length, innerType] = arrayComponents;
+            if (!length)
+                throw new Error("Dynamic array length is unsupported");
+            const arrayValue = Array.from({ length }, () => getDummyValues([{
+                    ...input,
+                    type: innerType,
+                }]));
+            return arrayValue;
+        }
+        if (input.type.startsWith("tuple")) {
+            // Recursively fill tuple components
+            const components = input.components;
+            if (!components)
+                throw new Error("Tuple without components is unsupported");
+            return getDummyValues(components);
+        }
+        return getDummyValue(input.type);
+    });
+};
+export const getParameterChunkIndex = (abiFunction, targetInputIndex) => {
+    if (targetInputIndex >= abiFunction.inputs.length) {
+        throw new Error(`Input index ${targetInputIndex} is out of bounds`);
+    }
+    const inputs = abiFunction.inputs.slice(0, targetInputIndex);
+    const dummyValues = getDummyValues(inputs);
+    const encoded = encodeAbiParameters(inputs, dummyValues);
+    const chunks = encodedInputToAbiChunks(encoded);
+    const chunkIndex = chunks.length;
+    return chunkIndex;
+};
+// ============================================================================
+// Format Functions
+// ============================================================================
+/**
+ * Format user-friendly limit preferences to full UsageLimit
+ */
+export const formatLimitPreferences = (limit) => {
+    /* Just bigint was passed */
+    if (typeof limit === "bigint") {
+        return {
+            limitType: LimitType.Lifetime,
+            limit,
+            period: 0n,
+        };
+    }
+    /* LimitType was specified */
+    if ("limitType" in limit) {
+        if (limit.limitType === "lifetime" || limit.limitType === LimitType.Lifetime) {
+            return {
+                limitType: LimitType.Lifetime,
+                limit: limit.limit,
+                period: 0n,
+            };
+        }
+        else if (limit.limitType === "unlimited" || limit.limitType === LimitType.Unlimited) {
+            return {
+                limitType: LimitType.Unlimited,
+                limit: 0n,
+                period: 0n,
+            };
+        }
+        else if (limit.limitType === "allowance" || limit.limitType === LimitType.Allowance) {
+            return {
+                limitType: LimitType.Allowance,
+                limit: limit.limit,
+                period: typeof limit.period === "string" ? msStringToSeconds(limit.period) : limit.period,
+            };
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        throw new Error(`Invalid limit type: ${limit.limitType}`);
+    }
+    /* LimitType not selected */
+    if (limit.period) {
+        return {
+            limitType: LimitType.Allowance,
+            limit: limit.limit,
+            period: typeof limit.period === "string" ? msStringToSeconds(limit.period) : limit.period,
+        };
+    }
+    return {
+        limitType: LimitType.Lifetime,
+        limit: limit.limit,
+        period: 0n,
+    };
+};
+/**
+ * Format user-friendly date preferences to bigint timestamp
+ */
+export const formatDatePreferences = (date) => {
+    if (typeof date === "string") {
+        const now = Math.floor(new Date().getTime() / 1000);
+        const seconds = msStringToSeconds(date);
+        return BigInt(now) + seconds;
+    }
+    if (date instanceof Date) {
+        const seconds = Math.floor(date.getTime() / 1000);
+        return BigInt(seconds);
+    }
+    return date;
+};
+/**
+ * Format user-friendly session preferences to full SessionSpec (without signer)
+ * @param preferences - User-friendly session configuration
+ * @param defaults - Default values for expiry and feeLimit if not specified
+ * @returns SessionSpec without the signer field (to be added separately)
+ */
+export function formatSessionPreferences(preferences, defaults) {
+    return {
+        expiresAt: preferences.expiry ? formatDatePreferences(preferences.expiry) : defaults.expiresAt,
+        feeLimit: preferences.feeLimit ? formatLimitPreferences(preferences.feeLimit) : defaults.feeLimit,
+        callPolicies: preferences.contractCalls?.map((policy) => {
+            const allowedStateMutability = ["nonpayable", "payable"];
+            const abiFunction = policy.abi.find((fn) => fn.type === "function" && fn.name === policy.functionName && allowedStateMutability.includes(fn.stateMutability));
+            if (!abiFunction)
+                throw new Error(`Function not found in the provided ABI: ${policy.functionName}`);
+            const selector = toFunctionSelector(abiFunction);
+            const valueLimit = policy.valueLimit ? formatLimitPreferences(policy.valueLimit) : LimitZero;
+            return {
+                target: getAddress(policy.address.toLowerCase()),
+                maxValuePerUse: policy.maxValuePerUse ?? valueLimit.limit,
+                valueLimit,
+                selector: selector,
+                constraints: policy.constraints?.map((constraint) => {
+                    const limit = constraint.limit ? formatLimitPreferences(constraint.limit) : LimitUnlimited;
+                    let condition = ConstraintCondition.Unconstrained;
+                    if (constraint.condition) {
+                        condition = ConstraintCondition[constraint.condition];
+                    }
+                    else if (constraint.value !== undefined && constraint.value !== null) {
+                        condition = ConstraintCondition.Equal;
+                    }
+                    const input = abiFunction.inputs[constraint.index];
+                    if (!input) {
+                        throw new Error(`Target function parameter not found in the provided ABI function. Provided at function ${policy.functionName}, index ${constraint.index}`);
+                    }
+                    const isDynamicType = isDynamicInputType(input.type);
+                    if (isDynamicType) {
+                        throw new Error(`Function parameters with dynamic types are not supported for constraint validation. Provided at function ${policy.functionName}, index ${constraint.index}`);
+                    }
+                    const isFollowedByDynamicType = isFollowedByDynamicInputType(abiFunction, constraint.index);
+                    if (isFollowedByDynamicType) {
+                        throw new Error(`Target function parameter is followed by a dynamic type parameter. Provided at function ${policy.functionName}, index ${constraint.index}`);
+                    }
+                    const startingAbiChunkIndex = getParameterChunkIndex(abiFunction, constraint.index);
+                    if (constraint.value === undefined || constraint.value === null) {
+                        return {
+                            index: BigInt(startingAbiChunkIndex),
+                            condition: ConstraintCondition.Unconstrained,
+                            refValue: toHex("", { size: 32 }),
+                            limit,
+                        };
+                    }
+                    const encodedInput = encodeAbiParameters([input], [constraint.value]);
+                    const abiBytesChunks = encodedInputToAbiChunks(encodedInput);
+                    const ALLOWED_OVERFLOW_CONDITIONS = [
+                        ConstraintCondition.Unconstrained,
+                        ConstraintCondition.Equal,
+                        ConstraintCondition.NotEqual,
+                    ];
+                    const ALLOWED_OVERFLOW_LIMIT_TYPES = [
+                        LimitType.Unlimited,
+                    ];
+                    if (abiBytesChunks.length > 1
+                        && (!ALLOWED_OVERFLOW_CONDITIONS.includes(condition) // Can't validate condition (e.g. < >) if value is split across multiple chunks
+                            || !ALLOWED_OVERFLOW_LIMIT_TYPES.includes(limit.limitType) // Can't validate limit if value is split across multiple chunks
+                        )) {
+                        throw new Error(`Encoded input size of parameter at index ${constraint.index} of ${policy.functionName} exceeds the maximum size of 32 bytes: ${abiBytesChunks.length * 32} bytes`);
+                    }
+                    ;
+                    return abiBytesChunks.map((abiChunk, index) => ({
+                        index: BigInt(startingAbiChunkIndex + index),
+                        condition,
+                        refValue: abiChunk,
+                        limit,
+                    }));
+                }).flat() ?? [],
+            };
+        }) ?? [],
+        transferPolicies: preferences.transfers?.map((policy) => {
+            const valueLimit = policy.valueLimit ? formatLimitPreferences(policy.valueLimit) : LimitZero;
+            return {
+                target: getAddress(policy.to.toLowerCase()),
+                maxValuePerUse: policy.maxValuePerUse ?? valueLimit.limit,
+                valueLimit,
+            };
+        }) ?? [],
+    };
+}
+//# sourceMappingURL=formatSessionPreferences.js.map