@opendatalabs/vana-sdk 0.1.0-alpha.db07fe1 → 0.1.0-alpha.dc68f39

package/dist/platform.cjs

@@ -0,0 +1,50 @@
+"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 platform_exports = {};
+__export(platform_exports, {
+  BrowserPlatformAdapter: () => import_browser.BrowserPlatformAdapter,
+  NodePlatformAdapter: () => import_node.NodePlatformAdapter,
+  createBrowserPlatformAdapter: () => import_browser_safe.createBrowserPlatformAdapter,
+  createNodePlatformAdapter: () => import_browser_safe.createNodePlatformAdapter,
+  createPlatformAdapter: () => import_utils.createPlatformAdapter,
+  createPlatformAdapterFor: () => import_utils.createPlatformAdapterFor,
+  createPlatformAdapterSafe: () => import_browser_safe.createPlatformAdapterSafe,
+  detectPlatform: () => import_utils.detectPlatform,
+  getPlatformCapabilities: () => import_utils.getPlatformCapabilities,
+  isPlatformSupported: () => import_utils.isPlatformSupported
+});
+module.exports = __toCommonJS(platform_exports);
+var import_browser = require("./platform/browser");
+var import_node = require("./platform/node");
+var import_utils = require("./platform/utils");
+var import_browser_safe = require("./platform/browser-safe");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BrowserPlatformAdapter,
+  NodePlatformAdapter,
+  createBrowserPlatformAdapter,
+  createNodePlatformAdapter,
+  createPlatformAdapter,
+  createPlatformAdapterFor,
+  createPlatformAdapterSafe,
+  detectPlatform,
+  getPlatformCapabilities,
+  isPlatformSupported
+});
+//# sourceMappingURL=platform.cjs.map

package/dist/platform.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/platform.ts"],"sourcesContent":["/**\n * Platform adapters entry point\n *\n * This module provides platform-specific utilities for different environments.\n * Use this when you need platform detection or adapter creation.\n */\n\n// Export platform adapters - these will be environment-specific\nexport { BrowserPlatformAdapter } from \"./platform/browser\";\nexport { NodePlatformAdapter } from \"./platform/node\";\n\n// Export platform interface\nexport type { VanaPlatformAdapter } from \"./platform/interface\";\n\n// Export platform utilities\nexport {\n  detectPlatform,\n  createPlatformAdapter,\n  createPlatformAdapterFor,\n  isPlatformSupported,\n  getPlatformCapabilities,\n} from \"./platform/utils\";\n\n// Export browser-safe utilities\nexport {\n  createNodePlatformAdapter,\n  createBrowserPlatformAdapter,\n  createPlatformAdapterSafe,\n} from \"./platform/browser-safe\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,qBAAuC;AACvC,kBAAoC;AAMpC,mBAMO;AAGP,0BAIO;","names":[]}

package/dist/platform.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Platform adapters entry point
+ *
+ * This module provides platform-specific utilities for different environments.
+ * Use this when you need platform detection or adapter creation.
+ */
+export { BrowserPlatformAdapter } from "./platform/browser";
+export { NodePlatformAdapter } from "./platform/node";
+export type { VanaPlatformAdapter } from "./platform/interface";
+export { detectPlatform, createPlatformAdapter, createPlatformAdapterFor, isPlatformSupported, getPlatformCapabilities, } from "./platform/utils";
+export { createNodePlatformAdapter, createBrowserPlatformAdapter, createPlatformAdapterSafe, } from "./platform/browser-safe";

package/dist/platform.js

@@ -0,0 +1,27 @@
+import { BrowserPlatformAdapter } from "./platform/browser";
+import { NodePlatformAdapter } from "./platform/node";
+import {
+  detectPlatform,
+  createPlatformAdapter,
+  createPlatformAdapterFor,
+  isPlatformSupported,
+  getPlatformCapabilities
+} from "./platform/utils";
+import {
+  createNodePlatformAdapter,
+  createBrowserPlatformAdapter,
+  createPlatformAdapterSafe
+} from "./platform/browser-safe";
+export {
+  BrowserPlatformAdapter,
+  NodePlatformAdapter,
+  createBrowserPlatformAdapter,
+  createNodePlatformAdapter,
+  createPlatformAdapter,
+  createPlatformAdapterFor,
+  createPlatformAdapterSafe,
+  detectPlatform,
+  getPlatformCapabilities,
+  isPlatformSupported
+};
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/platform.ts"],"sourcesContent":["/**\n * Platform adapters entry point\n *\n * This module provides platform-specific utilities for different environments.\n * Use this when you need platform detection or adapter creation.\n */\n\n// Export platform adapters - these will be environment-specific\nexport { BrowserPlatformAdapter } from \"./platform/browser\";\nexport { NodePlatformAdapter } from \"./platform/node\";\n\n// Export platform interface\nexport type { VanaPlatformAdapter } from \"./platform/interface\";\n\n// Export platform utilities\nexport {\n  detectPlatform,\n  createPlatformAdapter,\n  createPlatformAdapterFor,\n  isPlatformSupported,\n  getPlatformCapabilities,\n} from \"./platform/utils\";\n\n// Export browser-safe utilities\nexport {\n  createNodePlatformAdapter,\n  createBrowserPlatformAdapter,\n  createPlatformAdapterSafe,\n} from \"./platform/browser-safe\";\n"],"mappings":"AAQA,SAAS,8BAA8B;AACvC,SAAS,2BAA2B;AAMpC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/platform.node.cjs

