@rlajous/sdk-core 1.0.0

package/dist/cjs/http/client.js

@@ -0,0 +1,335 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+const errors_1 = require("../errors");
+const retry_1 = require("./retry");
+const config_1 = require("../config");
+/**
+ * HTTP client with retry support and interceptors
+ */
+class HttpClient {
+    baseUrl;
+    defaultHeaders;
+    defaultTimeout;
+    retryConfig;
+    requestInterceptors = [];
+    responseInterceptors = [];
+    errorInterceptors = [];
+    debug;
+    logger;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, ''); // Remove trailing slash
+        this.defaultHeaders = {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+            ...config.headers,
+        };
+        this.defaultTimeout = config.timeout ?? 30000;
+        this.retryConfig = { ...retry_1.DEFAULT_RETRY_CONFIG, ...config.retry };
+        this.debug = config.debug ?? false;
+        this.logger = config.logger ?? config_1.defaultLogger;
+    }
+    /**
+     * Check if request logging is enabled
+     */
+    shouldLogRequests() {
+        return this.debug === true || this.debug === 'all' || this.debug === 'requests';
+    }
+    /**
+     * Check if response logging is enabled
+     */
+    shouldLogResponses() {
+        return this.debug === true || this.debug === 'all' || this.debug === 'responses';
+    }
+    /**
+     * Check if error logging is enabled
+     */
+    shouldLogErrors() {
+        return this.debug === true || this.debug === 'all' || this.debug === 'errors';
+    }
+    /**
+     * Log a request
+     */
+    logRequest(method, url, body) {
+        if (this.shouldLogRequests()) {
+            this.logger.debug(`→ ${method} ${url}`, body ? { body: this.sanitizeBody(body) } : undefined);
+        }
+    }
+    /**
+     * Log a response
+     */
+    logResponse(method, url, status, duration) {
+        if (this.shouldLogResponses()) {
+            this.logger.debug(`← ${method} ${url} ${status} (${duration}ms)`);
+        }
+    }
+    /**
+     * Log an error
+     */
+    logError(method, url, error) {
+        if (this.shouldLogErrors()) {
+            this.logger.error(`✗ ${method} ${url} - ${error.code}: ${error.message}`, {
+                code: error.code,
+                status: error.status,
+                requestId: error.requestId,
+            });
+        }
+    }
+    /**
+     * Sanitize request body for logging (remove sensitive data)
+     */
+    sanitizeBody(body) {
+        if (typeof body !== 'object' || body === null) {
+            return body;
+        }
+        // Remove potentially sensitive fields from logs
+        const sanitized = { ...body };
+        const sensitiveKeys = ['apiKey', 'api_key', 'secret', 'password', 'token'];
+        for (const key of sensitiveKeys) {
+            if (key in sanitized) {
+                sanitized[key] = '[REDACTED]';
+            }
+        }
+        return sanitized;
+    }
+    /**
+     * Add a request interceptor
+     */
+    addRequestInterceptor(interceptor) {
+        this.requestInterceptors.push(interceptor);
+    }
+    /**
+     * Add a response interceptor
+     */
+    addResponseInterceptor(interceptor) {
+        this.responseInterceptors.push(interceptor);
+    }
+    /**
+     * Add an error interceptor
+     */
+    addErrorInterceptor(interceptor) {
+        this.errorInterceptors.push(interceptor);
+    }
+    /**
+     * Make a GET request
+     */
+    async get(path, config) {
+        return this.request(path, { ...config, method: 'GET' });
+    }
+    /**
+     * Make a POST request
+     */
+    async post(path, body, config) {
+        return this.request(path, { ...config, method: 'POST', body });
+    }
+    /**
+     * Make a PUT request
+     */
+    async put(path, body, config) {
+        return this.request(path, { ...config, method: 'PUT', body });
+    }
+    /**
+     * Make a PATCH request
+     */
+    async patch(path, body, config) {
+        return this.request(path, { ...config, method: 'PATCH', body });
+    }
+    /**
+     * Make a DELETE request
+     */
+    async delete(path, config) {
+        return this.request(path, { ...config, method: 'DELETE' });
+    }
+    /**
+     * Make an HTTP request with retry support
+     */
+    async request(path, config = {}) {
+        const url = `${this.baseUrl}${path.startsWith('/') ? path : `/${path}`}`;
+        // Apply request interceptors
+        let finalConfig = { ...config };
+        for (const interceptor of this.requestInterceptors) {
+            finalConfig = await interceptor(url, finalConfig);
+        }
+        let lastError;
+        let attempt = 0;
+        while (attempt <= this.retryConfig.maxRetries) {
+            try {
+                const response = await this.executeRequest(url, finalConfig);
+                // Apply response interceptors
+                let finalResponse = response;
+                for (const interceptor of this.responseInterceptors) {
+                    finalResponse = (await interceptor(finalResponse));
+                }
+                return finalResponse;
+            }
+            catch (error) {
+                lastError = error instanceof errors_1.WebacyError ? error : this.wrapError(error);
+                // Apply error interceptors
+                for (const interceptor of this.errorInterceptors) {
+                    lastError = await interceptor(lastError);
+                }
+                // Check if we should retry
+                if (!lastError.isRetryable() || attempt >= this.retryConfig.maxRetries) {
+                    throw lastError;
+                }
+                // Calculate retry delay
+                const retryAfter = lastError instanceof errors_1.RateLimitError ? lastError.retryAfter : undefined;
+                const delay = (0, retry_1.calculateRetryDelay)(attempt, this.retryConfig, retryAfter);
+                await (0, retry_1.sleep)(delay);
+                attempt++;
+            }
+        }
+        throw lastError ?? new errors_1.NetworkError('Request failed after all retries');
+    }
+    /**
+     * Execute a single HTTP request
+     */
+    async executeRequest(url, config) {
+        const method = config.method ?? 'GET';
+        const timeout = config.timeout ?? this.defaultTimeout;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        const startTime = Date.now();
+        // Log the outgoing request
+        this.logRequest(method, url, config.body);
+        // Combine abort signals if user provided one
+        const signal = config.signal
+            ? this.combineAbortSignals(config.signal, controller.signal)
+            : controller.signal;
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    ...this.defaultHeaders,
+                    ...config.headers,
+                },
+                body: config.body ? JSON.stringify(config.body) : undefined,
+                signal,
+            });
+            clearTimeout(timeoutId);
+            const duration = Date.now() - startTime;
+            const requestId = response.headers.get('x-request-id') ?? undefined;
+            // Handle non-OK responses
+            if (!response.ok) {
+                const error = await this.createErrorFromResponse(response, requestId, url);
+                this.logError(method, url, error);
+                throw error;
+            }
+            // Log successful response
+            this.logResponse(method, url, response.status, duration);
+            // Parse response body
+            const contentType = response.headers.get('content-type');
+            let data;
+            if (contentType?.includes('application/json')) {
+                data = (await response.json());
+            }
+            else {
+                data = (await response.text());
+            }
+            return {
+                data,
+                status: response.status,
+                headers: response.headers,
+                requestId,
+            };
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof errors_1.WebacyError) {
+                throw error;
+            }
+            // Handle fetch errors
+            let networkError;
+            if (error instanceof Error) {
+                if (error.name === 'AbortError') {
+                    networkError = new errors_1.NetworkError('Request timed out', { cause: error, endpoint: url });
+                }
+                else {
+                    networkError = new errors_1.NetworkError(error.message, { cause: error, endpoint: url });
+                }
+            }
+            else {
+                networkError = new errors_1.NetworkError('An unknown error occurred', { endpoint: url });
+            }
+            this.logError(method, url, networkError);
+            throw networkError;
+        }
+    }
+    /**
+     * Create an appropriate error from an HTTP response
+     */
+    async createErrorFromResponse(response, requestId, endpoint) {
+        let errorBody = {};
+        try {
+            errorBody = (await response.json());
+        }
+        catch {
+            // Ignore JSON parse errors
+        }
+        const message = errorBody.message ?? errorBody.error ?? response.statusText;
+        switch (response.status) {
+            case 401:
+            case 403:
+                return new errors_1.AuthenticationError(message, { requestId, endpoint });
+            case 404:
+                return new errors_1.NotFoundError(message, { requestId, endpoint });
+            case 429: {
+                const retryAfter = response.headers.get('retry-after');
+                const resetAt = response.headers.get('x-ratelimit-reset');
+                return new errors_1.RateLimitError(message, {
+                    retryAfter: retryAfter ? parseInt(retryAfter, 10) : undefined,
+                    resetAt: resetAt ? parseInt(resetAt, 10) : undefined,
+                    requestId,
+                    endpoint,
+                });
+            }
+            case 400:
+                return new errors_1.ValidationError(message, {
+                    errors: errorBody.errors,
+                    requestId,
+                    endpoint,
+                });
+            default:
+                if ((0, retry_1.isRetryableStatusCode)(response.status, this.retryConfig)) {
+                    return new errors_1.NetworkError(message, {
+                        cause: new Error(`HTTP ${response.status}`),
+                        endpoint,
+                    });
+                }
+                return new errors_1.WebacyError(message, {
+                    status: response.status,
+                    code: 'API_ERROR',
+                    requestId,
+                    endpoint,
+                });
+        }
+    }
+    /**
+     * Wrap an unknown error in a WebacyError
+     */
+    wrapError(error) {
+        if (error instanceof errors_1.WebacyError) {
+            return error;
+        }
+        if (error instanceof Error) {
+            return new errors_1.NetworkError(error.message, { cause: error });
+        }
+        return new errors_1.NetworkError('An unknown error occurred');
+    }
+    /**
+     * Combine multiple abort signals
+     */
+    combineAbortSignals(...signals) {
+        const controller = new AbortController();
+        for (const signal of signals) {
+            if (signal.aborted) {
+                controller.abort(signal.reason);
+                break;
+            }
+            signal.addEventListener('abort', () => controller.abort(signal.reason), { once: true });
+        }
+        return controller.signal;
+    }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=client.js.map

