@opendatalabs/vana-sdk 0.1.0-alpha.a260bf0 → 0.1.0-alpha.a27f5bd

package/dist/controllers/base.cjs

@@ -75,6 +75,39 @@ class BaseController {
       );
     }
   }
+  /**
+   * Helper to safely spread transaction options for viem compatibility.
+   * Handles EIP-1559 vs legacy gas pricing correctly.
+   *
+   * @param options - Transaction options to spread
+   * @returns Properly formatted options for viem
+   * @internal
+   */
+  spreadTransactionOptions(options) {
+    if (!options) return {};
+    const baseOptions = {
+      ...options.nonce !== void 0 && { nonce: options.nonce },
+      ...options.gas !== void 0 && { gas: options.gas }
+    };
+    if (options.maxFeePerGas !== void 0 || options.maxPriorityFeePerGas !== void 0) {
+      return {
+        ...baseOptions,
+        ...options.maxFeePerGas !== void 0 && {
+          maxFeePerGas: options.maxFeePerGas
+        },
+        ...options.maxPriorityFeePerGas !== void 0 && {
+          maxPriorityFeePerGas: options.maxPriorityFeePerGas
+        }
+      };
+    }
+    if (options.gasPrice !== void 0) {
+      return {
+        ...baseOptions,
+        gasPrice: options.gasPrice
+      };
+    }
+    return baseOptions;
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/controllers/base.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/base.ts"],"sourcesContent":["/**\n * Base controller class providing common functionality for all controllers.\n *\n * @remarks\n * This abstract class establishes the foundation for all Vana SDK controllers,\n * providing shared utilities like wallet validation and context management.\n * All controllers should extend this base class to ensure consistency and\n * shared behavior across the SDK.\n *\n * The class follows the Single Responsibility Principle by handling only\n * the core controller concerns while leaving specific functionality to\n * implementing classes.\n *\n * @category Controllers\n */\n\nimport type { WalletClient } from \"viem\";\nimport type { ControllerContext } from \"../types/controller-context\";\nimport { ReadOnlyError } from \"../errors\";\n\n/**\n * Abstract base controller that all Vana SDK controllers extend.\n *\n * @remarks\n * Provides common functionality and patterns used across all controllers,\n * including wallet validation and context management. This ensures\n * consistency and reduces code duplication throughout the SDK.\n *\n * Key features:\n * - Wallet client validation with TypeScript assertion signatures\n * - Consistent error handling for read-only scenarios\n * - Shared context management patterns\n * - Type-safe wallet operations\n *\n * @example\n * ```typescript\n * class MyController extends BaseController {\n *   async performWalletOperation() {\n *     this.assertWallet(); // Ensures wallet is available\n *     // Now this.context.walletClient is guaranteed to be available\n *     const address = await this.context.walletClient.getAddresses();\n *     return address[0];\n *   }\n * }\n * ```\n */\nexport abstract class BaseController {\n  /**\n   * Creates a new controller instance with the provided context.\n   *\n   * @param context - The controller context containing clients and configuration\n   */\n  constructor(protected readonly context: ControllerContext) {}\n\n  /**\n   * Asserts that a wallet client with an account is available for operations requiring signing.\n   *\n   * @remarks\n   * This method uses TypeScript assertion signatures to narrow the type of\n   * `this.context` to guarantee that `walletClient` with an account is available\n   * after the call succeeds. This provides compile-time safety for wallet operations\n   * while enabling clear error messages for read-only scenarios.\n   *\n   * The assertion signature ensures that after calling this method,\n   * TypeScript knows that `this.context.walletClient` is definitely available\n   * with a configured account.\n   *\n   * @throws {ReadOnlyError} When no wallet client is configured\n   * @throws {Error} When wallet client exists but no account is configured\n   *\n   * @example\n   * ```typescript\n   * async performWalletOperation() {\n   *   this.assertWallet(); // Type assertion + runtime check\n   *\n   *   // TypeScript now knows walletClient and account are available\n   *   const account = this.context.walletClient.account;\n   *   const address = typeof account === 'string' ? account : account.address;\n   * }\n   * ```\n   */\n  protected assertWallet(): asserts this is {\n    context: ControllerContext & { walletClient: WalletClient };\n  } {\n    if (!this.context.walletClient) {\n      // Get the calling method name from the stack trace for better error messages\n      const stack = new Error().stack;\n      const callingMethod =\n        stack?.split(\"\\n\")[2]?.match(/at \\w+\\.(\\w+)/)?.[1] ?? \"this operation\";\n\n      throw new ReadOnlyError(\n        callingMethod,\n        \"Initialize the SDK with a walletClient to perform this operation\",\n      );\n    }\n\n    if (!this.context.walletClient.account) {\n      // Get the calling method name from the stack trace for better error messages\n      const stack = new Error().stack;\n      const callingMethod =\n        stack?.split(\"\\n\")[2]?.match(/at \\w+\\.(\\w+)/)?.[1] ?? \"this operation\";\n\n      throw new Error(\n        `No wallet account connected. Cannot perform ${callingMethod} without an account.`,\n      );\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAkBA,oBAA8B;AA4BvB,MAAe,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMnC,YAA+B,SAA4B;AAA5B;AAAA,EAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BlD,eAER;AACA,QAAI,CAAC,KAAK,QAAQ,cAAc;AAE9B,YAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,YAAM,gBACJ,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK;AAExD,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,QAAQ,aAAa,SAAS;AAEtC,YAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,YAAM,gBACJ,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK;AAExD,YAAM,IAAI;AAAA,QACR,+CAA+C,aAAa;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/controllers/base.ts"],"sourcesContent":["/**\n * Base controller class providing common functionality for all controllers.\n *\n * @remarks\n * This abstract class establishes the foundation for all Vana SDK controllers,\n * providing shared utilities like wallet validation and context management.\n * All controllers should extend this base class to ensure consistency and\n * shared behavior across the SDK.\n *\n * The class follows the Single Responsibility Principle by handling only\n * the core controller concerns while leaving specific functionality to\n * implementing classes.\n *\n * @category Controllers\n */\n\nimport type { WalletClient } from \"viem\";\nimport type { ControllerContext } from \"../types/controller-context\";\nimport type { TransactionOptions } from \"../types/operations\";\nimport { ReadOnlyError } from \"../errors\";\n\n/**\n * Abstract base controller that all Vana SDK controllers extend.\n *\n * @remarks\n * Provides common functionality and patterns used across all controllers,\n * including wallet validation and context management. This ensures\n * consistency and reduces code duplication throughout the SDK.\n *\n * Key features:\n * - Wallet client validation with TypeScript assertion signatures\n * - Consistent error handling for read-only scenarios\n * - Shared context management patterns\n * - Type-safe wallet operations\n *\n * @example\n * ```typescript\n * class MyController extends BaseController {\n *   async performWalletOperation() {\n *     this.assertWallet(); // Ensures wallet is available\n *     // Now this.context.walletClient is guaranteed to be available\n *     const address = await this.context.walletClient.getAddresses();\n *     return address[0];\n *   }\n * }\n * ```\n */\nexport abstract class BaseController {\n  /**\n   * Creates a new controller instance with the provided context.\n   *\n   * @param context - The controller context containing clients and configuration\n   */\n  constructor(protected readonly context: ControllerContext) {}\n\n  /**\n   * Asserts that a wallet client with an account is available for operations requiring signing.\n   *\n   * @remarks\n   * This method uses TypeScript assertion signatures to narrow the type of\n   * `this.context` to guarantee that `walletClient` with an account is available\n   * after the call succeeds. This provides compile-time safety for wallet operations\n   * while enabling clear error messages for read-only scenarios.\n   *\n   * The assertion signature ensures that after calling this method,\n   * TypeScript knows that `this.context.walletClient` is definitely available\n   * with a configured account.\n   *\n   * @throws {ReadOnlyError} When no wallet client is configured\n   * @throws {Error} When wallet client exists but no account is configured\n   *\n   * @example\n   * ```typescript\n   * async performWalletOperation() {\n   *   this.assertWallet(); // Type assertion + runtime check\n   *\n   *   // TypeScript now knows walletClient and account are available\n   *   const account = this.context.walletClient.account;\n   *   const address = typeof account === 'string' ? account : account.address;\n   * }\n   * ```\n   */\n  protected assertWallet(): asserts this is {\n    context: ControllerContext & { walletClient: WalletClient };\n  } {\n    if (!this.context.walletClient) {\n      // Get the calling method name from the stack trace for better error messages\n      const stack = new Error().stack;\n      const callingMethod =\n        stack?.split(\"\\n\")[2]?.match(/at \\w+\\.(\\w+)/)?.[1] ?? \"this operation\";\n\n      throw new ReadOnlyError(\n        callingMethod,\n        \"Initialize the SDK with a walletClient to perform this operation\",\n      );\n    }\n\n    if (!this.context.walletClient.account) {\n      // Get the calling method name from the stack trace for better error messages\n      const stack = new Error().stack;\n      const callingMethod =\n        stack?.split(\"\\n\")[2]?.match(/at \\w+\\.(\\w+)/)?.[1] ?? \"this operation\";\n\n      throw new Error(\n        `No wallet account connected. Cannot perform ${callingMethod} without an account.`,\n      );\n    }\n  }\n\n  /**\n   * Helper to safely spread transaction options for viem compatibility.\n   * Handles EIP-1559 vs legacy gas pricing correctly.\n   *\n   * @param options - Transaction options to spread\n   * @returns Properly formatted options for viem\n   * @internal\n   */\n  protected spreadTransactionOptions(options?: TransactionOptions) {\n    if (!options) return {};\n\n    const baseOptions: any = {\n      ...(options.nonce !== undefined && { nonce: options.nonce }),\n      ...(options.gas !== undefined && { gas: options.gas }),\n    };\n\n    // EIP-1559 and legacy gasPrice are mutually exclusive in viem\n    // If EIP-1559 params are provided, use them and exclude gasPrice\n    if (\n      options.maxFeePerGas !== undefined ||\n      options.maxPriorityFeePerGas !== undefined\n    ) {\n      return {\n        ...baseOptions,\n        ...(options.maxFeePerGas !== undefined && {\n          maxFeePerGas: options.maxFeePerGas,\n        }),\n        ...(options.maxPriorityFeePerGas !== undefined && {\n          maxPriorityFeePerGas: options.maxPriorityFeePerGas,\n        }),\n      };\n    }\n\n    // Otherwise, use legacy gasPrice if provided\n    if (options.gasPrice !== undefined) {\n      return {\n        ...baseOptions,\n        gasPrice: options.gasPrice,\n      };\n    }\n\n    return baseOptions;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAmBA,oBAA8B;AA4BvB,MAAe,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMnC,YAA+B,SAA4B;AAA5B;AAAA,EAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BlD,eAER;AACA,QAAI,CAAC,KAAK,QAAQ,cAAc;AAE9B,YAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,YAAM,gBACJ,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK;AAExD,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,QAAQ,aAAa,SAAS;AAEtC,YAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,YAAM,gBACJ,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK;AAExD,YAAM,IAAI;AAAA,QACR,+CAA+C,aAAa;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUU,yBAAyB,SAA8B;AAC/D,QAAI,CAAC,QAAS,QAAO,CAAC;AAEtB,UAAM,cAAmB;AAAA,MACvB,GAAI,QAAQ,UAAU,UAAa,EAAE,OAAO,QAAQ,MAAM;AAAA,MAC1D,GAAI,QAAQ,QAAQ,UAAa,EAAE,KAAK,QAAQ,IAAI;AAAA,IACtD;AAIA,QACE,QAAQ,iBAAiB,UACzB,QAAQ,yBAAyB,QACjC;AACA,aAAO;AAAA,QACL,GAAG;AAAA,QACH,GAAI,QAAQ,iBAAiB,UAAa;AAAA,UACxC,cAAc,QAAQ;AAAA,QACxB;AAAA,QACA,GAAI,QAAQ,yBAAyB,UAAa;AAAA,UAChD,sBAAsB,QAAQ;AAAA,QAChC;AAAA,MACF;AAAA,IACF;AAGA,QAAI,QAAQ,aAAa,QAAW;AAClC,aAAO;AAAA,QACL,GAAG;AAAA,QACH,UAAU,QAAQ;AAAA,MACpB;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/controllers/base.d.ts

@@ -15,6 +15,7 @@
  */
 import type { WalletClient } from "viem";
 import type { ControllerContext } from "../types/controller-context";
+import type { TransactionOptions } from "../types/operations";
 /**
  * Abstract base controller that all Vana SDK controllers extend.
  *
@@ -81,4 +82,13 @@ export declare abstract class BaseController {
             walletClient: WalletClient;
         };
     };
+    /**
+     * Helper to safely spread transaction options for viem compatibility.
+     * Handles EIP-1559 vs legacy gas pricing correctly.
+     *
+     * @param options - Transaction options to spread
+     * @returns Properly formatted options for viem
+     * @internal
+     */
+    protected spreadTransactionOptions(options?: TransactionOptions): any;
 }

