@rlajous/sdk-core 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Webacy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,96 @@
+# @rlajous/sdk-core
+
+Core utilities and shared internals for Webacy SDK packages. This package is automatically installed as a dependency of `@rlajous/sdk-trading` and `@rlajous/sdk-threat`.
+
+## Installation
+
+This package is typically not installed directly. Instead, install one of the SDK packages:
+
+```bash
+npm install @rlajous/sdk           # Full SDK
+npm install @rlajous/sdk-trading   # Trading analysis only
+npm install @rlajous/sdk-threat    # Threat analysis only
+```
+
+## What's Included
+
+### Chain Support
+
+```typescript
+import { Chain, isEvmChain, CHAIN_IDS, CHAIN_NAMES } from '@rlajous/sdk-core';
+
+// Check if a chain is EVM-compatible
+if (isEvmChain(Chain.ETH)) {
+  console.log('Using EVM chain');
+}
+
+// Get chain metadata
+console.log(CHAIN_NAMES[Chain.SOL]); // "Solana"
+console.log(CHAIN_IDS[Chain.ETH]);   // 1
+```
+
+### Error Classes
+
+```typescript
+import {
+  WebacyError,
+  AuthenticationError,
+  RateLimitError,
+  ValidationError,
+  NotFoundError,
+  NetworkError,
+} from '@rlajous/sdk-core';
+
+try {
+  await client.addresses.analyze('0x...');
+} catch (error) {
+  if (error instanceof RateLimitError) {
+    console.log(`Retry after ${error.retryAfter} seconds`);
+  }
+}
+```
+
+### Type Definitions
+
+```typescript
+import type {
+  RiskTag,
+  RiskModule,
+  RiskCategory,
+  TokenMetadata,
+  OwnershipDistribution,
+} from '@rlajous/sdk-core';
+```
+
+### Address Validation
+
+```typescript
+import {
+  isValidAddress,
+  isValidEvmAddress,
+  isValidSolanaAddress,
+} from '@rlajous/sdk-core';
+
+isValidAddress('0x742d35Cc...', Chain.ETH); // true
+isValidSolanaAddress('EPjFWdd5Aufq...'); // true
+```
+
+## Supported Chains
+
+| Chain | Code | EVM |
+|-------|------|-----|
+| Ethereum | `eth` | Yes |
+| Base | `base` | Yes |
+| BSC | `bsc` | Yes |
+| Polygon | `pol` | Yes |
+| Arbitrum | `arb` | Yes |
+| Optimism | `opt` | Yes |
+| Solana | `sol` | No |
+| TON | `ton` | No |
+| Sui | `sui` | No |
+| Stellar | `stellar` | No |
+| Bitcoin | `btc` | No |
+
+## License
+
+MIT

