chain-insights 0.2.16

package/dist/html-generator-V6Bp0uRb.mjs

@@ -0,0 +1,68 @@
+import { t as __exportAll } from "./rolldown-runtime-wcPFST8Q.mjs";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import { readFileSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import os from "node:os";
+//#region src/viz/html-generator.ts
+var html_generator_exports = /* @__PURE__ */ __exportAll({
+	generateHtml: () => generateHtml,
+	generateInlineGraphHtml: () => generateInlineGraphHtml,
+	transformToGraphHtml: () => transformToGraphHtml,
+	writeVizHtml: () => writeVizHtml
+});
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const template = readFileSync(path.resolve(__dirname, "templates", "graph.html"), "utf-8");
+const ENTITY_TO_ROLE = {
+	eoa: "search",
+	contract: "intermediary",
+	exchange: "exchange",
+	mixer: "intermediary",
+	unknown: null
+};
+function transformToGraphHtml(data) {
+	return {
+		nodes: data.nodes.map((n) => ({
+			address: n.id,
+			address_type: n.entityType === "exchange" ? "exchange" : "wallet",
+			labels: n.label ? [n.label] : [],
+			flow_in_usd: n.totalIn,
+			flow_out_usd: n.totalOut,
+			role: ENTITY_TO_ROLE[n.entityType] ?? null,
+			risk_level: n.riskLevel === "unknown" ? null : n.riskLevel,
+			pattern_flags: []
+		})),
+		edges: data.edges.map((e) => ({
+			source: e.source,
+			target: e.target,
+			usd_amount: e.value,
+			tx_count: 1,
+			edge_type: "flows_to"
+		})),
+		metadata: { title: data.metadata.title }
+	};
+}
+function generateHtml(data, _title) {
+	return generateInlineGraphHtml(transformToGraphHtml(data));
+}
+function generateInlineGraphHtml(data) {
+	const inlineScript = `<script>var INLINE_DATA = ${JSON.stringify(data).replaceAll("<\/script>", "<\\/script>")};<\/script>`;
+	return template.replace("</body>", `${inlineScript}\n</body>`);
+}
+function sanitizePathSegment(segment) {
+	if (/[/\\]|^\.\.?$/.test(segment)) throw new Error(`Invalid path segment: ${segment}`);
+	return segment;
+}
+async function writeVizHtml(vizId, html, caseId) {
+	let vizDir;
+	if (caseId) vizDir = path.join(os.homedir(), ".chain-insights", "cases", sanitizePathSegment(caseId), "viz");
+	else vizDir = path.join(os.homedir(), ".chain-insights", "viz");
+	await mkdir(vizDir, { recursive: true });
+	const filePath = path.join(vizDir, `${vizId}.html`);
+	await writeFile(filePath, html, { mode: 384 });
+	return filePath;
+}
+//#endregion
+export { html_generator_exports as n, writeVizHtml as r, generateHtml as t };
+
+//# sourceMappingURL=html-generator-V6Bp0uRb.mjs.map

package/dist/html-generator-V6Bp0uRb.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-generator-V6Bp0uRb.mjs","names":[],"sources":["../src/viz/html-generator.ts"],"sourcesContent":["import { readFileSync } from 'node:fs'\nimport { writeFile, mkdir } from 'node:fs/promises'\nimport { fileURLToPath } from 'node:url'\nimport path from 'node:path'\nimport os from 'node:os'\nimport type { GraphData } from './graph-model.js'\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url))\nconst templatePath = path.resolve(__dirname, 'templates', 'graph.html')\nconst template = readFileSync(templatePath, 'utf-8')\n\ninterface GraphHtmlNode {\n  address: string\n  address_type: string\n  labels: string[]\n  flow_in_usd: number\n  flow_out_usd: number\n  role: string | null\n  risk_level: string | null\n  pattern_flags: string[]\n}\n\ninterface GraphHtmlEdge {\n  source: string\n  target: string\n  usd_amount: number\n  tx_count: number\n  edge_type: string\n}\n\ninterface GraphHtmlData {\n  nodes: GraphHtmlNode[]\n  edges: GraphHtmlEdge[]\n  metadata?: { seed_address?: string; title?: string }\n}\n\nconst ENTITY_TO_ROLE: Record<string, string | null> = {\n  eoa: 'search',\n  contract: 'intermediary',\n  exchange: 'exchange',\n  mixer: 'intermediary',\n  unknown: null,\n}\n\nexport function transformToGraphHtml(data: GraphData): GraphHtmlData {\n  const nodes: GraphHtmlNode[] = data.nodes.map((n) => ({\n    address: n.id,\n    address_type: n.entityType === 'exchange' ? 'exchange' : 'wallet',\n    labels: n.label ? [n.label] : [],\n    flow_in_usd: n.totalIn,\n    flow_out_usd: n.totalOut,\n    role: ENTITY_TO_ROLE[n.entityType] ?? null,\n    risk_level: n.riskLevel === 'unknown' ? null : n.riskLevel,\n    pattern_flags: [],\n  }))\n\n  const edges: GraphHtmlEdge[] = data.edges.map((e) => ({\n    source: e.source,\n    target: e.target,\n    usd_amount: e.value,\n    tx_count: 1,\n    edge_type: 'flows_to',\n  }))\n\n  return {\n    nodes,\n    edges,\n    metadata: {\n      title: data.metadata.title,\n    },\n  }\n}\n\nexport function generateHtml(data: GraphData, _title: string): string {\n  const graphHtmlData = transformToGraphHtml(data)\n  return generateInlineGraphHtml(graphHtmlData)\n}\n\nexport function generateInlineGraphHtml(data: unknown): string {\n  const dataJson = JSON.stringify(data).replaceAll('</script>', '<\\\\/script>')\n  const inlineScript = `<script>var INLINE_DATA = ${dataJson};</script>`\n\n  return template.replace('</body>', `${inlineScript}\\n</body>`)\n}\n\nfunction sanitizePathSegment(segment: string): string {\n  if (/[/\\\\]|^\\.\\.?$/.test(segment)) throw new Error(`Invalid path segment: ${segment}`)\n  return segment\n}\n\nexport async function writeVizHtml(vizId: string, html: string, caseId?: string): Promise<string> {\n  let vizDir: string\n  if (caseId) {\n    vizDir = path.join(os.homedir(), '.chain-insights', 'cases', sanitizePathSegment(caseId), 'viz')\n  } else {\n    vizDir = path.join(os.homedir(), '.chain-insights', 'viz')\n  }\n  await mkdir(vizDir, { recursive: true })\n  const filePath = path.join(vizDir, `${vizId}.html`)\n  await writeFile(filePath, html, { mode: 0o600 })\n  return filePath\n}\n"],"mappings":";;;;;;;;;;;;;AAOA,MAAM,YAAY,KAAK,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE9D,MAAM,WAAW,aADI,KAAK,QAAQ,WAAW,aAAa,aAChB,EAAE,QAAQ;AA2BpD,MAAM,iBAAgD;CACpD,KAAK;CACL,UAAU;CACV,UAAU;CACV,OAAO;CACP,SAAS;CACV;AAED,SAAgB,qBAAqB,MAAgC;AAoBnE,QAAO;EACL,OApB6B,KAAK,MAAM,KAAK,OAAO;GACpD,SAAS,EAAE;GACX,cAAc,EAAE,eAAe,aAAa,aAAa;GACzD,QAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,EAAE;GAChC,aAAa,EAAE;GACf,cAAc,EAAE;GAChB,MAAM,eAAe,EAAE,eAAe;GACtC,YAAY,EAAE,cAAc,YAAY,OAAO,EAAE;GACjD,eAAe,EAAE;GAClB,EAWM;EACL,OAV6B,KAAK,MAAM,KAAK,OAAO;GACpD,QAAQ,EAAE;GACV,QAAQ,EAAE;GACV,YAAY,EAAE;GACd,UAAU;GACV,WAAW;GACZ,EAIM;EACL,UAAU,EACR,OAAO,KAAK,SAAS,OACtB;EACF;;AAGH,SAAgB,aAAa,MAAiB,QAAwB;AAEpE,QAAO,wBADe,qBAAqB,KACC,CAAC;;AAG/C,SAAgB,wBAAwB,MAAuB;CAE7D,MAAM,eAAe,6BADJ,KAAK,UAAU,KAAK,CAAC,WAAW,cAAa,cACJ,CAAC;AAE3D,QAAO,SAAS,QAAQ,WAAW,GAAG,aAAa,WAAW;;AAGhE,SAAS,oBAAoB,SAAyB;AACpD,KAAI,gBAAgB,KAAK,QAAQ,CAAE,OAAM,IAAI,MAAM,yBAAyB,UAAU;AACtF,QAAO;;AAGT,eAAsB,aAAa,OAAe,MAAc,QAAkC;CAChG,IAAI;AACJ,KAAI,OACF,UAAS,KAAK,KAAK,GAAG,SAAS,EAAE,mBAAmB,SAAS,oBAAoB,OAAO,EAAE,MAAM;KAEhG,UAAS,KAAK,KAAK,GAAG,SAAS,EAAE,mBAAmB,MAAM;AAE5D,OAAM,MAAM,QAAQ,EAAE,WAAW,MAAM,CAAC;CACxC,MAAM,WAAW,KAAK,KAAK,QAAQ,GAAG,MAAM,OAAO;AACnD,OAAM,UAAU,UAAU,MAAM,EAAE,MAAM,KAAO,CAAC;AAChD,QAAO"}