package/dist/controllers/base.js

@@ -52,6 +52,39 @@ class BaseController {
       );
     }
   }
+  /**
+   * Helper to safely spread transaction options for viem compatibility.
+   * Handles EIP-1559 vs legacy gas pricing correctly.
+   *
+   * @param options - Transaction options to spread
+   * @returns Properly formatted options for viem
+   * @internal
+   */
+  spreadTransactionOptions(options) {
+    if (!options) return {};
+    const baseOptions = {
+      ...options.nonce !== void 0 && { nonce: options.nonce },
+      ...options.gas !== void 0 && { gas: options.gas }
+    };
+    if (options.maxFeePerGas !== void 0 || options.maxPriorityFeePerGas !== void 0) {
+      return {
+        ...baseOptions,
+        ...options.maxFeePerGas !== void 0 && {
+          maxFeePerGas: options.maxFeePerGas
+        },
+        ...options.maxPriorityFeePerGas !== void 0 && {
+          maxPriorityFeePerGas: options.maxPriorityFeePerGas
+        }
+      };
+    }
+    if (options.gasPrice !== void 0) {
+      return {
+        ...baseOptions,
+        gasPrice: options.gasPrice
+      };
+    }
+    return baseOptions;
+  }
 }
 export {
   BaseController

package/dist/controllers/base.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/base.ts"],"sourcesContent":["/**\n * Base controller class providing common functionality for all controllers.\n *\n * @remarks\n * This abstract class establishes the foundation for all Vana SDK controllers,\n * providing shared utilities like wallet validation and context management.\n * All controllers should extend this base class to ensure consistency and\n * shared behavior across the SDK.\n *\n * The class follows the Single Responsibility Principle by handling only\n * the core controller concerns while leaving specific functionality to\n * implementing classes.\n *\n * @category Controllers\n */\n\nimport type { WalletClient } from \"viem\";\nimport type { ControllerContext } from \"../types/controller-context\";\nimport { ReadOnlyError } from \"../errors\";\n\n/**\n * Abstract base controller that all Vana SDK controllers extend.\n *\n * @remarks\n * Provides common functionality and patterns used across all controllers,\n * including wallet validation and context management. This ensures\n * consistency and reduces code duplication throughout the SDK.\n *\n * Key features:\n * - Wallet client validation with TypeScript assertion signatures\n * - Consistent error handling for read-only scenarios\n * - Shared context management patterns\n * - Type-safe wallet operations\n *\n * @example\n * ```typescript\n * class MyController extends BaseController {\n *   async performWalletOperation() {\n *     this.assertWallet(); // Ensures wallet is available\n *     // Now this.context.walletClient is guaranteed to be available\n *     const address = await this.context.walletClient.getAddresses();\n *     return address[0];\n *   }\n * }\n * ```\n */\nexport abstract class BaseController {\n  /**\n   * Creates a new controller instance with the provided context.\n   *\n   * @param context - The controller context containing clients and configuration\n   */\n  constructor(protected readonly context: ControllerContext) {}\n\n  /**\n   * Asserts that a wallet client with an account is available for operations requiring signing.\n   *\n   * @remarks\n   * This method uses TypeScript assertion signatures to narrow the type of\n   * `this.context` to guarantee that `walletClient` with an account is available\n   * after the call succeeds. This provides compile-time safety for wallet operations\n   * while enabling clear error messages for read-only scenarios.\n   *\n   * The assertion signature ensures that after calling this method,\n   * TypeScript knows that `this.context.walletClient` is definitely available\n   * with a configured account.\n   *\n   * @throws {ReadOnlyError} When no wallet client is configured\n   * @throws {Error} When wallet client exists but no account is configured\n   *\n   * @example\n   * ```typescript\n   * async performWalletOperation() {\n   *   this.assertWallet(); // Type assertion + runtime check\n   *\n   *   // TypeScript now knows walletClient and account are available\n   *   const account = this.context.walletClient.account;\n   *   const address = typeof account === 'string' ? account : account.address;\n   * }\n   * ```\n   */\n  protected assertWallet(): asserts this is {\n    context: ControllerContext & { walletClient: WalletClient };\n  } {\n    if (!this.context.walletClient) {\n      // Get the calling method name from the stack trace for better error messages\n      const stack = new Error().stack;\n      const callingMethod =\n        stack?.split(\"\\n\")[2]?.match(/at \\w+\\.(\\w+)/)?.[1] ?? \"this operation\";\n\n      throw new ReadOnlyError(\n        callingMethod,\n        \"Initialize the SDK with a walletClient to perform this operation\",\n      );\n    }\n\n    if (!this.context.walletClient.account) {\n      // Get the calling method name from the stack trace for better error messages\n      const stack = new Error().stack;\n      const callingMethod =\n        stack?.split(\"\\n\")[2]?.match(/at \\w+\\.(\\w+)/)?.[1] ?? \"this operation\";\n\n      throw new Error(\n        `No wallet account connected. Cannot perform ${callingMethod} without an account.`,\n      );\n    }\n  }\n}\n"],"mappings":"AAkBA,SAAS,qBAAqB;AA4BvB,MAAe,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMnC,YAA+B,SAA4B;AAA5B;AAAA,EAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BlD,eAER;AACA,QAAI,CAAC,KAAK,QAAQ,cAAc;AAE9B,YAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,YAAM,gBACJ,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK;AAExD,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,QAAQ,aAAa,SAAS;AAEtC,YAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,YAAM,gBACJ,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK;AAExD,YAAM,IAAI;AAAA,QACR,+CAA+C,aAAa;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/controllers/base.ts"],"sourcesContent":["/**\n * Base controller class providing common functionality for all controllers.\n *\n * @remarks\n * This abstract class establishes the foundation for all Vana SDK controllers,\n * providing shared utilities like wallet validation and context management.\n * All controllers should extend this base class to ensure consistency and\n * shared behavior across the SDK.\n *\n * The class follows the Single Responsibility Principle by handling only\n * the core controller concerns while leaving specific functionality to\n * implementing classes.\n *\n * @category Controllers\n */\n\nimport type { WalletClient } from \"viem\";\nimport type { ControllerContext } from \"../types/controller-context\";\nimport type { TransactionOptions } from \"../types/operations\";\nimport { ReadOnlyError } from \"../errors\";\n\n/**\n * Abstract base controller that all Vana SDK controllers extend.\n *\n * @remarks\n * Provides common functionality and patterns used across all controllers,\n * including wallet validation and context management. This ensures\n * consistency and reduces code duplication throughout the SDK.\n *\n * Key features:\n * - Wallet client validation with TypeScript assertion signatures\n * - Consistent error handling for read-only scenarios\n * - Shared context management patterns\n * - Type-safe wallet operations\n *\n * @example\n * ```typescript\n * class MyController extends BaseController {\n *   async performWalletOperation() {\n *     this.assertWallet(); // Ensures wallet is available\n *     // Now this.context.walletClient is guaranteed to be available\n *     const address = await this.context.walletClient.getAddresses();\n *     return address[0];\n *   }\n * }\n * ```\n */\nexport abstract class BaseController {\n  /**\n   * Creates a new controller instance with the provided context.\n   *\n   * @param context - The controller context containing clients and configuration\n   */\n  constructor(protected readonly context: ControllerContext) {}\n\n  /**\n   * Asserts that a wallet client with an account is available for operations requiring signing.\n   *\n   * @remarks\n   * This method uses TypeScript assertion signatures to narrow the type of\n   * `this.context` to guarantee that `walletClient` with an account is available\n   * after the call succeeds. This provides compile-time safety for wallet operations\n   * while enabling clear error messages for read-only scenarios.\n   *\n   * The assertion signature ensures that after calling this method,\n   * TypeScript knows that `this.context.walletClient` is definitely available\n   * with a configured account.\n   *\n   * @throws {ReadOnlyError} When no wallet client is configured\n   * @throws {Error} When wallet client exists but no account is configured\n   *\n   * @example\n   * ```typescript\n   * async performWalletOperation() {\n   *   this.assertWallet(); // Type assertion + runtime check\n   *\n   *   // TypeScript now knows walletClient and account are available\n   *   const account = this.context.walletClient.account;\n   *   const address = typeof account === 'string' ? account : account.address;\n   * }\n   * ```\n   */\n  protected assertWallet(): asserts this is {\n    context: ControllerContext & { walletClient: WalletClient };\n  } {\n    if (!this.context.walletClient) {\n      // Get the calling method name from the stack trace for better error messages\n      const stack = new Error().stack;\n      const callingMethod =\n        stack?.split(\"\\n\")[2]?.match(/at \\w+\\.(\\w+)/)?.[1] ?? \"this operation\";\n\n      throw new ReadOnlyError(\n        callingMethod,\n        \"Initialize the SDK with a walletClient to perform this operation\",\n      );\n    }\n\n    if (!this.context.walletClient.account) {\n      // Get the calling method name from the stack trace for better error messages\n      const stack = new Error().stack;\n      const callingMethod =\n        stack?.split(\"\\n\")[2]?.match(/at \\w+\\.(\\w+)/)?.[1] ?? \"this operation\";\n\n      throw new Error(\n        `No wallet account connected. Cannot perform ${callingMethod} without an account.`,\n      );\n    }\n  }\n\n  /**\n   * Helper to safely spread transaction options for viem compatibility.\n   * Handles EIP-1559 vs legacy gas pricing correctly.\n   *\n   * @param options - Transaction options to spread\n   * @returns Properly formatted options for viem\n   * @internal\n   */\n  protected spreadTransactionOptions(options?: TransactionOptions) {\n    if (!options) return {};\n\n    const baseOptions: any = {\n      ...(options.nonce !== undefined && { nonce: options.nonce }),\n      ...(options.gas !== undefined && { gas: options.gas }),\n    };\n\n    // EIP-1559 and legacy gasPrice are mutually exclusive in viem\n    // If EIP-1559 params are provided, use them and exclude gasPrice\n    if (\n      options.maxFeePerGas !== undefined ||\n      options.maxPriorityFeePerGas !== undefined\n    ) {\n      return {\n        ...baseOptions,\n        ...(options.maxFeePerGas !== undefined && {\n          maxFeePerGas: options.maxFeePerGas,\n        }),\n        ...(options.maxPriorityFeePerGas !== undefined && {\n          maxPriorityFeePerGas: options.maxPriorityFeePerGas,\n        }),\n      };\n    }\n\n    // Otherwise, use legacy gasPrice if provided\n    if (options.gasPrice !== undefined) {\n      return {\n        ...baseOptions,\n        gasPrice: options.gasPrice,\n      };\n    }\n\n    return baseOptions;\n  }\n}\n"],"mappings":"AAmBA,SAAS,qBAAqB;AA4BvB,MAAe,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMnC,YAA+B,SAA4B;AAA5B;AAAA,EAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BlD,eAER;AACA,QAAI,CAAC,KAAK,QAAQ,cAAc;AAE9B,YAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,YAAM,gBACJ,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK;AAExD,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,QAAQ,aAAa,SAAS;AAEtC,YAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,YAAM,gBACJ,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK;AAExD,YAAM,IAAI;AAAA,QACR,+CAA+C,aAAa;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUU,yBAAyB,SAA8B;AAC/D,QAAI,CAAC,QAAS,QAAO,CAAC;AAEtB,UAAM,cAAmB;AAAA,MACvB,GAAI,QAAQ,UAAU,UAAa,EAAE,OAAO,QAAQ,MAAM;AAAA,MAC1D,GAAI,QAAQ,QAAQ,UAAa,EAAE,KAAK,QAAQ,IAAI;AAAA,IACtD;AAIA,QACE,QAAQ,iBAAiB,UACzB,QAAQ,yBAAyB,QACjC;AACA,aAAO;AAAA,QACL,GAAG;AAAA,QACH,GAAI,QAAQ,iBAAiB,UAAa;AAAA,UACxC,cAAc,QAAQ;AAAA,QACxB;AAAA,QACA,GAAI,QAAQ,yBAAyB,UAAa;AAAA,UAChD,sBAAsB,QAAQ;AAAA,QAChC;AAAA,MACF;AAAA,IACF;AAGA,QAAI,QAAQ,aAAa,QAAW;AAClC,aAAO;AAAA,QACL,GAAG;AAAA,QACH,UAAU,QAAQ;AAAA,MACpB;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/controllers/data.cjs

