@explorins/pers-sdk 1.1.2 → 1.2.0

package/dist/user.js

@@ -0,0 +1,184 @@
+/**
+ * Platform-Agnostic User API Client
+ *
+ * Handles user operations using the PERS backend RESTful API.
+ * Updated to use new /users endpoints with enhanced security and consistency.
+ * Maintains framework UserApiService method compatibility.
+ */
+class UserApi {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+        this.basePath = '/users';
+    }
+    // ==========================================
+    // PUBLIC OPERATIONS
+    // ==========================================
+    /**
+     * PUBLIC: Get all users public profiles with optional filtering
+     * ✅ UPDATED: Uses new RESTful /users/public endpoint
+     */
+    async getAllUsersPublicProfiles(filter = null) {
+        let url = `${this.basePath}/public`;
+        if (filter) {
+            // ✅ MAINTAINED: Same parameter pattern for compatibility
+            const params = new URLSearchParams();
+            params.set('filterKey', filter.key);
+            params.set('filterValue', filter.value);
+            url += `?${params.toString()}`;
+        }
+        return this.apiClient.get(url);
+    }
+    // ==========================================
+    // AUTHENTICATED OPERATIONS
+    // ==========================================
+    /**
+     * AUTH: Get current authenticated user
+     * ✅ UPDATED: Uses new RESTful /users/me endpoint
+     */
+    async getRemoteUser() {
+        return this.apiClient.get(`${this.basePath}/me`);
+    }
+    /**
+     * AUTH: Update current authenticated user
+     * ✅ UPDATED: Uses new RESTful /users/me endpoint
+     */
+    async updateRemoteUser(updateRequest) {
+        return this.apiClient.put(`${this.basePath}/me`, updateRequest);
+    }
+    // ==========================================
+    // ADMIN OPERATIONS
+    // ==========================================
+    /**
+     * ADMIN: Get all remote users with query parameters
+     * ✅ UPDATED: Uses new RESTful /users endpoint with role-based access
+     * Note: Admin users get full data, non-admin users get public profiles only
+     */
+    async getAllRemoteUsers() {
+        // ✅ MAINTAINED: Same merge=soft parameter for compatibility
+        const url = `${this.basePath}?merge=soft`;
+        return this.apiClient.get(url);
+    }
+    /**
+     * ADMIN: Update user as admin
+     * ✅ UPDATED: Uses new RESTful /users/{id} endpoint
+     */
+    async updateUserAsAdmin(id, userData) {
+        return this.apiClient.put(`${this.basePath}/${id}`, userData);
+    }
+    /**
+     * ADMIN: Toggle user active status
+     * ✅ UPDATED: Uses new consistent /users/{id}/status endpoint
+     * Enhanced: Follows RESTful status management pattern across all domains
+     */
+    async toggleUserActiveStatusByUser(user) {
+        return this.apiClient.put(`${this.basePath}/${user.id}/status`, {});
+    }
+    /**
+     * ADMIN: Get user by unique identifier
+     * ✅ UPDATED: Uses new RESTful /users/{id} endpoint
+     */
+    async getUserByUniqueIdentifier(id) {
+        return this.apiClient.get(`${this.basePath}/${id}`);
+    }
+}
+
+/**
+ * Platform-Agnostic User Service
+ *
+ * Contains user business logic and operations that work across platforms.
+ * No framework dependencies - pure TypeScript business logic.
+ * Matches framework UserApiService capabilities exactly.
+ */
+class UserService {
+    constructor(userApi) {
+        this.userApi = userApi;
+    }
+    // ==========================================
+    // PUBLIC OPERATIONS
+    // ==========================================
+    /**
+     * PUBLIC: Get all users public profiles with optional filtering
+     * ✅ FIXED: Uses framework-compatible inline filter type
+     */
+    async getAllUsersPublicProfiles(filter = null) {
+        return this.userApi.getAllUsersPublicProfiles(filter);
+    }
+    // ==========================================
+    // AUTHENTICATED OPERATIONS
+    // ==========================================
+    /**
+     * AUTH: Get current authenticated user
+     */
+    async getRemoteUser() {
+        return this.userApi.getRemoteUser();
+    }
+    /**
+     * AUTH: Update current authenticated user
+     */
+    async updateRemoteUser(updateRequest) {
+        return this.userApi.updateRemoteUser(updateRequest);
+    }
+    // ==========================================
+    // ADMIN OPERATIONS
+    // ==========================================
+    /**
+     * ADMIN: Get all remote users
+     * ✅ FIXED: Matches API method signature (no parameters needed)
+     */
+    async getAllRemoteUsers() {
+        return this.userApi.getAllRemoteUsers();
+    }
+    /**
+     * ADMIN: Update user as admin
+     */
+    async updateUserAsAdmin(id, userData) {
+        return this.userApi.updateUserAsAdmin(id, userData);
+    }
+    async getUserByUniqueIdentifier(id) {
+        return this.userApi.getUserByUniqueIdentifier(id);
+    }
+    /**
+     * ADMIN: Toggle user active status by user object
+     * ✅ FIXED: Matches API method signature exactly
+     */
+    async toggleUserActiveStatusByUser(user) {
+        return this.userApi.toggleUserActiveStatusByUser(user);
+    }
+}
+
+/**
+ * @explorins/pers-sdk-user
+ *
+ * Platform-agnostic User Domain SDK for PERS ecosystem
+ * Handles user management, profiles, and authentication operations
+ */
+// API Layer
+/**
+ * Create a complete User SDK instance
+ *
+ * @param apiClient - Configured PERS API client
+ * @returns User SDK with flattened structure for better DX
+ */
+function createUserSDK(apiClient) {
+    const userApi = new UserApi(apiClient);
+    const userService = new UserService(userApi);
+    return {
+        // Direct access to service methods (primary interface)
+        // Public methods - matches framework exactly
+        getAllUsersPublicProfiles: (filter = null) => userService.getAllUsersPublicProfiles(filter),
+        // Auth methods - matches framework exactly
+        getRemoteUser: () => userService.getRemoteUser(),
+        updateRemoteUser: (updateRequest) => userService.updateRemoteUser(updateRequest),
+        // Admin methods - matches framework exactly
+        getAllRemoteUsers: () => userService.getAllRemoteUsers(),
+        updateUserAsAdmin: (id, userData) => userService.updateUserAsAdmin(id, userData),
+        toggleUserActiveStatusByUser: (user) => userService.toggleUserActiveStatusByUser(user),
+        getUserByUniqueIdentifier: (id) => userService.getUserByUniqueIdentifier(id),
+        // Advanced access for edge cases
+        api: userApi,
+        service: userService
+    };
+}
+
+export { UserApi, UserService, createUserSDK };
+//# sourceMappingURL=user.js.map

