@rlajous/sdk-core 1.0.0

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,147 @@
+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)
+     */
+    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;
+    /**
+     * 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,7 @@
+export { WebacyClientConfig, DEFAULT_CONFIG, buildBaseUrl, type DebugMode, type Logger, defaultLogger, } from './config';
+export { BaseClient } from './client-base';
+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, } 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,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,GACpB,MAAM,SAAS,CAAC"}

package/dist/types/types/chain.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Supported blockchain networks
+ */
+export declare enum Chain {
+    /** Ethereum Mainnet */
+    ETH = "eth",
+    /** Ethereum Sepolia Testnet */
+    SEP = "sep",
+    /** Arbitrum One */
+    ARB = "arb",
+    /** Polygon (MATIC) */
+    POL = "pol",
+    /** Solana */
+    SOL = "sol",
+    /** Optimism */
+    OPT = "opt",
+    /** Base */
+    BASE = "base",
+    /** BNB Smart Chain */
+    BSC = "bsc",
+    /** TON (The Open Network) */
+    TON = "ton",
+    /** Sei */
+    SEI = "sei",
+    /** Bitcoin */
+    BTC = "btc",
+    /** Sui */
+    SUI = "sui",
+    /** Stellar */
+    STELLAR = "stellar"
+}
+/**
+ * Chain compatibility groups for feature detection
+ */
+export declare enum ChainCompatibility {
+    EVM = "EVM",
+    SOLANA = "SOLANA",
+    TON = "TON",
+    BTC = "BTC",
+    SEI = "SEI",
+    SUI = "SUI",
+    STELLAR = "STELLAR"
+}
+/**
+ * Get the compatibility group for a chain
+ */
+export declare function getChainCompatibility(chain: Chain): ChainCompatibility;
+/**
+ * Check if a chain is EVM-compatible
+ */
+export declare function isEvmChain(chain: Chain): boolean;
+/**
+ * Chain ID mapping for EVM chains
+ */
+export declare const CHAIN_IDS: Partial<Record<Chain, number>>;
+/**
+ * Human-readable chain names
+ */
+export declare const CHAIN_NAMES: Record<Chain, string>;
+//# sourceMappingURL=chain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../../src/types/chain.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,KAAK;IACf,uBAAuB;IACvB,GAAG,QAAQ;IACX,+BAA+B;IAC/B,GAAG,QAAQ;IACX,mBAAmB;IACnB,GAAG,QAAQ;IACX,sBAAsB;IACtB,GAAG,QAAQ;IACX,aAAa;IACb,GAAG,QAAQ;IACX,eAAe;IACf,GAAG,QAAQ;IACX,WAAW;IACX,IAAI,SAAS;IACb,sBAAsB;IACtB,GAAG,QAAQ;IACX,6BAA6B;IAC7B,GAAG,QAAQ;IACX,UAAU;IACV,GAAG,QAAQ;IACX,cAAc;IACd,GAAG,QAAQ;IACX,UAAU;IACV,GAAG,QAAQ;IACX,cAAc;IACd,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB,CAuBtE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEhD;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAQpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAc7C,CAAC"}

package/dist/types/types/common.d.ts

