@threatledger/sdk 0.1.0

package/README.md

@@ -0,0 +1,46 @@
+# @threatledger/sdk
+
+Official JavaScript/TypeScript SDK for the [ThreatLedger](https://threatledger.net) Threat Intelligence API.
+
+## Install
+
+```bash
+npm install @threatledger/sdk
+```
+
+## Usage
+
+```typescript
+import { ThreatLedger } from '@threatledger/sdk';
+
+const tl = new ThreatLedger({ apiKey: 'your-api-key' });
+
+// Check address risk
+const result = await tl.checkAddress('0x098b716b8aaf21512996dc57eb0615e2383e2f96');
+console.log(result.risk_level); // "CRITICAL"
+
+// List incidents
+const incidents = await tl.listIncidents({ severity: 'critical' });
+
+// Check credits
+const credits = await tl.getCredits();
+```
+
+## API Reference
+
+| Method | Description |
+|--------|-------------|
+| `checkAddress(address)` | Check address against threat database |
+| `listIncidents(params?)` | List security incidents |
+| `listActors()` | List known threat actors |
+| `listPatterns()` | List attack patterns |
+| `getCredits()` | Check API credit balance |
+
+## Links
+
+- [API Docs](https://threatledger.net/docs/)
+- [Full Documentation](https://merkleclaw.com/developers/)
+
+## License
+
+MIT — [ZeroVector Limited](https://zerovector.hk)

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ThreatLedger JavaScript SDK
+ */
+export interface ThreatLedgerConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+export interface AddressCheckResult {
+    address: string;
+    found: boolean;
+    risk_score: number;
+    risk_level: string;
+    entry?: {
+        chain: string;
+        tier: string;
+        entity: string;
+        reason: string;
+    };
+}
+export interface Incident {
+    id: string;
+    title: string;
+    date: string;
+    chain: string;
+    severity: string;
+    loss_usd: number;
+    protocol: string;
+    description: string;
+}
+export declare class ThreatLedger {
+    private apiKey;
+    private baseUrl;
+    constructor(config: ThreatLedgerConfig);
+    private request;
+    checkAddress(address: string): Promise<AddressCheckResult>;
+    listIncidents(params?: {
+        chain?: string;
+        severity?: string;
+        page?: number;
+    }): Promise<Incident[]>;
+    listActors(): Promise<unknown[]>;
+    listPatterns(): Promise<unknown[]>;
+    getCredits(): Promise<{
+        tier: string;
+        remaining: number;
+        total_credits: number;
+    }>;
+}
+export default ThreatLedger;

package/dist/index.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * ThreatLedger JavaScript SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThreatLedger = void 0;
+class ThreatLedger {
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl || 'https://api.threatledger.net/v1';
+    }
+    async request(path, options) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            ...options,
+            headers: { 'X-API-Key': this.apiKey, 'Content-Type': 'application/json', ...options?.headers },
+        });
+        if (!res.ok)
+            throw new Error(`ThreatLedger API error: ${res.status}`);
+        const json = await res.json();
+        return json.data;
+    }
+    async checkAddress(address) {
+        return this.request(`/addresses/check?address=${address}`);
+    }
+    async listIncidents(params) {
+        const qs = new URLSearchParams(params).toString();
+        return this.request(`/incidents${qs ? '?' + qs : ''}`);
+    }
+    async listActors() {
+        return this.request('/actors');
+    }
+    async listPatterns() {
+        return this.request('/patterns');
+    }
+    async getCredits() {
+        return this.request('/credits/balance');
+    }
+}
+exports.ThreatLedger = ThreatLedger;
+exports.default = ThreatLedger;

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@threatledger/sdk",
+  "version": "0.1.0",
+  "description": "ThreatLedger API JavaScript/TypeScript SDK",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "blockchain",
+    "forensics",
+    "threat-intelligence",
+    "crypto",
+    "aml"
+  ],
+  "license": "MIT",
+  "repository": "https://github.com/zerovector-hk/MerkleClaw",
+  "devDependencies": {
+    "typescript": "^6.0.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,64 @@
+/**
+ * ThreatLedger JavaScript SDK
+ */
+
+export interface ThreatLedgerConfig {
+  apiKey: string;
+  baseUrl?: string;
+}
+
+export interface AddressCheckResult {
+  address: string;
+  found: boolean;
+  risk_score: number;
+  risk_level: string;
+  entry?: { chain: string; tier: string; entity: string; reason: string };
+}
+
+export interface Incident {
+  id: string; title: string; date: string; chain: string;
+  severity: string; loss_usd: number; protocol: string; description: string;
+}
+
+export class ThreatLedger {
+  private apiKey: string;
+  private baseUrl: string;
+
+  constructor(config: ThreatLedgerConfig) {
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl || 'https://api.threatledger.net/v1';
+  }
+
+  private async request<T>(path: string, options?: RequestInit): Promise<T> {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      ...options,
+      headers: { 'X-API-Key': this.apiKey, 'Content-Type': 'application/json', ...options?.headers },
+    });
+    if (!res.ok) throw new Error(`ThreatLedger API error: ${res.status}`);
+    const json = await res.json();
+    return json.data;
+  }
+
+  async checkAddress(address: string): Promise<AddressCheckResult> {
+    return this.request(`/addresses/check?address=${address}`);
+  }
+
+  async listIncidents(params?: { chain?: string; severity?: string; page?: number }): Promise<Incident[]> {
+    const qs = new URLSearchParams(params as Record<string, string>).toString();
+    return this.request(`/incidents${qs ? '?' + qs : ''}`);
+  }
+
+  async listActors(): Promise<unknown[]> {
+    return this.request('/actors');
+  }
+
+  async listPatterns(): Promise<unknown[]> {
+    return this.request('/patterns');
+  }
+
+  async getCredits(): Promise<{ tier: string; remaining: number; total_credits: number }> {
+    return this.request('/credits/balance');
+  }
+}
+
+export default ThreatLedger;

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020", "DOM"],
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"]
+}