package/dist/cjs/client-base.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseClient = void 0;
+const config_1 = require("./config");
+const http_1 = require("./http");
+const errors_1 = require("./errors");
+/**
+ * Base client class for Webacy SDK
+ *
+ * Provides shared functionality for all Webacy client implementations
+ * including HTTP client setup, authentication, and interceptors.
+ */
+class BaseClient {
+    httpClient;
+    config;
+    /**
+     * Default chain to use when chain is not specified in API calls
+     */
+    defaultChain;
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new errors_1.AuthenticationError('API key is required');
+        }
+        this.config = {
+            ...config,
+            baseUrl: config.baseUrl ?? config_1.DEFAULT_CONFIG.baseUrl,
+            apiVersion: config.apiVersion ?? config_1.DEFAULT_CONFIG.apiVersion,
+            timeout: config.timeout ?? config_1.DEFAULT_CONFIG.timeout,
+        };
+        this.defaultChain = config.defaultChain;
+        this.httpClient = new http_1.HttpClient({
+            baseUrl: (0, config_1.buildBaseUrl)(this.config),
+            timeout: this.config.timeout,
+            retry: config.retry,
+            debug: config.debug,
+            logger: config.logger,
+            headers: {
+                'x-api-key': config.apiKey,
+                ...config.headers,
+            },
+        });
+    }
+    /**
+     * Add a request interceptor
+     *
+     * Request interceptors are called before each request is sent.
+     * Use them to modify requests, add headers, or log requests.
+     *
+     * @example
+     * ```typescript
+     * client.addRequestInterceptor((url, config) => {
+     *   console.log(`Making request to ${url}`);
+     *   return config;
+     * });
+     * ```
+     */
+    addRequestInterceptor(interceptor) {
+        this.httpClient.addRequestInterceptor(interceptor);
+    }
+    /**
+     * Add a response interceptor
+     *
+     * Response interceptors are called after each successful response.
+     * Use them to transform responses or log data.
+     *
+     * @example
+     * ```typescript
+     * client.addResponseInterceptor((response) => {
+     *   console.log(`Received ${response.status} response`);
+     *   return response;
+     * });
+     * ```
+     */
+    addResponseInterceptor(interceptor) {
+        this.httpClient.addResponseInterceptor(interceptor);
+    }
+    /**
+     * Add an error interceptor
+     *
+     * Error interceptors are called when a request fails.
+     * Use them to handle errors globally or transform error types.
+     *
+     * @example
+     * ```typescript
+     * client.addErrorInterceptor((error) => {
+     *   if (error instanceof RateLimitError) {
+     *     console.warn('Rate limited, will retry...');
+     *   }
+     *   return error;
+     * });
+     * ```
+     */
+    addErrorInterceptor(interceptor) {
+        this.httpClient.addErrorInterceptor(interceptor);
+    }
+    /**
+     * Make a GET request
+     */
+    get(path, options) {
+        return this.httpClient.get(path, {
+            timeout: options?.timeout,
+            signal: options?.signal,
+        });
+    }
+    /**
+     * Make a POST request
+     */
+    post(path, body, options) {
+        return this.httpClient.post(path, body, {
+            timeout: options?.timeout,
+            signal: options?.signal,
+        });
+    }
+    /**
+     * Make a PUT request
+     */
+    put(path, body, options) {
+        return this.httpClient.put(path, body, {
+            timeout: options?.timeout,
+            signal: options?.signal,
+        });
+    }
+    /**
+     * Make a DELETE request
+     */
+    delete(path, options) {
+        return this.httpClient.delete(path, {
+            timeout: options?.timeout,
+            signal: options?.signal,
+        });
+    }
+    /**
+     * Build query string from parameters
+     */
+    buildQueryString(params) {
+        const searchParams = new URLSearchParams();
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined || value === null) {
+                continue;
+            }
+            if (Array.isArray(value)) {
+                for (const item of value) {
+                    searchParams.append(key, String(item));
+                }
+            }
+            else {
+                searchParams.append(key, String(value));
+            }
+        }
+        const queryString = searchParams.toString();
+        return queryString ? `?${queryString}` : '';
+    }
+}
+exports.BaseClient = BaseClient;
+//# sourceMappingURL=client-base.js.map

package/dist/cjs/client-base.js.map

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

package/dist/cjs/config.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = exports.defaultLogger = void 0;
+exports.buildBaseUrl = buildBaseUrl;
+/**
+ * Default console logger implementation
+ */
+exports.defaultLogger = {
+    debug: (message, data) => console.debug(`[Webacy SDK] ${message}`, data ?? ''),
+    info: (message, data) => console.info(`[Webacy SDK] ${message}`, data ?? ''),
+    warn: (message, data) => console.warn(`[Webacy SDK] ${message}`, data ?? ''),
+    error: (message, data) => console.error(`[Webacy SDK] ${message}`, data ?? ''),
+};
+/**
+ * Default API configuration
+ */
+exports.DEFAULT_CONFIG = {
+    baseUrl: 'https://api.webacy.com',
+    apiVersion: 'v2',
+    timeout: 30000,
+};
+/**
+ * Build the full base URL from configuration
+ */
+function buildBaseUrl(config) {
+    const baseUrl = config.baseUrl ?? exports.DEFAULT_CONFIG.baseUrl;
+    // API doesn't need /api/v2 prefix - endpoints are directly on base URL
+    return baseUrl.replace(/\/$/, '');
+}
+//# sourceMappingURL=config.js.map

