@webacy-xyz/sdk-threat 1.0.1

package/dist/esm/resources/addresses.js

@@ -0,0 +1,158 @@
+import { BaseResource } from '@webacy-xyz/sdk-core';
+/**
+ * Resource for address risk analysis
+ *
+ * Provides comprehensive security analysis for blockchain addresses including:
+ * - Overall risk scoring
+ * - Risk categorization and tagging
+ * - Sanctions screening
+ * - Address poisoning detection
+ * - Fund flow analysis
+ *
+ * @example
+ * ```typescript
+ * // Analyze an address
+ * const risk = await client.addresses.analyze('0x...', { chain: Chain.ETH });
+ *
+ * // Check sanctions
+ * const sanctioned = await client.addresses.checkSanctioned('0x...', { chain: Chain.ETH });
+ *
+ * // With default chain configured, chain can be omitted
+ * const client = new ThreatClient({ apiKey: '...', defaultChain: Chain.ETH });
+ * const risk = await client.addresses.analyze('0x...'); // Uses ETH
+ * ```
+ */
+export class AddressesResource extends BaseResource {
+    /**
+     * Analyze an address for security risks
+     *
+     * Returns comprehensive risk analysis including:
+     * - Overall risk score (0-100)
+     * - Risk tags and categories
+     * - Detailed analysis data (optional)
+     * - Deployer risk for contracts (optional)
+     *
+     * @param address - Address to analyze
+     * @param options - Analysis options (chain is optional if defaultChain is set)
+     * @returns Address risk analysis result
+     *
+     * @example
+     * ```typescript
+     * // Basic analysis
+     * const risk = await client.addresses.analyze('0x742d35Cc...', {
+     *   chain: Chain.ETH,
+     * });
+     * console.log(`Risk score: ${risk.overallRisk}`);
+     *
+     * // With default chain, options can be omitted
+     * const risk = await client.addresses.analyze('0x742d35Cc...');
+     *
+     * // With specific modules
+     * const risk = await client.addresses.analyze('0x...', {
+     *   chain: Chain.ETH,
+     *   modules: [RiskModule.SANCTIONS_COMPLIANCE, RiskModule.FUND_FLOW_SCREENING],
+     * });
+     *
+     * // With detailed response and deployer risk
+     * const risk = await client.addresses.analyze('0x...', {
+     *   chain: Chain.ETH,
+     *   detailed: true,
+     *   deployerRisk: true,
+     * });
+     * ```
+     */
+    async analyze(address, options = {}) {
+        const chain = this.resolveChain(options);
+        this.validateAddress(address, chain);
+        const queryParams = new URLSearchParams();
+        queryParams.append('chain', chain);
+        if (options.modules && options.modules.length > 0) {
+            for (const module of options.modules) {
+                queryParams.append('modules', module);
+            }
+        }
+        if (options.detailed !== undefined) {
+            queryParams.append('detailed', String(options.detailed));
+        }
+        if (options.deployerRisk !== undefined) {
+            queryParams.append('deployer_risk', String(options.deployerRisk));
+        }
+        const response = await this.httpClient.get(`/addresses/${encodeURIComponent(address)}?${queryParams.toString()}`, {
+            timeout: options.timeout,
+            signal: options.signal,
+        });
+        return response.data;
+    }
+    /**
+     * Check if an address is sanctioned
+     *
+     * Screens the address against known sanctions lists including OFAC.
+     *
+     * @param address - Address to check
+     * @param options - Request options (chain is optional if defaultChain is set)
+     * @returns Sanctions check result
+     *
+     * @example
+     * ```typescript
+     * const result = await client.addresses.checkSanctioned('0x...', {
+     *   chain: Chain.ETH,
+     * });
+     *
+     * // With default chain configured
+     * const result = await client.addresses.checkSanctioned('0x...');
+     *
+     * if (result.is_sanctioned) {
+     *   console.error('Address is sanctioned!');
+     *   console.log('Details:', result.sanction_details);
+     * }
+     * ```
+     */
+    async checkSanctioned(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(`/addresses/sanctioned/${encodeURIComponent(address)}?${queryParams.toString()}`, {
+            timeout: options.timeout,
+            signal: options.signal,
+        });
+        return response.data;
+    }
+    /**
+     * Check for address poisoning attacks
+     *
+     * Detects if an address has been targeted by address poisoning
+     * (dust attack) attempts.
+     *
+     * @param address - Address to check
+     * @param options - Request options (chain is optional if defaultChain is set)
+     * @returns Poisoning detection result
+     *
+     * @example
+     * ```typescript
+     * const result = await client.addresses.checkPoisoning('0x...', {
+     *   chain: Chain.ETH,
+     * });
+     *
+     * // With default chain configured
+     * const result = await client.addresses.checkPoisoning('0x...');
+     *
+     * if (result.is_poisoned) {
+     *   console.warn('Address poisoning detected!');
+     *   console.log('Similar addresses:', result.poisoning_details?.similar_addresses);
+     * }
+     * ```
+     */
+    async checkPoisoning(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(`/addresses/${encodeURIComponent(address)}/poisoning?${queryParams.toString()}`, {
+            timeout: options.timeout,
+            signal: options.signal,
+        });
+        return response.data;
+    }
+}
+//# sourceMappingURL=addresses.js.map

