paytaca-cli 0.1.0

package/dist/wallet/keys.js

@@ -0,0 +1,125 @@
+/**
+ * HD key derivation for Bitcoin Cash using libauth.
+ *
+ * Adapted from: paytaca-app/src/wallet/bch-libauth.js (LibauthHDWallet class)
+ *
+ * This is the modern derivation implementation that uses @bitauth/libauth
+ * and bip39 directly, without @psf/bch-js.
+ *
+ * Derivation path: m/44'/145'/0'  (BIP44, coin type 145 = BCH)
+ *   - Receiving addresses: m/44'/145'/0'/0/{index}
+ *   - Change addresses:    m/44'/145'/0'/1/{index}
+ */
+import { mnemonicToSeedSync } from 'bip39';
+import { binToHex, deriveHdPath, deriveHdPrivateNodeFromSeed, deriveHdPublicNode, encodePrivateKeyWif, sha256, } from '@bitauth/libauth';
+import { pubkeyToAddress, toTokenAddress } from '../utils/crypto.js';
+import { BCH_DERIVATION_PATH } from '../utils/network.js';
+export class LibauthHDWallet {
+    mnemonic;
+    derivationPath;
+    network;
+    walletHash;
+    /**
+     * @param mnemonic - BIP39 mnemonic phrase
+     * @param derivationPath - HD derivation path (default: m/44'/145'/0')
+     * @param network - 'mainnet' or 'chipnet'
+     */
+    constructor(mnemonic = '', derivationPath = BCH_DERIVATION_PATH, network = 'mainnet') {
+        this.mnemonic = mnemonic;
+        this.derivationPath = derivationPath;
+        this.network = network;
+        this.walletHash = this.getWalletHash();
+    }
+    get isChipnet() {
+        return this.network === 'chipnet';
+    }
+    set isChipnet(value) {
+        this.network = value ? 'chipnet' : 'mainnet';
+    }
+    /**
+     * Compute wallet hash: sha256(sha256(mnemonic) + sha256(derivationPath))
+     * Identical to paytaca-app's computeWalletHash() and BchWallet.getWalletHash()
+     */
+    getWalletHash() {
+        const customSha256 = (value) => binToHex(sha256.hash(Buffer.from(value, 'utf8')));
+        const mnemonicHash = customSha256(this.mnemonic);
+        const derivationPathHash = customSha256(this.derivationPath);
+        const walletHash = customSha256(mnemonicHash + derivationPathHash);
+        return walletHash;
+    }
+    /**
+     * Derive the main HD node at the derivation path.
+     * mnemonic → seed → master node → derive(path)
+     */
+    getMainNode() {
+        const mnemonicBin = new Uint8Array(mnemonicToSeedSync(this.mnemonic));
+        const node = deriveHdPrivateNodeFromSeed(mnemonicBin);
+        if (!('valid' in node) || !node.valid) {
+            throw new Error('Failed to derive valid HD node from seed');
+        }
+        const mainNode = deriveHdPath(node, this.derivationPath);
+        if (typeof mainNode === 'string')
+            throw new Error(mainNode);
+        if (!('privateKey' in mainNode)) {
+            throw new Error('Derivation produced a public node instead of private node');
+        }
+        return mainNode;
+    }
+    /**
+     * Derive an HD node at a relative sub-path from the main node.
+     * @param path - Relative path like '0/0' for receiving index 0
+     */
+    getNodeAt(path = '') {
+        if (!path?.startsWith('m/') && !path.startsWith('M/'))
+            path = 'm/' + path;
+        if (!path?.startsWith('m') && !path.startsWith('M'))
+            path = 'm' + path;
+        const mainNode = this.getMainNode();
+        const node = deriveHdPath(mainNode, path);
+        if (typeof node === 'string')
+            throw new Error(node);
+        if (!('privateKey' in node)) {
+            throw new Error('Derivation produced a public node instead of private node');
+        }
+        return node;
+    }
+    /**
+     * Get the WIF-encoded private key at a sub-path.
+     */
+    getPrivateKeyWifAt(path = '') {
+        const node = this.getNodeAt(path);
+        return encodePrivateKeyWif(node.privateKey, 'mainnet');
+    }
+    /**
+     * Get the compressed public key (hex) at a sub-path.
+     */
+    getPubkeyAt(path = '') {
+        const node = this.getNodeAt(path);
+        const publicNode = deriveHdPublicNode(node);
+        return binToHex(publicNode.publicKey);
+    }
+    /**
+     * Derive a CashAddress at a sub-path.
+     *
+     * @param opts.path - Sub-path like '0/0' (receiving) or '1/0' (change)
+     * @param opts.token - If true, return token-aware address (z-prefix)
+     */
+    getAddressAt(opts = {}) {
+        const pubkeyHex = this.getPubkeyAt(opts?.path);
+        const address = pubkeyToAddress(pubkeyHex, this.isChipnet);
+        if (opts?.token)
+            return toTokenAddress(address);
+        return address;
+    }
+    /**
+     * Derive receiving and change addresses at a given index.
+     * Convenience method matching BchWallet.getAddressSetAt() from paytaca-app.
+     */
+    getAddressSetAt(index) {
+        return {
+            receiving: this.getAddressAt({ path: `0/${index}` }),
+            change: this.getAddressAt({ path: `1/${index}` }),
+        };
+    }
+}
+//# sourceMappingURL=keys.js.map

package/dist/wallet/keys.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "paytaca-cli",
+  "version": "0.1.0",
+  "description": "Command-line interface for the Paytaca Bitcoin Cash wallet",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "paytaca": "./bin/paytaca.js"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node bin/paytaca.js",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "bitcoin-cash",
+    "bch",
+    "wallet",
+    "cli",
+    "paytaca",
+    "cryptocurrency"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/paytaca/paytaca-cli.git"
+  },
+  "author": "Paytaca",
+  "license": "SEE LICENSE IN LICENSE",
+  "dependencies": {
+    "@bitauth/libauth": "2.0.0-alpha.8",
+    "@napi-rs/keyring": "^1.2.0",
+    "bip39": "^3.1.0",
+    "chalk": "^5.4.1",
+    "commander": "^12.1.0",
+    "js-sha256": "^0.9.0",
+    "qrcode-terminal": "^0.12.0",
+    "watchtower-cash-js": "^0.2.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/qrcode-terminal": "^0.12.2",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}