package/dist/cjs/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":";;;AA6IA,oCAIC;AAhID;;GAEG;AACU,QAAA,aAAa,GAAW;IACnC,KAAK,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC;IAC9E,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC;IAC5E,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC;IAC5E,KAAK,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC;CAC/E,CAAC;AAwGF;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,OAAO,EAAE,wBAAwB;IACjC,UAAU,EAAE,IAAI;IAChB,OAAO,EAAE,KAAK;CACN,CAAC;AAEX;;GAEG;AACH,SAAgB,YAAY,CAAC,MAA0B;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,sBAAc,CAAC,OAAO,CAAC;IACzD,uEAAuE;IACvE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/cjs/errors/authentication.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthenticationError = void 0;
+const base_1 = require("./base");
+/**
+ * Thrown when API key is invalid or missing
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.addresses.analyze(address, { chain: Chain.ETH });
+ * } catch (error) {
+ *   if (error instanceof AuthenticationError) {
+ *     console.error('Authentication failed:', error.message);
+ *     console.error('Suggestion:', error.getRecoverySuggestion());
+ *   }
+ * }
+ * ```
+ */
+class AuthenticationError extends base_1.WebacyError {
+    constructor(message = 'Invalid or missing API key', options = {}) {
+        super(message, {
+            status: 401,
+            code: 'AUTHENTICATION_ERROR',
+            requestId: options.requestId,
+            endpoint: options.endpoint,
+        });
+        this.name = 'AuthenticationError';
+    }
+    getRecoverySuggestion() {
+        return 'Verify your API key is correct and has not expired. You can get a new API key from the Webacy dashboard at https://webacy.com';
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+//# sourceMappingURL=authentication.js.map

package/dist/cjs/errors/authentication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authentication.js","sourceRoot":"","sources":["../../../src/errors/authentication.ts"],"names":[],"mappings":";;;AAAA,iCAAqC;AAErC;;;;;;;;;;;;;;GAcG;AACH,MAAa,mBAAoB,SAAQ,kBAAW;IAClD,YACE,OAAO,GAAG,4BAA4B,EACtC,UAAqD,EAAE;QAEvD,KAAK,CAAC,OAAO,EAAE;YACb,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,sBAAsB;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;IAEQ,qBAAqB;QAC5B,OAAO,+HAA+H,CAAC;IACzI,CAAC;CACF;AAjBD,kDAiBC"}

package/dist/cjs/errors/base.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebacyError = void 0;
+/**
+ * Base error class for all Webacy SDK errors
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.addresses.analyze(address, { chain: Chain.ETH });
+ * } catch (error) {
+ *   if (error instanceof WebacyError) {
+ *     console.error(`Error: ${error.message}`);
+ *     console.error(`Code: ${error.code}`);
+ *     if (error.endpoint) {
+ *       console.error(`Endpoint: ${error.endpoint}`);
+ *     }
+ *     if (error.requestId) {
+ *       console.error(`Request ID: ${error.requestId} (include this when contacting support)`);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+class WebacyError extends Error {
+    /** HTTP status code if applicable */
+    status;
+    /** Error code for programmatic handling */
+    code;
+    /** Original error if wrapped */
+    cause;
+    /** Request ID for support inquiries */
+    requestId;
+    /** API endpoint that failed (for debugging) */
+    endpoint;
+    constructor(message, options) {
+        super(message);
+        this.name = 'WebacyError';
+        this.status = options.status;
+        this.code = options.code;
+        this.cause = options.cause;
+        this.requestId = options.requestId;
+        this.endpoint = options.endpoint;
+        // Maintain proper stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Check if this error is retryable
+     */
+    isRetryable() {
+        return false;
+    }
+    /**
+     * Convert to JSON for logging
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            status: this.status,
+            requestId: this.requestId,
+            endpoint: this.endpoint,
+        };
+    }
+    /**
+     * Get a user-friendly description of how to resolve this error
+     */
+    getRecoverySuggestion() {
+        return undefined;
+    }
+}
+exports.WebacyError = WebacyError;
+//# sourceMappingURL=base.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/errors/base.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAa,WAAY,SAAQ,KAAK;IACpC,qCAAqC;IACrB,MAAM,CAAU;IAEhC,2CAA2C;IAC3B,IAAI,CAAS;IAE7B,gCAAgC;IAChB,KAAK,CAAS;IAE9B,uCAAuC;IACvB,SAAS,CAAU;IAEnC,+CAA+C;IAC/B,QAAQ,CAAU;IAElC,YACE,OAAe,EACf,OAMC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAEjC,8BAA8B;QAC9B,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAnED,kCAmEC"}

package/dist/cjs/errors/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkError = exports.NotFoundError = exports.ValidationError = exports.RateLimitError = exports.AuthenticationError = exports.WebacyError = void 0;
+var base_1 = require("./base");
+Object.defineProperty(exports, "WebacyError", { enumerable: true, get: function () { return base_1.WebacyError; } });
+var authentication_1 = require("./authentication");
+Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return authentication_1.AuthenticationError; } });
+var rate_limit_1 = require("./rate-limit");
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return rate_limit_1.RateLimitError; } });
+var validation_1 = require("./validation");
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return validation_1.ValidationError; } });
+var not_found_1 = require("./not-found");
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return not_found_1.NotFoundError; } });
+var network_1 = require("./network");
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return network_1.NetworkError; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":";;;AAAA,+BAAqC;AAA5B,mGAAA,WAAW,OAAA;AACpB,mDAAuD;AAA9C,qHAAA,mBAAmB,OAAA;AAC5B,2CAA8C;AAArC,4GAAA,cAAc,OAAA;AACvB,2CAA+C;AAAtC,6GAAA,eAAe,OAAA;AACxB,yCAA4C;AAAnC,0GAAA,aAAa,OAAA;AACtB,qCAAyC;AAAhC,uGAAA,YAAY,OAAA"}

