@explorins/pers-sdk 2.0.7 → 2.0.11

package/dist/chunks/web3-chain-service-D68-0WaW.cjs

@@ -0,0 +1,224 @@
+'use strict';
+
+var index = require('./index-B-g2JPVK.cjs');
+var index$1 = require('./index-B6-bbNnd.cjs');
+var ethers = require('@explorins/web3-ts/ethers');
+
+/**
+ * Platform-Agnostic Web3 Chain API Client
+ *
+ * Handles blockchain chain operations using the PERS backend.
+ * Uses @explorins/web3-ts types for perfect framework compatibility.
+ */
+class Web3ChainApi {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+        this.basePath = '/chains';
+    }
+    // ==========================================
+    // PUBLIC OPERATIONS
+    // ==========================================
+    /**
+     * PUBLIC: Get chain data by chain ID
+     */
+    async getChainData(chainId) {
+        try {
+            const response = await this.apiClient.get(`${this.basePath}/${chainId}`);
+            if (!response) {
+                throw new Error(`No chain data received for chainId: ${chainId}`);
+            }
+            return response;
+        }
+        catch (error) {
+            console.error('[Web3ChainApi] Failed to get chain data:', {
+                chainId,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw error;
+        }
+    }
+}
+
+/**
+ * Create Web3 provider from chain data
+ * Synchronous function for immediate provider creation
+ */
+const getWeb3ProviderFromChainData = (chainData, timeout = 15000, customUserAgentName = '', tokenRefresher) => {
+    let ethersProvider;
+    if (chainData.authHeader) {
+        // Authenticated provider for private chains
+        const fetchRequest = new ethers.FetchRequest(chainData.rpcUrl);
+        fetchRequest.timeout = timeout;
+        // Handle auth header format
+        const authValue = chainData.authHeader.startsWith('Bearer ')
+            ? chainData.authHeader
+            : `Bearer ${chainData.authHeader}`;
+        fetchRequest.setHeader('Authorization', authValue);
+        fetchRequest.setHeader('Content-Type', 'application/json');
+        fetchRequest.setHeader('Accept', 'application/json');
+        if (customUserAgentName) {
+            fetchRequest.setHeader('User-Agent', customUserAgentName);
+        }
+        ethersProvider = new ethers.JsonRpcProvider(fetchRequest, chainData.chainId, {
+            staticNetwork: true, // Prevent eth_chainId calls - we know the chain
+            polling: false,
+            batchMaxCount: 1, // Disable batching for private chains
+        });
+    }
+    else {
+        // Public provider for public chains
+        ethersProvider = new ethers.JsonRpcProvider(chainData.rpcUrl, chainData.chainId, {
+            staticNetwork: true, // Prevent eth_chainId calls - we know the chain
+            polling: false,
+        });
+    }
+    return ethersProvider;
+};
+/**
+ * Async wrapper with retry logic for higher-level usage
+ */
+const getWeb3ProviderWithRetry = async (chainData, timeout = 15000, customUserAgentName = '', tokenRefresher, retryConfig = { maxAttempts: 3, baseDelay: 1000, maxDelay: 8000 }) => {
+    let lastError = null;
+    for (let attempt = 1; attempt <= retryConfig.maxAttempts; attempt++) {
+        try {
+            const provider = getWeb3ProviderFromChainData(chainData, timeout, customUserAgentName, tokenRefresher);
+            await validateChainConnection(provider, chainData.authHeader ? 'private' : 'public');
+            return provider;
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // Stop retrying on auth errors for authenticated chains
+            if (index.ApiErrorDetector.isAuthError(lastError) && chainData.authHeader) {
+                break;
+            }
+            if (attempt === retryConfig.maxAttempts)
+                break;
+            const delay = Math.min(retryConfig.baseDelay * Math.pow(2, attempt - 1), retryConfig.maxDelay);
+            await sleep(delay);
+        }
+    }
+    throw new Error(`Failed to create Web3 provider after ${retryConfig.maxAttempts} attempts. Last error: ${lastError?.message}`);
+};
+async function validateChainConnection(provider, chainType) {
+    try {
+        // Lightweight test using eth_chainId (works for both public and private)
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => reject(new Error(`${chainType} chain validation timeout`)), 3000);
+        });
+        const chainIdPromise = provider.send('eth_chainId', []);
+        await Promise.race([chainIdPromise, timeoutPromise]);
+    }
+    catch (error) {
+        // Fallback: try net_version if chainId fails
+        try {
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => reject(new Error(`${chainType} chain fallback validation timeout`)), 3000);
+            });
+            const versionPromise = provider.send('net_version', []);
+            await Promise.race([versionPromise, timeoutPromise]);
+        }
+        catch (fallbackError) {
+            throw new Error(`${chainType} chain validation failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+class Web3ChainService {
+    constructor(web3ChainApi) {
+        this.web3ChainApi = web3ChainApi;
+        this.cache = index$1.globalCacheService.createNamespace('web3-chain');
+    }
+    async getEthersProviderByChainId(chainId) {
+        const cacheKey = `provider:${chainId}`;
+        // Check if we have a valid cached provider
+        const cached = this.cache.get(cacheKey);
+        if (cached && !this.checkIsTokenExpired(cached.chainData.authHeader)) {
+            return cached.provider;
+        }
+        try {
+            // Create new provider instance
+            const { provider, chainData } = await this.createProviderInstance(chainId);
+            // Cache the provider with chain data
+            const cacheEntry = {
+                provider,
+                chainData,
+                createdAt: Date.now(),
+                chainId
+            };
+            this.cache.set(cacheKey, cacheEntry, index$1.CacheTTL.PROVIDER);
+            return provider;
+        }
+        catch (error) {
+            // ✅ AUTH ERROR RECOVERY: Clear cache and retry once
+            if (index.ApiErrorDetector.isAuthError(error)) {
+                this.cache.delete(cacheKey);
+                // Retry once with fresh instance
+                const { provider, chainData } = await this.createProviderInstance(chainId);
+                const cacheEntry = {
+                    provider,
+                    chainData,
+                    createdAt: Date.now(),
+                    chainId
+                };
+                this.cache.set(cacheKey, cacheEntry, index$1.CacheTTL.PROVIDER);
+                return provider;
+            }
+            throw error;
+        }
+    }
+    async createProviderInstance(chainId) {
+        const chainData = await this.getChainDataWithCache(chainId);
+        if (!chainData) {
+            throw new Error(`Chain data not found for chainId: ${chainId}`);
+        }
+        const provider = await getWeb3ProviderWithRetry(chainData);
+        return { provider, chainData };
+    }
+    async getChainDataWithCache(chainId) {
+        const cacheKey = `chainData:${chainId}`;
+        // First check if we have it in the provider cache (includes token validation)
+        const providerCached = this.cache.get(`provider:${chainId}`);
+        if (providerCached && !this.checkIsTokenExpired(providerCached.chainData.authHeader)) {
+            return providerCached.chainData;
+        }
+        // Otherwise use getOrSet for chainData only
+        return this.cache.getOrSet(cacheKey, async () => {
+            const chainData = await this.web3ChainApi.getChainData(chainId);
+            if (!chainData) {
+                throw new Error(`Chain data not found for chainId: ${chainId}`);
+            }
+            return chainData;
+        }, index$1.CacheTTL.MEDIUM // 30 minutes for chain data
+        );
+    }
+    checkIsTokenExpired(authHeader) {
+        // NULL CHECK: Handle undefined case
+        if (!authHeader) {
+            return false; // No token means no expiration (public chains)
+        }
+        // FUNCTION CALL: Use imported function, not method
+        return index.isTokenExpired(authHeader);
+    }
+    /**
+     * Clear all cached providers and chain data
+     * Useful for logout scenarios or when authentication context changes
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Clear cache for a specific chain
+     * Useful when a specific chain's authentication fails
+     */
+    clearCacheForChain(chainId) {
+        this.cache.delete(`provider:${chainId}`);
+        this.cache.delete(`chainData:${chainId}`);
+    }
+}
+
+exports.Web3ChainApi = Web3ChainApi;
+exports.Web3ChainService = Web3ChainService;
+//# sourceMappingURL=web3-chain-service-D68-0WaW.cjs.map

package/dist/chunks/web3-chain-service-D68-0WaW.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"web3-chain-service-D68-0WaW.cjs","sources":["../../src/web3-chain/api/web3-chain-api.ts","../../src/web3-chain/services/getWeb3FCD.service.ts","../../src/web3-chain/services/web3-chain-service.ts"],"sourcesContent":[null,null,null],"names":["FetchRequest","JsonRpcProvider","ApiErrorDetector","globalCacheService","CacheTTL","isTokenExpired"],"mappings":"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"}

package/dist/chunks/web3-chain-service-DuvxmKSj.js

@@ -0,0 +1,221 @@
+import { b as ApiErrorDetector, i as isTokenExpired } from './index-CKm_V5XE.js';
+import { g as globalCacheService, C as CacheTTL } from './index-DBLskLuH.js';
+import { FetchRequest, JsonRpcProvider } from '@explorins/web3-ts/ethers';
+
+/**
+ * Platform-Agnostic Web3 Chain API Client
+ *
+ * Handles blockchain chain operations using the PERS backend.
+ * Uses @explorins/web3-ts types for perfect framework compatibility.
+ */
+class Web3ChainApi {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+        this.basePath = '/chains';
+    }
+    // ==========================================
+    // PUBLIC OPERATIONS
+    // ==========================================
+    /**
+     * PUBLIC: Get chain data by chain ID
+     */
+    async getChainData(chainId) {
+        try {
+            const response = await this.apiClient.get(`${this.basePath}/${chainId}`);
+            if (!response) {
+                throw new Error(`No chain data received for chainId: ${chainId}`);
+            }
+            return response;
+        }
+        catch (error) {
+            console.error('[Web3ChainApi] Failed to get chain data:', {
+                chainId,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw error;
+        }
+    }
+}
+
+/**
+ * Create Web3 provider from chain data
+ * Synchronous function for immediate provider creation
+ */
+const getWeb3ProviderFromChainData = (chainData, timeout = 15000, customUserAgentName = '', tokenRefresher) => {
+    let ethersProvider;
+    if (chainData.authHeader) {
+        // Authenticated provider for private chains
+        const fetchRequest = new FetchRequest(chainData.rpcUrl);
+        fetchRequest.timeout = timeout;
+        // Handle auth header format
+        const authValue = chainData.authHeader.startsWith('Bearer ')
+            ? chainData.authHeader
+            : `Bearer ${chainData.authHeader}`;
+        fetchRequest.setHeader('Authorization', authValue);
+        fetchRequest.setHeader('Content-Type', 'application/json');
+        fetchRequest.setHeader('Accept', 'application/json');
+        if (customUserAgentName) {
+            fetchRequest.setHeader('User-Agent', customUserAgentName);
+        }
+        ethersProvider = new JsonRpcProvider(fetchRequest, chainData.chainId, {
+            staticNetwork: true, // Prevent eth_chainId calls - we know the chain
+            polling: false,
+            batchMaxCount: 1, // Disable batching for private chains
+        });
+    }
+    else {
+        // Public provider for public chains
+        ethersProvider = new JsonRpcProvider(chainData.rpcUrl, chainData.chainId, {
+            staticNetwork: true, // Prevent eth_chainId calls - we know the chain
+            polling: false,
+        });
+    }
+    return ethersProvider;
+};
+/**
+ * Async wrapper with retry logic for higher-level usage
+ */
+const getWeb3ProviderWithRetry = async (chainData, timeout = 15000, customUserAgentName = '', tokenRefresher, retryConfig = { maxAttempts: 3, baseDelay: 1000, maxDelay: 8000 }) => {
+    let lastError = null;
+    for (let attempt = 1; attempt <= retryConfig.maxAttempts; attempt++) {
+        try {
+            const provider = getWeb3ProviderFromChainData(chainData, timeout, customUserAgentName, tokenRefresher);
+            await validateChainConnection(provider, chainData.authHeader ? 'private' : 'public');
+            return provider;
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // Stop retrying on auth errors for authenticated chains
+            if (ApiErrorDetector.isAuthError(lastError) && chainData.authHeader) {
+                break;
+            }
+            if (attempt === retryConfig.maxAttempts)
+                break;
+            const delay = Math.min(retryConfig.baseDelay * Math.pow(2, attempt - 1), retryConfig.maxDelay);
+            await sleep(delay);
+        }
+    }
+    throw new Error(`Failed to create Web3 provider after ${retryConfig.maxAttempts} attempts. Last error: ${lastError?.message}`);
+};
+async function validateChainConnection(provider, chainType) {
+    try {
+        // Lightweight test using eth_chainId (works for both public and private)
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => reject(new Error(`${chainType} chain validation timeout`)), 3000);
+        });
+        const chainIdPromise = provider.send('eth_chainId', []);
+        await Promise.race([chainIdPromise, timeoutPromise]);
+    }
+    catch (error) {
+        // Fallback: try net_version if chainId fails
+        try {
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => reject(new Error(`${chainType} chain fallback validation timeout`)), 3000);
+            });
+            const versionPromise = provider.send('net_version', []);
+            await Promise.race([versionPromise, timeoutPromise]);
+        }
+        catch (fallbackError) {
+            throw new Error(`${chainType} chain validation failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+class Web3ChainService {
+    constructor(web3ChainApi) {
+        this.web3ChainApi = web3ChainApi;
+        this.cache = globalCacheService.createNamespace('web3-chain');
+    }
+    async getEthersProviderByChainId(chainId) {
+        const cacheKey = `provider:${chainId}`;
+        // Check if we have a valid cached provider
+        const cached = this.cache.get(cacheKey);
+        if (cached && !this.checkIsTokenExpired(cached.chainData.authHeader)) {
+            return cached.provider;
+        }
+        try {
+            // Create new provider instance
+            const { provider, chainData } = await this.createProviderInstance(chainId);
+            // Cache the provider with chain data
+            const cacheEntry = {
+                provider,
+                chainData,
+                createdAt: Date.now(),
+                chainId
+            };
+            this.cache.set(cacheKey, cacheEntry, CacheTTL.PROVIDER);
+            return provider;
+        }
+        catch (error) {
+            // ✅ AUTH ERROR RECOVERY: Clear cache and retry once
+            if (ApiErrorDetector.isAuthError(error)) {
+                this.cache.delete(cacheKey);
+                // Retry once with fresh instance
+                const { provider, chainData } = await this.createProviderInstance(chainId);
+                const cacheEntry = {
+                    provider,
+                    chainData,
+                    createdAt: Date.now(),
+                    chainId
+                };
+                this.cache.set(cacheKey, cacheEntry, CacheTTL.PROVIDER);
+                return provider;
+            }
+            throw error;
+        }
+    }
+    async createProviderInstance(chainId) {
+        const chainData = await this.getChainDataWithCache(chainId);
+        if (!chainData) {
+            throw new Error(`Chain data not found for chainId: ${chainId}`);
+        }
+        const provider = await getWeb3ProviderWithRetry(chainData);
+        return { provider, chainData };
+    }
+    async getChainDataWithCache(chainId) {
+        const cacheKey = `chainData:${chainId}`;
+        // First check if we have it in the provider cache (includes token validation)
+        const providerCached = this.cache.get(`provider:${chainId}`);
+        if (providerCached && !this.checkIsTokenExpired(providerCached.chainData.authHeader)) {
+            return providerCached.chainData;
+        }
+        // Otherwise use getOrSet for chainData only
+        return this.cache.getOrSet(cacheKey, async () => {
+            const chainData = await this.web3ChainApi.getChainData(chainId);
+            if (!chainData) {
+                throw new Error(`Chain data not found for chainId: ${chainId}`);
+            }
+            return chainData;
+        }, CacheTTL.MEDIUM // 30 minutes for chain data
+        );
+    }
+    checkIsTokenExpired(authHeader) {
+        // NULL CHECK: Handle undefined case
+        if (!authHeader) {
+            return false; // No token means no expiration (public chains)
+        }
+        // FUNCTION CALL: Use imported function, not method
+        return isTokenExpired(authHeader);
+    }
+    /**
+     * Clear all cached providers and chain data
+     * Useful for logout scenarios or when authentication context changes
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Clear cache for a specific chain
+     * Useful when a specific chain's authentication fails
+     */
+    clearCacheForChain(chainId) {
+        this.cache.delete(`provider:${chainId}`);
+        this.cache.delete(`chainData:${chainId}`);
+    }
+}
+
+export { Web3ChainApi as W, Web3ChainService as a };
+//# sourceMappingURL=web3-chain-service-DuvxmKSj.js.map

package/dist/chunks/web3-chain-service-DuvxmKSj.js.map

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