@rlajous/sdk-threat 1.0.0

package/dist/cjs/resources/usage.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageResource = void 0;
+/**
+ * Resource for API usage and quota management
+ *
+ * Provides access to API usage statistics, current quota,
+ * and available plans.
+ *
+ * @example
+ * ```typescript
+ * const current = await client.usage.getCurrent();
+ * console.log(`Used: ${current.calls_used}/${current.calls_limit}`);
+ * ```
+ */
+class UsageResource {
+    httpClient;
+    constructor(httpClient) {
+        this.httpClient = httpClient;
+    }
+    /**
+     * Get historical usage data
+     *
+     * Returns API usage statistics for a time period.
+     *
+     * @param options - Request options with date range
+     * @returns Historical usage data
+     *
+     * @example
+     * ```typescript
+     * const usage = await client.usage.getUsage({
+     *   start_date: '2024-01-01',
+     *   end_date: '2024-01-31',
+     * });
+     *
+     * console.log(`Total calls: ${usage.total_calls}`);
+     * console.log(`Period calls: ${usage.period_calls}`);
+     *
+     * // Usage by endpoint
+     * if (usage.by_endpoint) {
+     *   for (const [endpoint, count] of Object.entries(usage.by_endpoint)) {
+     *     console.log(`${endpoint}: ${count} calls`);
+     *   }
+     * }
+     * ```
+     */
+    async getUsage(options) {
+        const queryParams = new URLSearchParams();
+        if (options?.start_date) {
+            queryParams.append('start_date', options.start_date);
+        }
+        if (options?.end_date) {
+            queryParams.append('end_date', options.end_date);
+        }
+        const queryString = queryParams.toString();
+        const path = queryString ? `/usage?${queryString}` : '/usage';
+        const response = await this.httpClient.get(path, {
+            timeout: options?.timeout,
+            signal: options?.signal,
+        });
+        return response.data;
+    }
+    /**
+     * Get current usage status
+     *
+     * Returns current period usage and remaining quota.
+     *
+     * @param options - Request options
+     * @returns Current usage status
+     *
+     * @example
+     * ```typescript
+     * const current = await client.usage.getCurrent();
+     *
+     * console.log(`Plan: ${current.plan}`);
+     * console.log(`Used: ${current.calls_used}/${current.calls_limit}`);
+     * console.log(`Remaining: ${current.calls_remaining}`);
+     * console.log(`Usage: ${current.usage_percentage}%`);
+     * console.log(`Resets: ${current.reset_date}`);
+     *
+     * if (current.usage_percentage > 80) {
+     *   console.warn('Approaching usage limit!');
+     * }
+     * ```
+     */
+    async getCurrent(options) {
+        const response = await this.httpClient.get('/usage/current', {
+            timeout: options?.timeout,
+            signal: options?.signal,
+        });
+        return response.data;
+    }
+    /**
+     * Get available usage plans
+     *
+     * Returns list of available plans and their features.
+     *
+     * @param options - Request options
+     * @returns Available plans
+     *
+     * @example
+     * ```typescript
+     * const plans = await client.usage.getPlans();
+     *
+     * console.log(`Current plan: ${plans.current_plan}`);
+     *
+     * for (const plan of plans.plans) {
+     *   console.log(`${plan.name}:`);
+     *   console.log(`  Monthly limit: ${plan.monthly_limit}`);
+     *   console.log(`  Rate limit: ${plan.rate_limit}/sec`);
+     *   console.log(`  Features: ${plan.features.join(', ')}`);
+     * }
+     * ```
+     */
+    async getPlans(options) {
+        const response = await this.httpClient.get('/usage/usagePlans', {
+            timeout: options?.timeout,
+            signal: options?.signal,
+        });
+        return response.data;
+    }
+}
+exports.UsageResource = UsageResource;
+//# sourceMappingURL=usage.js.map

