@opendatalabs/vana-sdk 0.1.0-alpha.eebb656 → 0.1.0-alpha.ef15099

package/dist/controllers/protocol.cjs

@@ -23,12 +23,15 @@ __export(protocol_exports, {
 module.exports = __toCommonJS(protocol_exports);
 var import_errors = require("../errors");
 var import_contractController = require("../contracts/contractController");
-class ProtocolController {
+var import_base = require("./base");
+class ProtocolController extends import_base.BaseController {
+  contractFactory;
   constructor(context) {
-    this.context = context;
-    this.contractFactory = new import_contractController.ContractFactory(context.walletClient);
+    super(context);
+    this.contractFactory = new import_contractController.ContractFactory(
+      context.walletClient ?? context.publicClient
+    );
   }
-  contractFactory;
   /**
    * Retrieves the address and ABI for a specific Vana protocol contract.
    *
@@ -53,7 +56,7 @@ class ProtocolController {
    */
   getContract(contractName) {
     try {
-      const chainId = this.context.walletClient.chain?.id;
+      const chainId = this.context.walletClient?.chain?.id ?? this.context.publicClient.chain?.id;
       if (!chainId) {
         throw new import_errors.ContractNotFoundError(contractName, 0);
       }
@@ -66,7 +69,7 @@ class ProtocolController {
         if (error.message.includes("Contract address not found")) {
           let chainId = 0;
           try {
-            chainId = this.context.walletClient.chain?.id ?? 0;
+            chainId = this.context.walletClient?.chain?.id ?? this.context.publicClient.chain?.id ?? 0;
           } catch {
             chainId = 0;
           }
@@ -102,6 +105,7 @@ class ProtocolController {
    * ```
    */
   createContract(contractName) {
+    this.assertWallet();
     try {
       return (0, import_contractController.getContractController)(contractName, this.context.walletClient);
     } catch (error) {
@@ -152,9 +156,9 @@ class ProtocolController {
    * @throws {Error} When chain ID is not available from wallet client
    */
   getChainId() {
-    const chainId = this.context.walletClient.chain?.id;
+    const chainId = this.context.walletClient?.chain?.id ?? this.context.publicClient.chain?.id;
     if (!chainId) {
-      throw new Error("Chain ID not available from wallet client");
+      throw new Error("Chain ID not available from client");
     }
     return chainId;
   }
@@ -165,9 +169,9 @@ class ProtocolController {
    * @throws {Error} When chain name is not available from wallet client
    */
   getChainName() {
-    const chainName = this.context.walletClient.chain?.name;
+    const chainName = this.context.walletClient?.chain?.name ?? this.context.publicClient.chain?.name;
     if (!chainName) {
-      throw new Error("Chain name not available from wallet client");
+      throw new Error("Chain name not available from client");
     }
     return chainName;
   }

package/dist/controllers/protocol.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/protocol.ts"],"sourcesContent":["import type { ContractInfo, VanaChainId } from \"../types/index\";\nimport type { VanaContract, ContractAbis } from \"../generated/abi\";\nimport { ContractNotFoundError } from \"../errors\";\nimport {\n  getContractController,\n  getContractInfo,\n  ContractFactory,\n} from \"../contracts/contractController\";\nimport type { ControllerContext } from \"./permissions\";\nimport type { GetContractReturnType } from \"viem\";\n\n/**\n * Provides direct, low-level access to all Vana protocol smart contracts.\n *\n * @remarks\n * This controller serves as the designated \"escape hatch\" for advanced developers who need\n * to interact directly with the underlying blockchain contracts. It provides access to\n * contract addresses, ABIs, and factory methods for creating typed contract instances.\n * Most developers should use the higher-level DataController and PermissionsController\n * instead of this advanced API.\n *\n * **Contract Selection:**\n * The controller automatically handles chain detection and provides only contracts that\n * are deployed on the current network. All contract instances are fully typed for\n * enhanced developer experience and type safety.\n *\n * **Method Selection:**\n * - `getContract()` retrieves contract address and ABI for manual interaction\n * - `createContract()` returns fully typed contract instance with read/write methods\n * - `getAvailableContracts()` lists all contracts deployed on current chain\n * - `isContractAvailable()` checks if specific contract exists on current chain\n * - `getChainId()` and `getChainName()` provide current network information\n *\n * **Usage Guidelines:**\n * Use this controller when high-level controllers don't provide needed functionality.\n * Most developers should use `vana.data.*` for files and `vana.permissions.*` for access control.\n *\n * **Type Safety:**\n * Use `as const` assertion with contract names for full TypeScript type inference.\n * Contract instances provide complete typing for all methods, parameters, and return values.\n *\n * @example\n * ```typescript\n * // Get contract info for direct interaction\n * const registry = vana.protocol.getContract(\"DataRegistry\" as const);\n *\n * // Access contract address and ABI with full typing\n * console.log(registry.address); // Contract address on current chain\n * console.log(registry.abi);     // Fully typed contract ABI\n *\n * // Create a typed contract instance\n * const contract = vana.protocol.createContract(\"DataRegistry\" as const);\n * const fileCount = await contract.read.filesCount();\n * ```\n * @category Advanced\n * @see {@link https://docs.vana.com/developer/protocol/contracts | Vana Protocol Contracts} for contract specifications\n */\nexport class ProtocolController {\n  private readonly contractFactory: ContractFactory;\n\n  constructor(private readonly context: ControllerContext) {\n    this.contractFactory = new ContractFactory(context.walletClient);\n  }\n\n  /**\n   * Retrieves the address and ABI for a specific Vana protocol contract.\n   *\n   * @remarks\n   * This method provides direct access to contract addresses and ABIs for the current\n   * chain. It includes full TypeScript type inference when using const assertions,\n   * enabling type-safe contract interactions. The method only returns contracts that\n   * are actually deployed on the current network.\n   * @param contractName - The name of the Vana contract to retrieve (use const assertion for full typing)\n   * @returns An object containing the contract's address and fully typed ABI\n   * @throws {ContractNotFoundError} When the contract is not deployed on the current chain.\n   *   Verify contract name spelling and check current network with `getChainId()`.\n   * @example\n   * ```typescript\n   * // Get contract info with full type inference\n   * const dataRegistry = vana.protocol.getContract(\"DataRegistry\" as const);\n   *\n   * // Now dataRegistry.abi is fully typed for the DataRegistry contract\n   * console.log(dataRegistry.address); // \"0x123...\"\n   * console.log(dataRegistry.abi.length); // Full ABI array\n   * ```\n   */\n  getContract<T extends VanaContract>(\n    contractName: T,\n  ): ContractInfo<ContractAbis[T]> {\n    try {\n      const chainId = this.context.walletClient.chain?.id;\n\n      if (!chainId) {\n        throw new ContractNotFoundError(contractName, 0);\n      }\n\n      return getContractInfo(contractName, chainId as VanaChainId);\n    } catch (error) {\n      if (error instanceof ContractNotFoundError) {\n        throw error;\n      }\n      if (error instanceof Error) {\n        if (error.message.includes(\"Contract address not found\")) {\n          let chainId = 0;\n          try {\n            chainId = this.context.walletClient.chain?.id ?? 0;\n          } catch {\n            // Use 0 as fallback if chain ID access fails\n            chainId = 0;\n          }\n          throw new ContractNotFoundError(contractName, chainId);\n        }\n        throw error;\n      }\n      throw new Error(`Failed to get contract ${contractName}: Unknown error`);\n    }\n  }\n\n  /**\n   * Creates a fully typed contract instance ready for blockchain interaction.\n   *\n   * @remarks\n   * This method creates a contract instance with complete type safety for all contract\n   * methods including read operations, write operations, and event handling. The instance\n   * is pre-configured with the correct address, ABI, and wallet client for immediate use.\n   * All method parameters and return types are fully typed based on the contract ABI.\n   * @param contractName - The name of the Vana contract (use const assertion for full typing)\n   * @returns A fully typed contract instance with read/write methods and event handling\n   * @throws {ContractNotFoundError} When the contract is not deployed on the current chain\n   * @example\n   * ```typescript\n   * // Create typed contract instance\n   * const dataRegistry = vana.protocol.createContract(\"DataRegistry\" as const);\n   *\n   * // Full type safety for all operations\n   * const fileCount = await dataRegistry.read.filesCount(); // Type: bigint\n   * const txHash = await dataRegistry.write.addFile([\"ipfs://...\"]); // Typed parameters\n   *\n   * // Listen to events with full typing\n   * const logs = await dataRegistry.getEvents.FileAdded();\n   * ```\n   */\n  createContract<T extends VanaContract>(\n    contractName: T,\n  ): GetContractReturnType<ContractAbis[T]> {\n    try {\n      return getContractController(contractName, this.context.walletClient);\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.message.includes(\"Contract address not found\")) {\n          const chainId = this.context.walletClient.chain?.id ?? 0;\n          throw new ContractNotFoundError(contractName, chainId);\n        }\n        throw error;\n      }\n      throw new Error(\n        `Failed to create contract ${contractName}: Unknown error`,\n      );\n    }\n  }\n\n  /**\n   * Gets all available contract names that can be used with getContract().\n   * Returns only contracts that are actually deployed on the current chain.\n   *\n   * @returns Array of all available contract names for the current chain\n   */\n  getAvailableContracts(): VanaContract[] {\n    return this.contractFactory.getAvailableContracts();\n  }\n\n  /**\n   * Checks if a specific contract is available on the current chain.\n   *\n   * @param contractName - The contract name to check\n   * @returns Whether the contract is deployed on the current chain\n   */\n  isContractAvailable(contractName: VanaContract): boolean {\n    const availableContracts = this.getAvailableContracts();\n    return availableContracts.includes(contractName);\n  }\n\n  /**\n   * Gets the contract factory instance for advanced usage.\n   * This provides access to additional contract management methods.\n   *\n   * @returns The contract factory instance\n   */\n  getContractFactory(): ContractFactory {\n    return this.contractFactory;\n  }\n\n  /**\n   * Gets the current chain ID from the wallet client.\n   *\n   * @returns The chain ID\n   * @throws {Error} When chain ID is not available from wallet client\n   */\n  getChainId(): number {\n    const chainId = this.context.walletClient.chain?.id;\n    if (!chainId) {\n      throw new Error(\"Chain ID not available from wallet client\");\n    }\n    return chainId;\n  }\n\n  /**\n   * Gets the current chain name from the wallet client.\n   *\n   * @returns The chain name\n   * @throws {Error} When chain name is not available from wallet client\n   */\n  getChainName(): string {\n    const chainName = this.context.walletClient.chain?.name;\n    if (!chainName) {\n      throw new Error(\"Chain name not available from wallet client\");\n    }\n    return chainName;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,oBAAsC;AACtC,gCAIO;AAkDA,MAAM,mBAAmB;AAAA,EAG9B,YAA6B,SAA4B;AAA5B;AAC3B,SAAK,kBAAkB,IAAI,0CAAgB,QAAQ,YAAY;AAAA,EACjE;AAAA,EAJiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA4BjB,YACE,cAC+B;AAC/B,QAAI;AACF,YAAM,UAAU,KAAK,QAAQ,aAAa,OAAO;AAEjD,UAAI,CAAC,SAAS;AACZ,cAAM,IAAI,oCAAsB,cAAc,CAAC;AAAA,MACjD;AAEA,iBAAO,2CAAgB,cAAc,OAAsB;AAAA,IAC7D,SAAS,OAAO;AACd,UAAI,iBAAiB,qCAAuB;AAC1C,cAAM;AAAA,MACR;AACA,UAAI,iBAAiB,OAAO;AAC1B,YAAI,MAAM,QAAQ,SAAS,4BAA4B,GAAG;AACxD,cAAI,UAAU;AACd,cAAI;AACF,sBAAU,KAAK,QAAQ,aAAa,OAAO,MAAM;AAAA,UACnD,QAAQ;AAEN,sBAAU;AAAA,UACZ;AACA,gBAAM,IAAI,oCAAsB,cAAc,OAAO;AAAA,QACvD;AACA,cAAM;AAAA,MACR;AACA,YAAM,IAAI,MAAM,0BAA0B,YAAY,iBAAiB;AAAA,IACzE;AAAA,EACF;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,EA0BA,eACE,cACwC;AACxC,QAAI;AACF,iBAAO,iDAAsB,cAAc,KAAK,QAAQ,YAAY;AAAA,IACtE,SAAS,OAAO;AACd,UAAI,iBAAiB,OAAO;AAC1B,YAAI,MAAM,QAAQ,SAAS,4BAA4B,GAAG;AACxD,gBAAM,UAAU,KAAK,QAAQ,aAAa,OAAO,MAAM;AACvD,gBAAM,IAAI,oCAAsB,cAAc,OAAO;AAAA,QACvD;AACA,cAAM;AAAA,MACR;AACA,YAAM,IAAI;AAAA,QACR,6BAA6B,YAAY;AAAA,MAC3C;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,wBAAwC;AACtC,WAAO,KAAK,gBAAgB,sBAAsB;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,oBAAoB,cAAqC;AACvD,UAAM,qBAAqB,KAAK,sBAAsB;AACtD,WAAO,mBAAmB,SAAS,YAAY;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,qBAAsC;AACpC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,aAAqB;AACnB,UAAM,UAAU,KAAK,QAAQ,aAAa,OAAO;AACjD,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,MAAM,2CAA2C;AAAA,IAC7D;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,eAAuB;AACrB,UAAM,YAAY,KAAK,QAAQ,aAAa,OAAO;AACnD,QAAI,CAAC,WAAW;AACd,YAAM,IAAI,MAAM,6CAA6C;AAAA,IAC/D;AACA,WAAO;AAAA,EACT;AACF;","names":[]}
+{"version":3,"sources":["../../src/controllers/protocol.ts"],"sourcesContent":["import type { ContractInfo, VanaChainId } from \"../types/index\";\nimport type { VanaContract, ContractAbis } from \"../generated/abi\";\nimport { ContractNotFoundError } from \"../errors\";\nimport {\n  getContractController,\n  getContractInfo,\n  ContractFactory,\n} from \"../contracts/contractController\";\nimport type { ControllerContext } from \"../types/controller-context\";\nimport type { GetContractReturnType } from \"viem\";\nimport { BaseController } from \"./base\";\n\n/**\n * Provides low-level access to Vana protocol smart contracts.\n *\n * @remarks\n * Advanced API for direct contract interaction. Most developers should use\n * higher-level controllers (DataController, PermissionsController) instead.\n * This controller serves as an escape hatch when high-level APIs lack needed\n * functionality.\n *\n * **Architecture:**\n * Automatically detects current chain and provides only deployed contracts.\n * Full TypeScript type safety through contract ABIs and const assertions.\n *\n * **Method Selection:**\n * - `getContract()` - Retrieve address and ABI for manual interaction\n * - `createContract()` - Get typed contract instance with read/write methods\n * - `getAvailableContracts()` - List all contracts on current chain\n * - `isContractAvailable()` - Check contract deployment status\n * - `getChainId()`/`getChainName()` - Current network information\n *\n * **When to Use:**\n * - Custom contract interactions not covered by high-level APIs\n * - Direct contract event listening\n * - Advanced protocol operations\n *\n * **Type Safety:**\n * Always use `as const` with contract names for full type inference.\n *\n * @example\n * ```typescript\n * // Get contract info with typed ABI\n * const registry = vana.protocol.getContract(\"DataRegistry\" as const);\n * console.log(`Contract at ${registry.address}`);\n *\n * // Create typed contract instance\n * const contract = vana.protocol.createContract(\"DataRegistry\" as const);\n * const count = await contract.read.filesCount(); // Returns: bigint\n *\n * // Write operations with full typing\n * const hash = await contract.write.addFile([\"ipfs://...\"]);\n * ```\n *\n * @category Advanced\n * @see For contract specifications, visit {@link https://docs.vana.org/docs/protocol-contracts}\n */\nexport class ProtocolController extends BaseController {\n  private readonly contractFactory: ContractFactory;\n\n  constructor(context: ControllerContext) {\n    super(context);\n    this.contractFactory = new ContractFactory(\n      context.walletClient ?? context.publicClient,\n    );\n  }\n\n  /**\n   * Retrieves the address and ABI for a specific Vana protocol contract.\n   *\n   * @remarks\n   * This method provides direct access to contract addresses and ABIs for the current\n   * chain. It includes full TypeScript type inference when using const assertions,\n   * enabling type-safe contract interactions. The method only returns contracts that\n   * are actually deployed on the current network.\n   * @param contractName - The name of the Vana contract to retrieve (use const assertion for full typing)\n   * @returns An object containing the contract's address and fully typed ABI\n   * @throws {ContractNotFoundError} When the contract is not deployed on the current chain.\n   *   Verify contract name spelling and check current network with `getChainId()`.\n   * @example\n   * ```typescript\n   * // Get contract info with full type inference\n   * const dataRegistry = vana.protocol.getContract(\"DataRegistry\" as const);\n   *\n   * // Now dataRegistry.abi is fully typed for the DataRegistry contract\n   * console.log(dataRegistry.address); // \"0x123...\"\n   * console.log(dataRegistry.abi.length); // Full ABI array\n   * ```\n   */\n  getContract<T extends VanaContract>(\n    contractName: T,\n  ): ContractInfo<ContractAbis[T]> {\n    try {\n      const chainId =\n        this.context.walletClient?.chain?.id ??\n        this.context.publicClient.chain?.id;\n\n      if (!chainId) {\n        throw new ContractNotFoundError(contractName, 0);\n      }\n\n      return getContractInfo(contractName, chainId as VanaChainId);\n    } catch (error) {\n      if (error instanceof ContractNotFoundError) {\n        throw error;\n      }\n      if (error instanceof Error) {\n        if (error.message.includes(\"Contract address not found\")) {\n          let chainId = 0;\n          try {\n            chainId =\n              this.context.walletClient?.chain?.id ??\n              this.context.publicClient.chain?.id ??\n              0;\n          } catch {\n            // Use 0 as fallback if chain ID access fails\n            chainId = 0;\n          }\n          throw new ContractNotFoundError(contractName, chainId);\n        }\n        throw error;\n      }\n      throw new Error(`Failed to get contract ${contractName}: Unknown error`);\n    }\n  }\n\n  /**\n   * Creates a fully typed contract instance ready for blockchain interaction.\n   *\n   * @remarks\n   * This method creates a contract instance with complete type safety for all contract\n   * methods including read operations, write operations, and event handling. The instance\n   * is pre-configured with the correct address, ABI, and wallet client for immediate use.\n   * All method parameters and return types are fully typed based on the contract ABI.\n   * @param contractName - The name of the Vana contract (use const assertion for full typing)\n   * @returns A fully typed contract instance with read/write methods and event handling\n   * @throws {ContractNotFoundError} When the contract is not deployed on the current chain\n   * @example\n   * ```typescript\n   * // Create typed contract instance\n   * const dataRegistry = vana.protocol.createContract(\"DataRegistry\" as const);\n   *\n   * // Full type safety for all operations\n   * const fileCount = await dataRegistry.read.filesCount(); // Type: bigint\n   * const txHash = await dataRegistry.write.addFile([\"ipfs://...\"]); // Typed parameters\n   *\n   * // Listen to events with full typing\n   * const logs = await dataRegistry.getEvents.FileAdded();\n   * ```\n   */\n  createContract<T extends VanaContract>(\n    contractName: T,\n  ): GetContractReturnType<ContractAbis[T]> {\n    this.assertWallet();\n    try {\n      return getContractController(contractName, this.context.walletClient);\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.message.includes(\"Contract address not found\")) {\n          const chainId = this.context.walletClient.chain?.id ?? 0;\n          throw new ContractNotFoundError(contractName, chainId);\n        }\n        throw error;\n      }\n      throw new Error(\n        `Failed to create contract ${contractName}: Unknown error`,\n      );\n    }\n  }\n\n  /**\n   * Gets all available contract names that can be used with getContract().\n   * Returns only contracts that are actually deployed on the current chain.\n   *\n   * @returns Array of all available contract names for the current chain\n   */\n  getAvailableContracts(): VanaContract[] {\n    return this.contractFactory.getAvailableContracts();\n  }\n\n  /**\n   * Checks if a specific contract is available on the current chain.\n   *\n   * @param contractName - The contract name to check\n   * @returns Whether the contract is deployed on the current chain\n   */\n  isContractAvailable(contractName: VanaContract): boolean {\n    const availableContracts = this.getAvailableContracts();\n    return availableContracts.includes(contractName);\n  }\n\n  /**\n   * Gets the contract factory instance for advanced usage.\n   * This provides access to additional contract management methods.\n   *\n   * @returns The contract factory instance\n   */\n  getContractFactory(): ContractFactory {\n    return this.contractFactory;\n  }\n\n  /**\n   * Gets the current chain ID from the wallet client.\n   *\n   * @returns The chain ID\n   * @throws {Error} When chain ID is not available from wallet client\n   */\n  getChainId(): number {\n    const chainId =\n      this.context.walletClient?.chain?.id ??\n      this.context.publicClient.chain?.id;\n    if (!chainId) {\n      throw new Error(\"Chain ID not available from client\");\n    }\n    return chainId;\n  }\n\n  /**\n   * Gets the current chain name from the wallet client.\n   *\n   * @returns The chain name\n   * @throws {Error} When chain name is not available from wallet client\n   */\n  getChainName(): string {\n    const chainName =\n      this.context.walletClient?.chain?.name ??\n      this.context.publicClient.chain?.name;\n    if (!chainName) {\n      throw new Error(\"Chain name not available from client\");\n    }\n    return chainName;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/controllers/protocol.d.ts

@@ -1,56 +1,55 @@
 import type { ContractInfo } from "../types/index";
 import type { VanaContract, ContractAbis } from "../generated/abi";
 import { ContractFactory } from "../contracts/contractController";
-import type { ControllerContext } from "./permissions";
+import type { ControllerContext } from "../types/controller-context";
 import type { GetContractReturnType } from "viem";
+import { BaseController } from "./base";
 /**
- * Provides direct, low-level access to all Vana protocol smart contracts.
+ * Provides low-level access to Vana protocol smart contracts.
  *
  * @remarks
- * This controller serves as the designated "escape hatch" for advanced developers who need
- * to interact directly with the underlying blockchain contracts. It provides access to
- * contract addresses, ABIs, and factory methods for creating typed contract instances.
- * Most developers should use the higher-level DataController and PermissionsController
- * instead of this advanced API.
+ * Advanced API for direct contract interaction. Most developers should use
+ * higher-level controllers (DataController, PermissionsController) instead.
+ * This controller serves as an escape hatch when high-level APIs lack needed
+ * functionality.
  *
- * **Contract Selection:**
- * The controller automatically handles chain detection and provides only contracts that
- * are deployed on the current network. All contract instances are fully typed for
- * enhanced developer experience and type safety.
+ * **Architecture:**
+ * Automatically detects current chain and provides only deployed contracts.
+ * Full TypeScript type safety through contract ABIs and const assertions.
  *
  * **Method Selection:**
- * - `getContract()` retrieves contract address and ABI for manual interaction
- * - `createContract()` returns fully typed contract instance with read/write methods
- * - `getAvailableContracts()` lists all contracts deployed on current chain
- * - `isContractAvailable()` checks if specific contract exists on current chain
- * - `getChainId()` and `getChainName()` provide current network information
+ * - `getContract()` - Retrieve address and ABI for manual interaction
+ * - `createContract()` - Get typed contract instance with read/write methods
+ * - `getAvailableContracts()` - List all contracts on current chain
+ * - `isContractAvailable()` - Check contract deployment status
+ * - `getChainId()`/`getChainName()` - Current network information
  *
- * **Usage Guidelines:**
- * Use this controller when high-level controllers don't provide needed functionality.
- * Most developers should use `vana.data.*` for files and `vana.permissions.*` for access control.
+ * **When to Use:**
+ * - Custom contract interactions not covered by high-level APIs
+ * - Direct contract event listening
+ * - Advanced protocol operations
  *
  * **Type Safety:**
- * Use `as const` assertion with contract names for full TypeScript type inference.
- * Contract instances provide complete typing for all methods, parameters, and return values.
+ * Always use `as const` with contract names for full type inference.
  *
  * @example
  * ```typescript
- * // Get contract info for direct interaction
+ * // Get contract info with typed ABI
  * const registry = vana.protocol.getContract("DataRegistry" as const);
+ * console.log(`Contract at ${registry.address}`);
  *
- * // Access contract address and ABI with full typing
- * console.log(registry.address); // Contract address on current chain
- * console.log(registry.abi);     // Fully typed contract ABI
- *
- * // Create a typed contract instance
+ * // Create typed contract instance
  * const contract = vana.protocol.createContract("DataRegistry" as const);
- * const fileCount = await contract.read.filesCount();
+ * const count = await contract.read.filesCount(); // Returns: bigint
+ *
+ * // Write operations with full typing
+ * const hash = await contract.write.addFile(["ipfs://..."]);
  * ```
+ *
  * @category Advanced
- * @see {@link https://docs.vana.com/developer/protocol/contracts | Vana Protocol Contracts} for contract specifications
+ * @see For contract specifications, visit {@link https://docs.vana.org/docs/protocol-contracts}
  */
-export declare class ProtocolController {
-    private readonly context;
+export declare class ProtocolController extends BaseController {
     private readonly contractFactory;
     constructor(context: ControllerContext);
     /**

package/dist/controllers/protocol.js

@@ -4,12 +4,15 @@ import {
   getContractInfo,
   ContractFactory
 } from "../contracts/contractController";
-class ProtocolController {
+import { BaseController } from "./base";
+class ProtocolController extends BaseController {
+  contractFactory;
   constructor(context) {
-    this.context = context;
-    this.contractFactory = new ContractFactory(context.walletClient);
+    super(context);
+    this.contractFactory = new ContractFactory(
+      context.walletClient ?? context.publicClient
+    );
   }
-  contractFactory;
   /**
    * Retrieves the address and ABI for a specific Vana protocol contract.
    *
@@ -34,7 +37,7 @@ class ProtocolController {
    */
   getContract(contractName) {
     try {
-      const chainId = this.context.walletClient.chain?.id;
+      const chainId = this.context.walletClient?.chain?.id ?? this.context.publicClient.chain?.id;
       if (!chainId) {
         throw new ContractNotFoundError(contractName, 0);
       }
@@ -47,7 +50,7 @@ class ProtocolController {
         if (error.message.includes("Contract address not found")) {
           let chainId = 0;
           try {
-            chainId = this.context.walletClient.chain?.id ?? 0;
+            chainId = this.context.walletClient?.chain?.id ?? this.context.publicClient.chain?.id ?? 0;
           } catch {
             chainId = 0;
           }
@@ -83,6 +86,7 @@ class ProtocolController {
    * ```
    */
   createContract(contractName) {
+    this.assertWallet();
     try {
       return getContractController(contractName, this.context.walletClient);
     } catch (error) {
@@ -133,9 +137,9 @@ class ProtocolController {
    * @throws {Error} When chain ID is not available from wallet client
    */
   getChainId() {
-    const chainId = this.context.walletClient.chain?.id;
+    const chainId = this.context.walletClient?.chain?.id ?? this.context.publicClient.chain?.id;
     if (!chainId) {
-      throw new Error("Chain ID not available from wallet client");
+      throw new Error("Chain ID not available from client");
     }
     return chainId;
   }
@@ -146,9 +150,9 @@ class ProtocolController {
    * @throws {Error} When chain name is not available from wallet client
    */
   getChainName() {
-    const chainName = this.context.walletClient.chain?.name;
+    const chainName = this.context.walletClient?.chain?.name ?? this.context.publicClient.chain?.name;
     if (!chainName) {
-      throw new Error("Chain name not available from wallet client");
+      throw new Error("Chain name not available from client");
     }
     return chainName;
   }

package/dist/controllers/protocol.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/protocol.ts"],"sourcesContent":["import type { ContractInfo, VanaChainId } from \"../types/index\";\nimport type { VanaContract, ContractAbis } from \"../generated/abi\";\nimport { ContractNotFoundError } from \"../errors\";\nimport {\n  getContractController,\n  getContractInfo,\n  ContractFactory,\n} from \"../contracts/contractController\";\nimport type { ControllerContext } from \"./permissions\";\nimport type { GetContractReturnType } from \"viem\";\n\n/**\n * Provides direct, low-level access to all Vana protocol smart contracts.\n *\n * @remarks\n * This controller serves as the designated \"escape hatch\" for advanced developers who need\n * to interact directly with the underlying blockchain contracts. It provides access to\n * contract addresses, ABIs, and factory methods for creating typed contract instances.\n * Most developers should use the higher-level DataController and PermissionsController\n * instead of this advanced API.\n *\n * **Contract Selection:**\n * The controller automatically handles chain detection and provides only contracts that\n * are deployed on the current network. All contract instances are fully typed for\n * enhanced developer experience and type safety.\n *\n * **Method Selection:**\n * - `getContract()` retrieves contract address and ABI for manual interaction\n * - `createContract()` returns fully typed contract instance with read/write methods\n * - `getAvailableContracts()` lists all contracts deployed on current chain\n * - `isContractAvailable()` checks if specific contract exists on current chain\n * - `getChainId()` and `getChainName()` provide current network information\n *\n * **Usage Guidelines:**\n * Use this controller when high-level controllers don't provide needed functionality.\n * Most developers should use `vana.data.*` for files and `vana.permissions.*` for access control.\n *\n * **Type Safety:**\n * Use `as const` assertion with contract names for full TypeScript type inference.\n * Contract instances provide complete typing for all methods, parameters, and return values.\n *\n * @example\n * ```typescript\n * // Get contract info for direct interaction\n * const registry = vana.protocol.getContract(\"DataRegistry\" as const);\n *\n * // Access contract address and ABI with full typing\n * console.log(registry.address); // Contract address on current chain\n * console.log(registry.abi);     // Fully typed contract ABI\n *\n * // Create a typed contract instance\n * const contract = vana.protocol.createContract(\"DataRegistry\" as const);\n * const fileCount = await contract.read.filesCount();\n * ```\n * @category Advanced\n * @see {@link https://docs.vana.com/developer/protocol/contracts | Vana Protocol Contracts} for contract specifications\n */\nexport class ProtocolController {\n  private readonly contractFactory: ContractFactory;\n\n  constructor(private readonly context: ControllerContext) {\n    this.contractFactory = new ContractFactory(context.walletClient);\n  }\n\n  /**\n   * Retrieves the address and ABI for a specific Vana protocol contract.\n   *\n   * @remarks\n   * This method provides direct access to contract addresses and ABIs for the current\n   * chain. It includes full TypeScript type inference when using const assertions,\n   * enabling type-safe contract interactions. The method only returns contracts that\n   * are actually deployed on the current network.\n   * @param contractName - The name of the Vana contract to retrieve (use const assertion for full typing)\n   * @returns An object containing the contract's address and fully typed ABI\n   * @throws {ContractNotFoundError} When the contract is not deployed on the current chain.\n   *   Verify contract name spelling and check current network with `getChainId()`.\n   * @example\n   * ```typescript\n   * // Get contract info with full type inference\n   * const dataRegistry = vana.protocol.getContract(\"DataRegistry\" as const);\n   *\n   * // Now dataRegistry.abi is fully typed for the DataRegistry contract\n   * console.log(dataRegistry.address); // \"0x123...\"\n   * console.log(dataRegistry.abi.length); // Full ABI array\n   * ```\n   */\n  getContract<T extends VanaContract>(\n    contractName: T,\n  ): ContractInfo<ContractAbis[T]> {\n    try {\n      const chainId = this.context.walletClient.chain?.id;\n\n      if (!chainId) {\n        throw new ContractNotFoundError(contractName, 0);\n      }\n\n      return getContractInfo(contractName, chainId as VanaChainId);\n    } catch (error) {\n      if (error instanceof ContractNotFoundError) {\n        throw error;\n      }\n      if (error instanceof Error) {\n        if (error.message.includes(\"Contract address not found\")) {\n          let chainId = 0;\n          try {\n            chainId = this.context.walletClient.chain?.id ?? 0;\n          } catch {\n            // Use 0 as fallback if chain ID access fails\n            chainId = 0;\n          }\n          throw new ContractNotFoundError(contractName, chainId);\n        }\n        throw error;\n      }\n      throw new Error(`Failed to get contract ${contractName}: Unknown error`);\n    }\n  }\n\n  /**\n   * Creates a fully typed contract instance ready for blockchain interaction.\n   *\n   * @remarks\n   * This method creates a contract instance with complete type safety for all contract\n   * methods including read operations, write operations, and event handling. The instance\n   * is pre-configured with the correct address, ABI, and wallet client for immediate use.\n   * All method parameters and return types are fully typed based on the contract ABI.\n   * @param contractName - The name of the Vana contract (use const assertion for full typing)\n   * @returns A fully typed contract instance with read/write methods and event handling\n   * @throws {ContractNotFoundError} When the contract is not deployed on the current chain\n   * @example\n   * ```typescript\n   * // Create typed contract instance\n   * const dataRegistry = vana.protocol.createContract(\"DataRegistry\" as const);\n   *\n   * // Full type safety for all operations\n   * const fileCount = await dataRegistry.read.filesCount(); // Type: bigint\n   * const txHash = await dataRegistry.write.addFile([\"ipfs://...\"]); // Typed parameters\n   *\n   * // Listen to events with full typing\n   * const logs = await dataRegistry.getEvents.FileAdded();\n   * ```\n   */\n  createContract<T extends VanaContract>(\n    contractName: T,\n  ): GetContractReturnType<ContractAbis[T]> {\n    try {\n      return getContractController(contractName, this.context.walletClient);\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.message.includes(\"Contract address not found\")) {\n          const chainId = this.context.walletClient.chain?.id ?? 0;\n          throw new ContractNotFoundError(contractName, chainId);\n        }\n        throw error;\n      }\n      throw new Error(\n        `Failed to create contract ${contractName}: Unknown error`,\n      );\n    }\n  }\n\n  /**\n   * Gets all available contract names that can be used with getContract().\n   * Returns only contracts that are actually deployed on the current chain.\n   *\n   * @returns Array of all available contract names for the current chain\n   */\n  getAvailableContracts(): VanaContract[] {\n    return this.contractFactory.getAvailableContracts();\n  }\n\n  /**\n   * Checks if a specific contract is available on the current chain.\n   *\n   * @param contractName - The contract name to check\n   * @returns Whether the contract is deployed on the current chain\n   */\n  isContractAvailable(contractName: VanaContract): boolean {\n    const availableContracts = this.getAvailableContracts();\n    return availableContracts.includes(contractName);\n  }\n\n  /**\n   * Gets the contract factory instance for advanced usage.\n   * This provides access to additional contract management methods.\n   *\n   * @returns The contract factory instance\n   */\n  getContractFactory(): ContractFactory {\n    return this.contractFactory;\n  }\n\n  /**\n   * Gets the current chain ID from the wallet client.\n   *\n   * @returns The chain ID\n   * @throws {Error} When chain ID is not available from wallet client\n   */\n  getChainId(): number {\n    const chainId = this.context.walletClient.chain?.id;\n    if (!chainId) {\n      throw new Error(\"Chain ID not available from wallet client\");\n    }\n    return chainId;\n  }\n\n  /**\n   * Gets the current chain name from the wallet client.\n   *\n   * @returns The chain name\n   * @throws {Error} When chain name is not available from wallet client\n   */\n  getChainName(): string {\n    const chainName = this.context.walletClient.chain?.name;\n    if (!chainName) {\n      throw new Error(\"Chain name not available from wallet client\");\n    }\n    return chainName;\n  }\n}\n"],"mappings":"AAEA,SAAS,6BAA6B;AACtC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAkDA,MAAM,mBAAmB;AAAA,EAG9B,YAA6B,SAA4B;AAA5B;AAC3B,SAAK,kBAAkB,IAAI,gBAAgB,QAAQ,YAAY;AAAA,EACjE;AAAA,EAJiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA4BjB,YACE,cAC+B;AAC/B,QAAI;AACF,YAAM,UAAU,KAAK,QAAQ,aAAa,OAAO;AAEjD,UAAI,CAAC,SAAS;AACZ,cAAM,IAAI,sBAAsB,cAAc,CAAC;AAAA,MACjD;AAEA,aAAO,gBAAgB,cAAc,OAAsB;AAAA,IAC7D,SAAS,OAAO;AACd,UAAI,iBAAiB,uBAAuB;AAC1C,cAAM;AAAA,MACR;AACA,UAAI,iBAAiB,OAAO;AAC1B,YAAI,MAAM,QAAQ,SAAS,4BAA4B,GAAG;AACxD,cAAI,UAAU;AACd,cAAI;AACF,sBAAU,KAAK,QAAQ,aAAa,OAAO,MAAM;AAAA,UACnD,QAAQ;AAEN,sBAAU;AAAA,UACZ;AACA,gBAAM,IAAI,sBAAsB,cAAc,OAAO;AAAA,QACvD;AACA,cAAM;AAAA,MACR;AACA,YAAM,IAAI,MAAM,0BAA0B,YAAY,iBAAiB;AAAA,IACzE;AAAA,EACF;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,EA0BA,eACE,cACwC;AACxC,QAAI;AACF,aAAO,sBAAsB,cAAc,KAAK,QAAQ,YAAY;AAAA,IACtE,SAAS,OAAO;AACd,UAAI,iBAAiB,OAAO;AAC1B,YAAI,MAAM,QAAQ,SAAS,4BAA4B,GAAG;AACxD,gBAAM,UAAU,KAAK,QAAQ,aAAa,OAAO,MAAM;AACvD,gBAAM,IAAI,sBAAsB,cAAc,OAAO;AAAA,QACvD;AACA,cAAM;AAAA,MACR;AACA,YAAM,IAAI;AAAA,QACR,6BAA6B,YAAY;AAAA,MAC3C;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,wBAAwC;AACtC,WAAO,KAAK,gBAAgB,sBAAsB;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,oBAAoB,cAAqC;AACvD,UAAM,qBAAqB,KAAK,sBAAsB;AACtD,WAAO,mBAAmB,SAAS,YAAY;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,qBAAsC;AACpC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,aAAqB;AACnB,UAAM,UAAU,KAAK,QAAQ,aAAa,OAAO;AACjD,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,MAAM,2CAA2C;AAAA,IAC7D;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,eAAuB;AACrB,UAAM,YAAY,KAAK,QAAQ,aAAa,OAAO;AACnD,QAAI,CAAC,WAAW;AACd,YAAM,IAAI,MAAM,6CAA6C;AAAA,IAC/D;AACA,WAAO;AAAA,EACT;AACF;","names":[]}
+{"version":3,"sources":["../../src/controllers/protocol.ts"],"sourcesContent":["import type { ContractInfo, VanaChainId } from \"../types/index\";\nimport type { VanaContract, ContractAbis } from \"../generated/abi\";\nimport { ContractNotFoundError } from \"../errors\";\nimport {\n  getContractController,\n  getContractInfo,\n  ContractFactory,\n} from \"../contracts/contractController\";\nimport type { ControllerContext } from \"../types/controller-context\";\nimport type { GetContractReturnType } from \"viem\";\nimport { BaseController } from \"./base\";\n\n/**\n * Provides low-level access to Vana protocol smart contracts.\n *\n * @remarks\n * Advanced API for direct contract interaction. Most developers should use\n * higher-level controllers (DataController, PermissionsController) instead.\n * This controller serves as an escape hatch when high-level APIs lack needed\n * functionality.\n *\n * **Architecture:**\n * Automatically detects current chain and provides only deployed contracts.\n * Full TypeScript type safety through contract ABIs and const assertions.\n *\n * **Method Selection:**\n * - `getContract()` - Retrieve address and ABI for manual interaction\n * - `createContract()` - Get typed contract instance with read/write methods\n * - `getAvailableContracts()` - List all contracts on current chain\n * - `isContractAvailable()` - Check contract deployment status\n * - `getChainId()`/`getChainName()` - Current network information\n *\n * **When to Use:**\n * - Custom contract interactions not covered by high-level APIs\n * - Direct contract event listening\n * - Advanced protocol operations\n *\n * **Type Safety:**\n * Always use `as const` with contract names for full type inference.\n *\n * @example\n * ```typescript\n * // Get contract info with typed ABI\n * const registry = vana.protocol.getContract(\"DataRegistry\" as const);\n * console.log(`Contract at ${registry.address}`);\n *\n * // Create typed contract instance\n * const contract = vana.protocol.createContract(\"DataRegistry\" as const);\n * const count = await contract.read.filesCount(); // Returns: bigint\n *\n * // Write operations with full typing\n * const hash = await contract.write.addFile([\"ipfs://...\"]);\n * ```\n *\n * @category Advanced\n * @see For contract specifications, visit {@link https://docs.vana.org/docs/protocol-contracts}\n */\nexport class ProtocolController extends BaseController {\n  private readonly contractFactory: ContractFactory;\n\n  constructor(context: ControllerContext) {\n    super(context);\n    this.contractFactory = new ContractFactory(\n      context.walletClient ?? context.publicClient,\n    );\n  }\n\n  /**\n   * Retrieves the address and ABI for a specific Vana protocol contract.\n   *\n   * @remarks\n   * This method provides direct access to contract addresses and ABIs for the current\n   * chain. It includes full TypeScript type inference when using const assertions,\n   * enabling type-safe contract interactions. The method only returns contracts that\n   * are actually deployed on the current network.\n   * @param contractName - The name of the Vana contract to retrieve (use const assertion for full typing)\n   * @returns An object containing the contract's address and fully typed ABI\n   * @throws {ContractNotFoundError} When the contract is not deployed on the current chain.\n   *   Verify contract name spelling and check current network with `getChainId()`.\n   * @example\n   * ```typescript\n   * // Get contract info with full type inference\n   * const dataRegistry = vana.protocol.getContract(\"DataRegistry\" as const);\n   *\n   * // Now dataRegistry.abi is fully typed for the DataRegistry contract\n   * console.log(dataRegistry.address); // \"0x123...\"\n   * console.log(dataRegistry.abi.length); // Full ABI array\n   * ```\n   */\n  getContract<T extends VanaContract>(\n    contractName: T,\n  ): ContractInfo<ContractAbis[T]> {\n    try {\n      const chainId =\n        this.context.walletClient?.chain?.id ??\n        this.context.publicClient.chain?.id;\n\n      if (!chainId) {\n        throw new ContractNotFoundError(contractName, 0);\n      }\n\n      return getContractInfo(contractName, chainId as VanaChainId);\n    } catch (error) {\n      if (error instanceof ContractNotFoundError) {\n        throw error;\n      }\n      if (error instanceof Error) {\n        if (error.message.includes(\"Contract address not found\")) {\n          let chainId = 0;\n          try {\n            chainId =\n              this.context.walletClient?.chain?.id ??\n              this.context.publicClient.chain?.id ??\n              0;\n          } catch {\n            // Use 0 as fallback if chain ID access fails\n            chainId = 0;\n          }\n          throw new ContractNotFoundError(contractName, chainId);\n        }\n        throw error;\n      }\n      throw new Error(`Failed to get contract ${contractName}: Unknown error`);\n    }\n  }\n\n  /**\n   * Creates a fully typed contract instance ready for blockchain interaction.\n   *\n   * @remarks\n   * This method creates a contract instance with complete type safety for all contract\n   * methods including read operations, write operations, and event handling. The instance\n   * is pre-configured with the correct address, ABI, and wallet client for immediate use.\n   * All method parameters and return types are fully typed based on the contract ABI.\n   * @param contractName - The name of the Vana contract (use const assertion for full typing)\n   * @returns A fully typed contract instance with read/write methods and event handling\n   * @throws {ContractNotFoundError} When the contract is not deployed on the current chain\n   * @example\n   * ```typescript\n   * // Create typed contract instance\n   * const dataRegistry = vana.protocol.createContract(\"DataRegistry\" as const);\n   *\n   * // Full type safety for all operations\n   * const fileCount = await dataRegistry.read.filesCount(); // Type: bigint\n   * const txHash = await dataRegistry.write.addFile([\"ipfs://...\"]); // Typed parameters\n   *\n   * // Listen to events with full typing\n   * const logs = await dataRegistry.getEvents.FileAdded();\n   * ```\n   */\n  createContract<T extends VanaContract>(\n    contractName: T,\n  ): GetContractReturnType<ContractAbis[T]> {\n    this.assertWallet();\n    try {\n      return getContractController(contractName, this.context.walletClient);\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.message.includes(\"Contract address not found\")) {\n          const chainId = this.context.walletClient.chain?.id ?? 0;\n          throw new ContractNotFoundError(contractName, chainId);\n        }\n        throw error;\n      }\n      throw new Error(\n        `Failed to create contract ${contractName}: Unknown error`,\n      );\n    }\n  }\n\n  /**\n   * Gets all available contract names that can be used with getContract().\n   * Returns only contracts that are actually deployed on the current chain.\n   *\n   * @returns Array of all available contract names for the current chain\n   */\n  getAvailableContracts(): VanaContract[] {\n    return this.contractFactory.getAvailableContracts();\n  }\n\n  /**\n   * Checks if a specific contract is available on the current chain.\n   *\n   * @param contractName - The contract name to check\n   * @returns Whether the contract is deployed on the current chain\n   */\n  isContractAvailable(contractName: VanaContract): boolean {\n    const availableContracts = this.getAvailableContracts();\n    return availableContracts.includes(contractName);\n  }\n\n  /**\n   * Gets the contract factory instance for advanced usage.\n   * This provides access to additional contract management methods.\n   *\n   * @returns The contract factory instance\n   */\n  getContractFactory(): ContractFactory {\n    return this.contractFactory;\n  }\n\n  /**\n   * Gets the current chain ID from the wallet client.\n   *\n   * @returns The chain ID\n   * @throws {Error} When chain ID is not available from wallet client\n   */\n  getChainId(): number {\n    const chainId =\n      this.context.walletClient?.chain?.id ??\n      this.context.publicClient.chain?.id;\n    if (!chainId) {\n      throw new Error(\"Chain ID not available from client\");\n    }\n    return chainId;\n  }\n\n  /**\n   * Gets the current chain name from the wallet client.\n   *\n   * @returns The chain name\n   * @throws {Error} When chain name is not available from wallet client\n   */\n  getChainName(): string {\n    const chainName =\n      this.context.walletClient?.chain?.name ??\n      this.context.publicClient.chain?.name;\n    if (!chainName) {\n      throw new Error(\"Chain name not available from client\");\n    }\n    return chainName;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/controllers/runtimePermissions.cjs

@@ -0,0 +1,272 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var runtimePermissions_exports = {};
+__export(runtimePermissions_exports, {
+  RuntimePermissionsController: () => RuntimePermissionsController
+});
+module.exports = __toCommonJS(runtimePermissions_exports);
+var import_viem = require("viem");
+var import_base = require("./base");
+var import_runtimeGrantFiles = require("../utils/runtimeGrantFiles");
+var import_errors = require("../errors");
+var import_addresses = require("../generated/addresses");
+var import_abi = require("../generated/abi");
+class RuntimePermissionsController extends import_base.BaseController {
+  /**
+   * Create a new runtime permission grant
+   *
+   * @remarks
+   * This method:
+   * 1. Creates a grant file with pricing and operation details
+   * 2. Uploads the grant to IPFS (via relayer if available)
+   * 3. Calls VanaRuntimePermissions.createPermission() on-chain
+   * 4. Waits for transaction confirmation
+   * 5. Returns the permission ID and grant URL
+   *
+   * @param params - Permission parameters including dataset, grantee, pricing
+   * @returns Permission ID, transaction hash, and grant URL
+   * @throws {BlockchainError} When permission creation fails
+   * @throws {NetworkError} When IPFS upload fails
+   *
+   * @example
+   * ```typescript
+   * const result = await sdk.runtimePermissions.createPermission({
+   *   datasetId: 123n,
+   *   grantee: "0x742d35Cc...",
+   *   task: "vanaorg/vana-task-demo:latest",
+   *   operation: "aggregate_keywords",
+   *   pricing: {
+   *     price_per_file_vana: 0.1,
+   *     minimum_price_vana: 0.01,
+   *     maximum_price_vana: 100
+   *   },
+   *   parameters: {
+   *     maxFiles: 1000
+   *   },
+   * });
+   * ```
+   */
+  async createPermission(params) {
+    this.assertWallet();
+    try {
+      const grantFile = (0, import_runtimeGrantFiles.createRuntimeGrantFile)(params);
+      let grantUrl = params.grantUrl;
+      if (!grantUrl) {
+        if (!this.context.relayer) {
+          throw new import_errors.NetworkError(
+            "No relayer configured and no grantUrl provided. Configure relayer or provide grantUrl parameter."
+          );
+        }
+        const request = {
+          type: "direct",
+          operation: "storeGrantFile",
+          params: grantFile
+        };
+        const response = await this.context.relayer(request);
+        if (response.type === "error") {
+          throw new import_errors.NetworkError(
+            `Failed to store grant file: ${response.error}`
+          );
+        }
+        if (response.type === "direct" && typeof response.result === "object" && response.result !== null && "url" in response.result && typeof response.result.url === "string") {
+          grantUrl = response.result.url;
+        } else {
+          throw new import_errors.NetworkError("Upload succeeded but no URL was returned");
+        }
+      }
+      const chainId = await this.context.publicClient.getChainId();
+      const contractAddress = (0, import_addresses.getContractAddress)(
+        chainId,
+        "VanaRuntimePermissions"
+      );
+      const abi = (0, import_abi.getAbi)("VanaRuntimePermissions");
+      const granteeId = BigInt(params.grantee);
+      const startBlock = await this.context.publicClient.getBlockNumber();
+      const endBlock = 2n ** 256n - 1n;
+      const account = this.context.walletClient?.account ?? this.context.userAddress;
+      const hash = await this.context.walletClient.writeContract({
+        address: contractAddress,
+        abi,
+        functionName: "createPermission",
+        args: [params.datasetId, granteeId, grantUrl, startBlock, endBlock],
+        account,
+        chain: this.context.walletClient?.chain ?? null
+      });
+      await this.context.publicClient.waitForTransactionReceipt({
+        hash
+      });
+      const permissionId = 0n;
+      return {
+        permissionId,
+        hash,
+        grantUrl
+      };
+    } catch (error) {
+      if (error instanceof import_errors.NetworkError) {
+        throw error;
+      }
+      if (error instanceof Error) {
+        throw new import_errors.BlockchainError(
+          `Failed to create runtime permission: ${error.message}`,
+          error
+        );
+      }
+      throw new import_errors.BlockchainError(
+        "Failed to create runtime permission with unknown error"
+      );
+    }
+  }
+  /**
+   * Get permission by ID
+   *
+   * @remarks
+   * Fetches permission details from the VanaRuntimePermissions contract.
+   * The returned permission contains an IPFS hash in the grant field,
+   * which can be resolved using fetchGrant().
+   *
+   * @param permissionId - Permission identifier
+   * @returns Permission details including dataset, grantee, and grant hash
+   *
+   * @example
+   * ```typescript
+   * const permission = await sdk.runtimePermissions.getPermission(1024n);
+   * console.log(`Dataset: ${permission.datasetId}`);
+   * console.log(`Grant: ${permission.grant}`); // IPFS hash
+   *
+   * // Resolve full grant details
+   * const grantFile = await sdk.runtimePermissions.fetchGrant(permission);
+   * console.log(`Price: ${grantFile.pricing.price_per_file_vana} VANA`);
+   * ```
+   */
+  async getPermission(permissionId) {
+    const chainId = await this.context.publicClient.getChainId();
+    const contractAddress = (0, import_addresses.getContractAddress)(
+      chainId,
+      "VanaRuntimePermissions"
+    );
+    const abi = (0, import_abi.getAbi)("VanaRuntimePermissions");
+    const contract = (0, import_viem.getContract)({
+      address: contractAddress,
+      abi,
+      client: this.context.publicClient
+    });
+    return await contract.read.getPermission([
+      permissionId
+    ]);
+  }
+  /**
+   * Check if permission is active (not expired)
+   *
+   * @remarks
+   * Returns true if the current block number is between startBlock and endBlock.
+   *
+   * @param permissionId - Permission identifier
+   * @returns Whether permission is currently active
+   *
+   * @example
+   * ```typescript
+   * const isActive = await sdk.runtimePermissions.isPermissionActive(1024n);
+   * if (isActive) {
+   *   console.log("Permission is valid");
+   * } else {
+   *   console.log("Permission has expired");
+   * }
+   * ```
+   */
+  async isPermissionActive(permissionId) {
+    const chainId = await this.context.publicClient.getChainId();
+    const contractAddress = (0, import_addresses.getContractAddress)(
+      chainId,
+      "VanaRuntimePermissions"
+    );
+    const abi = (0, import_abi.getAbi)("VanaRuntimePermissions");
+    const contract = (0, import_viem.getContract)({
+      address: contractAddress,
+      abi,
+      client: this.context.publicClient
+    });
+    return await contract.read.isPermissionActive([permissionId]);
+  }
+  /**
+   * Get all permissions for a dataset
+   *
+   * @remarks
+   * Returns an array of permissions that have been granted for the specified dataset.
+   * Useful for dataset owners to view all active permissions.
+   *
+   * @param datasetId - Dataset identifier
+   * @returns Array of runtime permissions
+   *
+   * @example
+   * ```typescript
+   * const permissions = await sdk.runtimePermissions.getDatasetPermissions(123n);
+   * console.log(`Found ${permissions.length} permissions`);
+   *
+   * // Access each permission directly
+   * for (const permission of permissions) {
+   *   console.log(`Permission ${permission.id}: ${permission.grant}`);
+   * }
+   * ```
+   */
+  async getDatasetPermissions(datasetId) {
+    const chainId = await this.context.publicClient.getChainId();
+    const contractAddress = (0, import_addresses.getContractAddress)(
+      chainId,
+      "VanaRuntimePermissions"
+    );
+    const abi = (0, import_abi.getAbi)("VanaRuntimePermissions");
+    const contract = (0, import_viem.getContract)({
+      address: contractAddress,
+      abi,
+      client: this.context.publicClient
+    });
+    return await contract.read.getDatasetPermissions([
+      datasetId
+    ]);
+  }
+  /**
+   * Fetch and parse grant file from IPFS
+   *
+   * @remarks
+   * Resolves the IPFS hash stored in permission.grant and returns the
+   * full grant file with pricing and operation details.
+   *
+   * @param permission - Permission with grant URL/hash
+   * @returns Parsed grant file with pricing and parameters
+   * @throws {NetworkError} When IPFS fetch fails
+   *
+   * @example
+   * ```typescript
+   * const permission = await sdk.runtimePermissions.getPermission(1024n);
+   * const grant = await sdk.runtimePermissions.fetchGrant(permission);
+   *
+   * console.log(`Task: ${grant.task}`);
+   * console.log(`Operation: ${grant.operation}`);
+   * console.log(`Price: ${grant.pricing.price_per_file_vana} VANA per file`);
+   * ```
+   */
+  async fetchGrant(permission) {
+    return await (0, import_runtimeGrantFiles.retrieveRuntimeGrantFile)(permission.grant);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RuntimePermissionsController
+});
+//# sourceMappingURL=runtimePermissions.cjs.map

package/dist/controllers/runtimePermissions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controllers/runtimePermissions.ts"],"sourcesContent":["import { getContract } from \"viem\";\nimport { BaseController } from \"./base\";\nimport type {\n  RuntimePermissionParams,\n  RuntimePermission,\n  RuntimeGrantFile,\n  RuntimePermissionResult,\n} from \"../types/runtimePermissions\";\nimport type { UnifiedRelayerRequest } from \"../types/relayer\";\nimport {\n  createRuntimeGrantFile,\n  retrieveRuntimeGrantFile,\n} from \"../utils/runtimeGrantFiles\";\nimport { BlockchainError, NetworkError } from \"../errors\";\nimport { getContractAddress } from \"../generated/addresses\";\nimport { getAbi } from \"../generated/abi\";\n\n/**\n * Controller for VanaRuntimePermissions contract\n *\n * @remarks\n * Manages permissions for data access via Vana Runtime. Allows dataset owners\n * to create monetized access permissions for data consumers to execute operations\n * on their datasets within TEE environments.\n *\n * Follows the same pattern as PermissionsController but for runtime-specific permissions.\n *\n * @category Controllers\n * @example\n * ```typescript\n * // Create a permission for a data consumer\n * const result = await sdk.runtimePermissions.createPermission({\n *   datasetId: 123n,\n *   grantee: \"0x...\",\n *   task: \"vanaorg/vana-task-demo:latest\",\n *   operation: \"aggregate_keywords\",\n *   pricing: { price_per_file_vana: 0.1 }\n * });\n *\n * console.log(`Permission created with ID: ${result.permissionId}`);\n * console.log(`Grant stored at: ${result.grantUrl}`);\n * ```\n */\nexport class RuntimePermissionsController extends BaseController {\n  /**\n   * Create a new runtime permission grant\n   *\n   * @remarks\n   * This method:\n   * 1. Creates a grant file with pricing and operation details\n   * 2. Uploads the grant to IPFS (via relayer if available)\n   * 3. Calls VanaRuntimePermissions.createPermission() on-chain\n   * 4. Waits for transaction confirmation\n   * 5. Returns the permission ID and grant URL\n   *\n   * @param params - Permission parameters including dataset, grantee, pricing\n   * @returns Permission ID, transaction hash, and grant URL\n   * @throws {BlockchainError} When permission creation fails\n   * @throws {NetworkError} When IPFS upload fails\n   *\n   * @example\n   * ```typescript\n   * const result = await sdk.runtimePermissions.createPermission({\n   *   datasetId: 123n,\n   *   grantee: \"0x742d35Cc...\",\n   *   task: \"vanaorg/vana-task-demo:latest\",\n   *   operation: \"aggregate_keywords\",\n   *   pricing: {\n   *     price_per_file_vana: 0.1,\n   *     minimum_price_vana: 0.01,\n   *     maximum_price_vana: 100\n   *   },\n   *   parameters: {\n   *     maxFiles: 1000\n   *   },\n   * });\n   * ```\n   */\n  async createPermission(\n    params: RuntimePermissionParams,\n  ): Promise<RuntimePermissionResult> {\n    this.assertWallet();\n\n    try {\n      // 1. Create grant file\n      const grantFile = createRuntimeGrantFile(params);\n\n      // 2. Upload to IPFS (via relayer if available, or use provided URL)\n      let grantUrl = params.grantUrl;\n      if (!grantUrl) {\n        if (!this.context.relayer) {\n          throw new NetworkError(\n            \"No relayer configured and no grantUrl provided. \" +\n              \"Configure relayer or provide grantUrl parameter.\",\n          );\n        }\n\n        // Store via relayer\n        const request: UnifiedRelayerRequest = {\n          type: \"direct\",\n          operation: \"storeGrantFile\",\n          params: grantFile,\n        };\n        const response = await this.context.relayer(request);\n        if (response.type === \"error\") {\n          throw new NetworkError(\n            `Failed to store grant file: ${response.error}`,\n          );\n        }\n        if (\n          response.type === \"direct\" &&\n          typeof response.result === \"object\" &&\n          response.result !== null &&\n          \"url\" in response.result &&\n          typeof response.result.url === \"string\"\n        ) {\n          grantUrl = response.result.url;\n        } else {\n          throw new NetworkError(\"Upload succeeded but no URL was returned\");\n        }\n      }\n\n      // 3. Get contract address and ABI\n      const chainId = await this.context.publicClient.getChainId();\n      const contractAddress = getContractAddress(\n        chainId,\n        \"VanaRuntimePermissions\",\n      );\n      const abi = getAbi(\"VanaRuntimePermissions\");\n\n      // 4. Convert grantee address to ID\n      // NOTE: For MVP, we use address as ID. In production, this should\n      // query a grantee registry contract or use a proper ID scheme.\n      const granteeId = BigInt(params.grantee);\n\n      // 5. Get current block for startBlock\n      const startBlock = await this.context.publicClient.getBlockNumber();\n\n      // 6. Set endBlock to max uint256 (never expires)\n      // Note: Unlike DataPortabilityPermissions which has no on-chain expiration,\n      // VanaRuntimePermissions contract requires endBlock. We always set it to\n      // max uint256 since we have no way to predict future block numbers from timestamps.\n      const endBlock = 2n ** 256n - 1n;\n\n      // 7. Call contract to create permission\n      const account =\n        this.context.walletClient?.account ?? this.context.userAddress;\n\n      const hash = await this.context.walletClient.writeContract({\n        address: contractAddress,\n        abi,\n        functionName: \"createPermission\",\n        args: [params.datasetId, granteeId, grantUrl, startBlock, endBlock],\n        account,\n        chain: this.context.walletClient?.chain ?? null,\n      });\n\n      // 8. Wait for transaction confirmation\n      await this.context.publicClient.waitForTransactionReceipt({\n        hash,\n      });\n\n      // 9. Parse PermissionCreated event to get permission ID\n      // For MVP, we'll use a placeholder. In production, parse event logs.\n      // TODO: Add proper event parsing from receipt.logs\n      const permissionId = 0n; // Placeholder\n\n      return {\n        permissionId,\n        hash,\n        grantUrl,\n      };\n    } catch (error) {\n      if (error instanceof NetworkError) {\n        throw error;\n      }\n      if (error instanceof Error) {\n        throw new BlockchainError(\n          `Failed to create runtime permission: ${error.message}`,\n          error,\n        );\n      }\n      throw new BlockchainError(\n        \"Failed to create runtime permission with unknown error\",\n      );\n    }\n  }\n\n  /**\n   * Get permission by ID\n   *\n   * @remarks\n   * Fetches permission details from the VanaRuntimePermissions contract.\n   * The returned permission contains an IPFS hash in the grant field,\n   * which can be resolved using fetchGrant().\n   *\n   * @param permissionId - Permission identifier\n   * @returns Permission details including dataset, grantee, and grant hash\n   *\n   * @example\n   * ```typescript\n   * const permission = await sdk.runtimePermissions.getPermission(1024n);\n   * console.log(`Dataset: ${permission.datasetId}`);\n   * console.log(`Grant: ${permission.grant}`); // IPFS hash\n   *\n   * // Resolve full grant details\n   * const grantFile = await sdk.runtimePermissions.fetchGrant(permission);\n   * console.log(`Price: ${grantFile.pricing.price_per_file_vana} VANA`);\n   * ```\n   */\n  async getPermission(permissionId: bigint): Promise<RuntimePermission> {\n    const chainId = await this.context.publicClient.getChainId();\n    const contractAddress = getContractAddress(\n      chainId,\n      \"VanaRuntimePermissions\",\n    );\n    const abi = getAbi(\"VanaRuntimePermissions\");\n\n    const contract = getContract({\n      address: contractAddress,\n      abi,\n      client: this.context.publicClient,\n    });\n\n    return (await contract.read.getPermission([\n      permissionId,\n    ])) as RuntimePermission;\n  }\n\n  /**\n   * Check if permission is active (not expired)\n   *\n   * @remarks\n   * Returns true if the current block number is between startBlock and endBlock.\n   *\n   * @param permissionId - Permission identifier\n   * @returns Whether permission is currently active\n   *\n   * @example\n   * ```typescript\n   * const isActive = await sdk.runtimePermissions.isPermissionActive(1024n);\n   * if (isActive) {\n   *   console.log(\"Permission is valid\");\n   * } else {\n   *   console.log(\"Permission has expired\");\n   * }\n   * ```\n   */\n  async isPermissionActive(permissionId: bigint): Promise<boolean> {\n    const chainId = await this.context.publicClient.getChainId();\n    const contractAddress = getContractAddress(\n      chainId,\n      \"VanaRuntimePermissions\",\n    );\n    const abi = getAbi(\"VanaRuntimePermissions\");\n\n    const contract = getContract({\n      address: contractAddress,\n      abi,\n      client: this.context.publicClient,\n    });\n\n    return (await contract.read.isPermissionActive([permissionId])) as boolean;\n  }\n\n  /**\n   * Get all permissions for a dataset\n   *\n   * @remarks\n   * Returns an array of permissions that have been granted for the specified dataset.\n   * Useful for dataset owners to view all active permissions.\n   *\n   * @param datasetId - Dataset identifier\n   * @returns Array of runtime permissions\n   *\n   * @example\n   * ```typescript\n   * const permissions = await sdk.runtimePermissions.getDatasetPermissions(123n);\n   * console.log(`Found ${permissions.length} permissions`);\n   *\n   * // Access each permission directly\n   * for (const permission of permissions) {\n   *   console.log(`Permission ${permission.id}: ${permission.grant}`);\n   * }\n   * ```\n   */\n  async getDatasetPermissions(datasetId: bigint): Promise<RuntimePermission[]> {\n    const chainId = await this.context.publicClient.getChainId();\n    const contractAddress = getContractAddress(\n      chainId,\n      \"VanaRuntimePermissions\",\n    );\n    const abi = getAbi(\"VanaRuntimePermissions\");\n\n    const contract = getContract({\n      address: contractAddress,\n      abi,\n      client: this.context.publicClient,\n    });\n\n    return (await contract.read.getDatasetPermissions([\n      datasetId,\n    ])) as RuntimePermission[];\n  }\n\n  /**\n   * Fetch and parse grant file from IPFS\n   *\n   * @remarks\n   * Resolves the IPFS hash stored in permission.grant and returns the\n   * full grant file with pricing and operation details.\n   *\n   * @param permission - Permission with grant URL/hash\n   * @returns Parsed grant file with pricing and parameters\n   * @throws {NetworkError} When IPFS fetch fails\n   *\n   * @example\n   * ```typescript\n   * const permission = await sdk.runtimePermissions.getPermission(1024n);\n   * const grant = await sdk.runtimePermissions.fetchGrant(permission);\n   *\n   * console.log(`Task: ${grant.task}`);\n   * console.log(`Operation: ${grant.operation}`);\n   * console.log(`Price: ${grant.pricing.price_per_file_vana} VANA per file`);\n   * ```\n   */\n  async fetchGrant(permission: RuntimePermission): Promise<RuntimeGrantFile> {\n    return await retrieveRuntimeGrantFile(permission.grant);\n  }\n}\n"],"mappings":"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","names":[]}