package/dist/cjs/http/client.js.map

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

package/dist/cjs/http/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = exports.isRetryableStatusCode = exports.calculateRetryDelay = exports.DEFAULT_RETRY_CONFIG = exports.HttpClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "HttpClient", { enumerable: true, get: function () { return client_1.HttpClient; } });
+var retry_1 = require("./retry");
+Object.defineProperty(exports, "DEFAULT_RETRY_CONFIG", { enumerable: true, get: function () { return retry_1.DEFAULT_RETRY_CONFIG; } });
+Object.defineProperty(exports, "calculateRetryDelay", { enumerable: true, get: function () { return retry_1.calculateRetryDelay; } });
+Object.defineProperty(exports, "isRetryableStatusCode", { enumerable: true, get: function () { return retry_1.isRetryableStatusCode; } });
+Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return retry_1.sleep; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/http/index.ts"],"names":[],"mappings":";;;AAAA,mCAQkB;AAPhB,oGAAA,UAAU,OAAA;AASZ,iCAMiB;AAJf,6GAAA,oBAAoB,OAAA;AACpB,4GAAA,mBAAmB,OAAA;AACnB,8GAAA,qBAAqB,OAAA;AACrB,8FAAA,KAAK,OAAA"}

package/dist/cjs/http/retry.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RETRY_CONFIG = void 0;
+exports.calculateRetryDelay = calculateRetryDelay;
+exports.isRetryableStatusCode = isRetryableStatusCode;
+exports.sleep = sleep;
+/**
+ * Default retry configuration
+ */
+exports.DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialDelay: 1000,
+    maxDelay: 30000,
+    backoffMultiplier: 2,
+    retryableStatusCodes: [408, 429, 500, 502, 503, 504],
+};
+/**
+ * Calculate delay for a retry attempt using exponential backoff with jitter
+ */
+function calculateRetryDelay(attempt, config, retryAfter) {
+    // If server provided Retry-After, use it
+    if (retryAfter && retryAfter > 0) {
+        return Math.min(retryAfter * 1000, config.maxDelay);
+    }
+    // Exponential backoff with jitter
+    const exponentialDelay = config.initialDelay * Math.pow(config.backoffMultiplier, attempt);
+    const jitter = Math.random() * 0.3 * exponentialDelay; // 30% jitter
+    const delay = exponentialDelay + jitter;
+    return Math.min(delay, config.maxDelay);
+}
+/**
+ * Check if a status code is retryable
+ */
+function isRetryableStatusCode(statusCode, config) {
+    return config.retryableStatusCodes.includes(statusCode);
+}
+/**
+ * Sleep for a given number of milliseconds
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=retry.js.map

package/dist/cjs/http/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../src/http/retry.ts"],"names":[],"mappings":";;;AA8BA,kDAgBC;AAKD,sDAEC;AAKD,sBAEC;AA5CD;;GAEG;AACU,QAAA,oBAAoB,GAAgB;IAC/C,UAAU,EAAE,CAAC;IACb,YAAY,EAAE,IAAI;IAClB,QAAQ,EAAE,KAAK;IACf,iBAAiB,EAAE,CAAC;IACpB,oBAAoB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;CACrD,CAAC;AAEF;;GAEG;AACH,SAAgB,mBAAmB,CACjC,OAAe,EACf,MAAmB,EACnB,UAAmB;IAEnB,yCAAyC;IACzC,IAAI,UAAU,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED,kCAAkC;IAClC,MAAM,gBAAgB,GAAG,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAC3F,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,gBAAgB,CAAC,CAAC,aAAa;IACpE,MAAM,KAAK,GAAG,gBAAgB,GAAG,MAAM,CAAC;IAExC,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,UAAkB,EAAE,MAAmB;IAC3E,OAAO,MAAM,CAAC,oBAAoB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeEvmAddress = exports.normalizeAddress = exports.isValidStellarAddress = exports.isValidSuiAddress = exports.isValidTonAddress = exports.isValidBitcoinAddress = exports.isValidSolanaAddress = exports.isValidEvmAddress = exports.isValidAddress = exports.TokenStandard = exports.TypeOfAddress = exports.RiskLevel = exports.RiskScore = exports.RiskModule = exports.CHAIN_NAMES = exports.CHAIN_IDS = exports.isEvmChain = exports.getChainCompatibility = exports.ChainCompatibility = exports.Chain = exports.NetworkError = exports.NotFoundError = exports.ValidationError = exports.RateLimitError = exports.AuthenticationError = exports.WebacyError = exports.DEFAULT_RETRY_CONFIG = exports.HttpClient = exports.BaseClient = exports.defaultLogger = exports.buildBaseUrl = exports.DEFAULT_CONFIG = void 0;
+// Configuration
+var config_1 = require("./config");
+Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return config_1.DEFAULT_CONFIG; } });
+Object.defineProperty(exports, "buildBaseUrl", { enumerable: true, get: function () { return config_1.buildBaseUrl; } });
+Object.defineProperty(exports, "defaultLogger", { enumerable: true, get: function () { return config_1.defaultLogger; } });
+// Base client
+var client_base_1 = require("./client-base");
+Object.defineProperty(exports, "BaseClient", { enumerable: true, get: function () { return client_base_1.BaseClient; } });
+// HTTP client
+var http_1 = require("./http");
+Object.defineProperty(exports, "HttpClient", { enumerable: true, get: function () { return http_1.HttpClient; } });
+Object.defineProperty(exports, "DEFAULT_RETRY_CONFIG", { enumerable: true, get: function () { return http_1.DEFAULT_RETRY_CONFIG; } });
+// Errors
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "WebacyError", { enumerable: true, get: function () { return errors_1.WebacyError; } });
+Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return errors_1.AuthenticationError; } });
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return errors_1.RateLimitError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return errors_1.NotFoundError; } });
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return errors_1.NetworkError; } });
+// Types
+var types_1 = require("./types");
+Object.defineProperty(exports, "Chain", { enumerable: true, get: function () { return types_1.Chain; } });
+Object.defineProperty(exports, "ChainCompatibility", { enumerable: true, get: function () { return types_1.ChainCompatibility; } });
+Object.defineProperty(exports, "getChainCompatibility", { enumerable: true, get: function () { return types_1.getChainCompatibility; } });
+Object.defineProperty(exports, "isEvmChain", { enumerable: true, get: function () { return types_1.isEvmChain; } });
+Object.defineProperty(exports, "CHAIN_IDS", { enumerable: true, get: function () { return types_1.CHAIN_IDS; } });
+Object.defineProperty(exports, "CHAIN_NAMES", { enumerable: true, get: function () { return types_1.CHAIN_NAMES; } });
+Object.defineProperty(exports, "RiskModule", { enumerable: true, get: function () { return types_1.RiskModule; } });
+Object.defineProperty(exports, "RiskScore", { enumerable: true, get: function () { return types_1.RiskScore; } });
+Object.defineProperty(exports, "RiskLevel", { enumerable: true, get: function () { return types_1.RiskLevel; } });
+Object.defineProperty(exports, "TypeOfAddress", { enumerable: true, get: function () { return types_1.TypeOfAddress; } });
+Object.defineProperty(exports, "TokenStandard", { enumerable: true, get: function () { return types_1.TokenStandard; } });
+// Utilities
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "isValidAddress", { enumerable: true, get: function () { return utils_1.isValidAddress; } });
+Object.defineProperty(exports, "isValidEvmAddress", { enumerable: true, get: function () { return utils_1.isValidEvmAddress; } });
+Object.defineProperty(exports, "isValidSolanaAddress", { enumerable: true, get: function () { return utils_1.isValidSolanaAddress; } });
+Object.defineProperty(exports, "isValidBitcoinAddress", { enumerable: true, get: function () { return utils_1.isValidBitcoinAddress; } });
+Object.defineProperty(exports, "isValidTonAddress", { enumerable: true, get: function () { return utils_1.isValidTonAddress; } });
+Object.defineProperty(exports, "isValidSuiAddress", { enumerable: true, get: function () { return utils_1.isValidSuiAddress; } });
+Object.defineProperty(exports, "isValidStellarAddress", { enumerable: true, get: function () { return utils_1.isValidStellarAddress; } });
+Object.defineProperty(exports, "normalizeAddress", { enumerable: true, get: function () { return utils_1.normalizeAddress; } });
+Object.defineProperty(exports, "normalizeEvmAddress", { enumerable: true, get: function () { return utils_1.normalizeEvmAddress; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,gBAAgB;AAChB,mCAOkB;AALhB,wGAAA,cAAc,OAAA;AACd,sGAAA,YAAY,OAAA;AAGZ,uGAAA,aAAa,OAAA;AAGf,cAAc;AACd,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AAEnB,cAAc;AACd,+BAUgB;AATd,kGAAA,UAAU,OAAA;AAQV,4GAAA,oBAAoB,OAAA;AAGtB,SAAS;AACT,mCAOkB;AANhB,qGAAA,WAAW,OAAA;AACX,6GAAA,mBAAmB,OAAA;AACnB,wGAAA,cAAc,OAAA;AACd,yGAAA,eAAe,OAAA;AACf,uGAAA,aAAa,OAAA;AACb,sGAAA,YAAY,OAAA;AAGd,QAAQ;AACR,iCA2BiB;AA1Bf,8FAAA,KAAK,OAAA;AACL,2GAAA,kBAAkB,OAAA;AAClB,8GAAA,qBAAqB,OAAA;AACrB,mGAAA,UAAU,OAAA;AACV,kGAAA,SAAS,OAAA;AACT,oGAAA,WAAW,OAAA;AACX,mGAAA,UAAU,OAAA;AACV,kGAAA,SAAS,OAAA;AACT,kGAAA,SAAS,OAAA;AACT,sGAAA,aAAa,OAAA;AACb,sGAAA,aAAa,OAAA;AAkBf,YAAY;AACZ,iCAUiB;AATf,uGAAA,cAAc,OAAA;AACd,0GAAA,iBAAiB,OAAA;AACjB,6GAAA,oBAAoB,OAAA;AACpB,8GAAA,qBAAqB,OAAA;AACrB,0GAAA,iBAAiB,OAAA;AACjB,0GAAA,iBAAiB,OAAA;AACjB,8GAAA,qBAAqB,OAAA;AACrB,yGAAA,gBAAgB,OAAA;AAChB,4GAAA,mBAAmB,OAAA"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/types/chain.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHAIN_NAMES = exports.CHAIN_IDS = exports.ChainCompatibility = exports.Chain = void 0;
+exports.getChainCompatibility = getChainCompatibility;
+exports.isEvmChain = isEvmChain;
+/**
+ * Supported blockchain networks
+ */
+var Chain;
+(function (Chain) {
+    /** Ethereum Mainnet */
+    Chain["ETH"] = "eth";
+    /** Ethereum Sepolia Testnet */
+    Chain["SEP"] = "sep";
+    /** Arbitrum One */
+    Chain["ARB"] = "arb";
+    /** Polygon (MATIC) */
+    Chain["POL"] = "pol";
+    /** Solana */
+    Chain["SOL"] = "sol";
+    /** Optimism */
+    Chain["OPT"] = "opt";
+    /** Base */
+    Chain["BASE"] = "base";
+    /** BNB Smart Chain */
+    Chain["BSC"] = "bsc";
+    /** TON (The Open Network) */
+    Chain["TON"] = "ton";
+    /** Sei */
+    Chain["SEI"] = "sei";
+    /** Bitcoin */
+    Chain["BTC"] = "btc";
+    /** Sui */
+    Chain["SUI"] = "sui";
+    /** Stellar */
+    Chain["STELLAR"] = "stellar";
+})(Chain || (exports.Chain = Chain = {}));
+/**
+ * Chain compatibility groups for feature detection
+ */
+var ChainCompatibility;
+(function (ChainCompatibility) {
+    ChainCompatibility["EVM"] = "EVM";
+    ChainCompatibility["SOLANA"] = "SOLANA";
+    ChainCompatibility["TON"] = "TON";
+    ChainCompatibility["BTC"] = "BTC";
+    ChainCompatibility["SEI"] = "SEI";
+    ChainCompatibility["SUI"] = "SUI";
+    ChainCompatibility["STELLAR"] = "STELLAR";
+})(ChainCompatibility || (exports.ChainCompatibility = ChainCompatibility = {}));
+/**
+ * Get the compatibility group for a chain
+ */
+function getChainCompatibility(chain) {
+    switch (chain) {
+        case Chain.ETH:
+        case Chain.SEP:
+        case Chain.ARB:
+        case Chain.POL:
+        case Chain.OPT:
+        case Chain.BASE:
+        case Chain.BSC:
+            return ChainCompatibility.EVM;
+        case Chain.SOL:
+            return ChainCompatibility.SOLANA;
+        case Chain.TON:
+            return ChainCompatibility.TON;
+        case Chain.BTC:
+            return ChainCompatibility.BTC;
+        case Chain.SEI:
+            return ChainCompatibility.SEI;
+        case Chain.SUI:
+            return ChainCompatibility.SUI;
+        case Chain.STELLAR:
+            return ChainCompatibility.STELLAR;
+    }
+}
+/**
+ * Check if a chain is EVM-compatible
+ */
+function isEvmChain(chain) {
+    return getChainCompatibility(chain) === ChainCompatibility.EVM;
+}
+/**
+ * Chain ID mapping for EVM chains
+ */
+exports.CHAIN_IDS = {
+    [Chain.ETH]: 1,
+    [Chain.SEP]: 11155111,
+    [Chain.BSC]: 56,
+    [Chain.POL]: 137,
+    [Chain.OPT]: 10,
+    [Chain.ARB]: 42161,
+    [Chain.BASE]: 8453,
+};
+/**
+ * Human-readable chain names
+ */
+exports.CHAIN_NAMES = {
+    [Chain.ETH]: 'Ethereum',
+    [Chain.SEP]: 'Sepolia',
+    [Chain.ARB]: 'Arbitrum',
+    [Chain.POL]: 'Polygon',
+    [Chain.SOL]: 'Solana',
+    [Chain.OPT]: 'Optimism',
+    [Chain.BASE]: 'Base',
+    [Chain.BSC]: 'BNB Smart Chain',
+    [Chain.TON]: 'TON',
+    [Chain.SEI]: 'Sei',
+    [Chain.BTC]: 'Bitcoin',
+    [Chain.SUI]: 'Sui',
+    [Chain.STELLAR]: 'Stellar',
+};
+//# sourceMappingURL=chain.js.map

