@cogcoin/client 0.5.3 → 0.5.4

package/dist/wallet/material.js

@@ -1,13 +1,14 @@
 import { createHash, randomBytes } from "node:crypto";
 import { bech32 } from "@scure/base";
 import { HDKey } from "@scure/bip32";
-import { generateMnemonic, mnemonicToSeedSync } from "@scure/bip39";
+import { generateMnemonic, mnemonicToSeedSync, validateMnemonic } from "@scure/bip39";
 import { wordlist as englishWordlist } from "@scure/bip39/wordlists/english.js";
 import { secp256k1 } from "@noble/curves/secp256k1.js";
 import { keccak_256 } from "@noble/hashes/sha3.js";
 export const WALLET_ACCOUNT_PATH = "m/84'/0'/0'";
 export const DEFAULT_DESCRIPTOR_RANGE_END = 4095;
 export const DEFAULT_DESCRIPTOR_SAFETY_MARGIN = 128;
+const ENGLISH_WORDLIST_SET = new Set(englishWordlist);
 function hash160(value) {
     const sha256 = createHash("sha256").update(value).digest();
     return createHash("ripemd160").update(sha256).digest();
@@ -57,6 +58,12 @@ export function generateWalletMaterial() {
     const phrase = generateMnemonic(englishWordlist, 256);
     return deriveWalletMaterialFromMnemonic(phrase);
 }
+export function isEnglishMnemonicWord(word) {
+    return ENGLISH_WORDLIST_SET.has(word);
+}
+export function validateEnglishMnemonic(phrase) {
+    return validateMnemonic(phrase, englishWordlist);
+}
 export function deriveWalletMaterialFromMnemonic(phrase) {
     const words = phrase.trim().split(/\s+/);
     const seed = mnemonicToSeedSync(phrase);

package/dist/wallet/mnemonic-art.d.ts

@@ -0,0 +1,2 @@
+export declare function renderWalletMnemonicRevealArt(words: readonly string[]): string[];
+export declare function loadWalletArtTemplateForTesting(): string[];

package/dist/wallet/mnemonic-art.js

@@ -0,0 +1,54 @@
+import { readFileSync } from "node:fs";
+const WALLET_ART_WIDTH = 80;
+const WALLET_ART_SLOT_WIDTH = 8;
+const WALLET_ART_PLACEHOLDER_WORD = "achieved";
+const WALLET_ART_WORD_COUNT = 24;
+let walletArtTemplateCache = null;
+function normalizeWalletArtTemplate(raw) {
+    const lines = raw.replaceAll("\r\n", "\n").split("\n");
+    if (lines[lines.length - 1] === "") {
+        lines.pop();
+    }
+    for (const line of lines) {
+        if (line.length !== WALLET_ART_WIDTH) {
+            throw new Error(`wallet_art_template_width_invalid_${line.length}`);
+        }
+    }
+    const template = lines.join("\n");
+    for (let index = 1; index <= WALLET_ART_WORD_COUNT; index += 1) {
+        if (!template.includes(`${index}.${WALLET_ART_PLACEHOLDER_WORD}`)) {
+            throw new Error(`wallet_art_template_placeholder_missing_${index}`);
+        }
+    }
+    return lines;
+}
+function loadWalletArtTemplate() {
+    if (walletArtTemplateCache !== null) {
+        return walletArtTemplateCache;
+    }
+    walletArtTemplateCache = normalizeWalletArtTemplate(readFileSync(new URL("../art/wallet.txt", import.meta.url), "utf8"));
+    return walletArtTemplateCache;
+}
+function formatWalletArtWord(word) {
+    const normalized = word ?? "";
+    if (normalized.length > WALLET_ART_SLOT_WIDTH) {
+        throw new Error(`wallet_art_word_too_wide_${normalized.length}`);
+    }
+    return normalized.padEnd(WALLET_ART_SLOT_WIDTH, " ");
+}
+export function renderWalletMnemonicRevealArt(words) {
+    const rendered = loadWalletArtTemplate().map((line) => {
+        let next = line;
+        for (let index = 0; index < WALLET_ART_WORD_COUNT; index += 1) {
+            next = next.replace(`${index + 1}.${WALLET_ART_PLACEHOLDER_WORD}`, `${index + 1}.${formatWalletArtWord(words[index])}`);
+        }
+        return next;
+    });
+    if (rendered.some((line) => line.includes(`.${WALLET_ART_PLACEHOLDER_WORD}`))) {
+        throw new Error("wallet_art_render_placeholder_unreplaced");
+    }
+    return rendered;
+}
+export function loadWalletArtTemplateForTesting() {
+    return [...loadWalletArtTemplate()];
+}

package/dist/wallet/reset.d.ts

@@ -0,0 +1,61 @@
+import { type WalletRuntimePaths } from "./runtime.js";
+import { type WalletSecretProvider } from "./state/provider.js";
+import type { WalletPrompter } from "./lifecycle.js";
+export type WalletResetAction = "not-present" | "kept-unchanged" | "reset-base-entropy" | "deleted";
+export type WalletResetSecretCleanupStatus = "deleted" | "not-found" | "failed" | "unknown";
+export type WalletResetSnapshotResultStatus = "not-present" | "invalid-removed" | "deleted" | "preserved";
+export interface WalletResetResult {
+    dataRoot: string;
+    factoryResetReady: true;
+    stoppedProcesses: {
+        managedBitcoind: number;
+        indexerDaemon: number;
+        backgroundMining: number;
+        survivors: number;
+    };
+    secretCleanupStatus: WalletResetSecretCleanupStatus;
+    deletedSecretRefs: string[];
+    failedSecretRefs: string[];
+    preservedSecretRefs: string[];
+    walletAction: WalletResetAction;
+    walletOldRootId: string | null;
+    walletNewRootId: string | null;
+    bootstrapSnapshot: {
+        status: WalletResetSnapshotResultStatus;
+        path: string;
+    };
+    removedPaths: string[];
+}
+export interface WalletResetPreview {
+    dataRoot: string;
+    confirmationPhrase: "permanently reset";
+    walletPrompt: null | {
+        defaultAction: "reset-base-entropy";
+        acceptedInputs: ["", "skip", "delete wallet"];
+        entropyRetainingResetAvailable: boolean;
+        requiresPassphrase: boolean;
+        envelopeSource: "primary" | "backup" | null;
+    };
+    bootstrapSnapshot: {
+        status: "not-present" | "invalid" | "valid";
+        path: string;
+        defaultAction: "preserve" | "delete";
+    };
+    trackedProcessKinds: Array<"managed-bitcoind" | "indexer-daemon" | "background-mining">;
+    willDeleteOsSecrets: boolean;
+    removedPaths: string[];
+}
+export declare function previewResetWallet(options: {
+    dataDir: string;
+    provider?: WalletSecretProvider;
+    paths?: WalletRuntimePaths;
+    validateSnapshotFile?: (path: string) => Promise<void>;
+}): Promise<WalletResetPreview>;
+export declare function resetWallet(options: {
+    dataDir: string;
+    provider?: WalletSecretProvider;
+    prompter: WalletPrompter;
+    nowUnixMs?: number;
+    paths?: WalletRuntimePaths;
+    validateSnapshotFile?: (path: string) => Promise<void>;
+}): Promise<WalletResetResult>;