@lukso/transaction-decoder 1.0.1-dev.0f1bea5

package/src/server/types.ts

@@ -0,0 +1,168 @@
+import type { Chain, Transaction } from 'viem'
+import type { DataKey, DecoderResult, EnhancedInfo } from '../types'
+
+/**
+ * Options for server-side decoding
+ */
+export interface ServerDecoderOptions {
+  /**
+   * Total time budget in milliseconds
+   * Default: 800ms
+   */
+  timeoutMs?: number
+
+  /**
+   * Whether to enable Phase 2 (ABI fetching and enhancement)
+   * Default: true
+   */
+  enableEnhancement?: boolean
+
+  /**
+   * Chain to decode for
+   */
+  chain: Chain
+}
+
+/**
+ * Configuration for server decoder instance
+ */
+export interface ServerDecoderConfig {
+  /**
+   * GraphQL endpoint for address resolution
+   */
+  graphqlEndpoint: string
+
+  /**
+   * Default chain (can be overridden per request)
+   */
+  defaultChain: Chain
+
+  /**
+   * Size of transaction result cache
+   * Default: 10000
+   */
+  transactionCacheSize?: number
+
+  /**
+   * Size of address metadata cache
+   * Default: 50000
+   */
+  addressCacheSize?: number
+
+  /**
+   * Size of contract ABI cache
+   * Default: 5000
+   */
+  abiCacheSize?: number
+
+  /**
+   * Size of schema decode cache
+   * Default: 10000
+   */
+  schemaCacheSize?: number
+
+  /**
+   * Default timeout for decoding operations
+   * Default: 800ms
+   */
+  defaultTimeout?: number
+}
+
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+  transactions: {
+    size: number
+    maxSize: number
+    hits: number
+    misses: number
+    hitRate: number
+  }
+  addresses: {
+    size: number
+    maxSize: number
+    hits: number
+    misses: number
+    hitRate: number
+  }
+  abis: {
+    size: number
+    maxSize: number
+    hits: number
+    misses: number
+    hitRate: number
+  }
+  schemas: {
+    size: number
+    maxSize: number
+    hits: number
+    misses: number
+    hitRate: number
+  }
+}
+
+/**
+ * Batch decode result
+ */
+export interface BatchDecodeResult {
+  /**
+   * Array of decoded results
+   */
+  results: DecoderResult[]
+}
+
+/**
+ * Server decoder instance interface
+ */
+export interface ServerDecoder {
+  /**
+   * Decode a single transaction
+   */
+  decodeTransaction: (
+    transaction: DecoderResult,
+    options?: Partial<ServerDecoderOptions>
+  ) => Promise<DecoderResult>
+
+  /**
+   * Decode multiple transactions with batching
+   * Returns results with global addressIdentities
+   */
+  decodeTransactionsBatch: (
+    transactions: DecoderResult[],
+    options?: Partial<ServerDecoderOptions>
+  ) => Promise<BatchDecodeResult>
+
+  /**
+   * Finish decoding a transaction (enhance and resolve addresses)
+   * This will update the cache with the fully decoded result
+   */
+  finishDecoding: (
+    transaction: DecoderResult,
+    options?: Partial<ServerDecoderOptions>
+  ) => Promise<DecoderResult>
+
+  /**
+   * Clear all caches
+   */
+  clearCaches: () => void
+
+  /**
+   * Get cache statistics
+   */
+  getCacheStats: () => CacheStats
+
+  /**
+   * Warm up address cache with specific addresses
+   */
+  warmAddressCache: (addresses: DataKey[]) => Promise<void>
+
+  /**
+   * Resolve addresses and return their metadata
+   * Uses cache when available
+   */
+  resolveAddresses: (
+    addresses: DataKey[],
+    timeoutMs?: number
+  ) => Promise<Map<DataKey, EnhancedInfo>>
+}

package/src/server.ts

@@ -0,0 +1,22 @@
+/**
+ * @lukso/decoder/server - Server-side API
+ *
+ * This module exports functions optimized for server-side use with:
+ * - Time-bounded decoding
+ * - Multi-level caching
+ * - No reactive state management
+ * - Batch processing optimizations
+ */
+
+export { ServerAddressResolver } from './server/addressResolver'
+export { ServerDecoderCaches } from './server/caches'
+export { decodeTransactionSync } from './server/decodeTransactionSync'
+export { decodeTransactionsBatch } from './server/decodeTransactionsBatch'
+export { createServerDecoder } from './server/index'
+
+export type {
+  CacheStats,
+  ServerDecoder,
+  ServerDecoderConfig,
+  ServerDecoderOptions,
+} from './server/types'