@0xsequence/dapp-client 0.0.0-20250910142613

package/.turbo/turbo-build.log

@@ -0,0 +1,5 @@
+
+
+> @0xsequence/dapp-client@0.0.0-20250910142613 build /Users/taylan/Development/Horizon/sequence.js/packages/wallet/dapp-client
+> tsc
+

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# @0xsequence/dapp-client
+
+## 0.0.0-20250910142613
+
+### Patch Changes
+
+- v3 beta snapshot
+- Updated dependencies
+  - @0xsequence/guard@0.0.0-20250910142613
+  - @0xsequence/wallet-core@0.0.0-20250910142613
+  - @0xsequence/wallet-primitives@0.0.0-20250910142613

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,238 @@
+# @0xsequence/dapp-client
+
+## 1. Overview
+
+The `DappClient` is the main entry point for interacting with the Sequence Wallet from any decentralized application (dapp). It provides a high-level, developer-friendly API to manage user sessions across multiple blockchains.
+
+This client simplifies complex wallet interactions such as connecting a user, sending transactions, and signing messages, while handling different communication methods (popup vs. redirect) and session types (implicit vs. explicit) under the hood.
+
+### Core Concepts
+
+- **Multichain by Design:** A single client instance manages connections to multiple blockchains simultaneously.
+- **Implicit vs. Explicit Sessions:**
+  - **Implicit Session:** The primary session tied to a user's main login (e.g., social or email). It is designed for interacting with specific, pre-approved contracts within your dapp for a seamless UX.
+  - **Explicit Session:** A temporary, permissioned session key. Your dapp can request specific permissions (e.g., "allow this key to spend 10 USDC"), and once approved by the user, can perform those actions without further popups.
+- **Event-Driven:** Asynchronous operations like signing are handled via an event emitter, creating a single, consistent API for both popup and redirect flows.
+
+## 2. Getting Started
+
+### Installation
+
+```bash
+pnpm install @0xsequence/dapp-client
+```
+
+### Basic Usage
+
+It is recommended to create and manage a single, singleton instance of the `DappClient` throughout your application.
+
+```typescript
+import { DappClient } from '@0xsequence/dapp-client'
+
+// 1. Create a single client instance for your app
+const dappClient = new DappClient('https://my-wallet-url.com')
+
+// 2. Initialize the client when your application loads
+async function initializeClient() {
+  try {
+    // The initialize method loads any existing session from storage
+    // and handles any pending redirect responses.
+    await dappClient.initialize()
+    console.log('Client initialized. User is connected:', dappClient.isInitialized)
+  } catch (error) {
+    console.error('Failed to initialize client:', error)
+  }
+}
+
+initializeClient()
+```
+
+## 3. Class: `DappClient`
+
+The main entry point for interacting with the Wallet. This client manages user sessions across multiple chains, handles connection and disconnection, and provides methods for signing and sending transactions.
+
+### Constructor
+
+**`new DappClient(walletUrl, options?)`**
+
+Initializes a new instance of the DappClient.
+
+| Parameter                        | Type                        | Description                                                                                  |
+| :------------------------------- | :-------------------------- | :------------------------------------------------------------------------------------------- |
+| `walletUrl`                      | `string`                    | **(Required)** The URL of the Ecosystem Wallet Webapp.                                       |
+| `origin`                         | `string`                    | **(Required)** The origin of the dapp.                                                       |
+| `options`                        | `object`                    | (Optional) An object containing configuration options for the client.                        |
+| `options.transportMode`          | `'popup' \| 'redirect'`     | The communication mode to use with the wallet. Defaults to `'popup'`.                        |
+| `options.keymachineUrl`          | `string`                    | The URL of the key management service. Defaults to the production Sequence Key Machine.      |
+| `options.redirectPath`           | `string`                    | The path to redirect back to after a redirect-based flow. Used as origin+path.               |
+| `options.sequenceStorage`        | `SequenceStorage`           | An object for persistent session data storage. Defaults to `WebStorage` (using IndexedDB).   |
+| `options.sequenceSessionStorage` | `SequenceSessionStorage`    | An object for temporary data storage (e.g., pending requests). Defaults to `sessionStorage`. |
+| `options.randomPrivateKeyFn`     | `() => Hex \| Promise<Hex>` | A function to generate random private keys for new sessions.                                 |
+| `options.redirectActionHandler`  | `(url: string) => void`     | A handler to manually control navigation for redirect flows.                                 |
+| `options.canUseIndexedDb`        | `boolean`                   | A flag to enable or disable the use of IndexedDB for caching. Defaults to `true`.            |
+
+---
+
+## 4. API Reference
+
+### Properties
+
+| Property        | Type             | Description                                                               |
+| :-------------- | :--------------- | :------------------------------------------------------------------------ |
+| `isInitialized` | `boolean`        | `true` if the client has an active and loaded session, `false` otherwise. |
+| `loginMethod`   | `string \| null` | The login method used for the current session (e.g., 'google', 'email').  |
+| `userEmail`     | `string \| null` | The email address associated with the session, if available.              |
+| `transportMode` | `TransportMode`  | (Read-only) The transport mode the client was configured with.            |
+
+### Methods
+
+#### **initialize()**
+
+Initializes the client by loading any existing session from storage. This should be called once when your application loads.
+
+- **Returns:** `Promise<void>`
+- **Throws:** `InitializationError` if the process fails.
+
+---
+
+#### **connect()**
+
+Creates and initializes a new user session for a given chain.
+
+- **Parameters:**
+  - `chainId`: `ChainId` - The primary chain ID for the new session.
+  - `permissions?`: `Signers.Session.ExplicitParams` - (Optional) Permissions to request the user to approve for the new session (Unrestricted permissions if not provided).
+  - `options?`: `{ preferredLoginMethod?, email? }` - (Optional) Options for the new session.
+- **Returns:** `Promise<void>`
+- **Throws:** `ConnectionError`, `InitializationError`
+
+---
+
+#### **disconnect()**
+
+Disconnects the client and clears all session data from browser storage. Note: this does not revoke the sessions on-chain.
+
+- **Returns:** `Promise<void>`
+
+---
+
+#### **getWalletAddress()**
+
+Returns the wallet address of the current session.
+
+- **Returns:** `Address.Address | null`
+
+---
+
+#### **getAllSessions()**
+
+Returns an array of all active session keys (both implicit and explicit).
+
+- **Returns:** `Session[]`
+
+---
+
+#### **addExplicitSession()**
+
+Creates and initializes a new explicit session for a given chain.
+
+- **Parameters:**
+  - `chainId`: `ChainId` - The chain ID for the new session.
+  - `permissions`: `Signers.Session.ExplicitParams` - The permissions to request.
+- **Returns:** `Promise<void>`
+- **Throws:** `AddExplicitSessionError`, `InitializationError`
+- **Example:**
+  ```typescript
+  // Allow this session to transfer 1 USDC on Polygon
+  const USDC_ADDRESS = '0x...'
+  const permissions = {
+    permissions: [Utils.ERC20PermissionBuilder.buildTransfer(USDC_ADDRESS, '1000000')],
+  }
+  await dappClient.addExplicitSession(137, permissions)
+  ```
+
+---
+
+#### **sendTransaction()**
+
+Signs and sends a transaction using an active session signer.
+
+- **Parameters:**
+  - `chainId`: `ChainId` - The chain ID for the transaction.
+  - `transactions`: `Transaction[]` - An array of transactions to execute.
+  - `feeOption?`: `Relayer.FeeOption` - (Optional) A gas fee option for (ex: User could pay the gas in USDC).
+- **Returns:** `Promise<string>` - The transaction hash.
+- **Throws:** `TransactionError`, `InitializationError`
+
+---
+
+#### **getFeeOptions()**
+
+Gets available gas fee options for a transaction.
+
+- **Parameters:**
+  - `chainId`: `ChainId` - The chain ID for the transaction.
+  - `transactions`: `Transaction[]` - The transactions to get fee options for.
+- **Returns:** `Promise<Relayer.FeeOption[]>`
+- **Throws:** `FeeOptionError`, `InitializationError`
+
+---
+
+#### **signMessage()**
+
+Signs a standard EIP-191 message. The signature is delivered via the `signatureResponse` event.
+
+- **Parameters:**
+  - `chainId`: `ChainId` - The chain ID for signing.
+  - `message`: `string` - The message to sign.
+- **Returns:** `Promise<void>`
+- **Throws:** `SigningError`, `InitializationError`
+
+---
+
+#### **signTypedData()**
+
+Signs an EIP-712 typed data object. The signature is delivered via the `signatureResponse` event.
+
+- **Parameters:**
+  - `chainId`: `ChainId` - The chain ID for signing.
+  - `typedData`: `unknown` - The typed data object to sign.
+- **Returns:** `Promise<void>`
+- **Throws:** `SigningError`, `InitializationError`
+
+---
+
+#### **on()**
+
+Registers an event listener for client-side events.
+
+- **Parameters:**
+  - `event`: `'sessionsUpdated' | 'signatureResponse'` - The event to listen for.
+  - `listener`: `DappClientEventListener` - The callback function.
+- **Returns:** `() => void` - A function to unsubscribe the listener.
+- **Example:**
+
+  ```typescript
+  // The listener for `signatureResponse` receives the signing result.
+  dappClient.on('signatureResponse', (data) => {
+    // The `data` object includes the chainId where the signing occurred.
+    console.log('Signature response from chain:', data.chainId)
+
+    if (data.error) {
+      console.error('Signing failed:', data.error)
+      return
+    }
+
+    // The `data.response` object contains the signature and other details.
+    console.log('Action:', data.action) // 'signMessage' or 'signTypedData'
+    console.log('Signature:', data.response.signature)
+    console.log('Signed by wallet:', data.response.walletAddress)
+  })
+
+  // The listener for `sessionsUpdated` is useful for syncing UI state.
+  dappClient.on('sessionsUpdated', () => {
+    console.log('Sessions updated!')
+    console.log('Is initialized:', dappClient.isInitialized)
+    console.log('Wallet address:', dappClient.getWalletAddress())
+  })
+  ```