@@ -0,0 +1,50 @@
+"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 platform_node_exports = {};
+__export(platform_node_exports, {
+  BrowserPlatformAdapter: () => import_browser.BrowserPlatformAdapter,
+  NodePlatformAdapter: () => import_node.NodePlatformAdapter,
+  createBrowserPlatformAdapter: () => import_browser_safe.createBrowserPlatformAdapter,
+  createNodePlatformAdapter: () => import_browser_safe.createNodePlatformAdapter,
+  createPlatformAdapter: () => import_utils.createPlatformAdapter,
+  createPlatformAdapterFor: () => import_utils.createPlatformAdapterFor,
+  createPlatformAdapterSafe: () => import_browser_safe.createPlatformAdapterSafe,
+  detectPlatform: () => import_utils.detectPlatform,
+  getPlatformCapabilities: () => import_utils.getPlatformCapabilities,
+  isPlatformSupported: () => import_utils.isPlatformSupported
+});
+module.exports = __toCommonJS(platform_node_exports);
+var import_browser = require("./platform/browser");
+var import_node = require("./platform/node");
+var import_utils = require("./platform/utils");
+var import_browser_safe = require("./platform/browser-safe");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BrowserPlatformAdapter,
+  NodePlatformAdapter,
+  createBrowserPlatformAdapter,
+  createNodePlatformAdapter,
+  createPlatformAdapter,
+  createPlatformAdapterFor,
+  createPlatformAdapterSafe,
+  detectPlatform,
+  getPlatformCapabilities,
+  isPlatformSupported
+});
+//# sourceMappingURL=platform.node.cjs.map

package/dist/platform.node.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/platform.node.ts"],"sourcesContent":["/**\n * Node.js-specific platform adapters entry point\n *\n * This module provides full platform utilities including Node.js support.\n */\n\n// Export both platform adapters\nexport { BrowserPlatformAdapter } from \"./platform/browser\";\nexport { NodePlatformAdapter } from \"./platform/node\";\n\n// Export platform interface\nexport type { VanaPlatformAdapter } from \"./platform/interface\";\n\n// Export all platform utilities\nexport {\n  detectPlatform,\n  createPlatformAdapter,\n  createPlatformAdapterFor,\n  isPlatformSupported,\n  getPlatformCapabilities,\n} from \"./platform/utils\";\n\n// Export browser-safe utilities with Node.js support\nexport {\n  createNodePlatformAdapter,\n  createBrowserPlatformAdapter,\n  createPlatformAdapterSafe,\n} from \"./platform/browser-safe\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,qBAAuC;AACvC,kBAAoC;AAMpC,mBAMO;AAGP,0BAIO;","names":[]}

package/dist/platform.node.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Node.js-specific platform adapters entry point
+ *
+ * This module provides full platform utilities including Node.js support.
+ */
+export { BrowserPlatformAdapter } from "./platform/browser";
+export { NodePlatformAdapter } from "./platform/node";
+export type { VanaPlatformAdapter } from "./platform/interface";
+export { detectPlatform, createPlatformAdapter, createPlatformAdapterFor, isPlatformSupported, getPlatformCapabilities, } from "./platform/utils";
+export { createNodePlatformAdapter, createBrowserPlatformAdapter, createPlatformAdapterSafe, } from "./platform/browser-safe";

package/dist/platform.node.js

@@ -0,0 +1,27 @@
+import { BrowserPlatformAdapter } from "./platform/browser";
+import { NodePlatformAdapter } from "./platform/node";
+import {
+  detectPlatform,
+  createPlatformAdapter,
+  createPlatformAdapterFor,
+  isPlatformSupported,
+  getPlatformCapabilities
+} from "./platform/utils";
+import {
+  createNodePlatformAdapter,
+  createBrowserPlatformAdapter,
+  createPlatformAdapterSafe
+} from "./platform/browser-safe";
+export {
+  BrowserPlatformAdapter,
+  NodePlatformAdapter,
+  createBrowserPlatformAdapter,
+  createNodePlatformAdapter,
+  createPlatformAdapter,
+  createPlatformAdapterFor,
+  createPlatformAdapterSafe,
+  detectPlatform,
+  getPlatformCapabilities,
+  isPlatformSupported
+};
+//# sourceMappingURL=platform.node.js.map

package/dist/platform.node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/platform.node.ts"],"sourcesContent":["/**\n * Node.js-specific platform adapters entry point\n *\n * This module provides full platform utilities including Node.js support.\n */\n\n// Export both platform adapters\nexport { BrowserPlatformAdapter } from \"./platform/browser\";\nexport { NodePlatformAdapter } from \"./platform/node\";\n\n// Export platform interface\nexport type { VanaPlatformAdapter } from \"./platform/interface\";\n\n// Export all platform utilities\nexport {\n  detectPlatform,\n  createPlatformAdapter,\n  createPlatformAdapterFor,\n  isPlatformSupported,\n  getPlatformCapabilities,\n} from \"./platform/utils\";\n\n// Export browser-safe utilities with Node.js support\nexport {\n  createNodePlatformAdapter,\n  createBrowserPlatformAdapter,\n  createPlatformAdapterSafe,\n} from \"./platform/browser-safe\";\n"],"mappings":"AAOA,SAAS,8BAA8B;AACvC,SAAS,2BAA2B;AAMpC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/schemas/dataSchema.schema.json