package/dist/cjs/resources/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../../src/resources/usage.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;GAWG;AACH,MAAa,aAAa;IACK;IAA7B,YAA6B,UAAsB;QAAtB,eAAU,GAAV,UAAU,CAAY;IAAG,CAAC;IAEvD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAsB;QACnC,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QAE1C,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;YACxB,WAAW,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;YACtB,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,UAAU,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE9D,MAAM,QAAQ,GAA4B,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE;YACxE,OAAO,EAAE,OAAO,EAAE,OAAO;YACzB,MAAM,EAAE,OAAO,EAAE,MAAM;SACxB,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,UAAU,CAAC,OAGhB;QACC,MAAM,QAAQ,GAAuC,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAC5E,gBAAgB,EAChB;YACE,OAAO,EAAE,OAAO,EAAE,OAAO;YACzB,MAAM,EAAE,OAAO,EAAE,MAAM;SACxB,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,QAAQ,CAAC,OAGd;QACC,MAAM,QAAQ,GAAqC,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAC1E,mBAAmB,EACnB;YACE,OAAO,EAAE,OAAO,EAAE,OAAO;YACzB,MAAM,EAAE,OAAO,EAAE,MAAM;SACxB,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF;AA5HD,sCA4HC"}

package/dist/cjs/resources/wallets.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletsResource = void 0;
+const sdk_core_1 = require("@rlajous/sdk-core");
+/**
+ * Resource for wallet transaction and approval analysis
+ *
+ * Provides security analysis for wallet activity including:
+ * - Transaction risk analysis
+ * - Token approval monitoring
+ * - Counterparty risk assessment
+ *
+ * @example
+ * ```typescript
+ * // Get transaction risks
+ * const txs = await client.wallets.getTransactions('0x...', { chain: Chain.ETH });
+ *
+ * // Get token approvals
+ * const approvals = await client.wallets.getApprovals('0x...', { chain: Chain.ETH });
+ *
+ * // With default chain configured, chain can be omitted
+ * const client = new ThreatClient({ apiKey: '...', defaultChain: Chain.ETH });
+ * const txs = await client.wallets.getTransactions('0x...'); // Uses ETH
+ * ```
+ */
+class WalletsResource {
+    httpClient;
+    defaultChain;
+    constructor(httpClient, defaultChain) {
+        this.httpClient = httpClient;
+        this.defaultChain = defaultChain;
+    }
+    /**
+     * Resolve the chain to use for a request
+     * @throws ValidationError if no chain is specified and no default is set
+     */
+    resolveChain(options) {
+        const chain = options?.chain ?? this.defaultChain;
+        if (!chain) {
+            throw new sdk_core_1.ValidationError('Chain is required. Either specify chain in options or set defaultChain in client configuration.');
+        }
+        return chain;
+    }
+    /**
+     * Validate wallet address format
+     * @throws ValidationError if address format is invalid for the chain
+     */
+    validateAddress(address, chain) {
+        if (!(0, sdk_core_1.isValidAddress)(address, chain)) {
+            const chainName = sdk_core_1.CHAIN_NAMES[chain] || chain;
+            throw new sdk_core_1.ValidationError(`Invalid ${chainName} wallet address: "${address}". Please provide a valid address format for the ${chainName} blockchain.`);
+        }
+    }
+    /**
+     * Get wallet transaction risk analysis
+     *
+     * Analyzes recent transactions for security risks including:
+     * - Interactions with risky addresses
+     * - Sanctioned counterparties
+     * - Suspicious patterns
+     *
+     * @param address - Wallet address
+     * @param options - Request options (chain is optional if defaultChain is set)
+     * @returns Transaction risk analysis
+     *
+     * @example
+     * ```typescript
+     * const result = await client.wallets.getTransactions('0x...', {
+     *   chain: Chain.ETH,
+     *   limit: 50,
+     * });
+     *
+     * // With default chain configured
+     * const result = await client.wallets.getTransactions('0x...');
+     *
+     * console.log(`Total issues: ${result.count}`);
+     * console.log(`High risk: ${result.high}`);
+     * console.log(`Overall risk: ${result.overallRisk}`);
+     *
+     * for (const issue of result.issues) {
+     *   if (issue.transaction.sanctioned_address) {
+     *     console.error('Transaction with sanctioned address!');
+     *   }
+     * }
+     * ```
+     */
+    async getTransactions(address, options = {}) {
+        const chain = this.resolveChain(options);
+        this.validateAddress(address, chain);
+        const queryParams = new URLSearchParams();
+        queryParams.append('chain', chain);
+        if (options.limit !== undefined) {
+            queryParams.append('limit', String(options.limit));
+        }
+        if (options.offset !== undefined) {
+            queryParams.append('offset', String(options.offset));
+        }
+        const response = await this.httpClient.get(`/wallets/${encodeURIComponent(address)}/transactions?${queryParams.toString()}`, {
+            timeout: options.timeout,
+            signal: options.signal,
+        });
+        return response.data;
+    }
+    /**
+     * Get wallet token approvals
+     *
+     * Lists all active token approvals for a wallet,
+     * with risk assessment for each spender.
+     *
+     * @param address - Wallet address
+     * @param options - Request options (chain is optional if defaultChain is set)
+     * @returns Token approvals with risk data
+     *
+     * @example
+     * ```typescript
+     * const result = await client.wallets.getApprovals('0x...', {
+     *   chain: Chain.ETH,
+     * });
+     *
+     * // With default chain configured
+     * const result = await client.wallets.getApprovals('0x...');
+     *
+     * console.log(`Total approvals: ${result.count}`);
+     * console.log(`High risk approvals: ${result.high_risk_count}`);
+     *
+     * for (const approval of result.approvals) {
+     *   if (approval.is_unlimited) {
+     *     console.warn(`Unlimited approval to ${approval.spender}`);
+     *   }
+     *   if (approval.spender_risk && approval.spender_risk > 50) {
+     *     console.error(`High risk spender: ${approval.spender}`);
+     *   }
+     * }
+     * ```
+     */
+    async getApprovals(address, options = {}) {
+        const chain = this.resolveChain(options);
+        this.validateAddress(address, chain);
+        const queryParams = new URLSearchParams();
+        queryParams.append('chain', chain);
+        const response = await this.httpClient.get(`/wallets/${encodeURIComponent(address)}/approvals?${queryParams.toString()}`, {
+            timeout: options.timeout,
+            signal: options.signal,
+        });
+        return response.data;
+    }
+}
+exports.WalletsResource = WalletsResource;
+//# sourceMappingURL=wallets.js.map

