@opendatalabs/vana-sdk 2.3.0 → 3.0.1

package/dist/types/options.d.ts

@@ -1,308 +0,0 @@
-/**
- * @file Standard option types for Vana SDK methods
- * @module vana-sdk/types/options
- */
-/**
- * Transaction options for blockchain write operations.
- *
- * @remarks
- * Aligned with viem's transaction parameters for consistency.
- * These options control gas pricing, limits, polling behavior, and other transaction-specific settings.
- *
- * @example
- * ```typescript
- * // Basic usage with gas options
- * await vana.data.upload(params, {
- *   gas: 1000000n,
- *   maxFeePerGas: 20000000000n
- * });
- *
- * // With status updates for long-running operations
- * await vana.permissions.grant({ grantee: '0x...' }, {
- *   onStatusUpdate: (status) => {
- *     if (status.type === 'queued') {
- *       console.log(`Position in queue: ${status.position}`);
- *     }
- *   }
- * });
- *
- * // With cancellation support
- * const controller = new AbortController();
- * const promise = vana.permissions.grant({ grantee: '0x...' }, {
- *   signal: controller.signal
- * });
- * // Cancel after 30 seconds
- * setTimeout(() => controller.abort(), 30000);
- * ```
- *
- * @category Options
- */
-export interface TransactionOptions {
-    /** Gas limit for the transaction */
-    gas?: bigint;
-    /** Gas price in wei (for legacy transactions) */
-    gasPrice?: bigint;
-    /** Maximum fee per gas in wei (EIP-1559) */
-    maxFeePerGas?: bigint;
-    /** Maximum priority fee per gas in wei (EIP-1559) */
-    maxPriorityFeePerGas?: bigint;
-    /** Transaction nonce override */
-    nonce?: number;
-    /** ETH value to send with transaction */
-    value?: bigint;
-    /**
-     * AbortSignal for cancelling long-running operations.
-     *
-     * @remarks
-     * Useful for cancelling pending transactions or polling operations.
-     * When aborted, the operation will throw an error immediately.
-     */
-    signal?: AbortSignal;
-    /**
-     * Callback for receiving status updates during long-running operations.
-     *
-     * @remarks
-     * Called whenever the operation status changes (e.g., from pending to queued).
-     * Useful for showing progress in UI during multi-minute operations.
-     *
-     * @param status - The current operation status
-     */
-    onStatusUpdate?: (status: OperationStatus) => void;
-    /**
-     * Custom polling options for long-running operations.
-     *
-     * @remarks
-     * Overrides default polling behavior for operations that use the relayer.
-     * Generally not needed unless you have specific timing requirements.
-     */
-    pollingOptions?: {
-        /** Total timeout in milliseconds (default: 300000 = 5 min) */
-        timeout?: number;
-        /** Initial polling interval in milliseconds (default: 1000) */
-        initialInterval?: number;
-        /** Maximum polling interval in milliseconds (default: 10000) */
-        maxInterval?: number;
-    };
-}
-/**
- * Represents the current status of a blockchain operation.
- *
- * @remarks
- * Used for status updates during long-running operations via the onStatusUpdate callback.
- * Provides detailed information about the operation's progress through its lifecycle.
- *
- * @category Options
- */
-export type OperationStatus = {
-    /** Operation is pending, not yet processed */
-    type: "pending";
-    /** The operation ID for tracking */
-    operationId: string;
-} | {
-    /** Operation is queued for processing */
-    type: "queued";
-    /** Position in the processing queue */
-    position?: number;
-    /** Estimated wait time in seconds */
-    estimatedWait?: number;
-} | {
-    /** Operation is actively being processed */
-    type: "processing";
-} | {
-    /** Transaction has been submitted to blockchain */
-    type: "submitted";
-    /** The transaction hash */
-    hash: `0x${string}`;
-} | {
-    /** Transaction has been confirmed on-chain */
-    type: "confirmed";
-    /** The transaction hash */
-    hash: `0x${string}`;
-    /** The transaction receipt if available */
-    receipt?: unknown;
-} | {
-    /** Operation failed with an error */
-    type: "failed";
-    /** Error message describing the failure */
-    error: string;
-    /** Operation ID if available for recovery */
-    operationId?: string;
-};
-/**
- * Source selection for data queries.
- *
- * @remarks
- * - `chain`: Query directly from blockchain (immediate consistency)
- * - `subgraph`: Query from indexed subgraph (may lag 15-60s)
- * - `auto`: SDK chooses optimal source (default)
- *
- * @category Options
- */
-export type DataSource = "chain" | "subgraph" | "auto";
-/**
- * Consistency options for read operations.
- *
- * @remarks
- * Controls data freshness requirements and source selection.
- * Essential for read-after-write consistency when data must reflect recent transactions.
- *
- * @example
- * ```typescript
- * // Ensure data includes a recent transaction
- * const files = await vana.data.getUserFiles({ owner }, {
- *   minBlock: receipt.blockNumber,
- *   waitForSync: 30000  // Wait up to 30s
- * });
- * ```
- *
- * @category Options
- */
-export interface ConsistencyOptions {
-    /**
-     * Minimum block number the data source must have indexed.
-     *
-     * @remarks
-     * Operation will fail or wait (if waitForSync set) until source reaches this block.
-     * Critical for ensuring recently created data is visible.
-     */
-    minBlock?: number;
-    /**
-     * Maximum milliseconds to wait for data source to sync to minBlock.
-     *
-     * @remarks
-     * If not set, operation fails immediately when source is behind.
-     * Useful for critical operations where waiting is preferable to failure.
-     *
-     * @default undefined (no waiting)
-     */
-    waitForSync?: number;
-    /**
-     * Explicitly select data source.
-     *
-     * @remarks
-     * Useful for debugging or when specific consistency guarantees are needed.
-     * Not all methods support all sources - unsupported selections will error.
-     *
-     * @default 'auto'
-     */
-    source?: DataSource;
-    /**
-     * AbortSignal for cancelling long-running operations.
-     *
-     * @remarks
-     * Particularly useful with waitForSync to cancel polling operations.
-     * Properly cleans up timers and pending requests when aborted.
-     *
-     * @example
-     * ```typescript
-     * const controller = new AbortController();
-     * const promise = vana.data.getUserFiles(
-     *   { owner },
-     *   { waitForSync: 30000, signal: controller.signal }
-     * );
-     *
-     * // Cancel after 5 seconds
-     * setTimeout(() => controller.abort(), 5000);
-     * ```
-     */
-    signal?: AbortSignal;
-}
-/**
- * Pagination options for list operations.
- *
- * @remarks
- * Controls result set size, ordering, and pagination.
- * By default returns first 100 items to prevent accidental large fetches.
- *
- * @example
- * ```typescript
- * // Get all files (explicit opt-in)
- * const allFiles = await vana.data.getUserFiles({ owner }, {
- *   fetchAll: true
- * });
- *
- * // Get 10 most recent files
- * const recentFiles = await vana.data.getUserFiles({ owner }, {
- *   limit: 10,
- *   orderBy: 'addedAtBlock',
- *   orderDirection: 'desc'
- * });
- * ```
- *
- * @category Options
- */
-export interface PaginationOptions {
-    /**
-     * Maximum number of items to return.
-     *
-     * @remarks
-     * Prevents accidental large fetches. Use fetchAll: true for unlimited.
-     *
-     * @default 100
-     */
-    limit?: number;
-    /**
-     * Number of items to skip (for manual pagination).
-     *
-     * @default 0
-     */
-    offset?: number;
-    /**
-     * Field to order results by.
-     *
-     * @remarks
-     * Field names depend on the entity type.
-     * Common: 'id', 'addedAtBlock', 'addedAtTimestamp'
-     */
-    orderBy?: string;
-    /**
-     * Sort direction for orderBy field.
-     *
-     * @default 'desc' for timestamp/block fields, 'asc' for others
-     */
-    orderDirection?: "asc" | "desc";
-    /**
-     * Explicitly fetch all available items.
-     *
-     * @remarks
-     * Override safety limit. SDK will paginate internally to fetch all results.
-     * Use with caution - can result in many API calls and large memory usage.
-     *
-     * @default false
-     */
-    fetchAll?: boolean;
-}
-/**
- * Combined options for read operations that return lists.
- *
- * @remarks
- * Convenience type combining consistency and pagination controls.
- *
- * @category Options
- */
-export type ListOptions = ConsistencyOptions & PaginationOptions;
-/**
- * Combined options for write operations that may read data.
- *
- * @remarks
- * Some write operations need to read data (e.g., schema validation).
- * This type combines transaction and consistency options.
- *
- * @category Options
- */
-export type WriteOptions = TransactionOptions & ConsistencyOptions;
-/**
- * Legacy transaction options type for backwards compatibility.
- *
- * @deprecated Use TransactionOptions instead. Will be removed in next major version.
- * @category Options
- */
-export interface LegacyTransactionOptions {
-    /** @deprecated Use `gas` instead */
-    gasLimit?: bigint;
-    gasPrice?: bigint;
-    maxFeePerGas?: bigint;
-    maxPriorityFeePerGas?: bigint;
-    nonce?: number;
-    value?: bigint;
-}

