@explorins/pers-sdk 2.1.39 → 2.1.42

package/dist/shared/utils/image-url-utils.d.ts

@@ -0,0 +1,76 @@
+import { ImageCdnOptions } from '@explorins/pers-shared';
+/**
+ * Image URL Utilities
+ *
+ * Centralized helper for building optimized image URLs.
+ * Handles IPFS resolution and CDN optimization in one call.
+ *
+ * @example
+ * ```typescript
+ * import { buildImageUrl } from '@explorins/pers-sdk';
+ *
+ * // IPFS with CDN preset
+ * const thumbUrl = buildImageUrl('ipfs://Qm...', { preset: 'thumb' }, 'cdn.example.com');
+ *
+ * // HTTP URL with CDN preset (no gateway needed)
+ * const cardUrl = buildImageUrl('https://example.com/photo.jpg', { preset: 'card' });
+ * ```
+ */
+export { buildImageCdnUrl, isValidPreset, getPresetDimensions, isSupportedImageFormat, IMAGE_CDN_PRESETS, IMAGE_CDN_DEFAULT_QUALITY, IMAGE_CDN_DEFAULT_FIT, IMAGE_CDN_DEFAULT_FORMAT, IMAGE_CDN_MAX_DIMENSION, } from '@explorins/pers-shared';
+export type { ImageCdnOptions, ImagePreset, ImageFit, ImageFormat, ImagePresetConfig, } from '@explorins/pers-shared';
+/**
+ * Build optimized image URL with automatic IPFS resolution and CDN options
+ *
+ * Single entry point for all image URL building:
+ * - IPFS URIs → resolved via gateway + CDN options applied
+ * - HTTP URLs → CDN options applied directly
+ *
+ * @param url - Image URL (ipfs://, https://, or any URL)
+ * @param options - CDN optimization options (preset, quality, format, fit)
+ * @param gateway - IPFS gateway domain (required for ipfs:// URLs)
+ * @returns Optimized URL with query parameters
+ *
+ * @example
+ * ```typescript
+ * // IPFS thumbnail
+ * buildImageUrl('ipfs://QmHash', { preset: 'thumb' }, 'cdn.example.com')
+ * // => 'https://cdn.example.com/ipfs/QmHash?preset=thumb'
+ *
+ * // IPFS hero with high quality
+ * buildImageUrl('ipfs://QmHash', { preset: 'hero', q: 95, fit: 'cover' }, 'cdn.example.com')
+ * // => 'https://cdn.example.com/ipfs/QmHash?preset=hero&q=95&fit=cover'
+ *
+ * // HTTP URL (gateway ignored)
+ * buildImageUrl('https://example.com/photo.jpg', { preset: 'card' })
+ * // => 'https://example.com/photo.jpg?preset=card'
+ *
+ * // No options - just IPFS resolution
+ * buildImageUrl('ipfs://QmHash', undefined, 'cdn.example.com')
+ * // => 'https://cdn.example.com/ipfs/QmHash'
+ * ```
+ */
+export declare function buildImageUrl(url: string, options?: ImageCdnOptions, gateway?: string): string;
+/**
+ * Check if a URL is an IPFS URI
+ *
+ * @param url - URL to check
+ * @returns True if URL starts with ipfs://
+ */
+export declare function isIpfsUrl(url: string): boolean;
+/**
+ * Extract CID from IPFS URI
+ *
+ * @param ipfsUri - IPFS URI (ipfs://Qm... or ipfs://baf...)
+ * @returns CID string, or null if not a valid IPFS URI
+ *
+ * @example
+ * ```typescript
+ * extractIpfsCid('ipfs://QmHash123')
+ * // => 'QmHash123'
+ *
+ * extractIpfsCid('https://example.com/image.jpg')
+ * // => null
+ * ```
+ */
+export declare function extractIpfsCid(ipfsUri: string): string | null;
+//# sourceMappingURL=image-url-utils.d.ts.map

