@opendatalabs/vana-sdk 0.1.0-alpha.2fd4542 → 0.1.0-alpha.321a1fe

package/dist/index.node.cjs

@@ -2811,6 +2811,19 @@ var init_DataRegistryImplementation = __esm({
         name: "Upgraded",
         type: "event"
       },
+      {
+        inputs: [],
+        name: "DATA_PORTABILITY_ROLE",
+        outputs: [
+          {
+            internalType: "bytes32",
+            name: "",
+            type: "bytes32"
+          }
+        ],
+        stateMutability: "view",
+        type: "function"
+      },
       {
         inputs: [],
         name: "DEFAULT_ADMIN_ROLE",
@@ -2905,6 +2918,41 @@ var init_DataRegistryImplementation = __esm({
         stateMutability: "nonpayable",
         type: "function"
       },
+      {
+        inputs: [
+          {
+            internalType: "uint256",
+            name: "fileId",
+            type: "uint256"
+          },
+          {
+            components: [
+              {
+                internalType: "address",
+                name: "account",
+                type: "address"
+              },
+              {
+                internalType: "string",
+                name: "key",
+                type: "string"
+              }
+            ],
+            internalType: "struct IDataRegistry.Permission[]",
+            name: "permissions",
+            type: "tuple[]"
+          },
+          {
+            internalType: "uint256",
+            name: "schemaId",
+            type: "uint256"
+          }
+        ],
+        name: "addFilePermissionsAndSchema",
+        outputs: [],
+        stateMutability: "nonpayable",
+        type: "function"
+      },
       {
         inputs: [
           {
@@ -35990,70 +36038,451 @@ var init_ipfs = __esm({
   }
 });
 
-// src/utils/blockchain/registry.ts
-async function fetchSchemaFromChain(context, schemaId) {
-  const chainId = context.walletClient.chain?.id;
-  if (!chainId) {
-    throw new Error("Chain ID not available");
-  }
-  const dataRefinerRegistryAddress = getContractAddress(
-    chainId,
-    "DataRefinerRegistry"
-  );
-  const dataRefinerRegistryAbi = getAbi("DataRefinerRegistry");
-  const dataRefinerRegistry = (0, import_viem4.getContract)({
-    address: dataRefinerRegistryAddress,
-    abi: dataRefinerRegistryAbi,
-    client: context.publicClient
-  });
-  const schemaData = await dataRefinerRegistry.read.schemas([BigInt(schemaId)]);
-  if (!schemaData) {
-    throw new Error(`Schema with ID ${schemaId} not found`);
-  }
-  const schemaObj = schemaData;
-  if (!schemaObj.name || !schemaObj.dialect || !schemaObj.definitionUrl) {
-    throw new Error("Incomplete schema data");
-  }
-  return {
-    id: schemaId,
-    name: schemaObj.name,
-    dialect: schemaObj.dialect,
-    definitionUrl: schemaObj.definitionUrl
-  };
-}
-async function fetchSchemaCountFromChain(context) {
-  const chainId = context.walletClient.chain?.id;
-  if (!chainId) {
-    throw new Error("Chain ID not available");
-  }
-  const dataRefinerRegistryAddress = getContractAddress(
-    chainId,
-    "DataRefinerRegistry"
-  );
-  const dataRefinerRegistryAbi = getAbi("DataRefinerRegistry");
-  const dataRefinerRegistry = (0, import_viem4.getContract)({
-    address: dataRefinerRegistryAddress,
-    abi: dataRefinerRegistryAbi,
-    client: context.publicClient
-  });
-  const count = await dataRefinerRegistry.read.schemasCount();
-  return Number(count);
-}
-var import_viem4;
-var init_registry = __esm({
-  "src/utils/blockchain/registry.ts"() {
-    "use strict";
-    import_viem4 = require("viem");
-    init_addresses();
-    init_abi();
-  }
-});
-
 // src/generated/subgraph.ts
-var GetSchemaDocument, ListSchemasDocument, CountSchemasDocument;
+var GetUserPermissionsDocument, GetUserTrustedServersDocument, GetUserFilesDocument, GetFileProofsDocument, GetDlpDocument, GetSchemaDocument, ListSchemasDocument, CountSchemasDocument;
 var init_subgraph = __esm({
   "src/generated/subgraph.ts"() {
     "use strict";
+    GetUserPermissionsDocument = {
+      kind: "Document",
+      definitions: [
+        {
+          kind: "OperationDefinition",
+          operation: "query",
+          name: { kind: "Name", value: "GetUserPermissions" },
+          variableDefinitions: [
+            {
+              kind: "VariableDefinition",
+              variable: {
+                kind: "Variable",
+                name: { kind: "Name", value: "userId" }
+              },
+              type: {
+                kind: "NonNullType",
+                type: { kind: "NamedType", name: { kind: "Name", value: "ID" } }
+              }
+            }
+          ],
+          selectionSet: {
+            kind: "SelectionSet",
+            selections: [
+              {
+                kind: "Field",
+                name: { kind: "Name", value: "user" },
+                arguments: [
+                  {
+                    kind: "Argument",
+                    name: { kind: "Name", value: "id" },
+                    value: {
+                      kind: "Variable",
+                      name: { kind: "Name", value: "userId" }
+                    }
+                  }
+                ],
+                selectionSet: {
+                  kind: "SelectionSet",
+                  selections: [
+                    { kind: "Field", name: { kind: "Name", value: "id" } },
+                    {
+                      kind: "Field",
+                      name: { kind: "Name", value: "permissions" },
+                      selectionSet: {
+                        kind: "SelectionSet",
+                        selections: [
+                          { kind: "Field", name: { kind: "Name", value: "id" } },
+                          { kind: "Field", name: { kind: "Name", value: "grant" } },
+                          { kind: "Field", name: { kind: "Name", value: "nonce" } },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "signature" }
+                          },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "startBlock" }
+                          },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "endBlock" }
+                          },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "addedAtBlock" }
+                          },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "addedAtTimestamp" }
+                          },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "transactionHash" }
+                          },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "grantee" },
+                            selectionSet: {
+                              kind: "SelectionSet",
+                              selections: [
+                                {
+                                  kind: "Field",
+                                  name: { kind: "Name", value: "id" }
+                                },
+                                {
+                                  kind: "Field",
+                                  name: { kind: "Name", value: "address" }
+                                }
+                              ]
+                            }
+                          },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "filePermissions" },
+                            selectionSet: {
+                              kind: "SelectionSet",
+                              selections: [
+                                {
+                                  kind: "Field",
+                                  name: { kind: "Name", value: "file" },
+                                  selectionSet: {
+                                    kind: "SelectionSet",
+                                    selections: [
+                                      {
+                                        kind: "Field",
+                                        name: { kind: "Name", value: "id" }
+                                      },
+                                      {
+                                        kind: "Field",
+                                        name: { kind: "Name", value: "url" }
+                                      }
+                                    ]
+                                  }
+                                }
+                              ]
+                            }
+                          }
+                        ]
+                      }
+                    }
+                  ]
+                }
+              }
+            ]
+          }
+        }
+      ]
+    };
+    GetUserTrustedServersDocument = {
+      kind: "Document",
+      definitions: [
+        {
+          kind: "OperationDefinition",
+          operation: "query",
+          name: { kind: "Name", value: "GetUserTrustedServers" },
+          variableDefinitions: [
+            {
+              kind: "VariableDefinition",
+              variable: {
+                kind: "Variable",
+                name: { kind: "Name", value: "userId" }
+              },
+              type: {
+                kind: "NonNullType",
+                type: { kind: "NamedType", name: { kind: "Name", value: "ID" } }
+              }
+            }
+          ],
+          selectionSet: {
+            kind: "SelectionSet",
+            selections: [
+              {
+                kind: "Field",
+                name: { kind: "Name", value: "user" },
+                arguments: [
+                  {
+                    kind: "Argument",
+                    name: { kind: "Name", value: "id" },
+                    value: {
+                      kind: "Variable",
+                      name: { kind: "Name", value: "userId" }
+                    }
+                  }
+                ],
+                selectionSet: {
+                  kind: "SelectionSet",
+                  selections: [
+                    { kind: "Field", name: { kind: "Name", value: "id" } },
+                    {
+                      kind: "Field",
+                      name: { kind: "Name", value: "serverTrusts" },
+                      selectionSet: {
+                        kind: "SelectionSet",
+                        selections: [
+                          { kind: "Field", name: { kind: "Name", value: "id" } },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "server" },
+                            selectionSet: {
+                              kind: "SelectionSet",
+                              selections: [
+                                {
+                                  kind: "Field",
+                                  name: { kind: "Name", value: "id" }
+                                },
+                                {
+                                  kind: "Field",
+                                  name: { kind: "Name", value: "serverAddress" }
+                                },
+                                {
+                                  kind: "Field",
+                                  name: { kind: "Name", value: "url" }
+                                },
+                                {
+                                  kind: "Field",
+                                  name: { kind: "Name", value: "publicKey" }
+                                }
+                              ]
+                            }
+                          },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "trustedAt" }
+                          },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "trustedAtBlock" }
+                          },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "untrustedAtBlock" }
+                          },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "transactionHash" }
+                          }
+                        ]
+                      }
+                    }
+                  ]
+                }
+              }
+            ]
+          }
+        }
+      ]
+    };
+    GetUserFilesDocument = {
+      kind: "Document",
+      definitions: [
+        {
+          kind: "OperationDefinition",
+          operation: "query",
+          name: { kind: "Name", value: "GetUserFiles" },
+          variableDefinitions: [
+            {
+              kind: "VariableDefinition",
+              variable: {
+                kind: "Variable",
+                name: { kind: "Name", value: "userId" }
+              },
+              type: {
+                kind: "NonNullType",
+                type: { kind: "NamedType", name: { kind: "Name", value: "ID" } }
+              }
+            }
+          ],
+          selectionSet: {
+            kind: "SelectionSet",
+            selections: [
+              {
+                kind: "Field",
+                name: { kind: "Name", value: "user" },
+                arguments: [
+                  {
+                    kind: "Argument",
+                    name: { kind: "Name", value: "id" },
+                    value: {
+                      kind: "Variable",
+                      name: { kind: "Name", value: "userId" }
+                    }
+                  }
+                ],
+                selectionSet: {
+                  kind: "SelectionSet",
+                  selections: [
+                    { kind: "Field", name: { kind: "Name", value: "id" } },
+                    {
+                      kind: "Field",
+                      name: { kind: "Name", value: "files" },
+                      selectionSet: {
+                        kind: "SelectionSet",
+                        selections: [
+                          { kind: "Field", name: { kind: "Name", value: "id" } },
+                          { kind: "Field", name: { kind: "Name", value: "url" } },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "schemaId" }
+                          },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "addedAtBlock" }
+                          },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "addedAtTimestamp" }
+                          },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "transactionHash" }
+                          },
+                          {
+                            kind: "Field",
+                            name: { kind: "Name", value: "owner" },
+                            selectionSet: {
+                              kind: "SelectionSet",
+                              selections: [
+                                {
+                                  kind: "Field",
+                                  name: { kind: "Name", value: "id" }
+                                }
+                              ]
+                            }
+                          }
+                        ]
+                      }
+                    }
+                  ]
+                }
+              }
+            ]
+          }
+        }
+      ]
+    };
+    GetFileProofsDocument = {
+      kind: "Document",
+      definitions: [
+        {
+          kind: "OperationDefinition",
+          operation: "query",
+          name: { kind: "Name", value: "GetFileProofs" },
+          variableDefinitions: [
+            {
+              kind: "VariableDefinition",
+              variable: {
+                kind: "Variable",
+                name: { kind: "Name", value: "fileIds" }
+              },
+              type: {
+                kind: "NonNullType",
+                type: {
+                  kind: "ListType",
+                  type: {
+                    kind: "NonNullType",
+                    type: {
+                      kind: "NamedType",
+                      name: { kind: "Name", value: "BigInt" }
+                    }
+                  }
+                }
+              }
+            }
+          ],
+          selectionSet: {
+            kind: "SelectionSet",
+            selections: [
+              {
+                kind: "Field",
+                name: { kind: "Name", value: "dataRegistryProofs" },
+                arguments: [
+                  {
+                    kind: "Argument",
+                    name: { kind: "Name", value: "where" },
+                    value: {
+                      kind: "ObjectValue",
+                      fields: [
+                        {
+                          kind: "ObjectField",
+                          name: { kind: "Name", value: "fileId_in" },
+                          value: {
+                            kind: "Variable",
+                            name: { kind: "Name", value: "fileIds" }
+                          }
+                        }
+                      ]
+                    }
+                  }
+                ],
+                selectionSet: {
+                  kind: "SelectionSet",
+                  selections: [
+                    { kind: "Field", name: { kind: "Name", value: "fileId" } },
+                    {
+                      kind: "Field",
+                      name: { kind: "Name", value: "dlp" },
+                      selectionSet: {
+                        kind: "SelectionSet",
+                        selections: [
+                          { kind: "Field", name: { kind: "Name", value: "id" } }
+                        ]
+                      }
+                    }
+                  ]
+                }
+              }
+            ]
+          }
+        }
+      ]
+    };
+    GetDlpDocument = {
+      kind: "Document",
+      definitions: [
+        {
+          kind: "OperationDefinition",
+          operation: "query",
+          name: { kind: "Name", value: "GetDLP" },
+          variableDefinitions: [
+            {
+              kind: "VariableDefinition",
+              variable: { kind: "Variable", name: { kind: "Name", value: "id" } },
+              type: {
+                kind: "NonNullType",
+                type: { kind: "NamedType", name: { kind: "Name", value: "ID" } }
+              }
+            }
+          ],
+          selectionSet: {
+            kind: "SelectionSet",
+            selections: [
+              {
+                kind: "Field",
+                name: { kind: "Name", value: "dlp" },
+                arguments: [
+                  {
+                    kind: "Argument",
+                    name: { kind: "Name", value: "id" },
+                    value: {
+                      kind: "Variable",
+                      name: { kind: "Name", value: "id" }
+                    }
+                  }
+                ],
+                selectionSet: {
+                  kind: "SelectionSet",
+                  selections: [
+                    { kind: "Field", name: { kind: "Name", value: "id" } },
+                    { kind: "Field", name: { kind: "Name", value: "name" } },
+                    { kind: "Field", name: { kind: "Name", value: "metadata" } },
+                    { kind: "Field", name: { kind: "Name", value: "status" } },
+                    { kind: "Field", name: { kind: "Name", value: "address" } },
+                    { kind: "Field", name: { kind: "Name", value: "owner" } }
+                  ]
+                }
+              }
+            ]
+          }
+        }
+      ]
+    };
     GetSchemaDocument = {
       kind: "Document",
       definitions: [
@@ -36250,6 +36679,65 @@ var init_subgraph = __esm({
   }
 });
 
+// src/utils/blockchain/registry.ts
+async function fetchSchemaFromChain(context, schemaId) {
+  const chainId = context.walletClient.chain?.id;
+  if (!chainId) {
+    throw new Error("Chain ID not available");
+  }
+  const dataRefinerRegistryAddress = getContractAddress(
+    chainId,
+    "DataRefinerRegistry"
+  );
+  const dataRefinerRegistryAbi = getAbi("DataRefinerRegistry");
+  const dataRefinerRegistry = (0, import_viem7.getContract)({
+    address: dataRefinerRegistryAddress,
+    abi: dataRefinerRegistryAbi,
+    client: context.publicClient
+  });
+  const schemaData = await dataRefinerRegistry.read.schemas([BigInt(schemaId)]);
+  if (!schemaData) {
+    throw new Error(`Schema with ID ${schemaId} not found`);
+  }
+  const schemaObj = schemaData;
+  if (!schemaObj.name || !schemaObj.dialect || !schemaObj.definitionUrl) {
+    throw new Error("Incomplete schema data");
+  }
+  return {
+    id: schemaId,
+    name: schemaObj.name,
+    dialect: schemaObj.dialect,
+    definitionUrl: schemaObj.definitionUrl
+  };
+}
+async function fetchSchemaCountFromChain(context) {
+  const chainId = context.walletClient.chain?.id;
+  if (!chainId) {
+    throw new Error("Chain ID not available");
+  }
+  const dataRefinerRegistryAddress = getContractAddress(
+    chainId,
+    "DataRefinerRegistry"
+  );
+  const dataRefinerRegistryAbi = getAbi("DataRefinerRegistry");
+  const dataRefinerRegistry = (0, import_viem7.getContract)({
+    address: dataRefinerRegistryAddress,
+    abi: dataRefinerRegistryAbi,
+    client: context.publicClient
+  });
+  const count = await dataRefinerRegistry.read.schemasCount();
+  return Number(count);
+}
+var import_viem7;
+var init_registry = __esm({
+  "src/utils/blockchain/registry.ts"() {
+    "use strict";
+    import_viem7 = require("viem");
+    init_addresses();
+    init_abi();
+  }
+});
+
 // src/utils/urlResolver.ts
 async function fetchFromUrl(url) {
   try {
@@ -37549,6 +38037,7 @@ function parseReplicateOutput(response, typeGuard) {
 init_errors();
 
 // src/controllers/permissions.ts
+var import_viem6 = require("viem");
 init_multicall();
 init_transactionHandle();
 init_errors();
@@ -37724,6 +38213,7 @@ function validateGrantFile(data) {
 }
 
 // src/utils/grantValidation.ts
+var import_viem4 = require("viem");
 var import_ajv2 = __toESM(require("ajv"), 1);
 var import_ajv_formats2 = __toESM(require("ajv-formats"), 1);
 
@@ -37927,7 +38417,9 @@ function extractFieldFromBusinessError(error) {
   return void 0;
 }
 function validateGranteeAccess(grantFile, requestingAddress) {
-  if (grantFile.grantee.toLowerCase() !== requestingAddress.toLowerCase()) {
+  const normalizedGrantee = (0, import_viem4.getAddress)(grantFile.grantee);
+  const normalizedRequesting = (0, import_viem4.getAddress)(requestingAddress);
+  if (normalizedGrantee !== normalizedRequesting) {
     throw new GranteeMismatchError(
       "Permission denied: requesting address does not match grantee",
       grantFile.grantee,
@@ -37958,6 +38450,7 @@ function validateOperationAccess(grantFile, requestedOperation) {
 }
 
 // src/utils/signatureCache.ts
+var import_viem5 = require("viem");
 init_crypto_utils();
 var SignatureCache = class {
   static PREFIX = "vana_sig_";
@@ -38051,7 +38544,7 @@ var SignatureCache = class {
     }
   }
   static getCacheKey(walletAddress, messageHash) {
-    return `${this.PREFIX}${walletAddress.toLowerCase()}:${messageHash}`;
+    return `${this.PREFIX}${(0, import_viem5.getAddress)(walletAddress)}:${messageHash}`;
   }
   /**
    * Generate a deterministic hash of a message object for cache key generation
@@ -39324,20 +39817,22 @@ var PermissionsController = class {
       if (!userData || !userData.permissions?.length) {
         return [];
       }
-      const onChainGrants = userData.permissions.slice(0, limit).map((permission) => ({
-        id: BigInt(permission.id),
-        grantUrl: permission.grant,
-        grantSignature: permission.signature,
-        grantHash: "",
-        // Not available in new schema, compute if needed
-        nonce: BigInt(permission.nonce),
-        addedAtBlock: BigInt(permission.addedAtBlock),
-        addedAtTimestamp: BigInt(permission.addedAtTimestamp || "0"),
-        transactionHash: permission.transactionHash || "",
-        grantor: userAddress,
-        active: !permission.endBlock || BigInt(permission.endBlock) === 0n
-        // Active if no end block or end block is 0
-      }));
+      const onChainGrants = userData.permissions.slice(0, limit).map(
+        (permission) => ({
+          id: BigInt(permission.id),
+          grantUrl: permission.grant,
+          grantSignature: permission.signature,
+          nonce: BigInt(permission.nonce),
+          startBlock: BigInt(permission.startBlock),
+          addedAtBlock: BigInt(permission.addedAtBlock),
+          addedAtTimestamp: BigInt(permission.addedAtTimestamp || "0"),
+          transactionHash: permission.transactionHash || "",
+          grantor: userAddress,
+          grantee: permission.grantee,
+          active: !permission.endBlock || BigInt(permission.endBlock) === 0n
+          // Active if no end block or end block is 0
+        })
+      );
       return onChainGrants.sort((a, b) => {
         if (a.id < b.id) return 1;
         if (a.id > b.id) return -1;
@@ -39415,14 +39910,16 @@ var PermissionsController = class {
       );
       const DataPortabilityServersAbi = getAbi("DataPortabilityServers");
       const userAddress = this.context.walletClient.account?.address || await this.getUserAddress();
+      const normalizedUserAddress = (0, import_viem6.getAddress)(userAddress);
+      const normalizedServerAddress = (0, import_viem6.getAddress)(params.serverAddress);
       const txHash = await this.context.walletClient.writeContract({
         address: DataPortabilityServersAddress,
         abi: DataPortabilityServersAbi,
         functionName: "addAndTrustServerByManager",
         args: [
-          userAddress,
+          normalizedUserAddress,
           {
-            serverAddress: params.serverAddress,
+            serverAddress: normalizedServerAddress,
             serverUrl: params.serverUrl,
             publicKey: params.publicKey
           }
@@ -39492,9 +39989,10 @@ var PermissionsController = class {
   async submitAddAndTrustServerWithSignature(params) {
     try {
       const nonce = await this.getServersUserNonce();
+      const serverAddress = (0, import_viem6.getAddress)(params.serverAddress);
       const addAndTrustServerInput = {
         nonce,
-        serverAddress: params.serverAddress,
+        serverAddress,
         publicKey: params.publicKey,
         serverUrl: params.serverUrl
       };
@@ -40299,11 +40797,13 @@ var PermissionsController = class {
       "DataPortabilityGrantees"
     );
     const DataPortabilityGranteesAbi = getAbi("DataPortabilityGrantees");
+    const ownerAddress = (0, import_viem6.getAddress)(params.owner);
+    const granteeAddress = (0, import_viem6.getAddress)(params.granteeAddress);
     const txHash = await this.context.walletClient.writeContract({
       address: DataPortabilityGranteesAddress,
       abi: DataPortabilityGranteesAbi,
       functionName: "registerGrantee",
-      args: [params.owner, params.granteeAddress, params.publicKey],
+      args: [ownerAddress, granteeAddress, params.publicKey],
       account: this.context.walletClient.account || await this.getUserAddress(),
       chain: this.context.walletClient.chain || null
     });
@@ -40330,10 +40830,12 @@ var PermissionsController = class {
    */
   async submitRegisterGranteeWithSignature(params) {
     const nonce = await this.getServersUserNonce();
+    const owner = (0, import_viem6.getAddress)(params.owner);
+    const granteeAddress = (0, import_viem6.getAddress)(params.granteeAddress);
     const registerGranteeInput = {
       nonce,
-      owner: params.owner,
-      granteeAddress: params.granteeAddress,
+      owner,
+      granteeAddress,
       publicKey: params.publicKey
     };
     const typedData = await this.buildRegisterGranteeTypedData(registerGranteeInput);
@@ -41841,10 +42343,12 @@ var PermissionsController = class {
 };
 
 // src/controllers/data.ts
-var import_viem5 = require("viem");
+var import_viem8 = require("viem");
 init_transactionHandle();
 init_addresses();
 init_abi();
+init_subgraph();
+var import_graphql2 = require("graphql");
 
 // src/utils/encryption.ts
 var DEFAULT_ENCRYPTION_SEED = "Please sign to retrieve your encryption key";
@@ -42268,34 +42772,16 @@ var DataController = class {
       );
     }
     try {
-      const query = `
-        query GetUserFiles($userId: ID!) {
-          user(id: $userId) {
-            id
-            files {
-              id
-              url
-              schemaId
-              addedAtBlock
-              addedAtTimestamp
-              transactionHash
-              owner {
-                id
-              }
-            }
-          }
-        }
-      `;
       const response = await fetch(endpoint, {
         method: "POST",
         headers: {
           "Content-Type": "application/json"
         },
         body: JSON.stringify({
-          query,
+          query: (0, import_graphql2.print)(GetUserFilesDocument),
           variables: {
             userId: owner.toLowerCase()
-            // Subgraph stores addresses in lowercase
+            // Subgraph requires lowercase addresses
           }
         })
       });
@@ -42375,23 +42861,13 @@ var DataController = class {
    * @returns Map of file IDs to their associated DLP IDs
    */
   async _fetchProofsFromSubgraph(fileIds, subgraphUrl) {
-    const query = `
-      query GetFileProofs($fileIds: [BigInt!]!) {
-        dataRegistryProofs(where: { fileId_in: $fileIds }) {
-          fileId
-          dlp {
-            id
-          }
-        }
-      }
-    `;
     const response = await fetch(subgraphUrl, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
       },
       body: JSON.stringify({
-        query,
+        query: (0, import_graphql2.print)(GetFileProofsDocument),
         variables: {
           fileIds: fileIds.map((id) => id.toString())
         }
@@ -42495,25 +42971,13 @@ var DataController = class {
     const subgraphUrl = options.subgraphUrl || this.context.subgraphUrl;
     if (subgraphUrl) {
       try {
-        const query = `
-          query GetDLP($id: ID!) {
-            dlp(id: $id) {
-              id
-              name
-              metadata
-              status
-              address
-              owner
-            }
-          }
-        `;
         const response = await fetch(subgraphUrl, {
           method: "POST",
           headers: {
             "Content-Type": "application/json"
           },
           body: JSON.stringify({
-            query,
+            query: (0, import_graphql2.print)(GetDlpDocument),
             variables: {
               id: dlpId.toString()
             }
@@ -42536,7 +43000,7 @@ var DataController = class {
         return {
           id: parseInt(result.data.dlp.id),
           name: result.data.dlp.name || "",
-          metadata: result.data.dlp.metadata,
+          metadata: result.data.dlp.metadata || void 0,
           status: result.data.dlp.status ? parseInt(result.data.dlp.status) : void 0,
           address: result.data.dlp.address,
           owner: result.data.dlp.owner
@@ -42750,32 +43214,13 @@ var DataController = class {
   async _getUserPermissionsViaSubgraph(params) {
     const { user, subgraphUrl } = params;
     try {
-      const query = `
-        query GetUserPermissions($userId: ID!) {
-          user(id: $userId) {
-            id
-            permissions {
-              id
-              grant
-              nonce
-              signature
-              addedAtBlock
-              addedAtTimestamp
-              transactionHash
-              user {
-                id
-              }
-            }
-          }
-        }
-      `;
       const response = await fetch(subgraphUrl, {
         method: "POST",
         headers: {
           "Content-Type": "application/json"
         },
         body: JSON.stringify({
-          query,
+          query: (0, import_graphql2.print)(GetUserPermissionsDocument),
           variables: {
             userId: user.toLowerCase()
           }
@@ -42804,7 +43249,7 @@ var DataController = class {
         addedAtBlock: BigInt(permission.addedAtBlock),
         addedAtTimestamp: BigInt(permission.addedAtTimestamp),
         transactionHash: permission.transactionHash,
-        user: permission.user.id
+        user
       })).sort((a, b) => Number(b.addedAtTimestamp - a.addedAtTimestamp));
     } catch (error) {
       console.error("Failed to query user permissions from subgraph:", error);
@@ -42976,36 +43421,16 @@ var DataController = class {
       );
     }
     try {
-      const query = `
-        query GetUserTrustedServers($userId: ID!) {
-          user(id: $userId) {
-            id
-            serverTrusts {
-              id
-              server {
-                id
-                serverAddress
-                url
-                publicKey
-              }
-              trustedAt
-              trustedAtBlock
-              untrustedAtBlock
-              transactionHash
-            }
-          }
-        }
-      `;
       const response = await fetch(graphqlEndpoint, {
         method: "POST",
         headers: {
           "Content-Type": "application/json"
         },
         body: JSON.stringify({
-          query,
+          query: (0, import_graphql2.print)(GetUserTrustedServersDocument),
           variables: {
             userId: user.toLowerCase()
-            // Subgraph stores addresses in lowercase
+            // Subgraph requires lowercase addresses
           }
         })
       });
@@ -43155,7 +43580,7 @@ var DataController = class {
       }
       const dataRegistryAddress = getContractAddress(chainId, "DataRegistry");
       const dataRegistryAbi = getAbi("DataRegistry");
-      const dataRegistry = (0, import_viem5.getContract)({
+      const dataRegistry = (0, import_viem8.getContract)({
         address: dataRegistryAddress,
         abi: dataRegistryAbi,
         client: this.context.walletClient
@@ -43206,7 +43631,7 @@ var DataController = class {
       }
       const dataRegistryAddress = getContractAddress(chainId, "DataRegistry");
       const dataRegistryAbi = getAbi("DataRegistry");
-      const dataRegistry = (0, import_viem5.getContract)({
+      const dataRegistry = (0, import_viem8.getContract)({
         address: dataRegistryAddress,
         abi: dataRegistryAbi,
         client: this.context.walletClient
@@ -43513,7 +43938,7 @@ var DataController = class {
         "DataRefinerRegistry"
       );
       const dataRefinerRegistryAbi = getAbi("DataRefinerRegistry");
-      const dataRefinerRegistry = (0, import_viem5.getContract)({
+      const dataRefinerRegistry = (0, import_viem8.getContract)({
         address: dataRefinerRegistryAddress,
         abi: dataRefinerRegistryAbi,
         client: this.context.walletClient
@@ -43569,7 +43994,7 @@ var DataController = class {
         "DataRefinerRegistry"
       );
       const dataRefinerRegistryAbi = getAbi("DataRefinerRegistry");
-      const dataRefinerRegistry = (0, import_viem5.getContract)({
+      const dataRefinerRegistry = (0, import_viem8.getContract)({
         address: dataRefinerRegistryAddress,
         abi: dataRefinerRegistryAbi,
         client: this.context.walletClient
@@ -43608,7 +44033,7 @@ var DataController = class {
         "DataRefinerRegistry"
       );
       const dataRefinerRegistryAbi = getAbi("DataRefinerRegistry");
-      const dataRefinerRegistry = (0, import_viem5.getContract)({
+      const dataRefinerRegistry = (0, import_viem8.getContract)({
         address: dataRefinerRegistryAddress,
         abi: dataRefinerRegistryAbi,
         client: this.context.walletClient
@@ -43839,19 +44264,31 @@ var DataController = class {
     return await this.submitFilePermission(fileId, account, publicKey);
   }
   /**
-   * Submits a file permission transaction and returns the transaction hash immediately.
+   * Submits a file permission transaction to the blockchain.
    *
-   * This is the lower-level method that provides maximum control over transaction timing.
+   * @remarks
+   * This method supports gasless transactions via relayer callbacks when configured.
+   * It encrypts the user's encryption key with the recipient's public key before submission.
    * Use this when you want to handle transaction confirmation and event parsing separately.
    *
-   * @param fileId - The ID of the file to add permissions for
-   * @param account - The address of the account to grant permission to
-   * @param publicKey - The public key to encrypt the user's encryption key with
-   * @returns Promise resolving to the transaction hash
+   * @param fileId - The ID of the file to grant permission for
+   * @param account - The recipient's wallet address that will access the file
+   * @param publicKey - The recipient's public key for encryption.
+   *   Obtain via `vana.server.getIdentity(account).public_key`
+   * @returns Promise resolving to TransactionHandle for tracking the transaction
+   * @throws {Error} When chain ID is not available
+   * @throws {Error} When encryption key generation fails
+   * @throws {Error} When public key encryption fails
+   *
    * @example
    * ```typescript
-   * const txHash = await vana.data.submitFilePermission(fileId, account, publicKey);
-   * console.log(`Transaction submitted: ${txHash}`);
+   * const tx = await vana.data.submitFilePermission(
+   *   fileId,
+   *   "0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36",
+   *   recipientPublicKey
+   * );
+   * const result = await tx.waitForEvents();
+   * console.log(`Permission granted with ID: ${result.permissionId}`);
    * ```
    */
   async submitFilePermission(fileId, account, publicKey) {
@@ -43907,7 +44344,7 @@ var DataController = class {
       }
       const dataRegistryAddress = getContractAddress(chainId, "DataRegistry");
       const dataRegistryAbi = getAbi("DataRegistry");
-      const dataRegistry = (0, import_viem5.getContract)({
+      const dataRegistry = (0, import_viem8.getContract)({
         address: dataRegistryAddress,
         abi: dataRegistryAbi,
         client: this.context.walletClient
@@ -44219,6 +44656,73 @@ init_schemas();
 
 // src/controllers/server.ts
 init_errors();
+
+// src/utils/operationHandle.ts
+init_errors();
+var OperationHandle = class {
+  constructor(controller, id) {
+    this.controller = controller;
+    this.id = id;
+  }
+  _resultPromise;
+  /**
+   * Waits for the operation to complete and returns the result.
+   *
+   * @remarks
+   * Results are memoized - multiple calls return the same promise.
+   * The method polls the server at regular intervals until the operation
+   * succeeds, fails, or times out. Returns the raw string result from the
+   * server - callers are responsible for parsing if needed.
+   *
+   * @param options - Optional polling configuration
+   * @returns The operation result as a string when completed
+   * @throws {PersonalServerError} When the operation fails or times out
+   * @example
+   * ```typescript
+   * const result = await handle.waitForResult({
+   *   timeout: 60000,
+   *   pollingInterval: 500
+   * });
+   * // If expecting JSON, parse it:
+   * const data = JSON.parse(result);
+   * ```
+   */
+  async waitForResult(options) {
+    if (!this._resultPromise) {
+      this._resultPromise = this.pollForCompletion(options);
+    }
+    return this._resultPromise;
+  }
+  async pollForCompletion(options) {
+    const startTime = Date.now();
+    const timeout = options?.timeout ?? 3e4;
+    const interval = options?.pollingInterval ?? 500;
+    while (true) {
+      const result = await this.controller.getOperation(
+        this.id
+      );
+      if (result.status === "succeeded") {
+        if (result.result) {
+          return result.result;
+        }
+        throw new PersonalServerError(
+          "Operation succeeded but returned no result"
+        );
+      }
+      if (result.status === "failed") {
+        throw new PersonalServerError(
+          `Operation ${result.status}: ${result.result || "Unknown error"}`
+        );
+      }
+      if (Date.now() - startTime > timeout) {
+        throw new PersonalServerError(`Operation timed out after ${timeout}ms`);
+      }
+      await new Promise((resolve) => setTimeout(resolve, interval));
+    }
+  }
+};
+
+// src/controllers/server.ts
 var ServerController = class {
   constructor(context) {
     this.context = context;
@@ -44300,26 +44804,29 @@ var ServerController = class {
     }
   }
   /**
-   * Creates an operation via the personal server API.
+   * Creates a server operation and returns a handle for lifecycle management.
    *
    * @remarks
-   * This method submits a computation request to the personal server API.
-   * The response includes the operation ID.
-   * @param params - The request parameters object
+   * This method submits a computation request to the personal server and returns
+   * an OperationHandle that provides Promise-based methods for waiting on results.
+   * The handle pattern matches TransactionHandle for consistency across async operations.
+   *
+   * @param params - The operation request parameters
    * @param params.permissionId - The permission ID authorizing this operation.
-   *   Obtain from granted permissions via `vana.permissions.getUserPermissionGrantsOnChain()`.
-   * @returns A Promise that resolves to an operation response with status and control URLs
-   * @throws {PersonalServerError} When server request fails or parameters are invalid.
-   *   Verify permissionId exists and is active for the target server.
-   * @throws {NetworkError} When personal server API communication fails.
-   *   Check server URL configuration and network connectivity.
+   *   Obtain via `vana.permissions.getUserPermissionGrantsOnChain()`.
+   * @returns An OperationHandle providing access to the operation ID and result methods
+   * @throws {PersonalServerError} When the server request fails or parameters are invalid
+   * @throws {NetworkError} When personal server API communication fails
    * @example
    * ```typescript
-   * const response = await vana.server.createOperation({
-   *   permissionId: 123,
+   * const operation = await vana.server.createOperation({
+   *   permissionId: 123
    * });
-   *
-   * console.log(`Operation created: ${response.id}`);
+   * console.log(`Operation ID: ${operation.id}`);
+   * 
+   * // Wait for completion
+   * const result = await operation.waitForResult();
+   * console.log("Result:", result);
    * ```
    */
   async createOperation(params) {
@@ -44335,7 +44842,7 @@ var ServerController = class {
       };
       console.debug("\u{1F50D} Debug - createOperation requestBody", requestBody);
       const response = await this.makeRequest(requestBody);
-      return response;
+      return new OperationHandle(this, response.id);
     } catch (error) {
       if (error instanceof Error) {
         if (error instanceof NetworkError || error instanceof SerializationError || error instanceof SignatureError || error instanceof PersonalServerError) {
@@ -44352,30 +44859,20 @@ var ServerController = class {
     }
   }
   /**
-   * Polls the status of a computation request for updates and results.
+   * Retrieves the current status and result of a server operation.
    *
    * @remarks
-   * This method checks the current status of a computation request by querying
-   * the personal server API using the provided operation ID. It returns the current
-   * status, any available output, and error information. The method can be
-   * called periodically until the operation completes or fails.
-   *
-   * Common status values include: `starting`, `processing`, `succeeded`, `failed`, `canceled`.
-   * @param operationId - The operation ID returned from the initial request submission
-   * @returns A Promise that resolves to the current operation response with status and results
-   * @throws {NetworkError} When the polling request fails or returns invalid data
+   * Common status values: `starting`, `running`, `succeeded`, `failed`, `canceled`.
+   * When status is `succeeded`, the result field contains the operation output.
+   *
+   * @param operationId - The ID of the operation to query
+   * @returns The operation response containing status, result, and metadata
+   * @throws {NetworkError} When the API request fails or returns invalid data
    * @example
    * ```typescript
-   * // Poll until completion
-   * let result = await vana.server.getOperation(response.id);
-   *
-   * while (result.status === "processing") {
-   *   await new Promise(resolve => setTimeout(resolve, 1000));
-   *   result = await vana.server.getOperation(response.id);
-   * }
-   *
-   * if (result.status === "succeeded") {
-   *   console.log("Computation completed:", result.output);
+   * const status = await vana.server.getOperation(operationId);
+   * if (status.status === 'succeeded') {
+   *   console.log('Result:', JSON.parse(status.result));
    * }
    * ```
    */
@@ -44566,16 +45063,16 @@ var ServerController = class {
 init_errors();
 
 // src/contracts/contractController.ts
-var import_viem8 = require("viem");
+var import_viem11 = require("viem");
 init_abi();
 init_addresses();
 
 // src/core/client.ts
-var import_viem7 = require("viem");
+var import_viem10 = require("viem");
 
 // src/config/chains.ts
-var import_viem6 = require("viem");
-var mokshaTestnet = (0, import_viem6.defineChain)({
+var import_viem9 = require("viem");
+var mokshaTestnet = (0, import_viem9.defineChain)({
   id: 14800,
   caipNetworkId: "eip155:14800",
   chainNamespace: "eip155",
@@ -44603,7 +45100,7 @@ var mokshaTestnet = (0, import_viem6.defineChain)({
   contracts: {},
   abis: {}
 });
-var vanaMainnet = (0, import_viem6.defineChain)({
+var vanaMainnet = (0, import_viem9.defineChain)({
   id: 1480,
   caipNetworkId: "eip155:1480",
   chainNamespace: "eip155",
@@ -44650,9 +45147,9 @@ var createClient = (chainId = mokshaTestnet.id) => {
     if (!chain) {
       throw new Error(`Chain ${chainId} not found`);
     }
-    _client = (0, import_viem7.createPublicClient)({
+    _client = (0, import_viem10.createPublicClient)({
       chain,
-      transport: (0, import_viem7.http)()
+      transport: (0, import_viem10.http)()
     });
   }
   return _client;
@@ -44669,7 +45166,7 @@ function getContractController(contract, client = createClient()) {
   const cacheKey = createCacheKey(contract, chainId);
   let controller = contractCache.get(cacheKey);
   if (!controller) {
-    controller = (0, import_viem8.getContract)({
+    controller = (0, import_viem11.getContract)({
       address: getContractAddress(chainId, contract),
       abi: getAbi(contract),
       client
@@ -46265,7 +46762,7 @@ var StorageManager = class {
 };
 
 // src/core.ts
-var import_viem9 = require("viem");
+var import_viem12 = require("viem");
 
 // src/chains/definitions.ts
 var vanaMainnet2 = {
@@ -46443,9 +46940,9 @@ var VanaCore = class {
           `Unsupported chain ID: ${config.chainId}`
         );
       }
-      walletClient = (0, import_viem9.createWalletClient)({
+      walletClient = (0, import_viem12.createWalletClient)({
         chain,
-        transport: (0, import_viem9.http)(config.rpcUrl || chain.rpcUrls.default.http[0]),
+        transport: (0, import_viem12.http)(config.rpcUrl || chain.rpcUrls.default.http[0]),
         account: config.account
       });
     } else {
@@ -46453,9 +46950,9 @@ var VanaCore = class {
         "Invalid configuration: must be either WalletConfig or ChainConfig"
       );
     }
-    const publicClient = (0, import_viem9.createPublicClient)({
+    const publicClient = (0, import_viem12.createPublicClient)({
       chain: walletClient.chain,
-      transport: (0, import_viem9.http)()
+      transport: (0, import_viem12.http)()
     });
     const chainConfig = getChainConfig(walletClient.chain.id);
     const subgraphUrl = config.subgraphUrl || chainConfig?.subgraphUrl;
@@ -46819,15 +47316,15 @@ init_errors();
 init_schemas();
 
 // src/utils/formatters.ts
-var import_viem10 = require("viem");
+var import_viem13 = require("viem");
 function formatNumber(value) {
   return Number(value);
 }
 function formatEth(wei, decimals = 4) {
-  return (0, import_viem10.formatEther)(BigInt(wei.toString())).slice(0, decimals + 2);
+  return (0, import_viem13.formatEther)(BigInt(wei.toString())).slice(0, decimals + 2);
 }
 function formatToken(amount, decimals = 18, displayDecimals = 4) {
-  const value = (0, import_viem10.formatUnits)(BigInt(amount.toString()), decimals);
+  const value = (0, import_viem13.formatUnits)(BigInt(amount.toString()), decimals);
   const parts = value.split(".");
   if (parts.length === 1) {
     return parts[0];
@@ -47262,7 +47759,7 @@ var CircuitBreaker = class {
 };
 
 // src/server/handler.ts
-var import_viem11 = require("viem");
+var import_viem14 = require("viem");
 init_errors();
 async function handleRelayerRequest(sdk, payload) {
   const { typedData, signature, expectedUserAddress } = payload;
@@ -47273,7 +47770,7 @@ async function handleRelayerRequest(sdk, payload) {
     message: typedData.message,
     signature
   });
-  const signerAddress = await (0, import_viem11.recoverTypedDataAddress)({
+  const signerAddress = await (0, import_viem14.recoverTypedDataAddress)({
     domain: typedData.domain,
     types: typedData.types,
     primaryType: typedData.primaryType,
@@ -47286,21 +47783,22 @@ async function handleRelayerRequest(sdk, payload) {
     );
   }
   if (expectedUserAddress) {
-    const normalizedSigner = signerAddress.toLowerCase();
-    const normalizedExpected = expectedUserAddress.toLowerCase();
+    const normalizedSigner = (0, import_viem14.getAddress)(signerAddress);
+    const normalizedExpected = (0, import_viem14.getAddress)(expectedUserAddress);
     if (normalizedSigner !== normalizedExpected) {
       throw new SignatureError(
         `Security verification failed: Recovered signer address (${normalizedSigner}) does not match expected user address (${normalizedExpected}). This may be due to incorrect EIP-712 domain configuration.`
       );
     }
   }
-  switch (typedData.primaryType) {
+  const primaryType = typedData.primaryType;
+  switch (primaryType) {
     case "Permission":
       return sdk.permissions.submitSignedGrant(
         typedData,
         signature
       );
-    case "PermissionRevoke":
+    case "RevokePermission":
       return sdk.permissions.submitSignedRevoke(
         typedData,
         signature