@0xsequence/dapp-client 3.0.0-beta.9 → 3.0.1

package/dist/utils/index.js

@@ -1,6 +1,6 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
 import { Network } from '@0xsequence/wallet-primitives';
 import { Bytes, Hex } from 'ox';
+export { VALUE_FORWARDER_ADDRESS } from './constants.js';
 /**
  * Creates a single JSON replacer by chaining multiple replacers.
  * The first replacer to transform a value wins.
@@ -114,6 +114,28 @@ const uint8ArrayReviver = (key, value) => {
 };
 export const jsonRevivers = chainRevivers([mapReviver, bigIntReviver, uint8ArrayReviver]);
 export const jsonReplacers = chainReplacers([mapReplacer, bigIntReplacer, uint8ArrayReplacer]);
+export const createExplicitSessionConfig = (params) => {
+    const nowInSeconds = BigInt(Math.floor(Date.now() / 1000));
+    const { days = 0, hours = 0, minutes = 0 } = params.expiresIn;
+    const sessionLifetimeSeconds = days * 24 * 60 * 60 + hours * 60 * 60 + minutes * 60;
+    const deadline = nowInSeconds + BigInt(sessionLifetimeSeconds);
+    if (params.permissions.length === 0) {
+        throw new Error('createExplicitSessionConfig: At least one permission is required.');
+    }
+    const nativeTokenSpending = params.nativeTokenSpending;
+    const valueLimit = nativeTokenSpending?.valueLimit ?? 0n;
+    const nativeTokenReceivers = [...(nativeTokenSpending?.allowedRecipients || [])];
+    const nativeTokenSpendingPermissions = nativeTokenReceivers.map((receiver) => ({
+        target: receiver,
+        rules: [],
+    }));
+    return {
+        chainId: params.chainId,
+        valueLimit,
+        deadline,
+        permissions: [...params.permissions, ...nativeTokenSpendingPermissions],
+    };
+};
 /**
  * Apply a template to a string.
  *

package/dist/utils/storage.d.ts

@@ -1,5 +1,5 @@
 import { Address, Hex } from 'ox';
-import { LoginMethod, SignMessagePayload, SignTypedDataPayload, GuardConfig, SendWalletTransactionPayload, ModifyExplicitSessionPayload, CreateNewSessionPayload, AddExplicitSessionPayload } from '../types/index.js';
+import { LoginMethod, SignMessagePayload, SignTypedDataPayload, GuardConfig, ETHAuthProof, SendWalletTransactionPayload, ModifyExplicitSessionPayload, CreateNewSessionPayload, AddExplicitSessionPayload } from '../types/index.js';
 import { Attestation } from '../index.js';
 export interface ExplicitSessionData {
     pk: Hex.Hex;
@@ -48,6 +48,9 @@ export interface SequenceStorage {
     saveSessionlessConnection(sessionData: SessionlessConnectionData): Promise<void>;
     getSessionlessConnection(): Promise<SessionlessConnectionData | null>;
     clearSessionlessConnection(): Promise<void>;
+    saveEthAuthProof(proof: ETHAuthProof): Promise<void>;
+    getEthAuthProof(): Promise<ETHAuthProof | null>;
+    clearEthAuthProof(): Promise<void>;
     saveSessionlessConnectionSnapshot?(sessionData: SessionlessConnectionData): Promise<void>;
     getSessionlessConnectionSnapshot?(): Promise<SessionlessConnectionData | null>;
     clearSessionlessConnectionSnapshot?(): Promise<void>;
@@ -73,8 +76,11 @@ export declare class WebStorage implements SequenceStorage {
     getImplicitSession(): Promise<ImplicitSessionData | null>;
     clearImplicitSession(): Promise<void>;
     saveSessionlessConnection(sessionData: SessionlessConnectionData): Promise<void>;
+    saveEthAuthProof(proof: ETHAuthProof): Promise<void>;
     getSessionlessConnection(): Promise<SessionlessConnectionData | null>;
+    getEthAuthProof(): Promise<ETHAuthProof | null>;
     clearSessionlessConnection(): Promise<void>;
+    clearEthAuthProof(): Promise<void>;
     saveSessionlessConnectionSnapshot(sessionData: SessionlessConnectionData): Promise<void>;
     getSessionlessConnectionSnapshot(): Promise<SessionlessConnectionData | null>;
     clearSessionlessConnectionSnapshot(): Promise<void>;

package/dist/utils/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":"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"}

package/dist/utils/storage.js

@@ -9,6 +9,7 @@ const STORE_NAME = 'userKeys';
 const IMPLICIT_SESSIONS_IDB_KEY = 'SequenceImplicitSession';
 const EXPLICIT_SESSIONS_IDB_KEY = 'SequenceExplicitSession';
 const SESSIONLESS_CONNECTION_IDB_KEY = 'SequenceSessionlessConnection';
+const ETH_AUTH_PROOF_IDB_KEY = 'SequenceEthAuthProof';
 const SESSIONLESS_CONNECTION_SNAPSHOT_IDB_KEY = 'SequenceSessionlessConnectionSnapshot';
 const PENDING_REDIRECT_REQUEST_KEY = 'SequencePendingRedirect';
 const TEMP_SESSION_PK_KEY = 'SequencePendingTempSessionPk';
@@ -219,6 +220,15 @@ export class WebStorage {
             throw error;
         }
     }
+    async saveEthAuthProof(proof) {
+        try {
+            await this.setIDBItem(ETH_AUTH_PROOF_IDB_KEY, proof);
+        }
+        catch (error) {
+            console.error('Failed to save ETHAuth proof:', error);
+            throw error;
+        }
+    }
     async getSessionlessConnection() {
         try {
             return (await this.getIDBItem(SESSIONLESS_CONNECTION_IDB_KEY)) ?? null;
@@ -228,6 +238,15 @@ export class WebStorage {
             return null;
         }
     }
+    async getEthAuthProof() {
+        try {
+            return (await this.getIDBItem(ETH_AUTH_PROOF_IDB_KEY)) ?? null;
+        }
+        catch (error) {
+            console.error('Failed to retrieve ETHAuth proof:', error);
+            return null;
+        }
+    }
     async clearSessionlessConnection() {
         try {
             await this.deleteIDBItem(SESSIONLESS_CONNECTION_IDB_KEY);
@@ -237,6 +256,15 @@ export class WebStorage {
             throw error;
         }
     }
+    async clearEthAuthProof() {
+        try {
+            await this.deleteIDBItem(ETH_AUTH_PROOF_IDB_KEY);
+        }
+        catch (error) {
+            console.error('Failed to clear ETHAuth proof:', error);
+            throw error;
+        }
+    }
     async saveSessionlessConnectionSnapshot(sessionData) {
         try {
             await this.setIDBItem(SESSIONLESS_CONNECTION_SNAPSHOT_IDB_KEY, sessionData);
@@ -276,6 +304,7 @@ export class WebStorage {
             await this.clearExplicitSessions();
             await this.clearImplicitSession();
             await this.clearSessionlessConnection();
+            await this.clearEthAuthProof();
             await this.clearSessionlessConnectionSnapshot();
         }
         catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xsequence/dapp-client",
-  "version": "3.0.0-beta.9",
+  "version": "3.0.1",
   "license": "Apache-2.0",
   "type": "module",
   "publishConfig": {
@@ -14,26 +14,28 @@
     }
   },
   "devDependencies": {
-    "@types/node": "^25.0.2",
-    "@vitest/coverage-v8": "^4.0.15",
-    "dotenv": "^17.2.3",
+    "@types/node": "^25.3.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "dotenv": "^17.3.1",
     "fake-indexeddb": "^6.2.5",
-    "happy-dom": "^20.0.11",
+    "happy-dom": "^20.7.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.15",
-    "@repo/typescript-config": "^0.0.1-beta.1"
+    "vitest": "^4.0.18",
+    "@repo/eslint-config": "^0.0.1",
+    "@repo/typescript-config": "^0.0.1"
   },
   "dependencies": {
     "ox": "^0.9.17",
-    "@0xsequence/guard": "^3.0.0-beta.9",
-    "@0xsequence/wallet-core": "^3.0.0-beta.9",
-    "@0xsequence/wallet-primitives": "^3.0.0-beta.9",
-    "@0xsequence/relayer": "^3.0.0-beta.9"
+    "@0xsequence/guard": "^3.0.1",
+    "@0xsequence/wallet-core": "^3.0.1",
+    "@0xsequence/wallet-primitives": "^3.0.1",
+    "@0xsequence/relayer": "^3.0.1"
   },
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
     "typecheck": "tsc --noEmit",
-    "clean": "rimraf dist"
+    "clean": "rimraf dist",
+    "lint": "eslint . --max-warnings 0"
   }
 }

package/src/ChainSessionManager.ts

@@ -37,12 +37,14 @@ import {
   TransportMode,
   GuardConfig,
   CreateNewSessionPayload,
+  EthAuthSettings,
   ModifyExplicitSessionPayload,
   SessionResponse,
   AddExplicitSessionPayload,
   FeeOption,
   OperationFailedStatus,
   OperationStatus,
+  ETHAuthProof,
 } from './types/index.js'
 import { CACHE_DB_NAME, VALUE_FORWARDER_ADDRESS } from './utils/constants.js'
 import { ExplicitSession, ImplicitSession, ExplicitSessionConfig } from './index.js'
@@ -84,6 +86,11 @@ export class ChainSessionManager {
   public loginMethod: LoginMethod | null = null
   public userEmail: string | null = null
   private guard?: GuardConfig
+  private lastSignedCallCache?: {
+    fingerprint: string
+    signedCall: { to: Address.Address; data: Hex.Hex }
+    createdAtMs: number
+  }
 
   /**
    * @param chainId The ID of the chain this manager is responsible for.
@@ -151,11 +158,11 @@ export class ChainSessionManager {
     listener: ChainSessionManagerEventMap[K],
   ): () => void {
     if (!this.eventListeners[event]) {
-      this.eventListeners[event] = new Set() as any
+      this.eventListeners[event] = new Set<ChainSessionManagerEventMap[K]>()
     }
-    ;(this.eventListeners[event] as any).add(listener)
+    this.eventListeners[event].add(listener)
     return () => {
-      ;(this.eventListeners[event] as any)?.delete(listener)
+      this.eventListeners[event]?.delete(listener)
     }
   }
 
@@ -280,6 +287,7 @@ export class ChainSessionManager {
       preferredLoginMethod?: LoginMethod
       email?: string
       includeImplicitSession?: boolean
+      ethAuth?: EthAuthSettings
     } = {},
   ): Promise<void> {
     if (this.isInitialized) {
@@ -306,6 +314,7 @@ export class ChainSessionManager {
         origin,
         session: completeSession as ExplicitSession | undefined,
         includeImplicitSession: options.includeImplicitSession ?? false,
+        ethAuth: options.ethAuth,
         preferredLoginMethod: options.preferredLoginMethod,
         email: options.preferredLoginMethod === 'email' ? options.email : undefined,
       }
@@ -372,6 +381,10 @@ export class ChainSessionManager {
         this.guard = guard
       }
 
+      if (payload.ethAuth) {
+        await this._saveEthAuthProofIfProvided(connectResponse.ethAuthProof)
+      }
+
       if (this.transport.mode === TransportMode.POPUP) {
         this.transport.closeWallet()
       }
@@ -591,6 +604,10 @@ export class ChainSessionManager {
           this.userEmail = userEmail ?? null
           this.guard = guard
         }
+
+        if (savedPayload?.ethAuth) {
+          await this._saveEthAuthProofIfProvided(connectResponse.ethAuthProof)
+        }
       } else if (response.action === RequestActionType.ADD_EXPLICIT_SESSION) {
         if (!this.walletAddress || !Address.isEqual(receivedAddress, this.walletAddress)) {
           throw new InitializationError('Received an explicit session for a wallet that is not active.')
@@ -811,19 +828,6 @@ export class ChainSessionManager {
       await this.sessionManager.findSignersForCalls(this.wallet.address, this.chainId, calls)
       return true
     } catch (error) {
-      if (error instanceof Error && error.message.includes('Signer supporting call is expired')) {
-        // Extract the expired signer address from the message with address regex
-        const expiredSignerAddress = error.message.match(/(0x[0-9a-fA-F]{40})/)?.[1]
-        if (expiredSignerAddress) {
-          // Refresh the session
-          await this._refreshExplicitSession(Address.from(expiredSignerAddress))
-          // Retry the permission check
-          return this.hasPermission(transactions)
-        } else {
-          // Could not parse error message. Rethrow as this shouldn't happen.
-          throw error
-        }
-      }
       // An error from findSignersForCalls indicates a permission failure.
       console.warn(
         `Permission check failed for chain ${this.chainId}:`,
@@ -851,7 +855,17 @@ export class ChainSessionManager {
     }))
     try {
       const signedCall = await this._buildAndSignCalls(callsToSend)
-      const feeOptions = await this.relayer.feeOptions(signedCall.to, this.chainId, callsToSend)
+      const fingerprint = this._fingerprintCalls(callsToSend)
+      if (fingerprint) {
+        this.lastSignedCallCache = {
+          fingerprint,
+          signedCall,
+          createdAtMs: Date.now(),
+        }
+      }
+      const walletAddress = this.walletAddress
+      if (!walletAddress) throw new InitializationError('Wallet is not initialized.')
+      const feeOptions = await this.relayer.feeOptions(walletAddress, this.chainId, signedCall.to, callsToSend)
       return feeOptions.options
     } catch (err) {
       throw new FeeOptionError(`Failed to get fee options: ${err instanceof Error ? err.message : String(err)}`)
@@ -907,7 +921,7 @@ export class ChainSessionManager {
           callsToSend.unshift(transferCall)
         }
       }
-      const signedCalls = await this._buildAndSignCalls(callsToSend)
+      const signedCalls = this._getCachedSignedCall(callsToSend) ?? (await this._buildAndSignCalls(callsToSend))
       const hash = await this.relayer.relay(signedCalls.to, signedCalls.data, this.chainId)
       const status = await this._waitForTransactionReceipt(hash.opHash, this.chainId)
       if (status.status === 'confirmed') {
@@ -1101,4 +1115,49 @@ export class ChainSessionManager {
     await this.sequenceStorage.clearExplicitSessions()
     await this.sequenceStorage.clearSessionlessConnection()
   }
+
+  private async _saveEthAuthProofIfProvided(ethAuthProof?: ETHAuthProof): Promise<void> {
+    if (!ethAuthProof) {
+      return
+    }
+    await this.sequenceStorage.saveEthAuthProof(ethAuthProof)
+  }
+
+  private _getCachedSignedCall(calls: Payload.Call[]): { to: Address.Address; data: Hex.Hex } | null {
+    if (!this.lastSignedCallCache) {
+      return null
+    }
+    const ttlMs = 30_000
+    if (Date.now() - this.lastSignedCallCache.createdAtMs > ttlMs) {
+      this.lastSignedCallCache = undefined
+      return null
+    }
+    const fingerprint = this._fingerprintCalls(calls)
+    if (!fingerprint) {
+      return null
+    }
+    if (fingerprint !== this.lastSignedCallCache.fingerprint) {
+      return null
+    }
+    return this.lastSignedCallCache.signedCall
+  }
+
+  private _fingerprintCalls(calls: Payload.Call[]): string | null {
+    try {
+      return JSON.stringify(
+        calls.map((call) => ({
+          to: call.to,
+          value: call.value?.toString() ?? '0',
+          data: call.data ?? '0x',
+          gasLimit: call.gasLimit?.toString() ?? '0',
+          delegateCall: call.delegateCall ?? false,
+          onlyFallback: call.onlyFallback ?? false,
+          behaviorOnError: call.behaviorOnError ?? 'revert',
+        })),
+      )
+    } catch (error) {
+      console.warn('ChainSessionManager._fingerprintCalls failed:', error)
+      return null
+    }
+  }
 }

package/src/DappClient.ts

@@ -14,8 +14,10 @@ import {
   GetFeeTokensResponse,
   GuardConfig,
   LoginMethod,
+  EthAuthSettings,
   RandomPrivateKeyFn,
   RequestActionType,
+  ETHAuthProof,
   SendWalletTransactionPayload,
   SequenceSessionStorage,
   SignMessagePayload,
@@ -30,7 +32,7 @@ import { KEYMACHINE_URL, NODES_URL, RELAYER_URL } from './utils/constants.js'
 import { getRelayerUrl, getRpcUrl } from './utils/index.js'
 import { Relayer } from '@0xsequence/relayer'
 
-export type DappClientEventListener = (data?: any) => void
+export type DappClientEventListener = (data?: unknown) => void
 
 interface DappClientEventMap {
   sessionsUpdated: () => void
@@ -180,11 +182,12 @@ export class DappClient {
    */
   public on<K extends keyof DappClientEventMap>(event: K, listener: DappClientEventMap[K]): () => void {
     if (!this.eventListeners[event]) {
-      this.eventListeners[event] = new Set() as any
+      // @ts-expect-error - indexing into evenListeners will improperly create a union of all the possible types
+      this.eventListeners[event] = new Set<DappClientEventMap[K]>()
     }
-    ;(this.eventListeners[event] as any).add(listener)
+    this.eventListeners[event].add(listener)
     return () => {
-      ;(this.eventListeners[event] as any)?.delete(listener)
+      this.eventListeners[event]?.delete(listener)
     }
   }
 