package/dist/esm/resources/addresses.js.map

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

package/dist/esm/resources/contracts.js

@@ -0,0 +1,183 @@
+import { BaseResource } from '@webacy-xyz/sdk-core';
+/**
+ * Resource for smart contract security analysis
+ *
+ * Provides comprehensive contract analysis including:
+ * - Static and dynamic code analysis
+ * - Vulnerability detection
+ * - Source code verification
+ * - Tax/fee detection
+ * - Deployer risk analysis
+ *
+ * @example
+ * ```typescript
+ * // Analyze a contract
+ * const risk = await client.contracts.analyze('0x...', { chain: Chain.ETH });
+ *
+ * // Get source code
+ * const source = await client.contracts.getSourceCode('0x...', { chain: Chain.ETH });
+ *
+ * // With default chain configured, chain can be omitted
+ * const client = new ThreatClient({ apiKey: '...', defaultChain: Chain.ETH });
+ * const risk = await client.contracts.analyze('0x...'); // Uses ETH
+ * ```
+ */
+export class ContractsResource extends BaseResource {
+    /**
+     * Analyze a smart contract for security risks
+     *
+     * Returns comprehensive analysis including:
+     * - Risk score and categorization
+     * - Vulnerability detection
+     * - Source code analysis (if verified)
+     * - Similar contracts
+     * - Deployer risk (optional)
+     *
+     * @param address - Contract address
+     * @param options - Analysis options (chain is optional if defaultChain is set)
+     * @returns Contract risk analysis result
+     *
+     * @example
+     * ```typescript
+     * const result = await client.contracts.analyze('0xContract...', {
+     *   chain: Chain.ETH,
+     * });
+     *
+     * // With default chain, options can be omitted
+     * const result = await client.contracts.analyze('0xContract...');
+     *
+     * console.log(`Risk score: ${result.score}`);
+     * console.log(`Tags: ${result.tags.map(t => t.name).join(', ')}`);
+     *
+     * // Check for vulnerabilities
+     * if (result.source_code_analysis && 'vulnerabilities' in result.source_code_analysis) {
+     *   for (const vuln of result.source_code_analysis.vulnerabilities) {
+     *     console.warn(`${vuln.severity}: ${vuln.title}`);
+     *   }
+     * }
+     * ```
+     */
+    async analyze(address, options = {}) {
+        const chain = this.resolveChain(options);
+        this.validateAddress(address, chain);
+        const queryParams = new URLSearchParams();
+        queryParams.append('chain', chain);
+        if (options.deployerRisk !== undefined) {
+            queryParams.append('deployer_risk', String(options.deployerRisk));
+        }
+        const response = await this.httpClient.get(`/contracts/${encodeURIComponent(address)}?${queryParams.toString()}`, {
+            timeout: options.timeout,
+            signal: options.signal,
+        });
+        return response.data;
+    }
+    /**
+     * Get contract source code
+     *
+     * Returns source code and metadata for verified contracts.
+     *
+     * @param address - Contract address
+     * @param options - Request options (chain is optional if defaultChain is set)
+     * @returns Contract source code and metadata
+     *
+     * @example
+     * ```typescript
+     * const source = await client.contracts.getSourceCode('0x...', {
+     *   chain: Chain.ETH,
+     * });
+     *
+     * // With default chain configured
+     * const source = await client.contracts.getSourceCode('0x...');
+     *
+     * if (source.is_verified) {
+     *   console.log(`Contract: ${source.contract_name}`);
+     *   console.log(`Compiler: ${source.compiler_version}`);
+     * } else {
+     *   console.log('Contract source not verified');
+     * }
+     * ```
+     */
+    async getSourceCode(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(`/contracts/${encodeURIComponent(address)}/source-code?${queryParams.toString()}`, {
+            timeout: options.timeout,
+            signal: options.signal,
+        });
+        return response.data;
+    }
+    /**
+     * Get token buy/sell taxes
+     *
+     * Analyzes token contracts for buy and sell taxes.
+     *
+     * @param address - Token contract address
+     * @param options - Request options (chain is optional if defaultChain is set)
+     * @returns Tax information
+     *
+     * @example
+     * ```typescript
+     * const taxes = await client.contracts.getTaxes('0x...', {
+     *   chain: Chain.ETH,
+     * });
+     *
+     * // With default chain configured
+     * const taxes = await client.contracts.getTaxes('0x...');
+     *
+     * if (taxes.buyTaxPercentage !== null || taxes.sellTaxPercentage !== null) {
+     *   console.log(`Buy tax: ${taxes.buyTaxPercentage}%`);
+     *   console.log(`Sell tax: ${taxes.sellTaxPercentage}%`);
+     * }
+     * ```
+     */
+    async getTaxes(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(`/contracts/taxes/${encodeURIComponent(address)}?${queryParams.toString()}`, {
+            timeout: options.timeout,
+            signal: options.signal,
+        });
+        return response.data;
+    }
+    /**
+     * Analyze Solidity source code
+     *
+     * Analyzes raw Solidity source code for vulnerabilities
+     * without requiring deployment.
+     *
+     * @param request - Analysis request with source code
+     * @returns Analysis results
+     *
+     * @example
+     * ```typescript
+     * const result = await client.contracts.analyzeSolidity({
+     *   source_code: `
+     *     pragma solidity ^0.8.0;
+     *     contract MyToken {
+     *       // ...
+     *     }
+     *   `,
+     *   compiler_version: '0.8.19',
+     * });
+     *
+     * if (result.success && result.results) {
+     *   console.log(`Security score: ${result.results.security_score}`);
+     *   for (const vuln of result.results.vulnerabilities) {
+     *     console.warn(`${vuln.severity}: ${vuln.title}`);
+     *   }
+     * }
+     * ```
+     */
+    async analyzeSolidity(request, options) {
+        const response = await this.httpClient.post('/contracts/solidity-detector', request, {
+            timeout: options?.timeout,
+            signal: options?.signal,
+        });
+        return response.data;
+    }
+}
+//# sourceMappingURL=contracts.js.map