package/dist/index.cjs

@@ -0,0 +1,31 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_config = require("./config-Bmdl5hdk.cjs");
+const require_app = require("./app-Dq1TdB6p.cjs");
+const require_server = require("./server-DXowbpfi.cjs");
+const require_wallet = require("./wallet-RnvvSpV2.cjs");
+const require_tools = require("./tools-f_vJUZAF.cjs");
+const require_topup_server = require("./topup-server-BZuQifvh.cjs");
+const require_client = require("./client-D4fZgIaO.cjs");
+const require_viz = require("./viz-ClezVXrJ.cjs");
+exports.buildTopupInfo = require_tools.buildTopupInfo;
+exports.createApp = require_app.createApp;
+exports.createMcpFetchClient = require_client.createMcpFetchClient;
+exports.decryptKey = require_wallet.decryptKey;
+exports.encryptKey = require_wallet.encryptKey;
+exports.formatWalletBalance = require_tools.formatWalletBalance;
+exports.generateArtifactHtml = require_topup_server.generateArtifactHtml;
+exports.generateVisualization = require_viz.generateVisualization;
+exports.getBalanceEth = require_tools.getBalanceEth;
+exports.getBalanceUsdc = require_tools.getBalanceUsdc;
+exports.getTopupUrl = require_topup_server.getTopupUrl;
+exports.getWalletAccount = require_tools.getWalletAccount;
+exports.getWalletBalanceText = require_tools.getWalletBalanceText;
+exports.isWalletConfigured = require_wallet.isWalletConfigured;
+exports.loadConfig = require_config.loadConfig;
+exports.normalizeWalletPrivateKey = require_wallet.normalizeWalletPrivateKey;
+exports.resetConfigCache = require_config.resetConfigCache;
+exports.saveConfig = require_config.saveConfig;
+exports.setWalletPrivateKey = require_wallet.setWalletPrivateKey;
+exports.startServer = require_server.startServer;
+exports.startTopupServer = require_topup_server.startTopupServer;
+exports.walletAddressFromPrivateKey = require_wallet.walletAddressFromPrivateKey;