@@ -0,0 +1,53 @@
+{
+  "$id": "https://vana.org/data-schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Schema",
+  "description": "Meta‑schema that validates a schema object containing a dataset schema and related metadata.",
+  "type": "object",
+  "required": ["name", "version", "dialect", "schema"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Human‑readable name of the contract."
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic version of the contract's business logic (e.g. 1.1.0)."
+    },
+    "description": {
+      "type": "string",
+      "description": "Long‑form description of the dataset or API."
+    },
+    "dialect": {
+      "type": "string",
+      "description": "Primary language/format of the data schema.",
+      "enum": ["sqlite", "json"]
+    },
+    "dialectVersion": {
+      "type": "string",
+      "description": "Optional: The version of the dialect's engine or specification the schema targets (e.g., '3' for SQLite v3). Omit for self-describing dialects like json."
+    },
+    "schema": {
+      "description": "The actual schema definition. For 'sqlite', supply a DDL string; for 'json', embed a JSON Schema object."
+    }
+  },
+  "additionalProperties": false,
+  "allOf": [
+    {
+      "if": {
+        "properties": { "dialect": { "const": "sqlite" } }
+      },
+      "then": {
+        "properties": { "schema": { "type": "string" } }
+      }
+    },
+    {
+      "if": {
+        "properties": { "dialect": { "const": "json" } }
+      },
+      "then": {
+        "properties": { "schema": { "type": "object" } }
+      }
+    }
+  ]
+}

package/dist/schemas/grantFile.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Vana Data Permission Grant",
+  "description": "User-signed permission that authorizes a specific application to perform operations via a personal server",
+  "type": "object",
+  "required": ["grantee", "operation", "parameters"],
+  "properties": {
+    "grantee": {
+      "type": "string",
+      "pattern": "^0x[0-9a-fA-F]{40}$",
+      "description": "EVM address of the application authorized to use this grant"
+    },
+    "operation": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Operation the grantee is authorized to perform"
+    },
+    "parameters": {
+      "type": "object",
+      "description": "Operation-specific parameters",
+      "additionalProperties": true
+    },
+    "expires": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Optional Unix timestamp when grant expires (seconds since epoch per POSIX.1-2008)"
+    }
+  },
+  "additionalProperties": false,
+  "examples": [
+    {
+      "grantee": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
+      "operation": "llm_inference",
+      "parameters": {
+        "prompt": "Analyze this data: {{data}}",
+        "model": "gpt-4",
+        "maxTokens": 2000,
+        "temperature": 0.7
+      },
+      "expires": 1736467579
+    }
+  ]
+}

package/dist/server/handler.cjs