package/dist/types/options.js

@@ -1 +0,0 @@
-//# sourceMappingURL=options.js.map

package/dist/types/options.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types/permissions.cjs

@@ -1,17 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-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 permissions_exports = {};
-module.exports = __toCommonJS(permissions_exports);
-//# sourceMappingURL=permissions.cjs.map

package/dist/types/permissions.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/types/permissions.ts"],"sourcesContent":["import type { Address, Hash } from \"viem\";\n\n/**\n * Base interface for types that need to be compatible with Record<string, unknown>\n *\n * @category Permissions\n */\nexport interface RecordCompatible {\n  [key: string]: unknown;\n}\n\n/**\n * Contains on-chain permission data for efficient retrieval.\n *\n * @remarks\n * Provides fast access to permission metadata from subgraph without\n * IPFS calls. For detailed parameters, resolve `grantUrl` separately.\n *\n * @category Permissions\n * @example\n * ```typescript\n * const grants = await vana.permissions.getUserPermissionGrantsOnChain();\n *\n * // Resolve details when needed\n * const details = await retrieveGrantFile(grants[0].grantUrl);\n * console.log(`Operation: ${details.operation}`);\n * ```\n */\nexport interface OnChainPermissionGrant {\n  /** Unique identifier for the permission */\n  id: bigint;\n  /** The grant URL containing detailed permission parameters (IPFS link) */\n  grantUrl: string;\n  /** Cryptographic signature that authorized this permission */\n  grantSignature: string;\n  /** Nonce used when granting the permission */\n  nonce: bigint;\n  /** Block number when permission started */\n  startBlock: bigint;\n  /** Block number when permission ends (0 or MAX_UINT256 means no expiry) */\n  endBlock: bigint;\n  /** Block number when permission was granted */\n  addedAtBlock: bigint;\n  /** Timestamp when permission was added */\n  addedAtTimestamp: bigint;\n  /** Transaction hash of the grant transaction */\n  transactionHash: string;\n  /** Address that granted the permission */\n  grantor: Address;\n  /** Grantee information */\n  grantee: {\n    /** Grantee ID */\n    id: string;\n    /** Grantee address */\n    address: string;\n  };\n  /** Whether the permission is still active (not revoked) */\n  active: boolean;\n}\n\n/**\n * Options for retrieving user permissions\n *\n * @category Permissions\n */\nexport interface GetUserPermissionsOptions {\n  /** Maximum number of permissions to retrieve */\n  limit?: number;\n  /** Whether to fetch all permissions (ignores limit) */\n  fetchAll?: boolean;\n  /** Custom subgraph URL to use for querying */\n  subgraphUrl?: string;\n}\n\n/**\n * Defines parameters for granting file access permissions.\n *\n * @remarks\n * Specifies application, operation, files, and parameters for\n * permission grants via `vana.permissions.grant()`.\n *\n * @category Permissions\n * @example\n * ```typescript\n * const params: GrantPermissionParams = {\n *   grantee: '0x1234...',\n *   operation: 'llm_inference',\n *   files: [1, 2, 3],\n *   parameters: { model: 'gpt-4', maxTokens: 1000 }\n * };\n * const result = await vana.permissions.grant(params);\n * ```\n */\nexport interface GrantPermissionParams {\n  /** The on-chain identity of the application */\n  grantee: Address;\n  /** The class of computation, e.g., \"llm_inference\" */\n  operation: string;\n  /**\n   * Array of file IDs to grant permission for.\n   * Obtain file IDs from `vana.data.getUserFiles()` or from upload results via `vana.data.upload().fileId`.\n   */\n  files: number[];\n  /** The full, off-chain parameters (e.g., LLM prompt) */\n  parameters: Record<string, unknown>;\n  /** Optional JSONPath filters to apply to files, keyed by file ID */\n  filters?: Record<string, string>;\n  /** Optional pre-stored grant URL to avoid duplicate IPFS storage */\n  grantUrl?: string;\n  /** Optional nonce for the permission */\n  nonce?: bigint;\n  /** Optional expiration time for the permission */\n  expiresAt?: number;\n}\n\n/**\n * Parameters for revoking a previously granted data access permission.\n *\n * Used with `PermissionsController.revoke()` to remove an application's access\n * to user data. Once revoked, the application can no longer use the permission\n * to access the specified files.\n *\n * @category Permissions\n * @example\n * ```typescript\n * const revokeParams: RevokePermissionParams = {\n *   permissionId: 123n // Permission ID to revoke\n * };\n *\n * await vana.permissions.revoke(revokeParams);\n * ```\n */\nexport interface RevokePermissionParams {\n  /** The permission ID to revoke */\n  permissionId: bigint;\n}\n\n/**\n * Parameters for checking if a specific permission exists and is valid.\n *\n * Used to verify whether an application has active permission to access\n * specific user files for a particular operation before attempting to use the data.\n *\n * @category Permissions\n * @example\n * ```typescript\n * const checkParams: CheckPermissionParams = {\n *   application: '0x1234...', // App address\n *   operation: 'llm_inference',\n *   files: [1, 2, 3], // File IDs to check\n *   parameters: { model: 'gpt-4' }, // Operation parameters\n *   user: '0xabcd...' // Optional specific user\n * };\n *\n * const hasPermission = await vana.permissions.check(checkParams);\n * ```\n */\nexport interface CheckPermissionParams {\n  /** The application address */\n  application: Address;\n  /** The operation type */\n  operation: string;\n  /** The file IDs */\n  files: number[];\n  /** The grant parameters */\n  parameters: Record<string, unknown>;\n  /** The user address */\n  user?: Address;\n}\n\n/**\n * Permission check result\n *\n * @category Permissions\n */\nexport interface PermissionCheckResult {\n  /** Whether the permission exists and is valid */\n  exists: boolean;\n  /** The permission details if it exists */\n  permission?: GrantedPermission;\n  /** Reason why permission is invalid (if applicable) */\n  reason?: string;\n}\n\n/**\n * EIP-712 domain definition for PermissionGrant signatures\n *\n * @category Permissions\n */\nexport interface PermissionGrantDomain {\n  /** Domain name */\n  name: string;\n  /** Domain version */\n  version: string;\n  /** Chain ID */\n  chainId: number;\n  /** Verifying contract address */\n  verifyingContract: Address;\n}\n\n/**\n * EIP-712 Permission message structure (current contract format)\n *\n * @category Permissions\n */\nexport interface PermissionGrantMessage {\n  /** Application address */\n  application: Address;\n  /** File IDs */\n  files: number[];\n  /** Operation type */\n  operation: string;\n  /** Grant URL */\n  grant: string;\n  /** Parameters as JSON string */\n  parameters: string;\n  /** Nonce */\n  nonce: bigint;\n}\n\n/**\n * EIP-712 PermissionInput message structure (new simplified format)\n *\n * @category Permissions\n */\nexport interface PermissionInputMessage extends RecordCompatible {\n  /** Nonce */\n  nonce: bigint;\n  /** Grantee ID */\n  granteeId: bigint;\n  /** Grant URL */\n  grant: string;\n  /** File IDs */\n  fileIds: bigint[];\n}\n\n/**\n * Contract PermissionInput structure\n *\n * @category Permissions\n */\nexport interface PermissionInput {\n  /** Nonce */\n  nonce: bigint;\n  /** Grantee ID */\n  granteeId: bigint;\n  /** Grant URL */\n  grant: string;\n  /** File IDs to grant permission for */\n  fileIds: bigint[];\n}\n\n/**\n * Contract RevokePermissionInput structure\n *\n * @category Permissions\n */\nexport interface RevokePermissionInput extends RecordCompatible {\n  /** Nonce */\n  nonce: bigint;\n  /** Permission ID to revoke */\n  permissionId: bigint;\n}\n\n/**\n * Contract Permission Info structure returned from the contract\n *\n * @category Permissions\n */\nexport interface PermissionInfo {\n  /** Permission ID */\n  id: bigint;\n  /** Address that granted the permission */\n  grantor: Address;\n  /** Nonce used when creating */\n  nonce: bigint;\n  /** Grantee ID */\n  granteeId: bigint;\n  /** Grant URL */\n  grant: string;\n  /** Signature bytes (removed in newer contract versions) */\n  signature?: `0x${string}`;\n  /** Start block */\n  startBlock: bigint;\n  /** End block */\n  endBlock: bigint;\n  /** File IDs associated with this permission */\n  fileIds: readonly bigint[];\n}\n\n/**\n * EIP-712 Permission message structure (simplified future format)\n *\n * @category Permissions\n */\nexport interface SimplifiedPermissionMessage {\n  /** Application address */\n  application: Address;\n  /** Grant URL */\n  grant: string;\n  /** Nonce */\n  nonce: bigint;\n}\n\n/**\n * Grant file structure containing permission details.\n *\n * Grant files contain the complete specification of what an application is permitted\n * to do with user data, including operation parameters and file access rights.\n *\n * @category Permissions\n * @example\n * ```typescript\n * const grantFile: GrantFile = {\n *   grantee: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',\n *   operation: 'llm_inference',\n *   parameters: {\n *     prompt: 'Analyze this data: {{data}}',\n *     model: 'gpt-4',\n *     maxTokens: 2000,\n *     temperature: 0.7\n *   },\n *   expires: 1736467579\n * };\n * ```\n */\nexport interface GrantFile {\n  /** EVM address of the application authorized to use this grant */\n  grantee: Address;\n  /** Operation the grantee is authorized to perform */\n  operation: string;\n  /** Operation-specific parameters */\n  parameters: Record<string, unknown>;\n  /** Optional Unix timestamp when grant expires (seconds since epoch per POSIX.1-2008) */\n  expires?: number;\n}\n\n/**\n * EIP-712 typed data structure for Permission\n *\n * @category Permissions\n */\nexport interface PermissionGrantTypedData extends GenericTypedData {\n  /** EIP-712 types */\n  types: {\n    Permission: Array<{\n      name: string;\n      type: string;\n    }>;\n  };\n  /** Primary type */\n  primaryType: \"Permission\";\n  /** Message to sign */\n  message: PermissionInputMessage;\n}\n\n/**\n * Generic EIP-712 typed data structure\n *\n * @category Permissions\n */\nexport interface GenericTypedData extends RecordCompatible {\n  /** EIP-712 domain */\n  domain: PermissionGrantDomain;\n  /** EIP-712 types */\n  types: Record<string, Array<{ name: string; type: string }>>;\n  /** Primary type */\n  primaryType: string;\n  /** Message to sign */\n  message: Record<string, unknown>;\n}\n\n/**\n * Represents EIP-712 typed data for permission revocation.\n *\n * @remarks\n * Used when revoking previously granted permissions through gasless transactions.\n * The message contains a nonce and the permission ID to revoke.\n *\n * @category Permissions\n */\nexport interface RevokePermissionTypedData extends GenericTypedData {\n  /** EIP-712 type definitions for the RevokePermission structure */\n  types: {\n    RevokePermission: Array<{\n      name: string;\n      type: string;\n    }>;\n  };\n  /** The primary type identifier for revocation operations */\n  primaryType: \"RevokePermission\";\n  /** The structured message containing revocation parameters */\n  message: RevokePermissionInput;\n}\n\n/**\n * Defines all valid primary types for EIP-712 typed data in the Vana SDK.\n *\n * @remarks\n * These literal types ensure compile-time safety when handling typed data operations.\n * Each corresponds to a specific blockchain operation type.\n *\n * @category Permissions\n */\nexport type TypedDataPrimaryType =\n  | \"Permission\"\n  | \"RevokePermission\"\n  | \"TrustServer\"\n  | \"UntrustServer\"\n  | \"AddServer\"\n  | \"RegisterGrantee\"\n  | \"ServerFilesAndPermission\";\n\n/**\n * Represents the union of all specific typed data interfaces.\n *\n * @remarks\n * Enables type-safe handling of any typed data structure in the SDK.\n * Used internally by relayer handlers and signature verification.\n *\n * @category Permissions\n */\nexport type SpecificTypedData =\n  | PermissionGrantTypedData\n  | RevokePermissionTypedData\n  | TrustServerTypedData\n  | UntrustServerTypedData\n  | AddAndTrustServerTypedData\n  | RegisterGranteeTypedData\n  | ServerFilesAndPermissionTypedData;\n\n/**\n * Permission operation types\n *\n * @category Permissions\n */\nexport type PermissionOperation =\n  | \"llm_inference\"\n  | \"data_analysis\"\n  | \"model_training\"\n  | \"data_sharing\"\n  | \"compute_task\"\n  | string;\n\n/**\n * Permission status\n *\n * @category Permissions\n */\nexport type PermissionStatus = \"active\" | \"revoked\" | \"expired\" | \"pending\";\n\n/**\n * Parameters for querying permissions\n *\n * @category Permissions\n */\nexport interface QueryPermissionsParams {\n  /** Filter by grantor address */\n  grantor?: Address;\n  /** Filter by grantee address */\n  grantee?: Address;\n  /** Filter by operation type */\n  operation?: PermissionOperation;\n  /** Filter by file IDs */\n  files?: number[];\n  /** Filter by status */\n  status?: PermissionStatus;\n  /** Starting block number */\n  fromBlock?: bigint;\n  /** Ending block number */\n  toBlock?: bigint;\n  /** Maximum number of results */\n  limit?: number;\n  /** Offset for pagination */\n  offset?: number;\n}\n\n/**\n * Granted permission details\n *\n * @category Permissions\n */\nexport interface GrantedPermission {\n  /** Unique identifier for the permission */\n  id: bigint;\n  /** Array of file IDs that the permission applies to */\n  files: number[];\n  /** The type of operation being granted permission for */\n  operation: string;\n  /** Grant file reference (IPFS hash or URL) */\n  grant: string;\n  /** Address of the application granted permission */\n  grantee: Address;\n  /** Address of the user who granted permission */\n  grantor: Address;\n  /** Custom parameters for the operation */\n  parameters: Record<string, unknown>;\n  /** Whether the permission is still active */\n  active: boolean;\n  /** Data status for the permission */\n  dataStatus?: string;\n  /** Nonce used for the permission */\n  nonce?: number;\n  /** Timestamp when permission was granted */\n  grantedAt?: number;\n  /** Optional expiration timestamp */\n  expiresAt?: number;\n  /** Transaction hash of the grant transaction */\n  transactionHash?: string;\n  /** Block number when permission was granted */\n  blockNumber?: bigint;\n}\n\n/**\n * Permission query result\n *\n * @category Permissions\n */\nexport interface PermissionQueryResult {\n  /** Array of permissions matching the query */\n  permissions: GrantedPermission[];\n  /** Total number of permissions (for pagination) */\n  total: number;\n  /** Whether there are more results available */\n  hasMore: boolean;\n}\n\n/**\n * Permission analytics data\n *\n * @category Permissions\n */\nexport interface PermissionAnalytics {\n  /** Total number of permissions granted */\n  totalPermissions: number;\n  /** Number of active permissions */\n  activePermissions: number;\n  /** Number of revoked permissions */\n  revokedPermissions: number;\n  /** Number of expired permissions */\n  expiredPermissions: number;\n  /** Most common operation types */\n  topOperations: Array<{\n    operation: PermissionOperation;\n    count: number;\n  }>;\n  /** Most active applications */\n  topApplications: Array<{\n    application: Address;\n    count: number;\n  }>;\n}\n\n/**\n * Server information\n *\n * @category Permissions\n */\nexport interface Server {\n  /** Server ID (numeric) */\n  id: number;\n  /** Server owner address */\n  owner: Address;\n  /** Server URL */\n  url: string;\n  /** Server address */\n  serverAddress: Address;\n  /** Server public key */\n  publicKey: string;\n}\n\n/**\n * Contract ServerInfo structure returned from the contract\n *\n * @category Permissions\n */\nexport interface ServerInfo {\n  /** Server ID */\n  id: bigint;\n  /** Server owner address */\n  owner: Address;\n  /** Server address */\n  serverAddress: Address;\n  /** Server public key */\n  publicKey: string;\n  /** Server URL */\n  url: string;\n}\n\n/**\n * Parameters for adding and trusting a server\n *\n * @category Permissions\n */\nexport interface AddAndTrustServerParams {\n  /** Server address */\n  serverAddress: Address;\n  /** Server URL */\n  serverUrl: string;\n  /** Server public key */\n  publicKey: string;\n}\n\n/**\n * Parameters for trusting a server (legacy)\n *\n * @category Permissions\n * @deprecated Use AddAndTrustServerParams instead\n */\nexport interface TrustServerParams {\n  /** Server ID (numeric) */\n  serverId: number;\n}\n\n/**\n * Parameters for untrusting a server\n *\n * @category Permissions\n */\nexport interface UntrustServerParams {\n  /** Server ID (numeric) */\n  serverId: number;\n}\n\n/**\n * Input for adding and trusting a server with signature (gasless)\n *\n * @category Permissions\n */\nexport interface AddAndTrustServerInput extends RecordCompatible {\n  /** User nonce */\n  nonce: bigint;\n  /** Server address */\n  serverAddress: Address;\n  /** Server URL */\n  serverUrl: string;\n  /** Server public key */\n  publicKey: string;\n}\n\n/**\n * Input for trusting a server with signature (gasless)\n *\n * @category Permissions\n * @deprecated Use AddAndTrustServerInput instead\n */\nexport interface TrustServerInput extends RecordCompatible {\n  /** User nonce */\n  nonce: bigint;\n  /** Server ID (numeric) */\n  serverId: number;\n}\n\n/**\n * Input for untrusting a server with signature (gasless)\n *\n * @category Permissions\n */\nexport interface UntrustServerInput extends RecordCompatible {\n  /** User nonce */\n  nonce: bigint;\n  /** Server ID (numeric) */\n  serverId: number;\n}\n\n/**\n * EIP-712 typed data for AddAndTrustServer\n *\n * @category Permissions\n */\nexport interface AddAndTrustServerTypedData extends GenericTypedData {\n  /** EIP-712 types */\n  types: {\n    AddServer: Array<{\n      name: string;\n      type: string;\n    }>;\n  };\n  /** Primary type */\n  primaryType: \"AddServer\";\n  /** Message to sign */\n  message: AddAndTrustServerInput;\n}\n\n/**\n * EIP-712 typed data for TrustServer\n *\n * @category Permissions\n * @deprecated Use AddAndTrustServerTypedData instead\n */\nexport interface TrustServerTypedData extends GenericTypedData {\n  /** EIP-712 types */\n  types: {\n    TrustServer: Array<{\n      name: string;\n      type: string;\n    }>;\n  };\n  /** Primary type */\n  primaryType: \"TrustServer\";\n  /** Message to sign */\n  message: TrustServerInput;\n}\n\n/**\n * EIP-712 typed data for UntrustServer\n *\n * @category Permissions\n */\nexport interface UntrustServerTypedData extends GenericTypedData {\n  /** EIP-712 types */\n  types: {\n    UntrustServer: Array<{\n      name: string;\n      type: string;\n    }>;\n  };\n  /** Primary type */\n  primaryType: \"UntrustServer\";\n  /** Message to sign */\n  message: UntrustServerInput;\n}\n\n/**\n * Permission event data\n *\n * @category Permissions\n */\nexport interface PermissionEvent {\n  /** Event type */\n  type: \"granted\" | \"revoked\" | \"expired\";\n  /** Permission details */\n  permission: GrantedPermission;\n  /** Block number where event occurred */\n  blockNumber: bigint;\n  /** Transaction hash */\n  transactionHash: Hash;\n  /** Event timestamp */\n  timestamp: number;\n}\n\n/**\n * Enhanced trusted server information with trust status\n *\n * @category Permissions\n */\nexport interface TrustedServerInfo {\n  /** Server ID */\n  id: bigint;\n  /** Server owner address */\n  owner: Address;\n  /** Server address */\n  serverAddress: Address;\n  /** Server public key */\n  publicKey: string;\n  /** Server URL */\n  url: string;\n  /** Start block when trust relationship began */\n  startBlock: bigint;\n  /** End block when trust relationship ended (0 if still active) */\n  endBlock: bigint;\n}\n\n/**\n * Paginated result for trusted server queries\n *\n * @category Permissions\n */\nexport interface PaginatedTrustedServers {\n  /** Array of server IDs (numeric) */\n  servers: number[];\n  /** Total number of trusted servers */\n  total: number;\n  /** Offset used for this query */\n  offset: number;\n  /** Limit used for this query */\n  limit: number;\n  /** Whether there are more servers beyond this page */\n  hasMore: boolean;\n}\n\n/**\n * Options for querying trusted servers\n *\n * @category Permissions\n */\nexport interface TrustedServerQueryOptions {\n  /** User address to query (defaults to current user) */\n  userAddress?: Address;\n  /** Maximum number of servers to return */\n  limit?: number;\n  /** Offset for pagination */\n  offset?: number;\n  /** Whether to include full server info or just IDs */\n  includeServerInfo?: boolean;\n}\n\n/**\n * Result of batch server info requests\n *\n * @category Permissions\n */\nexport interface BatchServerInfoResult {\n  /** Successfully retrieved server info */\n  servers: Map<number, Server>;\n  /** Server IDs that failed to retrieve */\n  failed: number[];\n}\n\n/**\n * Server trust status information\n *\n * @category Permissions\n */\nexport interface ServerTrustStatus {\n  /** Server ID being checked (numeric) */\n  serverId: number;\n  /** Whether the server is trusted by the user */\n  isTrusted: boolean;\n  /** Index in user's trusted server list (if trusted) */\n  trustIndex?: number;\n}\n\n/**\n * Grantee information\n *\n * @category Permissions\n */\nexport interface Grantee {\n  /** Grantee ID (numeric) */\n  id: number;\n  /** Grantee owner address */\n  owner: Address;\n  /** Grantee address */\n  address: Address;\n  /** Grantee public key */\n  publicKey: string;\n  /** Permission IDs associated with this grantee */\n  permissionIds: number[];\n}\n\n/**\n * Contract GranteeInfo structure returned from the contract\n *\n * @category Permissions\n */\nexport interface GranteeInfo {\n  /** Grantee owner address */\n  owner: Address;\n  /** Grantee address */\n  granteeAddress: Address;\n  /** Grantee public key */\n  publicKey: string;\n  /** Permission IDs associated with this grantee */\n  permissionIds: readonly bigint[];\n}\n\n/**\n * Parameters for registering a grantee\n *\n * @category Permissions\n */\nexport interface RegisterGranteeParams {\n  /** Grantee owner address */\n  owner: Address;\n  /** Grantee address */\n  granteeAddress: Address;\n  /** Grantee public key */\n  publicKey: string;\n}\n\n/**\n * Input for registering a grantee with signature (gasless)\n *\n * @category Permissions\n */\nexport interface RegisterGranteeInput extends RecordCompatible {\n  /** User nonce */\n  nonce: bigint;\n  /** Grantee owner address */\n  owner: Address;\n  /** Grantee address */\n  granteeAddress: Address;\n  /** Grantee public key */\n  publicKey: string;\n}\n\n/**\n * EIP-712 typed data for RegisterGrantee\n *\n * @category Permissions\n */\nexport interface RegisterGranteeTypedData extends GenericTypedData {\n  /** EIP-712 types */\n  types: {\n    RegisterGrantee: Array<{\n      name: string;\n      type: string;\n    }>;\n  };\n  /** Primary type */\n  primaryType: \"RegisterGrantee\";\n  /** Message to sign */\n  message: RegisterGranteeInput;\n}\n\n/**\n * Options for querying grantees\n *\n * @category Permissions\n */\nexport interface GranteeQueryOptions {\n  /** Maximum number of grantees to return */\n  limit?: number;\n  /** Offset for pagination */\n  offset?: number;\n  /** Whether to include permission info or just basic info */\n  includePermissions?: boolean;\n}\n\n/**\n * Paginated result for grantee queries\n *\n * @category Permissions\n */\nexport interface PaginatedGrantees {\n  /** Array of grantees */\n  grantees: Grantee[];\n  /** Total number of grantees */\n  total: number;\n  /** Offset used for this query */\n  offset: number;\n  /** Limit used for this query */\n  limit: number;\n  /** Whether there are more grantees beyond this page */\n  hasMore: boolean;\n}\n\n/**\n * Contract Permission structure as used in ServerFilesAndPermissionInput\n *\n * @category Permissions\n */\nexport interface Permission {\n  /** Account address for the permission */\n  account: Address;\n  /** Permission key */\n  key: string;\n}\n\n/**\n * Contract ServerFilesAndPermissionInput structure\n *\n * @category Permissions\n */\nexport interface ServerFilesAndPermissionInput {\n  /** User nonce */\n  nonce: bigint;\n  /** Grantee ID */\n  granteeId: bigint;\n  /** Grant URL */\n  grant: string;\n  /** File URLs */\n  fileUrls: string[];\n  /** Server address */\n  serverAddress: Address;\n  /** Server URL */\n  serverUrl: string;\n  /** Server public key */\n  serverPublicKey: string;\n  /** File permissions array - permissions for each file */\n  filePermissions: Permission[][];\n}\n\n/**\n * Parameters for server files and permissions operations\n *\n * @category Permissions\n */\nexport interface ServerFilesAndPermissionParams {\n  /** Grantee ID */\n  granteeId: bigint;\n  /** Grant URL or grant data */\n  grant: string;\n  /** File URLs */\n  fileUrls: string[];\n  /** Schema IDs for each file - use 0 for files without schema validation */\n  schemaIds: number[];\n  /** Server address */\n  serverAddress: Address;\n  /** Server URL */\n  serverUrl: string;\n  /** Server public key */\n  serverPublicKey: string;\n  /** File permissions array - permissions for each file */\n  filePermissions: Permission[][];\n}\n\n/**\n * EIP-712 typed data for server files and permissions messages\n *\n * @category Permissions\n */\nexport interface ServerFilesAndPermissionTypedData extends GenericTypedData {\n  /** Message data structure */\n  message: {\n    /** User nonce */\n    nonce: bigint;\n    /** Grantee ID */\n    granteeId: bigint;\n    /** Grant URL */\n    grant: string;\n    /** File URLs */\n    fileUrls: string[];\n    /** Schema IDs for each file - use 0 for files without schema validation */\n    schemaIds: bigint[];\n    /** Server address */\n    serverAddress: Address;\n    /** Server URL */\n    serverUrl: string;\n    /** Server public key */\n    serverPublicKey: string;\n    /** File permissions array - permissions for each file */\n    filePermissions: Permission[][];\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}