paytaca-cli 0.1.0

package/dist/utils/network.js

@@ -0,0 +1,45 @@
+/**
+ * Network configuration and address conversion helpers.
+ *
+ * Adapted from: paytaca-app/src/wallet/chipnet.js
+ *
+ * Stripped of Vuex store dependency — uses explicit `isChipnet` parameter.
+ */
+import { CashAddressNetworkPrefix, CashAddressType, encodeCashAddress, decodeCashAddress, } from '@bitauth/libauth';
+/** BCH derivation path (BIP44 coin type 145) */
+export const BCH_DERIVATION_PATH = "m/44'/145'/0'";
+/** Watchtower project IDs (from environment or defaults) */
+export const projectId = {
+    mainnet: process.env.WATCHTOWER_PROJECT_ID || '',
+    chipnet: process.env.WATCHTOWER_CHIP_PROJECT_ID || '',
+};
+export function getWatchtowerApiUrl(isChipnet) {
+    if (isChipnet)
+        return 'https://chipnet.watchtower.cash/api';
+    return 'https://watchtower.cash/api';
+}
+export function getWatchtowerWebsocketUrl(isChipnet) {
+    if (isChipnet)
+        return 'wss://chipnet.watchtower.cash/ws';
+    return 'wss://watchtower.cash/ws';
+}
+/**
+ * Convert a CashAddress between mainnet/testnet and regular/token types.
+ *
+ * Adapted from paytaca-app/src/wallet/chipnet.js convertCashAddress().
+ */
+export function convertCashAddress(address, toTestNet = true, toTokenAddress = true) {
+    const decodedAddress = decodeCashAddress(address);
+    if (typeof decodedAddress === 'string')
+        throw new Error(decodedAddress);
+    const prefix = toTestNet ? CashAddressNetworkPrefix.testnet : CashAddressNetworkPrefix.mainnet;
+    const addressType = toTokenAddress ? CashAddressType.p2pkhWithTokens : CashAddressType.p2pkh;
+    return encodeCashAddress(prefix, addressType, decodedAddress.payload);
+}
+/**
+ * Get the CashAddress prefix for the given network.
+ */
+export function getAddressPrefix(isChipnet) {
+    return isChipnet ? 'bchtest' : 'bitcoincash';
+}
+//# sourceMappingURL=network.js.map

package/dist/utils/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/utils/network.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,kBAAkB,CAAA;AAEzB,gDAAgD;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAA;AAElD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE;IAChD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,EAAE;CACtD,CAAA;AAED,MAAM,UAAU,mBAAmB,CAAC,SAAkB;IACpD,IAAI,SAAS;QAAE,OAAO,qCAAqC,CAAA;IAC3D,OAAO,6BAA6B,CAAA;AACtC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,SAAkB;IAC1D,IAAI,SAAS;QAAE,OAAO,kCAAkC,CAAA;IACxD,OAAO,0BAA0B,CAAA;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,YAAqB,IAAI,EACzB,iBAA0B,IAAI;IAE9B,MAAM,cAAc,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IACjD,IAAI,OAAO,cAAc,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAA;IACvE,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC,OAAO,CAAA;IAC9F,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAA;IAC5F,OAAO,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC,OAAO,CAAC,CAAA;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAkB;IACjD,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAA;AAC9C,CAAC"}

package/dist/wallet/bch.d.ts

