@webacy-xyz/sdk-core 1.0.1

package/dist/cjs/http/client.js

@@ -0,0 +1,393 @@
+"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)
+     * Recursively processes nested objects and arrays
+     */
+    sanitizeBody(body) {
+        if (typeof body !== 'object' || body === null) {
+            return body;
+        }
+        // Handle arrays recursively
+        if (Array.isArray(body)) {
+            return body.map((item) => this.sanitizeBody(item));
+        }
+        // Remove potentially sensitive fields from logs
+        const sanitized = {};
+        const sensitiveKeys = [
+            'apikey',
+            'api_key',
+            'secret',
+            'password',
+            'token',
+            'authorization',
+            'auth',
+            'credentials',
+            'bearer',
+        ];
+        for (const [key, value] of Object.entries(body)) {
+            if (sensitiveKeys.includes(key.toLowerCase())) {
+                sanitized[key] = '[REDACTED]';
+            }
+            else if (typeof value === 'object' && value !== null) {
+                sanitized[key] = this.sanitizeBody(value);
+            }
+            else {
+                sanitized[key] = value;
+            }
+        }
+        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();
+        let didTimeout = false;
+        const timeoutId = setTimeout(() => {
+            didTimeout = true;
+            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') {
+                    // Distinguish between timeout and user-cancelled requests
+                    if (didTimeout) {
+                        networkError = new errors_1.NetworkError('Request timed out', { cause: error, endpoint: url });
+                    }
+                    else {
+                        networkError = new errors_1.NetworkError('Request was cancelled by the caller', {
+                            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: this.parseRetryAfter(retryAfter),
+                    resetAt: this.parseRetryAfter(resetAt),
+                    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');
+    }
+    /**
+     * Parse and validate Retry-After header value
+     *
+     * Handles edge cases:
+     * - NaN from non-numeric strings (e.g., HTTP-date format)
+     * - Negative values
+     * - Extremely large values (capped at 5 minutes)
+     *
+     * @param value - Raw header value
+     * @returns Validated retry delay in seconds, or undefined if invalid
+     */
+    parseRetryAfter(value) {
+        if (!value)
+            return undefined;
+        const parsed = parseInt(value, 10);
+        // Handle NaN (e.g., from HTTP-date format like "Wed, 21 Oct 2015 07:28:00 GMT")
+        // and negative values
+        if (Number.isNaN(parsed) || parsed < 0) {
+            return undefined;
+        }
+        // Cap at 5 minutes to prevent excessive delays from malformed headers
+        const MAX_RETRY_AFTER_SECONDS = 300;
+        return Math.min(parsed, MAX_RETRY_AFTER_SECONDS);
+    }
+    /**
+     * 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,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidUrl = 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.BaseResource = 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; } });
+// Base resource
+var resources_1 = require("./resources");
+Object.defineProperty(exports, "BaseResource", { enumerable: true, get: function () { return resources_1.BaseResource; } });
+// 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; } });
+Object.defineProperty(exports, "isValidUrl", { enumerable: true, get: function () { return utils_1.isValidUrl; } });
+//# 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,gBAAgB;AAChB,yCAA2C;AAAlC,yGAAA,YAAY,OAAA;AAErB,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,iCAWiB;AAVf,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;AACnB,mGAAA,UAAU,OAAA"}

package/dist/cjs/package.json

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

package/dist/cjs/resources/base.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseResource = void 0;
+const errors_1 = require("../errors");
+const types_1 = require("../types");
+const utils_1 = require("../utils");
+/**
+ * Base class for API resources
+ *
+ * Provides common functionality for chain resolution and address validation
+ * that is shared across all resource implementations.
+ */
+class BaseResource {
+    httpClient;
+    defaultChain;
+    constructor(httpClient, defaultChain) {
+        this.httpClient = httpClient;
+        this.defaultChain = defaultChain;
+    }
+    /**
+     * Resolve the chain to use for a request
+     * @throws ValidationError if no chain is specified and no default is set
+     */
+    resolveChain(options) {
+        const chain = options?.chain ?? this.defaultChain;
+        if (!chain) {
+            throw new errors_1.ValidationError('Chain is required. Either specify chain in options or set defaultChain in client configuration.');
+        }
+        return chain;
+    }
+    /**
+     * Validate address format for the given chain
+     * @throws ValidationError if address format is invalid for the chain
+     */
+    validateAddress(address, chain) {
+        if (!(0, utils_1.isValidAddress)(address, chain)) {
+            const chainName = types_1.CHAIN_NAMES[chain] || chain;
+            throw new errors_1.ValidationError(`Invalid ${chainName} address: "${address}". Please provide a valid address format for the ${chainName} blockchain.`);
+        }
+    }
+}
+exports.BaseResource = BaseResource;
+//# sourceMappingURL=base.js.map

package/dist/cjs/resources/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/resources/base.ts"],"names":[],"mappings":";;;AACA,sCAA4C;AAC5C,oCAA8C;AAC9C,oCAA0C;AAE1C;;;;;GAKG;AACH,MAAsB,YAAY;IAEX;IACA;IAFrB,YACqB,UAAsB,EACtB,YAAoB;QADpB,eAAU,GAAV,UAAU,CAAY;QACtB,iBAAY,GAAZ,YAAY,CAAQ;IACtC,CAAC;IAEJ;;;OAGG;IACO,YAAY,CAAC,OAA2B;QAChD,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC;QAClD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,wBAAe,CACvB,iGAAiG,CAClG,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACO,eAAe,CAAC,OAAe,EAAE,KAAY;QACrD,IAAI,CAAC,IAAA,sBAAc,EAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,mBAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;YAC9C,MAAM,IAAI,wBAAe,CACvB,WAAW,SAAS,cAAc,OAAO,oDAAoD,SAAS,cAAc,CACrH,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAhCD,oCAgCC"}

package/dist/cjs/resources/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseResource = void 0;
+var base_1 = require("./base");
+Object.defineProperty(exports, "BaseResource", { enumerable: true, get: function () { return base_1.BaseResource; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/index.ts"],"names":[],"mappings":";;;AAAA,+BAAsC;AAA7B,oGAAA,YAAY,OAAA"}