@rlajous/sdk-core 1.0.0

package/dist/esm/types/common.js

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

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

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

package/dist/esm/types/index.js

@@ -0,0 +1,4 @@
+export { Chain, ChainCompatibility, getChainCompatibility, isEvmChain, CHAIN_IDS, CHAIN_NAMES, } from './chain';
+export { RiskModule } from './modules';
+export { RiskScore, RiskLevel, TypeOfAddress, TokenStandard } from './common';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,kBAAkB,EAClB,qBAAqB,EACrB,UAAU,EACV,SAAS,EACT,WAAW,GACZ,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAoBvC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/esm/types/modules.js

@@ -0,0 +1,61 @@
+/**
+ * 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.
+ */
+export 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 || (RiskModule = {}));
+//# sourceMappingURL=modules.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"modules.js","sourceRoot":"","sources":["../../../src/types/modules.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAN,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,KAAV,UAAU,QA4DrB"}

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

@@ -0,0 +1,113 @@
+import { Chain, isEvmChain } from '../types';
+/**
+ * Validate an Ethereum address format
+ */
+export function isValidEvmAddress(address) {
+    return /^0x[a-fA-F0-9]{40}$/.test(address);
+}
+/**
+ * Validate a Solana address format (base58)
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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)
+ */
+export 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
+ */
+export function isValidAddress(address, chain) {
+    if (!address || typeof address !== 'string') {
+        return false;
+    }
+    if (isEvmChain(chain)) {
+        return isValidEvmAddress(address);
+    }
+    switch (chain) {
+        case Chain.SOL:
+            return isValidSolanaAddress(address);
+        case Chain.BTC:
+            return isValidBitcoinAddress(address);
+        case Chain.TON:
+            return isValidTonAddress(address);
+        case Chain.SUI:
+            return isValidSuiAddress(address);
+        case Chain.STELLAR:
+            return isValidStellarAddress(address);
+        default:
+            // Unknown chain, allow any non-empty string
+            return address.length > 0;
+    }
+}
+/**
+ * Normalize an EVM address to checksum format
+ */
+export 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
+ */
+export function normalizeAddress(address, chain) {
+    if (isEvmChain(chain)) {
+        return normalizeEvmAddress(address);
+    }
+    // For non-EVM chains, return as-is
+    return address;
+}
+//# sourceMappingURL=address-validation.js.map

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

@@ -0,0 +1,2 @@
+export { isValidAddress, isValidEvmAddress, isValidSolanaAddress, isValidBitcoinAddress, isValidTonAddress, isValidSuiAddress, isValidStellarAddress, normalizeAddress, normalizeEvmAddress, } from './address-validation';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

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

@@ -0,0 +1,94 @@
+import { WebacyClientConfig } from './config';
+import { HttpClient, HttpResponse, RequestInterceptor, ResponseInterceptor, ErrorInterceptor } from './http';
+import { Chain } from './types';
+/**
+ * Base client class for Webacy SDK
+ *
+ * Provides shared functionality for all Webacy client implementations
+ * including HTTP client setup, authentication, and interceptors.
+ */
+export declare abstract class BaseClient {
+    protected readonly httpClient: HttpClient;
+    protected readonly config: Required<Pick<WebacyClientConfig, 'baseUrl' | 'apiVersion' | 'timeout'>> & WebacyClientConfig;
+    /**
+     * Default chain to use when chain is not specified in API calls
+     */
+    readonly defaultChain?: Chain;
+    constructor(config: WebacyClientConfig);
+    /**
+     * 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: RequestInterceptor): void;
+    /**
+     * 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: ResponseInterceptor): void;
+    /**
+     * 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: ErrorInterceptor): void;
+    /**
+     * Make a GET request
+     */
+    protected get<T>(path: string, options?: RequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Make a POST request
+     */
+    protected post<T>(path: string, body?: unknown, options?: RequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Make a PUT request
+     */
+    protected put<T>(path: string, body?: unknown, options?: RequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Make a DELETE request
+     */
+    protected delete<T>(path: string, options?: RequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Build query string from parameters
+     */
+    protected buildQueryString(params: Record<string, unknown>): string;
+}
+/**
+ * Options for protected request methods
+ */
+interface RequestOptions {
+    timeout?: number;
+    signal?: AbortSignal;
+}
+export {};
+//# sourceMappingURL=client-base.d.ts.map

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;IAOrF;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAoBpE;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 '@rlajous/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"}