nkamoto 1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nkamoto contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,95 @@
+# nkamoto
+
+A terminal Bitcoin wallet CLI built around BIP-39 and BIP-84.
+
+> **Security status:** development release. Do not use this implementation to store real BTC until it has been independently reviewed and audited.
+
+## Requirements
+
+- Node.js 20.19+.
+- npm.
+
+## Commands
+
+Running `nkamoto` without a command displays help.
+
+```text
+nkamoto
+nkamoto generate
+nkamoto validate
+nkamoto balance <bc1...>
+nkamoto --help
+nkamoto --version
+```
+
+### `nkamoto generate`
+
+Generates:
+
+- 256 bits of cryptographically secure entropy.
+- A 24-word BIP-39 English mnemonic.
+- A separately generated 12-word BIP-39 passphrase.
+- A Bitcoin mainnet BIP-84 native SegWit address.
+- Terminal QR codes for the mnemonic and passphrase.
+
+Derivation path:
+
+```text
+m/84'/0'/0'/0/0
+```
+
+### `nkamoto validate`
+
+Reads the mnemonic interactively rather than accepting it as a command-line argument, reducing the chance of shell-history leakage.
+
+```text
+nkamoto validate
+```
+
+It validates the BIP-39 checksum, accepts the optional BIP-39 passphrase interactively, and derives the first BIP-84 address.
+
+### `nkamoto balance`
+
+Checks a public Bitcoin address using the Blockstream Esplora API.
+
+```text
+nkamoto balance bc1q...
+```
+
+Only the public address is sent to the balance service. The command does not accept or require a mnemonic or private key.
+
+The provider is isolated behind `BitcoinBalanceProvider` so a self-hosted or alternative backend can be added later.
+
+## Development
+
+```bash
+npm install
+npm run lint
+npm test
+npm run build
+npm start
+```
+
+For direct development:
+
+```bash
+npm run dev
+```
+
+## Security
+
+The mnemonic and BIP-39 passphrase are recovery secrets.
+
+Do not:
+
+- put them in shell arguments;
+- paste them into websites or chat;
+- commit them to source control;
+- redirect wallet-generation output to files;
+- use generated wallets with real funds before independent security review.
+
+The public API intentionally does not return the derived BIP-39 seed.
+
+## License
+
+MIT

package/dist/balance.d.ts

@@ -0,0 +1,16 @@
+export interface BitcoinBalance {
+    readonly address: string;
+    readonly confirmedSatoshis: bigint;
+    readonly unconfirmedSatoshis: bigint;
+    readonly totalSatoshis: bigint;
+}
+export interface BitcoinBalanceProvider {
+    getBalance(address: string): Promise<BitcoinBalance>;
+}
+export declare class EsploraBalanceProvider implements BitcoinBalanceProvider {
+    private readonly baseUrl;
+    constructor(baseUrl?: string);
+    getBalance(address: string): Promise<BitcoinBalance>;
+}
+export declare function isBitcoinAddress(address: string): boolean;
+export declare function satoshisToBtc(satoshis: bigint): string;

package/dist/balance.js

