@opendatalabs/vana-sdk 0.1.0-alpha.2dd2718 → 0.1.0-alpha.2e569eb

package/dist/controllers/permissions.d.ts

@@ -1057,6 +1057,24 @@ export declare class PermissionsController extends BaseController {
      * @returns Promise resolving to array of file IDs
      */
     getPermissionFileIds(permissionId: bigint): Promise<bigint[]>;
+    /**
+     * Retrieves detailed grant file data from IPFS or HTTP storage.
+     *
+     * @remarks
+     * This method automatically uses the SDK's configured downloadRelayer to bypass CORS restrictions.
+     * Use this instead of importing the standalone `retrieveGrantFile` utility.
+     *
+     * @param grantUrl - The grant file URL (from OnChainPermissionGrant.grantUrl)
+     * @returns Promise resolving to the complete grant file with operation details
+     * @throws {NetworkError} When all retrieval attempts fail
+     * @example
+     * ```typescript
+     * const grants = await vana.permissions.getUserPermissionGrantsOnChain();
+     * const grantFile = await vana.permissions.retrieveGrantFile(grants[0].grantUrl);
+     * console.log(`Operation: ${grantFile.operation}`);
+     * ```
+     */
+    retrieveGrantFile(grantUrl: string): Promise<GrantFile>;
     /**
      * Get all permissions for a specific file (alias for getFilePermissionIds)
      *

package/dist/controllers/permissions.js

@@ -2700,19 +2700,53 @@ class PermissionsController extends BaseController {
     const total = Number(totalCount);
     const limit = options.limit ?? 50;
     const offset = options.offset ?? 0;
-    const endIndex = Math.min(offset + limit, total);
+    const includePermissions = options.includePermissions ?? true;
+    const startId = total - offset;
+    const endId = Math.max(startId - limit + 1, 1);
     const granteeIds = Array.from(
-      { length: endIndex - offset },
-      (_, i) => offset + i + 1
-      // Grantee IDs are 1-indexed
-    );
-    const granteePromises = granteeIds.map(
-      (granteeId) => this.getGranteeById(granteeId)
-    );
-    const granteeResults = await Promise.all(granteePromises);
-    const grantees = granteeResults.filter(
-      (grantee) => grantee !== null
+      { length: startId - endId + 1 },
+      (_, i) => startId - i
+      // Generate IDs in descending order
     );
+    let grantees;
+    if (includePermissions) {
+      const granteePromises = granteeIds.map(
+        (granteeId) => this.getGranteeById(granteeId)
+      );
+      const granteeResults = await Promise.all(granteePromises);
+      grantees = granteeResults.filter(
+        (grantee) => grantee !== null
+      );
+    } else {
+      const granteeInfoPromises = granteeIds.map(
+        async (granteeId) => {
+          try {
+            const granteeInfo = await this.context.publicClient.readContract({
+              address: DataPortabilityGranteesAddress,
+              abi: DataPortabilityGranteesAbi,
+              functionName: "granteesV2",
+              args: [BigInt(granteeId)]
+            });
+            const grantee = {
+              id: granteeId,
+              owner: granteeInfo.owner,
+              address: granteeInfo.granteeAddress,
+              publicKey: granteeInfo.publicKey,
+              permissionIds: []
+              // TypeScript infers number[] from Grantee type
+            };
+            return grantee;
+          } catch (error) {
+            console.warn(`Failed to fetch grantee ${granteeId}:`, error);
+            return null;
+          }
+        }
+      );
+      const granteeInfoResults = await Promise.all(granteeInfoPromises);
+      grantees = granteeInfoResults.filter(
+        (grantee) => grantee !== null
+      );
+    }
     return {
       grantees,
       total,
@@ -3218,6 +3252,31 @@ class PermissionsController extends BaseController {
       );
     }
   }
+  /**
+   * Retrieves detailed grant file data from IPFS or HTTP storage.
+   *
+   * @remarks
+   * This method automatically uses the SDK's configured downloadRelayer to bypass CORS restrictions.
+   * Use this instead of importing the standalone `retrieveGrantFile` utility.
+   *
+   * @param grantUrl - The grant file URL (from OnChainPermissionGrant.grantUrl)
+   * @returns Promise resolving to the complete grant file with operation details
+   * @throws {NetworkError} When all retrieval attempts fail
+   * @example
+   * ```typescript
+   * const grants = await vana.permissions.getUserPermissionGrantsOnChain();
+   * const grantFile = await vana.permissions.retrieveGrantFile(grants[0].grantUrl);
+   * console.log(`Operation: ${grantFile.operation}`);
+   * ```
+   */
+  async retrieveGrantFile(grantUrl) {
+    const { retrieveGrantFile: retrieveGrantFileUtil } = await import("../utils/grantFiles");
+    return retrieveGrantFileUtil(
+      grantUrl,
+      void 0,
+      this.context.downloadRelayer
+    );
+  }
   /**
    * Get all permissions for a specific file (alias for getFilePermissionIds)
    *