package/dist/esm/resources/contracts.js.map

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

package/dist/esm/resources/index.js

@@ -0,0 +1,8 @@
+export { AddressesResource } from './addresses.js';
+export { ContractsResource } from './contracts.js';
+export { UrlResource } from './url.js';
+export { WalletsResource } from './wallets.js';
+export { LedgerResource } from './ledger.js';
+export { AccountTraceResource } from './account-trace.js';
+export { UsageResource } from './usage.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/esm/resources/ledger.js

@@ -0,0 +1,119 @@
+/**
+ * Resource for hardware wallet transaction scanning
+ *
+ * Provides security analysis for transactions before signing on
+ * hardware wallets (Ledger devices).
+ *
+ * @example
+ * ```typescript
+ * // Scan a transaction before signing
+ * const result = await client.ledger.scanTransaction('ethereum', {
+ *   tx: { from: '0x...', raw: '0x...' },
+ *   chain: 1,
+ * });
+ *
+ * if (!result.is_safe) {
+ *   console.error('Transaction may be risky!');
+ * }
+ * ```
+ */
+export class LedgerResource {
+    httpClient;
+    constructor(httpClient) {
+        this.httpClient = httpClient;
+    }
+    /**
+     * Scan a transaction before signing
+     *
+     * Analyzes a transaction for security risks before signing
+     * on a hardware wallet.
+     *
+     * @param family - Ledger device family (ethereum, solana, bitcoin)
+     * @param request - Transaction scan request
+     * @param options - Request options
+     * @returns Security analysis result
+     *
+     * @example
+     * ```typescript
+     * const result = await client.ledger.scanTransaction('ethereum', {
+     *   tx: {
+     *     from: '0xYourWallet...',
+     *     raw: '0xEncodedTransaction...',
+     *   },
+     *   chain: 1, // Ethereum mainnet
+     * });
+     *
+     * if (!result.is_safe) {
+     *   console.error(`Risk level: ${result.risk_level}`);
+     *   for (const risk of result.risks) {
+     *     console.warn(`${risk.level}: ${risk.description}`);
+     *   }
+     * }
+     *
+     * // Check decoded data
+     * if (result.decoded?.function_name) {
+     *   console.log(`Function: ${result.decoded.function_name}`);
+     * }
+     * ```
+     */
+    async scanTransaction(family, request, options) {
+        const response = await this.httpClient.post(`/ledger/${family}/scan/tx`, request, {
+            timeout: options?.timeout,
+            signal: options?.signal,
+        });
+        return response.data;
+    }
+    /**
+     * Scan EIP-712 typed data before signing
+     *
+     * Analyzes EIP-712 structured data for security risks
+     * before signing on a hardware wallet.
+     *
+     * @param family - Ledger device family
+     * @param request - EIP-712 scan request
+     * @param options - Request options
+     * @returns Security analysis result
+     *
+     * @example
+     * ```typescript
+     * const result = await client.ledger.scanEip712('ethereum', {
+     *   signer: '0xYourWallet...',
+     *   typedData: {
+     *     domain: {
+     *       name: 'MyDApp',
+     *       version: '1',
+     *       chainId: 1,
+     *       verifyingContract: '0x...',
+     *     },
+     *     message: {
+     *       // Message content
+     *     },
+     *     primaryType: 'Order',
+     *     types: {
+     *       EIP712Domain: [
+     *         { name: 'name', type: 'string' },
+     *         // ...
+     *       ],
+     *       Order: [
+     *         { name: 'maker', type: 'address' },
+     *         // ...
+     *       ],
+     *     },
+     *   },
+     *   chain: 1,
+     * });
+     *
+     * if (!result.is_safe) {
+     *   console.error('EIP-712 data may be risky!');
+     * }
+     * ```
+     */
+    async scanEip712(family, request, options) {
+        const response = await this.httpClient.post(`/ledger/${family}/scan/eip-712`, request, {
+            timeout: options?.timeout,
+            signal: options?.signal,
+        });
+        return response.data;
+    }
+}
+//# sourceMappingURL=ledger.js.map

