@webacy-xyz/sdk-core 1.0.1

package/dist/types/client-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-base.d.ts","sourceRoot":"","sources":["../../src/client-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAgC,MAAM,UAAU,CAAC;AAC5E,OAAO,EACL,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;GAKG;AACH,8BAAsB,UAAU;IAC9B,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAC1C,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CACjC,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC,CAC/D,GACC,kBAAkB,CAAC;IAErB;;OAEG;IACH,SAAgB,YAAY,CAAC,EAAE,KAAK,CAAC;gBAEzB,MAAM,EAAE,kBAAkB;IA2BtC;;;;;;;;;;;;;OAaG;IACH,qBAAqB,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI;IAI5D;;;;;;;;;;;;;OAaG;IACH,sBAAsB,CAAC,WAAW,EAAE,mBAAmB,GAAG,IAAI;IAI9D;;;;;;;;;;;;;;;OAeG;IACH,mBAAmB,CAAC,WAAW,EAAE,gBAAgB,GAAG,IAAI;IAIxD;;OAEG;IACH,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAOlF;;OAEG;IACH,SAAS,CAAC,IAAI,CAAC,CAAC,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAO3B;;OAEG;IACH,SAAS,CAAC,GAAG,CAAC,CAAC,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAO3B;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAMtF;AAED;;GAEG;AACH,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}

package/dist/types/config.d.ts

@@ -0,0 +1,124 @@
+import { RetryConfig } from './http/retry';
+/**
+ * Debug mode options
+ */
+export type DebugMode = boolean | 'requests' | 'responses' | 'errors' | 'all';
+/**
+ * Logger interface for custom logging implementations
+ */
+export interface Logger {
+    debug(message: string, data?: unknown): void;
+    info(message: string, data?: unknown): void;
+    warn(message: string, data?: unknown): void;
+    error(message: string, data?: unknown): void;
+}
+/**
+ * Default console logger implementation
+ */
+export declare const defaultLogger: Logger;
+/**
+ * Webacy client configuration options
+ */
+export interface WebacyClientConfig {
+    /**
+     * Your Webacy API key
+     * @required
+     */
+    apiKey: string;
+    /**
+     * Base URL for the API
+     * @default 'https://api.webacy.com'
+     */
+    baseUrl?: string;
+    /**
+     * API version to use
+     * @default 'v2'
+     */
+    apiVersion?: string;
+    /**
+     * Default request timeout in milliseconds
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * Retry configuration for failed requests
+     */
+    retry?: Partial<RetryConfig>;
+    /**
+     * Custom headers to include with all requests
+     */
+    headers?: Record<string, string>;
+    /**
+     * Enable debug logging
+     *
+     * - `true` or `'all'`: Log requests, responses, and errors
+     * - `'requests'`: Log only outgoing requests
+     * - `'responses'`: Log only incoming responses
+     * - `'errors'`: Log only errors
+     * - `false`: Disable logging (default)
+     *
+     * @default false
+     *
+     * @example
+     * ```typescript
+     * const client = new WebacyClient({
+     *   apiKey: 'your-api-key',
+     *   debug: true, // Enable full debug logging
+     * });
+     * ```
+     */
+    debug?: DebugMode;
+    /**
+     * Custom logger instance
+     *
+     * Provide your own logger implementation (e.g., winston, pino)
+     *
+     * @example
+     * ```typescript
+     * import pino from 'pino';
+     *
+     * const client = new WebacyClient({
+     *   apiKey: 'your-api-key',
+     *   debug: true,
+     *   logger: pino({ level: 'debug' }),
+     * });
+     * ```
+     */
+    logger?: Logger;
+    /**
+     * Default blockchain to use when chain is not specified
+     *
+     * When set, you can omit the `chain` parameter on API calls
+     * and this chain will be used automatically.
+     *
+     * @example
+     * ```typescript
+     * import { Chain } from '@webacy-xyz/sdk';
+     *
+     * const client = new WebacyClient({
+     *   apiKey: 'your-api-key',
+     *   defaultChain: Chain.ETH,
+     * });
+     *
+     * // No need to specify chain - uses ETH by default
+     * const risk = await client.threat.addresses.analyze('0x...');
+     *
+     * // Can still override for specific calls
+     * const solRisk = await client.threat.addresses.analyze('...', { chain: Chain.SOL });
+     * ```
+     */
+    defaultChain?: import('./types').Chain;
+}
+/**
+ * Default API configuration
+ */
+export declare const DEFAULT_CONFIG: {
+    readonly baseUrl: "https://api.webacy.com";
+    readonly apiVersion: "v2";
+    readonly timeout: 30000;
+};
+/**
+ * Build the full base URL from configuration
+ */
+export declare function buildBaseUrl(config: WebacyClientConfig): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAK3B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAE7B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YAAY,CAAC,EAAE,OAAO,SAAS,EAAE,KAAK,CAAC;CACxC;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAI/D"}