@@ -0,0 +1,137 @@
+/**
+ * BCH wallet operations: balance, address derivation, sending.
+ *
+ * Adapted from: paytaca-app/src/wallet/bch.js (BchWallet class)
+ *
+ * Key differences from paytaca-app:
+ *   - Uses LibauthHDWallet for address derivation instead of @psf/bch-js
+ *   - Transaction building/signing/broadcasting delegated to watchtower-cash-js
+ *     (identical to paytaca-app)
+ *   - Stripped: SLP, POS, fiat tracking, WalletConnect
+ */
+import Watchtower from 'watchtower-cash-js';
+export interface Recipient {
+    address: string;
+    amount: number;
+    tokenAmount?: number;
+}
+export interface SendResult {
+    success: boolean;
+    txid?: string;
+    transaction?: string;
+    error?: string;
+    lackingSats?: bigint;
+}
+export declare class BchWallet {
+    isChipnet: boolean;
+    mnemonic: string;
+    derivationPath: string;
+    watchtower: InstanceType<typeof Watchtower>;
+    projectId: string;
+    walletHash: string;
+    baseUrl: string;
+    private hdWallet;
+    constructor(projectId: string, mnemonic: string, path: string, isChipnet?: boolean);
+    /**
+     * Derive receiving and change addresses at a given index.
+     * Adapted from paytaca-app BchWallet.getAddressSetAt()
+     */
+    getAddressSetAt(index: number): {
+        receiving: string;
+        change: string;
+    };
+    /**
+     * Subscribe a new address set with Watchtower for monitoring.
+     * Adapted from paytaca-app BchWallet.getNewAddressSet()
+     */
+    getNewAddressSet(index: number): Promise<{
+        addresses: {
+            receiving: string;
+            change: string;
+        };
+    } | null>;
+    /**
+     * Get the last used address index from Watchtower.
+     */
+    getLastAddressIndex(opts?: {
+        with_tx?: boolean;
+        exclude_pos?: boolean;
+    }): Promise<number | undefined>;
+    /**
+     * Get wallet balance from Watchtower.
+     * Adapted from paytaca-app BchWallet.getBalance()
+     */
+    getBalance(): Promise<{
+        valid: boolean;
+        wallet: string;
+        spendable: number;
+        balance: number;
+    }>;
+    /**
+     * Get transaction history from Watchtower.
+     * Adapted from paytaca-app BchWallet.getTransactions()
+     */
+    getHistory(opts?: {
+        page?: number;
+        recordType?: string;
+    }): Promise<{
+        history: {
+            record_type: 'outgoing' | 'incoming';
+            txid: string;
+            amount: number;
+            tx_fee: number;
+            senders: any[][];
+            recipients: any[][];
+            date_created: string;
+            tx_timestamp: string;
+            usd_price: number;
+            market_prices: Record<string, number>;
+            attributes: any;
+        }[];
+        page: string;
+        num_pages: number;
+        has_next: boolean;
+    }>;
+    /**
+     * Send BCH to one or more recipients.
+     *
+     * Adapted from paytaca-app BchWallet.sendBch() and _sendBch().
+     * The actual transaction building, signing, and broadcasting is handled
+     * entirely by watchtower-cash-js BCH.send() — identical to paytaca-app.
+     *
+     * @param amount - Amount in BCH (e.g. 0.001)
+     * @param address - Recipient CashAddress
+     * @param changeAddress - Change address (optional, derived if not provided)
+     * @param recipients - Array of recipients for multi-send (overrides amount/address)
+     */
+    sendBch(amount: number, address: string, changeAddress?: string, recipients?: Recipient[]): Promise<SendResult>;
+    /**
+     * Internal send implementation.
+     * Passes data to watchtower-cash-js BCH.send() which handles:
+     *   1. UTXO fetching from Watchtower API
+     *   2. Transaction building with libauth
+     *   3. Signing with derived private keys
+     *   4. Broadcasting to the network
+     *
+     * The data format is identical to what paytaca-app passes.
+     */
+    private _sendBch;
+    /**
+     * Trigger a UTXO scan on the Watchtower backend.
+     */
+    scanUtxos(opts?: {
+        background?: boolean;
+    }): Promise<any>;
+    /**
+     * Bulk-subscribe a range of addresses to Watchtower.
+     * Adapted from paytaca-app BchWallet.scanAddresses()
+     */
+    scanAddresses(opts: {
+        startIndex: number;
+        count: number;
+    }): Promise<{
+        success: boolean;
+        error: string;
+    }>;
+}
+//# sourceMappingURL=bch.d.ts.map

package/dist/wallet/bch.d.ts.map

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

package/dist/wallet/bch.js

