meshcore-hashtag-cracker 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * MeshCore Cracker - Standalone library for cracking MeshCore GroupText packets
+ *
+ * @example
+ * ```typescript
+ * import { GroupTextCracker } from 'meshcore-cracker';
+ *
+ * const cracker = new GroupTextCracker();
+ *
+ * // Optional: load wordlist for dictionary attack
+ * await cracker.loadWordlist('/words_alpha.txt');
+ *
+ * const result = await cracker.crack(packetHex, {
+ *   maxLength: 6,
+ *   useTimestampFilter: true,
+ *   useUtf8Filter: true,
+ * }, (progress) => {
+ *   console.log(`${progress.percent.toFixed(1)}% - ETA: ${progress.etaSeconds}s`);
+ * });
+ *
+ * if (result.found) {
+ *   console.log(`Room: #${result.roomName}`);
+ *   console.log(`Message: ${result.decryptedMessage}`);
+ * }
+ *
+ * cracker.destroy();
+ * ```
+ */
+export { GroupTextCracker } from './cracker';
+export type { CrackOptions, CrackResult, ProgressReport, ProgressCallback, DecodedPacket, } from './types';
+export { deriveKeyFromRoomName, getChannelHash, verifyMac, isTimestampValid, isValidUtf8, indexToRoomName, roomNameToIndex, countNamesForLength, PUBLIC_ROOM_NAME, PUBLIC_KEY, DEFAULT_VALID_SECONDS, } from './core';
+export { isWebGpuSupported } from './gpu-bruteforce';
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG7C,YAAY,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACV,qBAAqB,GACtB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+/**
+ * MeshCore Cracker - Standalone library for cracking MeshCore GroupText packets
+ *
+ * @example
+ * ```typescript
+ * import { GroupTextCracker } from 'meshcore-cracker';
+ *
+ * const cracker = new GroupTextCracker();
+ *
+ * // Optional: load wordlist for dictionary attack
+ * await cracker.loadWordlist('/words_alpha.txt');
+ *
+ * const result = await cracker.crack(packetHex, {
+ *   maxLength: 6,
+ *   useTimestampFilter: true,
+ *   useUtf8Filter: true,
+ * }, (progress) => {
+ *   console.log(`${progress.percent.toFixed(1)}% - ETA: ${progress.etaSeconds}s`);
+ * });
+ *
+ * if (result.found) {
+ *   console.log(`Room: #${result.roomName}`);
+ *   console.log(`Message: ${result.decryptedMessage}`);
+ * }
+ *
+ * cracker.destroy();
+ * ```
+ */
+// Main cracker class
+export { GroupTextCracker } from './cracker';
+// Utility exports for advanced usage
+export { deriveKeyFromRoomName, getChannelHash, verifyMac, isTimestampValid, isValidUtf8, indexToRoomName, roomNameToIndex, countNamesForLength, PUBLIC_ROOM_NAME, PUBLIC_KEY, DEFAULT_VALID_SECONDS, } from './core';
+export { isWebGpuSupported } from './gpu-bruteforce';
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,qBAAqB;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAW7C,qCAAqC;AACrC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACV,qBAAqB,GACtB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Options for configuring the cracking process.
+ */
+export interface CrackOptions {
+    /**
+     * Maximum room name length to search (default: 8).
+     * Longer names exponentially increase search time.
+     */
+    maxLength?: number;
+    /**
+     * Minimum room name length to search (default: 1).
+     * Use this to skip shorter room names if you know the target is longer.
+     */
+    startingLength?: number;
+    /**
+     * Use dictionary attack before brute force (default: true).
+     * When enabled and a wordlist is loaded, tries dictionary words first.
+     * Set to false to skip dictionary attack even if a wordlist is loaded.
+     */
+    useDictionary?: boolean;
+    /**
+     * Filter results by timestamp validity (default: true).
+     * When enabled, rejects results where the decrypted timestamp
+     * is outside the validity window.
+     */
+    useTimestampFilter?: boolean;
+    /**
+     * Timestamp validity window in seconds (default: 2592000 = 30 days).
+     * Only used when useTimestampFilter is enabled.
+     * Timestamps older than this many seconds from now are rejected.
+     */
+    validSeconds?: number;
+    /**
+     * Filter results by UTF-8 validity (default: true).
+     * When enabled, rejects results containing invalid UTF-8 sequences.
+     */
+    useUtf8Filter?: boolean;
+    /**
+     * Resume cracking from a specific room name position.
+     * Useful for resuming interrupted searches.
+     */
+    startFrom?: string;
+    /**
+     * Force CPU-based cracking instead of WebGPU (default: false).
+     * Much slower but works in environments without WebGPU support.
+     * Also useful for testing.
+     */
+    forceCpu?: boolean;
+}
+/**
+ * Progress information reported during cracking.
+ */
+export interface ProgressReport {
+    /** Total candidates checked so far */
+    checked: number;
+    /** Total candidates to check */
+    total: number;
+    /** Progress percentage (0-100) */
+    percent: number;
+    /** Current cracking rate in keys/second */
+    rateKeysPerSec: number;
+    /** Estimated time remaining in seconds */
+    etaSeconds: number;
+    /** Time elapsed since start in seconds */
+    elapsedSeconds: number;
+    /** Current room name length being tested */
+    currentLength: number;
+    /** Current room name position being tested */
+    currentPosition: string;
+    /** Current phase of cracking */
+    phase: 'public-key' | 'wordlist' | 'bruteforce';
+}
+/**
+ * Callback function for progress updates.
+ * Called approximately 5 times per second during cracking.
+ */
+export type ProgressCallback = (report: ProgressReport) => void;
+/**
+ * Result of a cracking operation.
+ */
+export interface CrackResult {
+    /** Whether a matching room name was found */
+    found: boolean;
+    /** The room name (without '#' prefix) if found */
+    roomName?: string;
+    /** The derived encryption key (hex) if found */
+    key?: string;
+    /** The decrypted message content if found */
+    decryptedMessage?: string;
+    /** Whether the operation was aborted */
+    aborted?: boolean;
+    /** Position to resume from if aborted or failed */
+    resumeFrom?: string;
+    /** Error message if an error occurred */
+    error?: string;
+}
+/**
+ * Decoded packet information extracted from a MeshCore GroupText packet.
+ */
+export interface DecodedPacket {
+    /** Channel hash (1 byte, hex) */
+    channelHash: string;
+    /** Encrypted ciphertext (hex) */
+    ciphertext: string;
+    /** MAC for verification (2 bytes, hex) */
+    cipherMac: string;
+    /** Whether this is a GroupText packet */
+    isGroupText: boolean;
+}
+//# 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;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAEhB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IAEd,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAEhB,2CAA2C;IAC3C,cAAc,EAAE,MAAM,CAAC;IAEvB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IAEnB,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;IAEvB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IAEtB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;IAExB,gCAAgC;IAChC,KAAK,EAAE,YAAY,GAAG,UAAU,GAAG,YAAY,CAAC;CACjD;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;IAEf,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IAEpB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IAEnB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAElB,yCAAyC;IACzC,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# 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

@@ -0,0 +1,55 @@
+{
+  "name": "meshcore-hashtag-cracker",
+  "version": "1.0.0",
+  "description": "MeshCore hashtag Grouptext packet brute-forcer",
+  "author": "Jack Kingsman",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jkingsman/meshcore-hashtag-cracker.git"
+  },
+  "homepage": "https://github.com/jkingsman/meshcore-hashtag-cracker#readme",
+  "bugs": {
+    "url": "https://github.com/jkingsman/meshcore-hashtag-cracker/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@michaelhart/meshcore-decoder": "^0.2.7",
+    "crypto-js": "^4.2.0"
+  },
+  "devDependencies": {
+    "@types/crypto-js": "^4.2.2",
+    "@webgpu/types": "^0.1.68",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.16"
+  },
+  "keywords": [
+    "meshcore",
+    "cracker",
+    "brute-force",
+    "webgpu"
+  ],
+  "directories": {
+    "test": "test"
+  }
+}