package/dist/index.d.cts

@@ -0,0 +1,187 @@
+import * as z from "zod";
+import { Hono } from "hono";
+import { Address, Hex } from "viem";
+
+//#region src/config/schema.d.ts
+declare const ConfigSchema: z.ZodObject<{
+  mcpEndpoint: z.ZodDefault<z.ZodString>;
+  mcpAuthToken: z.ZodOptional<z.ZodString>;
+  graphMcpEndpoint: z.ZodDefault<z.ZodString>;
+  graphMcpAuthToken: z.ZodOptional<z.ZodString>;
+  graphMcpMode: z.ZodDefault<z.ZodEnum<{
+    paid: "paid";
+    debug: "debug";
+  }>>;
+  walletAddress: z.ZodOptional<z.ZodString>;
+  serverPort: z.ZodDefault<z.ZodNumber>;
+  dataDir: z.ZodDefault<z.ZodString>;
+  version: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type InvestigatorConfig = z.infer<typeof ConfigSchema>;
+//#endregion
+//#region src/config/index.d.ts
+declare function loadConfig(): Promise<InvestigatorConfig>;
+declare function saveConfig(updates: Partial<InvestigatorConfig>): Promise<void>;
+declare function resetConfigCache(): Promise<void>;
+//#endregion
+//#region src/server/app.d.ts
+declare function createApp(): Hono;
+//#endregion
+//#region src/server/index.d.ts
+declare function startServer(port?: number): () => void;
+//#endregion
+//#region src/wallet/index.d.ts
+declare function normalizeWalletPrivateKey(value: string): Hex;
+declare function walletAddressFromPrivateKey(privateKey: string): Address;
+/**
+ * Encrypts a private key and writes it to ~/.chain-insights/wallet.json.
+ * Uses AES-256-GCM with a machine-identity-derived key and a random per-wallet salt.
+ * File is written with 0o600 permissions (owner read/write only).
+ *
+ * @param privateKey - The EVM private key to encrypt (0x-prefixed)
+ */
+declare function encryptKey(privateKey: string): Promise<void>;
+declare function setWalletPrivateKey(privateKey: string): Promise<Address>;
+/**
+ * Reads and decrypts the private key from ~/.chain-insights/wallet.json.
+ * Throws a human-readable error if wallet is absent or decryption fails.
+ *
+ * @returns The decrypted EVM private key string
+ */
+declare function decryptKey(): Promise<string>;
+/**
+ * Returns true if wallet.json exists, false if absent.
+ * Does not validate the wallet contents.
+ */
+declare function isWalletConfigured(): Promise<boolean>;
+//#endregion
+//#region src/wallet/tools.d.ts
+declare const BASE_CHAIN_ID = 8453;
+declare const USDC_ADDRESS: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+interface PaymentWalletAccount {
+  address: Address;
+  privateKey: Hex;
+}
+interface TopupInfo {
+  wallet_address: string;
+  network: 'Base';
+  chain_id: typeof BASE_CHAIN_ID;
+  token: 'USDC';
+  token_contract: typeof USDC_ADDRESS;
+  topup_url?: string;
+}
+declare function getWalletAccount(): Promise<PaymentWalletAccount>;
+declare function getBalanceUsdc(address: Address | string, rpcUrl?: string | undefined): Promise<string>;
+declare function getBalanceEth(address: Address | string, rpcUrl?: string | undefined): Promise<string>;
+declare function formatWalletBalance(address: string, balanceUsdc: string, balanceEth?: string): string;
+declare function getWalletBalanceText(account?: PaymentWalletAccount): Promise<string>;
+declare function buildTopupInfo(address: string, topupUrl?: string): TopupInfo;
+//#endregion
+//#region src/wallet/mcp-proxy/topup-server.d.ts
+declare function generateArtifactHtml(walletAddress: string, topupUrl: string): string;
+//#endregion
+//#region src/wallet/topup-server.d.ts
+declare function getTopupUrl(): string | null;
+declare function startTopupServer(account: PaymentWalletAccount | string): Promise<string>;
+//#endregion
+//#region src/mcp/client.d.ts
+/**
+ * Creates an x402-payment-wrapped fetch function for the Chain Insights MCP.
+ * Payments are made in USDC on Base Mainnet (eip155:8453).
+ *
+ * The factory is pure — no side effects, no state, no caching.
+ * If called with an invalid private key format, viem throws — the error propagates.
+ *
+ * @param privateKey - 0x-prefixed EVM private key (decrypted from wallet.json)
+ * @returns A fetch-compatible function that auto-handles HTTP 402 payment challenges
+ */
+declare function createMcpFetchClient(privateKey: `0x${string}`, authToken?: string): typeof fetch;
+//#endregion
+//#region src/viz/graph-model.d.ts
+declare const GraphNode: z.ZodObject<{
+  id: z.ZodString;
+  label: z.ZodOptional<z.ZodString>;
+  entityType: z.ZodDefault<z.ZodEnum<{
+    eoa: "eoa";
+    contract: "contract";
+    exchange: "exchange";
+    mixer: "mixer";
+    unknown: "unknown";
+  }>>;
+  riskLevel: z.ZodDefault<z.ZodEnum<{
+    unknown: "unknown";
+    low: "low";
+    medium: "medium";
+    high: "high";
+    critical: "critical";
+  }>>;
+  totalIn: z.ZodDefault<z.ZodNumber>;
+  totalOut: z.ZodDefault<z.ZodNumber>;
+  txCount: z.ZodDefault<z.ZodNumber>;
+  firstSeen: z.ZodOptional<z.ZodString>;
+  lastSeen: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type GraphNode = z.infer<typeof GraphNode>;
+declare const GraphEdge: z.ZodObject<{
+  source: z.ZodString;
+  target: z.ZodString;
+  value: z.ZodNumber;
+  txHash: z.ZodOptional<z.ZodString>;
+  blockNumber: z.ZodOptional<z.ZodNumber>;
+  timestamp: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type GraphEdge = z.infer<typeof GraphEdge>;
+declare const GraphData: z.ZodObject<{
+  nodes: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    entityType: z.ZodDefault<z.ZodEnum<{
+      eoa: "eoa";
+      contract: "contract";
+      exchange: "exchange";
+      mixer: "mixer";
+      unknown: "unknown";
+    }>>;
+    riskLevel: z.ZodDefault<z.ZodEnum<{
+      unknown: "unknown";
+      low: "low";
+      medium: "medium";
+      high: "high";
+      critical: "critical";
+    }>>;
+    totalIn: z.ZodDefault<z.ZodNumber>;
+    totalOut: z.ZodDefault<z.ZodNumber>;
+    txCount: z.ZodDefault<z.ZodNumber>;
+    firstSeen: z.ZodOptional<z.ZodString>;
+    lastSeen: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  edges: z.ZodArray<z.ZodObject<{
+    source: z.ZodString;
+    target: z.ZodString;
+    value: z.ZodNumber;
+    txHash: z.ZodOptional<z.ZodString>;
+    blockNumber: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  metadata: z.ZodObject<{
+    caseId: z.ZodOptional<z.ZodString>;
+    title: z.ZodDefault<z.ZodString>;
+    generatedAt: z.ZodString;
+    truncated: z.ZodDefault<z.ZodBoolean>;
+    totalNodes: z.ZodOptional<z.ZodNumber>;
+    hiddenNodes: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+type GraphData = z.infer<typeof GraphData>;
+//#endregion
+//#region src/viz/index.d.ts
+declare function generateVisualization(opts: {
+  caseId?: string;
+  dataFile?: string;
+}): Promise<{
+  vizId: string;
+  htmlPath: string;
+}>;
+//#endregion
+export { type GraphData as GraphDataType, type GraphEdge as GraphEdgeType, type GraphNode as GraphNodeType, type InvestigatorConfig, buildTopupInfo, createApp, createMcpFetchClient, decryptKey, encryptKey, formatWalletBalance, generateArtifactHtml, generateVisualization, getBalanceEth, getBalanceUsdc, getTopupUrl, getWalletAccount, getWalletBalanceText, isWalletConfigured, loadConfig, normalizeWalletPrivateKey, resetConfigCache, saveConfig, setWalletPrivateKey, startServer, startTopupServer, walletAddressFromPrivateKey };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/config/schema.ts","../src/config/index.ts","../src/server/app.ts","../src/server/index.ts","../src/wallet/index.ts","../src/wallet/tools.ts","../src/wallet/mcp-proxy/topup-server.ts","../src/wallet/topup-server.ts","../src/mcp/client.ts","../src/viz/graph-model.ts","../src/viz/index.ts"],"mappings":";;;;;cAIa,YAAA,EAAY,CAAA,CAAA,SAAA;;;;;;;;;;;;;;KAYb,kBAAA,GAAqB,CAAA,CAAE,KAAA,QAAa,YAAA;;;iBCJ1B,UAAA,CAAA,GAAc,OAAA,CAAQ,kBAAA;AAAA,iBAYtB,UAAA,CAAW,OAAA,EAAS,OAAA,CAAQ,kBAAA,IAAsB,OAAA;AAAA,iBASlD,gBAAA,CAAA,GAAoB,OAAA;;;iBCkG1B,SAAA,CAAA,GAAa,IAAA;;;iBChIb,WAAA,CAAY,IAAA;;;iBC0BZ,yBAAA,CAA0B,KAAA,WAAgB,GAAA;AAAA,iBAO1C,2BAAA,CAA4B,UAAA,WAAqB,OAAA;;AJhCjE;;;;;;iBI2CsB,UAAA,CAAW,UAAA,WAAqB,OAAA;AAAA,iBA2BhC,mBAAA,CAAoB,UAAA,WAAqB,OAAA,CAAQ,OAAA;;;;;;;iBAajD,UAAA,CAAA,GAAc,OAAA;;;;;iBA2Cd,kBAAA,CAAA,GAAsB,OAAA;;;cC7H/B,aAAA;AAAA,cACA,YAAA;AAAA,UAmBI,oBAAA;EACf,OAAA,EAAS,OAAA;EACT,UAAA,EAAY,GAAA;AAAA;AAAA,UAGG,SAAA;EACf,cAAA;EACA,OAAA;EACA,QAAA,SAAiB,aAAA;EACjB,KAAA;EACA,cAAA,SAAuB,YAAA;EACvB,SAAA;AAAA;AAAA,iBAGoB,gBAAA,CAAA,GAAoB,OAAA,CAAQ,oBAAA;AAAA,iBAM5B,cAAA,CACpB,OAAA,EAAS,OAAA,WACT,MAAA,wBACC,OAAA;AAAA,iBA2BmB,aAAA,CACpB,OAAA,EAAS,OAAA,WACT,MAAA,wBACC,OAAA;AAAA,iBAsBa,mBAAA,CAAoB,OAAA,UAAiB,WAAA,UAAqB,UAAA;AAAA,iBAUpD,oBAAA,CAAqB,OAAA,GAAU,oBAAA,GAAuB,OAAA;AAAA,iBAS5D,cAAA,CAAe,OAAA,UAAiB,QAAA,YAAoB,SAAA;;;iBC3BpD,oBAAA,CAAqB,aAAA,UAAuB,QAAA;;;iBCjC5C,WAAA,CAAA;AAAA,iBAIM,gBAAA,CAAiB,OAAA,EAAS,oBAAA,YAAgC,OAAA;;;;;;AP3DhF;;;;;;;iBQsEgB,oBAAA,CAAqB,UAAA,iBAA2B,SAAA,mBAAkB,KAAA;;;cClErE,SAAA,EAAS,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;KAWV,SAAA,GAAY,CAAA,CAAE,KAAA,QAAa,SAAA;AAAA,cAE1B,SAAA,EAAS,CAAA,CAAA,SAAA;;;;;;;;KAQV,SAAA,GAAY,CAAA,CAAE,KAAA,QAAa,SAAA;AAAA,cAE1B,SAAA,EAAS,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAYV,SAAA,GAAY,CAAA,CAAE,KAAA,QAAa,SAAA;;;iBClCjB,qBAAA,CAAsB,IAAA;EAC1C,MAAA;EACA,QAAA;AAAA,IACE,OAAA;EAAU,KAAA;EAAe,QAAA;AAAA"}

package/dist/index.d.mts

@@ -0,0 +1,187 @@
+import * as z from "zod";
+import { Hono } from "hono";
+import { Address, Hex } from "viem";
+
+//#region src/config/schema.d.ts
+declare const ConfigSchema: z.ZodObject<{
+  mcpEndpoint: z.ZodDefault<z.ZodString>;
+  mcpAuthToken: z.ZodOptional<z.ZodString>;
+  graphMcpEndpoint: z.ZodDefault<z.ZodString>;
+  graphMcpAuthToken: z.ZodOptional<z.ZodString>;
+  graphMcpMode: z.ZodDefault<z.ZodEnum<{
+    paid: "paid";
+    debug: "debug";
+  }>>;
+  walletAddress: z.ZodOptional<z.ZodString>;
+  serverPort: z.ZodDefault<z.ZodNumber>;
+  dataDir: z.ZodDefault<z.ZodString>;
+  version: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type InvestigatorConfig = z.infer<typeof ConfigSchema>;
+//#endregion
+//#region src/config/index.d.ts
+declare function loadConfig(): Promise<InvestigatorConfig>;
+declare function saveConfig(updates: Partial<InvestigatorConfig>): Promise<void>;
+declare function resetConfigCache(): Promise<void>;
+//#endregion
+//#region src/server/app.d.ts
+declare function createApp(): Hono;
+//#endregion
+//#region src/server/index.d.ts
+declare function startServer(port?: number): () => void;
+//#endregion
+//#region src/wallet/index.d.ts
+declare function normalizeWalletPrivateKey(value: string): Hex;
+declare function walletAddressFromPrivateKey(privateKey: string): Address;
+/**
+ * Encrypts a private key and writes it to ~/.chain-insights/wallet.json.
+ * Uses AES-256-GCM with a machine-identity-derived key and a random per-wallet salt.
+ * File is written with 0o600 permissions (owner read/write only).
+ *
+ * @param privateKey - The EVM private key to encrypt (0x-prefixed)
+ */
+declare function encryptKey(privateKey: string): Promise<void>;
+declare function setWalletPrivateKey(privateKey: string): Promise<Address>;
+/**
+ * Reads and decrypts the private key from ~/.chain-insights/wallet.json.
+ * Throws a human-readable error if wallet is absent or decryption fails.
+ *
+ * @returns The decrypted EVM private key string
+ */
+declare function decryptKey(): Promise<string>;
+/**
+ * Returns true if wallet.json exists, false if absent.
+ * Does not validate the wallet contents.
+ */
+declare function isWalletConfigured(): Promise<boolean>;
+//#endregion
+//#region src/wallet/tools.d.ts
+declare const BASE_CHAIN_ID = 8453;
+declare const USDC_ADDRESS: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+interface PaymentWalletAccount {
+  address: Address;
+  privateKey: Hex;
+}
+interface TopupInfo {
+  wallet_address: string;
+  network: 'Base';
+  chain_id: typeof BASE_CHAIN_ID;
+  token: 'USDC';
+  token_contract: typeof USDC_ADDRESS;
+  topup_url?: string;
+}
+declare function getWalletAccount(): Promise<PaymentWalletAccount>;
+declare function getBalanceUsdc(address: Address | string, rpcUrl?: string | undefined): Promise<string>;
+declare function getBalanceEth(address: Address | string, rpcUrl?: string | undefined): Promise<string>;
+declare function formatWalletBalance(address: string, balanceUsdc: string, balanceEth?: string): string;
+declare function getWalletBalanceText(account?: PaymentWalletAccount): Promise<string>;
+declare function buildTopupInfo(address: string, topupUrl?: string): TopupInfo;
+//#endregion
+//#region src/wallet/mcp-proxy/topup-server.d.ts
+declare function generateArtifactHtml(walletAddress: string, topupUrl: string): string;
+//#endregion
+//#region src/wallet/topup-server.d.ts
+declare function getTopupUrl(): string | null;
+declare function startTopupServer(account: PaymentWalletAccount | string): Promise<string>;
+//#endregion
+//#region src/mcp/client.d.ts
+/**
+ * Creates an x402-payment-wrapped fetch function for the Chain Insights MCP.
+ * Payments are made in USDC on Base Mainnet (eip155:8453).
+ *
+ * The factory is pure — no side effects, no state, no caching.
+ * If called with an invalid private key format, viem throws — the error propagates.
+ *
+ * @param privateKey - 0x-prefixed EVM private key (decrypted from wallet.json)
+ * @returns A fetch-compatible function that auto-handles HTTP 402 payment challenges
+ */
+declare function createMcpFetchClient(privateKey: `0x${string}`, authToken?: string): typeof fetch;
+//#endregion
+//#region src/viz/graph-model.d.ts
+declare const GraphNode: z.ZodObject<{
+  id: z.ZodString;
+  label: z.ZodOptional<z.ZodString>;
+  entityType: z.ZodDefault<z.ZodEnum<{
+    eoa: "eoa";
+    contract: "contract";
+    exchange: "exchange";
+    mixer: "mixer";
+    unknown: "unknown";
+  }>>;
+  riskLevel: z.ZodDefault<z.ZodEnum<{
+    unknown: "unknown";
+    low: "low";
+    medium: "medium";
+    high: "high";
+    critical: "critical";
+  }>>;
+  totalIn: z.ZodDefault<z.ZodNumber>;
+  totalOut: z.ZodDefault<z.ZodNumber>;
+  txCount: z.ZodDefault<z.ZodNumber>;
+  firstSeen: z.ZodOptional<z.ZodString>;
+  lastSeen: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type GraphNode = z.infer<typeof GraphNode>;
+declare const GraphEdge: z.ZodObject<{
+  source: z.ZodString;
+  target: z.ZodString;
+  value: z.ZodNumber;
+  txHash: z.ZodOptional<z.ZodString>;
+  blockNumber: z.ZodOptional<z.ZodNumber>;
+  timestamp: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type GraphEdge = z.infer<typeof GraphEdge>;
+declare const GraphData: z.ZodObject<{
+  nodes: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    entityType: z.ZodDefault<z.ZodEnum<{
+      eoa: "eoa";
+      contract: "contract";
+      exchange: "exchange";
+      mixer: "mixer";
+      unknown: "unknown";
+    }>>;
+    riskLevel: z.ZodDefault<z.ZodEnum<{
+      unknown: "unknown";
+      low: "low";
+      medium: "medium";
+      high: "high";
+      critical: "critical";
+    }>>;
+    totalIn: z.ZodDefault<z.ZodNumber>;
+    totalOut: z.ZodDefault<z.ZodNumber>;
+    txCount: z.ZodDefault<z.ZodNumber>;
+    firstSeen: z.ZodOptional<z.ZodString>;
+    lastSeen: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  edges: z.ZodArray<z.ZodObject<{
+    source: z.ZodString;
+    target: z.ZodString;
+    value: z.ZodNumber;
+    txHash: z.ZodOptional<z.ZodString>;
+    blockNumber: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  metadata: z.ZodObject<{
+    caseId: z.ZodOptional<z.ZodString>;
+    title: z.ZodDefault<z.ZodString>;
+    generatedAt: z.ZodString;
+    truncated: z.ZodDefault<z.ZodBoolean>;
+    totalNodes: z.ZodOptional<z.ZodNumber>;
+    hiddenNodes: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+type GraphData = z.infer<typeof GraphData>;
+//#endregion
+//#region src/viz/index.d.ts
+declare function generateVisualization(opts: {
+  caseId?: string;
+  dataFile?: string;
+}): Promise<{
+  vizId: string;
+  htmlPath: string;
+}>;
+//#endregion
+export { type GraphData as GraphDataType, type GraphEdge as GraphEdgeType, type GraphNode as GraphNodeType, type InvestigatorConfig, buildTopupInfo, createApp, createMcpFetchClient, decryptKey, encryptKey, formatWalletBalance, generateArtifactHtml, generateVisualization, getBalanceEth, getBalanceUsdc, getTopupUrl, getWalletAccount, getWalletBalanceText, isWalletConfigured, loadConfig, normalizeWalletPrivateKey, resetConfigCache, saveConfig, setWalletPrivateKey, startServer, startTopupServer, walletAddressFromPrivateKey };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/config/schema.ts","../src/config/index.ts","../src/server/app.ts","../src/server/index.ts","../src/wallet/index.ts","../src/wallet/tools.ts","../src/wallet/mcp-proxy/topup-server.ts","../src/wallet/topup-server.ts","../src/mcp/client.ts","../src/viz/graph-model.ts","../src/viz/index.ts"],"mappings":";;;;;cAIa,YAAA,EAAY,CAAA,CAAA,SAAA;;;;;;;;;;;;;;KAYb,kBAAA,GAAqB,CAAA,CAAE,KAAA,QAAa,YAAA;;;iBCJ1B,UAAA,CAAA,GAAc,OAAA,CAAQ,kBAAA;AAAA,iBAYtB,UAAA,CAAW,OAAA,EAAS,OAAA,CAAQ,kBAAA,IAAsB,OAAA;AAAA,iBASlD,gBAAA,CAAA,GAAoB,OAAA;;;iBCkG1B,SAAA,CAAA,GAAa,IAAA;;;iBChIb,WAAA,CAAY,IAAA;;;iBC0BZ,yBAAA,CAA0B,KAAA,WAAgB,GAAA;AAAA,iBAO1C,2BAAA,CAA4B,UAAA,WAAqB,OAAA;;AJhCjE;;;;;;iBI2CsB,UAAA,CAAW,UAAA,WAAqB,OAAA;AAAA,iBA2BhC,mBAAA,CAAoB,UAAA,WAAqB,OAAA,CAAQ,OAAA;;;;;;;iBAajD,UAAA,CAAA,GAAc,OAAA;;;;;iBA2Cd,kBAAA,CAAA,GAAsB,OAAA;;;cC7H/B,aAAA;AAAA,cACA,YAAA;AAAA,UAmBI,oBAAA;EACf,OAAA,EAAS,OAAA;EACT,UAAA,EAAY,GAAA;AAAA;AAAA,UAGG,SAAA;EACf,cAAA;EACA,OAAA;EACA,QAAA,SAAiB,aAAA;EACjB,KAAA;EACA,cAAA,SAAuB,YAAA;EACvB,SAAA;AAAA;AAAA,iBAGoB,gBAAA,CAAA,GAAoB,OAAA,CAAQ,oBAAA;AAAA,iBAM5B,cAAA,CACpB,OAAA,EAAS,OAAA,WACT,MAAA,wBACC,OAAA;AAAA,iBA2BmB,aAAA,CACpB,OAAA,EAAS,OAAA,WACT,MAAA,wBACC,OAAA;AAAA,iBAsBa,mBAAA,CAAoB,OAAA,UAAiB,WAAA,UAAqB,UAAA;AAAA,iBAUpD,oBAAA,CAAqB,OAAA,GAAU,oBAAA,GAAuB,OAAA;AAAA,iBAS5D,cAAA,CAAe,OAAA,UAAiB,QAAA,YAAoB,SAAA;;;iBC3BpD,oBAAA,CAAqB,aAAA,UAAuB,QAAA;;;iBCjC5C,WAAA,CAAA;AAAA,iBAIM,gBAAA,CAAiB,OAAA,EAAS,oBAAA,YAAgC,OAAA;;;;;;AP3DhF;;;;;;;iBQsEgB,oBAAA,CAAqB,UAAA,iBAA2B,SAAA,mBAAkB,KAAA;;;cClErE,SAAA,EAAS,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;KAWV,SAAA,GAAY,CAAA,CAAE,KAAA,QAAa,SAAA;AAAA,cAE1B,SAAA,EAAS,CAAA,CAAA,SAAA;;;;;;;;KAQV,SAAA,GAAY,CAAA,CAAE,KAAA,QAAa,SAAA;AAAA,cAE1B,SAAA,EAAS,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAYV,SAAA,GAAY,CAAA,CAAE,KAAA,QAAa,SAAA;;;iBClCjB,qBAAA,CAAsB,IAAA;EAC1C,MAAA;EACA,QAAA;AAAA,IACE,OAAA;EAAU,KAAA;EAAe,QAAA;AAAA"}

package/dist/index.mjs

@@ -0,0 +1,9 @@
+import { i as saveConfig, n as loadConfig, r as resetConfigCache } from "./config-BwrBYmiC.mjs";
+import { t as createApp } from "./app-BjjuQM0B.mjs";
+import { n as startServer } from "./server-BkM5xrXb.mjs";
+import { a as setWalletPrivateKey, i as normalizeWalletPrivateKey, n as encryptKey, o as walletAddressFromPrivateKey, r as isWalletConfigured, t as decryptKey } from "./wallet-BMelXBYP.mjs";
+import { a as getWalletAccount, i as getBalanceUsdc, n as formatWalletBalance, o as getWalletBalanceText, r as getBalanceEth, t as buildTopupInfo } from "./tools-Cp2jAAAb.mjs";
+import { i as generateArtifactHtml, n as startTopupServer, t as getTopupUrl } from "./topup-server-DUjyFftI.mjs";
+import { r as createMcpFetchClient } from "./client-D4Bq0rp9.mjs";
+import { t as generateVisualization } from "./viz-BlCJe6Tk.mjs";
+export { buildTopupInfo, createApp, createMcpFetchClient, decryptKey, encryptKey, formatWalletBalance, generateArtifactHtml, generateVisualization, getBalanceEth, getBalanceUsdc, getTopupUrl, getWalletAccount, getWalletBalanceText, isWalletConfigured, loadConfig, normalizeWalletPrivateKey, resetConfigCache, saveConfig, setWalletPrivateKey, startServer, startTopupServer, walletAddressFromPrivateKey };