@@ -0,0 +1,197 @@
+/**
+ * BCH wallet operations: balance, address derivation, sending.
+ *
+ * Adapted from: paytaca-app/src/wallet/bch.js (BchWallet class)
+ *
+ * Key differences from paytaca-app:
+ *   - Uses LibauthHDWallet for address derivation instead of @psf/bch-js
+ *   - Transaction building/signing/broadcasting delegated to watchtower-cash-js
+ *     (identical to paytaca-app)
+ *   - Stripped: SLP, POS, fiat tracking, WalletConnect
+ */
+import Watchtower from 'watchtower-cash-js';
+import { LibauthHDWallet } from './keys.js';
+import { getWatchtowerApiUrl } from '../utils/network.js';
+export class BchWallet {
+    isChipnet;
+    mnemonic;
+    derivationPath;
+    watchtower;
+    projectId;
+    walletHash;
+    baseUrl;
+    hdWallet;
+    constructor(projectId, mnemonic, path, isChipnet = false) {
+        this.isChipnet = isChipnet;
+        this.mnemonic = mnemonic;
+        this.derivationPath = path;
+        this.watchtower = new Watchtower(isChipnet);
+        this.projectId = projectId;
+        this.baseUrl = getWatchtowerApiUrl(isChipnet);
+        // Use LibauthHDWallet for address derivation (replaces @psf/bch-js HDNode)
+        this.hdWallet = new LibauthHDWallet(mnemonic, path, isChipnet ? 'chipnet' : 'mainnet');
+        this.walletHash = this.hdWallet.walletHash;
+    }
+    /**
+     * Derive receiving and change addresses at a given index.
+     * Adapted from paytaca-app BchWallet.getAddressSetAt()
+     */
+    getAddressSetAt(index) {
+        return this.hdWallet.getAddressSetAt(index);
+    }
+    /**
+     * Subscribe a new address set with Watchtower for monitoring.
+     * Adapted from paytaca-app BchWallet.getNewAddressSet()
+     */
+    async getNewAddressSet(index) {
+        const addresses = this.getAddressSetAt(index);
+        const data = {
+            address: undefined,
+            addresses: { receiving: addresses.receiving, change: addresses.change },
+            projectId: this.projectId,
+            walletHash: this.walletHash,
+            walletIndex: undefined,
+            addressIndex: index,
+            webhookUrl: undefined,
+            chatIdentity: undefined,
+        };
+        const result = await this.watchtower.subscribe(data);
+        if (result.success) {
+            return { addresses };
+        }
+        return null;
+    }
+    /**
+     * Get the last used address index from Watchtower.
+     */
+    async getLastAddressIndex(opts) {
+        const _params = {
+            with_tx: opts?.with_tx || false,
+            exclude_pos: opts?.exclude_pos || false,
+        };
+        const apiResponse = await this.watchtower.BCH._api.get(`last-address-index/wallet/${this.walletHash}/`, { params: _params });
+        if (Number.isInteger(apiResponse?.data?.address?.address_index)) {
+            return apiResponse.data.address.address_index;
+        }
+        return undefined;
+    }
+    /**
+     * Get wallet balance from Watchtower.
+     * Adapted from paytaca-app BchWallet.getBalance()
+     */
+    async getBalance() {
+        const walletHash = this.walletHash;
+        return this.watchtower.Wallet.getBalance({ walletHash });
+    }
+    /**
+     * Get transaction history from Watchtower.
+     * Adapted from paytaca-app BchWallet.getTransactions()
+     */
+    async getHistory(opts) {
+        const walletHash = this.walletHash;
+        return this.watchtower.Wallet.getHistory({
+            walletHash,
+            tokenId: '',
+            page: opts?.page ?? 1,
+            recordType: opts?.recordType ?? 'all',
+            txSearchReference: '',
+        });
+    }
+    /**
+     * Send BCH to one or more recipients.
+     *
+     * Adapted from paytaca-app BchWallet.sendBch() and _sendBch().
+     * The actual transaction building, signing, and broadcasting is handled
+     * entirely by watchtower-cash-js BCH.send() — identical to paytaca-app.
+     *
+     * @param amount - Amount in BCH (e.g. 0.001)
+     * @param address - Recipient CashAddress
+     * @param changeAddress - Change address (optional, derived if not provided)
+     * @param recipients - Array of recipients for multi-send (overrides amount/address)
+     */
+    async sendBch(amount, address, changeAddress, recipients = []) {
+        const finalRecipients = [];
+        if (recipients.length > 0) {
+            finalRecipients.push(...recipients);
+        }
+        else {
+            finalRecipients.push({ address, amount });
+        }
+        return this._sendBch(changeAddress, finalRecipients);
+    }
+    /**
+     * Internal send implementation.
+     * Passes data to watchtower-cash-js BCH.send() which handles:
+     *   1. UTXO fetching from Watchtower API
+     *   2. Transaction building with libauth
+     *   3. Signing with derived private keys
+     *   4. Broadcasting to the network
+     *
+     * The data format is identical to what paytaca-app passes.
+     */
+    async _sendBch(changeAddress, recipients, broadcast = true) {
+        const data = {
+            sender: {
+                walletHash: this.walletHash,
+                mnemonic: this.mnemonic,
+                derivationPath: this.derivationPath,
+            },
+            recipients,
+            changeAddress,
+            wallet: {
+                mnemonic: this.mnemonic,
+                derivationPath: this.derivationPath,
+            },
+            broadcast,
+        };
+        const result = await this.watchtower.BCH.send(data);
+        return result;
+    }
+    /**
+     * Trigger a UTXO scan on the Watchtower backend.
+     */
+    async scanUtxos(opts) {
+        const queryParams = {};
+        if (opts?.background)
+            queryParams.background = true;
+        return this.watchtower.BCH._api.get(`utxo/wallet/${this.walletHash}/scan/`, { params: queryParams });
+    }
+    /**
+     * Bulk-subscribe a range of addresses to Watchtower.
+     * Adapted from paytaca-app BchWallet.scanAddresses()
+     */
+    async scanAddresses(opts) {
+        const response = {
+            success: false,
+            error: '',
+        };
+        if (!Number.isSafeInteger(opts?.startIndex)) {
+            response.error = 'Invalid start index';
+            return response;
+        }
+        if (!Number.isSafeInteger(opts?.count)) {
+            response.error = 'Invalid count';
+            return response;
+        }
+        const endIndex = opts.startIndex + opts.count;
+        const addressSets = [];
+        for (let i = opts.startIndex; i < endIndex; i++) {
+            const addresses = this.getAddressSetAt(i);
+            addressSets.push({ address_index: i, addresses });
+        }
+        const data = {
+            address_sets: addressSets,
+            wallet_hash: this.walletHash,
+            project_id: this.projectId,
+        };
+        try {
+            await this.watchtower.BCH._api.post('wallet/address-scan/', data);
+            response.success = true;
+        }
+        catch (error) {
+            response.error = error?.message || 'Address scan failed';
+        }
+        return response;
+    }
+}
+//# sourceMappingURL=bch.js.map