package/dist/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sources":["../src/user/api/user-api.ts","../src/user/services/user-service.ts","../src/user/index.ts"],"sourcesContent":[null,null,null],"names":[],"mappings":"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"}

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

@@ -0,0 +1,27 @@
+import { Web3ChainService } from '../../web3-chain/services/web3-chain-service';
+import type { ContractAbi } from 'web3';
+export declare class Web3Api {
+    private web3ChainService;
+    constructor(web3ChainService: Web3ChainService);
+    getTokenBalance(request: {
+        accountAddress: string;
+        contractAddress: string;
+        abi: ContractAbi;
+        tokenId: string | null;
+        chainId: number;
+    }): Promise<number>;
+    getTokenUri(request: {
+        contractAddress: string;
+        abi: ContractAbi;
+        tokenId: string;
+        chainId: number;
+    }): Promise<string>;
+    getTokenOfOwnerByIndex(request: {
+        contractAddress: string;
+        abi: ContractAbi;
+        accountAddress: string;
+        tokenIndex: number;
+        chainId: number;
+    }): Promise<string>;
+}
+//# sourceMappingURL=web3-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web3-api.d.ts","sourceRoot":"","sources":["../../../src/web3/api/web3-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AASxC,qBAAa,OAAO;IAGhB,OAAO,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,gBAAgB;IAGtC,eAAe,CAAC,OAAO,EAAE;QAC7B,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,WAAW,CAAC;QACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,MAAM,CAAC;IAab,WAAW,CAAC,OAAO,EAAE;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,WAAW,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,MAAM,CAAC;IAYb,sBAAsB,CAAC,OAAO,EAAE;QACpC,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,WAAW,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,MAAM,CAAC;CASpB"}

