@opendatalabs/vana-sdk 0.1.0-alpha.a25bcc7 → 0.1.0-alpha.a6b60fc

package/dist/controllers/permissions.d.ts

@@ -1,5 +1,5 @@
 import type { Address, Hash } from "viem";
-import type { GrantPermissionParams, RevokePermissionParams, PermissionGrantTypedData, GenericTypedData, OnChainPermissionGrant, GetUserPermissionsOptions, AddAndTrustServerParams, TrustServerParams, UntrustServerParams, AddAndTrustServerTypedData, TrustServerTypedData, TrustedServerInfo, PaginatedTrustedServers, TrustedServerQueryOptions, BatchServerInfoResult, ServerTrustStatus, GrantFile, Grantee, GranteeInfo, RegisterGranteeParams, RegisterGranteeTypedData, GranteeQueryOptions, PaginatedGrantees, ServerInfo, ServerFilesAndPermissionParams, ServerFilesAndPermissionTypedData, TransactionOptions } from "../types/index";
+import type { GrantPermissionParams, RevokePermissionParams, PermissionGrantTypedData, GenericTypedData, OnChainPermissionGrant, GetUserPermissionsOptions, AddAndTrustServerParams, TrustServerParams, UntrustServerParams, AddAndTrustServerTypedData, TrustServerTypedData, TrustedServerInfo, PaginatedTrustedServers, TrustedServerQueryOptions, BatchServerInfoResult, ServerTrustStatus, GrantFile, Grantee, GranteeInfo, RegisterGranteeParams, GranteeQueryOptions, PaginatedGrantees, ServerInfo, ServerFilesAndPermissionParams, ServerFilesAndPermissionTypedData, TransactionOptions } from "../types/index";
 import type { PermissionGrantResult, PermissionRevokeResult, ServerTrustResult } from "../types/transactionResults";
 import type { TransactionResult } from "../types/operations";
 import type { PermissionInfo } from "../types/permissions";