package/dist/wallet/bch.js.map

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

package/dist/wallet/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Wallet management: mnemonic generation, storage, wallet loading.
+ *
+ * Adapted from: paytaca-app/src/wallet/index.js
+ *
+ * Key differences:
+ *   - Uses @napi-rs/keyring (OS keychain) instead of Capacitor SecureStoragePlugin
+ *   - Uses bip39 directly for mnemonic generation instead of @psf/bch-js
+ *   - No SLP wallet
+ *   - No migration logic (fresh CLI, no legacy key schemes)
+ *   - computeWalletHash() is identical to paytaca-app
+ */
+import { BchWallet } from './bch.js';
+/**
+ * Compute wallet hash from mnemonic and derivation path.
+ * walletHash = sha256(sha256(mnemonic) + sha256(derivationPath))
+ *
+ * Identical to paytaca-app's computeWalletHash() in src/wallet/index.js
+ * and BchWallet.getWalletHash() in src/wallet/bch.js
+ */
+export declare function computeWalletHash(mnemonic: string, derivationPath?: string): string;
+/**
+ * Generate a new 12-word BIP39 mnemonic, store it in the OS keychain,
+ * and set it as the active wallet.
+ *
+ * Adapted from paytaca-app generateMnemonic() — stripped of
+ * Capacitor SecureStoragePlugin and old key-scheme migration.
+ */
+export declare function generateMnemonic(): {
+    mnemonic: string;
+    walletHash: string;
+};
+/**
+ * Import an existing mnemonic, validate it, store in keychain,
+ * and set as active wallet.
+ */
+export declare function importMnemonic(mnemonic: string): {
+    mnemonic: string;
+    walletHash: string;
+};
+/**
+ * Load the active wallet's mnemonic from keychain.
+ * Returns null if no active wallet is set or mnemonic is missing.
+ */
+export declare function loadMnemonic(): {
+    mnemonic: string;
+    walletHash: string;
+} | null;
+/**
+ * High-level wallet class that provides access to BCH sub-wallets.
+ *
+ * Adapted from paytaca-app's Wallet class in src/wallet/index.js.
+ * Stripped of SLP — only BCH mainnet and chipnet.
+ */
+export declare class Wallet {
+    mnemonic: string;
+    private _BCH;
+    private _BCH_CHIP;
+    constructor(mnemonic: string);
+    /** Main BCH wallet (mainnet) */
+    get BCH(): BchWallet;
+    /** Chipnet BCH wallet (testnet) */
+    get BCH_CHIP(): BchWallet;
+    /** Get the appropriate sub-wallet for the given network */
+    forNetwork(isChipnet: boolean): BchWallet;
+}
+/**
+ * Load a Wallet instance from the keychain.
+ * Returns null if no active wallet exists.
+ */
+export declare function loadWallet(): Wallet | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/wallet/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wallet/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAGpC;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,MAA4B,GAC3C,MAAM,CAWR;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAQ3E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG;IAChD,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB,CAWA;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,IAAI,CAQP;AAED;;;;;GAKG;AACH,qBAAa,MAAM;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,SAAS,CAAyB;gBAE9B,QAAQ,EAAE,MAAM;IAI5B,gCAAgC;IAChC,IAAI,GAAG,IAAI,SAAS,CAUnB;IAED,mCAAmC;IACnC,IAAI,QAAQ,IAAI,SAAS,CAUxB;IAED,2DAA2D;IAC3D,UAAU,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS;CAG1C;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAI1C"}

