@explorins/pers-sdk 2.1.10 → 2.1.14

package/dist/events/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * PERS Events Types
+ *
+ * Type definitions for real-time blockchain event streaming.
+ * Re-exports types from @explorins/pers-shared for type consistency.
+ *
+ * @version 1.2.0 - Client-side subscription model
+ */
+export type { WalletInfo, WSClientMessageBase, SubscribeMessage, UnsubscribeMessage, PongMessage, WSClientMessage, ConnectedPayload, SubscribedPayload, UnsubscribedPayload, ErrorPayload, BlockchainEventType, BlockchainEvent, WSServerMessageConnected, WSServerMessageSubscribed, WSServerMessageUnsubscribed, WSServerMessageEvent, WSServerMessageError, WSServerMessagePing, WSServerMessage, } from '@explorins/pers-shared';
+export { isServerMessage, isConnectedMessage, isEventMessage, isSubscribedMessage, isErrorMessage, } from '@explorins/pers-shared';
+export type { BlockchainEventHandler, BlockchainEventUnsubscribe, EventConnectionState, } from '@explorins/web3-types';
+export type { EventConnectionState as ConnectionState } from '@explorins/web3-types';
+export type { WalletInfo as WalletTarget } from '@explorins/pers-shared';
+/**
+ * Events client configuration
+ */
+export interface EventsClientConfig {
+    /** WS Relay server URL (wss://...) */
+    wsUrl: string;
+    /** Reconnect on disconnect */
+    autoReconnect?: boolean;
+    /** Max reconnect attempts (default: 10) */
+    maxReconnectAttempts?: number;
+    /** Reconnect delay in ms (default: 1000) */
+    reconnectDelay?: number;
+    /** Connection timeout in ms (default: 30000) */
+    connectionTimeout?: number;
+    /** Debug logging */
+    debug?: boolean;
+    /** Token refresh callback for reconnection (optional) */
+    tokenRefresher?: () => Promise<string>;
+}
+/**
+ * Current subscription state (alias for SubscribedPayload)
+ */
+export type { SubscribedPayload as SubscriptionState } from '@explorins/pers-shared';
+//# sourceMappingURL=types.d.ts.map

package/dist/events/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EAEV,UAAU,EAGV,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,eAAe,EAGf,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,cAAc,GACf,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EAAE,oBAAoB,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGrF,YAAY,EAAE,UAAU,IAAI,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,YAAY,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
-var persSdk = require('./chunks/pers-sdk-Co-R9M1O.cjs');
+var persSdk = require('./chunks/pers-sdk-Cv7hM1I7.cjs');
 var persShared = require('@explorins/pers-shared');
 var environment = require('./chunks/environment-C73snhIJ.cjs');
-var index = require('./chunks/index-B6-bbNnd.cjs');
-var index$1 = require('./chunks/index-B-g2JPVK.cjs');
+var index = require('./chunks/index-CGaKfZNU.cjs');
+var tenantManager = require('./chunks/tenant-manager-BUiFM33X.cjs');
 var paginationUtils = require('./chunks/pagination-utils-B2jRHMSO.cjs');
 var businessMembershipService = require('./chunks/business-membership-service-BfHzIQlc.cjs');
-var transactionRequest_builder = require('./chunks/transaction-request.builder-Bjxi0C9F.cjs');
+var transactionRequest_builder = require('./chunks/transaction-request.builder-CW3Wwdi3.cjs');
 var analyticsService = require('./chunks/analytics-service-CF9AsMQH.cjs');
 var campaign = require('./campaign.cjs');
 var donation = require('./donation.cjs');
@@ -50,6 +50,7 @@ exports.LocalStorageTokenStorage = persSdk.LocalStorageTokenStorage;
 exports.MemoryTokenStorage = persSdk.MemoryTokenStorage;
 exports.PersApiClient = persSdk.PersApiClient;
 exports.PersEventEmitter = persSdk.PersEventEmitter;
+exports.PersEventsClient = persSdk.PersEventsClient;
 exports.PersSDK = persSdk.PersSDK;
 exports.PurchaseManager = persSdk.PurchaseManager;
 exports.RedemptionManager = persSdk.RedemptionManager;
@@ -57,14 +58,19 @@ exports.SDK_NAME = persSdk.SDK_NAME;
 exports.SDK_USER_AGENT = persSdk.SDK_USER_AGENT;
 exports.SDK_VERSION = persSdk.SDK_VERSION;
 exports.StaticJwtAuthProvider = persSdk.StaticJwtAuthProvider;