@@ -0,0 +1,71 @@
+export class EsploraBalanceProvider {
+    baseUrl;
+    constructor(baseUrl = "https://blockstream.info/api") {
+        this.baseUrl = baseUrl;
+    }
+    async getBalance(address) {
+        if (!isBitcoinAddress(address)) {
+            throw new Error("Invalid Bitcoin address");
+        }
+        const response = await fetch(`${this.baseUrl.replace(/\/$/, "")}/address/${encodeURIComponent(address)}`, {
+            headers: {
+                accept: "application/json",
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Bitcoin balance request failed with HTTP ${response.status}`);
+        }
+        const data = await response.json();
+        const stats = parseAddressStats(data);
+        const confirmedSatoshis = stats.chainStats.funded - stats.chainStats.spent;
+        const unconfirmedSatoshis = stats.mempoolStats.funded - stats.mempoolStats.spent;
+        return {
+            address,
+            confirmedSatoshis,
+            unconfirmedSatoshis,
+            totalSatoshis: confirmedSatoshis + unconfirmedSatoshis,
+        };
+    }
+}
+function parseAddressStats(value) {
+    if (!isRecord(value)) {
+        throw new Error("Invalid Bitcoin API response");
+    }
+    const chainStats = parseStats(value.chain_stats);
+    const mempoolStats = parseStats(value.mempool_stats);
+    return { chainStats, mempoolStats };
+}
+function parseStats(value) {
+    if (!isRecord(value)) {
+        throw new Error("Invalid Bitcoin API response");
+    }
+    return {
+        funded: parseNonNegativeInteger(value.funded_txo_sum),
+        spent: parseNonNegativeInteger(value.spent_txo_sum),
+    };
+}
+function parseNonNegativeInteger(value) {
+    if (typeof value !== "number" && typeof value !== "string") {
+        throw new Error("Invalid Bitcoin API response");
+    }
+    const text = String(value);
+    if (!/^\d+$/.test(text)) {
+        throw new Error("Invalid Bitcoin API response");
+    }
+    return BigInt(text);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+export function isBitcoinAddress(address) {
+    return /^bc1[ac-hj-np-z02-9]{11,87}$/.test(address);
+}
+export function satoshisToBtc(satoshis) {
+    const whole = satoshis / 100000000n;
+    const fraction = (satoshis % 100000000n)
+        .toString()
+        .padStart(8, "0")
+        .replace(/0+$/, "");
+    return fraction ? `${whole}.${fraction}` : `${whole}.00000000`;
+}
+//# sourceMappingURL=balance.js.map

package/dist/balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.js","sourceRoot":"","sources":["../src/balance.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { EsploraBalanceProvider, isBitcoinAddress, satoshisToBtc, } from "./balance.js";
+import { renderQr } from "./qr.js";
+import { BIP84_PATH, deriveBitcoinAddress, generateWallet, validateMnemonic, } from "./index.js";
+const VERSION = "0.2.0";
+const HELP = `NKAMOTO — Bitcoin wallet CLI
+
+Usage:
+  nkamoto <command>
+
+Commands:
+  generate    Generate a new Bitcoin wallet
+  qr          Generate a new wallet with qr code
+  validate    Validate a BIP-39 mnemonic
+  balance     Check a Bitcoin address balance
+
+Options:
+  -h, --help      Show help
+  -v, --version   Show version
+
+Examples:
+  nkamoto generate
+  nkamoto validate
+  nkamoto balance bc1q...
+
+Security:
+  Never share your BIP-39 mnemonic or passphrase.
+  Never put recovery secrets in shell arguments.
+`;
+function printHelp() {
+    console.log(HELP);
+}
+function printVersion() {
+    console.log(`nkamoto ${VERSION}`);
+}
+async function runGenerate(qr_included) {
+    const wallet = generateWallet();
+    console.log("");
+    console.log("========================================");
+    console.log("           NKAMOTO BTC WALLET");
+    console.log("========================================");
+    console.log("");
+    console.log("Network:         Bitcoin Mainnet");
+    console.log("Standard:        BIP-39");
+    console.log("Address type:    BIP-84 / P2WPKH");
+    console.log(`Derivation path: ${BIP84_PATH}`);
+    console.log("");
+    if (qr_included) {
+        await printQr("BIP-39 MNEMONIC QR", wallet.mnemonic);
+        await printQr("BIP-39 PASSPHRASE QR", wallet.passphrase);
+    }
+    console.log("Bitcoin address:");
+    console.log(wallet.address);
+    console.log("");
+    console.log("WARNING");
+    console.log("-------");
+    console.log("Your mnemonic and passphrase control this wallet.");
+    console.log("Never share them with anyone.");
+    console.log("Store recovery information offline.");
+    console.log("");
+}
+async function runValidate() {
+    const rl = createInterface({ input, output });
+    try {
+        const mnemonic = await rl.question("Enter BIP-39 mnemonic: ");
+        if (!validateMnemonic(mnemonic.trim())) {
+            console.error("Invalid BIP-39 mnemonic.");
+            process.exitCode = 1;
+            return;
+        }
+        const passphrase = await rl.question("Enter BIP-39 passphrase (leave empty if none): ");
+        const address = deriveBitcoinAddress(mnemonic.trim(), passphrase);
+        console.log("");
+        console.log("Valid BIP-39 mnemonic.");
+        console.log(`BIP-84 address: ${address}`);
+        console.log("");
+    }
+    finally {
+        rl.close();
+    }
+}
+async function runBalance(address) {
+    if (!address || !isBitcoinAddress(address)) {
+        throw new Error("Usage: nkamoto balance <bc1... Bitcoin address>");
+    }
+    const provider = new EsploraBalanceProvider();
+    const balance = await provider.getBalance(address);
+    console.log("");
+    console.log(`Address:     ${balance.address}`);
+    console.log(`Confirmed:   ${satoshisToBtc(balance.confirmedSatoshis)} BTC`);
+    console.log(`Unconfirmed: ${satoshisToBtc(balance.unconfirmedSatoshis)} BTC`);
+    console.log(`Total:       ${satoshisToBtc(balance.totalSatoshis)} BTC`);
+    console.log("");
+}
+async function printQr(label, value) {
+    console.log("");
+    console.log(label);
+    console.log("");
+    console.log(await renderQr(value));
+}
+async function main(argv) {
+    const [command, ...args] = argv;
+    if (!command || command === "--help" || command === "-h" || command === "help") {
+        printHelp();
+        return;
+    }
+    if (command === "--version" || command === "-v" || command === "version") {
+        printVersion();
+        return;
+    }
+    switch (command) {
+        case "qr":
+            if (args.length > 0) {
+                throw new Error("qr does not accept arguments");
+            }
+            await runGenerate(true);
+            return;
+        case "generate":
+            if (args.length > 0) {
+                throw new Error("generate does not accept arguments");
+            }
+            await runGenerate(false);
+            return;
+        case "validate":
+            if (args.length > 0) {
+                throw new Error("validate reads the mnemonic interactively; do not pass secrets as arguments");
+            }
+            await runValidate();
+            return;
+        case "balance":
+            await runBalance(args[0]);
+            return;
+        default:
+            printHelp();
+            throw new Error(`Unknown command: ${command}`);
+    }
+}
+main(process.argv.slice(2)).catch((error) => {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    console.error(`nkamoto: ${message}`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { BIP84_PATH, deriveBitcoinAddress, mnemonicToSeed, validateMnemonic, } from "./wallet/derive.js";
+export { generateMnemonic, generateWallet, } from "./wallet/generate.js";
+export type { BitcoinWallet, } from "./wallet/generate.js";
+export { generatePassphrase, } from "./wallet/passphrase.js";
+export type { RandomWordSource, } from "./wallet/passphrase.js";
+export { renderQr, } from "./qr.js";
+export type { QrOptions, } from "./qr.js";
+export { EsploraBalanceProvider, isBitcoinAddress, satoshisToBtc, } from "./balance.js";
+export type { BitcoinBalance, BitcoinBalanceProvider, } from "./balance.js";

package/dist/index.js

@@ -0,0 +1,6 @@
+export { BIP84_PATH, deriveBitcoinAddress, mnemonicToSeed, validateMnemonic, } from "./wallet/derive.js";
+export { generateMnemonic, generateWallet, } from "./wallet/generate.js";
+export { generatePassphrase, } from "./wallet/passphrase.js";
+export { renderQr, } from "./qr.js";
+export { EsploraBalanceProvider, isBitcoinAddress, satoshisToBtc, } from "./balance.js";
+//# 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,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EACL,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EACL,QAAQ,GACT,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,GACd,MAAM,cAAc,CAAC"}

package/dist/qr.d.ts

@@ -0,0 +1,5 @@
+export interface QrOptions {
+    readonly errorCorrectionLevel?: "L" | "M" | "Q" | "H";
+    readonly margin?: number;
+}
+export declare function renderQr(value: string, options?: QrOptions): Promise<string>;

package/dist/qr.js

@@ -0,0 +1,9 @@
+import QRCode from "qrcode";
+export async function renderQr(value, options = {}) {
+    return QRCode.toString(value, {
+        type: "terminal",
+        errorCorrectionLevel: options.errorCorrectionLevel ?? "M",
+        margin: options.margin ?? 2,
+    });
+}
+//# sourceMappingURL=qr.js.map

package/dist/qr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr.js","sourceRoot":"","sources":["../src/qr.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAO5B,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAa,EACb,UAAqB,EAAE;IAEvB,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE;QAC5B,IAAI,EAAE,UAAU;QAChB,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,IAAI,GAAG;QACzD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC;KAC5B,CAAC,CAAC;AACL,CAAC"}

package/dist/wallet/derive.d.ts

@@ -0,0 +1,4 @@
+export declare const BIP84_PATH = "m/84'/0'/0'/0/0";
+export declare function validateMnemonic(mnemonic: string): boolean;
+export declare function mnemonicToSeed(mnemonic: string, passphrase: string): Uint8Array;
+export declare function deriveBitcoinAddress(mnemonic: string, passphrase: string): string;

package/dist/wallet/derive.js

@@ -0,0 +1,28 @@
+import * as bip32 from "@scure/bip32";
+import * as bip39 from "@scure/bip39";
+import { wordlist } from "@scure/bip39/wordlists/english.js";
+import * as btc from "@scure/btc-signer";
+export const BIP84_PATH = "m/84'/0'/0'/0/0";
+export function validateMnemonic(mnemonic) {
+    return bip39.validateMnemonic(mnemonic, wordlist);
+}
+export function mnemonicToSeed(mnemonic, passphrase) {
+    if (!validateMnemonic(mnemonic)) {
+        throw new Error("Invalid BIP-39 mnemonic");
+    }
+    return bip39.mnemonicToSeedSync(mnemonic, passphrase);
+}
+export function deriveBitcoinAddress(mnemonic, passphrase) {
+    const seed = mnemonicToSeed(mnemonic, passphrase);
+    const root = bip32.HDKey.fromMasterSeed(seed);
+    const child = root.derive(BIP84_PATH);
+    if (!child.publicKey) {
+        throw new Error("Failed to derive BIP-84 public key");
+    }
+    const payment = btc.p2wpkh(child.publicKey);
+    if (!payment.address) {
+        throw new Error("Failed to derive Bitcoin address");
+    }
+    return payment.address;
+}
+//# sourceMappingURL=derive.js.map

package/dist/wallet/derive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.js","sourceRoot":"","sources":["../../src/wallet/derive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,KAAK,GAAG,MAAM,mBAAmB,CAAC;AAEzC,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,CAAC;AAE5C,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,UAAkB;IAElB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,KAAK,CAAC,kBAAkB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,UAAkB;IAElB,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAEtC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAE5C,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,CAAC;AACzB,CAAC"}

package/dist/wallet/generate.d.ts

@@ -0,0 +1,9 @@
+import { BIP84_PATH } from "./derive.js";
+export interface BitcoinWallet {
+    readonly mnemonic: string;
+    readonly passphrase: string;
+    readonly derivationPath: typeof BIP84_PATH;
+    readonly address: string;
+}
+export declare function generateMnemonic(entropy?: Uint8Array): string;
+export declare function generateWallet(): BitcoinWallet;

package/dist/wallet/generate.js

@@ -0,0 +1,26 @@
+import { randomBytes } from "node:crypto";
+import * as bip39 from "@scure/bip39";
+import { wordlist } from "@scure/bip39/wordlists/english.js";
+import { BIP84_PATH, deriveBitcoinAddress } from "./derive.js";
+import { generatePassphrase } from "./passphrase.js";
+const ENTROPY_BYTES = 32;
+function generateEntropy() {
+    return new Uint8Array(randomBytes(ENTROPY_BYTES));
+}
+export function generateMnemonic(entropy = generateEntropy()) {
+    if (entropy.length !== ENTROPY_BYTES) {
+        throw new RangeError("Entropy must contain exactly 32 bytes");
+    }
+    return bip39.entropyToMnemonic(entropy, wordlist);
+}
+export function generateWallet() {
+    const mnemonic = generateMnemonic();
+    const passphrase = generatePassphrase();
+    return {
+        mnemonic,
+        passphrase,
+        derivationPath: BIP84_PATH,
+        address: deriveBitcoinAddress(mnemonic, passphrase),
+    };
+}
+//# sourceMappingURL=generate.js.map

package/dist/wallet/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/wallet/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,aAAa,GAAG,EAAE,CAAC;AASzB,SAAS,eAAe;IACtB,OAAO,IAAI,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,UAAsB,eAAe,EAAE;IAEvC,IAAI,OAAO,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QACrC,MAAM,IAAI,UAAU,CAAC,uCAAuC,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,KAAK,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,MAAM,UAAU,GAAG,kBAAkB,EAAE,CAAC;IAExC,OAAO;QACL,QAAQ;QACR,UAAU;QACV,cAAc,EAAE,UAAU;QAC1B,OAAO,EAAE,oBAAoB,CAAC,QAAQ,EAAE,UAAU,CAAC;KACpD,CAAC;AACJ,CAAC"}

package/dist/wallet/passphrase.d.ts

@@ -0,0 +1,4 @@
+export interface RandomWordSource {
+    next(maxExclusive: number): number;
+}
+export declare function generatePassphrase(wordCount?: number, random?: RandomWordSource): string;

package/dist/wallet/passphrase.js

@@ -0,0 +1,22 @@
+import { randomInt } from "node:crypto";
+import { wordlist } from "@scure/bip39/wordlists/english.js";
+const DEFAULT_WORD_COUNT = 12;
+const cryptoWordSource = {
+    next(maxExclusive) {
+        return randomInt(0, maxExclusive);
+    },
+};
+export function generatePassphrase(wordCount = DEFAULT_WORD_COUNT, random = cryptoWordSource) {
+    if (!Number.isInteger(wordCount) || wordCount < 1) {
+        throw new RangeError("wordCount must be a positive integer");
+    }
+    const words = Array.from({ length: wordCount }, () => {
+        const index = random.next(wordlist.length);
+        if (!Number.isInteger(index) || index < 0 || index >= wordlist.length) {
+            throw new Error("Random source returned an invalid word index");
+        }
+        return wordlist[index];
+    });
+    return words.join(" ");
+}
+//# sourceMappingURL=passphrase.js.map

package/dist/wallet/passphrase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passphrase.js","sourceRoot":"","sources":["../../src/wallet/passphrase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAM9B,MAAM,gBAAgB,GAAqB;IACzC,IAAI,CAAC,YAAoB;QACvB,OAAO,SAAS,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IACpC,CAAC;CACF,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAChC,SAAS,GAAG,kBAAkB,EAC9B,SAA2B,gBAAgB;IAE3C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,UAAU,CAAC,sCAAsC,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE;QACnD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAE3C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "nkamoto",
+  "version": "1.2.0",
+  "description": "NKAMOTO is a security-focused Bitcoin wallet CLI for generating BIP-39 wallets, managing Bitcoin keys, addresses, and QR codes from the terminal.",
+  "type": "module",
+
+  "bin": {
+    "nkamoto": "dist/cli.js"
+  },
+
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+
+  "engines": {
+    "node": ">=20.19.0"
+  },
+
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Coperbyte/nkamoto.app.git"
+  },
+
+  "homepage": "https://nkamoto.app",
+
+  "bugs": {
+    "url": "https://github.com/Coperbyte/nkamoto.app/issues"
+  },
+
+  "license": "MIT",
+
+  "publishConfig": {
+    "access": "public"
+  }
+}