@opendatalabs/vana-sdk 0.1.0-alpha.7e4db82 → 0.1.0-alpha.7ee7635

package/dist/server/handler.d.cts

@@ -0,0 +1,306 @@
+import { VanaCore } from '../core.cjs';
+import '../types.cjs';
+import '../types/external-apis.cjs';
+import '../generated/abi/index.cjs';
+import '../errors.cjs';
+import '../controllers/permissions.cjs';
+import '../controllers/data.cjs';
+import '../controllers/server.cjs';
+import '../controllers/protocol.cjs';
+import '../controllers/schemas.cjs';
+import '../contracts/contractController.cjs';
+import '../utils/encryption.cjs';
+import '../utils/formatters.cjs';
+import '../utils/grantFiles.cjs';
+import '../utils/grantValidation.cjs';
+import '../utils/grants.cjs';
+import '../utils/ipfs.cjs';
+import '../utils/schemaValidation.cjs';
+import '../utils/signatureCache.cjs';
+import '../types/storage.cjs';
+import '../storage/providers/google-drive.cjs';
+import '../storage/providers/ipfs.cjs';
+import '../storage/providers/pinata.cjs';
+import '../storage/providers/callback-storage.cjs';
+import '../storage/manager.cjs';
+import { VanaConfigWithStorage, VanaConfig, StorageRequiredMarker } from '../types/config.cjs';
+import '../config/addresses.cjs';
+import '../config/chains.cjs';
+import '../chains/definitions.cjs';
+import '../core/generics.cjs';
+import { Hash, Address } from 'viem';
+import { TransactionResult } from '../types/operations.cjs';
+import '../platform/node.cjs';
+import '../platform/browser.cjs';
+import '../platform/interface.cjs';
+import '../platform/utils.cjs';
+import '../platform/browser-safe.cjs';
+import '../core/apiClient.cjs';
+import '../types/chains.cjs';
+import '../types/contracts.cjs';
+import '../types/data.cjs';
+import { GenericTypedData } from '../types/permissions.cjs';
+import '../types/personal.cjs';
+import '../types/relayer.cjs';
+import '../types/utils.cjs';
+import '../types/generics.cjs';
+import '../generated/server/server.cjs';
+import '../generated/server/server-exports.cjs';
+import { PermissionGrantResult, PermissionRevokeResult, ServerTrustResult, ServerUntrustResult, GranteeRegisterResult, FileAddedResult } from '../types/transactionResults.cjs';
+import '../generated/event-types.cjs';
+import '../types/controller-context.cjs';
+import '../generated/abi/ComputeEngineImplementation.cjs';
+import '../generated/abi/DataRegistryImplementation.cjs';
+import '../generated/abi/TeePoolImplementation.cjs';
+import '../generated/abi/TeePoolPhalaImplementation.cjs';
+import '../generated/abi/DataPortabilityPermissionsImplementation.cjs';
+import '../generated/abi/DataPortabilityServersImplementation.cjs';
+import '../generated/abi/DataPortabilityGranteesImplementation.cjs';
+import '../generated/abi/DataRefinerRegistryImplementation.cjs';
+import '../generated/abi/QueryEngineImplementation.cjs';
+import '../generated/abi/ComputeInstructionRegistryImplementation.cjs';
+import '../generated/abi/TeePoolEphemeralStandardImplementation.cjs';
+import '../generated/abi/TeePoolPersistentStandardImplementation.cjs';
+import '../generated/abi/TeePoolPersistentGpuImplementation.cjs';
+import '../generated/abi/TeePoolDedicatedStandardImplementation.cjs';
+import '../generated/abi/TeePoolDedicatedGpuImplementation.cjs';
+import '../generated/abi/VanaEpochImplementation.cjs';
+import '../generated/abi/DLPRegistryImplementation.cjs';
+import '../generated/abi/DLPTreasuryImplementation.cjs';
+import '../generated/abi/DLPRewardDeployerTreasuryImplementation.cjs';
+import '../generated/abi/DLPPerformanceImplementation.cjs';
+import '../generated/abi/DLPRewardDeployerImplementation.cjs';
+import '../generated/abi/DLPRewardSwapImplementation.cjs';
+import '../generated/abi/SwapHelperImplementation.cjs';
+import '../generated/abi/DLPRootImplementation.cjs';
+import '../generated/abi/DataLiquidityPoolImplementation.cjs';
+import '../generated/abi/DLPRegistryTreasuryImplementation.cjs';
+import '../generated/abi/VanaPoolStakingImplementation.cjs';
+import '../generated/abi/VanaPoolEntityImplementation.cjs';
+import '../generated/abi/VanaPoolTreasuryImplementation.cjs';
+import '../generated/abi/DATImplementation.cjs';
+import '../generated/abi/DATFactoryImplementation.cjs';
+import '../generated/abi/DATPausableImplementation.cjs';
+import '../generated/abi/DATVotesImplementation.cjs';
+import 'abitype';
+import '../core/client.cjs';
+
+/** 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
+ */
+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 });
+ *   }
+ * }
+ * ```
+ */
+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.
+ * Uses InstanceType to properly expose all public methods from the class hierarchy.
+ *
+ * @see {@link Vana}
+ */
+type VanaInstance = InstanceType<typeof VanaNodeImpl>;
+
+export { type RelayerRequestPayload, Vana as V, VanaNodeImpl as a, type VanaInstance as b, handleRelayerRequest };

package/dist/server/handler.d.ts

@@ -0,0 +1,306 @@
+import { VanaCore } from '../core.js';
+import '../types.js';
+import '../types/external-apis.js';
+import '../generated/abi/index.js';
+import '../errors.js';
+import '../controllers/permissions.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 { PermissionGrantResult, PermissionRevokeResult, ServerTrustResult, ServerUntrustResult, GranteeRegisterResult, FileAddedResult } from '../types/transactionResults.js';
+import '../generated/event-types.js';
+import '../types/controller-context.js';
+import '../generated/abi/ComputeEngineImplementation.js';
+import '../generated/abi/DataRegistryImplementation.js';
+import '../generated/abi/TeePoolImplementation.js';
+import '../generated/abi/TeePoolPhalaImplementation.js';
+import '../generated/abi/DataPortabilityPermissionsImplementation.js';
+import '../generated/abi/DataPortabilityServersImplementation.js';
+import '../generated/abi/DataPortabilityGranteesImplementation.js';
+import '../generated/abi/DataRefinerRegistryImplementation.js';
+import '../generated/abi/QueryEngineImplementation.js';
+import '../generated/abi/ComputeInstructionRegistryImplementation.js';
+import '../generated/abi/TeePoolEphemeralStandardImplementation.js';
+import '../generated/abi/TeePoolPersistentStandardImplementation.js';
+import '../generated/abi/TeePoolPersistentGpuImplementation.js';
+import '../generated/abi/TeePoolDedicatedStandardImplementation.js';
+import '../generated/abi/TeePoolDedicatedGpuImplementation.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/DLPRewardSwapImplementation.js';
+import '../generated/abi/SwapHelperImplementation.js';
+import '../generated/abi/DLPRootImplementation.js';
+import '../generated/abi/DataLiquidityPoolImplementation.js';
+import '../generated/abi/DLPRegistryTreasuryImplementation.js';
+import '../generated/abi/VanaPoolStakingImplementation.js';
+import '../generated/abi/VanaPoolEntityImplementation.js';
+import '../generated/abi/VanaPoolTreasuryImplementation.js';
+import '../generated/abi/DATImplementation.js';
+import '../generated/abi/DATFactoryImplementation.js';
+import '../generated/abi/DATPausableImplementation.js';
+import '../generated/abi/DATVotesImplementation.js';
+import 'abitype';
+import '../core/client.js';
+
+/** 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
+ */
+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 });
+ *   }
+ * }
+ * ```
+ */
+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.
+ * Uses InstanceType to properly expose all public methods from the class hierarchy.
+ *
+ * @see {@link Vana}
+ */
+type VanaInstance = InstanceType<typeof VanaNodeImpl>;
+
+export { type RelayerRequestPayload, Vana as V, VanaNodeImpl as a, type VanaInstance as b, handleRelayerRequest };

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