package/dist/cjs/types/chain.js.map

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

package/dist/cjs/types/common.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenStandard = exports.TypeOfAddress = exports.RiskLevel = exports.RiskScore = void 0;
+/**
+ * Risk score classification
+ */
+var RiskScore;
+(function (RiskScore) {
+    RiskScore["HIGH"] = "High Risk";
+    RiskScore["MEDIUM"] = "Medium Risk";
+    RiskScore["LOW"] = "Low Risk";
+    RiskScore["TRUSTED"] = "Trusted";
+    RiskScore["UNKNOWN"] = "Unknown";
+})(RiskScore || (exports.RiskScore = RiskScore = {}));
+/**
+ * Risk level enum
+ */
+var RiskLevel;
+(function (RiskLevel) {
+    RiskLevel["Low"] = "low";
+    RiskLevel["Medium"] = "medium";
+    RiskLevel["High"] = "high";
+    RiskLevel["Suspicious"] = "suspicious";
+})(RiskLevel || (exports.RiskLevel = RiskLevel = {}));
+/**
+ * Address type classification
+ */
+var TypeOfAddress;
+(function (TypeOfAddress) {
+    TypeOfAddress["EOA"] = "EOA";
+    TypeOfAddress["CONTRACT"] = "CONTRACT";
+    TypeOfAddress["TOKEN"] = "TOKEN";
+    TypeOfAddress["CONTRACT_WALLET"] = "CONTRACT_WALLET";
+    TypeOfAddress["MULTISIG"] = "MULTISIG";
+})(TypeOfAddress || (exports.TypeOfAddress = TypeOfAddress = {}));
+/**
+ * Token standard
+ */
+var TokenStandard;
+(function (TokenStandard) {
+    TokenStandard["ERC20"] = "ERC20";
+    TokenStandard["ERC721"] = "ERC721";
+    TokenStandard["ERC1155"] = "ERC1155";
+    TokenStandard["SPL"] = "SPL";
+    TokenStandard["JETTON"] = "JETTON";
+    TokenStandard["STELLAR_ASSET"] = "STELLAR_ASSET";
+    TokenStandard["SUI_COIN"] = "SUI_COIN";
+})(TokenStandard || (exports.TokenStandard = TokenStandard = {}));
+//# sourceMappingURL=common.js.map