-exports.TenantManager = persSdk.TenantManager;
 exports.TokenManager = persSdk.TokenManager;
 exports.TransactionManager = persSdk.TransactionManager;
 exports.TriggerSourceManager = persSdk.TriggerSourceManager;
 exports.UserManager = persSdk.UserManager;
 exports.UserStatusManager = persSdk.UserStatusManager;
+exports.WalletEventsManager = persSdk.WalletEventsManager;
 exports.WebDPoPCryptoProvider = persSdk.WebDPoPCryptoProvider;
+exports.WebhookApi = persSdk.WebhookApi;
+exports.WebhookManager = persSdk.WebhookManager;
+exports.WebhookService = persSdk.WebhookService;
 exports.buildApiRoot = persSdk.buildApiRoot;
+exports.buildWalletEventsWsUrl = persSdk.buildWalletEventsWsUrl;
+exports.createPersEventsClient = persSdk.createPersEventsClient;
 exports.createPersSDK = persSdk.createPersSDK;
 exports.mergeWithDefaults = persSdk.mergeWithDefaults;
 Object.defineProperty(exports, "AccountOwnerType", {
@@ -79,6 +85,26 @@ Object.defineProperty(exports, "VALID_USER_RELATIONS", {
 	enumerable: true,
 	get: function () { return persShared.VALID_USER_RELATIONS; }
 });
+Object.defineProperty(exports, "isConnectedMessage", {
+	enumerable: true,
+	get: function () { return persShared.isConnectedMessage; }
+});
+Object.defineProperty(exports, "isErrorMessage", {
+	enumerable: true,
+	get: function () { return persShared.isErrorMessage; }
+});
+Object.defineProperty(exports, "isEventMessage", {
+	enumerable: true,
+	get: function () { return persShared.isEventMessage; }
+});
+Object.defineProperty(exports, "isServerMessage", {
+	enumerable: true,
+	get: function () { return persShared.isServerMessage; }
+});
+Object.defineProperty(exports, "isSubscribedMessage", {
+	enumerable: true,
+	get: function () { return persShared.isSubscribedMessage; }
+});
 Object.defineProperty(exports, "isValidUserRelation", {
 	enumerable: true,
 	get: function () { return persShared.isValidUserRelation; }
@@ -87,17 +113,18 @@ exports.IndexedDBTokenStorage = environment.IndexedDBTokenStorage;
 exports.detectEnvironment = environment.detectEnvironment;
 exports.environment = environment.environment;
 exports.warnIfProblematicEnvironment = environment.warnIfProblematicEnvironment;
+exports.ApiErrorDetector = index.ApiErrorDetector;
+exports.AuthenticationError = index.AuthenticationError;
 exports.CacheService = index.CacheService;
 exports.CacheTTL = index.CacheTTL;
+exports.ErrorUtils = index.ErrorUtils;
+exports.LogoutRequired = index.LogoutRequired;
+exports.NetworkError = index.NetworkError;
+exports.PersApiError = index.PersApiError;
+exports.ProviderTokenRefreshNeeded = index.ProviderTokenRefreshNeeded;
+exports.TokenRefreshNeeded = index.TokenRefreshNeeded;
 exports.globalCacheService = index.globalCacheService;
-exports.ApiErrorDetector = index$1.ApiErrorDetector;
-exports.AuthenticationError = index$1.AuthenticationError;
-exports.ErrorUtils = index$1.ErrorUtils;
-exports.LogoutRequired = index$1.LogoutRequired;
-exports.NetworkError = index$1.NetworkError;
-exports.PersApiError = index$1.PersApiError;
-exports.ProviderTokenRefreshNeeded = index$1.ProviderTokenRefreshNeeded;
-exports.TokenRefreshNeeded = index$1.TokenRefreshNeeded;
+exports.TenantManager = tenantManager.TenantManager;
 exports.buildPaginationParams = paginationUtils.buildPaginationParams;
 exports.extractData = paginationUtils.extractData;
 exports.extractPagination = paginationUtils.extractPagination;
@@ -121,6 +148,7 @@ exports.buildTransferRequest = transactionRequest_builder.buildTransferRequest;
 exports.extractDeadlineFromSigningData = transactionRequest_builder.extractDeadlineFromSigningData;
 exports.getSigningUrl = transactionRequest_builder.getSigningUrl;
 exports.needsExternalSigning = transactionRequest_builder.needsExternalSigning;
+exports.needsSubmission = transactionRequest_builder.needsSubmission;
 exports.AnalyticsApi = analyticsService.AnalyticsApi;
 exports.AnalyticsService = analyticsService.AnalyticsService;
 exports.CampaignApi = campaign.CampaignApi;

package/dist/index.cjs.map

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

package/dist/index.d.ts

@@ -20,6 +20,8 @@ export * from './user';
 export * from './user-status';
 export * from './api-key';
 export * from './trigger-source';
+export * from './webhook';
+export * from './events';
 export type { CampaignClaimFilters, CampaignClaimQueryOptions } from './campaign';
 export type { TransactionQueryOptions } from './transaction';
 export type { RedemptionRedeemFilters, RedemptionRedeemQueryOptions } from './redemption';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,QAAQ,CAAA;AAGtB,cAAc,YAAY,CAAC;AAG3B,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAG3B,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC;AAG5B,cAAc,YAAY,CAAC;AAG3B,cAAc,YAAY,CAAC;AAG3B,cAAc,WAAW,CAAC;AAG1B,cAAc,QAAQ,CAAC;AAGvB,cAAc,cAAc,CAAC;AAG7B,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,QAAQ,CAAC;AAGvB,cAAc,eAAe,CAAC;AAG9B,cAAc,WAAW,CAAC;AAG1B,cAAc,kBAAkB,CAAC;AAIjC,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAClF,YAAY,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAC1F,YAAY,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AASrD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGpD,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,QAAQ,CAAA;AAGtB,cAAc,YAAY,CAAC;AAG3B,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAG3B,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC;AAG5B,cAAc,YAAY,CAAC;AAG3B,cAAc,YAAY,CAAC;AAG3B,cAAc,WAAW,CAAC;AAG1B,cAAc,QAAQ,CAAC;AAGvB,cAAc,cAAc,CAAC;AAG7B,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,QAAQ,CAAC;AAGvB,cAAc,eAAe,CAAC;AAG9B,cAAc,WAAW,CAAC;AAG1B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,WAAW,CAAC;AAG1B,cAAc,UAAU,CAAC;AAIzB,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAClF,YAAY,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAC1F,YAAY,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AASrD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGpD,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,12 +1,12 @@
-export { b as AUTH_STORAGE_KEYS, v as AnalyticsManager, E as ApiKeyApi, u as ApiKeyManager, k as AuthApi, p as AuthManager, l as AuthService, A as AuthStatus, a as AuthTokenManager, B as BusinessManager, C as CampaignManager, h as DEFAULT_PERS_CONFIG, d as DPOP_STORAGE_KEYS, n as DPoPManager, D as DefaultAuthProvider, w as DonationManager, y as FileApi, F as FileManager, z as FileService, L as LocalStorageTokenStorage, M as MemoryTokenStorage, g as PersApiClient, o as PersEventEmitter, P as PersSDK, s as PurchaseManager, R as RedemptionManager, S as SDK_NAME, f as SDK_USER_AGENT, e as SDK_VERSION, j as StaticJwtAuthProvider, t as TenantManager, T as TokenManager, r as TransactionManager, x as TriggerSourceManager, U as UserManager, q as UserStatusManager, W as WebDPoPCryptoProvider, i as buildApiRoot, c as createPersSDK, m as mergeWithDefaults } from './chunks/pers-sdk-Bh-m0x17.js';
+export { b as AUTH_STORAGE_KEYS, v as AnalyticsManager, H as ApiKeyApi, u as ApiKeyManager, l as AuthApi, q as AuthManager, n as AuthService, A as AuthStatus, a as AuthTokenManager, B as BusinessManager, C as CampaignManager, h as DEFAULT_PERS_CONFIG, d as DPOP_STORAGE_KEYS, o as DPoPManager, D as DefaultAuthProvider, w as DonationManager, E as FileApi, F as FileManager, G as FileService, L as LocalStorageTokenStorage, M as MemoryTokenStorage, g as PersApiClient, p as PersEventEmitter, K as PersEventsClient, P as PersSDK, t as PurchaseManager, R as RedemptionManager, S as SDK_NAME, f as SDK_USER_AGENT, e as SDK_VERSION, k as StaticJwtAuthProvider, T as TokenManager, s as TransactionManager, x as TriggerSourceManager, U as UserManager, r as UserStatusManager, z as WalletEventsManager, W as WebDPoPCryptoProvider, I as WebhookApi, y as WebhookManager, J as WebhookService, i as buildApiRoot, j as buildWalletEventsWsUrl, N as createPersEventsClient, c as createPersSDK, m as mergeWithDefaults } from './chunks/pers-sdk-BiP7UMJ3.js';
 export * from '@explorins/pers-shared';
-export { AccountOwnerType, SortOrder, VALID_USER_RELATIONS, isValidUserRelation } from '@explorins/pers-shared';
+export { AccountOwnerType, SortOrder, VALID_USER_RELATIONS, isConnectedMessage, isErrorMessage, isEventMessage, isServerMessage, isSubscribedMessage, isValidUserRelation } from '@explorins/pers-shared';
 export { I as IndexedDBTokenStorage, d as detectEnvironment, e as environment, w as warnIfProblematicEnvironment } from './chunks/environment-CKVwRAEL.js';
-export { a as CacheService, C as CacheTTL, g as globalCacheService } from './chunks/index-DBLskLuH.js';
-export { b as ApiErrorDetector, A as AuthenticationError, E as ErrorUtils, L as LogoutRequired, N as NetworkError, a as PersApiError, P as ProviderTokenRefreshNeeded, T as TokenRefreshNeeded } from './chunks/index-CKm_V5XE.js';
+export { c as ApiErrorDetector, A as AuthenticationError, a as CacheService, C as CacheTTL, E as ErrorUtils, L as LogoutRequired, N as NetworkError, b as PersApiError, P as ProviderTokenRefreshNeeded, T as TokenRefreshNeeded, g as globalCacheService } from './chunks/index-DgTEdUgC.js';
+export { T as TenantManager } from './chunks/tenant-manager-Bbj0bKoo.js';
 export { b as buildPaginationParams, e as extractData, a as extractPagination, f as fetchAllPages, i as isPaginatedResponse, n as normalizeToPaginated } from './chunks/pagination-utils-9vQ-Npkr.js';
 export { B as BusinessApi, a as BusinessMembershipApi, c as BusinessMembershipService, b as BusinessService } from './chunks/business-membership-service-CFa-TI39.js';
-export { C as ClientTransactionType, T as TransactionApi, a as TransactionService, c as buildBurnRequest, b as buildMintRequest, f as buildPOSBurnRequest, e as buildPOSTransferRequest, i as buildPendingTransactionData, g as buildSubmissionRequest, d as buildTransferRequest, h as extractDeadlineFromSigningData, j as getSigningUrl, n as needsExternalSigning } from './chunks/transaction-request.builder-DGTxGvc3.js';
+export { C as ClientTransactionType, T as TransactionApi, a as TransactionService, c as buildBurnRequest, b as buildMintRequest, f as buildPOSBurnRequest, e as buildPOSTransferRequest, i as buildPendingTransactionData, g as buildSubmissionRequest, d as buildTransferRequest, h as extractDeadlineFromSigningData, k as getSigningUrl, n as needsExternalSigning, j as needsSubmission } from './chunks/transaction-request.builder-C3C19kCx.js';
 export { A as AnalyticsApi, a as AnalyticsService } from './chunks/analytics-service-vm7B7LhS.js';
 export { CampaignApi, CampaignService } from './campaign.js';
 export { DonationApi, DonationService } from './donation.js';

package/dist/managers/events-manager.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Wallet Events Manager - Real-time blockchain events for user's wallets
+ *
+ * Provides automatic connection management and event routing integrated
+ * with the SDK's authentication flow and event system.
+ *
+ * Events are routed through the SDK's PersEventEmitter, so you can either:
+ * 1. Subscribe via `sdk.walletEvents.on()` for wallet-specific handling
+ * 2. Subscribe via `sdk.events.subscribe()` for unified event stream
+ *
+ * ## v1.2.0 - Subscription Model
+ *
+ * After connecting, you must explicitly subscribe to wallets or chains:
+ * - User SDK: `subscribeWallets([{ address, chainId }])`
+ * - Admin Dashboard: `subscribeChains([chainId1, chainId2])`
+ *
+ * For convenience, use `sdk.connectWalletEvents()` which auto-subscribes
+ * based on auth type.
+ *
+ * @example Manual subscription
+ * ```typescript
+ * await sdk.walletEvents.connect();
+ * await sdk.walletEvents.subscribeWallets([
+ *   { address: user.wallets[0].address, chainId: 39123 }
+ * ]);
+ *
+ * sdk.walletEvents.on('Transfer', (event) => {
+ *   console.log(`Received ${event.data.value} tokens`);
+ * });
+ * ```
+ *
+ * @example Auto-subscription (recommended)
+ * ```typescript
+ * // Auto-subscribes based on auth type (user/business/admin)
+ * await sdk.connectWalletEvents();
+ * ```
+ */
+import type { PersApiClient } from '../core/pers-api-client';
+import type { PersEventEmitter } from '../core/events';
+import type { BlockchainEventType, BlockchainEventHandler, BlockchainEventUnsubscribe, ConnectionState, WalletInfo, SubscribedPayload } from '../events/types';
+export interface WalletEventsConfig {
+    /** WS Relay server URL. If not provided, uses environment default. */
+    wsUrl?: string;
+    /** Auto-reconnect on disconnect (default: true) */
+    autoReconnect?: boolean;
+    /** Connection timeout in ms (default: 30000) */
+    connectionTimeout?: number;
+    /** Debug logging (default: false) */
+    debug?: boolean;
+}
+/**
+ * Wallet Events Manager - Manages real-time blockchain event subscriptions
+ *
+ * Low-level WS client wrapper. For auto-subscription based on auth type,
+ * use `sdk.connectWalletEvents()` which handles subscription automatically.
+ */
+export declare class WalletEventsManager {
+    private apiClient;
+    private eventEmitter;
+    private client;
+    private config;
+    private pendingHandlers;
+    private unsubscribes;
+    constructor(apiClient: PersApiClient, eventEmitter: PersEventEmitter, config?: WalletEventsConfig);
+    /**
+     * Connect to real-time wallet events
+     *
+     * Establishes WebSocket connection to the WS relay server.
+     * After connecting, call subscribeWallets() or subscribeChains() to start
+     * receiving events.
+     *
+     * For auto-subscription, use `sdk.connectWalletEvents()` instead.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from real-time events
+     */
+    disconnect(): void;
+    /**
+     * Subscribe to wallet events
+     *
+     * Receives events only for the specified wallet addresses.
+     * Use this for user-facing SDK where you want to monitor specific wallets.
+     *
+     * @param wallets - Array of wallet info (address + chainId)
+     * @returns Promise that resolves when subscription is confirmed
+     *
+     * @example
+     * ```typescript
+     * await sdk.walletEvents.connect();
+     * await sdk.walletEvents.subscribeWallets([
+     *   { address: '0x123...', chainId: 39123 }
+     * ]);
+     * ```
+     */
+    subscribeWallets(wallets: WalletInfo[]): Promise<SubscribedPayload>;
+    /**
+     * Subscribe to chain events (Admin Dashboard)
+     *
+     * Receives ALL events on the specified chains.
+     * Use for admin dashboards that need to monitor all activity.
+     *
+     * @param chains - Array of chain IDs to subscribe to
+     * @returns Promise that resolves when subscription is confirmed
+     *
+     * @example
+     * ```typescript
+     * await sdk.walletEvents.connect();
+     * await sdk.walletEvents.subscribeChains([39123, 137]);
+     * ```
+     */
+    subscribeChains(chains: number[]): Promise<SubscribedPayload>;
+    /**
+     * Unsubscribe from wallet events
+     *
+     * @param wallets - Array of wallet info to unsubscribe from
+     * @returns Promise that resolves when unsubscription is confirmed
+     */
+    unsubscribeWallets(wallets: WalletInfo[]): Promise<SubscribedPayload>;
+    /**
+     * Unsubscribe from chain events
+     *
+     * @param chains - Array of chain IDs to unsubscribe from
+     * @returns Promise that resolves when unsubscription is confirmed
+     */
+    unsubscribeChains(chains: number[]): Promise<SubscribedPayload>;
+    /**
+     * Get current subscription state
+     */
+    getSubscriptionState(): SubscribedPayload;
+    /**
+     * Subscribe to blockchain events
+     *
+     * @param eventType - Event type ('Transfer', 'Approval', etc.) or '*' for all
+     * @param handler - Callback function when event is received
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```typescript
+     * const unsub = sdk.walletEvents.on('Transfer', (event) => {
+     *   console.log(`Transfer: ${event.data.from} -> ${event.data.to}`);
+     * });
+     *
+     * // Later: stop listening
+     * unsub();
+     * ```
+     */
+    on(eventType: BlockchainEventType | '*', handler: BlockchainEventHandler): BlockchainEventUnsubscribe;
+    /**
+     * Subscribe to connection state changes
+     */
+    onStateChange(handler: (state: ConnectionState) => void): BlockchainEventUnsubscribe;
+    /**
+     * Get current connection state
+     */
+    getState(): ConnectionState;
+    /**
+     * Check if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get connection info (wallets, active chains)
+     */
+    getConnectionInfo(): {
+        userId: string;
+        wallets: WalletInfo[];
+        activeChains: number[];
+    } | null | undefined;
+    /**
+     * Build a descriptive message for blockchain events
+     * Neutral tone - frontend will handle user-facing presentation
+     */
+    private buildUserMessage;
+    /**
+     * Route blockchain event to PersEventEmitter for unified event stream
+     */
+    private emitToPersEvents;
+}
+//# sourceMappingURL=events-manager.d.ts.map

package/dist/managers/events-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-manager.d.ts","sourceRoot":"","sources":["../../src/managers/events-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAEV,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,eAAe,EACf,UAAU,EACV,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,mBAAmB;IAO5B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,YAAY;IAPtB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,eAAe,CAAmF;IAC1G,OAAO,CAAC,YAAY,CAAoC;gBAG9C,SAAS,EAAE,aAAa,EACxB,YAAY,EAAE,gBAAgB,EACtC,MAAM,CAAC,EAAE,kBAAkB;IAU7B;;;;;;;;OAQG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA0D9B;;OAEG;IACH,UAAU,IAAI,IAAI;IAWlB;;;;;;;;;;;;;;;;OAgBG;IACG,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOzE;;;;;;;;;;;;;;OAcG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOnE;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAO3E;;;;;OAKG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOrE;;OAEG;IACH,oBAAoB,IAAI,iBAAiB;IAQzC;;;;;;;;;;;;;;;;OAgBG;IACH,EAAE,CAAC,SAAS,EAAE,mBAAmB,GAAG,GAAG,EAAE,OAAO,EAAE,sBAAsB,GAAG,0BAA0B;IAerG;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,0BAA0B;IAOpF;;OAEG;IACH,QAAQ,IAAI,eAAe;IAI3B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,iBAAiB;;;;;IAQjB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAgDxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAiBzB"}

package/dist/managers/index.d.ts

@@ -19,4 +19,6 @@ export { ApiKeyManager } from './api-key-manager';
 export { AnalyticsManager } from './analytics-manager';
 export { DonationManager } from './donation-manager';
 export { TriggerSourceManager } from './trigger-source-manager';
+export { WebhookManager } from './webhook-manager';
+export { WalletEventsManager, type WalletEventsConfig } from './events-manager';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/managers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/managers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/managers/tenant-manager.d.ts

@@ -8,10 +8,13 @@ import type { TenantPublicDTO, TenantClientConfigDTO, AdminDTO, AdminCreateReque
  *
  * Provides a simplified API for common tenant management tasks while maintaining
  * access to the full tenant SDK for advanced use cases.
+ *
+ * Also provides chain-agnostic IPFS URL resolution using tenant configuration.
  */
 export declare class TenantManager {
     private apiClient;
     private tenantService;
+    private cache;
     constructor(apiClient: PersApiClient);
     /**
      * Get current tenant information
@@ -26,11 +29,45 @@ export declare class TenantManager {
      */
     getLoginToken(): Promise<string>;
     /**
-     * Get tenant client configuration
+     * Get tenant client configuration (cached)
      *
      * @returns Promise resolving to client config
      */
     getClientConfig(): Promise<TenantClientConfigDTO>;
+    /**
+     * Resolve IPFS URL to HTTPS URL using tenant's configured gateway.
+     *
+     * This is chain-agnostic - IPFS gateway is configured at the tenant level,
+     * not per-chain. Use this for resolving any ipfs:// URLs (images, metadata, etc.).
+     *
+     * @param url - URL to resolve (can be ipfs:// or https://)
+     * @returns Resolved HTTPS URL
+     * @throws Error if tenant's ipfsGatewayDomain is not configured
+     *
+     * @example
+     * ```typescript
+     * const imageUrl = await sdk.tenant.resolveIPFSUrl('ipfs://QmXxx.../image.png');
+     * // Returns: 'https://pers.mypinata.cloud/ipfs/QmXxx.../image.png'
+     *
+     * // Non-IPFS URLs pass through unchanged
+     * const httpUrl = await sdk.tenant.resolveIPFSUrl('https://example.com/image.png');
+     * // Returns: 'https://example.com/image.png'
+     * ```
+     */
+    resolveIPFSUrl(url: string): Promise<string>;
+    /**
+     * Get IPFS gateway domain from tenant configuration (cached).
+     *
+     * @returns IPFS gateway domain (e.g., 'pers.mypinata.cloud')
+     * @throws Error if ipfsGatewayDomain is not configured for this tenant
+     */
+    getIpfsGatewayDomain(): Promise<string>;
+    /**
+     * Get Google API key from tenant configuration (cached).
+     *
+     * @returns Google API key or undefined if not configured
+     */
+    getGoogleApiKey(): Promise<string | undefined>;
     /**
      * Admin: Update tenant data
      *
@@ -66,5 +103,9 @@ export declare class TenantManager {
      * @returns TenantService instance
      */
     getTenantService(): TenantService;
+    /**
+     * Clear tenant cache (useful after config changes)
+     */
+    clearCache(): void;
 }
 //# sourceMappingURL=tenant-manager.d.ts.map

package/dist/managers/tenant-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tenant-manager.d.ts","sourceRoot":"","sources":["../../src/managers/tenant-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAa,aAAa,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAEV,eAAe,EACf,qBAAqB,EACrB,QAAQ,EACR,qBAAqB,EACtB,MAAM,iDAAiD,CAAC;AAEzD;;;;;GAKG;AACH,qBAAa,aAAa;IAGZ,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,aAAa,CAAgB;gBAEjB,SAAS,EAAE,aAAa;IAK5C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;IAI/C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAItC;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAIvD;;;;;OAKG;IACG,YAAY,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAIzE;;;;;OAKG;IACG,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIrF;;;;;OAKG;IACG,WAAW,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItE;;;;;;OAMG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvF;;;;OAIG;IACH,gBAAgB,IAAI,aAAa;CAGlC"}
+{"version":3,"file":"tenant-manager.d.ts","sourceRoot":"","sources":["../../src/managers/tenant-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAa,aAAa,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,OAAO,KAAK,EAEV,eAAe,EACf,qBAAqB,EACrB,QAAQ,EACR,qBAAqB,EACtB,MAAM,iDAAiD,CAAC;AAEzD;;;;;;;GAOG;AACH,qBAAa,aAAa;IAIZ,OAAO,CAAC,SAAS;IAH7B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,KAAK,CAAgD;gBAEzC,SAAS,EAAE,aAAa;IAK5C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;IAI/C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAItC;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAYvD;;;;;;;;;;;;;;;;;;;OAmBG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASlD;;;;;OAKG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;IAiB7C;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IASpD;;;;;OAKG;IACG,YAAY,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAIzE;;;;;OAKG;IACG,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAIrF;;;;;OAKG;IACG,WAAW,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItE;;;;;;OAMG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvF;;;;OAIG;IACH,gBAAgB,IAAI,aAAa;IAIjC;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/managers/user-manager.d.ts

@@ -327,33 +327,36 @@ export declare class UserManager {
      */
     updateUser(userId: string, userData: UserCreateRequestDTO): Promise<UserDTO>;
     /**
-     * Admin: Toggle user active status
+     * Admin: Set or toggle user active status
      *
-     * Toggles the active/inactive status of a user account. This is typically
-     * used for account suspension or reactivation. Requires administrator privileges.
+     * Sets the active/inactive status of a user account explicitly, or toggles
+     * if no explicit value is provided. This is typically used for account
+     * suspension or reactivation. Requires administrator privileges.
      *
-     * @param user - User object to toggle status for
+     * @param userId - User ID to update
+     * @param isActive - Optional explicit status. If provided, sets to this value. If omitted, toggles current status.
      * @returns Promise resolving to updated user data
      * @throws {PersApiError} When not authenticated as admin
      *
-     * @example Suspend User
+     * @example Explicit Status
      * ```typescript
-     * // Admin operation - toggle user status
-     * try {
-     *   const user = await sdk.users.getUserById('problematic-user-123');
-     *   const updated = await sdk.users.toggleUserStatus(user);
+     * // Admin operation - explicitly activate user
+     * const activated = await sdk.users.setUserActiveStatus('user-123', true);
+     * console.log('User activated:', activated.isActive); // true
      *
-     *   if (updated.isActive) {
-     *     console.log('User account reactivated');
-     *   } else {
-     *     console.log('User account suspended');
-     *   }
-     * } catch (error) {
-     *   console.log('Failed to update user status');
-     * }
+     * // Explicitly deactivate user
+     * const deactivated = await sdk.users.setUserActiveStatus('user-123', false);
+     * console.log('User deactivated:', deactivated.isActive); // false
+     * ```
+     *
+     * @example Toggle Status
+     * ```typescript
+     * // Admin operation - toggle current status
+     * const toggled = await sdk.users.setUserActiveStatus('user-123');
+     * console.log('User status toggled:', toggled.isActive);
      * ```
      */
-    toggleUserStatus(user: UserDTO): Promise<UserDTO>;
+    setUserActiveStatus(userId: string, isActive?: boolean): Promise<UserDTO>;
     /**
      * Admin: Delete user (soft delete)
      *

package/dist/managers/user-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-manager.d.ts","sourceRoot":"","sources":["../../src/managers/user-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"user-manager.d.ts","sourceRoot":"","sources":["../../src/managers/user-manager.ts"],"names":[],"mappings":"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"}

package/dist/managers/web3-manager.d.ts

@@ -1,7 +1,8 @@
 import { PersApiClient } from '../core/pers-api-client';
 import { Web3ApplicationService } from '../web3/application/web3-application.service';
+import { TenantManager } from './tenant-manager';
 import type { TokenBalanceRequest, TokenCollectionRequest, TokenBalance, TokenCollection, TokenMetadata, AccountOwnedTokensResult } from '../web3/application/web3-application.service';
-import type { ChainData } from '../web3-chain';
+import type { ChainDataDTO } from '@explorins/pers-shared';
 import type { TokenDTO } from '../token/models';
 /**
  * Web3 Manager - Clean, high-level interface for Web3 operations
@@ -39,12 +40,18 @@ import type { TokenDTO } from '../token/models';
  *   tokenIds  // Required for ERC-1155, optional for ERC-721
  * });
  * ```
+ *
+ * ## IPFS Resolution
+ *
+ * For IPFS URL resolution, use `sdk.tenant.resolveIPFSUrl()` instead.
+ * IPFS is chain-agnostic and configured at the tenant level.
  */
 export declare class Web3Manager {
     private apiClient;
     private web3ApplicationService;
     private web3ChainService;
-    constructor(apiClient: PersApiClient);
+    private tenantManager;
+    constructor(apiClient: PersApiClient, tenantManager?: TenantManager);
     /**
      * Get token balance for a specific token
      *
@@ -66,29 +73,20 @@ export declare class Web3Manager {
      * @returns Promise resolving to token collection
      */
     getTokenCollection(request: TokenCollectionRequest): Promise<TokenCollection>;
-    /**
-     * Resolve IPFS URL to accessible URL
-     *
-     * @param url - IPFS URL to resolve
-     * @param chainId - Chain ID for context
-     * @returns Promise resolving to accessible URL
-     */
-    resolveIPFSUrl(url: string, chainId: number): Promise<string>;
     /**
      * Fetch and process token metadata
      *
      * @param tokenUri - Token URI to fetch metadata from
-     * @param chainId - Chain ID for context
      * @returns Promise resolving to processed metadata or null if not found
      */
-    fetchAndProcessMetadata(tokenUri: string, chainId: number): Promise<TokenMetadata | null>;
+    fetchAndProcessMetadata(tokenUri: string): Promise<TokenMetadata | null>;
     /**
      * Get blockchain chain data by chain ID
      *
      * @param chainId - Chain ID to get data for
      * @returns Promise resolving to chain data or null if not found
      */
-    getChainDataById(chainId: number): Promise<ChainData | null>;
+    getChainDataById(chainId: number): Promise<ChainDataDTO | null>;
     /**
      * Get explorer URL for a given address or transaction
      *
@@ -150,7 +148,7 @@ export declare class Web3Manager {
      *
      * @param accountAddress - Any valid blockchain address (wallet, contract, etc.)
      * @param token - Token definition (from getRewardTokens, getStatusTokens, etc.)
-     * @param maxTokens - Maximum tokens to retrieve (default: 50)
+     * @param maxTokens - Maximum tokens to retrieve (default: 100, max: 100)
      * @returns Promise resolving to collection result with owned tokens
      *
      * @example Query user's wallet

package/dist/managers/web3-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web3-manager.d.ts","sourceRoot":"","sources":["../../src/managers/web3-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAItF,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,wBAAwB,EACzB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,WAAW;IAYV,OAAO,CAAC,SAAS;IAX7B,OAAO,CAAC,sBAAsB,CAAyB;IACvD,OAAO,CAAC,gBAAgB,CAAmB;gBAUvB,SAAS,EAAE,aAAa;IAW5C;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI1E;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAInF;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAInF;;;;;;OAMG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAInE;;;;;;OAMG;IACG,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAI/F;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAIlE;;;;;;;OAOG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,GAAG,IAAI,GACrB,OAAO,CAAC,MAAM,CAAC;IASlB;;;;OAIG;IACH,yBAAyB,IAAI,sBAAsB;IAQnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE,GAAG,SAAS;IAOtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,iCAAiC,CACrC,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,QAAQ,EACf,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,wBAAwB,CAAC;IAiCpC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,sBAAsB,CACpB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,QAAQ,EACf,SAAS,GAAE,MAAW,GACrB,sBAAsB;CAU1B"}
+{"version":3,"file":"web3-manager.d.ts","sourceRoot":"","sources":["../../src/managers/web3-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAItF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,wBAAwB,EACzB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,WAAW;IAaV,OAAO,CAAC,SAAS;IAZ7B,OAAO,CAAC,sBAAsB,CAAyB;IACvD,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAgB;gBAUjB,SAAS,EAAE,aAAa,EAAE,aAAa,CAAC,EAAE,aAAa;IAc3E;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI1E;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAInF;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAInF;;;;;OAKG;IACG,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAI9E;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAIrE;;;;;;;OAOG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,GAAG,IAAI,GACrB,OAAO,CAAC,MAAM,CAAC;IASlB;;;;OAIG;IACH,yBAAyB,IAAI,sBAAsB;IAQnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE,GAAG,SAAS;IAOtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,iCAAiC,CACrC,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,QAAQ,EACf,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,wBAAwB,CAAC;IAiCpC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,sBAAsB,CACpB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,QAAQ,EACf,SAAS,GAAE,MAAW,GACrB,sBAAsB;CAU1B"}