@@ -18,50 +18,52 @@ import type { ControllerContext } from "../types/controller-context";
 import { BaseController } from "./base";
 export type { ControllerContext };
 /**
- * Manages gasless data access permissions and trusted server registry operations.
+ * Manages data access permissions and trusted server operations with gasless transaction support.
  *
  * @remarks
- * This controller enables users to grant applications access to their data without
- * paying gas fees. It handles the complete EIP-712 permission flow including signature
- * creation, IPFS storage of permission details, and gasless transaction submission.
- * The controller also manages trusted servers that can process user data and provides
- * methods for revoking permissions when access is no longer needed.
+ * Enables applications to access user data through EIP-712 signatures, eliminating gas fees
+ * for users. Handles permission lifecycle from creation through revocation, plus trusted
+ * server management for data processing operations.
  *
- * **Permission Architecture:**
- * Permissions use dual storage: detailed parameters stored on IPFS, references stored on blockchain.
- * This enables complex permissions while maintaining minimal on-chain data.
+ * **Architecture:**
+ * Permissions use dual storage: complex parameters on IPFS, references on blockchain.
+ * This minimizes on-chain data while maintaining decentralization and auditability.
  *
  * **Method Selection:**
- * - `grant()` creates new permissions with automatic IPFS upload and blockchain registration
- * - `prepareGrant()` allows preview before signing for interactive applications
- * - `revoke()` removes permissions by ID, supporting both gasless and direct transactions
- * - `getUserPermissionGrantsOnChain()` queries existing permissions efficiently
- * - `trustServer()` and `untrustServer()` manage server access for data processing
+ * - `grant()` - Create permissions with automatic IPFS upload and blockchain registration
+ * - `prepareGrant()` - Preview permission structure before signing
+ * - `revoke()` - Remove permissions by ID (gasless or direct)
+ * - `getUserPermissionGrantsOnChain()` - Query active permissions
+ * - `trustServer()`/`untrustServer()` - Manage server access
+ *
+ * **Gasless Support:**
+ * All permission methods support both gasless (via relayer) and direct transactions.
+ * Configure relayer callbacks in Vana initialization for gasless operations.
  *
- * **Transaction Types:**
- * Methods with gasless support: `grant()`, `revoke()`, `trustServer()`, `untrustServer()`
- * Methods requiring direct transactions: none (all support both gasless and direct)
  * @example
  * ```typescript
- * // Grant permission for an app to access your data
- * const txHash = await vana.permissions.grant({
+ * // Grant data access permission
+ * const result = await vana.permissions.grant({
  *   grantee: "0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36",
  *   operation: "llm_inference",
- *   files: [1, 2, 3],
- *   parameters: { model: "gpt-4", maxTokens: 1000 },
+ *   fileIds: [1, 2, 3],
+ *   parameters: { model: "gpt-4", maxTokens: 1000 }
  * });
+ * console.log(`Permission ${result.permissionId} granted`);
  *
- * // Trust a server for data processing
+ * // Trust server for processing
  * await vana.permissions.trustServer({
- *   serverId: "0x123...",
- *   serverUrl: "https://personal-server.vana.org",
+ *   serverAddress: "0x123...",
+ *   serverUrl: "https://personal-server.vana.org"
  * });
  *
- * // Query current permissions
+ * // Query active permissions
  * const permissions = await vana.permissions.getUserPermissionGrantsOnChain();
+ * permissions.forEach(p => console.log(`Permission ${p.id}: ${p.grantee}`));
  * ```
+ *
  * @category Permissions
- * @see {@link https://docs.vana.com/developer/permissions | Vana Permissions System} for conceptual overview
+ * @see For conceptual overview, visit {@link https://docs.vana.org/docs/permissions}
  */
 export declare class PermissionsController extends BaseController {
     constructor(context: ControllerContext);
@@ -859,35 +861,6 @@ export declare class PermissionsController extends BaseController {
      * ```
      */
     submitRegisterGrantee(params: RegisterGranteeParams, options?: TransactionOptions): Promise<TransactionResult<"DataPortabilityGrantees", "registerGrantee">>;
-    /**
-     * Registers a grantee with a signature (gasless transaction)
-     *
-     * @param params - Parameters for registering the grantee
-     * @returns Promise resolving to the transaction hash
-     *
-     * @example
-     * ```typescript
-     * const txHash = await vana.permissions.registerGranteeWithSignature({
-     *   owner: "0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36",
-     *   granteeAddress: "0xApp1234567890123456789012345678901234567890",
-     *   publicKey: "0x1234567890abcdef..."
-     * });
-     * ```
-     */
-    submitRegisterGranteeWithSignature(params: RegisterGranteeParams): Promise<TransactionResult<"DataPortabilityGrantees", "registerGrantee">>;
-    /**
-     * Submits a signed register grantee transaction via relayer
-     *
-     * @param typedData - The EIP-712 typed data for register grantee
-     * @param signature - The cryptographic signature
-     * @returns Promise resolving to the transaction hash
-     *
-     * @example
-     * ```typescript
-     * const result = await vana.permissions.submitSignedRegisterGrantee(typedData, signature);
-     * ```
-     */
-    submitSignedRegisterGrantee(typedData: RegisterGranteeTypedData, signature: Hash): Promise<TransactionResult<"DataPortabilityGrantees", "registerGrantee">>;
     /**
      * Retrieves all registered grantees from the DataPortabilityGrantees contract.
      *
@@ -974,23 +947,6 @@ export declare class PermissionsController extends BaseController {
      * ```
      */
     getGranteeById(granteeId: number): Promise<Grantee | null>;
-    /**
-     * Builds EIP-712 typed data for grantee registration
-     *
-     * @param input - The register grantee input
-     * @returns Promise resolving to the typed data structure
-     * @private
-     */
-    private buildRegisterGranteeTypedData;
-    /**
-     * Submits a register grantee transaction with signature.
-     *
-     * @param typedData - The EIP-712 typed data structure for the registration
-     * @param _signature - The cryptographic signature authorizing the registration (currently unused)
-     * @returns Promise resolving to the transaction hash
-     * @private
-     */
-    private submitSignedRegisterGranteeTransaction;
     /**
      * Get all trusted server IDs for a user
      *

package/dist/controllers/permissions.js

@@ -163,17 +163,31 @@ class PermissionsController extends BaseController {
       let { grantUrl } = params;
       console.debug("\u{1F50D} Debug - Grant URL from params:", grantUrl);
       if (!grantUrl) {
-        if (!this.context.relayerCallbacks?.storeGrantFile && !this.context.storageManager) {
+        const canStoreViaRelayer = this.context.relayer !== void 0;
+        if (!canStoreViaRelayer && !this.context.storageManager) {
           if (this.context.validateStorageRequired) {
             this.context.validateStorageRequired();
           } else {
             throw new Error(
-              "No storage available. Provide a grantUrl, configure relayerCallbacks.storeGrantFile, or storageManager."
+              "No storage available. Provide a grantUrl, configure relayer, or storageManager."
             );
           }
         }
-        if (this.context.relayerCallbacks?.storeGrantFile) {
-          grantUrl = await this.context.relayerCallbacks.storeGrantFile(grantFile);
+        if (canStoreViaRelayer && this.context.relayer) {
+          const request = {
+            type: "direct",
+            operation: "storeGrantFile",
+            params: grantFile
+          };
+          const response = await this.context.relayer(request);
+          if (response.type === "error") {
+            throw new Error(response.error);
+          }
+          if (response.type === "direct" && typeof response.result === "object" && "url" in response.result) {
+            grantUrl = response.result.url;
+          } else {
+            throw new Error("Invalid response from relayer for grant storage");
+          }
         } else if (this.context.storageManager) {
           const blob = new Blob([JSON.stringify(grantFile)], {
             type: "application/json"
@@ -257,17 +271,31 @@ class PermissionsController extends BaseController {
       let { grantUrl } = params;
       console.debug("\u{1F50D} Debug - Grant URL from params:", grantUrl);
       if (!grantUrl) {
-        if (!this.context.relayerCallbacks?.storeGrantFile && !this.context.storageManager) {
+        const canStoreViaRelayer = this.context.relayer !== void 0;
+        if (!canStoreViaRelayer && !this.context.storageManager) {
           if (this.context.validateStorageRequired) {
             this.context.validateStorageRequired();
           } else {
             throw new Error(
-              "No storage available. Provide a grantUrl, configure relayerCallbacks.storeGrantFile, or storageManager."
+              "No storage available. Provide a grantUrl, configure relayer, or storageManager."
             );
           }
         }
-        if (this.context.relayerCallbacks?.storeGrantFile) {
-          grantUrl = await this.context.relayerCallbacks.storeGrantFile(grantFile);
+        if (canStoreViaRelayer && this.context.relayer) {
+          const request = {
+            type: "direct",
+            operation: "storeGrantFile",
+            params: grantFile
+          };
+          const response = await this.context.relayer(request);
+          if (response.type === "error") {
+            throw new Error(response.error);
+          }
+          if (response.type === "direct" && typeof response.result === "object" && "url" in response.result) {
+            grantUrl = response.result.url;
+          } else {
+            throw new Error("Invalid response from relayer for grant storage");
+          }
         } else if (this.context.storageManager) {
           const blob = new Blob([JSON.stringify(grantFile)], {
             type: "application/json"
@@ -346,11 +374,24 @@ class PermissionsController extends BaseController {
           2
         )
       );
-      if (this.context.relayerCallbacks?.submitPermissionGrant) {
-        const hash = await this.context.relayerCallbacks.submitPermissionGrant(
+      if (this.context.relayer) {
+        const response = await this.context.relayer({
+          type: "signed",
+          operation: "submitAddPermission",
           typedData,
-          signature
-        );
+          signature,
+          expectedUserAddress: this.context.userAddress
+        });
+        let hash;
+        if (response.type === "signed") {
+          hash = response.hash;
+        } else if (response.type === "error") {
+          throw new Error(`Relayer error: ${response.error}`);
+        } else {
+          throw new Error(
+            "Invalid response from relayer: expected signed transaction"
+          );
+        }
         const account = this.context.walletClient?.account ?? this.context.userAddress;
         const { tx } = await import("../utils/transactionHelpers");
         return tx({
@@ -576,11 +617,23 @@ class PermissionsController extends BaseController {
   async submitSignedRevoke(typedData, signature) {
     try {
       let hash;
-      if (this.context.relayerCallbacks?.submitPermissionRevoke) {
-        hash = await this.context.relayerCallbacks.submitPermissionRevoke(
+      if (this.context.relayer) {
+        const response = await this.context.relayer({
+          type: "signed",
+          operation: "submitPermissionRevoke",
           typedData,
-          signature
-        );
+          signature,
+          expectedUserAddress: this.context.userAddress
+        });
+        if (response.type === "signed") {
+          hash = response.hash;
+        } else if (response.type === "error") {
+          throw new Error(`Relayer error: ${response.error}`);
+        } else {
+          throw new Error(
+            "Invalid response from relayer: expected signed transaction"
+          );
+        }
       } else {
         hash = await this.submitDirectRevokeTransaction(
           typedData,
@@ -629,11 +682,23 @@ class PermissionsController extends BaseController {
   async submitSignedUntrustServer(typedData, signature) {
     try {
       let hash;
-      if (this.context.relayerCallbacks?.submitUntrustServer) {
-        hash = await this.context.relayerCallbacks.submitUntrustServer(
+      if (this.context.relayer) {
+        const response = await this.context.relayer({
+          type: "signed",
+          operation: "submitUntrustServer",
           typedData,
-          signature
-        );
+          signature,
+          expectedUserAddress: this.context.userAddress
+        });
+        if (response.type === "signed") {
+          hash = response.hash;
+        } else if (response.type === "error") {
+          throw new Error(`Relayer error: ${response.error}`);
+        } else {
+          throw new Error(
+            "Invalid response from relayer: expected signed transaction"
+          );
+        }
       } else {
         hash = await this.submitSignedUntrustTransaction(
           typedData,
@@ -882,11 +947,23 @@ class PermissionsController extends BaseController {
       };
       const signature = await this.signTypedData(typedData);
       let hash;
-      if (this.context.relayerCallbacks?.submitPermissionRevoke) {
-        hash = await this.context.relayerCallbacks.submitPermissionRevoke(
+      if (this.context.relayer) {
+        const response = await this.context.relayer({
+          type: "signed",
+          operation: "submitPermissionRevoke",
           typedData,
-          signature
-        );
+          signature,
+          expectedUserAddress: this.context.userAddress
+        });
+        if (response.type === "signed") {
+          hash = response.hash;
+        } else if (response.type === "error") {
+          throw new Error(`Relayer error: ${response.error}`);
+        } else {
+          throw new Error(
+            "Invalid response from relayer: expected signed transaction"
+          );
+        }
       } else {
         hash = await this.submitDirectRevokeTransaction(
           typedData,
@@ -1480,11 +1557,22 @@ class PermissionsController extends BaseController {
       const signature = await this.signTypedData(typedData);
       console.debug("\u{1F50D} Generated signature:", signature);
       let hash;
-      if (this.context.relayerCallbacks?.submitAddAndTrustServer) {
-        hash = await this.context.relayerCallbacks.submitAddAndTrustServer(
+      if (this.context.relayer) {
+        const request = {
+          type: "signed",
+          operation: "submitAddAndTrustServer",
           typedData,
           signature
-        );
+        };
+        const response = await this.context.relayer(request);
+        if (response.type === "error") {
+          throw new RelayerError(response.error);
+        }
+        if (response.type === "signed") {
+          hash = response.hash;
+        } else {
+          throw new Error("Unexpected response type from relayer");
+        }
       } else {
         hash = await this.submitAddAndTrustServerTransaction(
           addAndTrustServerInput,
@@ -1538,11 +1626,22 @@ class PermissionsController extends BaseController {
       const typedData = await this.composeTrustServerMessage(trustServerInput);
       const signature = await this.signTypedData(typedData);
       let hash;
-      if (this.context.relayerCallbacks?.submitTrustServer) {
-        hash = await this.context.relayerCallbacks.submitTrustServer(
+      if (this.context.relayer) {
+        const request = {
+          type: "signed",
+          operation: "submitTrustServer",
           typedData,
           signature
-        );
+        };
+        const response = await this.context.relayer(request);
+        if (response.type === "error") {
+          throw new RelayerError(response.error);
+        }
+        if (response.type === "signed") {
+          hash = response.hash;
+        } else {
+          throw new Error("Unexpected response type from relayer");
+        }
       } else {
         hash = await this.submitTrustServerTransaction(
           trustServerInput,
@@ -1697,11 +1796,22 @@ class PermissionsController extends BaseController {
       const typedData = await this.composeUntrustServerMessage(untrustServerInput);
       const signature = await this.signTypedData(typedData);
       let hash;
-      if (this.context.relayerCallbacks?.submitUntrustServer) {
-        hash = await this.context.relayerCallbacks.submitUntrustServer(
+      if (this.context.relayer) {
+        const request = {
+          type: "signed",
+          operation: "submitUntrustServer",
           typedData,
           signature
-        );
+        };
+        const response = await this.context.relayer(request);
+        if (response.type === "error") {
+          throw new RelayerError(response.error);
+        }
+        if (response.type === "signed") {
+          hash = response.hash;
+        } else {
+          throw new Error("Unexpected response type from relayer");
+        }
       } else {
         hash = await this.submitSignedUntrustTransaction(typedData, signature);
       }
@@ -2334,73 +2444,9 @@ class PermissionsController extends BaseController {
       fn: "registerGrantee"
     });
   }
-  /**
-   * Registers a grantee with a signature (gasless transaction)
-   *
-   * @param params - Parameters for registering the grantee
-   * @returns Promise resolving to the transaction hash
-   *
-   * @example
-   * ```typescript
-   * const txHash = await vana.permissions.registerGranteeWithSignature({
-   *   owner: "0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36",
-   *   granteeAddress: "0xApp1234567890123456789012345678901234567890",
-   *   publicKey: "0x1234567890abcdef..."
-   * });
-   * ```
-   */
-  async submitRegisterGranteeWithSignature(params) {
-    this.assertWallet();
-    const nonce = await this.getServersUserNonce();
-    const owner = getAddress(params.owner);
-    const granteeAddress = getAddress(params.granteeAddress);
-    const registerGranteeInput = {
-      nonce,
-      owner,
-      granteeAddress,
-      publicKey: params.publicKey
-    };
-    const typedData = await this.buildRegisterGranteeTypedData(registerGranteeInput);
-    const signature = await this.signTypedData(typedData);
-    const hash = await this.submitSignedRegisterGranteeTransaction(
-      typedData,
-      signature
-    );
-    const account = this.context.walletClient?.account ?? this.context.userAddress;
-    const { tx } = await import("../utils/transactionHelpers");
-    return tx({
-      hash,
-      from: typeof account === "string" ? account : account.address,
-      contract: "DataPortabilityGrantees",
-      fn: "registerGrantee"
-    });
-  }
-  /**
-   * Submits a signed register grantee transaction via relayer
-   *
-   * @param typedData - The EIP-712 typed data for register grantee
-   * @param signature - The cryptographic signature
-   * @returns Promise resolving to the transaction hash
-   *
-   * @example
-   * ```typescript
-   * const result = await vana.permissions.submitSignedRegisterGrantee(typedData, signature);
-   * ```
-   */
-  async submitSignedRegisterGrantee(typedData, signature) {
-    const hash = await this.submitSignedRegisterGranteeTransaction(
-      typedData,
-      signature
-    );
-    const account = this.context.walletClient?.account ?? this.context.userAddress;
-    const { tx } = await import("../utils/transactionHelpers");
-    return tx({
-      hash,
-      from: typeof account === "string" ? account : account.address,
-      contract: "DataPortabilityGrantees",
-      fn: "registerGrantee"
-    });
-  }
+  // TODO: When DataPortabilityGrantees contract adds registerGranteeWithSignature function,
+  // implement submitRegisterGranteeWithSignature and submitSignedRegisterGrantee methods
+  // to support gasless transactions via relayer
   /**
    * Retrieves all registered grantees from the DataPortabilityGrantees contract.
    *
@@ -2587,68 +2633,6 @@ class PermissionsController extends BaseController {
       return null;
     }
   }
-  /**
-   * Builds EIP-712 typed data for grantee registration
-   *
-   * @param input - The register grantee input
-   * @returns Promise resolving to the typed data structure
-   * @private
-   */
-  async buildRegisterGranteeTypedData(input) {
-    const chainId = await this.context.publicClient.getChainId();
-    const verifyingContract = getContractAddress(
-      chainId,
-      "DataPortabilityGrantees"
-    );
-    return {
-      domain: {
-        name: "DataPortabilityGrantees",
-        version: "1",
-        chainId,
-        verifyingContract
-      },
-      types: {
-        RegisterGrantee: [
-          { name: "nonce", type: "uint256" },
-          { name: "owner", type: "address" },
-          { name: "granteeAddress", type: "address" },
-          { name: "publicKey", type: "string" }
-        ]
-      },
-      primaryType: "RegisterGrantee",
-      message: input
-    };
-  }
-  /**
-   * Submits a register grantee transaction with signature.
-   *
-   * @param typedData - The EIP-712 typed data structure for the registration
-   * @param _signature - The cryptographic signature authorizing the registration (currently unused)
-   * @returns Promise resolving to the transaction hash
-   * @private
-   */
-  async submitSignedRegisterGranteeTransaction(typedData, _signature) {
-    this.assertWallet();
-    const chainId = await this.context.walletClient.getChainId();
-    const DataPortabilityGranteesAddress = getContractAddress(
-      chainId,
-      "DataPortabilityGrantees"
-    );
-    const DataPortabilityGranteesAbi = getAbi("DataPortabilityGrantees");
-    const txHash = await this.context.walletClient.writeContract({
-      address: DataPortabilityGranteesAddress,
-      abi: DataPortabilityGranteesAbi,
-      functionName: "registerGrantee",
-      args: [
-        typedData.message.owner,
-        typedData.message.granteeAddress,
-        typedData.message.publicKey
-      ],
-      account: this.context.walletClient?.account ?? this.context.userAddress,
-      chain: this.context.walletClient?.chain ?? null
-    });
-    return txHash;
-  }
   // ===========================
   // DATA PORTABILITY SERVERS HELPER METHODS
   // ===========================
@@ -3598,11 +3582,22 @@ class PermissionsController extends BaseController {
     this.assertWallet();
     try {
       let hash;
-      if (this.context.relayerCallbacks?.submitAddPermission) {
-        hash = await this.context.relayerCallbacks.submitAddPermission(
+      if (this.context.relayer) {
+        const request = {
+          type: "signed",
+          operation: "submitAddPermission",
           typedData,
           signature
-        );
+        };
+        const response = await this.context.relayer(request);
+        if (response.type === "error") {
+          throw new RelayerError(response.error);
+        }
+        if (response.type === "signed") {
+          hash = response.hash;
+        } else {
+          throw new Error("Unexpected response type from relayer");
+        }
       } else {
         hash = await this.submitDirectAddPermissionTransaction(
           typedData,
@@ -3760,45 +3755,44 @@ class PermissionsController extends BaseController {
   async submitSignedAddServerFilesAndPermissions(typedData, signature, options) {
     this.assertWallet();
     try {
-      console.debug("\u{1F50D} submitSignedAddServerFilesAndPermissions Debug Info:", {
-        hasRelayerCallbacks: !!this.context.relayerCallbacks,
-        hasSubmitMethod: !!this.context.relayerCallbacks?.submitAddServerFilesAndPermissions,
-        availableRelayerMethods: this.context.relayerCallbacks ? Object.keys(this.context.relayerCallbacks) : []
-      });
-      if (this.context.relayerCallbacks?.submitAddServerFilesAndPermissions) {
+      let hash;
+      if (this.context.relayer) {
         console.debug(
           "\u{1F680} Using relayer for submitAddServerFilesAndPermissions"
         );
-        const hash = await this.context.relayerCallbacks.submitAddServerFilesAndPermissions(
+        const request = {
+          type: "signed",
+          operation: "submitAddServerFilesAndPermissions",
           typedData,
           signature
-        );
-        const account = this.context.walletClient?.account ?? this.context.userAddress;
-        const { tx } = await import("../utils/transactionHelpers");
-        return tx({
-          hash,
-          from: typeof account === "string" ? account : account.address,
-          contract: "DataPortabilityPermissions",
-          fn: "addServerFilesAndPermissions"
-        });
+        };
+        const response = await this.context.relayer(request);
+        if (response.type === "error") {
+          throw new RelayerError(response.error);
+        }
+        if (response.type === "signed") {
+          hash = response.hash;
+        } else {
+          throw new Error("Unexpected response type from relayer");
+        }
       } else {
         console.debug(
           "\u{1F4DD} Using direct transaction for submitAddServerFilesAndPermissions"
         );
-        const hash = await this.submitDirectAddServerFilesAndPermissionsTransaction(
+        hash = await this.submitDirectAddServerFilesAndPermissionsTransaction(
           typedData,
           signature,
           options
         );
-        const account = this.context.userAddress;
-        const { tx } = await import("../utils/transactionHelpers");
-        return tx({
-          hash,
-          from: account,
-          contract: "DataPortabilityPermissions",
-          fn: "addServerFilesAndPermissions"
-        });
       }
+      const account = this.context.walletClient?.account ?? this.context.userAddress;
+      const { tx } = await import("../utils/transactionHelpers");
+      return tx({
+        hash,
+        from: typeof account === "string" ? account : account.address,
+        contract: "DataPortabilityPermissions",
+        fn: "addServerFilesAndPermissions"
+      });
     } catch (error) {
       if (error instanceof RelayerError || error instanceof NetworkError || error instanceof UserRejectedRequestError || error instanceof SignatureError || error instanceof NonceError) {
         throw error;