package/dist/esm/resources/ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.js","sourceRoot":"","sources":["../../../src/resources/ledger.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,UAAsB;QAAtB,eAAU,GAAV,UAAU,CAAY;IAAG,CAAC;IAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,KAAK,CAAC,eAAe,CACnB,MAAoB,EACpB,OAA0B,EAC1B,OAA2B;QAE3B,MAAM,QAAQ,GAAqC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAC3E,WAAW,MAAM,UAAU,EAC3B,OAAO,EACP;YACE,OAAO,EAAE,OAAO,EAAE,OAAO;YACzB,MAAM,EAAE,OAAO,EAAE,MAAM;SACxB,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACH,KAAK,CAAC,UAAU,CACd,MAAoB,EACpB,OAA4B,EAC5B,OAA2B;QAE3B,MAAM,QAAQ,GAAqC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAC3E,WAAW,MAAM,eAAe,EAChC,OAAO,EACP;YACE,OAAO,EAAE,OAAO,EAAE,OAAO;YACzB,MAAM,EAAE,OAAO,EAAE,MAAM;SACxB,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF"}

package/dist/esm/resources/url.js

@@ -0,0 +1,88 @@
+import { ValidationError, isValidUrl } from '@webacy-xyz/sdk-core';
+/**
+ * Resource for URL safety analysis
+ *
+ * Provides URL risk assessment to identify phishing sites,
+ * malicious domains, and other web-based threats.
+ *
+ * @example
+ * ```typescript
+ * const result = await client.url.check('https://suspicious-site.com');
+ * if (result.prediction === 'malicious') {
+ *   console.warn('URL is malicious!');
+ * }
+ * ```
+ */
+export class UrlResource {
+    httpClient;
+    constructor(httpClient) {
+        this.httpClient = httpClient;
+    }
+    /**
+     * Check if a URL is safe
+     *
+     * Analyzes a URL for phishing, malware, and other threats.
+     *
+     * @param url - URL to check
+     * @param options - Request options
+     * @returns URL safety analysis result
+     *
+     * @example
+     * ```typescript
+     * const result = await client.url.check('https://example.com');
+     *
+     * if (result.prediction === 'malicious') {
+     *   console.error('URL is potentially dangerous!');
+     *   console.log('Details:', result.details);
+     * } else if (result.prediction === 'benign') {
+     *   console.log('URL appears safe');
+     * }
+     *
+     * // Check blacklist/whitelist status
+     * if (result.blacklist === 'true') {
+     *   console.error('URL is blacklisted');
+     * }
+     * if (result.whitelist === 'true') {
+     *   console.log('URL is whitelisted');
+     * }
+     * ```
+     */
+    async check(url, options) {
+        if (!isValidUrl(url)) {
+            throw new ValidationError(`Invalid URL: "${url}". Please provide a valid HTTP or HTTPS URL.`);
+        }
+        const response = await this.httpClient.post('/url', { url }, {
+            timeout: options?.timeout,
+            signal: options?.signal,
+        });
+        return response.data;
+    }
+    /**
+     * Add a URL to the database
+     *
+     * Report a URL to be analyzed and added to the threat database.
+     *
+     * @param url - URL to add
+     * @param options - Request options
+     * @returns Addition result
+     *
+     * @example
+     * ```typescript
+     * const result = await client.url.add('https://phishing-site.com');
+     * if (result.success) {
+     *   console.log('URL reported successfully');
+     * }
+     * ```
+     */
+    async add(url, options) {
+        if (!isValidUrl(url)) {
+            throw new ValidationError(`Invalid URL: "${url}". Please provide a valid HTTP or HTTPS URL.`);
+        }
+        const response = await this.httpClient.post('/url/add', { url }, {
+            timeout: options?.timeout,
+            signal: options?.signal,
+        });
+        return response.data;
+    }
+}
+//# sourceMappingURL=url.js.map

package/dist/esm/resources/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../../src/resources/url.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAG7F;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,UAAsB;QAAtB,eAAU,GAAV,UAAU,CAAY;IAAG,CAAC;IAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,OAAyB;QAChD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,eAAe,CAAC,iBAAiB,GAAG,8CAA8C,CAAC,CAAC;QAChG,CAAC;QAED,MAAM,QAAQ,GAAkC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACxE,MAAM,EACN,EAAE,GAAG,EAAE,EACP;YACE,OAAO,EAAE,OAAO,EAAE,OAAO;YACzB,MAAM,EAAE,OAAO,EAAE,MAAM;SACxB,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,OAAyB;QAC9C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,eAAe,CAAC,iBAAiB,GAAG,8CAA8C,CAAC,CAAC;QAChG,CAAC;QAED,MAAM,QAAQ,GAAiC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACvE,UAAU,EACV,EAAE,GAAG,EAAE,EACP;YACE,OAAO,EAAE,OAAO,EAAE,OAAO;YACzB,MAAM,EAAE,OAAO,EAAE,MAAM;SACxB,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF"}