package/dist/cjs/errors/network.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkError = void 0;
+const base_1 = require("./base");
+/**
+ * Thrown when a network error occurs
+ *
+ * This includes timeouts, connection failures, and other transport-level errors.
+ * The SDK automatically retries network errors with exponential backoff.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.addresses.analyze(address, { chain: Chain.ETH });
+ * } catch (error) {
+ *   if (error instanceof NetworkError) {
+ *     console.error('Network error:', error.message);
+ *     if (error.cause) {
+ *       console.error('Cause:', error.cause.message);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+class NetworkError extends base_1.WebacyError {
+    constructor(message = 'Network request failed', options = {}) {
+        super(message, {
+            code: 'NETWORK_ERROR',
+            cause: options.cause,
+            endpoint: options.endpoint,
+        });
+        this.name = 'NetworkError';
+    }
+    isRetryable() {
+        return true;
+    }
+    getRecoverySuggestion() {
+        if (this.message.includes('timed out')) {
+            return 'The request timed out. Try increasing the timeout option or check your network connection.';
+        }
+        return 'Check your network connection and try again. If the problem persists, the Webacy API may be temporarily unavailable.';
+    }
+}
+exports.NetworkError = NetworkError;
+//# sourceMappingURL=network.js.map

package/dist/cjs/errors/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../src/errors/network.ts"],"names":[],"mappings":";;;AAAA,iCAAqC;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,YAAa,SAAQ,kBAAW;IAC3C,YACE,OAAO,GAAG,wBAAwB,EAClC,UAAgD,EAAE;QAElD,KAAK,CAAC,OAAO,EAAE;YACb,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;IAEQ,WAAW;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAEQ,qBAAqB;QAC5B,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACvC,OAAO,4FAA4F,CAAC;QACtG,CAAC;QACD,OAAO,sHAAsH,CAAC;IAChI,CAAC;CACF;AAvBD,oCAuBC"}

package/dist/cjs/errors/not-found.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotFoundError = void 0;
+const base_1 = require("./base");
+/**
+ * Thrown when a resource is not found
+ *
+ * This typically means the address or resource doesn't exist on the specified chain,
+ * or hasn't been indexed yet.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.addresses.analyze(address, { chain: Chain.ETH });
+ * } catch (error) {
+ *   if (error instanceof NotFoundError) {
+ *     console.error('Resource not found:', error.message);
+ *     // The address may not exist or may not have any activity
+ *   }
+ * }
+ * ```
+ */
+class NotFoundError extends base_1.WebacyError {
+    constructor(message = 'Resource not found', options = {}) {
+        super(message, {
+            status: 404,
+            code: 'NOT_FOUND_ERROR',
+            requestId: options.requestId,
+            endpoint: options.endpoint,
+        });
+        this.name = 'NotFoundError';
+    }
+    getRecoverySuggestion() {
+        return 'Verify the address exists and has activity on the specified chain. For new addresses, data may take a few minutes to become available.';
+    }
+}
+exports.NotFoundError = NotFoundError;
+//# sourceMappingURL=not-found.js.map

package/dist/cjs/errors/not-found.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-found.js","sourceRoot":"","sources":["../../../src/errors/not-found.ts"],"names":[],"mappings":";;;AAAA,iCAAqC;AAErC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,aAAc,SAAQ,kBAAW;IAC5C,YACE,OAAO,GAAG,oBAAoB,EAC9B,UAAqD,EAAE;QAEvD,KAAK,CAAC,OAAO,EAAE;YACb,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,iBAAiB;YACvB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;IAEQ,qBAAqB;QAC5B,OAAO,wIAAwI,CAAC;IAClJ,CAAC;CACF;AAjBD,sCAiBC"}