@@ -407,6 +410,13 @@ export class DappClient {
     }
   }
 
+  /**
+   * Returns the latest persisted ETHAuth proof, if one has been received from the wallet.
+   */
+  public async getEthAuthProof(): Promise<ETHAuthProof | null> {
+    return this.sequenceStorage.getEthAuthProof()
+  }
+
   /**
    * Restores a sessionless connection that was previously persisted via {@link disconnect} or a connect flow.
    * @returns A promise that resolves to true if a sessionless connection was applied.
@@ -559,6 +569,7 @@ export class DappClient {
       preferredLoginMethod?: LoginMethod
       email?: string
       includeImplicitSession?: boolean
+      ethAuth?: EthAuthSettings
     } = {},
   ): Promise<void> {
     if (this.isInitialized) {
@@ -614,6 +625,7 @@ export class DappClient {
       preferredLoginMethod?: LoginMethod
       email?: string
       includeImplicitSession?: boolean
+      ethAuth?: EthAuthSettings
     } = {},
   ): Promise<void> {
     if (!this.isInitialized || !this.hasSessionlessConnection || !this.walletAddress) {
@@ -965,8 +977,6 @@ export class DappClient {
   async disconnect(options?: { keepSessionlessConnection?: boolean }): Promise<void> {
     const keepSessionlessConnection = options?.keepSessionlessConnection ?? true
 
-    const transportMode = this.transportMode
-
     if (this.transport) {
       this.transport.destroy()
     }

package/src/DappTransport.ts

@@ -378,10 +378,7 @@ export class DappTransport {
       return
     }
 
-    const isPotentiallyValidSource =
-      this.walletWindow && (event.source === this.walletWindow || !this.walletWindow.closed)
-
-    if (!isPotentiallyValidSource && event.data?.type !== MessageType.WALLET_OPENED) {
+    if (!this.walletWindow || event.source !== this.walletWindow) {
       return
     }
 

package/src/index.ts

@@ -24,6 +24,8 @@ export type {
   FeeToken,
   FeeOption,
   TransportMessage,
+  EthAuthSettings,
+  ETHAuthProof,
 } from './types/index.js'
 export { RequestActionType, TransportMode, MessageType } from './types/index.js'
 export {
@@ -35,7 +37,17 @@ export {
   SigningError,
   ModifyExplicitSessionError,
 } from './utils/errors.js'
-export { getExplorerUrl, jsonReplacers, jsonRevivers } from './utils/index.js'
+export {
+  createExplicitSessionConfig,
+  getExplorerUrl,
+  getNetwork,
+  getRelayerUrl,
+  getRpcUrl,
+  jsonReplacers,
+  jsonRevivers,
+  VALUE_FORWARDER_ADDRESS,
+} from './utils/index.js'
+export type { ExplicitSessionParams, NativeTokenSpending, SessionDuration } from './utils/index.js'
 export type {
   SequenceStorage,
   ExplicitSessionData,
@@ -46,6 +58,14 @@ export type {
 } from './utils/storage.js'
 export { WebStorage } from './utils/storage.js'
 
-export { Attestation, Permission, Extensions, SessionConfig, Constants, Payload } from '@0xsequence/wallet-primitives'
+export {
+  Attestation,
+  Permission,
+  Extensions,
+  SessionConfig,
+  Constants,
+  Payload,
+  Network,
+} from '@0xsequence/wallet-primitives'
 export type { ExplicitSessionConfig, ExplicitSession, ImplicitSession, Session } from '@0xsequence/wallet-core'
 export { Signers, Wallet, Utils, Envelope, State } from '@0xsequence/wallet-core'

package/src/types/index.ts

@@ -28,12 +28,32 @@ export interface GuardConfig {
   moduleAddresses: Map<Address.Address, Address.Address>
 }
 
+export interface EthAuthSettings {
+  app?: string
+  /** expiry number (in seconds) that is used for ETHAuth proof. Default is 1 week in seconds. */
+  expiry?: number
+  /** origin hint of the dapp's host opening the wallet. This value will automatically
+   * be determined and verified for integrity, and can be omitted. */
+  origin?: string
+  /** authorizeNonce is an optional number to be passed as ETHAuth's nonce claim for replay protection. **/
+  nonce?: number
+}
+
+export interface ETHAuthProof {
+  // eip712 typed-data payload for ETHAuth domain as input
+  typedData: Payload.TypedDataToSign
+
+  // signature encoded in an ETHAuth proof string
+  ewtString: string
+}
+
 // --- Payloads for Transport ---
 
 export interface CreateNewSessionPayload {
   origin?: string
   session?: ExplicitSession
   includeImplicitSession?: boolean
+  ethAuth?: EthAuthSettings
   preferredLoginMethod?: LoginMethod
   email?: string
 }