package/dist/ChainSessionManager.d.ts

@@ -0,0 +1,203 @@
+import { Relayer, Signers } from '@0xsequence/wallet-core';
+import { Address, Hex } from 'ox';
+import { DappTransport } from './DappTransport.js';
+import { SequenceStorage } from './utils/storage.js';
+import { ExplicitSessionEventListener, LoginMethod, RandomPrivateKeyFn, Session, Transaction, GuardConfig } from './types/index.js';
+interface ChainSessionManagerEventMap {
+    explicitSessionResponse: ExplicitSessionEventListener;
+}
+/**
+ * Manages sessions and wallet interactions for a single blockchain.
+ * This class is used internally by the DappClient to handle chain-specific logic.
+ */
+export declare class ChainSessionManager {
+    private readonly instanceId;
+    private stateProvider;
+    private readonly redirectUrl;
+    private readonly randomPrivateKeyFn;
+    private eventListeners;
+    private sessions;
+    private walletAddress;
+    private sessionManager;
+    private wallet;
+    private provider;
+    private relayer;
+    private readonly chainId;
+    transport: DappTransport | null;
+    private sequenceStorage;
+    isInitialized: boolean;
+    private isInitializing;
+    loginMethod: LoginMethod | null;
+    userEmail: string | null;
+    private guard?;
+    /**
+     * @param chainId The ID of the chain this manager is responsible for.
+     * @param keyMachineUrl The URL of the key management service.
+     * @param transport The transport mechanism for communicating with the wallet.
+     * @param sequenceStorage The storage implementation for persistent session data.
+     * @param redirectUrl (Optional) The URL to redirect back to after a redirect-based flow.
+     * @param guard (Optional) The guard config to use for the session.
+     * @param randomPrivateKeyFn (Optional) A function to generate random private keys.
+     * @param canUseIndexedDb (Optional) A flag to enable or disable IndexedDB for caching.
+     */
+    constructor(chainId: number, transport: DappTransport, projectAccessKey: string, keyMachineUrl: string, nodesUrl: string, relayerUrl: string, sequenceStorage: SequenceStorage, redirectUrl: string, guard?: GuardConfig, randomPrivateKeyFn?: RandomPrivateKeyFn, canUseIndexedDb?: boolean);
+    /**
+     * Registers an event listener for a specific event within this chain manager.
+     * @param event The event to listen for ChainSessionManagerEvent events.
+     * @param listener The function to call when the event occurs.
+     * @returns A function to unsubscribe the listener.
+     */
+    on<K extends keyof ChainSessionManagerEventMap>(event: K, listener: ChainSessionManagerEventMap[K]): () => void;
+    /**
+     * @private Emits an event to all registered listeners for this chain manager.
+     * @param event The event to emit.
+     * @param data The data to pass to the listener.
+     */
+    private emit;
+    /**
+     * Initializes the manager by loading sessions from storage for this specific chain.
+     * @returns A promise resolving to the login method and email if an implicit session is found, or void.
+     * @throws {InitializationError} If initialization fails.
+     */
+    initialize(): Promise<{
+        loginMethod: string | null;
+        userEmail: string | null;
+    } | void>;
+    /**
+     * Initializes the manager with a known wallet address, without loading sessions from storage.
+     * This is used when a wallet address is known but the session manager for this chain hasn't been instantiated yet.
+     * @param walletAddress The address of the wallet to initialize with.
+     */
+    initializeWithWallet(walletAddress: Address.Address): void;
+    /**
+     * @private Loads implicit and explicit sessions from storage for the current wallet address.
+     * @param walletAddress The walletAddress for all sessions.
+     */
+    private _loadSessionFromStorage;
+    /**
+     * Initiates the creation of a new session by sending a request to the wallet.
+     * @param permissions (Optional) Permissions for an initial explicit session.
+     * @param options (Optional) Additional options like preferred login method.
+     * @throws {InitializationError} If a session already exists or the transport fails to initialize.
+     */
+    createNewSession(origin: string, permissions?: Signers.Session.ExplicitParams, options?: {
+        preferredLoginMethod?: LoginMethod;
+        email?: string;
+        includeImplicitSession?: boolean;
+    }): Promise<void>;
+    /**
+     * Initiates the addition of a new explicit session by sending a request to the wallet.
+     * @param permissions The permissions for the new explicit session.
+     * @throws {InitializationError} If the manager is not initialized.
+     * @throws {AddExplicitSessionError} If adding the session fails.
+     */
+    addExplicitSession(permissions: Signers.Session.ExplicitParams): Promise<void>;
+    /**
+     * Initiates the modification of an existing explicit session by sending a request to the wallet.
+     * @param sessionAddress The address of the explicit session to modify.
+     * @param newPermissions The new permissions for the session.
+     * @throws {InitializationError} If the manager is not initialized.
+     * @throws {ModifyExplicitSessionError} If modifying the session fails.
+     */
+    modifyExplicitSession(sessionAddress: Address.Address, newPermissions: Signers.Session.ExplicitParams): Promise<void>;
+    /**
+     * @private Handles the connection-related part of a redirect response, initializing sessions.
+     * @param response The response payload from the redirect.
+     * @returns A promise resolving to true on success.
+     */
+    private _handleRedirectConnectionResponse;
+    /**
+     * Resets the manager state and clears all credentials from storage.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * @private Initializes an implicit session signer and adds it to the session manager.
+     * @param pk The private key of the session.
+     * @param address The wallet address.
+     * @param attestation The attestation from the wallet.
+     * @param identitySignature The identity signature from the wallet.
+     * @param saveSession Whether to persist the session in storage.
+     * @param loginMethod The login method used.
+     * @param userEmail The email associated with the session.
+     * @param guard The guard configuration.
+     */
+    private _initializeImplicitSessionInternal;
+    /**
+     * @private Initializes an explicit session signer and adds it to the session manager.
+     * It retries fetching permissions from the network if allowed.
+     * @param pk The private key of the session.
+     * @param loginMethod The login method used for the session.
+     * @param userEmail The email associated with the session.
+     * @param allowRetries Whether to retry fetching permissions on failure.
+     */
+    private _initializeExplicitSessionInternal;
+    /**
+     * Checks if the current session has permission to execute a set of transactions.
+     * @param transactions The transactions to check permissions for.
+     * @returns A promise that resolves to true if the session has permission, false otherwise.
+     */
+    hasPermission(transactions: Transaction[]): Promise<boolean>;
+    /**
+     * Fetches fee options for a set of transactions.
+     * @param calls The transactions to estimate fees for.
+     * @returns A promise that resolves with an array of fee options.
+     * @throws {FeeOptionError} If fetching fee options fails.
+     */
+    getFeeOptions(calls: Transaction[]): Promise<Relayer.FeeOption[]>;
+    /**
+     * Builds, signs, and sends a batch of transactions.
+     * @param transactions The transactions to be sent.
+     * @param feeOption (Optional) The fee option to use for sponsoring the transaction. If provided, a token transfer call will be prepended.
+     * @returns A promise that resolves with the transaction hash.
+     * @throws {InitializationError} If the session is not initialized.
+     * @throws {TransactionError} If the transaction fails at any stage.
+     */
+    buildSignAndSendTransactions(transactions: Transaction[], feeOption?: Relayer.FeeOption): Promise<Hex.Hex>;
+    /**
+     * Handles a redirect response from the wallet for this specific chain.
+     * @param response The pre-parsed response from the transport.
+     * @returns A promise that resolves to true if the response was handled successfully.
+     * @throws {WalletRedirectError} If the response is invalid or causes an error.
+     * @throws {InitializationError} If the session cannot be initialized from the response.
+     */
+    handleRedirectResponse(response: {
+        payload: any;
+        action: string;
+    } | {
+        error: any;
+        action: string;
+    }): Promise<boolean>;
+    /**
+     * Gets the wallet address associated with this manager.
+     * @returns The wallet address, or null if not initialized.
+     */
+    getWalletAddress(): Address.Address | null;
+    /**
+     * Gets the sessions (signers) managed by this instance.
+     * @returns An array of session objects.
+     */
+    getSessions(): Session[];
+    /**
+     * @private Prepares, signs, and builds a transaction envelope.
+     * @param calls The payload calls to include in the transaction.
+     * @returns The signed transaction data ready for relaying.
+     */
+    private _buildAndSignCalls;
+    /**
+     * @private Polls the relayer for the status of a transaction until it is confirmed or fails.
+     * @param opHash The operation hash of the relayed transaction.
+     * @param chainId The chain ID of the transaction.
+     * @returns The final status of the transaction.
+     */
+    private _waitForTransactionReceipt;
+    /**
+     * @private Resets the internal state of the manager without clearing stored credentials.
+     */
+    private _resetState;
+    /**
+     * @private Resets the internal state and clears all persisted session data from storage.
+     */
+    private _resetStateAndClearCredentials;
+}
+export {};
+//# sourceMappingURL=ChainSessionManager.d.ts.map

package/dist/ChainSessionManager.d.ts.map

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