@@ -0,0 +1,101 @@
+"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 handler_exports = {};
+__export(handler_exports, {
+  handleRelayerRequest: () => handleRelayerRequest
+});
+module.exports = __toCommonJS(handler_exports);
+var import_viem = require("viem");
+var import_errors = require("../errors");
+async function handleRelayerRequest(sdk, payload) {
+  const { typedData, signature, expectedUserAddress } = payload;
+  console.debug({
+    domain: typedData.domain,
+    types: typedData.types,
+    primaryType: typedData.primaryType,
+    message: typedData.message,
+    signature
+  });
+  const signerAddress = await (0, import_viem.recoverTypedDataAddress)({
+    domain: typedData.domain,
+    types: typedData.types,
+    primaryType: typedData.primaryType,
+    message: typedData.message,
+    signature
+  });
+  if (!signerAddress) {
+    throw new import_errors.SignatureError(
+      "Invalid signature - could not recover signer address"
+    );
+  }
+  if (expectedUserAddress) {
+    const normalizedSigner = (0, import_viem.getAddress)(signerAddress);
+    const normalizedExpected = (0, import_viem.getAddress)(expectedUserAddress);
+    if (normalizedSigner !== normalizedExpected) {
+      throw new import_errors.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.`
+      );
+    }
+  }
+  const primaryType = typedData.primaryType;
+  switch (primaryType) {
+    case "Permission":
+      return sdk.permissions.submitSignedGrant(
+        typedData,
+        signature
+      );
+    case "RevokePermission":
+      return sdk.permissions.submitSignedRevoke(
+        typedData,
+        signature
+      );
+    case "TrustServer":
+      return sdk.permissions.submitSignedTrustServer(
+        typedData,
+        signature
+      );
+    case "AddServer":
+      return sdk.permissions.submitSignedAddAndTrustServer(
+        typedData,
+        signature
+      );
+    case "UntrustServer":
+      return sdk.permissions.submitSignedUntrustServer(
+        typedData,
+        signature
+      );
+    case "RegisterGrantee":
+      return sdk.permissions.submitSignedRegisterGrantee(
+        typedData,
+        signature
+      );
+    case "ServerFilesAndPermission":
+      return sdk.permissions.submitSignedAddServerFilesAndPermissions(
+        typedData,
+        signature
+      );
+    default:
+      throw new Error(`Unsupported operation type: ${typedData.primaryType}`);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  handleRelayerRequest
+});
+//# sourceMappingURL=handler.cjs.map

package/dist/server/handler.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/handler.ts"],"sourcesContent":["import type { Address, Hash } from \"viem\";\nimport { recoverTypedDataAddress, getAddress } from \"viem\";\nimport type { VanaInstance } from \"../index.node\";\nimport type {\n  GenericTypedData,\n  PermissionGrantTypedData,\n  RevokePermissionTypedData,\n  RegisterGranteeTypedData,\n  TrustServerTypedData,\n  AddAndTrustServerTypedData,\n  ServerFilesAndPermissionTypedData,\n  TypedDataPrimaryType,\n} from \"../types\";\nimport { SignatureError } from \"../errors\";\nimport type { TransactionResult } from \"../types/operations\";\nimport type {\n  PermissionGrantResult,\n  PermissionRevokeResult,\n  ServerTrustResult,\n  ServerUntrustResult,\n  GranteeRegisterResult,\n  FileAddedResult,\n} from \"../types/transactionResults\";\n\n/** Union type of all possible transaction results from relayer operations */\ntype RelayerTransactionResult =\n  | PermissionGrantResult\n  | PermissionRevokeResult\n  | ServerTrustResult\n  | ServerUntrustResult\n  | GranteeRegisterResult\n  | FileAddedResult;\n\n/**\n * Payload structure for relayer requests.\n * Contains the EIP-712 typed data, signature, and optional expected user address for security verification.\n *\n * @category Server\n */\nexport interface RelayerRequestPayload {\n  /** EIP-712 typed data containing the transaction details */\n  typedData: GenericTypedData;\n  /** User's signature of the typed data */\n  signature: Hash;\n  /** Optional expected user address for security verification */\n  expectedUserAddress?: Address;\n}\n\n/**\n * Unified server-side handler for processing relayed transactions.\n *\n * This function encapsulates the complete relayer workflow:\n * 1. Verifies the signature against the typed data\n * 2. Optionally checks the signer matches the expected user address\n * 3. Routes to the appropriate SDK method based on primaryType\n * 4. Returns the transaction handle with hash and event parsing capability\n *\n * Supported transaction types:\n * - Permission: Permission grants\n * - PermissionRevoke: Permission revocations\n * - TrustServer: Trust server operations\n * - UntrustServer: Untrust server operations\n * - AddServer: Add and trust server operations\n * - RegisterGrantee: Register grantee operations\n * - ServerFilesAndPermission: Batch operation for server, files, and permissions\n *\n * @param sdk - Initialized Vana SDK instance\n * @param payload - Request payload containing typed data, signature, and optional security check\n * @returns Promise resolving to TransactionResult with hash and optional event data\n * @throws {SignatureError} When signature verification fails or signer mismatch occurs\n * @throws {Error} When primaryType is unsupported or SDK operations fail\n * @category Server\n * @example\n * ```typescript\n * import { handleRelayerRequest } from '@opendatalabs/vana-sdk';\n *\n * // In your relayer API endpoint:\n * export async function POST(request: NextRequest) {\n *   try {\n *     const body = await request.json();\n *     const vana = await createRelayerVana();\n *\n *     const tx = await handleRelayerRequest(vana, {\n *       typedData: body.typedData,\n *       signature: body.signature,\n *       expectedUserAddress: body.expectedUserAddress\n *     });\n *\n *     // Option 1: Return just the hash immediately\n *     return NextResponse.json({\n *       success: true,\n *       transactionHash: tx.hash\n *     });\n *\n *     // Option 2: Wait for transaction confirmation and return event data\n *     const eventData = await tx.waitForEvents();\n *     return NextResponse.json({\n *       success: true,\n *       transactionHash: tx.hash,\n *       ...eventData // Include parsed event data like permissionId, fileId, etc.\n *     });\n *   } catch (error) {\n *     return NextResponse.json({\n *       success: false,\n *       error: error.message\n *     }, { status: 500 });\n *   }\n * }\n * ```\n */\nexport async function handleRelayerRequest(\n  sdk: VanaInstance,\n  payload: RelayerRequestPayload,\n): Promise<TransactionResult & { eventData?: RelayerTransactionResult }> {\n  const { typedData, signature, expectedUserAddress } = payload;\n\n  console.debug({\n    domain: typedData.domain,\n    types: typedData.types,\n    primaryType: typedData.primaryType,\n    message: typedData.message as unknown as Record<string, unknown>,\n    signature,\n  });\n\n  // Step 1: Verify signature and recover signer address\n  const signerAddress = await recoverTypedDataAddress({\n    domain: typedData.domain,\n    types: typedData.types,\n    primaryType: typedData.primaryType,\n    message: typedData.message as unknown as Record<string, unknown>,\n    signature,\n  });\n\n  if (!signerAddress) {\n    throw new SignatureError(\n      \"Invalid signature - could not recover signer address\",\n    );\n  }\n\n  // Step 2: Security check - verify signer matches expected user address if provided\n  if (expectedUserAddress) {\n    const normalizedSigner = getAddress(signerAddress);\n    const normalizedExpected = getAddress(expectedUserAddress);\n\n    if (normalizedSigner !== normalizedExpected) {\n      throw new SignatureError(\n        `Security verification failed: Recovered signer address (${normalizedSigner}) does not match expected user address (${normalizedExpected}). This may be due to incorrect EIP-712 domain configuration.`,\n      );\n    }\n  }\n\n  // Step 3: Route to appropriate SDK method based on primaryType\n  // Route to appropriate SDK method and return TransactionResult directly\n  const primaryType = typedData.primaryType as TypedDataPrimaryType;\n  switch (primaryType) {\n    case \"Permission\":\n      return sdk.permissions.submitSignedGrant(\n        typedData as unknown as PermissionGrantTypedData,\n        signature,\n      );\n\n    case \"RevokePermission\":\n      return sdk.permissions.submitSignedRevoke(\n        typedData as unknown as RevokePermissionTypedData,\n        signature,\n      );\n\n    case \"TrustServer\":\n      return sdk.permissions.submitSignedTrustServer(\n        typedData as unknown as TrustServerTypedData,\n        signature,\n      );\n\n    case \"AddServer\":\n      return sdk.permissions.submitSignedAddAndTrustServer(\n        typedData as unknown as AddAndTrustServerTypedData,\n        signature,\n      );\n\n    case \"UntrustServer\":\n      return sdk.permissions.submitSignedUntrustServer(\n        typedData as unknown as GenericTypedData,\n        signature,\n      );\n\n    case \"RegisterGrantee\":\n      return sdk.permissions.submitSignedRegisterGrantee(\n        typedData as unknown as RegisterGranteeTypedData,\n        signature,\n      );\n\n    case \"ServerFilesAndPermission\":\n      return sdk.permissions.submitSignedAddServerFilesAndPermissions(\n        typedData as unknown as ServerFilesAndPermissionTypedData,\n        signature,\n      );\n\n    default:\n      throw new Error(`Unsupported operation type: ${typedData.primaryType}`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,kBAAoD;AAYpD,oBAA+B;AAiG/B,eAAsB,qBACpB,KACA,SACuE;AACvE,QAAM,EAAE,WAAW,WAAW,oBAAoB,IAAI;AAEtD,UAAQ,MAAM;AAAA,IACZ,QAAQ,UAAU;AAAA,IAClB,OAAO,UAAU;AAAA,IACjB,aAAa,UAAU;AAAA,IACvB,SAAS,UAAU;AAAA,IACnB;AAAA,EACF,CAAC;AAGD,QAAM,gBAAgB,UAAM,qCAAwB;AAAA,IAClD,QAAQ,UAAU;AAAA,IAClB,OAAO,UAAU;AAAA,IACjB,aAAa,UAAU;AAAA,IACvB,SAAS,UAAU;AAAA,IACnB;AAAA,EACF,CAAC;AAED,MAAI,CAAC,eAAe;AAClB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAGA,MAAI,qBAAqB;AACvB,UAAM,uBAAmB,wBAAW,aAAa;AACjD,UAAM,yBAAqB,wBAAW,mBAAmB;AAEzD,QAAI,qBAAqB,oBAAoB;AAC3C,YAAM,IAAI;AAAA,QACR,2DAA2D,gBAAgB,2CAA2C,kBAAkB;AAAA,MAC1I;AAAA,IACF;AAAA,EACF;AAIA,QAAM,cAAc,UAAU;AAC9B,UAAQ,aAAa;AAAA,IACnB,KAAK;AACH,aAAO,IAAI,YAAY;AAAA,QACrB;AAAA,QACA;AAAA,MACF;AAAA,IAEF,KAAK;AACH,aAAO,IAAI,YAAY;AAAA,QACrB;AAAA,QACA;AAAA,MACF;AAAA,IAEF,KAAK;AACH,aAAO,IAAI,YAAY;AAAA,QACrB;AAAA,QACA;AAAA,MACF;AAAA,IAEF,KAAK;AACH,aAAO,IAAI,YAAY;AAAA,QACrB;AAAA,QACA;AAAA,MACF;AAAA,IAEF,KAAK;AACH,aAAO,IAAI,YAAY;AAAA,QACrB;AAAA,QACA;AAAA,MACF;AAAA,IAEF,KAAK;AACH,aAAO,IAAI,YAAY;AAAA,QACrB;AAAA,QACA;AAAA,MACF;AAAA,IAEF,KAAK;AACH,aAAO,IAAI,YAAY;AAAA,QACrB;AAAA,QACA;AAAA,MACF;AAAA,IAEF;AACE,YAAM,IAAI,MAAM,+BAA+B,UAAU,WAAW,EAAE;AAAA,EAC1E;AACF;","names":[]}

package/dist/server/handler.d.ts

@@ -0,0 +1,87 @@
+import type { Address, Hash } from "viem";
+import type { VanaInstance } from "../index.node";
+import type { GenericTypedData } from "../types";
+import type { TransactionResult } from "../types/operations";
+import type { PermissionGrantResult, PermissionRevokeResult, ServerTrustResult, ServerUntrustResult, GranteeRegisterResult, FileAddedResult } from "../types/transactionResults";
+/** Union type of all possible transaction results from relayer operations */
+type RelayerTransactionResult = PermissionGrantResult | PermissionRevokeResult | ServerTrustResult | ServerUntrustResult | GranteeRegisterResult | FileAddedResult;
+/**
+ * Payload structure for relayer requests.
+ * Contains the EIP-712 typed data, signature, and optional expected user address for security verification.
+ *
+ * @category Server
+ */
+export interface RelayerRequestPayload {
+    /** EIP-712 typed data containing the transaction details */
+    typedData: GenericTypedData;
+    /** User's signature of the typed data */
+    signature: Hash;
+    /** Optional expected user address for security verification */
+    expectedUserAddress?: Address;
+}
+/**
+ * Unified server-side handler for processing relayed transactions.
+ *
+ * This function encapsulates the complete relayer workflow:
+ * 1. Verifies the signature against the typed data
+ * 2. Optionally checks the signer matches the expected user address
+ * 3. Routes to the appropriate SDK method based on primaryType
+ * 4. Returns the transaction handle with hash and event parsing capability
+ *
+ * Supported transaction types:
+ * - Permission: Permission grants
+ * - PermissionRevoke: Permission revocations
+ * - TrustServer: Trust server operations
+ * - UntrustServer: Untrust server operations
+ * - AddServer: Add and trust server operations
+ * - RegisterGrantee: Register grantee operations
+ * - ServerFilesAndPermission: Batch operation for server, files, and permissions
+ *
+ * @param sdk - Initialized Vana SDK instance
+ * @param payload - Request payload containing typed data, signature, and optional security check
+ * @returns Promise resolving to TransactionResult with hash and optional event data
+ * @throws {SignatureError} When signature verification fails or signer mismatch occurs
+ * @throws {Error} When primaryType is unsupported or SDK operations fail
+ * @category Server
+ * @example
+ * ```typescript
+ * import { handleRelayerRequest } from '@opendatalabs/vana-sdk';
+ *
+ * // In your relayer API endpoint:
+ * export async function POST(request: NextRequest) {
+ *   try {
+ *     const body = await request.json();
+ *     const vana = await createRelayerVana();
+ *
+ *     const tx = await handleRelayerRequest(vana, {
+ *       typedData: body.typedData,
+ *       signature: body.signature,
+ *       expectedUserAddress: body.expectedUserAddress
+ *     });
+ *
+ *     // Option 1: Return just the hash immediately
+ *     return NextResponse.json({
+ *       success: true,
+ *       transactionHash: tx.hash
+ *     });
+ *
+ *     // Option 2: Wait for transaction confirmation and return event data
+ *     const eventData = await tx.waitForEvents();
+ *     return NextResponse.json({
+ *       success: true,
+ *       transactionHash: tx.hash,
+ *       ...eventData // Include parsed event data like permissionId, fileId, etc.
+ *     });
+ *   } catch (error) {
+ *     return NextResponse.json({
+ *       success: false,
+ *       error: error.message
+ *     }, { status: 500 });
+ *   }
+ * }
+ * ```
+ */
+export declare function handleRelayerRequest(sdk: VanaInstance, payload: RelayerRequestPayload): Promise<TransactionResult & {
+    eventData?: RelayerTransactionResult;
+}>;
+export {};

package/dist/server/handler.js

@@ -0,0 +1,77 @@
+import { recoverTypedDataAddress, getAddress } from "viem";
+import { SignatureError } from "../errors";
+async function handleRelayerRequest(sdk, payload) {
+  const { typedData, signature, expectedUserAddress } = payload;
+  console.debug({
+    domain: typedData.domain,
+    types: typedData.types,
+    primaryType: typedData.primaryType,
+    message: typedData.message,
+    signature
+  });
+  const signerAddress = await recoverTypedDataAddress({
+    domain: typedData.domain,
+    types: typedData.types,
+    primaryType: typedData.primaryType,
+    message: typedData.message,
+    signature
+  });
+  if (!signerAddress) {
+    throw new SignatureError(
+      "Invalid signature - could not recover signer address"
+    );
+  }
+  if (expectedUserAddress) {
+    const normalizedSigner = getAddress(signerAddress);
+    const normalizedExpected = 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.`
+      );
+    }
+  }
+  const primaryType = typedData.primaryType;
+  switch (primaryType) {
+    case "Permission":
+      return sdk.permissions.submitSignedGrant(
+        typedData,
+        signature
+      );
+    case "RevokePermission":
+      return sdk.permissions.submitSignedRevoke(
+        typedData,
+        signature
+      );
+    case "TrustServer":
+      return sdk.permissions.submitSignedTrustServer(
+        typedData,
+        signature
+      );
+    case "AddServer":
+      return sdk.permissions.submitSignedAddAndTrustServer(
+        typedData,
+        signature
+      );
+    case "UntrustServer":
+      return sdk.permissions.submitSignedUntrustServer(
+        typedData,
+        signature
+      );
+    case "RegisterGrantee":
+      return sdk.permissions.submitSignedRegisterGrantee(
+        typedData,
+        signature
+      );
+    case "ServerFilesAndPermission":
+      return sdk.permissions.submitSignedAddServerFilesAndPermissions(
+        typedData,
+        signature
+      );
+    default:
+      throw new Error(`Unsupported operation type: ${typedData.primaryType}`);
+  }
+}
+export {
+  handleRelayerRequest
+};
+//# sourceMappingURL=handler.js.map

package/dist/server/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/handler.ts"],"sourcesContent":["import type { Address, Hash } from \"viem\";\nimport { recoverTypedDataAddress, getAddress } from \"viem\";\nimport type { VanaInstance } from \"../index.node\";\nimport type {\n  GenericTypedData,\n  PermissionGrantTypedData,\n  RevokePermissionTypedData,\n  RegisterGranteeTypedData,\n  TrustServerTypedData,\n  AddAndTrustServerTypedData,\n  ServerFilesAndPermissionTypedData,\n  TypedDataPrimaryType,\n} from \"../types\";\nimport { SignatureError } from \"../errors\";\nimport type { TransactionResult } from \"../types/operations\";\nimport type {\n  PermissionGrantResult,\n  PermissionRevokeResult,\n  ServerTrustResult,\n  ServerUntrustResult,\n  GranteeRegisterResult,\n  FileAddedResult,\n} from \"../types/transactionResults\";\n\n/** Union type of all possible transaction results from relayer operations */\ntype RelayerTransactionResult =\n  | PermissionGrantResult\n  | PermissionRevokeResult\n  | ServerTrustResult\n  | ServerUntrustResult\n  | GranteeRegisterResult\n  | FileAddedResult;\n\n/**\n * Payload structure for relayer requests.\n * Contains the EIP-712 typed data, signature, and optional expected user address for security verification.\n *\n * @category Server\n */\nexport interface RelayerRequestPayload {\n  /** EIP-712 typed data containing the transaction details */\n  typedData: GenericTypedData;\n  /** User's signature of the typed data */\n  signature: Hash;\n  /** Optional expected user address for security verification */\n  expectedUserAddress?: Address;\n}\n\n/**\n * Unified server-side handler for processing relayed transactions.\n *\n * This function encapsulates the complete relayer workflow:\n * 1. Verifies the signature against the typed data\n * 2. Optionally checks the signer matches the expected user address\n * 3. Routes to the appropriate SDK method based on primaryType\n * 4. Returns the transaction handle with hash and event parsing capability\n *\n * Supported transaction types:\n * - Permission: Permission grants\n * - PermissionRevoke: Permission revocations\n * - TrustServer: Trust server operations\n * - UntrustServer: Untrust server operations\n * - AddServer: Add and trust server operations\n * - RegisterGrantee: Register grantee operations\n * - ServerFilesAndPermission: Batch operation for server, files, and permissions\n *\n * @param sdk - Initialized Vana SDK instance\n * @param payload - Request payload containing typed data, signature, and optional security check\n * @returns Promise resolving to TransactionResult with hash and optional event data\n * @throws {SignatureError} When signature verification fails or signer mismatch occurs\n * @throws {Error} When primaryType is unsupported or SDK operations fail\n * @category Server\n * @example\n * ```typescript\n * import { handleRelayerRequest } from '@opendatalabs/vana-sdk';\n *\n * // In your relayer API endpoint:\n * export async function POST(request: NextRequest) {\n *   try {\n *     const body = await request.json();\n *     const vana = await createRelayerVana();\n *\n *     const tx = await handleRelayerRequest(vana, {\n *       typedData: body.typedData,\n *       signature: body.signature,\n *       expectedUserAddress: body.expectedUserAddress\n *     });\n *\n *     // Option 1: Return just the hash immediately\n *     return NextResponse.json({\n *       success: true,\n *       transactionHash: tx.hash\n *     });\n *\n *     // Option 2: Wait for transaction confirmation and return event data\n *     const eventData = await tx.waitForEvents();\n *     return NextResponse.json({\n *       success: true,\n *       transactionHash: tx.hash,\n *       ...eventData // Include parsed event data like permissionId, fileId, etc.\n *     });\n *   } catch (error) {\n *     return NextResponse.json({\n *       success: false,\n *       error: error.message\n *     }, { status: 500 });\n *   }\n * }\n * ```\n */\nexport async function handleRelayerRequest(\n  sdk: VanaInstance,\n  payload: RelayerRequestPayload,\n): Promise<TransactionResult & { eventData?: RelayerTransactionResult }> {\n  const { typedData, signature, expectedUserAddress } = payload;\n\n  console.debug({\n    domain: typedData.domain,\n    types: typedData.types,\n    primaryType: typedData.primaryType,\n    message: typedData.message as unknown as Record<string, unknown>,\n    signature,\n  });\n\n  // Step 1: Verify signature and recover signer address\n  const signerAddress = await recoverTypedDataAddress({\n    domain: typedData.domain,\n    types: typedData.types,\n    primaryType: typedData.primaryType,\n    message: typedData.message as unknown as Record<string, unknown>,\n    signature,\n  });\n\n  if (!signerAddress) {\n    throw new SignatureError(\n      \"Invalid signature - could not recover signer address\",\n    );\n  }\n\n  // Step 2: Security check - verify signer matches expected user address if provided\n  if (expectedUserAddress) {\n    const normalizedSigner = getAddress(signerAddress);\n    const normalizedExpected = getAddress(expectedUserAddress);\n\n    if (normalizedSigner !== normalizedExpected) {\n      throw new SignatureError(\n        `Security verification failed: Recovered signer address (${normalizedSigner}) does not match expected user address (${normalizedExpected}). This may be due to incorrect EIP-712 domain configuration.`,\n      );\n    }\n  }\n\n  // Step 3: Route to appropriate SDK method based on primaryType\n  // Route to appropriate SDK method and return TransactionResult directly\n  const primaryType = typedData.primaryType as TypedDataPrimaryType;\n  switch (primaryType) {\n    case \"Permission\":\n      return sdk.permissions.submitSignedGrant(\n        typedData as unknown as PermissionGrantTypedData,\n        signature,\n      );\n\n    case \"RevokePermission\":\n      return sdk.permissions.submitSignedRevoke(\n        typedData as unknown as RevokePermissionTypedData,\n        signature,\n      );\n\n    case \"TrustServer\":\n      return sdk.permissions.submitSignedTrustServer(\n        typedData as unknown as TrustServerTypedData,\n        signature,\n      );\n\n    case \"AddServer\":\n      return sdk.permissions.submitSignedAddAndTrustServer(\n        typedData as unknown as AddAndTrustServerTypedData,\n        signature,\n      );\n\n    case \"UntrustServer\":\n      return sdk.permissions.submitSignedUntrustServer(\n        typedData as unknown as GenericTypedData,\n        signature,\n      );\n\n    case \"RegisterGrantee\":\n      return sdk.permissions.submitSignedRegisterGrantee(\n        typedData as unknown as RegisterGranteeTypedData,\n        signature,\n      );\n\n    case \"ServerFilesAndPermission\":\n      return sdk.permissions.submitSignedAddServerFilesAndPermissions(\n        typedData as unknown as ServerFilesAndPermissionTypedData,\n        signature,\n      );\n\n    default:\n      throw new Error(`Unsupported operation type: ${typedData.primaryType}`);\n  }\n}\n"],"mappings":"AACA,SAAS,yBAAyB,kBAAkB;AAYpD,SAAS,sBAAsB;AAiG/B,eAAsB,qBACpB,KACA,SACuE;AACvE,QAAM,EAAE,WAAW,WAAW,oBAAoB,IAAI;AAEtD,UAAQ,MAAM;AAAA,IACZ,QAAQ,UAAU;AAAA,IAClB,OAAO,UAAU;AAAA,IACjB,aAAa,UAAU;AAAA,IACvB,SAAS,UAAU;AAAA,IACnB;AAAA,EACF,CAAC;AAGD,QAAM,gBAAgB,MAAM,wBAAwB;AAAA,IAClD,QAAQ,UAAU;AAAA,IAClB,OAAO,UAAU;AAAA,IACjB,aAAa,UAAU;AAAA,IACvB,SAAS,UAAU;AAAA,IACnB;AAAA,EACF,CAAC;AAED,MAAI,CAAC,eAAe;AAClB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAGA,MAAI,qBAAqB;AACvB,UAAM,mBAAmB,WAAW,aAAa;AACjD,UAAM,qBAAqB,WAAW,mBAAmB;AAEzD,QAAI,qBAAqB,oBAAoB;AAC3C,YAAM,IAAI;AAAA,QACR,2DAA2D,gBAAgB,2CAA2C,kBAAkB;AAAA,MAC1I;AAAA,IACF;AAAA,EACF;AAIA,QAAM,cAAc,UAAU;AAC9B,UAAQ,aAAa;AAAA,IACnB,KAAK;AACH,aAAO,IAAI,YAAY;AAAA,QACrB;AAAA,QACA;AAAA,MACF;AAAA,IAEF,KAAK;AACH,aAAO,IAAI,YAAY;AAAA,QACrB;AAAA,QACA;AAAA,MACF;AAAA,IAEF,KAAK;AACH,aAAO,IAAI,YAAY;AAAA,QACrB;AAAA,QACA;AAAA,MACF;AAAA,IAEF,KAAK;AACH,aAAO,IAAI,YAAY;AAAA,QACrB;AAAA,QACA;AAAA,MACF;AAAA,IAEF,KAAK;AACH,aAAO,IAAI,YAAY;AAAA,QACrB;AAAA,QACA;AAAA,MACF;AAAA,IAEF,KAAK;AACH,aAAO,IAAI,YAAY;AAAA,QACrB;AAAA,QACA;AAAA,MACF;AAAA,IAEF,KAAK;AACH,aAAO,IAAI,YAAY;AAAA,QACrB;AAAA,QACA;AAAA,MACF;AAAA,IAEF;AACE,YAAM,IAAI,MAAM,+BAA+B,UAAU,WAAW,EAAE;AAAA,EAC1E;AACF;","names":[]}

package/dist/storage/index.cjs

@@ -0,0 +1,44 @@
+"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 storage_exports = {};
+__export(storage_exports, {
+  CallbackStorage: () => import_callback_storage.CallbackStorage,
+  GoogleDriveStorage: () => import_google_drive.GoogleDriveStorage,
+  IpfsStorage: () => import_ipfs.IpfsStorage,
+  PinataStorage: () => import_pinata.PinataStorage,
+  StorageError: () => import_storage.StorageError,
+  StorageManager: () => import_manager.StorageManager
+});
+module.exports = __toCommonJS(storage_exports);
+var import_storage = require("../types/storage");
+var import_google_drive = require("./providers/google-drive");
+var import_ipfs = require("./providers/ipfs");
+var import_pinata = require("./providers/pinata");
+var import_callback_storage = require("./providers/callback-storage");
+var import_manager = require("./manager");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CallbackStorage,
+  GoogleDriveStorage,
+  IpfsStorage,
+  PinataStorage,
+  StorageError,
+  StorageManager
+});
+//# sourceMappingURL=index.cjs.map