package/dist/cjs/resources/wallets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallets.js","sourceRoot":"","sources":["../../../src/resources/wallets.ts"],"names":[],"mappings":";;;AAAA,gDAO2B;AAQ3B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAa,eAAe;IAEP;IACA;IAFnB,YACmB,UAAsB,EACtB,YAAoB;QADpB,eAAU,GAAV,UAAU,CAAY;QACtB,iBAAY,GAAZ,YAAY,CAAQ;IACpC,CAAC;IAEJ;;;OAGG;IACK,YAAY,CAAC,OAA2B;QAC9C,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC;QAClD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,0BAAe,CACvB,iGAAiG,CAClG,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACK,eAAe,CAAC,OAAe,EAAE,KAAY;QACnD,IAAI,CAAC,IAAA,yBAAc,EAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,sBAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;YAC9C,MAAM,IAAI,0BAAe,CACvB,WAAW,SAAS,qBAAqB,OAAO,oDAAoD,SAAS,cAAc,CAC5H,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,KAAK,CAAC,eAAe,CACnB,OAAe,EACf,UAAqC,EAAE;QAEvC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAErC,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QAC1C,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAEnC,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,QAAQ,GAA6C,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAClF,YAAY,kBAAkB,CAAC,OAAO,CAAC,iBAAiB,WAAW,CAAC,QAAQ,EAAE,EAAE,EAChF;YACE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,KAAK,CAAC,YAAY,CAChB,OAAe,EACf,UAAkC,EAAE;QAEpC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAErC,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QAC1C,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAEnC,MAAM,QAAQ,GAA0C,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAC/E,YAAY,kBAAkB,CAAC,OAAO,CAAC,cAAc,WAAW,CAAC,QAAQ,EAAE,EAAE,EAC7E;YACE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF;AAlJD,0CAkJC"}

package/dist/cjs/types/account-trace.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=account-trace.js.map

package/dist/cjs/types/account-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-trace.js","sourceRoot":"","sources":["../../../src/types/account-trace.ts"],"names":[],"mappings":""}

