@opendatalabs/vana-sdk 0.1.0-alpha.2b6935d → 0.1.0-alpha.2e77fcc

package/dist/server/handler.cjs

@@ -1,103 +0,0 @@
-"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
-      );
-    // TODO: RegisterGrantee with signature is not supported until
-    // DataPortabilityGrantees contract adds registerGranteeWithSignature function
-    // case "RegisterGrantee":
-    //   return sdk.permissions.submitSignedRegisterGrantee(
-    //     typedData as unknown as RegisterGranteeTypedData,
-    //     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

@@ -1 +0,0 @@
-{"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  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 * @deprecated Use `handleRelayerOperation` from '../server/relayerHandler' instead.\n * This legacy handler will be removed in the next major version.\n *\n * Migration guide:\n * - Import { handleRelayerOperation } instead of { handleRelayerRequest }\n * - Use UnifiedRelayerRequest/Response types for better type safety\n * - The new handler eliminates unsafe type assertions (as unknown as)\n *\n * Legacy 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\n  // NOTE: The type assertions below use `as unknown as` to bypass TypeScript checking.\n  // This is a known technical debt from the legacy relayer system.\n  // The new unified relayer handler (relayerHandler.ts) provides stronger type safety.\n  // TODO(TYPES): Migrate consumers to use the unified handler with proper type checking\n\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    // TODO: RegisterGrantee with signature is not supported until\n    // DataPortabilityGrantees contract adds registerGranteeWithSignature function\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;AAWpD,oBAA+B;AAyG/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;AAO9B,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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAUF,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

@@ -1,95 +0,0 @@
-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;
-}
-/**
- * @deprecated Use `handleRelayerOperation` from '../server/relayerHandler' instead.
- * This legacy handler will be removed in the next major version.
- *
- * Migration guide:
- * - Import { handleRelayerOperation } instead of { handleRelayerRequest }
- * - Use UnifiedRelayerRequest/Response types for better type safety
- * - The new handler eliminates unsafe type assertions (as unknown as)
- *
- * Legacy 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

@@ -1,79 +0,0 @@
-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
-      );
-    // TODO: RegisterGrantee with signature is not supported until
-    // DataPortabilityGrantees contract adds registerGranteeWithSignature function
-    // case "RegisterGrantee":
-    //   return sdk.permissions.submitSignedRegisterGrantee(
-    //     typedData as unknown as RegisterGranteeTypedData,
-    //     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

@@ -1 +0,0 @@
-{"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  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 * @deprecated Use `handleRelayerOperation` from '../server/relayerHandler' instead.\n * This legacy handler will be removed in the next major version.\n *\n * Migration guide:\n * - Import { handleRelayerOperation } instead of { handleRelayerRequest }\n * - Use UnifiedRelayerRequest/Response types for better type safety\n * - The new handler eliminates unsafe type assertions (as unknown as)\n *\n * Legacy 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\n  // NOTE: The type assertions below use `as unknown as` to bypass TypeScript checking.\n  // This is a known technical debt from the legacy relayer system.\n  // The new unified relayer handler (relayerHandler.ts) provides stronger type safety.\n  // TODO(TYPES): Migrate consumers to use the unified handler with proper type checking\n\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    // TODO: RegisterGrantee with signature is not supported until\n    // DataPortabilityGrantees contract adds registerGranteeWithSignature function\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;AAWpD,SAAS,sBAAsB;AAyG/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;AAO9B,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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAUF,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":[]}