package/dist/types/errors/authentication.d.ts

@@ -0,0 +1,24 @@
+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 declare class AuthenticationError extends WebacyError {
+    constructor(message?: string, options?: {
+        requestId?: string;
+        endpoint?: string;
+    });
+    getRecoverySuggestion(): string;
+}
+//# sourceMappingURL=authentication.d.ts.map

package/dist/types/errors/authentication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authentication.d.ts","sourceRoot":"","sources":["../../../src/errors/authentication.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;gBAEhD,OAAO,SAA+B,EACtC,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO;IAWhD,qBAAqB,IAAI,MAAM;CAGzC"}

package/dist/types/errors/base.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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 declare class WebacyError extends Error {
+    /** HTTP status code if applicable */
+    readonly status?: number;
+    /** Error code for programmatic handling */
+    readonly code: string;
+    /** Original error if wrapped */
+    readonly cause?: Error;
+    /** Request ID for support inquiries */
+    readonly requestId?: string;
+    /** API endpoint that failed (for debugging) */
+    readonly endpoint?: string;
+    constructor(message: string, options: {
+        status?: number;
+        code: string;
+        cause?: Error;
+        requestId?: string;
+        endpoint?: string;
+    });
+    /**
+     * Check if this error is retryable
+     */
+    isRetryable(): boolean;
+    /**
+     * Convert to JSON for logging
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Get a user-friendly description of how to resolve this error
+     */
+    getRecoverySuggestion(): string | undefined;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/types/errors/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/errors/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,qCAAqC;IACrC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhC,2CAA2C;IAC3C,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,gCAAgC;IAChC,SAAgB,KAAK,CAAC,EAAE,KAAK,CAAC;IAE9B,uCAAuC;IACvC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnC,+CAA+C;IAC/C,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;IAgBH;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAWjC;;OAEG;IACH,qBAAqB,IAAI,MAAM,GAAG,SAAS;CAG5C"}

package/dist/types/errors/index.d.ts

@@ -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.d.ts.map

package/dist/types/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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/types/errors/network.d.ts

@@ -0,0 +1,30 @@
+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 declare class NetworkError extends WebacyError {
+    constructor(message?: string, options?: {
+        cause?: Error;
+        endpoint?: string;
+    });
+    isRetryable(): boolean;
+    getRecoverySuggestion(): string;
+}
+//# sourceMappingURL=network.d.ts.map

package/dist/types/errors/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../src/errors/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAa,SAAQ,WAAW;gBAEzC,OAAO,SAA2B,EAClC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO;IAU3C,WAAW,IAAI,OAAO;IAItB,qBAAqB,IAAI,MAAM;CAMzC"}

package/dist/types/errors/not-found.d.ts

@@ -0,0 +1,27 @@
+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 declare class NotFoundError extends WebacyError {
+    constructor(message?: string, options?: {
+        requestId?: string;
+        endpoint?: string;
+    });
+    getRecoverySuggestion(): string;
+}
+//# sourceMappingURL=not-found.d.ts.map

package/dist/types/errors/not-found.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-found.d.ts","sourceRoot":"","sources":["../../../src/errors/not-found.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,aAAc,SAAQ,WAAW;gBAE1C,OAAO,SAAuB,EAC9B,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO;IAWhD,qBAAqB,IAAI,MAAM;CAGzC"}

package/dist/types/errors/rate-limit.d.ts

@@ -0,0 +1,37 @@
+import { WebacyError } from './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`);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class RateLimitError extends WebacyError {
+    /** When the rate limit resets (Unix timestamp) */
+    readonly resetAt?: number;
+    /** Number of seconds until reset */
+    readonly retryAfter?: number;
+    constructor(message?: string, options?: {
+        resetAt?: number;
+        retryAfter?: number;
+        requestId?: string;
+        endpoint?: string;
+    });
+    isRetryable(): boolean;
+    getRecoverySuggestion(): string;
+}
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/types/errors/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../../src/errors/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,kDAAkD;IAClD,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjC,oCAAoC;IACpC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGlC,OAAO,SAAwB,EAC/B,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO;IAavF,WAAW,IAAI,OAAO;IAItB,qBAAqB,IAAI,MAAM;CAMzC"}

package/dist/types/errors/validation.d.ts