package/dist/web3/index.d.ts

@@ -0,0 +1,16 @@
+import { PersApiClient } from '../core/pers-api-client';
+import { Web3Api } from './api/web3-api';
+import { Web3Service } from './services/web3-service';
+import { ERC1155CollectionRequest, ERC20BalanceRequest, ERC721CollectionRequest, ERC721CollectionResponse, Web3BalanceResponse, Web3TokenListResponse } from './models';
+import { Web3ProviderService } from '../web3-chain/services/provider.service';
+export declare function createWeb3SDK(apiClient: PersApiClient, web3ProviderService: Web3ProviderService): {
+    getCreditsBalance: (request: ERC20BalanceRequest) => Promise<Web3BalanceResponse>;
+    getRewardsCollection: (request: ERC1155CollectionRequest) => Promise<Web3TokenListResponse>;
+    getStampsCollection: (request: ERC721CollectionRequest) => Promise<ERC721CollectionResponse>;
+    api: Web3Api;
+    service: Web3Service;
+};
+export * from './models';
+export type { ERC20BalanceRequest, ERC1155CollectionRequest, ERC721CollectionRequest, ERC721CollectionResponse, NFTItem } from './models';
+export * from '../shared/interfaces/pers-shared-lib.interfaces';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web3/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAe,wBAAwB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,wBAAwB,EAAsB,mBAAmB,EAAwB,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAC/N,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAE9E,wBAAgB,aAAa,CAC3B,SAAS,EAAE,aAAa,EACxB,mBAAmB,EAAE,mBAAmB;iCAYT,mBAAmB,KAAG,OAAO,CAAC,mBAAmB,CAAC;oCAG/C,wBAAwB,KAAG,OAAO,CAAC,qBAAqB,CAAC;mCAG1D,uBAAuB,KAAG,OAAO,CAAC,wBAAwB,CAAC;;;EAM7F;AAED,cAAc,UAAU,CAAC;AACzB,YAAY,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1I,cAAc,iDAAiD,CAAC"}

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

