@cryptodetective/sdk 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,371 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# Crypto Detective Node.js / TypeScript SDK
+
+Official server-side Node.js and TypeScript SDK for the Crypto Detective Investigation API.
+
+
+
+
+
+
+## Overview
+
+The Crypto Detective SDK provides a typed server-side interface to the Crypto Detective REST API.
+
+It allows applications to submit blockchain addresses for investigation and receive the canonical Crypto Detective investigation response, including:
+
+- Final Risk Score
+- Risk level
+- Address validity
+- Classification
+- Hard-stop status
+- Final score source
+- Extended intelligence returned by the Crypto Detective API
+
+The SDK does not calculate or reconstruct Crypto Detective risk scores. The authoritative Final Risk Score is returned by the Crypto Detective API as `scan.score`.
+
+
+
+
+
+## Requirements
+
+- Node.js 18 or later
+- Active Crypto Detective API subscription
+- Crypto Detective API key
+
+
+
+
+
+## Installation
+
+Install the Crypto Detective SDK in your server-side Node.js application:
+
+```bash
+npm install @cryptodetective/sdk
+```
+
+The SDK requires Node.js 18 or later.
+
+After installation, import the client:
+
+```ts
+import { CryptoDetectiveClient } from "@cryptodetective/sdk";
+```
+
+For CommonJS applications:
+
+```js
+const {
+  CryptoDetectiveClient,
+  CryptoDetectiveError,
+} = require("@cryptodetective/sdk");
+```
+
+
+
+
+## Security
+
+The Crypto Detective API key is a server-side credential.
+
+Do not expose the API key in:
+
+- Browser JavaScript
+- Client-side React or Next.js components
+- Public repositories
+- Mobile application bundles
+- HTML source
+
+Store the API key in a secure server-side environment variable or secrets-management system.
+
+
+
+
+
+## Configuration
+
+Create the Crypto Detective client with your server-side API key:
+
+```ts
+import { CryptoDetectiveClient } from "@cryptodetective/sdk";
+
+const client = new CryptoDetectiveClient({
+  apiKey: process.env.CRYPTO_DETECTIVE_API_KEY!,
+});
+```
+
+The SDK connects to the production Crypto Detective API by default.
+
+For specialized environments, the API base URL can be overridden:
+
+```ts
+const client = new CryptoDetectiveClient({
+  apiKey: process.env.CRYPTO_DETECTIVE_API_KEY!,
+  baseUrl: "https://cryptodetective.app/api/v1",
+});
+```
+
+For normal production integrations, the default base URL should be used.
+
+Store the API key in a server-side environment variable or secrets-management system. Never send the API key to the browser.
+
+
+
+
+## Investigation Request
+
+Submit an investigation with `client.investigate()`:
+
+```ts
+const result = await client.investigate({
+  address: "0x000000000000000000000000000000000000dEaD",
+  chainSelected: "eth",
+  scanMode: "full",
+});
+```
+
+
+
+
+
+### Request Fields
+
+| Field | Required | Description |
+|---|---|---|
+| `address` | Yes | Blockchain address to investigate. |
+| `chainSelected` | Yes | Blockchain network to use for the investigation. |
+| `scanMode` | No | `"quick"` or `"full"`. Defaults to `"full"`. |
+| `assetSymbol` | No | Optional asset symbol. |
+| `calldata` | No | Optional transaction calldata for applicable investigations. |
+| `spender` | No | Optional spender address for applicable investigations. |
+
+
+
+
+
+
+
+
+### Supported Chains
+
+The SDK currently accepts:
+
+`auto`, `btc`, `eth`, `bsc`, `base`, `polygon`, `arbitrum`, `optimism`, `avalanche`, `tron`, `sol`, `ada`, `ltc`, `doge`, `xrp`, `bch`, `bnb`, `atom`
+
+Use the exact lowercase chain identifier shown above.
+
+
+
+
+## Investigation Response
+
+A successful investigation returns the canonical Crypto Detective API response:
+
+```ts
+const result = await client.investigate({
+  address: "0x000000000000000000000000000000000000dEaD",
+  chainSelected: "eth",
+  scanMode: "full",
+});
+
+console.log(result.scan.score);
+console.log(result.scan.risk_level);
+console.log(result.scan.hard_stop_triggered);
+console.log(result.scan.score_breakdown.final_score_source);
+```
+
+
+
+## Error Handling
+
+The SDK throws `CryptoDetectiveError` when the Crypto Detective API returns an error.
+
+```ts
+import {
+  CryptoDetectiveClient,
+  CryptoDetectiveError,
+} from "@cryptodetective/sdk";
+
+try {
+  const result = await client.investigate({
+    address: "0x...",
+    chainSelected: "eth",
+    scanMode: "full",
+  });
+
+  console.log(result.scan.score);
+} catch (error) {
+  if (error instanceof CryptoDetectiveError) {
+    console.error("HTTP Status:", error.status);
+    console.error("Error Code:", error.code);
+    console.error("Message:", error.message);
+  } else {
+    throw error;
+  }
+}
+```
+
+Applications should make programmatic decisions using the HTTP status and `error.code`. Do not depend on exact error-message wording.
+
+Common HTTP statuses include:
+
+| Status | Meaning |
+|---:|---|
+| `400` | Invalid request JSON or invalid idempotency key. |
+| `401` | Missing or invalid API authentication. |
+| `403` | API subscription or entitlement required. |
+| `405` | HTTP method not allowed. |
+| `409` | Idempotency conflict or request already in progress. |
+| `422` | Request validation failed. |
+| `429` | Rate limit or monthly quota reached. |
+| `500` | Investigation or accounting failure. |
+| `503` | Required API service or production dependency unavailable. |
+
+A failed API request should not be interpreted as a successful low-risk investigation. The integrating application determines the appropriate failure policy for its own workflow.
+
+
+
+
+## Idempotency
+
+Crypto Detective supports optional idempotency keys for investigation requests.
+
+Use an idempotency key when your application may retry the same investigation and you want to prevent duplicate processing:
+
+```ts
+const result = await client.investigate(
+  {
+    address: "0x000000000000000000000000000000000000dEaD",
+    chainSelected: "eth",
+    scanMode: "full",
+  },
+  {
+    idempotencyKey: "investigation-12345",
+  }
+);
+```
+
+Idempotency keys:
+
+- Are optional.
+- May contain a maximum of 128 characters.
+- May contain letters, numbers, `.`, `_`, `:`, and `-`.
+- Should identify one logical investigation request.
+
+Reusing the same idempotency key with the same request allows the API to return the completed result without performing the investigation again.
+
+Reusing the same idempotency key with different request data results in an idempotency conflict.
+
+If an investigation using the same key is still being processed, the API may return a conflict indicating that the request is already in progress.
+
+
+
+## Production Security and Integration Model
+
+The Crypto Detective SDK is designed for server-side use.
+
+A typical production integration follows this pattern:
+
+```text
+User / Browser / Application
+          ↓
+Customer Backend
+          ↓
+Crypto Detective SDK
+          ↓
+Crypto Detective REST API
+          ↓
+Canonical Investigation Response
+          ↓
+Customer Application Policy
+```
+
+The customer's backend should submit the public blockchain address and investigation parameters to Crypto Detective. The Crypto Detective API returns the investigation result, and the customer application determines how that intelligence is used within its own workflow.
+
+### Security Requirements
+
+- Keep Crypto Detective API keys on the server.
+- Never expose API keys in browser JavaScript or client-side application bundles.
+- Never commit API keys to source control.
+- Use environment variables or a secure secrets-management system.
+- Crypto Detective investigations require public blockchain information only.
+- Never send private keys, wallet seed phrases, recovery phrases, or signing credentials to Crypto Detective.
+- Treat API authentication credentials as secrets and rotate them if exposure is suspected.
+
+### Application Responsibility
+
+Crypto Detective provides investigation and risk intelligence. It does not control the integrating application's business rules.
+
+Applications may use Crypto Detective results to support workflows such as transaction review, risk warnings, compliance processes, fraud prevention, or other application-specific decisions.
+
+The authoritative investigation result comes from the Crypto Detective API. Applications should not recreate Crypto Detective scoring logic locally.
+
+
+
+
+
+
+
+
+### Core Response Fields
+
+| Field | Description |
+|---|---|
+| `scan.id` | Unique investigation identifier. |
+| `scan.address` | Address that was investigated. |
+| `scan.chain_selected` | Blockchain network used for the investigation. |
+| `scan.asset_symbol` | Asset symbol associated with the investigation. |
+| `scan.scan_type` | Investigation mode used. |
+| `scan.scanned_at` | Investigation timestamp. |
+| `scan.validity` | Address validity intelligence. |
+| `scan.classification` | Address classification intelligence. |
+| `scan.score` | Authoritative Crypto Detective Final Risk Score from 0–100. |
+| `scan.risk_level` | `low`, `caution`, `high`, or `critical`. |
+| `scan.hard_stop_triggered` | Indicates whether a Crypto Detective hard stop was triggered. |
+| `scan.hard_stop_code` | Hard-stop code when applicable. |
+| `scan.hard_stop_title` | Hard-stop title when applicable. |
+| `scan.hard_stop_message` | Hard-stop explanation when applicable. |
+| `scan.score_breakdown.final_score_source` | Identifies the source of the final score. |
+
+Crypto Detective API v1 may return additional intelligence fields. Applications should tolerate additive response fields rather than rejecting an otherwise valid response.
+
+
+
+
+
+
+### Risk Levels
+
+| Final Risk Score | Risk Level |
+|---:|---|
+| `0` to `<30` | `low` |
+| `30` to `<60` | `caution` |
+| `60` to `<80` | `high` |
+| `80` to `100` | `critical` |
+
+A `critical` result does not necessarily mean that a hard stop was triggered. Check `scan.hard_stop_triggered` when your application needs to distinguish a hard-stop result from another critical-risk result.
+
+
+
+
+
+
+## Basic Usage
+
+```ts
+import { CryptoDetectiveClient } from "@cryptodetective/sdk";
+
+const client = new CryptoDetectiveClient({
+  apiKey: process.env.CRYPTO_DETECTIVE_API_KEY!,
+});
+
+const result = await client.investigate({
+  address: "0x...",
+  chainSelected: "eth",
+  scanMode: "full",
+});
+
+console.log(result.scan.score);
+console.log(result.scan.risk_level);
+console.log(result.scan.hard_stop_triggered);

package/dist/client.d.ts

@@ -0,0 +1,23 @@
+import { InvestigationRequest, InvestigationResponse } from "./types";
+export interface CryptoDetectiveClientOptions {
+    apiKey: string;
+    /**
+     * Override only when necessary.
+     * Defaults to the production Crypto Detective API.
+     */
+    baseUrl?: string;
+}
+export interface InvestigationOptions {
+    /**
+     * Optional idempotency key.
+     * Maximum 128 characters.
+     */
+    idempotencyKey?: string;
+}
+export declare class CryptoDetectiveClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(options: CryptoDetectiveClientOptions);
+    investigate(request: InvestigationRequest, options?: InvestigationOptions): Promise<InvestigationResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAIjB,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,4BAA4B;IAa3C,WAAW,CACf,OAAO,EAAE,oBAAoB,EAC7B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,qBAAqB,CAAC;CAgElC"}

package/dist/client.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CryptoDetectiveClient = void 0;
+const errors_1 = require("./errors");
+class CryptoDetectiveClient {
+    apiKey;
+    baseUrl;
+    constructor(options) {
+        if (!options.apiKey || !options.apiKey.trim()) {
+            throw new Error("Crypto Detective API key is required.");
+        }
+        this.apiKey = options.apiKey.trim();
+        this.baseUrl = (options.baseUrl ??
+            "https://cryptodetective.app/api/v1").replace(/\/+$/, "");
+    }
+    async investigate(request, options = {}) {
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        };
+        if (options.idempotencyKey) {
+            headers["Idempotency-Key"] = options.idempotencyKey;
+        }
+        const response = await fetch(`${this.baseUrl}/investigations.php`, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({
+                address: request.address,
+                chain_selected: request.chainSelected,
+                scan_mode: request.scanMode ?? "full",
+                asset_symbol: request.assetSymbol ?? "",
+                calldata: request.calldata ?? "",
+                spender: request.spender ?? "",
+            }),
+        });
+        let body;
+        try {
+            body = await response.json();
+        }
+        catch {
+            throw new errors_1.CryptoDetectiveError(response.status, "INVALID_API_RESPONSE", "Crypto Detective returned an invalid JSON response.");
+        }
+        if (!response.ok) {
+            const errorBody = body;
+            if (errorBody &&
+                errorBody.success === false &&
+                errorBody.error &&
+                typeof errorBody.error.code === "string" &&
+                typeof errorBody.error.message === "string") {
+                throw errors_1.CryptoDetectiveError.fromApiResponse(response.status, errorBody);
+            }
+            throw new errors_1.CryptoDetectiveError(response.status, "API_REQUEST_FAILED", "Crypto Detective API request failed.");
+        }
+        return body;
+    }
+}
+exports.CryptoDetectiveClient = CryptoDetectiveClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAMA,qCAAgD;AAoBhD,MAAa,qBAAqB;IACf,MAAM,CAAS;IACf,OAAO,CAAS;IAEjC,YAAY,OAAqC;QAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAEpC,IAAI,CAAC,OAAO,GAAG,CACb,OAAO,CAAC,OAAO;YACf,oCAAoC,CACrC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,WAAW,CACf,OAA6B,EAC7B,UAAgC,EAAE;QAElC,MAAM,OAAO,GAA2B;YACtC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;YACtC,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,kBAAkB;SAC3B,CAAC;QAEF,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3B,OAAO,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;QACtD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,IAAI,CAAC,OAAO,qBAAqB,EACpC;YACE,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,cAAc,EAAE,OAAO,CAAC,aAAa;gBACrC,SAAS,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM;gBACrC,YAAY,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;gBACvC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;gBAChC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;aAC/B,CAAC;SACH,CACF,CAAC;QAEF,IAAI,IAAa,CAAC;QAElB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,6BAAoB,CAC5B,QAAQ,CAAC,MAAM,EACf,sBAAsB,EACtB,qDAAqD,CACtD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,IAAmC,CAAC;YAEtD,IACE,SAAS;gBACT,SAAS,CAAC,OAAO,KAAK,KAAK;gBAC3B,SAAS,CAAC,KAAK;gBACf,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;gBACxC,OAAO,SAAS,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ,EAC3C,CAAC;gBACD,MAAM,6BAAoB,CAAC,eAAe,CACxC,QAAQ,CAAC,MAAM,EACf,SAAS,CACV,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,6BAAoB,CAC5B,QAAQ,CAAC,MAAM,EACf,oBAAoB,EACpB,sCAAsC,CACvC,CAAC;QACJ,CAAC;QAED,OAAO,IAA6B,CAAC;IACvC,CAAC;CACF;AApFD,sDAoFC"}

package/dist/errors.d.ts

@@ -0,0 +1,9 @@
+import type { CryptoDetectiveApiErrorBody } from "./types";
+export declare class CryptoDetectiveError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly details?: Record<string, unknown>;
+    constructor(status: number, code: string, message: string, details?: Record<string, unknown>);
+    static fromApiResponse(status: number, body: CryptoDetectiveApiErrorBody): CryptoDetectiveError;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAE3D,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGhD,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYnC,MAAM,CAAC,eAAe,CACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,2BAA2B,GAChC,oBAAoB;CAUxB"}

package/dist/errors.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CryptoDetectiveError = void 0;
+class CryptoDetectiveError extends Error {
+    status;
+    code;
+    details;
+    constructor(status, code, message, details) {
+        super(message);
+        this.name = "CryptoDetectiveError";
+        this.status = status;
+        this.code = code;
+        this.details = details;
+        Object.setPrototypeOf(this, CryptoDetectiveError.prototype);
+    }
+    static fromApiResponse(status, body) {
+        const { code, message, ...details } = body.error;
+        return new CryptoDetectiveError(status, code, message, Object.keys(details).length > 0 ? details : undefined);
+    }
+}
+exports.CryptoDetectiveError = CryptoDetectiveError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAEA,MAAa,oBAAqB,SAAQ,KAAK;IAC7B,MAAM,CAAS;IACf,IAAI,CAAS;IACb,OAAO,CAA2B;IAElD,YACE,MAAc,EACd,IAAY,EACZ,OAAe,EACf,OAAiC;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,CAAC,eAAe,CACpB,MAAc,EACd,IAAiC;QAEjC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAEjD,OAAO,IAAI,oBAAoB,CAC7B,MAAM,EACN,IAAI,EACJ,OAAO,EACP,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CACtD,CAAC;IACJ,CAAC;CACF;AAlCD,oDAkCC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { CryptoDetectiveClient, } from "./client";
+export type { CryptoDetectiveClientOptions, InvestigationOptions, } from "./client";
+export { CryptoDetectiveError, } from "./errors";
+export type { CryptoDetectiveChain, CryptoDetectiveScanMode, CryptoDetectiveRiskLevel, InvestigationRequest, InvestigationValidity, InvestigationClassification, ScoreBreakdown, InvestigationScan, InvestigationResponse, CryptoDetectiveApiErrorBody, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,2BAA2B,EAC3B,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CryptoDetectiveError = exports.CryptoDetectiveClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "CryptoDetectiveClient", { enumerable: true, get: function () { return client_1.CryptoDetectiveClient; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "CryptoDetectiveError", { enumerable: true, get: function () { return errors_1.CryptoDetectiveError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAEkB;AADhB,+GAAA,qBAAqB,OAAA;AAQvB,mCAEkB;AADhB,8GAAA,oBAAoB,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,58 @@
+export type CryptoDetectiveChain = "auto" | "btc" | "eth" | "bsc" | "base" | "polygon" | "arbitrum" | "optimism" | "avalanche" | "tron" | "sol" | "ada" | "ltc" | "doge" | "xrp" | "bch" | "bnb" | "atom";
+export type CryptoDetectiveScanMode = "quick" | "full";
+export type CryptoDetectiveRiskLevel = "low" | "caution" | "high" | "critical";
+export interface InvestigationRequest {
+    address: string;
+    chainSelected: CryptoDetectiveChain;
+    scanMode?: CryptoDetectiveScanMode;
+    assetSymbol?: string;
+    calldata?: string;
+    spender?: string;
+}
+export interface InvestigationValidity {
+    [key: string]: unknown;
+}
+export interface InvestigationClassification {
+    [key: string]: unknown;
+}
+export interface ScoreBreakdown {
+    final_score_source: string;
+    [key: string]: unknown;
+}
+export interface InvestigationScan {
+    id: string | number;
+    address: string;
+    chain_selected: string;
+    asset_symbol: string;
+    scan_type: string;
+    scanned_at: string;
+    validity: InvestigationValidity;
+    classification: InvestigationClassification;
+    score: number;
+    risk_level: CryptoDetectiveRiskLevel;
+    hard_stop_triggered: boolean;
+    hard_stop_code: string | null;
+    hard_stop_title: string | null;
+    hard_stop_message: string | null;
+    score_breakdown: ScoreBreakdown;
+    [key: string]: unknown;
+}
+export interface InvestigationResponse {
+    success: true;
+    status: "completed";
+    scan: InvestigationScan;
+    api: {
+        version: "v1";
+        environment: string;
+        key_name: string;
+    };
+}
+export interface CryptoDetectiveApiErrorBody {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+        [key: string]: unknown;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN,KAAK,GACL,KAAK,GACL,KAAK,GACL,MAAM,GACN,SAAS,GACT,UAAU,GACV,UAAU,GACV,WAAW,GACX,MAAM,GACN,KAAK,GACL,KAAK,GACL,KAAK,GACL,MAAM,GACN,KAAK,GACL,KAAK,GACL,KAAK,GACL,MAAM,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEvD,MAAM,MAAM,wBAAwB,GAChC,KAAK,GACL,SAAS,GACT,MAAM,GACN,UAAU,CAAC;AAEf,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IAEnB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,cAAc,EAAE,2BAA2B,CAAC;IAE5C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,wBAAwB,CAAC;IAErC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC,eAAe,EAAE,cAAc,CAAC;IAMhC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IAEpB,IAAI,EAAE,iBAAiB,CAAC;IAExB,GAAG,EAAE;QACH,OAAO,EAAE,IAAI,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,KAAK,CAAC;IAEf,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,30 @@
-{
-  "name": "@cryptodetective/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+{
+  "name": "@cryptodetective/sdk",
+  "version": "1.0.0",
+  "description": "Official Node.js and TypeScript SDK for the Crypto Detective Investigation API.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "crypto-detective",
+    "blockchain",
+    "risk-intelligence",
+    "wallet-intelligence",
+    "blockchain-investigation"
+  ],
+  "license": "UNLICENSED",
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.0"
+  }
 }