@opendatalabs/vana-sdk 0.1.0-alpha.e2e45dd → 0.1.0-alpha.e2f8234

package/dist/controllers/runtimePermissions.cjs

@@ -0,0 +1,285 @@
+"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");
+var import_transactionHelpers = require("../utils/transactionHelpers");
+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
+      });
+      const txResult = (0, import_transactionHelpers.tx)({
+        hash,
+        from: typeof account === "string" ? account : account.address,
+        contract: "VanaRuntimePermissions",
+        fn: "createPermission"
+      });
+      if (!this.context.waitForTransactionEvents) {
+        throw new import_errors.BlockchainError("waitForTransactionEvents not configured");
+      }
+      const result = await this.context.waitForTransactionEvents(txResult);
+      const event = result.expectedEvents.PermissionCreated;
+      if (!event) {
+        throw new import_errors.BlockchainError(
+          "No PermissionCreated event found in transaction"
+        );
+      }
+      return {
+        permissionId: event.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\";\nimport { tx } from \"../utils/transactionHelpers\";\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. Create transaction result for event parsing\n      const txResult = tx({\n        hash,\n        from: typeof account === \"string\" ? account : account.address,\n        contract: \"VanaRuntimePermissions\",\n        fn: \"createPermission\",\n      });\n\n      // 9. Wait for transaction and parse events\n      if (!this.context.waitForTransactionEvents) {\n        throw new BlockchainError(\"waitForTransactionEvents not configured\");\n      }\n\n      const result = await this.context.waitForTransactionEvents(txResult);\n\n      // 10. Extract permission ID from PermissionCreated event\n      const event = result.expectedEvents.PermissionCreated;\n      if (!event) {\n        throw new BlockchainError(\n          \"No PermissionCreated event found in transaction\",\n        );\n      }\n\n      return {\n        permissionId: event.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":[]}

package/dist/controllers/runtimePermissions.d.ts

@@ -0,0 +1,152 @@
+import { BaseController } from "./base";
+import type { RuntimePermissionParams, RuntimePermission, RuntimeGrantFile, RuntimePermissionResult } from "../types/runtimePermissions";
+/**
+ * Controller for VanaRuntimePermissions contract
+ *
+ * @remarks
+ * Manages permissions for data access via Vana Runtime. Allows dataset owners
+ * to create monetized access permissions for data consumers to execute operations
+ * on their datasets within TEE environments.
+ *
+ * Follows the same pattern as PermissionsController but for runtime-specific permissions.
+ *
+ * @category Controllers
+ * @example
+ * ```typescript
+ * // Create a permission for a data consumer
+ * const result = await sdk.runtimePermissions.createPermission({
+ *   datasetId: 123n,
+ *   grantee: "0x...",
+ *   task: "vanaorg/vana-task-demo:latest",
+ *   operation: "aggregate_keywords",
+ *   pricing: { price_per_file_vana: 0.1 }
+ * });
+ *
+ * console.log(`Permission created with ID: ${result.permissionId}`);
+ * console.log(`Grant stored at: ${result.grantUrl}`);
+ * ```
+ */
+export declare class RuntimePermissionsController extends 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
+     *   },
+     * });
+     * ```
+     */
+    createPermission(params: RuntimePermissionParams): Promise<RuntimePermissionResult>;
+    /**
+     * 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`);
+     * ```
+     */
+    getPermission(permissionId: bigint): Promise<RuntimePermission>;
+    /**
+     * 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");
+     * }
+     * ```
+     */
+    isPermissionActive(permissionId: bigint): Promise<boolean>;
+    /**
+     * 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}`);
+     * }
+     * ```
+     */
+    getDatasetPermissions(datasetId: bigint): Promise<RuntimePermission[]>;
+    /**
+     * 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`);
+     * ```
+     */
+    fetchGrant(permission: RuntimePermission): Promise<RuntimeGrantFile>;
+}