@@ -1373,7 +1373,7 @@ class DataController extends import_base.BaseController {
    * console.log(`File ${fileId} registered with schema in tx ${transactionHash}`);
    * ```
    */
-  async registerFileWithSchema(url, schemaId) {
+  async registerFileWithSchema(url, schemaId, options) {
     this.assertWallet();
     try {
       const chainId = this.context.publicClient.chain?.id;
@@ -1391,7 +1391,8 @@ class DataController extends import_base.BaseController {
         functionName: "addFileWithSchema",
         args: [url, BigInt(schemaId)],
         account,
-        chain: this.context.walletClient.chain ?? null
+        chain: this.context.walletClient.chain ?? null,
+        ...this.spreadTransactionOptions(options)
       });
       const { tx } = await import("../utils/transactionHelpers");
       return tx({
@@ -1429,7 +1430,7 @@ class DataController extends import_base.BaseController {
    * with specific permissions on the DataRegistry contract. It can be used
    * by both direct transactions and relayer services.
    */
-  async addFileWithPermissions(url, ownerAddress, permissions = []) {
+  async addFileWithPermissions(url, ownerAddress, permissions = [], options) {
     this.assertWallet();
     try {
       const chainId = this.context.publicClient.chain?.id;
@@ -1447,7 +1448,8 @@ class DataController extends import_base.BaseController {
         functionName: "addFileWithPermissions",
         args: [url, ownerAddress, permissions],
         account,
-        chain: this.context.walletClient.chain ?? null
+        chain: this.context.walletClient.chain ?? null,
+        ...this.spreadTransactionOptions(options)
       });
       const { tx } = await import("../utils/transactionHelpers");
       return tx({
@@ -1502,7 +1504,7 @@ class DataController extends import_base.BaseController {
    * console.log(`File ${result.fileId} registered in tx ${result.hash}`);
    * ```
    */
-  async addFileWithPermissionsAndSchema(url, ownerAddress, permissions = [], schemaId = 0) {
+  async addFileWithPermissionsAndSchema(url, ownerAddress, permissions = [], schemaId = 0, options) {
     this.assertWallet();
     try {
       let encryptedPermissions = [];
@@ -1536,7 +1538,8 @@ class DataController extends import_base.BaseController {
         url,
         ownerAddress,
         encryptedPermissions,
-        schemaId
+        schemaId,
+        options
       );
     } catch (error) {
       console.error("Failed to add file with permissions and schema:", error);
@@ -1583,7 +1586,7 @@ class DataController extends import_base.BaseController {
    * console.log(`File registered in tx ${result.hash}`);
    * ```
    */
-  async addFileWithEncryptedPermissionsAndSchema(url, ownerAddress, permissions = [], schemaId = 0) {
+  async addFileWithEncryptedPermissionsAndSchema(url, ownerAddress, permissions = [], schemaId = 0, options) {
     try {
       const chainId = this.context.publicClient.chain?.id;
       if (!chainId) {
@@ -1600,7 +1603,8 @@ class DataController extends import_base.BaseController {
         functionName: "addFileWithPermissionsAndSchema",
         args: [url, ownerAddress, permissions, BigInt(schemaId)],
         account,
-        chain: this.context.walletClient.chain ?? null
+        chain: this.context.walletClient.chain ?? null,
+        ...this.spreadTransactionOptions(options)
       });
       const { tx } = await import("../utils/transactionHelpers");
       return tx({
@@ -1648,7 +1652,7 @@ class DataController extends import_base.BaseController {
    * console.log(`Refiner ${result.refinerId} created`);
    * ```
    */
-  async addRefiner(params) {
+  async addRefiner(params, options) {
     this.assertWallet();
     try {
       const chainId = this.context.publicClient.chain?.id;
@@ -1674,7 +1678,8 @@ class DataController extends import_base.BaseController {
           params.refinementInstructionUrl
         ],
         account,
-        chain: this.context.walletClient.chain ?? null
+        chain: this.context.walletClient.chain ?? null,
+        ...this.spreadTransactionOptions(options)
       });
       const { tx } = await import("../utils/transactionHelpers");
       const txResult = tx({
@@ -1874,7 +1879,7 @@ class DataController extends import_base.BaseController {
    * console.log(`Schema updated in tx ${result.transactionHash}`);
    * ```
    */
-  async updateSchemaId(params) {
+  async updateSchemaId(params, options) {
     this.assertWallet();
     try {
       const chainId = this.context.publicClient.chain?.id;
@@ -1894,7 +1899,8 @@ class DataController extends import_base.BaseController {
         functionName: "updateSchemaId",
         args: [BigInt(params.refinerId), BigInt(params.newSchemaId)],
         account,
-        chain: this.context.walletClient.chain ?? null
+        chain: this.context.walletClient.chain ?? null,
+        ...this.spreadTransactionOptions(options)
       });
       await this.context.publicClient.waitForTransactionReceipt({ hash });
       return {
@@ -2100,10 +2106,10 @@ class DataController extends import_base.BaseController {
    * console.log(`Transaction: ${result.transactionHash}`);
    * ```
    */
-  async addPermissionToFile(params) {
+  async addPermissionToFile(params, options) {
     this.assertWallet();
     const { fileId, account, publicKey } = params;
-    return await this.submitFilePermission(fileId, account, publicKey);
+    return await this.submitFilePermission(fileId, account, publicKey, options);
   }
   /**
    * Submits a file permission transaction to the blockchain.
@@ -2133,7 +2139,7 @@ class DataController extends import_base.BaseController {
    * console.log(`Permission granted with ID: ${result.permissionId}`);
    * ```
    */
-  async submitFilePermission(fileId, account, publicKey) {
+  async submitFilePermission(fileId, account, publicKey, options) {
     this.assertWallet();
     try {
       const userEncryptionKey = await (0, import_encryption.generateEncryptionKey)(
@@ -2160,7 +2166,8 @@ class DataController extends import_base.BaseController {
         functionName: "addFilePermission",
         args: [BigInt(fileId), account, encryptedKey],
         account: walletAccount,
-        chain: this.context.walletClient.chain ?? null
+        chain: this.context.walletClient.chain ?? null,
+        ...this.spreadTransactionOptions(options)
       });
       const { tx } = await import("../utils/transactionHelpers");
       return tx({