@explorins/pers-sdk 1.1.2 → 1.1.3

package/dist/web3-chain.cjs

@@ -0,0 +1,316 @@
+'use strict';
+
+var jwtDecode = require('jwt-decode');
+var Web3 = require('web3');
+var web3Ts = require('@explorins/web3-ts');
+var ethers = require('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
+     * ✅ Returns ChainData exactly as framework expects from @explorins/web3-ts
+     */
+    async getChainData(chainId) {
+        try {
+            console.log('🔍 [Web3ChainApi] Fetching chain data for chainId:', chainId);
+            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;
+        }
+    }
+}
+
+const isTokenExpired = (token, margin = 60) => {
+    // ✅ SANITIZE: Remove any words (Bearer etc) if exists and get the token
+    const cleanToken = token.split(' ')[1] || token;
+    // ✅ VALIDATION: Check if token is jwt
+    if (!cleanToken || cleanToken.split('.').length !== 3) {
+        return true; // Consider invalid tokens as expired
+    }
+    try {
+        // ✅ TYPE-SAFE: Decode with proper typing
+        const decoded = jwtDecode.jwtDecode(cleanToken);
+        const currentTime = Math.floor(Date.now() / 1000);
+        // ✅ CONFIGURABLE: Use provided margin (default 60 seconds)
+        return decoded.exp < (currentTime + margin);
+    }
+    catch (error) {
+        console.error('[SDK JWT Utils] Error decoding JWT token:', error);
+        return true; // Consider unparseable tokens as expired
+    }
+};
+
+class Web3ChainService {
+    constructor(web3ChainApi, providerService) {
+        this.web3ChainApi = web3ChainApi;
+        this.providerService = providerService;
+        this.web3InstanceCache = new Map();
+    }
+    async getWeb3ByChainId(chainId) {
+        const cached = this.web3InstanceCache.get(chainId);
+        // ✅ SMART CACHE: Check if cache is valid based on token expiration
+        if (cached && !this.checkIsTokenExpired(cached.chainData.authHeader)) {
+            console.log(`♻️ [Web3ChainService] Using cached Web3 instance for chain ${chainId}`);
+            return cached.web3Instance;
+        }
+        // ✅ CREATE WITH ERROR RECOVERY: Handle auth errors gracefully
+        try {
+            console.log(`🔧 [Web3ChainService] Creating new Web3 instance for chain ${chainId}`);
+            const { web3, chainData } = await this.createWeb3Instance(chainId);
+            // ✅ CACHE NEW INSTANCE
+            this.web3InstanceCache.set(chainId, {
+                web3Instance: web3,
+                chainData: chainData,
+                createdAt: Date.now(),
+                chainId
+            });
+            return web3;
+        }
+        catch (error) {
+            // ✅ AUTH ERROR RECOVERY: Clear cache and retry once
+            if (this.isAuthError(error)) {
+                console.warn(`🔄 [Web3ChainService] Auth error detected, clearing cache and retrying...`);
+                this.web3InstanceCache.delete(chainId);
+                // Retry once with fresh instance
+                const { web3, chainData } = await this.createWeb3Instance(chainId);
+                this.web3InstanceCache.set(chainId, {
+                    web3Instance: web3,
+                    chainData: chainData,
+                    createdAt: Date.now(),
+                    chainId
+                });
+                return web3;
+            }
+            throw error;
+        }
+    }
+    async getChainDataWithCache(chainId) {
+        const cached = this.web3InstanceCache.get(chainId);
+        //const now = Date.now();
+        if (cached && !this.checkIsTokenExpired(cached.chainData.authHeader)) {
+            console.log(`♻️ [Web3ChainService] Using cached ChainData for chain ${chainId}`);
+            return cached.chainData;
+        }
+        // If not cached, fetch fresh data
+        const chainData = await this.getChainDataById(chainId);
+        if (!chainData) {
+            throw new Error(`Chain data not found for chainId: ${chainId}`);
+        }
+        return chainData;
+    }
+    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);
+    }
+    async createWeb3Instance(chainId) {
+        const chainData = await this.getChainDataById(chainId);
+        if (!chainData) {
+            throw new Error(`Chain data not found for chainId: ${chainId}`);
+        }
+        // ✅ CRITICAL CHECK: Ensure authHeader is present for private chains
+        if (chainData.chainType === 'PRIVATE' && !chainData.authHeader) {
+            console.error('❌ [Web3ChainService] CRITICAL: Private chain missing authHeader!');
+            throw new Error(`Private chain ${chainId} missing authentication header`);
+        }
+        const web3 = await this.providerService.getWeb3(chainId, chainData.chainType || 'PUBLIC', chainData);
+        return { web3, chainData };
+    }
+    // ✅ HELPER: Type-safe error checking
+    isAuthError(error) {
+        const message = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
+        return (message.includes('unauthorized') ||
+            message.includes('401') ||
+            message.includes('token expired') ||
+            message.includes('invalid token'));
+    }
+    async getChainDataById(chainId) {
+        try {
+            return await this.web3ChainApi.getChainData(chainId);
+        }
+        catch (error) {
+            console.error('❌ [SDK Web3ChainService] Error getting chain data for chainId:', chainId, error);
+            return null;
+        }
+    }
+}
+
+//IMPORTANT//
+//This function is temporary so we install ethers just to make it work, once we delete this function we must uninstall Ethers
+const getWeb3ProviderFromChainData = (chainData, timeout = 15000, customUserAgentName = '', tokenRefresher) => {
+    // Fixed ethers provider setup for authenticated requests
+    let ethersProvider;
+    if (chainData.authHeader) {
+        // For authenticated requests, create a custom FetchRequest
+        const fetchRequest = new ethers.FetchRequest(chainData.rpcUrl);
+        fetchRequest.timeout = timeout;
+        fetchRequest.setHeader('Authorization', chainData.authHeader);
+        fetchRequest.setHeader('Content-Type', 'application/json');
+        if (customUserAgentName) {
+            fetchRequest.setHeader('User-Agent', customUserAgentName);
+        }
+        // Create provider with the configured FetchRequest
+        ethersProvider = new ethers.JsonRpcProvider(fetchRequest, undefined, {
+            staticNetwork: false,
+            polling: false, // Disable polling for better Lambda performance
+        });
+    }
+    else {
+        // For public chains, use simple URL-based provider
+        ethersProvider = new ethers.JsonRpcProvider(chainData.rpcUrl, undefined, {
+            staticNetwork: false,
+            polling: false,
+        });
+    }
+    return {
+        web3Provider: null,
+        ethersProvider: ethersProvider,
+        isAuthenticated: !!chainData.authHeader,
+    };
+};
+
+class Web3ProviderService {
+    constructor(publicHttpProviderService) {
+        this.publicHttpProviderService = publicHttpProviderService;
+        this._web3 = null;
+        this._currentChainId = null;
+    }
+    async getWeb3(chainId, chainType, privateChainData = null) {
+        if (!this._web3 || this._currentChainId !== chainId) {
+            if (!chainId)
+                throw new Error('ChainId not found');
+            try {
+                this._currentChainId = chainId;
+                const provider = await this.getWeb3ByChainId(chainId, chainType, privateChainData);
+                this._web3 = this.convertToWeb3(provider);
+            }
+            catch (error) {
+                console.error('Error getting web3 connection from chain id ' + chainId, error);
+                throw new Error('Error getting web3 connection from chain id ' + chainId);
+            }
+        }
+        return this._web3;
+    }
+    // Keep return type as 'any' to avoid TypeScript errors while still being adapted later
+    getWeb3ByChainId(chainId, chainType, privateChainData = null) {
+        // Rest of the method remains the same
+        if (chainType === web3Ts.ChainTypes.PRIVATE && privateChainData) {
+            //const privateProvider = this.privateChainProviderService.getProviderFromChainData(privateChainData)
+            const privateProvider = getWeb3ProviderFromChainData(privateChainData);
+            if (!privateProvider || privateProvider instanceof Error)
+                throw new Error('Error getting web3 provider');
+            return privateProvider;
+        }
+        else {
+            const publicProvider = this.publicHttpProviderService.getProvider(chainId);
+            if (!publicProvider || publicProvider instanceof Error)
+                throw new Error('Error getting web3 provider');
+            return publicProvider;
+        }
+    }
+    convertToWeb3(provider) {
+        if (provider instanceof Web3) {
+            return provider;
+        }
+        if (provider && typeof provider === 'object' && 'web3Provider' in provider) {
+            const providerObj = provider;
+            // If we want to user the web3Provider directly:
+            /*if (providerObj.web3Provider) {
+                return new Web3(providerObj.web3Provider as never);
+            }*/
+            if (providerObj.ethersProvider) {
+                const url = this.extractUrlFromEthersProvider(providerObj.ethersProvider);
+                const headers = this.extractHeadersFromEthersProvider(providerObj.ethersProvider);
+                const web3 = new Web3(url);
+                const currentProvider = web3.currentProvider;
+                if (currentProvider) {
+                    currentProvider['url'] = url;
+                    if (headers && Object.keys(headers).length > 0) {
+                        currentProvider['request'] = async (payload) => {
+                            const response = await fetch(url, {
+                                method: 'POST',
+                                headers: {
+                                    'Content-Type': 'application/json',
+                                    ...headers
+                                },
+                                body: JSON.stringify(payload)
+                            });
+                            if (!response.ok) {
+                                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                            }
+                            return await response.json();
+                        };
+                    }
+                }
+                return web3;
+            }
+        }
+        return new Web3(provider);
+    }
+    extractUrlFromEthersProvider(ethersProvider) {
+        return ethersProvider.connection?.url ||
+            ethersProvider._getConnection?.()?.url ||
+            ethersProvider.url ||
+            '';
+    }
+    extractHeadersFromEthersProvider(ethersProvider) {
+        return ethersProvider.connection?.headers ||
+            ethersProvider._getConnection?.()?.headers ||
+            {};
+    }
+}
+
+/**
+ * Web3 Chain Domain Models
+ *
+ * Minimal interface definitions matching framework usage exactly.
+ * Local ChainData interface to avoid external dependency issues.
+ */
+const ChainTypes = {
+    PUBLIC: 'PUBLIC',
+    PRIVATE: 'PRIVATE'
+};
+
+function createWeb3ChainSDK(apiClient, providerService) {
+    const web3ChainApi = new Web3ChainApi(apiClient);
+    const web3ChainService = new Web3ChainService(web3ChainApi, providerService); // ✅ DIRECT INJECTION
+    return {
+        // ✅ REPLICA: Same methods as framework
+        getChainDataById: (chainId) => web3ChainService.getChainDataById(chainId),
+        getWeb3ByChainId: (chainId) => web3ChainService.getWeb3ByChainId(chainId),
+        api: web3ChainApi,
+        service: web3ChainService
+    };
+}
+
+exports.ChainTypes = ChainTypes;
+exports.Web3ChainApi = Web3ChainApi;
+exports.Web3ChainService = Web3ChainService;
+exports.Web3ProviderService = Web3ProviderService;
+exports.createWeb3ChainSDK = createWeb3ChainSDK;
+//# sourceMappingURL=web3-chain.cjs.map

