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

package/dist/server.d.cts

@@ -0,0 +1,217 @@
+import { Chain, Abi } from 'viem';
+import { b as DecoderResult, c as DataKey, E as EnhancedInfo, e as Info } from './index-BzXh7poJ.cjs';
+import '@preact/signals-core';
+import '@erc725/erc725.js';
+
+/**
+ * Options for server-side decoding
+ */
+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
+ */
+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
+ */
+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
+ */
+interface BatchDecodeResult {
+    /**
+     * Array of decoded results
+     */
+    results: DecoderResult[];
+}
+/**
+ * Server decoder instance interface
+ */
+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>>;
+}
+
+/**
+ * Multi-level caching system for server-side decoder
+ */
+declare class ServerDecoderCaches {
+    private transactionCache;
+    private transactionStats;
+    private addressCache;
+    private addressStats;
+    private abiCache;
+    private abiStats;
+    private schemaCache;
+    private schemaStats;
+    constructor(options?: {
+        transactionCacheSize?: number;
+        addressCacheSize?: number;
+        abiCacheSize?: number;
+        schemaCacheSize?: number;
+    });
+    /**
+     * Get cache key for a data key (address or address:tokenId)
+     */
+    private getDataKeyCacheKey;
+    getTransaction(hash: string): DecoderResult | undefined;
+    setTransaction(hash: string, result: DecoderResult): void;
+    getAddress(key: DataKey): EnhancedInfo | undefined;
+    setAddress(key: DataKey, data: EnhancedInfo): void;
+    hasAddress(key: DataKey): boolean;
+    getAddresses(keys: DataKey[]): Map<DataKey, EnhancedInfo>;
+    getAbi(address: string): Abi | undefined;
+    setAbi(address: string, abi: Abi): void;
+    hasAbi(address: string): boolean;
+    getSchema(key: string, value: string): Info | undefined;
+    setSchema(key: string, value: string, info: Info): void;
+    clear(): void;
+    getStats(): CacheStats;
+}
+
+/**
+ * Server-side address resolver with caching
+ */
+declare class ServerAddressResolver {
+    private graphqlEndpoint;
+    private chain;
+    private caches;
+    private cacheAdapter;
+    constructor(graphqlEndpoint: string, chain: Chain, caches: ServerDecoderCaches);
+    /**
+     * Resolve addresses, using cache when possible
+     */
+    resolveAddresses(addresses: readonly DataKey[]): Promise<Map<DataKey, EnhancedInfo>>;
+    /**
+     * Resolve addresses with timeout
+     */
+    resolveAddressesWithTimeout(addresses: DataKey[], timeoutMs: number): Promise<Map<DataKey, EnhancedInfo>>;
+    /**
+     * Warm the cache with specific addresses
+     */
+    warmCache(addresses: DataKey[]): Promise<void>;
+}
+
+/**
+ * Decode a single transaction with time-bounded enhancement
+ */
+declare function decodeTransactionSync(transaction: DecoderResult, options: ServerDecoderOptions, caches: ServerDecoderCaches): Promise<DecoderResult>;
+
+/**
+ * Decode multiple transactions with batching and time budget
+ */
+declare function decodeTransactionsBatch(transactions: DecoderResult[], options: ServerDecoderOptions, caches: ServerDecoderCaches): Promise<BatchDecodeResult>;
+
+/**
+ * Create a server-optimized decoder instance
+ */
+declare function createServerDecoder(config: ServerDecoderConfig): ServerDecoder;
+
+export { type CacheStats, ServerAddressResolver, type ServerDecoder, ServerDecoderCaches, type ServerDecoderConfig, type ServerDecoderOptions, createServerDecoder, decodeTransactionSync, decodeTransactionsBatch };

package/dist/server.d.ts

@@ -0,0 +1,217 @@
+import { Chain, Abi } from 'viem';
+import { b as DecoderResult, c as DataKey, E as EnhancedInfo, e as Info } from './index-BzXh7poJ.js';
+import '@preact/signals-core';
+import '@erc725/erc725.js';
+
+/**
+ * Options for server-side decoding
+ */
+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
+ */
+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
+ */
+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
+ */
+interface BatchDecodeResult {
+    /**
+     * Array of decoded results
+     */
+    results: DecoderResult[];
+}
+/**
+ * Server decoder instance interface
+ */
+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>>;
+}
+
+/**
+ * Multi-level caching system for server-side decoder
+ */
+declare class ServerDecoderCaches {
+    private transactionCache;
+    private transactionStats;
+    private addressCache;
+    private addressStats;
+    private abiCache;
+    private abiStats;
+    private schemaCache;
+    private schemaStats;
+    constructor(options?: {
+        transactionCacheSize?: number;
+        addressCacheSize?: number;
+        abiCacheSize?: number;
+        schemaCacheSize?: number;
+    });
+    /**
+     * Get cache key for a data key (address or address:tokenId)
+     */
+    private getDataKeyCacheKey;
+    getTransaction(hash: string): DecoderResult | undefined;
+    setTransaction(hash: string, result: DecoderResult): void;
+    getAddress(key: DataKey): EnhancedInfo | undefined;
+    setAddress(key: DataKey, data: EnhancedInfo): void;
+    hasAddress(key: DataKey): boolean;
+    getAddresses(keys: DataKey[]): Map<DataKey, EnhancedInfo>;
+    getAbi(address: string): Abi | undefined;
+    setAbi(address: string, abi: Abi): void;
+    hasAbi(address: string): boolean;
+    getSchema(key: string, value: string): Info | undefined;
+    setSchema(key: string, value: string, info: Info): void;
+    clear(): void;
+    getStats(): CacheStats;
+}
+
+/**
+ * Server-side address resolver with caching
+ */
+declare class ServerAddressResolver {
+    private graphqlEndpoint;
+    private chain;
+    private caches;
+    private cacheAdapter;
+    constructor(graphqlEndpoint: string, chain: Chain, caches: ServerDecoderCaches);
+    /**
+     * Resolve addresses, using cache when possible
+     */
+    resolveAddresses(addresses: readonly DataKey[]): Promise<Map<DataKey, EnhancedInfo>>;
+    /**
+     * Resolve addresses with timeout
+     */
+    resolveAddressesWithTimeout(addresses: DataKey[], timeoutMs: number): Promise<Map<DataKey, EnhancedInfo>>;
+    /**
+     * Warm the cache with specific addresses
+     */
+    warmCache(addresses: DataKey[]): Promise<void>;
+}
+
+/**
+ * Decode a single transaction with time-bounded enhancement
+ */
+declare function decodeTransactionSync(transaction: DecoderResult, options: ServerDecoderOptions, caches: ServerDecoderCaches): Promise<DecoderResult>;
+
+/**
+ * Decode multiple transactions with batching and time budget
+ */
+declare function decodeTransactionsBatch(transactions: DecoderResult[], options: ServerDecoderOptions, caches: ServerDecoderCaches): Promise<BatchDecodeResult>;
+
+/**
+ * Create a server-optimized decoder instance
+ */
+declare function createServerDecoder(config: ServerDecoderConfig): ServerDecoder;
+
+export { type CacheStats, ServerAddressResolver, type ServerDecoder, ServerDecoderCaches, type ServerDecoderConfig, type ServerDecoderOptions, createServerDecoder, decodeTransactionSync, decodeTransactionsBatch };