@@ -81,6 +101,7 @@ export interface CreateNewSessionResponse {
   userEmail?: string
   loginMethod?: LoginMethod
   guard?: GuardConfig
+  ethAuthProof?: ETHAuthProof
 }
 
 export interface SignatureResponse {

package/src/utils/index.ts

@@ -1,6 +1,8 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
-import { Network } from '@0xsequence/wallet-primitives'
-import { Bytes, Hex } from 'ox'
+import type { ExplicitSessionConfig } from '@0xsequence/wallet-core'
+import { Network, Permission } from '@0xsequence/wallet-primitives'
+import { Bytes, Hex, type Address } from 'ox'
+export { VALUE_FORWARDER_ADDRESS } from './constants.js'
 
 type JsonReplacer = (key: string, value: any) => any
 type JsonReviver = (key: string, value: any) => any
@@ -124,6 +126,50 @@ const uint8ArrayReviver: JsonReviver = (key, value) => {
 export const jsonRevivers = chainRevivers([mapReviver, bigIntReviver, uint8ArrayReviver])
 export const jsonReplacers = chainReplacers([mapReplacer, bigIntReplacer, uint8ArrayReplacer])
 
+export type SessionDuration = {
+  days?: number
+  hours?: number
+  minutes?: number
+}
+
+export type NativeTokenSpending = {
+  valueLimit: bigint
+  allowedRecipients?: Address.Address[]
+}
+
+export type ExplicitSessionParams = {
+  chainId: number
+  expiresIn: SessionDuration
+  permissions: Permission.Permission[]
+  nativeTokenSpending?: NativeTokenSpending
+}
+
+export const createExplicitSessionConfig = (params: ExplicitSessionParams): ExplicitSessionConfig => {
+  const nowInSeconds = BigInt(Math.floor(Date.now() / 1000))
+  const { days = 0, hours = 0, minutes = 0 } = params.expiresIn
+  const sessionLifetimeSeconds = days * 24 * 60 * 60 + hours * 60 * 60 + minutes * 60
+  const deadline = nowInSeconds + BigInt(sessionLifetimeSeconds)
+
+  if (params.permissions.length === 0) {
+    throw new Error('createExplicitSessionConfig: At least one permission is required.')
+  }
+
+  const nativeTokenSpending = params.nativeTokenSpending
+  const valueLimit = nativeTokenSpending?.valueLimit ?? 0n
+  const nativeTokenReceivers = [...(nativeTokenSpending?.allowedRecipients || [])]
+  const nativeTokenSpendingPermissions = nativeTokenReceivers.map((receiver) => ({
+    target: receiver,
+    rules: [],
+  }))
+
+  return {
+    chainId: params.chainId,
+    valueLimit,
+    deadline,
+    permissions: [...params.permissions, ...nativeTokenSpendingPermissions],
+  }
+}
+
 /**
  * Apply a template to a string.
  *