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

package/dist/server/handler.d.ts

@@ -1,67 +1,8 @@
-import { VanaCore } from '../core.js';
-import '../types.js';
-import '../types/external-apis.js';
-import '../generated/abi/index.js';
-import '../errors.js';
-import { b as PermissionGrantResult, c as PermissionRevokeResult, d as ServerTrustResult, e as ServerUntrustResult, G as GranteeRegisterResult, a as FileAddedResult } from '../permissions-eo8YeLGf.js';
-import '../controllers/data.js';
-import '../controllers/server.js';
-import '../controllers/protocol.js';
-import '../controllers/schemas.js';
-import '../contracts/contractController.js';
-import '../utils/encryption.js';
-import '../utils/formatters.js';
-import '../utils/grantFiles.js';
-import '../utils/grantValidation.js';
-import '../utils/grants.js';
-import '../utils/ipfs.js';
-import '../utils/schemaValidation.js';
-import '../utils/signatureCache.js';
-import '../types/storage.js';
-import '../storage/providers/google-drive.js';
-import '../storage/providers/ipfs.js';
-import '../storage/providers/pinata.js';
-import '../storage/providers/callback-storage.js';
-import '../storage/manager.js';
-import { VanaConfigWithStorage, VanaConfig, StorageRequiredMarker } from '../types/config.js';
-import '../config/addresses.js';
-import '../config/chains.js';
-import '../chains/definitions.js';
-import '../core/generics.js';
-import { Hash, Address } from 'viem';
-import { TransactionResult } from '../types/operations.js';
-import '../platform/node.js';
-import '../platform/browser.js';
-import '../platform/interface.js';
-import '../platform/utils.js';
-import '../platform/browser-safe.js';
-import '../core/apiClient.js';
-import '../types/chains.js';
-import '../types/contracts.js';
-import '../types/data.js';
-import { GenericTypedData } from '../types/permissions.js';
-import '../types/personal.js';
-import '../types/relayer.js';
-import '../types/utils.js';
-import '../types/generics.js';
-import '../generated/server/server.js';
-import '../generated/server/server-exports.js';
-import '../config/eventMappings.js';
-import '../generated/abi/DataPortabilityPermissionsImplementation.js';
-import '../generated/abi/DataPortabilityServersImplementation.js';
-import '../generated/abi/DataPortabilityGranteesImplementation.js';
-import '../generated/abi/VanaEpochImplementation.js';
-import '../generated/abi/DLPRegistryImplementation.js';
-import '../generated/abi/DLPTreasuryImplementation.js';
-import '../generated/abi/DLPRewardDeployerTreasuryImplementation.js';
-import '../generated/abi/DLPPerformanceImplementation.js';
-import '../generated/abi/DLPRewardDeployerImplementation.js';
-import '../generated/abi/DLPRootImplementation.js';
-import '../generated/abi/DataLiquidityPoolImplementation.js';
-import '../generated/abi/DLPRegistryTreasuryImplementation.js';
-import 'abitype';
-import '../core/client.js';
-
+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;
 /**
@@ -70,7 +11,7 @@ type RelayerTransactionResult = PermissionGrantResult | PermissionRevokeResult |
  *
  * @category Server
  */
