chore(dapp-client): re-export network/util helpers and add explicit session config helper

Author: tolgahan-arikan

packages/wallet/dapp-client/src/index.ts

@@ -35,7 +35,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 +56,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'

packages/wallet/dapp-client/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.
  *