@@ -0,0 +1,34 @@
+import { WebacyError } from './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(', ')}`);
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class ValidationError extends WebacyError {
+    /** Field-level validation errors */
+    readonly errors?: Record<string, string[]>;
+    constructor(message?: string, options?: {
+        errors?: Record<string, string[]>;
+        requestId?: string;
+        endpoint?: string;
+    });
+    getRecoverySuggestion(): string;
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/types/errors/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/errors/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,oCAAoC;IACpC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAGhD,OAAO,SAAsB,EAC7B,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO;IAYnF,qBAAqB,IAAI,MAAM;CAOzC"}

package/dist/types/http/client.d.ts

@@ -0,0 +1,160 @@
+import { WebacyError } from '../errors';
+import { RetryConfig } from './retry';
+import { DebugMode, Logger } from '../config';
+/**
+ * HTTP request configuration
+ */
+export interface HttpRequestConfig {
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    headers?: Record<string, string>;
+    body?: unknown;
+    timeout?: number;
+    signal?: AbortSignal;
+}
+/**
+ * HTTP response wrapper
+ */
+export interface HttpResponse<T = unknown> {
+    data: T;
+    status: number;
+    headers: Headers;
+    requestId?: string;
+}
+/**
+ * Request interceptor function
+ */
+export type RequestInterceptor = (url: string, config: HttpRequestConfig) => HttpRequestConfig | Promise<HttpRequestConfig>;
+/**
+ * Response interceptor function
+ */
+export type ResponseInterceptor<T = unknown> = (response: HttpResponse<T>) => HttpResponse<T> | Promise<HttpResponse<T>>;
+/**
+ * Error interceptor function
+ */
+export type ErrorInterceptor = (error: WebacyError) => WebacyError | Promise<WebacyError>;
+/**
+ * HTTP client configuration
+ */
+export interface HttpClientConfig {
+    /** Base URL for all requests */
+    baseUrl: string;
+    /** Default headers for all requests */
+    headers?: Record<string, string>;
+    /** Default timeout in milliseconds */
+    timeout?: number;
+    /** Retry configuration */
+    retry?: Partial<RetryConfig>;
+    /** Debug mode for logging */
+    debug?: DebugMode;
+    /** Custom logger instance */
+    logger?: Logger;
+}
+/**
+ * HTTP client with retry support and interceptors
+ */
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly defaultHeaders;
+    private readonly defaultTimeout;
+    private readonly retryConfig;
+    private readonly requestInterceptors;
+    private readonly responseInterceptors;
+    private readonly errorInterceptors;
+    private readonly debug;
+    private readonly logger;
+    constructor(config: HttpClientConfig);
+    /**
+     * Check if request logging is enabled
+     */
+    private shouldLogRequests;
+    /**
+     * Check if response logging is enabled
+     */
+    private shouldLogResponses;
+    /**
+     * Check if error logging is enabled
+     */
+    private shouldLogErrors;
+    /**
+     * Log a request
+     */
+    private logRequest;
+    /**
+     * Log a response
+     */
+    private logResponse;
+    /**
+     * Log an error
+     */
+    private logError;
+    /**
+     * Sanitize request body for logging (remove sensitive data)
+     * Recursively processes nested objects and arrays
+     */
+    private sanitizeBody;
+    /**
+     * Add a request interceptor
+     */
+    addRequestInterceptor(interceptor: RequestInterceptor): void;
+    /**
+     * Add a response interceptor
+     */
+    addResponseInterceptor(interceptor: ResponseInterceptor): void;
+    /**
+     * Add an error interceptor
+     */
+    addErrorInterceptor(interceptor: ErrorInterceptor): void;
+    /**
+     * Make a GET request
+     */
+    get<T>(path: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Make a POST request
+     */
+    post<T>(path: string, body?: unknown, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Make a PUT request
+     */
+    put<T>(path: string, body?: unknown, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Make a PATCH request
+     */
+    patch<T>(path: string, body?: unknown, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Make a DELETE request
+     */
+    delete<T>(path: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Make an HTTP request with retry support
+     */
+    private request;
+    /**
+     * Execute a single HTTP request
+     */
+    private executeRequest;
+    /**
+     * Create an appropriate error from an HTTP response
+     */
+    private createErrorFromResponse;
+    /**
+     * Wrap an unknown error in a WebacyError
+     */
+    private wrapError;
+    /**
+     * 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
+     */
+    private parseRetryAfter;
+    /**
+     * Combine multiple abort signals
+     */
+    private combineAbortSignals;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/types/http/client.d.ts.map

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

package/dist/types/http/index.d.ts

@@ -0,0 +1,3 @@
+export { HttpClient, type HttpClientConfig, type HttpRequestConfig, type HttpResponse, type RequestInterceptor, type ResponseInterceptor, type ErrorInterceptor, } from './client';
+export { type RetryConfig, DEFAULT_RETRY_CONFIG, calculateRetryDelay, isRetryableStatusCode, sleep, } from './retry';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,KAAK,WAAW,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,GACN,MAAM,SAAS,CAAC"}

package/dist/types/http/retry.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Retry configuration options
+ */
+export interface RetryConfig {
+    /** Maximum number of retry attempts */
+    maxRetries: number;
+    /** Initial delay between retries in milliseconds */
+    initialDelay: number;
+    /** Maximum delay between retries in milliseconds */
+    maxDelay: number;
+    /** Multiplier for exponential backoff */
+    backoffMultiplier: number;
+    /** HTTP status codes that should trigger a retry */
+    retryableStatusCodes: number[];
+}
+/**
+ * Default retry configuration
+ */
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * Calculate delay for a retry attempt using exponential backoff with jitter
+ */
+export declare function calculateRetryDelay(attempt: number, config: RetryConfig, retryAfter?: number): number;
+/**
+ * Check if a status code is retryable
+ */
+export declare function isRetryableStatusCode(statusCode: number, config: RetryConfig): boolean;
+/**
+ * Sleep for a given number of milliseconds
+ */
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/types/http/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/http/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAMlC,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAYR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAEtF;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+export { WebacyClientConfig, DEFAULT_CONFIG, buildBaseUrl, type DebugMode, type Logger, defaultLogger, } from './config';
+export { BaseClient } from './client-base';
+export { BaseResource } from './resources';
+export { HttpClient, type HttpClientConfig, type HttpRequestConfig, type HttpResponse, type RequestInterceptor, type ResponseInterceptor, type ErrorInterceptor, type RetryConfig, DEFAULT_RETRY_CONFIG, } from './http';
+export { WebacyError, AuthenticationError, RateLimitError, ValidationError, NotFoundError, NetworkError, } from './errors';
+export { Chain, ChainCompatibility, getChainCompatibility, isEvmChain, CHAIN_IDS, CHAIN_NAMES, RiskModule, RiskScore, RiskLevel, TypeOfAddress, TokenStandard, type RiskTag, type InformationalTag, type RiskCategory, type ConsolidatedRiskResult, type OwnershipDistribution, type TopHolder, type AddressLabelInfo, type LiquidityPoolData, type LpHolder, type TokenMetadata, type TokenLinks, type BuySellTaxes, type RequestOptions, type PaginationOptions, type PaginatedResponse, } from './types';
+export { isValidAddress, isValidEvmAddress, isValidSolanaAddress, isValidBitcoinAddress, isValidTonAddress, isValidSuiAddress, isValidStellarAddress, normalizeAddress, normalizeEvmAddress, isValidUrl, } from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,MAAM,EACX,aAAa,GACd,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EACL,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,oBAAoB,GACrB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,GACb,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,KAAK,EACL,kBAAkB,EAClB,qBAAqB,EACrB,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,SAAS,EACT,SAAS,EACT,aAAa,EACb,aAAa,EACb,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/types/resources/base.d.ts

@@ -0,0 +1,26 @@
+import { HttpClient } from '../http';
+import { Chain } from '../types';
+/**
+ * Base class for API resources
+ *
+ * Provides common functionality for chain resolution and address validation
+ * that is shared across all resource implementations.
+ */
+export declare abstract class BaseResource {
+    protected readonly httpClient: HttpClient;
+    protected readonly defaultChain?: Chain | undefined;
+    constructor(httpClient: HttpClient, defaultChain?: Chain | undefined);
+    /**
+     * Resolve the chain to use for a request
+     * @throws ValidationError if no chain is specified and no default is set
+     */
+    protected resolveChain(options?: {
+        chain?: Chain;
+    }): Chain;
+    /**
+     * Validate address format for the given chain
+     * @throws ValidationError if address format is invalid for the chain
+     */
+    protected validateAddress(address: string, chain: Chain): void;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/types/resources/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/resources/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,KAAK,EAAe,MAAM,UAAU,CAAC;AAG9C;;;;;GAKG;AACH,8BAAsB,YAAY;IAE9B,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU;IACzC,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK;gBADpB,UAAU,EAAE,UAAU,EACtB,YAAY,CAAC,EAAE,KAAK,YAAA;IAGzC;;;OAGG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,GAAG,KAAK;IAU1D;;;OAGG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;CAQ/D"}

package/dist/types/resources/index.d.ts

@@ -0,0 +1,2 @@
+export { BaseResource } from './base';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC"}