package/dist/web3-chain.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"web3-chain.cjs","sources":["../../src/web3-chain/api/web3-chain-api.ts","../../src/core/utils/jwt.function.ts","../../src/web3-chain/services/web3-chain-service.ts","../../src/web3-chain/services/getWeb3FCD.service.ts","../../src/web3-chain/services/provider.service.ts","../../src/web3-chain/models/index.ts","../../src/web3-chain/index.ts"],"sourcesContent":[null,null,null,null,null,null,null],"names":["jwtDecode","FetchRequest","JsonRpcProvider","ChainTypes"],"mappings":"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"}

package/dist/web3-chain.d.ts

@@ -0,0 +1,17 @@
+import { PersApiClient } from './core/pers-api-client';
+import { Web3ChainApi } from './web3-chain/api/web3-chain-api';
+import { Web3ProviderService } from './web3-chain/services/provider.service';
+import { Web3ChainService } from './web3-chain/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 './web3-chain/api/web3-chain-api';
+export { Web3ChainService } from './web3-chain/services/web3-chain-service';
+export { Web3ProviderService } from './web3-chain/services/provider.service';
+export * from './web3-chain/models';
+export type { ChainData } from './web3-chain/models';
+export * from './shared/interfaces/pers-shared-lib.interfaces';
+//# sourceMappingURL=index.d.ts.map

