@rlajous/sdk-core 1.0.0

package/dist/cjs/types/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenStandard = exports.TypeOfAddress = exports.RiskLevel = exports.RiskScore = exports.RiskModule = exports.CHAIN_NAMES = exports.CHAIN_IDS = exports.isEvmChain = exports.getChainCompatibility = exports.ChainCompatibility = exports.Chain = void 0;
+var chain_1 = require("./chain");
+Object.defineProperty(exports, "Chain", { enumerable: true, get: function () { return chain_1.Chain; } });
+Object.defineProperty(exports, "ChainCompatibility", { enumerable: true, get: function () { return chain_1.ChainCompatibility; } });
+Object.defineProperty(exports, "getChainCompatibility", { enumerable: true, get: function () { return chain_1.getChainCompatibility; } });
+Object.defineProperty(exports, "isEvmChain", { enumerable: true, get: function () { return chain_1.isEvmChain; } });
+Object.defineProperty(exports, "CHAIN_IDS", { enumerable: true, get: function () { return chain_1.CHAIN_IDS; } });
+Object.defineProperty(exports, "CHAIN_NAMES", { enumerable: true, get: function () { return chain_1.CHAIN_NAMES; } });
+var modules_1 = require("./modules");
+Object.defineProperty(exports, "RiskModule", { enumerable: true, get: function () { return modules_1.RiskModule; } });
+var common_1 = require("./common");
+Object.defineProperty(exports, "RiskScore", { enumerable: true, get: function () { return common_1.RiskScore; } });
+Object.defineProperty(exports, "RiskLevel", { enumerable: true, get: function () { return common_1.RiskLevel; } });
+Object.defineProperty(exports, "TypeOfAddress", { enumerable: true, get: function () { return common_1.TypeOfAddress; } });
+Object.defineProperty(exports, "TokenStandard", { enumerable: true, get: function () { return common_1.TokenStandard; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;AAAA,iCAOiB;AANf,8FAAA,KAAK,OAAA;AACL,2GAAA,kBAAkB,OAAA;AAClB,8GAAA,qBAAqB,OAAA;AACrB,mGAAA,UAAU,OAAA;AACV,kGAAA,SAAS,OAAA;AACT,oGAAA,WAAW,OAAA;AAGb,qCAAuC;AAA9B,qGAAA,UAAU,OAAA;AAoBnB,mCAA8E;AAArE,mGAAA,SAAS,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,uGAAA,aAAa,OAAA;AAAE,uGAAA,aAAa,OAAA"}

package/dist/cjs/types/modules.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RiskModule = void 0;
+/**
+ * Risk analysis modules available for requests
+ *
+ * Use these to specify which analysis modules to run when making API requests.
+ * Requesting fewer modules can improve response time.
+ */
+var RiskModule;
+(function (RiskModule) {
+    // Core security analysis
+    /** Contract ownership, upgradeability, access controls */
+    RiskModule["GOVERNANCE_ANALYSIS"] = "governance_analysis";
+    /** Freezeable, mintable, blacklist, whitelist */
+    RiskModule["TOKEN_SECURITY"] = "token_security";
+    /** Static/dynamic code analysis, vulnerabilities */
+    RiskModule["CONTRACT_ANALYSIS"] = "contract_analysis";
+    /** Source code analysis, vulnerabilities */
+    RiskModule["SOURCE_CODE_ANALYSIS"] = "source_code_analysis";
+    // Financial risk analysis
+    /** Price, volatility, market cap, liquidity */
+    RiskModule["MARKET_DATA"] = "market_data";
+    /** Token distribution, concentration risks */
+    RiskModule["HOLDER_ANALYSIS"] = "holder_analysis";
+    /** Pool data, unlock schedules, LP analysis */
+    RiskModule["LIQUIDITY_ANALYSIS"] = "liquidity_analysis";
+    // Fraud and compliance
+    /** Hacker, drainer, rugpull detection */
+    RiskModule["FRAUD_DETECTION"] = "fraud_detection";
+    /** OFAC, sanctioned addresses */
+    RiskModule["SANCTIONS_COMPLIANCE"] = "sanctions_compliance";
+    /** Tornado cash, coin mixers */
+    RiskModule["MIXER_DETECTION"] = "mixer_detection";
+    // Address behavior analysis
+    /** Trading patterns, automated trading */
+    RiskModule["ADDRESS_BEHAVIOR"] = "address_behavior";
+    /** Address poisoning, wash trading */
+    RiskModule["TRANSACTION_ANALYSIS"] = "transaction_analysis";
+    /** Reported addresses, spam detection */
+    RiskModule["REPUTATION_ANALYSIS"] = "reputation_analysis";
+    // Chain-specific analysis
+    /** Solana-only risks (bundling, sniping) */
+    RiskModule["SOLANA_SPECIFIC"] = "solana_specific";
+    /** EVM-only risks (gas optimization, MEV) */
+    RiskModule["EVM_SPECIFIC"] = "evm_specific";
+    /** TON-only risks (jetton standards, etc.) */
+    RiskModule["TON_SPECIFIC"] = "ton_specific";
+    /** SUI-only risks (coin standards, object model) */
+    RiskModule["SUI_SPECIFIC"] = "sui_specific";
+    // Basic metadata (always fast)
+    /** Address type, age, balance checks */
+    RiskModule["BASIC_INFO"] = "basic_info";
+    // Ultra-fast module for core security flags
+    /** Only is_mintable, freezeable, is_metadata_immutable */
+    RiskModule["SECURITY_ESSENTIALS"] = "security_essentials";
+    // Fast fund flow screening with boolean indicators
+    /** Boolean flags for OFAC, hacker, mixer, drainer risks */
+    RiskModule["FUND_FLOW_SCREENING"] = "fund_flow_screening";
+    // Developer behavior and migration pattern analysis
+    /** Multi-platform developer behavior, token launch patterns */
+    RiskModule["DEVELOPER_MIGRATION"] = "developer_migration";
+})(RiskModule || (exports.RiskModule = RiskModule = {}));
+//# sourceMappingURL=modules.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"modules.js","sourceRoot":"","sources":["../../../src/types/modules.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,IAAY,UA4DX;AA5DD,WAAY,UAAU;IACpB,yBAAyB;IACzB,0DAA0D;IAC1D,yDAA2C,CAAA;IAC3C,iDAAiD;IACjD,+CAAiC,CAAA;IACjC,oDAAoD;IACpD,qDAAuC,CAAA;IACvC,4CAA4C;IAC5C,2DAA6C,CAAA;IAE7C,0BAA0B;IAC1B,+CAA+C;IAC/C,yCAA2B,CAAA;IAC3B,8CAA8C;IAC9C,iDAAmC,CAAA;IACnC,+CAA+C;IAC/C,uDAAyC,CAAA;IAEzC,uBAAuB;IACvB,yCAAyC;IACzC,iDAAmC,CAAA;IACnC,iCAAiC;IACjC,2DAA6C,CAAA;IAC7C,gCAAgC;IAChC,iDAAmC,CAAA;IAEnC,4BAA4B;IAC5B,0CAA0C;IAC1C,mDAAqC,CAAA;IACrC,sCAAsC;IACtC,2DAA6C,CAAA;IAC7C,yCAAyC;IACzC,yDAA2C,CAAA;IAE3C,0BAA0B;IAC1B,4CAA4C;IAC5C,iDAAmC,CAAA;IACnC,6CAA6C;IAC7C,2CAA6B,CAAA;IAC7B,8CAA8C;IAC9C,2CAA6B,CAAA;IAC7B,oDAAoD;IACpD,2CAA6B,CAAA;IAE7B,+BAA+B;IAC/B,wCAAwC;IACxC,uCAAyB,CAAA;IAEzB,4CAA4C;IAC5C,0DAA0D;IAC1D,yDAA2C,CAAA;IAE3C,mDAAmD;IACnD,2DAA2D;IAC3D,yDAA2C,CAAA;IAE3C,oDAAoD;IACpD,+DAA+D;IAC/D,yDAA2C,CAAA;AAC7C,CAAC,EA5DW,UAAU,0BAAV,UAAU,QA4DrB"}

package/dist/cjs/utils/address-validation.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidEvmAddress = isValidEvmAddress;
+exports.isValidSolanaAddress = isValidSolanaAddress;
+exports.isValidBitcoinAddress = isValidBitcoinAddress;
+exports.isValidTonAddress = isValidTonAddress;
+exports.isValidSuiAddress = isValidSuiAddress;
+exports.isValidStellarAddress = isValidStellarAddress;
+exports.isValidAddress = isValidAddress;
+exports.normalizeEvmAddress = normalizeEvmAddress;
+exports.normalizeAddress = normalizeAddress;
+const types_1 = require("../types");
+/**
+ * Validate an Ethereum address format
+ */
+function isValidEvmAddress(address) {
+    return /^0x[a-fA-F0-9]{40}$/.test(address);
+}
+/**
+ * Validate a Solana address format (base58)
+ */
+function isValidSolanaAddress(address) {
+    // Base58 character set (no 0, O, I, l)
+    return /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(address);
+}
+/**
+ * Validate a Bitcoin address format
+ */
+function isValidBitcoinAddress(address) {
+    // P2PKH (starts with 1), P2SH (starts with 3), Bech32 (starts with bc1)
+    return /^[13][a-km-zA-HJ-NP-Z1-9]{25,34}$/.test(address) || /^bc1[a-z0-9]{39,59}$/.test(address);
+}
+/**
+ * Validate a TON address format
+ */
+function isValidTonAddress(address) {
+    // Raw format (48 bytes hex with workchain)
+    if (/^-?\d:[a-fA-F0-9]{64}$/.test(address)) {
+        return true;
+    }
+    // User-friendly format (base64)
+    if (/^[A-Za-z0-9_-]{48}$/.test(address)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Validate a Sui address format
+ */
+function isValidSuiAddress(address) {
+    return /^0x[a-fA-F0-9]{64}$/.test(address);
+}
+/**
+ * Validate a Stellar address format
+ *
+ * Supports both:
+ * - Standard account ID (G...)
+ * - Asset identifier (CODE:ISSUER)
+ */
+function isValidStellarAddress(address) {
+    // Standard Stellar account ID
+    if (/^G[A-Z2-7]{55}$/.test(address)) {
+        return true;
+    }
+    // Asset identifier (CODE:ISSUER)
+    if (/^[A-Za-z0-9]{1,12}:G[A-Z2-7]{55}$/.test(address)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Validate an address for a specific chain
+ *
+ * @param address - The address to validate
+ * @param chain - The blockchain to validate against
+ * @returns true if the address is valid for the chain
+ */
+function isValidAddress(address, chain) {
+    if (!address || typeof address !== 'string') {
+        return false;
+    }
+    if ((0, types_1.isEvmChain)(chain)) {
+        return isValidEvmAddress(address);
+    }
+    switch (chain) {
+        case types_1.Chain.SOL:
+            return isValidSolanaAddress(address);
+        case types_1.Chain.BTC:
+            return isValidBitcoinAddress(address);
+        case types_1.Chain.TON:
+            return isValidTonAddress(address);
+        case types_1.Chain.SUI:
+            return isValidSuiAddress(address);
+        case types_1.Chain.STELLAR:
+            return isValidStellarAddress(address);
+        default:
+            // Unknown chain, allow any non-empty string
+            return address.length > 0;
+    }
+}
+/**
+ * Normalize an EVM address to checksum format
+ */
+function normalizeEvmAddress(address) {
+    if (!isValidEvmAddress(address)) {
+        throw new Error(`Invalid EVM address: ${address}`);
+    }
+    return address.toLowerCase();
+}
+/**
+ * Normalize an address for a specific chain
+ *
+ * @param address - The address to normalize
+ * @param chain - The blockchain
+ * @returns The normalized address
+ */
+function normalizeAddress(address, chain) {
+    if ((0, types_1.isEvmChain)(chain)) {
+        return normalizeEvmAddress(address);
+    }
+    // For non-EVM chains, return as-is
+    return address;
+}
+//# sourceMappingURL=address-validation.js.map

package/dist/cjs/utils/address-validation.js.map

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

package/dist/cjs/utils/index.js

@@ -0,0 +1,14 @@
+"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 = void 0;
+var address_validation_1 = require("./address-validation");
+Object.defineProperty(exports, "isValidAddress", { enumerable: true, get: function () { return address_validation_1.isValidAddress; } });
+Object.defineProperty(exports, "isValidEvmAddress", { enumerable: true, get: function () { return address_validation_1.isValidEvmAddress; } });
+Object.defineProperty(exports, "isValidSolanaAddress", { enumerable: true, get: function () { return address_validation_1.isValidSolanaAddress; } });
+Object.defineProperty(exports, "isValidBitcoinAddress", { enumerable: true, get: function () { return address_validation_1.isValidBitcoinAddress; } });
+Object.defineProperty(exports, "isValidTonAddress", { enumerable: true, get: function () { return address_validation_1.isValidTonAddress; } });
+Object.defineProperty(exports, "isValidSuiAddress", { enumerable: true, get: function () { return address_validation_1.isValidSuiAddress; } });
+Object.defineProperty(exports, "isValidStellarAddress", { enumerable: true, get: function () { return address_validation_1.isValidStellarAddress; } });
+Object.defineProperty(exports, "normalizeAddress", { enumerable: true, get: function () { return address_validation_1.normalizeAddress; } });
+Object.defineProperty(exports, "normalizeEvmAddress", { enumerable: true, get: function () { return address_validation_1.normalizeEvmAddress; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;AAAA,2DAU8B;AAT5B,oHAAA,cAAc,OAAA;AACd,uHAAA,iBAAiB,OAAA;AACjB,0HAAA,oBAAoB,OAAA;AACpB,2HAAA,qBAAqB,OAAA;AACrB,uHAAA,iBAAiB,OAAA;AACjB,uHAAA,iBAAiB,OAAA;AACjB,2HAAA,qBAAqB,OAAA;AACrB,sHAAA,gBAAgB,OAAA;AAChB,yHAAA,mBAAmB,OAAA"}

package/dist/esm/client-base.js

@@ -0,0 +1,151 @@
+import { DEFAULT_CONFIG, buildBaseUrl } from './config';
+import { HttpClient, } from './http';
+import { AuthenticationError } from './errors';
+/**
+ * Base client class for Webacy SDK
+ *
+ * Provides shared functionality for all Webacy client implementations
+ * including HTTP client setup, authentication, and interceptors.
+ */
+export class BaseClient {
+    httpClient;
+    config;
+    /**
+     * Default chain to use when chain is not specified in API calls
+     */
+    defaultChain;
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new AuthenticationError('API key is required');
+        }
+        this.config = {
+            ...config,
+            baseUrl: config.baseUrl ?? DEFAULT_CONFIG.baseUrl,
+            apiVersion: config.apiVersion ?? DEFAULT_CONFIG.apiVersion,
+            timeout: config.timeout ?? DEFAULT_CONFIG.timeout,
+        };
+        this.defaultChain = config.defaultChain;
+        this.httpClient = new HttpClient({
+            baseUrl: 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}` : '';
+    }
+}
+//# sourceMappingURL=client-base.js.map

package/dist/esm/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/esm/config.js

@@ -0,0 +1,26 @@
+/**
+ * Default console logger implementation
+ */
+export const 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
+ */
+export const DEFAULT_CONFIG = {
+    baseUrl: 'https://api.webacy.com',
+    apiVersion: 'v2',
+    timeout: 30000,
+};
+/**
+ * Build the full base URL from configuration
+ */
+export function buildBaseUrl(config) {
+    const baseUrl = config.baseUrl ?? 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/esm/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,MAAM,CAAC,MAAM,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;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,wBAAwB;IACjC,UAAU,EAAE,IAAI;IAChB,OAAO,EAAE,KAAK;CACN,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC;IACzD,uEAAuE;IACvE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/esm/errors/authentication.js

@@ -0,0 +1,31 @@
+import { WebacyError } from './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());
+ *   }
+ * }
+ * ```
+ */
+export class AuthenticationError extends 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';
+    }
+}
+//# sourceMappingURL=authentication.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"authentication.js","sourceRoot":"","sources":["../../../src/errors/authentication.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,mBAAoB,SAAQ,WAAW;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"}

package/dist/esm/errors/base.js

@@ -0,0 +1,72 @@
+/**
+ * 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)`);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export 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;
+    }
+}
+//# sourceMappingURL=base.js.map

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

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

package/dist/esm/errors/index.js

@@ -0,0 +1,7 @@
+export { WebacyError } from './base';
+export { AuthenticationError } from './authentication';
+export { RateLimitError } from './rate-limit';
+export { ValidationError } from './validation';
+export { NotFoundError } from './not-found';
+export { NetworkError } from './network';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/esm/errors/network.js

@@ -0,0 +1,41 @@
+import { WebacyError } from './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);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export class NetworkError extends 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.';
+    }
+}
+//# sourceMappingURL=network.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../src/errors/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,YAAa,SAAQ,WAAW;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"}

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

@@ -0,0 +1,34 @@
+import { WebacyError } from './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
+ *   }
+ * }
+ * ```
+ */
+export class NotFoundError extends 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.';
+    }
+}
+//# sourceMappingURL=not-found.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"not-found.js","sourceRoot":"","sources":["../../../src/errors/not-found.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,aAAc,SAAQ,WAAW;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"}