@rlajous/sdk-threat 1.0.0

package/dist/cjs/resources/addresses.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddressesResource = void 0;
+const sdk_core_1 = require("@rlajous/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
+ * ```
+ */
+class AddressesResource {
+    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 address format for the given chain
+     * @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} address: "${address}". Please provide a valid address format for the ${chainName} blockchain.`);
+        }
+    }
+    /**
+     * 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;
+    }
+}
+exports.AddressesResource = AddressesResource;
+//# sourceMappingURL=addresses.js.map

package/dist/cjs/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/cjs/resources/contracts.js

@@ -0,0 +1,216 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContractsResource = void 0;
+const sdk_core_1 = require("@rlajous/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
+ * ```
+ */
+class ContractsResource {
+    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;
+    }
+    /**
+     * 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);
+        // Validate contract address format before making API call
+        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} contract address: "${address}". Please provide a valid address format for the ${chainName} blockchain.`);
+        }
+        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);
+        // Validate contract address format before making API call
+        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} contract address: "${address}". Please provide a valid address format for the ${chainName} blockchain.`);
+        }
+        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);
+        // Validate token contract address format before making API call
+        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} token contract address: "${address}". Please provide a valid address format for the ${chainName} blockchain.`);
+        }
+        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;
+    }
+}
+exports.ContractsResource = ContractsResource;
+//# sourceMappingURL=contracts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/resources/contracts.ts"],"names":[],"mappings":";;;AAAA,gDAO2B;AAY3B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAa,iBAAiB;IAET;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,KAAK,CAAC,OAAO,CACX,OAAe,EACf,UAAmC,EAAE;QAErC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAEzC,0DAA0D;QAC1D,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,uBAAuB,OAAO,oDAAoD,SAAS,cAAc,CAC9H,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,YAAY,KAAK,SAAS,EAAE,CAAC;YACvC,WAAW,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,QAAQ,GAAuC,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAC5E,cAAc,kBAAkB,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,QAAQ,EAAE,EAAE,EACrE;YACE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,KAAK,CAAC,aAAa,CACjB,OAAe,EACf,UAA6B,EAAE;QAE/B,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAEzC,0DAA0D;QAC1D,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,uBAAuB,OAAO,oDAAoD,SAAS,cAAc,CAC9H,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QAC1C,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAEnC,MAAM,QAAQ,GAA6C,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAClF,cAAc,kBAAkB,CAAC,OAAO,CAAC,gBAAgB,WAAW,CAAC,QAAQ,EAAE,EAAE,EACjF;YACE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,UAAsB,EAAE;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAEzC,gEAAgE;QAChE,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,6BAA6B,OAAO,oDAAoD,SAAS,cAAc,CACpI,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QAC1C,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAEnC,MAAM,QAAQ,GAAmC,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CACxE,oBAAoB,kBAAkB,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,QAAQ,EAAE,EAAE,EAC3E;YACE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,KAAK,CAAC,eAAe,CACnB,OAAgC,EAChC,OAAoD;QAEpD,MAAM,QAAQ,GAA2C,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACjF,8BAA8B,EAC9B,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;AAzOD,8CAyOC"}

package/dist/cjs/resources/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageResource = exports.AccountTraceResource = exports.LedgerResource = exports.WalletsResource = exports.UrlResource = exports.ContractsResource = exports.AddressesResource = void 0;
+var addresses_1 = require("./addresses");
+Object.defineProperty(exports, "AddressesResource", { enumerable: true, get: function () { return addresses_1.AddressesResource; } });
+var contracts_1 = require("./contracts");
+Object.defineProperty(exports, "ContractsResource", { enumerable: true, get: function () { return contracts_1.ContractsResource; } });
+var url_1 = require("./url");
+Object.defineProperty(exports, "UrlResource", { enumerable: true, get: function () { return url_1.UrlResource; } });
+var wallets_1 = require("./wallets");
+Object.defineProperty(exports, "WalletsResource", { enumerable: true, get: function () { return wallets_1.WalletsResource; } });
+var ledger_1 = require("./ledger");
+Object.defineProperty(exports, "LedgerResource", { enumerable: true, get: function () { return ledger_1.LedgerResource; } });
+var account_trace_1 = require("./account-trace");
+Object.defineProperty(exports, "AccountTraceResource", { enumerable: true, get: function () { return account_trace_1.AccountTraceResource; } });
+var usage_1 = require("./usage");
+Object.defineProperty(exports, "UsageResource", { enumerable: true, get: function () { return usage_1.UsageResource; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/index.ts"],"names":[],"mappings":";;;AAAA,yCAAgD;AAAvC,8GAAA,iBAAiB,OAAA;AAC1B,yCAAgD;AAAvC,8GAAA,iBAAiB,OAAA;AAC1B,6BAAoC;AAA3B,kGAAA,WAAW,OAAA;AACpB,qCAA4C;AAAnC,0GAAA,eAAe,OAAA;AACxB,mCAA0C;AAAjC,wGAAA,cAAc,OAAA;AACvB,iDAAuD;AAA9C,qHAAA,oBAAoB,OAAA;AAC7B,iCAAwC;AAA/B,sGAAA,aAAa,OAAA"}

package/dist/cjs/resources/ledger.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LedgerResource = void 0;
+/**
+ * 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!');
+ * }
+ * ```
+ */
+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;
+    }
+}
+exports.LedgerResource = LedgerResource;
+//# sourceMappingURL=ledger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.js","sourceRoot":"","sources":["../../../src/resources/ledger.ts"],"names":[],"mappings":";;;AASA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,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;AAnHD,wCAmHC"}

package/dist/cjs/resources/url.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UrlResource = void 0;
+/**
+ * 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!');
+ * }
+ * ```
+ */
+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) {
+        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) {
+        const response = await this.httpClient.post('/url/add', { url }, {
+            timeout: options?.timeout,
+            signal: options?.signal,
+        });
+        return response.data;
+    }
+}
+exports.UrlResource = UrlResource;
+//# sourceMappingURL=url.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../../src/resources/url.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;GAaG;AACH,MAAa,WAAW;IACO;IAA7B,YAA6B,UAAsB;QAAtB,eAAU,GAAV,UAAU,CAAY;IAAG,CAAC;IAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,OAAyB;QAChD,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,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;AA1ED,kCA0EC"}