package/dist/wallet/index.js

@@ -0,0 +1,120 @@
+/**
+ * Wallet management: mnemonic generation, storage, wallet loading.
+ *
+ * Adapted from: paytaca-app/src/wallet/index.js
+ *
+ * Key differences:
+ *   - Uses @napi-rs/keyring (OS keychain) instead of Capacitor SecureStoragePlugin
+ *   - Uses bip39 directly for mnemonic generation instead of @psf/bch-js
+ *   - No SLP wallet
+ *   - No migration logic (fresh CLI, no legacy key schemes)
+ *   - computeWalletHash() is identical to paytaca-app
+ */
+import { generateMnemonic as bip39Generate, validateMnemonic } from 'bip39';
+import sha256 from 'js-sha256';
+import { storeMnemonic as keychainStoreMnemonic, getMnemonic as keychainGetMnemonic, setActiveWallet, getActiveWallet, } from '../storage/keychain.js';
+import { BchWallet } from './bch.js';
+import { BCH_DERIVATION_PATH, projectId } from '../utils/network.js';
+/**
+ * Compute wallet hash from mnemonic and derivation path.
+ * walletHash = sha256(sha256(mnemonic) + sha256(derivationPath))
+ *
+ * Identical to paytaca-app's computeWalletHash() in src/wallet/index.js
+ * and BchWallet.getWalletHash() in src/wallet/bch.js
+ */
+export function computeWalletHash(mnemonic, derivationPath = BCH_DERIVATION_PATH) {
+    if (typeof mnemonic !== 'string' || mnemonic.length === 0) {
+        throw new TypeError('mnemonic must be a non-empty string');
+    }
+    if (typeof derivationPath !== 'string' || derivationPath.length === 0) {
+        throw new TypeError('derivationPath must be a non-empty string');
+    }
+    const mnemonicHash = sha256.sha256(mnemonic);
+    const derivationPathHash = sha256.sha256(derivationPath);
+    const walletHash = sha256.sha256(mnemonicHash + derivationPathHash);
+    return walletHash;
+}
+/**
+ * Generate a new 12-word BIP39 mnemonic, store it in the OS keychain,
+ * and set it as the active wallet.
+ *
+ * Adapted from paytaca-app generateMnemonic() — stripped of
+ * Capacitor SecureStoragePlugin and old key-scheme migration.
+ */
+export function generateMnemonic() {
+    const mnemonic = bip39Generate(128); // 128 bits = 12 words
+    const walletHash = computeWalletHash(mnemonic);
+    keychainStoreMnemonic(mnemonic, walletHash);
+    setActiveWallet(walletHash);
+    return { mnemonic, walletHash };
+}
+/**
+ * Import an existing mnemonic, validate it, store in keychain,
+ * and set as active wallet.
+ */
+export function importMnemonic(mnemonic) {
+    const trimmed = mnemonic.trim().toLowerCase();
+    if (!validateMnemonic(trimmed)) {
+        throw new Error('Invalid BIP39 mnemonic phrase');
+    }
+    const walletHash = computeWalletHash(trimmed);
+    keychainStoreMnemonic(trimmed, walletHash);
+    setActiveWallet(walletHash);
+    return { mnemonic: trimmed, walletHash };
+}
+/**
+ * Load the active wallet's mnemonic from keychain.
+ * Returns null if no active wallet is set or mnemonic is missing.
+ */
+export function loadMnemonic() {
+    const walletHash = getActiveWallet();
+    if (!walletHash)
+        return null;
+    const mnemonic = keychainGetMnemonic(walletHash);
+    if (!mnemonic)
+        return null;
+    return { mnemonic, walletHash };
+}
+/**
+ * High-level wallet class that provides access to BCH sub-wallets.
+ *
+ * Adapted from paytaca-app's Wallet class in src/wallet/index.js.
+ * Stripped of SLP — only BCH mainnet and chipnet.
+ */
+export class Wallet {
+    mnemonic;
+    _BCH = null;
+    _BCH_CHIP = null;
+    constructor(mnemonic) {
+        this.mnemonic = mnemonic;
+    }
+    /** Main BCH wallet (mainnet) */
+    get BCH() {
+        if (!this._BCH) {
+            this._BCH = new BchWallet(projectId.mainnet, this.mnemonic, BCH_DERIVATION_PATH, false);
+        }
+        return this._BCH;
+    }
+    /** Chipnet BCH wallet (testnet) */
+    get BCH_CHIP() {
+        if (!this._BCH_CHIP) {
+            this._BCH_CHIP = new BchWallet(projectId.chipnet, this.mnemonic, BCH_DERIVATION_PATH, true);
+        }
+        return this._BCH_CHIP;
+    }
+    /** Get the appropriate sub-wallet for the given network */
+    forNetwork(isChipnet) {
+        return isChipnet ? this.BCH_CHIP : this.BCH;
+    }
+}
+/**
+ * Load a Wallet instance from the keychain.
+ * Returns null if no active wallet exists.
+ */
+export function loadWallet() {
+    const data = loadMnemonic();
+    if (!data)
+        return null;
+    return new Wallet(data.mnemonic);
+}
+//# sourceMappingURL=index.js.map