package/dist/shared/utils/image-url-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-url-utils.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/image-url-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE3E;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,eAAe,EACf,WAAW,EACX,QAAQ,EACR,WAAW,EACX,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAiBR;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG7D"}

package/dist/web3/domain/services/balance-manager.d.ts

@@ -0,0 +1,160 @@
+/**
+ * BalanceManager - Auto-refresh ERC-20 token balances on wallet events
+ *
+ * This manager provides:
+ * 1. Cached balance storage with automatic refresh
+ * 2. Auto-subscription to wallet events (transfers)
+ * 3. Targeted invalidation based on contract address
+ * 4. Subscriber pattern for reactive updates
+ *
+ * @example
+ * ```typescript
+ * // Get from SDK
+ * const manager = sdk.tokens.balanceManager;
+ *
+ * // Subscribe to balance updates
+ * const unsubscribe = manager.subscribe((balance, contractAddress) => {
+ *   console.log(`Balance updated for ${contractAddress}: ${balance}`);
+ *   updateUI(balance);
+ * });
+ *
+ * // Fetch balance (auto-cached, auto-refreshed on wallet events)
+ * const balance = await manager.getBalance({
+ *   accountAddress: '0x...',
+ *   contractAddress: '0x...',
+ *   abi: contractAbi,
+ *   chainId: 39123
+ * });
+ *
+ * // Manual refresh
+ * await manager.refreshBalance(contractAddress);
+ *
+ * // Cleanup
+ * unsubscribe();
+ * ```
+ */
+import type { TokenBalance } from '../models';
+import type { TokenDomainService } from './token-domain.service';
+import type { PersEventEmitter } from '../../../core/events';
+import type { AbiInput } from '../../application/web3-application.service';
+/**
+ * Parameters for fetching a token balance
+ */
+export interface BalanceParams {
+    accountAddress: string;
+    contractAddress: string;
+    abi: AbiInput;
+    chainId: number;
+}
+/**
+ * Handler for balance change events
+ */
+export type BalanceChangeHandler = (balance: TokenBalance, contractAddress: string, event: {
+    type: 'refresh' | 'wallet_event';
+    source?: string;
+}) => void;
+/**
+ * Configuration for BalanceManager
+ */
+export interface BalanceManagerConfig {
+    /** Enable auto-refresh on wallet events (default: true) */
+    autoRefreshOnWalletEvents?: boolean;
+    /** Debounce time for wallet events in ms (default: 500) */
+    eventDebounceMs?: number;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+}
+/**
+ * Manages ERC-20 token balances with automatic refresh on wallet events
+ */
+export declare class BalanceManager {
+    private tokenService;
+    private eventEmitter?;
+    private balances;
+    private handlers;
+    private eventUnsubscribe?;
+    private pendingRefresh;
+    private config;
+    constructor(tokenService: TokenDomainService, eventEmitter?: PersEventEmitter | undefined, config?: BalanceManagerConfig);
+    /**
+     * Subscribe to wallet events for auto-refresh
+     */
+    private setupEventSubscription;
+    /**
+     * Get a token balance (cached, auto-refreshed on wallet events)
+     *
+     * @param params - Balance parameters
+     * @returns Promise resolving to the token balance
+     */
+    getBalance(params: BalanceParams): Promise<TokenBalance>;
+    /**
+     * Force refresh a specific balance
+     *
+     * @param contractAddress - Contract address to refresh
+     * @param accountAddress - Account address to refresh (optional, refreshes all if not provided)
+     * @returns Promise that resolves when refresh is complete
+     */
+    refreshBalance(contractAddress: string, accountAddress?: string): Promise<void>;
+    /**
+     * Force refresh all tracked balances
+     *
+     * @returns Promise that resolves when all refreshes are complete
+     */
+    refreshAll(): Promise<void>;
+    /**
+     * Subscribe to balance change events
+     *
+     * @param handler - Callback when any tracked balance changes
+     * @returns Unsubscribe function
+     */
+    subscribe(handler: BalanceChangeHandler): () => void;
+    /**
+     * Get all currently tracked balances
+     */
+    getTrackedBalances(): Array<{
+        contractAddress: string;
+        accountAddress: string;
+        balance: TokenBalance | null;
+    }>;
+    /**
+     * Check if a balance is currently being tracked
+     */
+    isTracking(contractAddress: string, accountAddress: string): boolean;
+    /**
+     * Clear tracking for a specific balance
+     */
+    untrack(contractAddress: string, accountAddress?: string): void;
+    /**
+     * Clear all tracked balances
+     */
+    clearAll(): void;
+    /**
+     * Handle wallet events (with debouncing)
+     */
+    private handleWalletEvent;
+    /**
+     * Fetch and cache a balance
+     */
+    private fetchAndCache;
+    /**
+     * Refresh a cached entry and notify handlers
+     */
+    private refreshEntry;
+    /**
+     * Generate cache key from params
+     */
+    private getCacheKey;
+    /**
+     * Create empty balance placeholder
+     */
+    private emptyBalance;
+    /**
+     * Debug logging
+     */
+    private log;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=balance-manager.d.ts.map

package/dist/web3/domain/services/balance-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance-manager.d.ts","sourceRoot":"","sources":["../../../../src/web3/domain/services/balance-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4CAA4C,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,QAAQ,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE;IAAE,IAAI,EAAE,SAAS,GAAG,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KACzD,IAAI,CAAC;AAaV;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,cAAc;IAQvB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,YAAY,CAAC;IARvB,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,gBAAgB,CAAC,CAAa;IACtC,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,MAAM,CAAiC;gBAGrC,YAAY,EAAE,kBAAkB,EAChC,YAAY,CAAC,8BAAkB,EACvC,MAAM,CAAC,EAAE,oBAAoB;IAa/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAc9B;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAc9D;;;;;;OAMG;IACG,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBrF;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAKpD;;OAEG;IACH,kBAAkB,IAAI,KAAK,CAAC;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAA;KAAE,CAAC;IAQ9G;;OAEG;IACH,UAAU,CAAC,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO;IAKpE;;OAEG;IACH,OAAO,CAAC,eAAe,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAkB/D;;OAEG;IACH,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoCzB;;OAEG;YACW,aAAa;IAuC3B;;OAEG;YACW,YAAY;IAyC1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;OAEG;IACH,OAAO,IAAI,IAAI;CAgBhB"}

package/dist/web3/domain/services/index.d.ts

@@ -5,4 +5,6 @@
 export { TokenDomainService } from './token-domain.service';
 export { MetadataDomainService } from './metadata-domain.service';
 export { ContractDomainService } from './contract-domain.service';
+export { TokenCollectionManager, type CollectionParams, type CollectionChangeHandler, type TokenCollectionManagerConfig } from './token-collection-manager';
+export { BalanceManager, type BalanceParams, type BalanceChangeHandler, type BalanceManagerConfig } from './balance-manager';
 //# sourceMappingURL=index.d.ts.map

package/dist/web3/domain/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/web3/domain/services/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/web3/domain/services/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EAClC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC"}

package/dist/web3/domain/services/token-collection-manager.d.ts

@@ -0,0 +1,155 @@
+/**
+ * TokenCollectionManager - Auto-refresh token collections on wallet events
+ *
+ * This manager provides:
+ * 1. Cached token collection storage with automatic refresh
+ * 2. Auto-subscription to wallet events (transfers, mints, burns)
+ * 3. Targeted invalidation based on contract address
+ * 4. Subscriber pattern for reactive updates
+ *
+ * @example
+ * ```typescript
+ * // Get from SDK
+ * const manager = sdk.tokens.collectionManager;
+ *
+ * // Subscribe to collection updates
+ * const unsubscribe = manager.subscribe((collection, contractAddress) => {
+ *   console.log(`Collection updated for ${contractAddress}`);
+ *   updateUI(collection);
+ * });
+ *
+ * // Fetch collection (auto-cached, auto-refreshed on wallet events)
+ * const collection = await manager.getCollection({
+ *   accountAddress: '0x...',
+ *   contractAddress: '0x...',
+ *   abi: contractAbi,
+ *   chainId: 39123,
+ *   tokenIds: ['1', '2', '3']
+ * });
+ *
+ * // Cleanup
+ * unsubscribe();
+ * ```
+ */
+import type { TokenCollection } from '../models';
+import type { TokenDomainService } from './token-domain.service';
+import type { PersEventEmitter } from '../../../core/events';
+import type { AbiInput } from '../../application/web3-application.service';
+/**
+ * Parameters for fetching a token collection
+ */
+export interface CollectionParams {
+    accountAddress: string;
+    contractAddress: string;
+    abi: AbiInput;
+    chainId: number;
+    tokenIds?: string[];
+    maxTokens?: number;
+    batchSize?: number;
+}
+/**
+ * Handler for collection change events
+ */
+export type CollectionChangeHandler = (collection: TokenCollection, contractAddress: string, event: {
+    type: 'refresh' | 'wallet_event';
+    source?: string;
+}) => void;
+/**
+ * Configuration for TokenCollectionManager
+ */
+export interface TokenCollectionManagerConfig {
+    /** Enable auto-refresh on wallet events (default: true) */
+    autoRefreshOnWalletEvents?: boolean;
+    /** Debounce time for wallet events in ms (default: 500) */
+    eventDebounceMs?: number;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+}
+/**
+ * Manages token collections with automatic refresh on wallet events
+ */
+export declare class TokenCollectionManager {
+    private tokenService;
+    private eventEmitter?;
+    private collections;
+    private handlers;
+    private eventUnsubscribe?;
+    private pendingRefresh;
+    private config;
+    constructor(tokenService: TokenDomainService, eventEmitter?: PersEventEmitter | undefined, config?: TokenCollectionManagerConfig);
+    /**
+     * Subscribe to wallet events for auto-refresh
+     */
+    private setupEventSubscription;
+    /**
+     * Get a token collection (cached, auto-refreshed on wallet events)
+     *
+     * @param params - Collection parameters
+     * @returns Promise resolving to the token collection
+     */
+    getCollection(params: CollectionParams): Promise<TokenCollection>;
+    /**
+     * Force refresh a specific collection
+     *
+     * @param contractAddress - Contract address to refresh
+     * @param accountAddress - Account address to refresh
+     * @returns Promise that resolves when refresh is complete
+     */
+    refreshCollection(contractAddress: string, accountAddress?: string): Promise<void>;
+    /**
+     * Subscribe to collection change events
+     *
+     * @param handler - Callback when any tracked collection changes
+     * @returns Unsubscribe function
+     */
+    subscribe(handler: CollectionChangeHandler): () => void;
+    /**
+     * Get all currently tracked collections
+     */
+    getTrackedCollections(): Array<{
+        contractAddress: string;
+        accountAddress: string;
+        collection: TokenCollection | null;
+    }>;
+    /**
+     * Check if a collection is currently being tracked
+     */
+    isTracking(contractAddress: string, accountAddress: string): boolean;
+    /**
+     * Clear tracking for a specific collection
+     */
+    untrack(contractAddress: string, accountAddress?: string): void;
+    /**
+     * Clear all tracked collections
+     */
+    clearAll(): void;
+    /**
+     * Handle wallet events (with debouncing)
+     */
+    private handleWalletEvent;
+    /**
+     * Fetch and cache a collection
+     */
+    private fetchAndCache;
+    /**
+     * Refresh a cached entry and notify handlers
+     */
+    private refreshEntry;
+    /**
+     * Generate cache key from params
+     */
+    private getCacheKey;
+    /**
+     * Create empty collection placeholder
+     */
+    private emptyCollection;
+    /**
+     * Debug logging
+     */
+    private log;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=token-collection-manager.d.ts.map

package/dist/web3/domain/services/token-collection-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-collection-manager.d.ts","sourceRoot":"","sources":["../../../../src/web3/domain/services/token-collection-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4CAA4C,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,QAAQ,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CACpC,UAAU,EAAE,eAAe,EAC3B,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE;IAAE,IAAI,EAAE,SAAS,GAAG,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KACzD,IAAI,CAAC;AAaV;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,2DAA2D;IAC3D,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,sBAAsB;IAQ/B,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,YAAY,CAAC;IARvB,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,gBAAgB,CAAC,CAAa;IACtC,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,MAAM,CAAyC;gBAG7C,YAAY,EAAE,kBAAkB,EAChC,YAAY,CAAC,8BAAkB,EACvC,MAAM,CAAC,EAAE,4BAA4B;IAavC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAc9B;;;;;OAKG;IACG,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAcvE;;;;;;OAMG;IACG,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBxF;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,IAAI;IAKvD;;OAEG;IACH,qBAAqB,IAAI,KAAK,CAAC;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAA;KAAE,CAAC;IAQvH;;OAEG;IACH,UAAU,CAAC,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO;IAKpE;;OAEG;IACH,OAAO,CAAC,eAAe,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAgB/D;;OAEG;IACH,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoCzB;;OAEG;YACW,aAAa;IAoC3B;;OAEG;YACW,YAAY;IAsC1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;OAEG;IACH,OAAO,IAAI,IAAI;CAgBhB"}

package/dist/web3/domain/services/token-domain.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-domain.service.d.ts","sourceRoot":"","sources":["../../../../src/web3/domain/services/token-domain.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4CAA4C,CAAC;AAK3E;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,eAAe;IALzB,OAAO,CAAC,KAAK,CAAsD;gBAGzD,OAAO,EAAE,qBAAqB,EAC9B,eAAe,EAAE,qBAAqB,EACtC,eAAe,EAAE,qBAAqB;IAI1C,eAAe,CAAC,MAAM,EAAE;QAC5B,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,QAAQ,CAAC;QACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,YAAY,CAAC;IAYnB,gBAAgB,CAAC,MAAM,EAAE;QAC7B,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,QAAQ,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;KAChC,CAAC;IAoBI,mBAAmB,CAAC,MAAM,EAAE;QAChC,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,QAAQ,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,YAAY,CAAC;IAYnB,uBAAuB,CAAC,MAAM,EAAE;QACpC,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,QAAQ,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,YAAY,CAAC;IAUnB,kBAAkB,CAAC,MAAM,EAAE;QAC/B,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,QAAQ,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,eAAe,CAAC;IAsD5B;;OAEG;YACW,wBAAwB;YAexB,iBAAiB;IA+E/B,OAAO,CAAC,eAAe;IAcvB,UAAU,IAAI,IAAI;CAGnB"}
+{"version":3,"file":"token-domain.service.d.ts","sourceRoot":"","sources":["../../../../src/web3/domain/services/token-domain.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4CAA4C,CAAC;AAK3E;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,eAAe;IALzB,OAAO,CAAC,KAAK,CAAsD;gBAGzD,OAAO,EAAE,qBAAqB,EAC9B,eAAe,EAAE,qBAAqB,EACtC,eAAe,EAAE,qBAAqB;IAI1C,eAAe,CAAC,MAAM,EAAE;QAC5B,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,QAAQ,CAAC;QACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,YAAY,CAAC;IAYnB,gBAAgB,CAAC,MAAM,EAAE;QAC7B,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,QAAQ,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;KAChC,CAAC;IAoBI,mBAAmB,CAAC,MAAM,EAAE;QAChC,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,QAAQ,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,YAAY,CAAC;IAYnB,uBAAuB,CAAC,MAAM,EAAE;QACpC,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,QAAQ,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,YAAY,CAAC;IAUnB,kBAAkB,CAAC,MAAM,EAAE;QAC/B,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,QAAQ,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,eAAe,CAAC;IAyD5B;;OAEG;YACW,wBAAwB;YAexB,iBAAiB;IA4F/B,OAAO,CAAC,eAAe;IAcvB,UAAU,IAAI,IAAI;CAGnB"}

package/dist/web3/index.d.ts

@@ -1,6 +1,7 @@
 export { Web3Manager } from '../managers/web3-manager';
 export type { TokenBalanceRequest, TokenBalance, TokenMetadata, TokenCollection, TokenCollectionRequest, AbiInput, AccountOwnedTokensResult } from './application/web3-application.service';
 export type { MetadataMapper } from './domain/models';
+export { TokenCollectionManager, BalanceManager, type CollectionParams, type CollectionChangeHandler, type TokenCollectionManagerConfig, type BalanceParams, type BalanceChangeHandler, type BalanceManagerConfig } from './domain/services';
 export * from './infrastructure';
 export { Web3ApplicationService } from './application';
 export * from './utils/explorer.utils';

package/dist/web3/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web3/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,QAAQ,EACR,wBAAwB,EACzB,MAAM,wCAAwC,CAAC;AAGhD,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web3/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,QAAQ,EACR,wBAAwB,EACzB,MAAM,wCAAwC,CAAC;AAGhD,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,cAAc,wBAAwB,CAAC"}

package/dist/web3/infrastructure/api/web3-api.d.ts

@@ -1,5 +1,6 @@
 import { Interface } from 'ethers';
 import { Web3ChainService } from '../../../web3-chain/services/web3-chain-service';
+import { type BatchBalanceResult } from '@explorins/web3-ts/ethers';
 /**
  * Web3InfrastructureApi - Infrastructure implementation for blockchain operations
  * Uses @explorins/web3-ts for Web3 interactions
@@ -14,6 +15,21 @@ export declare class Web3InfrastructureApi {
         tokenId: string | null;
         chainId: number;
     }): Promise<number>;
+    /**
+     * Get multiple ERC-1155 token balances in a single RPC call using native balanceOfBatch.
+     * Falls back to individual calls if balanceOfBatch fails.
+     *
+     * @param request - Batch balance request
+     * @returns Array of balance results per tokenId
+     */
+    getBatchTokenBalances(request: {
+        accountAddress: string;
+        contractAddress: string;
+        abi: Interface;
+        tokenIds: string[];
+        chainId: number;
+        isERC1155?: boolean;
+    }): Promise<BatchBalanceResult[]>;
     getTokenUri(request: {
         contractAddress: string;
         abi: Interface;

package/dist/web3/infrastructure/api/web3-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web3-api.d.ts","sourceRoot":"","sources":["../../../../src/web3/infrastructure/api/web3-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iDAAiD,CAAC;AAQnF;;;GAGG;AACH,qBAAa,qBAAqB;IAEpB,OAAO,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,gBAAgB;IAEhD,eAAe,CAAC,OAAO,EAAE;QAC7B,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,SAAS,CAAC;QACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,MAAM,CAAC;IAcb,WAAW,CAAC,OAAO,EAAE;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,SAAS,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,MAAM,CAAC;IAeb,sBAAsB,CAAC,OAAO,EAAE;QACpC,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,SAAS,CAAC;QACf,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,MAAM,CAAC;CAYpB"}
+{"version":3,"file":"web3-api.d.ts","sourceRoot":"","sources":["../../../../src/web3/infrastructure/api/web3-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iDAAiD,CAAC;AACnF,OAAO,EAML,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAC;AAEnC;;;GAGG;AACH,qBAAa,qBAAqB;IAEpB,OAAO,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,gBAAgB;IAEhD,eAAe,CAAC,OAAO,EAAE;QAC7B,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,SAAS,CAAC;QACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,MAAM,CAAC;IAcnB;;;;;;OAMG;IACG,qBAAqB,CAAC,OAAO,EAAE;QACnC,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,SAAS,CAAC;QACf,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAyB3B,WAAW,CAAC,OAAO,EAAE;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,SAAS,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,MAAM,CAAC;IAeb,sBAAsB,CAAC,OAAO,EAAE;QACpC,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,SAAS,CAAC;QACf,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,MAAM,CAAC;CAYpB"}

package/dist/web3-manager.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var web3Manager = require('./chunks/web3-manager-C-JflQ86.cjs');
+var web3Manager = require('./chunks/web3-manager-NJaeBrci.cjs');
 require('./chunks/web3-chain-service-D6tBL0F7.cjs');
 require('@explorins/web3-types');
 require('./chunks/tenant-manager-DR5eSEJw.cjs');

package/dist/web3-manager.js

@@ -1,4 +1,4 @@
-export { W as Web3Manager } from './chunks/web3-manager-Dvcq4xmn.js';
+export { W as Web3Manager } from './chunks/web3-manager-B-IsluxI.js';
 import './chunks/web3-chain-service-BWRmwmmJ.js';
 import '@explorins/web3-types';
 import './chunks/tenant-manager-xmYKBFGu.js';

package/dist/web3.cjs

@@ -1,18 +1,20 @@
 'use strict';
 
-var web3Manager = require('./chunks/web3-manager-C-JflQ86.cjs');
+var web3Manager = require('./chunks/web3-manager-NJaeBrci.cjs');
 require('@explorins/web3-ts/ethers');
 require('./chunks/index-C4K-jkRO.cjs');
-require('@explorins/pers-shared');
 require('./chunks/web3-chain-service-D6tBL0F7.cjs');
 require('@explorins/web3-types');
 require('./chunks/tenant-manager-DR5eSEJw.cjs');
 require('./chunks/tenant-service-8vZWmTLV.cjs');
+require('@explorins/pers-shared');
 require('./chunks/pagination-utils-B2jRHMSO.cjs');
 
 
 
+exports.BalanceManager = web3Manager.BalanceManager;
 exports.IPFSInfrastructureApi = web3Manager.IPFSInfrastructureApi;
+exports.TokenCollectionManager = web3Manager.TokenCollectionManager;
 exports.Web3ApplicationService = web3Manager.Web3ApplicationService;
 exports.Web3InfrastructureApi = web3Manager.Web3InfrastructureApi;
 exports.Web3Manager = web3Manager.Web3Manager;

package/dist/web3.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"web3.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"web3.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;"}

package/dist/web3.js

@@ -1,10 +1,10 @@
-export { I as IPFSInfrastructureApi, a as Web3ApplicationService, b as Web3InfrastructureApi, W as Web3Manager, g as getExplorerUrl, c as getExplorerUrlByChainId } from './chunks/web3-manager-Dvcq4xmn.js';
+export { B as BalanceManager, I as IPFSInfrastructureApi, T as TokenCollectionManager, a as Web3ApplicationService, b as Web3InfrastructureApi, W as Web3Manager, g as getExplorerUrl, c as getExplorerUrlByChainId } from './chunks/web3-manager-B-IsluxI.js';
 import '@explorins/web3-ts/ethers';
 import './chunks/index--OssIds0.js';
-import '@explorins/pers-shared';
 import './chunks/web3-chain-service-BWRmwmmJ.js';
 import '@explorins/web3-types';
 import './chunks/tenant-manager-xmYKBFGu.js';
 import './chunks/tenant-service-DlhdZAs9.js';
+import '@explorins/pers-shared';
 import './chunks/pagination-utils-9vQ-Npkr.js';
 //# sourceMappingURL=web3.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-sdk",
-  "version": "2.1.39",
+  "version": "2.1.42",
   "description": "Platform-agnostic SDK for PERS (Phygital Experience Rewards System) - Core business logic and API integration",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -133,8 +133,8 @@
   },
   "dependencies": {
     "@explorins/pers-sdk": "^2.1.32",
-    "@explorins/pers-shared": "^2.1.146",
-    "@explorins/web3-ts": "^0.3.77",
+    "@explorins/pers-shared": "^2.1.154",
+    "@explorins/web3-ts": "^0.3.88",
     "@explorins/web3-types": "^1.2.0",
     "ethers": "^6.15.0"
   },