package/dist/cjs/types/address.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=address.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../src/types/address.ts"],"names":[],"mappings":""}

package/dist/cjs/types/contract.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=contract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../src/types/contract.ts"],"names":[],"mappings":""}

package/dist/cjs/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# 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":""}

package/dist/cjs/types/ledger.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ledger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.js","sourceRoot":"","sources":["../../../src/types/ledger.ts"],"names":[],"mappings":""}

package/dist/cjs/types/url.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=url.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../../src/types/url.ts"],"names":[],"mappings":""}

package/dist/cjs/types/usage.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=usage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../../src/types/usage.ts"],"names":[],"mappings":""}

package/dist/cjs/types/wallet.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=wallet.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../../src/types/wallet.ts"],"names":[],"mappings":""}

package/dist/esm/client.js

@@ -0,0 +1,161 @@
+import { BaseClient, } from '@rlajous/sdk-core';
+import { AddressesResource } from './resources/addresses';
+import { ContractsResource } from './resources/contracts';
+import { UrlResource } from './resources/url';
+import { WalletsResource } from './resources/wallets';
+import { LedgerResource } from './resources/ledger';
+import { AccountTraceResource } from './resources/account-trace';
+import { UsageResource } from './resources/usage';
+/**
+ * Webacy Threat SDK Client
+ *
+ * Provides access to threat and risk analysis including address risk,
+ * sanctions screening, contract security, URL safety, and more.
+ *
+ * @example
+ * ```typescript
+ * import { ThreatClient, Chain, RiskModule } from '@rlajous/sdk-threat';
+ *
+ * const client = new ThreatClient({
+ *   apiKey: process.env.WEBACY_API_KEY!,
+ * });
+ *
+ * // Address risk analysis
+ * const risk = await client.addresses.analyze('0x...', { chain: 'eth' });
+ *
+ * // Sanctions screening
+ * const sanctioned = await client.addresses.checkSanctioned('0x...', { chain: 'eth' });
+ *
+ * // URL safety check
+ * const urlRisk = await client.url.check('https://suspicious-site.com');
+ * ```
+ */
+export class ThreatClient extends BaseClient {
+    /**
+     * Addresses resource
+     *
+     * Comprehensive security analysis for blockchain addresses including
+     * risk scoring, sanctions screening, and address poisoning detection.
+     */
+    addresses;
+    /**
+     * Contracts resource
+     *
+     * Smart contract security analysis including vulnerability detection,
+     * source code analysis, and tax detection.
+     */
+    contracts;
+    /**
+     * URL resource
+     *
+     * URL safety analysis to identify phishing sites and malicious domains.
+     */
+    url;
+    /**
+     * Wallets resource
+     *
+     * Wallet activity analysis including transaction risks and token approvals.
+     */
+    wallets;
+    /**
+     * Ledger resource
+     *
+     * Hardware wallet transaction scanning for secure signing.
+     */
+    ledger;
+    /**
+     * Account trace resource
+     *
+     * Fund flow tracing to identify connections to risky entities.
+     */
+    accountTrace;
+    /**
+     * Usage resource
+     *
+     * API usage statistics and quota management.
+     */
+    usage;
+    /**
+     * Create a new ThreatClient instance
+     *
+     * @param config - Client configuration
+     * @throws AuthenticationError if API key is not provided
+     *
+     * @example
+     * ```typescript
+     * // Basic setup
+     * const client = new ThreatClient({
+     *   apiKey: 'your-api-key',
+     * });
+     *
+     * // With default chain (omit chain in API calls)
+     * const client = new ThreatClient({
+     *   apiKey: 'your-api-key',
+     *   defaultChain: Chain.ETH,
+     * });
+     *
+     * // With custom configuration
+     * const client = new ThreatClient({
+     *   apiKey: 'your-api-key',
+     *   timeout: 60000,
+     *   retry: {
+     *     maxRetries: 5,
+     *   },
+     * });
+     * ```
+     */
+    constructor(config) {
+        super(config);
+        // Initialize resources with the HTTP client and default chain
+        this.addresses = new AddressesResource(this.httpClient, this.defaultChain);
+        this.contracts = new ContractsResource(this.httpClient, this.defaultChain);
+        this.url = new UrlResource(this.httpClient);
+        this.wallets = new WalletsResource(this.httpClient, this.defaultChain);
+        this.ledger = new LedgerResource(this.httpClient);
+        this.accountTrace = new AccountTraceResource(this.httpClient, this.defaultChain);
+        this.usage = new UsageResource(this.httpClient);
+    }
+    /**
+     * Add a request interceptor
+     *
+     * @example
+     * ```typescript
+     * client.addRequestInterceptor((url, config) => {
+     *   console.log(`Making request to ${url}`);
+     *   return config;
+     * });
+     * ```
+     */
+    addRequestInterceptor(interceptor) {
+        super.addRequestInterceptor(interceptor);
+    }
+    /**
+     * Add a response interceptor
+     *
+     * @example
+     * ```typescript
+     * client.addResponseInterceptor((response) => {
+     *   console.log(`Received ${response.status} response`);
+     *   return response;
+     * });
+     * ```
+     */
+    addResponseInterceptor(interceptor) {
+        super.addResponseInterceptor(interceptor);
+    }
+    /**
+     * Add an error interceptor
+     *
+     * @example
+     * ```typescript
+     * client.addErrorInterceptor((error) => {
+     *   console.error(`Request failed: ${error.message}`);
+     *   return error;
+     * });
+     * ```
+     */
+    addErrorInterceptor(interceptor) {
+        super.addErrorInterceptor(interceptor);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAKX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,YAAa,SAAQ,UAAU;IAC1C;;;;;OAKG;IACa,SAAS,CAAoB;IAE7C;;;;;OAKG;IACa,SAAS,CAAoB;IAE7C;;;;OAIG;IACa,GAAG,CAAc;IAEjC;;;;OAIG;IACa,OAAO,CAAkB;IAEzC;;;;OAIG;IACa,MAAM,CAAiB;IAEvC;;;;OAIG;IACa,YAAY,CAAuB;IAEnD;;;;OAIG;IACa,KAAK,CAAgB;IAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,YAAY,MAA0B;QACpC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,8DAA8D;QAC9D,IAAI,CAAC,SAAS,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3E,IAAI,CAAC,SAAS,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3E,IAAI,CAAC,GAAG,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACvE,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,YAAY,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACjF,IAAI,CAAC,KAAK,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;;;;;OAUG;IACM,qBAAqB,CAAC,WAA+B;QAC5D,KAAK,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;OAUG;IACM,sBAAsB,CAAC,WAAgC;QAC9D,KAAK,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;;OAUG;IACM,mBAAmB,CAAC,WAA6B;QACxD,KAAK,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+// Client
+export { ThreatClient } from './client';
+// Resources
+export { AddressesResource, ContractsResource, UrlResource, WalletsResource, LedgerResource, AccountTraceResource, UsageResource, } from './resources';
+// Re-export commonly used types from core
+export { Chain, ChainCompatibility, isEvmChain, CHAIN_NAMES, RiskModule, RiskScore, RiskLevel, TypeOfAddress, TokenStandard, WebacyError, AuthenticationError, RateLimitError, ValidationError, NotFoundError, NetworkError, } from '@rlajous/sdk-core';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,YAAY;AACZ,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,aAAa,GACd,MAAM,aAAa,CAAC;AAiErB,0CAA0C;AAC1C,OAAO,EACL,KAAK,EACL,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACT,SAAS,EACT,aAAa,EACb,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,GAMb,MAAM,mBAAmB,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/dist/esm/resources/account-trace.js

@@ -0,0 +1,92 @@
+import { ValidationError, isValidAddress, CHAIN_NAMES, } from '@rlajous/sdk-core';
+/**
+ * Resource for account fund flow tracing
+ *
+ * Traces fund flows to and from addresses to identify
+ * connections to risky entities.
+ *
+ * @example
+ * ```typescript
+ * const trace = await client.accountTrace.trace('0x...', { chain: Chain.ETH });
+ * console.log(`Sanctioned connections: ${trace.summary.sanctioned_connections}`);
+ *
+ * // With default chain configured, chain can be omitted
+ * const client = new ThreatClient({ apiKey: '...', defaultChain: Chain.ETH });
+ * const trace = await client.accountTrace.trace('0x...'); // Uses ETH
+ * ```
+ */
+export class AccountTraceResource {
+    httpClient;
+    defaultChain;
+    constructor(httpClient, defaultChain) {
+        this.httpClient = httpClient;
+        this.defaultChain = defaultChain;
+    }
+    /**
+     * Resolve the chain to use for a request
+     * @throws ValidationError if no chain is specified and no default is set
+     */
+    resolveChain(options) {
+        const chain = options?.chain ?? this.defaultChain;
+        if (!chain) {
+            throw new ValidationError('Chain is required. Either specify chain in options or set defaultChain in client configuration.');
+        }
+        return chain;
+    }
+    /**
+     * Trace account fund flows
+     *
+     * Analyzes connections to identify:
+     * - Direct counterparties
+     * - Sanctioned address connections
+     * - Mixer usage
+     * - High-risk entities
+     *
+     * @param address - Address to trace
+     * @param options - Trace options (chain is optional if defaultChain is set)
+     * @returns Fund flow trace result
+     *
+     * @example
+     * ```typescript
+     * const trace = await client.accountTrace.trace('0x...', {
+     *   chain: Chain.ETH,
+     *   depth: 2, // Trace 2 hops
+     * });
+     *
+     * // With default chain configured
+     * const trace = await client.accountTrace.trace('0x...');
+     *
+     * console.log(`Total connections: ${trace.summary.total_connections}`);
+     * console.log(`High risk: ${trace.summary.high_risk_connections}`);
+     * console.log(`Sanctioned: ${trace.summary.sanctioned_connections}`);
+     * console.log(`Mixers: ${trace.summary.mixer_connections}`);
+     *
+     * // Check individual connections
+     * for (const conn of trace.connections) {
+     *   if (conn.risk_flags?.length) {
+     *     console.warn(`Risky connection: ${conn.address}`);
+     *     console.warn(`Flags: ${conn.risk_flags.join(', ')}`);
+     *   }
+     * }
+     * ```
+     */
+    async trace(address, options = {}) {
+        const chain = this.resolveChain(options);
+        // Validate address format before making API call
+        if (!isValidAddress(address, chain)) {
+            const chainName = CHAIN_NAMES[chain] || chain;
+            throw new ValidationError(`Invalid ${chainName} address: "${address}". Please provide a valid address format for the ${chainName} blockchain.`);
+        }
+        const queryParams = new URLSearchParams();
+        queryParams.append('chain', chain);
+        if (options.depth !== undefined) {
+            queryParams.append('depth', String(options.depth));
+        }
+        const response = await this.httpClient.get(`/account-trace/${encodeURIComponent(address)}?${queryParams.toString()}`, {
+            timeout: options.timeout,
+            signal: options.signal,
+        });
+        return response.data;
+    }
+}
+//# sourceMappingURL=account-trace.js.map

package/dist/esm/resources/account-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-trace.js","sourceRoot":"","sources":["../../../src/resources/account-trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,eAAe,EACf,cAAc,EACd,WAAW,GAEZ,MAAM,mBAAmB,CAAC;AAG3B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,oBAAoB;IAEZ;IACA;IAFnB,YACmB,UAAsB,EACtB,YAAoB;QADpB,eAAU,GAAV,UAAU,CAAY;QACtB,iBAAY,GAAZ,YAAY,CAAQ;IACpC,CAAC;IAEJ;;;OAGG;IACK,YAAY,CAAC,OAA2B;QAC9C,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC;QAClD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,eAAe,CACvB,iGAAiG,CAClG,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,KAAK,CAAC,KAAK,CAAC,OAAe,EAAE,UAA+B,EAAE;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAEzC,iDAAiD;QACjD,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;YAC9C,MAAM,IAAI,eAAe,CACvB,WAAW,SAAS,cAAc,OAAO,oDAAoD,SAAS,cAAc,CACrH,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QAC1C,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAEnC,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,QAAQ,GAAuC,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAC5E,kBAAkB,kBAAkB,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,QAAQ,EAAE,EAAE,EACzE;YACE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF"}