@@ -0,0 +1,92 @@
+import type { TokenDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
+export interface Web3BalanceRequest {
+    accountAddress: string;
+    token: TokenDTO;
+    tokenId: string | null;
+}
+export interface Web3BalanceResponse {
+    rawBalance: number;
+    formattedBalance: string;
+    decimals: number;
+    symbol: string;
+    hasBalance: boolean;
+}
+export interface Web3TokenConfig {
+    token: TokenDTO;
+    tokenIds?: (string | null)[];
+    metadata?: any[];
+}
+export interface Web3TokenListRequest {
+    accountAddress: string;
+    tokens: Web3TokenConfig[];
+}
+export interface Web3TokenResult {
+    tokenId: string | null;
+    balance: number;
+    formattedBalance: string;
+    hasBalance: boolean;
+    metadata: any | null;
+}
+export interface Web3TokenListResponse {
+    accountAddress: string;
+    tokens: {
+        token: TokenDTO;
+        results: Web3TokenResult[];
+    }[];
+}
+export interface NFTItem {
+    tokenId: string;
+    name: string;
+    description: string;
+    imageUrl: string;
+    rawBalance: number;
+    formattedBalance: string;
+    hasBalance: boolean;
+    metadata: any;
+    tokenIndex: number;
+}
+export interface ERC721CollectionRequest {
+    accountAddress: string;
+    nftContracts: TokenDTO[];
+    maxNFTsPerContract?: number;
+}
+export interface ERC721CollectionResponse {
+    accountAddress: string;
+    contracts: {
+        token: TokenDTO;
+        totalNFTs: number;
+        nfts: NFTItem[];
+        hasMore: boolean;
+    }[];
+    summary: {
+        totalContracts: number;
+        totalNFTs: number;
+        loadingTime: number;
+    };
+}
+export interface ERC20BalanceRequest {
+    accountAddress: string;
+    token: TokenDTO;
+}
+export interface ERC1155CollectionRequest {
+    accountAddress: string;
+    tokens: TokenDTO[];
+}
+export type { ContractAbi } from 'web3';
+export interface CacheEntry<T> {
+    data: T;
+    timestamp: number;
+    ttl: number;
+}
+export interface CacheStorage {
+    [key: string]: CacheEntry<unknown>;
+}
+export declare class SimpleCache {
+    private storage;
+    private readonly defaultTTL;
+    set<T>(key: string, data: T, ttl?: number): void;
+    get<T>(key: string): T | null;
+    clear(): void;
+    cleanup(): void;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/web3/services/web3-service.d.ts

@@ -0,0 +1,21 @@
+import { Web3ChainService } from '../../web3-chain';
+import { Web3Api } from '../api/web3-api';
+import { ERC20BalanceRequest, ERC1155CollectionRequest, ERC721CollectionRequest, ERC721CollectionResponse, Web3BalanceResponse, Web3TokenListResponse } from '../models';
+export declare class Web3Service {
+    private web3Api;
+    private web3ChainService;
+    private readonly defaultIpfsGatewayDomain;
+    private cache;
+    private cleanupInterval;
+    constructor(web3Api: Web3Api, web3ChainService: Web3ChainService);
+    destroy(): void;
+    getERC20Balance(request: ERC20BalanceRequest): Promise<Web3BalanceResponse>;
+    getERC1155Collection(request: ERC1155CollectionRequest): Promise<Web3TokenListResponse>;
+    getERC721Collection(request: ERC721CollectionRequest): Promise<ERC721CollectionResponse>;
+    private formatBalance;
+    private findMetadata;
+    private fetchMetadata;
+    private getIpfsGatewayDomain;
+    private resolveIPFSUrl;
+}
+//# sourceMappingURL=web3-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web3-service.d.ts","sourceRoot":"","sources":["../../../src/web3/services/web3-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EAExB,mBAAmB,EACnB,qBAAqB,EAGtB,MAAM,WAAW,CAAC;AAEnB,qBAAa,WAAW;IASpB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,gBAAgB;IAR1B,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAyB;IAGlE,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,eAAe,CAA+B;gBAG5C,OAAO,EAAE,OAAO,EAChB,gBAAgB,EAAE,gBAAgB;IAO5C,OAAO,IAAI,IAAI;IAQT,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsC3E,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA6EvF,mBAAmB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAkI9F,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,YAAY;YAON,aAAa;YAgBb,oBAAoB;YAUpB,cAAc;CAU7B"}

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

@@ -0,0 +1,19 @@
+import { PersApiClient } from '../../core/pers-api-client';
+import { ChainData } from '../models';
+/**
+ * Platform-Agnostic Web3 Chain API Client
+ *
+ * Handles blockchain chain operations using the PERS backend.
+ * Uses @explorins/web3-ts types for perfect framework compatibility.
+ */
+export declare class Web3ChainApi {
+    private apiClient;
+    constructor(apiClient: PersApiClient);
+    private basePath;
+    /**
+     * PUBLIC: Get chain data by chain ID
+     * ✅ Returns ChainData exactly as framework expects from @explorins/web3-ts
+     */
+    getChainData(chainId: number): Promise<ChainData>;
+}
+//# sourceMappingURL=web3-chain-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web3-chain-api.d.ts","sourceRoot":"","sources":["../../../src/web3-chain/api/web3-chain-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;;GAKG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C,OAAO,CAAC,QAAQ,CAAa;IAM7B;;;OAGG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CAmBxD"}

package/dist/web3-chain/index.d.ts

@@ -0,0 +1,17 @@
+import { PersApiClient } from '../core/pers-api-client';
+import { Web3ChainApi } from './api/web3-chain-api';
+import { Web3ProviderService } from './services/provider.service';
+import { Web3ChainService } from './services/web3-chain-service';
+export declare function createWeb3ChainSDK(apiClient: PersApiClient, providerService: Web3ProviderService): {
+    getChainDataById: (chainId: number) => Promise<import("./models").ChainData | null>;
+    getWeb3ByChainId: (chainId: number) => Promise<import("web3").default<import("web3-eth").RegisteredSubscription>>;
+    api: Web3ChainApi;
+    service: Web3ChainService;
+};
+export { Web3ChainApi } from './api/web3-chain-api';
+export { Web3ChainService } from './services/web3-chain-service';
+export { Web3ProviderService } from './services/provider.service';
+export * from './models';
+export type { ChainData } from './models';
+export * from '../shared/interfaces/pers-shared-lib.interfaces';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web3-chain/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,mBAAmB;gCAMjE,MAAM;gCACN,MAAM;;;EAKrC;AAGD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,cAAc,UAAU,CAAC;AACzB,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,cAAc,iDAAiD,CAAC"}

package/{src/web3-chain/models/index.ts → dist/web3-chain/models/index.d.ts}

@@ -1,45 +1,38 @@
-/**
- * Web3 Chain Domain Models
- * 
- * Minimal interface definitions matching framework usage exactly.
- * Local ChainData interface to avoid external dependency issues.
- */
-
-import type { Web3 } from "web3";
-
-// ✅ FIXED: Local ChainData interface instead of problematic external import
-export interface ChainData {
-    name: string;
-    shortName?: string;
-    chain?: string;
-    network?: string;
-    chainId?: number;
-    networkId?: number | null;
-    rpcUrl: string;
-    explorerUrl?: string;
-    authHeader?: string;
-    nativeCurrency?: any;
-    chainType: ChainType;
-    ipfsGatewayDomain?: string;
-}
-
-export type ChainType = typeof ChainTypes[keyof typeof ChainTypes];
-
-export const ChainTypes = {
-  PUBLIC: 'PUBLIC',
-  PRIVATE: 'PRIVATE'
-} as const;
-
-export interface CachedWeb3Instance {
-  instance: Web3;
-  createdAt: number;
-  chainId: number;
-}
-
-export interface CachedChainInstance {
-  web3Instance: Web3;
-  chainData: ChainData;
-  createdAt: number;
-  chainId: number;
-}
-
+/**
+ * Web3 Chain Domain Models
+ *
+ * Minimal interface definitions matching framework usage exactly.
+ * Local ChainData interface to avoid external dependency issues.
+ */
+import type { Web3 } from "web3";
+export interface ChainData {
+    name: string;
+    shortName?: string;
+    chain?: string;
+    network?: string;
+    chainId?: number;
+    networkId?: number | null;
+    rpcUrl: string;
+    explorerUrl?: string;
+    authHeader?: string;
+    nativeCurrency?: any;
+    chainType: ChainType;
+    ipfsGatewayDomain?: string;
+}
+export type ChainType = typeof ChainTypes[keyof typeof ChainTypes];
+export declare const ChainTypes: {
+    readonly PUBLIC: "PUBLIC";
+    readonly PRIVATE: "PRIVATE";
+};
+export interface CachedWeb3Instance {
+    instance: Web3;
+    createdAt: number;
+    chainId: number;
+}
+export interface CachedChainInstance {
+    web3Instance: Web3;
+    chainData: ChainData;
+    createdAt: number;
+    chainId: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/web3-chain/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/web3-chain/models/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAGjC,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEnE,eAAO,MAAM,UAAU;;;CAGb,CAAC;AAEX,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,IAAI,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/web3-chain/services/getWeb3FCD.service.d.ts

@@ -0,0 +1,8 @@
+import { ChainData } from "@explorins/web3-ts";
+import { JsonRpcProvider } from "ethers";
+export declare const getWeb3ProviderFromChainData: (chainData: ChainData, timeout?: number, customUserAgentName?: string, tokenRefresher?: () => Promise<string>) => {
+    web3Provider: null;
+    ethersProvider: JsonRpcProvider;
+    isAuthenticated: boolean;
+};
+//# sourceMappingURL=getWeb3FCD.service.d.ts.map

package/dist/web3-chain/services/getWeb3FCD.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWeb3FCD.service.d.ts","sourceRoot":"","sources":["../../../src/web3-chain/services/getWeb3FCD.service.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAgB,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEvD,eAAO,MAAM,4BAA4B,GACvC,WAAW,SAAS,EACpB,gBAAe,EACf,4BAAwB,EACxB,iBAAiB,MAAM,OAAO,CAAC,MAAM,CAAC;;;;CAmCvC,CAAC"}

package/dist/web3-chain/services/provider.service.d.ts

@@ -0,0 +1,15 @@
+import Web3 from "web3";
+import { ChainData, ChainType } from "@explorins/web3-ts";
+import { PublicHttpProviderService } from "./public-http-provider.service";
+export declare class Web3ProviderService {
+    private readonly publicHttpProviderService;
+    private _web3;
+    private _currentChainId;
+    constructor(publicHttpProviderService: PublicHttpProviderService);
+    getWeb3(chainId: number, chainType: ChainType, privateChainData?: ChainData | null): Promise<Web3<import("web3-eth").RegisteredSubscription>>;
+    private getWeb3ByChainId;
+    private convertToWeb3;
+    private extractUrlFromEthersProvider;
+    private extractHeadersFromEthersProvider;
+}
+//# sourceMappingURL=provider.service.d.ts.map

package/dist/web3-chain/services/provider.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.service.d.ts","sourceRoot":"","sources":["../../../src/web3-chain/services/provider.service.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAc,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAI3E,qBAAa,mBAAmB;IAMxB,OAAO,CAAC,QAAQ,CAAC,yBAAyB;IAJ9C,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,eAAe,CAAuB;gBAGzB,yBAAyB,EAAE,yBAAyB;IAI5D,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,GAAE,SAAS,GAAG,IAAW;IAkBrG,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,aAAa;IAwDrB,OAAO,CAAC,4BAA4B;IAOpC,OAAO,CAAC,gCAAgC;CAK3C"}

package/dist/web3-chain/services/public-http-provider.service.d.ts

@@ -0,0 +1,8 @@
+import type { PublicWeb3ProviderData } from "@explorins/web3/types";
+import type Web3 from "web3";
+export declare class PublicHttpProviderService {
+    private $providerData;
+    constructor(providerData?: PublicWeb3ProviderData | null);
+    getProvider(chainId: number): Web3;
+}
+//# sourceMappingURL=public-http-provider.service.d.ts.map

package/dist/web3-chain/services/public-http-provider.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-http-provider.service.d.ts","sourceRoot":"","sources":["../../../src/web3-chain/services/public-http-provider.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAI7B,qBAAa,yBAAyB;IAClC,OAAO,CAAC,aAAa,CAAgC;gBAEzC,YAAY,GAAE,sBAAsB,GAAG,IAAW;IAIvD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAa5C"}

package/dist/web3-chain/services/web3-chain-service.d.ts

@@ -0,0 +1,17 @@
+import { Web3ChainApi } from '../api/web3-chain-api';
+import { ChainData } from '../models';
+import type { Web3 } from 'web3';
+import { Web3ProviderService } from './provider.service';
+export declare class Web3ChainService {
+    private web3ChainApi;
+    private providerService;
+    private web3InstanceCache;
+    constructor(web3ChainApi: Web3ChainApi, providerService: Web3ProviderService);
+    getWeb3ByChainId(chainId: number): Promise<Web3>;
+    getChainDataWithCache(chainId: number): Promise<ChainData>;
+    private checkIsTokenExpired;
+    private createWeb3Instance;
+    private isAuthError;
+    getChainDataById(chainId: number): Promise<ChainData | null>;
+}
+//# sourceMappingURL=web3-chain-service.d.ts.map

package/dist/web3-chain/services/web3-chain-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web3-chain-service.d.ts","sourceRoot":"","sources":["../../../src/web3-chain/services/web3-chain-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAuB,MAAM,WAAW,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,eAAe;IAJzB,OAAO,CAAC,iBAAiB,CAA0C;gBAGzD,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,mBAAmB;IAGxC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8ChD,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAkBhE,OAAO,CAAC,mBAAmB;YAUb,kBAAkB;IAuBhC,OAAO,CAAC,WAAW;IAUb,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;CAQnE"}