package/dist/web3-chain.js

@@ -0,0 +1,310 @@
+import { jwtDecode } from 'jwt-decode';
+import Web3 from 'web3';
+import { ChainTypes as ChainTypes$1 } from '@explorins/web3-ts';
+import { FetchRequest, JsonRpcProvider } from '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
+     * ✅ Returns ChainData exactly as framework expects from @explorins/web3-ts
+     */
+    async getChainData(chainId) {
+        try {
+            console.log('🔍 [Web3ChainApi] Fetching chain data for chainId:', chainId);
+            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;
+        }
+    }
+}
+
+const isTokenExpired = (token, margin = 60) => {
+    // ✅ SANITIZE: Remove any words (Bearer etc) if exists and get the token
+    const cleanToken = token.split(' ')[1] || token;
+    // ✅ VALIDATION: Check if token is jwt
+    if (!cleanToken || cleanToken.split('.').length !== 3) {
+        return true; // Consider invalid tokens as expired
+    }
+    try {
+        // ✅ TYPE-SAFE: Decode with proper typing
+        const decoded = jwtDecode(cleanToken);
+        const currentTime = Math.floor(Date.now() / 1000);
+        // ✅ CONFIGURABLE: Use provided margin (default 60 seconds)
+        return decoded.exp < (currentTime + margin);
+    }
+    catch (error) {
+        console.error('[SDK JWT Utils] Error decoding JWT token:', error);
+        return true; // Consider unparseable tokens as expired
+    }
+};
+
+class Web3ChainService {
+    constructor(web3ChainApi, providerService) {
+        this.web3ChainApi = web3ChainApi;
+        this.providerService = providerService;
+        this.web3InstanceCache = new Map();
+    }
+    async getWeb3ByChainId(chainId) {
+        const cached = this.web3InstanceCache.get(chainId);
+        // ✅ SMART CACHE: Check if cache is valid based on token expiration
+        if (cached && !this.checkIsTokenExpired(cached.chainData.authHeader)) {
+            console.log(`♻️ [Web3ChainService] Using cached Web3 instance for chain ${chainId}`);
+            return cached.web3Instance;
+        }
+        // ✅ CREATE WITH ERROR RECOVERY: Handle auth errors gracefully
+        try {
+            console.log(`🔧 [Web3ChainService] Creating new Web3 instance for chain ${chainId}`);
+            const { web3, chainData } = await this.createWeb3Instance(chainId);
+            // ✅ CACHE NEW INSTANCE
+            this.web3InstanceCache.set(chainId, {
+                web3Instance: web3,
+                chainData: chainData,
+                createdAt: Date.now(),
+                chainId
+            });
+            return web3;
+        }
+        catch (error) {
+            // ✅ AUTH ERROR RECOVERY: Clear cache and retry once
+            if (this.isAuthError(error)) {
+                console.warn(`🔄 [Web3ChainService] Auth error detected, clearing cache and retrying...`);
+                this.web3InstanceCache.delete(chainId);
+                // Retry once with fresh instance
+                const { web3, chainData } = await this.createWeb3Instance(chainId);
+                this.web3InstanceCache.set(chainId, {
+                    web3Instance: web3,
+                    chainData: chainData,
+                    createdAt: Date.now(),
+                    chainId
+                });
+                return web3;
+            }
+            throw error;
+        }
+    }
+    async getChainDataWithCache(chainId) {
+        const cached = this.web3InstanceCache.get(chainId);
+        //const now = Date.now();
+        if (cached && !this.checkIsTokenExpired(cached.chainData.authHeader)) {
+            console.log(`♻️ [Web3ChainService] Using cached ChainData for chain ${chainId}`);
+            return cached.chainData;
+        }
+        // If not cached, fetch fresh data
+        const chainData = await this.getChainDataById(chainId);
+        if (!chainData) {
+            throw new Error(`Chain data not found for chainId: ${chainId}`);
+        }
+        return chainData;
+    }
+    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);
+    }
+    async createWeb3Instance(chainId) {
+        const chainData = await this.getChainDataById(chainId);
+        if (!chainData) {
+            throw new Error(`Chain data not found for chainId: ${chainId}`);
+        }
+        // ✅ CRITICAL CHECK: Ensure authHeader is present for private chains
+        if (chainData.chainType === 'PRIVATE' && !chainData.authHeader) {
+            console.error('❌ [Web3ChainService] CRITICAL: Private chain missing authHeader!');
+            throw new Error(`Private chain ${chainId} missing authentication header`);
+        }
+        const web3 = await this.providerService.getWeb3(chainId, chainData.chainType || 'PUBLIC', chainData);
+        return { web3, chainData };
+    }
+    // ✅ HELPER: Type-safe error checking
+    isAuthError(error) {
+        const message = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
+        return (message.includes('unauthorized') ||
+            message.includes('401') ||
+            message.includes('token expired') ||
+            message.includes('invalid token'));
+    }
+    async getChainDataById(chainId) {
+        try {
+            return await this.web3ChainApi.getChainData(chainId);
+        }
+        catch (error) {
+            console.error('❌ [SDK Web3ChainService] Error getting chain data for chainId:', chainId, error);
+            return null;
+        }
+    }
+}
+
+//IMPORTANT//
+//This function is temporary so we install ethers just to make it work, once we delete this function we must uninstall Ethers
+const getWeb3ProviderFromChainData = (chainData, timeout = 15000, customUserAgentName = '', tokenRefresher) => {
+    // Fixed ethers provider setup for authenticated requests
+    let ethersProvider;
+    if (chainData.authHeader) {
+        // For authenticated requests, create a custom FetchRequest
+        const fetchRequest = new FetchRequest(chainData.rpcUrl);
+        fetchRequest.timeout = timeout;
+        fetchRequest.setHeader('Authorization', chainData.authHeader);
+        fetchRequest.setHeader('Content-Type', 'application/json');
+        if (customUserAgentName) {
+            fetchRequest.setHeader('User-Agent', customUserAgentName);
+        }
+        // Create provider with the configured FetchRequest
+        ethersProvider = new JsonRpcProvider(fetchRequest, undefined, {
+            staticNetwork: false,
+            polling: false, // Disable polling for better Lambda performance
+        });
+    }
+    else {
+        // For public chains, use simple URL-based provider
+        ethersProvider = new JsonRpcProvider(chainData.rpcUrl, undefined, {
+            staticNetwork: false,
+            polling: false,
+        });
+    }
+    return {
+        web3Provider: null,
+        ethersProvider: ethersProvider,
+        isAuthenticated: !!chainData.authHeader,
+    };
+};
+
+class Web3ProviderService {
+    constructor(publicHttpProviderService) {
+        this.publicHttpProviderService = publicHttpProviderService;
+        this._web3 = null;
+        this._currentChainId = null;
+    }
+    async getWeb3(chainId, chainType, privateChainData = null) {
+        if (!this._web3 || this._currentChainId !== chainId) {
+            if (!chainId)
+                throw new Error('ChainId not found');
+            try {
+                this._currentChainId = chainId;
+                const provider = await this.getWeb3ByChainId(chainId, chainType, privateChainData);
+                this._web3 = this.convertToWeb3(provider);
+            }
+            catch (error) {
+                console.error('Error getting web3 connection from chain id ' + chainId, error);
+                throw new Error('Error getting web3 connection from chain id ' + chainId);
+            }
+        }
+        return this._web3;
+    }
+    // Keep return type as 'any' to avoid TypeScript errors while still being adapted later
+    getWeb3ByChainId(chainId, chainType, privateChainData = null) {
+        // Rest of the method remains the same
+        if (chainType === ChainTypes$1.PRIVATE && privateChainData) {
+            //const privateProvider = this.privateChainProviderService.getProviderFromChainData(privateChainData)
+            const privateProvider = getWeb3ProviderFromChainData(privateChainData);
+            if (!privateProvider || privateProvider instanceof Error)
+                throw new Error('Error getting web3 provider');
+            return privateProvider;
+        }
+        else {
+            const publicProvider = this.publicHttpProviderService.getProvider(chainId);
+            if (!publicProvider || publicProvider instanceof Error)
+                throw new Error('Error getting web3 provider');
+            return publicProvider;
+        }
+    }
+    convertToWeb3(provider) {
+        if (provider instanceof Web3) {
+            return provider;
+        }
+        if (provider && typeof provider === 'object' && 'web3Provider' in provider) {
+            const providerObj = provider;
+            // If we want to user the web3Provider directly:
+            /*if (providerObj.web3Provider) {
+                return new Web3(providerObj.web3Provider as never);
+            }*/
+            if (providerObj.ethersProvider) {
+                const url = this.extractUrlFromEthersProvider(providerObj.ethersProvider);
+                const headers = this.extractHeadersFromEthersProvider(providerObj.ethersProvider);
+                const web3 = new Web3(url);
+                const currentProvider = web3.currentProvider;
+                if (currentProvider) {
+                    currentProvider['url'] = url;
+                    if (headers && Object.keys(headers).length > 0) {
+                        currentProvider['request'] = async (payload) => {
+                            const response = await fetch(url, {
+                                method: 'POST',
+                                headers: {
+                                    'Content-Type': 'application/json',
+                                    ...headers
+                                },
+                                body: JSON.stringify(payload)
+                            });
+                            if (!response.ok) {
+                                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                            }
+                            return await response.json();
+                        };
+                    }
+                }
+                return web3;
+            }
+        }
+        return new Web3(provider);
+    }
+    extractUrlFromEthersProvider(ethersProvider) {
+        return ethersProvider.connection?.url ||
+            ethersProvider._getConnection?.()?.url ||
+            ethersProvider.url ||
+            '';
+    }
+    extractHeadersFromEthersProvider(ethersProvider) {
+        return ethersProvider.connection?.headers ||
+            ethersProvider._getConnection?.()?.headers ||
+            {};
+    }
+}
+
+/**
+ * Web3 Chain Domain Models
+ *
+ * Minimal interface definitions matching framework usage exactly.
+ * Local ChainData interface to avoid external dependency issues.
+ */
+const ChainTypes = {
+    PUBLIC: 'PUBLIC',
+    PRIVATE: 'PRIVATE'
+};
+
+function createWeb3ChainSDK(apiClient, providerService) {
+    const web3ChainApi = new Web3ChainApi(apiClient);
+    const web3ChainService = new Web3ChainService(web3ChainApi, providerService); // ✅ DIRECT INJECTION
+    return {
+        // ✅ REPLICA: Same methods as framework
+        getChainDataById: (chainId) => web3ChainService.getChainDataById(chainId),
+        getWeb3ByChainId: (chainId) => web3ChainService.getWeb3ByChainId(chainId),
+        api: web3ChainApi,
+        service: web3ChainService
+    };
+}
+
+export { ChainTypes, Web3ChainApi, Web3ChainService, Web3ProviderService, createWeb3ChainSDK };
+//# sourceMappingURL=web3-chain.js.map