-interface RelayerRequestPayload {
+export interface RelayerRequestPayload {
     /** EIP-712 typed data containing the transaction details */
     typedData: GenericTypedData;
     /** User's signature of the typed data */
@@ -79,7 +20,15 @@ interface RelayerRequestPayload {
     expectedUserAddress?: Address;
 }
 /**
- * Unified server-side handler for processing relayed transactions.
+ * @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
@@ -140,143 +89,7 @@ interface RelayerRequestPayload {
  * }
  * ```
  */
-declare function handleRelayerRequest(sdk: VanaInstance, payload: RelayerRequestPayload): Promise<TransactionResult & {
+export declare function handleRelayerRequest(sdk: VanaInstance, payload: RelayerRequestPayload): Promise<TransactionResult & {
     eventData?: RelayerTransactionResult;
 }>;
-
-/**
- * Internal implementation class for Node.js environments.
- * This class is not exported directly - use the Vana factory function instead.
- */
-declare class VanaNodeImpl extends VanaCore {
-    constructor(config: VanaConfig);
-}
-/**
- * Creates a new Vana SDK instance configured for Node.js environments.
- *
- * @remarks
- * This is the primary entry point for Node.js applications using the Vana SDK. The function
- * automatically detects your configuration type and provides compile-time type safety:
- * - **With storage configured**: All methods including file upload/download are available
- * - **Without storage**: Storage-dependent methods throw runtime errors and are excluded from TypeScript
- *
- * The Node.js version provides enhanced capabilities including native file system access,
- * server-side cryptographic operations, and support for personal server deployment.
- * It includes all browser capabilities plus Node.js-specific optimizations and utilities.
- *
- * @param config - Configuration object containing wallet, storage, and relayer settings
- * @returns A fully configured Vana SDK instance for Node.js use
- * @throws {InvalidConfigurationError} When configuration parameters are invalid or missing
- * @example
- * ```typescript
- * import { Vana } from '@opendatalabs/vana-sdk/node';
- * import { createWalletClient, http } from 'viem';
- * import { privateKeyToAccount } from 'viem/accounts';
- * import { IPFSStorage, PinataStorage } from '@opendatalabs/vana-sdk/node';
- * import { mokshaTestnet } from '@opendatalabs/vana-sdk/node';
- *
- * // Server setup with private key
- * const account = privateKeyToAccount('0x...');
- * const walletClient = createWalletClient({
- *   account,
- *   chain: mokshaTestnet,
- *   transport: http('https://rpc.moksha.vana.org')
- * });
- *
- * const vana = Vana({
- *   walletClient,
- *   storage: {
- *     providers: {
- *       ipfs: new IPFSStorage({
- *         gateway: 'https://gateway.pinata.cloud',
- *         timeout: 30000
- *       }),
- *       pinata: new PinataStorage({
- *         apiKey: process.env.PINATA_KEY,
- *         secretKey: process.env.PINATA_SECRET
- *       })
- *     },
- *     defaultProvider: 'pinata'
- *   },
- *   relayerCallbacks: {
- *     async submitPermissionGrant(typedData, signature) {
- *       // Server-side relayer implementation
- *       return await submitToCustomRelayer(typedData, signature);
- *     }
- *   }
- * });
- *
- * // Server operations
- * const uploadResult = await vana.data.upload({
- *   content: await fs.readFile('./user-data.json'),
- *   filename: 'user-data.json',
- *   schemaId: 1
- * });
- *
- * // Personal server setup
- * await vana.server.setupPersonalServer({
- *   serverUrl: 'https://my-server.example.com',
- *   capabilities: ['data_processing', 'ml_inference']
- * });
- * ```
- *
- * @example
- * ```typescript
- * // CLI tool or script usage
- * const vana = Vana({
- *   chainId: 14800, // Moksha testnet
- *   account: privateKeyToAccount(process.env.PRIVATE_KEY),
- *   rpcUrl: process.env.RPC_URL,
- *   storage: {
- *     providers: { ipfs: new IPFSStorage() },
- *     defaultProvider: 'ipfs'
- *   }
- * });
- *
- * // Batch operations for data processing
- * const userFiles = await vana.data.getUserFiles({
- *   owner: process.env.USER_ADDRESS
- * });
- *
- * for (const file of userFiles) {
- *   const decrypted = await vana.data.decryptFile(file);
- *   // Process file data...
- * }
- * ```
- *
- * @example
- * ```typescript
- * // Express.js server integration
- * import express from 'express';
- * import { handleRelayerRequest } from '@opendatalabs/vana-sdk/node';
- *
- * const app = express();
- *
- * app.post('/api/relay/:operation', async (req, res) => {
- *   try {
- *     const result = await handleRelayerRequest(
- *       req.params.operation,
- *       req.body,
- *       vana
- *     );
- *     res.json({ success: true, result });
- *   } catch (error) {
- *     res.status(500).json({ error: error.message });
- *   }
- * });
- * ```
- *
- * @see {@link https://docs.vana.org/docs/sdk/server-setup | Server Setup Guide} for Node.js-specific features
- * @see {@link VanaCore} for the underlying implementation details
- * @category Core SDK
- */
-declare function Vana(config: VanaConfigWithStorage): VanaNodeImpl & StorageRequiredMarker;
-declare function Vana(config: VanaConfig): VanaNodeImpl;
-/**
- * The type of a Vana SDK instance in Node.js environments.
- *
- * @see {@link Vana}
- */
-type VanaInstance = VanaNodeImpl;
-
-export { type RelayerRequestPayload, Vana as V, VanaNodeImpl as a, type VanaInstance as b, handleRelayerRequest };
+export {};

package/dist/server/handler.js

@@ -57,11 +57,13 @@ async function handleRelayerRequest(sdk, payload) {
         typedData,
         signature
       );
-    case "RegisterGrantee":
-      return sdk.permissions.submitSignedRegisterGrantee(
-        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,

package/dist/server/handler.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/server/handler.ts"],"sourcesContent":["import { Address, Hash, 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,SAAwB,yBAAyB,kBAAkB;AAYnE,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":[]}
+{"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":[]}

package/dist/server/relayerHandler.cjs

@@ -0,0 +1,220 @@
+"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 relayerHandler_exports = {};
+__export(relayerHandler_exports, {
+  handleRelayerOperation: () => handleRelayerOperation,
+  handleRelayerRequest: () => import_handler.handleRelayerRequest
+});
+module.exports = __toCommonJS(relayerHandler_exports);
+var import_errors = require("../errors");
+var import_viem = require("viem");
+var import_handler = require("./handler");
+async function handleRelayerOperation(sdk, request) {
+  if (request.type === "signed") {
+    return handleSignedOperation(sdk, request);
+  }
+  return handleDirectOperation(sdk, request);
+}
+async function handleSignedOperation(sdk, request) {
+  const { typedData, signature, expectedUserAddress } = request;
+  let recoveredAddress;
+  try {
+    recoveredAddress = await (0, import_viem.recoverTypedDataAddress)({
+      domain: {
+        ...typedData.domain,
+        chainId: typedData.domain.chainId ? BigInt(typedData.domain.chainId) : void 0
+      },
+      types: typedData.types,
+      primaryType: typedData.primaryType,
+      message: typedData.message,
+      signature
+    });
+  } catch (error) {
+    throw new import_errors.SignatureError(
+      `Signature verification failed: ${error instanceof Error ? error.message : "Unknown error"}`
+    );
+  }
+  if (expectedUserAddress) {
+    const normalizedExpected = (0, import_viem.getAddress)(expectedUserAddress);
+    const normalizedSigner = (0, import_viem.getAddress)(recoveredAddress);
+    if (normalizedSigner !== normalizedExpected) {
+      throw new import_errors.SignatureError(
+        `Security verification failed: Recovered signer address (${normalizedSigner}) does not match expected user address (${normalizedExpected})`
+      );
+    }
+  }
+  const result = await routeSignedOperation(sdk, typedData, signature);
+  return {
+    type: "signed",
+    hash: result.hash
+  };
+}
+async function routeSignedOperation(sdk, typedData, signature) {
+  const primaryType = typedData.primaryType;
+  switch (primaryType) {
+    case "Permission":
+      return sdk.permissions.submitSignedGrant(
+        {
+          ...typedData,
+          primaryType: "Permission"
+        },
+        signature
+      );
+    case "RevokePermission":
+      return sdk.permissions.submitSignedRevoke(
+        {
+          ...typedData,
+          primaryType: "RevokePermission"
+        },
+        signature
+      );
+    case "TrustServer":
+      return sdk.permissions.submitSignedTrustServer(
+        {
+          ...typedData,
+          primaryType: "TrustServer"
+        },
+        signature
+      );
+    case "AddServer":
+      return sdk.permissions.submitSignedAddAndTrustServer(
+        {
+          ...typedData,
+          primaryType: "AddServer"
+        },
+        signature
+      );
+    case "UntrustServer":
+      return sdk.permissions.submitSignedUntrustServer(
+        {
+          ...typedData,
+          primaryType: "UntrustServer"
+        },
+        signature
+      );
+    case "ServerFilesAndPermission":
+      return sdk.permissions.submitSignedAddServerFilesAndPermissions(
+        {
+          ...typedData,
+          primaryType: "ServerFilesAndPermission"
+        },
+        signature
+      );
+    // RegisterGrantee is commented out as it's not supported by smart contracts yet
+    // case "RegisterGrantee":
+    //   return sdk.permissions.submitSignedRegisterGrantee(...);
+    default:
+      throw new Error(`Unsupported operation type: ${typedData.primaryType}`);
+  }
+}
+async function handleDirectOperation(sdk, request) {
+  switch (request.operation) {
+    case "submitFileAddition": {
+      const { url, userAddress } = request.params;
+      const result = await sdk.data.addFileWithPermissions(
+        url,
+        userAddress,
+        []
+        // No permissions
+      );
+      const eventData = await sdk.waitForTransactionEvents(result);
+      const fileId = eventData.expectedEvents?.FileAdded?.fileId;
+      if (!fileId) {
+        throw new Error("Failed to get fileId from transaction events");
+      }
+      return {
+        type: "direct",
+        result: {
+          fileId: Number(fileId),
+          transactionHash: result.hash
+        }
+      };
+    }
+    case "submitFileAdditionWithPermissions": {
+      const { url, userAddress, permissions } = request.params;
+      const result = await sdk.data.addFileWithPermissions(
+        url,
+        userAddress,
+        permissions
+      );
+      const eventData = await sdk.waitForTransactionEvents(result);
+      const fileId = eventData.expectedEvents?.FileAdded?.fileId;
+      if (!fileId) {
+        throw new Error("Failed to get fileId from transaction events");
+      }
+      return {
+        type: "direct",
+        result: {
+          fileId: Number(fileId),
+          transactionHash: result.hash
+        }
+      };
+    }
+    case "submitFileAdditionComplete": {
+      const { url, userAddress, permissions, schemaId, ownerAddress } = request.params;
+      const sdkPermissions = permissions.map((p) => ({
+        account: p.account,
+        publicKey: p.key
+        // Map 'key' to 'publicKey'
+      }));
+      const result = await sdk.data.addFileWithPermissionsAndSchema(
+        url,
+        ownerAddress ?? userAddress,
+        sdkPermissions,
+        schemaId
+      );
+      const eventData = await sdk.waitForTransactionEvents(result);
+      const fileId = eventData.expectedEvents?.FileAdded?.fileId;
+      if (!fileId) {
+        throw new Error("Failed to get fileId from transaction events");
+      }
+      return {
+        type: "direct",
+        result: {
+          fileId: Number(fileId),
+          transactionHash: result.hash
+        }
+      };
+    }
+    case "storeGrantFile": {
+      const grantFile = request.params;
+      const blob = new Blob([JSON.stringify(grantFile)], {
+        type: "application/json"
+      });
+      const result = await sdk.data.upload({
+        content: blob,
+        filename: `grant-${Date.now()}.json`
+      });
+      return {
+        type: "direct",
+        result: { url: result.url }
+      };
+    }
+    default: {
+      const exhaustiveCheck = request;
+      return exhaustiveCheck;
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  handleRelayerOperation,
+  handleRelayerRequest
+});
+//# sourceMappingURL=relayerHandler.cjs.map

package/dist/server/relayerHandler.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/relayerHandler.ts"],"sourcesContent":["import type { VanaInstance } from \"../index.node\";\nimport type {\n  UnifiedRelayerRequest,\n  UnifiedRelayerResponse,\n  SignedRelayerRequest,\n  DirectRelayerRequest,\n} from \"../types/relayer\";\nimport type {\n  GenericTypedData,\n  PermissionGrantTypedData,\n  RevokePermissionTypedData,\n  TrustServerTypedData,\n  AddAndTrustServerTypedData,\n  ServerFilesAndPermissionTypedData,\n  TypedDataPrimaryType,\n} from \"../types/permissions\";\nimport { SignatureError } from \"../errors\";\nimport { recoverTypedDataAddress, getAddress, type Hash } from \"viem\";\n\n/**\n * Universal handler for all relayer operations.\n *\n * This function processes both EIP-712 signed operations and direct operations,\n * automatically routing to the appropriate SDK methods.\n *\n * @param sdk - Initialized Vana SDK instance\n * @param request - The unified relayer request\n * @returns Promise resolving to operation-specific response\n *\n * @category Server\n * @example\n * ```typescript\n * // In your server endpoint (Next.js example):\n * import { handleRelayerOperation } from '@opendatalabs/vana-sdk/node';\n *\n * export async function POST(request: NextRequest) {\n *   try {\n *     const body = await request.json();\n *     const vana = getServerVanaInstance(); // Your server SDK instance\n *\n *     const result = await handleRelayerOperation(vana, body);\n *\n *     return NextResponse.json(result);\n *   } catch (error) {\n *     return NextResponse.json(\n *       { error: error.message },\n *       { status: 500 }\n *     );\n *   }\n * }\n * ```\n */\nexport async function handleRelayerOperation(\n  sdk: VanaInstance,\n  request: UnifiedRelayerRequest,\n): Promise<UnifiedRelayerResponse> {\n  // Handle signed operations (EIP-712)\n  if (request.type === \"signed\") {\n    return handleSignedOperation(sdk, request);\n  }\n\n  // Handle direct operations (non-signed)\n  return handleDirectOperation(sdk, request);\n}\n\n/**\n * Handle EIP-712 signed operations with full type safety\n */\nasync function handleSignedOperation(\n  sdk: VanaInstance,\n  request: SignedRelayerRequest,\n): Promise<UnifiedRelayerResponse> {\n  const { typedData, signature, expectedUserAddress } = request;\n\n  // Step 1: Verify the signature (security check)\n  let recoveredAddress: `0x${string}`;\n  try {\n    recoveredAddress = await recoverTypedDataAddress({\n      domain: {\n        ...typedData.domain,\n        chainId: typedData.domain.chainId\n          ? BigInt(typedData.domain.chainId)\n          : undefined,\n      },\n      types: typedData.types,\n      primaryType: typedData.primaryType,\n      message: typedData.message as unknown as Record<string, unknown>,\n      signature,\n    });\n  } catch (error) {\n    // Handle signature verification errors\n    throw new SignatureError(\n      `Signature verification failed: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n    );\n  }\n\n  // Optional security check: Verify the signer matches expected address\n  if (expectedUserAddress) {\n    const normalizedExpected = getAddress(expectedUserAddress);\n    const normalizedSigner = getAddress(recoveredAddress);\n\n    if (normalizedSigner !== normalizedExpected) {\n      throw new SignatureError(\n        `Security verification failed: Recovered signer address (${normalizedSigner}) does not match expected user address (${normalizedExpected})`,\n      );\n    }\n  }\n\n  // Step 2: Route to appropriate SDK method based on primaryType\n  // Using proper type narrowing instead of unsafe casts\n  const result = await routeSignedOperation(sdk, typedData, signature);\n\n  // Return the transaction hash with type\n  return {\n    type: \"signed\",\n    hash: result.hash,\n  };\n}\n\n/**\n * Route signed operations to the appropriate SDK method with type safety\n */\nasync function routeSignedOperation(\n  sdk: VanaInstance,\n  typedData: GenericTypedData,\n  signature: Hash,\n) {\n  const primaryType = typedData.primaryType as TypedDataPrimaryType;\n\n  // Type-safe routing based on primaryType\n  switch (primaryType) {\n    case \"Permission\":\n      // TypeScript knows this is a Permission operation\n      return sdk.permissions.submitSignedGrant(\n        {\n          ...typedData,\n          primaryType: \"Permission\",\n        } as PermissionGrantTypedData,\n        signature,\n      );\n\n    case \"RevokePermission\":\n      return sdk.permissions.submitSignedRevoke(\n        {\n          ...typedData,\n          primaryType: \"RevokePermission\",\n        } as RevokePermissionTypedData,\n        signature,\n      );\n\n    case \"TrustServer\":\n      return sdk.permissions.submitSignedTrustServer(\n        {\n          ...typedData,\n          primaryType: \"TrustServer\",\n        } as TrustServerTypedData,\n        signature,\n      );\n\n    case \"AddServer\":\n      return sdk.permissions.submitSignedAddAndTrustServer(\n        {\n          ...typedData,\n          primaryType: \"AddServer\",\n        } as AddAndTrustServerTypedData,\n        signature,\n      );\n\n    case \"UntrustServer\":\n      return sdk.permissions.submitSignedUntrustServer(\n        {\n          ...typedData,\n          primaryType: \"UntrustServer\",\n        } as GenericTypedData,\n        signature,\n      );\n\n    case \"ServerFilesAndPermission\":\n      return sdk.permissions.submitSignedAddServerFilesAndPermissions(\n        {\n          ...typedData,\n          primaryType: \"ServerFilesAndPermission\",\n        } as ServerFilesAndPermissionTypedData,\n        signature,\n      );\n\n    // RegisterGrantee is commented out as it's not supported by smart contracts yet\n    // case \"RegisterGrantee\":\n    //   return sdk.permissions.submitSignedRegisterGrantee(...);\n\n    default:\n      throw new Error(`Unsupported operation type: ${typedData.primaryType}`);\n  }\n}\n\n/**\n * Handle direct (non-signed) operations\n */\nasync function handleDirectOperation(\n  sdk: VanaInstance,\n  request: DirectRelayerRequest,\n): Promise<UnifiedRelayerResponse> {\n  switch (request.operation) {\n    case \"submitFileAddition\": {\n      const { url, userAddress } = request.params;\n\n      // Use SDK to add file with no permissions\n      const result = await sdk.data.addFileWithPermissions(\n        url,\n        userAddress,\n        [], // No permissions\n      );\n\n      // Wait for transaction events to get fileId\n      const eventData = await sdk.waitForTransactionEvents(result);\n      const fileId = eventData.expectedEvents?.FileAdded?.fileId;\n\n      if (!fileId) {\n        throw new Error(\"Failed to get fileId from transaction events\");\n      }\n\n      return {\n        type: \"direct\",\n        result: {\n          fileId: Number(fileId),\n          transactionHash: result.hash,\n        },\n      };\n    }\n\n    case \"submitFileAdditionWithPermissions\": {\n      const { url, userAddress, permissions } = request.params;\n\n      // Use SDK to add file with permissions\n      const result = await sdk.data.addFileWithPermissions(\n        url,\n        userAddress,\n        permissions,\n      );\n\n      // Wait for transaction events to get fileId\n      const eventData = await sdk.waitForTransactionEvents(result);\n      const fileId = eventData.expectedEvents?.FileAdded?.fileId;\n\n      if (!fileId) {\n        throw new Error(\"Failed to get fileId from transaction events\");\n      }\n\n      return {\n        type: \"direct\",\n        result: {\n          fileId: Number(fileId),\n          transactionHash: result.hash,\n        },\n      };\n    }\n\n    case \"submitFileAdditionComplete\": {\n      const { url, userAddress, permissions, schemaId, ownerAddress } =\n        request.params;\n\n      // Map permissions from relayer format to SDK format\n      const sdkPermissions = permissions.map((p) => ({\n        account: p.account,\n        publicKey: p.key, // Map 'key' to 'publicKey'\n      }));\n\n      // Use SDK to add file with permissions and schema\n      const result = await sdk.data.addFileWithPermissionsAndSchema(\n        url,\n        ownerAddress ?? userAddress,\n        sdkPermissions,\n        schemaId,\n      );\n\n      // Wait for transaction events to get fileId\n      const eventData = await sdk.waitForTransactionEvents(result);\n      const fileId = eventData.expectedEvents?.FileAdded?.fileId;\n\n      if (!fileId) {\n        throw new Error(\"Failed to get fileId from transaction events\");\n      }\n\n      return {\n        type: \"direct\",\n        result: {\n          fileId: Number(fileId),\n          transactionHash: result.hash,\n        },\n      };\n    }\n\n    case \"storeGrantFile\": {\n      const grantFile = request.params;\n\n      // Store grant file using SDK's data controller\n      // Convert grant file to blob for storage\n      const blob = new Blob([JSON.stringify(grantFile)], {\n        type: \"application/json\",\n      });\n\n      // Upload using the data controller\n      const result = await sdk.data.upload({\n        content: blob,\n        filename: `grant-${Date.now()}.json`,\n      });\n\n      return {\n        type: \"direct\",\n        result: { url: result.url },\n      };\n    }\n\n    default: {\n      // TypeScript exhaustiveness check - ensures all cases are handled at compile time\n      const exhaustiveCheck: never = request;\n      // Return exhaustiveCheck to satisfy TypeScript while throwing an error\n      // This should never be reached if all cases are handled\n      return exhaustiveCheck;\n    }\n  }\n}\n\n// Legacy handler export - DEPRECATED\n// TODO: Remove in next major version\n// Migration guide: Use handleRelayerOperation instead\nexport { handleRelayerRequest } from \"./handler\";\n"],"mappings":"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","names":[]}

package/dist/server/relayerHandler.d.ts

@@ -0,0 +1,37 @@
+import type { VanaInstance } from "../index.node";
+import type { UnifiedRelayerRequest, UnifiedRelayerResponse } from "../types/relayer";
+/**
+ * Universal handler for all relayer operations.
+ *
+ * This function processes both EIP-712 signed operations and direct operations,
+ * automatically routing to the appropriate SDK methods.
+ *
+ * @param sdk - Initialized Vana SDK instance
+ * @param request - The unified relayer request
+ * @returns Promise resolving to operation-specific response
+ *
+ * @category Server
+ * @example
+ * ```typescript
+ * // In your server endpoint (Next.js example):
+ * import { handleRelayerOperation } from '@opendatalabs/vana-sdk/node';
+ *
+ * export async function POST(request: NextRequest) {
+ *   try {
+ *     const body = await request.json();
+ *     const vana = getServerVanaInstance(); // Your server SDK instance
+ *
+ *     const result = await handleRelayerOperation(vana, body);
+ *
+ *     return NextResponse.json(result);
+ *   } catch (error) {
+ *     return NextResponse.json(
+ *       { error: error.message },
+ *       { status: 500 }
+ *     );
+ *   }
+ * }
+ * ```
+ */
+export declare function handleRelayerOperation(sdk: VanaInstance, request: UnifiedRelayerRequest): Promise<UnifiedRelayerResponse>;
+export { handleRelayerRequest } from "./handler";