@@ -0,0 +1,251 @@
+import { Chain } from './chain';
+import { RiskModule } from './modules';
+/**
+ * Risk tag describing a specific security concern
+ */
+export interface RiskTag {
+    /** Human-readable name */
+    name: string;
+    /** Unique identifier key */
+    key: string;
+    /** Category type */
+    type: string;
+    /** Detailed description */
+    description: string;
+    /** Severity level (0-100, higher = more severe) */
+    severity?: number;
+}
+/**
+ * Informational tag (non-risk metadata)
+ */
+export interface InformationalTag {
+    name: string;
+    key: string;
+    type: string;
+    description: string;
+    /** Optional count for display (e.g., "2 active ads") */
+    count?: number;
+}
+/**
+ * Risk category grouping related tags
+ */
+export interface RiskCategory {
+    name: string;
+    key: string;
+    gradedDescription?: {
+        high: string;
+        medium: string;
+        low: string;
+    };
+    description?: string;
+    tags?: Record<string, boolean>;
+}
+/**
+ * Risk score classification
+ */
+export declare enum RiskScore {
+    HIGH = "High Risk",
+    MEDIUM = "Medium Risk",
+    LOW = "Low Risk",
+    TRUSTED = "Trusted",
+    UNKNOWN = "Unknown"
+}
+/**
+ * Risk level enum
+ */
+export declare enum RiskLevel {
+    Low = "low",
+    Medium = "medium",
+    High = "high",
+    Suspicious = "suspicious"
+}
+/**
+ * Consolidated risk analysis result
+ */
+export interface ConsolidatedRiskResult {
+    /** Numeric risk score (0-100) */
+    score: number;
+    /** List of identified risk tags */
+    tags: RiskTag[];
+    /** Categorized risk information */
+    categories: Record<string, RiskCategory>;
+    /** Human-readable risk classification */
+    riskScore?: RiskScore;
+    /** Additional analysis data */
+    analysis?: unknown;
+}
+/**
+ * Token ownership distribution data
+ */
+export interface OwnershipDistribution {
+    /** Total supply of the token */
+    totalSupply?: number | string;
+    /** Percentage held by top 10 holders (0-100) */
+    percentageHeldByTop10?: number;
+    /** Percentage held by top 5 holders (0-100) */
+    percentageHeldByTop5?: number;
+    /** Percentage held by top 20 holders (0-100) */
+    percentageHeldByTop20?: number;
+    /** Total number of unique holders */
+    totalHoldersCount?: number;
+    /** Top holders with balances */
+    topHolders?: TopHolder[];
+}
+/**
+ * Top holder information
+ */
+export interface TopHolder {
+    /** Account address */
+    accountAddress?: string;
+    /** Human-readable alias */
+    alias?: string;
+    /** Owner address */
+    ownerAddress: string;
+    /** Token amount held */
+    amount: number | string;
+    /** Percentage of total supply */
+    percentage?: number;
+    /** Address label information */
+    label_info?: AddressLabelInfo;
+}
+/**
+ * Address label information
+ */
+export interface AddressLabelInfo {
+    /** Label name */
+    name?: string;
+    /** Label category */
+    category?: string;
+    /** Label subcategory */
+    subcategory?: string;
+}
+/**
+ * Liquidity pool data
+ */
+export interface LiquidityPoolData {
+    /** DEX name */
+    dexName?: string;
+    /** Pool address */
+    address?: string;
+    /** LP token mint address */
+    lpMint?: string;
+    /** Trading pair address */
+    pairAddress?: string;
+    /** Total liquidity value */
+    totalLiquidity?: number;
+    /** Type of liquidity */
+    liquidityType?: string;
+    /** Percentage of locked liquidity */
+    lockedLiquidityPercent?: number;
+    /** LP token holders */
+    lpHolders?: LpHolder[];
+}
+/**
+ * LP token holder
+ */
+export interface LpHolder {
+    address?: string;
+    balance?: number;
+    percent?: number;
+    isLocked?: boolean;
+    lockedUntil?: Date;
+    isContract?: boolean;
+}
+/**
+ * Token metadata
+ */
+export interface TokenMetadata {
+    /** Token name */
+    name?: string;
+    /** Token symbol */
+    symbol?: string;
+    /** Token logo URL */
+    logo?: string;
+    /** Token decimals */
+    decimals?: number;
+    /** Token description */
+    description?: string;
+    /** Social links */
+    links?: TokenLinks;
+}
+/**
+ * Token social and website links
+ */
+export interface TokenLinks {
+    website?: string;
+    twitter?: string;
+    telegram?: string;
+    discord?: string;
+    github?: string;
+}
+/**
+ * Buy/sell tax information
+ */
+export interface BuySellTaxes {
+    has_buy_tax?: boolean;
+    has_sell_tax?: boolean;
+    buy_tax_percentage?: number;
+    sell_tax_percentage?: number;
+}
+/**
+ * Address type classification
+ */
+export declare enum TypeOfAddress {
+    EOA = "EOA",
+    CONTRACT = "CONTRACT",
+    TOKEN = "TOKEN",
+    CONTRACT_WALLET = "CONTRACT_WALLET",
+    MULTISIG = "MULTISIG"
+}
+/**
+ * Token standard
+ */
+export declare enum TokenStandard {
+    ERC20 = "ERC20",
+    ERC721 = "ERC721",
+    ERC1155 = "ERC1155",
+    SPL = "SPL",
+    JETTON = "JETTON",
+    STELLAR_ASSET = "STELLAR_ASSET",
+    SUI_COIN = "SUI_COIN"
+}
+/**
+ * Common request options
+ */
+export interface RequestOptions {
+    /** Target blockchain */
+    chain: Chain;
+    /** Specific risk modules to analyze */
+    modules?: RiskModule[];
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Abort signal for request cancellation */
+    signal?: AbortSignal;
+}
+/**
+ * Pagination options
+ */
+export interface PaginationOptions {
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Items per page */
+    limit?: number;
+    /** Cursor for cursor-based pagination */
+    cursor?: string;
+}
+/**
+ * Paginated response wrapper
+ */
+export interface PaginatedResponse<T> {
+    /** Data items */
+    data: T[];
+    /** Pagination metadata */
+    pagination: {
+        page?: number;
+        limit?: number;
+        total?: number;
+        hasMore?: boolean;
+        nextCursor?: string;
+    };
+}
+//# sourceMappingURL=common.d.ts.map

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

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

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

@@ -0,0 +1,5 @@
+export { Chain, ChainCompatibility, getChainCompatibility, isEvmChain, CHAIN_IDS, CHAIN_NAMES, } from './chain';
+export { RiskModule } from './modules';
+export type { RiskTag, InformationalTag, RiskCategory, ConsolidatedRiskResult, OwnershipDistribution, TopHolder, AddressLabelInfo, LiquidityPoolData, LpHolder, TokenMetadata, TokenLinks, BuySellTaxes, RequestOptions, PaginationOptions, PaginatedResponse, } from './common';
+export { RiskScore, RiskLevel, TypeOfAddress, TokenStandard } from './common';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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;AAEvC,YAAY,EACV,OAAO,EACP,gBAAgB,EAChB,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,aAAa,EACb,UAAU,EACV,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}