package/dist/wallet/index.js.map

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

package/dist/wallet/keys.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 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 { type HdPrivateNodeValid } from '@bitauth/libauth';
+export declare class LibauthHDWallet {
+    mnemonic: string;
+    derivationPath: string;
+    network: 'mainnet' | 'chipnet';
+    walletHash: string;
+    /**
+     * @param mnemonic - BIP39 mnemonic phrase
+     * @param derivationPath - HD derivation path (default: m/44'/145'/0')
+     * @param network - 'mainnet' or 'chipnet'
+     */
+    constructor(mnemonic?: string, derivationPath?: string, network?: 'mainnet' | 'chipnet');
+    get isChipnet(): boolean;
+    set isChipnet(value: boolean);
+    /**
+     * Compute wallet hash: sha256(sha256(mnemonic) + sha256(derivationPath))
+     * Identical to paytaca-app's computeWalletHash() and BchWallet.getWalletHash()
+     */
+    getWalletHash(): string;
+    /**
+     * Derive the main HD node at the derivation path.
+     * mnemonic → seed → master node → derive(path)
+     */
+    getMainNode(): HdPrivateNodeValid;
+    /**
+     * 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?: string): HdPrivateNodeValid;
+    /**
+     * Get the WIF-encoded private key at a sub-path.
+     */
+    getPrivateKeyWifAt(path?: string): string;
+    /**
+     * Get the compressed public key (hex) at a sub-path.
+     */
+    getPubkeyAt(path?: string): string;
+    /**
+     * 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?: {
+        path?: string;
+        token?: boolean;
+    }): string;
+    /**
+     * Derive receiving and change addresses at a given index.
+     * Convenience method matching BchWallet.getAddressSetAt() from paytaca-app.
+     */
+    getAddressSetAt(index: number): {
+        receiving: string;
+        change: string;
+    };
+}
+//# sourceMappingURL=keys.d.ts.map

package/dist/wallet/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/wallet/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAOL,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAA;AAIzB,qBAAa,eAAe;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAA;IAC9B,UAAU,EAAE,MAAM,CAAA;IAElB;;;;OAIG;gBAED,QAAQ,GAAE,MAAW,EACrB,cAAc,GAAE,MAA4B,EAC5C,OAAO,GAAE,SAAS,GAAG,SAAqB;IAQ5C,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,SAAS,CAAC,KAAK,EAAE,OAAO,EAE3B;IAED;;;OAGG;IACH,aAAa,IAAI,MAAM;IASvB;;;OAGG;IACH,WAAW,IAAI,kBAAkB;IAcjC;;;OAGG;IACH,SAAS,CAAC,IAAI,GAAE,MAAW,GAAG,kBAAkB;IAYhD;;OAEG;IACH,kBAAkB,CAAC,IAAI,GAAE,MAAW,GAAG,MAAM;IAK7C;;OAEG;IACH,WAAW,CAAC,IAAI,GAAE,MAAW,GAAG,MAAM;IAMtC;;;;;OAKG;IACH,YAAY,CAAC,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,MAAM;IAOnE;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAMtE"}