package/dist/cjs/errors/rate-limit.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitError = void 0;
+const base_1 = require("./base");
+/**
+ * Thrown when rate limit is exceeded
+ *
+ * The SDK automatically retries rate-limited requests with exponential backoff.
+ * If you're seeing this error frequently, consider reducing request frequency
+ * or upgrading your API plan.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.addresses.analyze(address, { chain: Chain.ETH });
+ * } catch (error) {
+ *   if (error instanceof RateLimitError) {
+ *     console.error('Rate limited:', error.message);
+ *     if (error.retryAfter) {
+ *       console.log(`Retry after ${error.retryAfter} seconds`);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+class RateLimitError extends base_1.WebacyError {
+    /** When the rate limit resets (Unix timestamp) */
+    resetAt;
+    /** Number of seconds until reset */
+    retryAfter;
+    constructor(message = 'Rate limit exceeded', options = {}) {
+        super(message, {
+            status: 429,
+            code: 'RATE_LIMIT_ERROR',
+            requestId: options.requestId,
+            endpoint: options.endpoint,
+        });
+        this.name = 'RateLimitError';
+        this.resetAt = options.resetAt;
+        this.retryAfter = options.retryAfter;
+    }
+    isRetryable() {
+        return true;
+    }
+    getRecoverySuggestion() {
+        if (this.retryAfter) {
+            return `Wait ${this.retryAfter} seconds before retrying. Consider implementing request throttling or upgrading your API plan for higher limits.`;
+        }
+        return 'Wait a moment before retrying. Consider implementing request throttling or upgrading your API plan for higher limits.';
+    }
+}
+exports.RateLimitError = RateLimitError;
+//# sourceMappingURL=rate-limit.js.map

package/dist/cjs/errors/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../../src/errors/rate-limit.ts"],"names":[],"mappings":";;;AAAA,iCAAqC;AAErC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAa,cAAe,SAAQ,kBAAW;IAC7C,kDAAkD;IAClC,OAAO,CAAU;IAEjC,oCAAoC;IACpB,UAAU,CAAU;IAEpC,YACE,OAAO,GAAG,qBAAqB,EAC/B,UAA4F,EAAE;QAE9F,KAAK,CAAC,OAAO,EAAE;YACb,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,kBAAkB;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACvC,CAAC;IAEQ,WAAW;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAEQ,qBAAqB;QAC5B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO,QAAQ,IAAI,CAAC,UAAU,kHAAkH,CAAC;QACnJ,CAAC;QACD,OAAO,uHAAuH,CAAC;IACjI,CAAC;CACF;AAhCD,wCAgCC"}

package/dist/cjs/errors/validation.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationError = void 0;
+const base_1 = require("./base");
+/**
+ * Thrown when request validation fails
+ *
+ * This error occurs when the provided input doesn't meet the API requirements.
+ * Common causes include invalid addresses, unsupported chains, or missing parameters.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.addresses.analyze(address, { chain: Chain.ETH });
+ * } catch (error) {
+ *   if (error instanceof ValidationError) {
+ *     console.error('Validation failed:', error.message);
+ *     if (error.errors) {
+ *       for (const [field, messages] of Object.entries(error.errors)) {
+ *         console.error(`  ${field}: ${messages.join(', ')}`);
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+class ValidationError extends base_1.WebacyError {
+    /** Field-level validation errors */
+    errors;
+    constructor(message = 'Validation failed', options = {}) {
+        super(message, {
+            status: 400,
+            code: 'VALIDATION_ERROR',
+            requestId: options.requestId,
+            endpoint: options.endpoint,
+        });
+        this.name = 'ValidationError';
+        this.errors = options.errors;
+    }
+    getRecoverySuggestion() {
+        if (this.errors && Object.keys(this.errors).length > 0) {
+            const fields = Object.keys(this.errors).join(', ');
+            return `Check the following fields: ${fields}. Ensure address formats match the specified blockchain and all required parameters are provided.`;
+        }
+        return 'Check your input parameters. Ensure address formats match the specified blockchain (e.g., 0x... for EVM chains, base58 for Solana).';
+    }
+}
+exports.ValidationError = ValidationError;
+//# sourceMappingURL=validation.js.map

package/dist/cjs/errors/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/errors/validation.ts"],"names":[],"mappings":";;;AAAA,iCAAqC;AAErC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAa,eAAgB,SAAQ,kBAAW;IAC9C,oCAAoC;IACpB,MAAM,CAA4B;IAElD,YACE,OAAO,GAAG,mBAAmB,EAC7B,UAAwF,EAAE;QAE1F,KAAK,CAAC,OAAO,EAAE;YACb,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,kBAAkB;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;IAEQ,qBAAqB;QAC5B,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnD,OAAO,+BAA+B,MAAM,mGAAmG,CAAC;QAClJ,CAAC;QACD,OAAO,qIAAqI,CAAC;IAC/I,CAAC;CACF;AAzBD,0CAyBC"}