package/dist/cjs/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/types/common.ts"],"names":[],"mappings":";;;AA8CA;;GAEG;AACH,IAAY,SAMX;AAND,WAAY,SAAS;IACnB,+BAAkB,CAAA;IAClB,mCAAsB,CAAA;IACtB,6BAAgB,CAAA;IAChB,gCAAmB,CAAA;IACnB,gCAAmB,CAAA;AACrB,CAAC,EANW,SAAS,yBAAT,SAAS,QAMpB;AAED;;GAEG;AACH,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,wBAAW,CAAA;IACX,8BAAiB,CAAA;IACjB,0BAAa,CAAA;IACb,sCAAyB,CAAA;AAC3B,CAAC,EALW,SAAS,yBAAT,SAAS,QAKpB;AA2ID;;GAEG;AACH,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,4BAAW,CAAA;IACX,sCAAqB,CAAA;IACrB,gCAAe,CAAA;IACf,oDAAmC,CAAA;IACnC,sCAAqB,CAAA;AACvB,CAAC,EANW,aAAa,6BAAb,aAAa,QAMxB;AAED;;GAEG;AACH,IAAY,aAQX;AARD,WAAY,aAAa;IACvB,gCAAe,CAAA;IACf,kCAAiB,CAAA;IACjB,oCAAmB,CAAA;IACnB,4BAAW,CAAA;IACX,kCAAiB,CAAA;IACjB,gDAA+B,CAAA;IAC/B,sCAAqB,CAAA;AACvB,CAAC,EARW,aAAa,6BAAb,aAAa,QAQxB"}