@hardkas/toolkit 0.11.1-alpha → 0.11.4-alpha

package/dist/stores/invoice-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"invoice-store.js","sourceRoot":"","sources":["../../src/stores/invoice-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAavD,MAAM,OAAO,gBAAgB;IACjB,KAAK,CAAiC;IAE9C,YAAY,OAA6B;QACrC,IAAI,CAAC,KAAK,GAAG,IAAI,eAAe,CAAgB,OAAO,CAAC,CAAC;IAC7D,CAAC;IAEM,IAAI,CAAC,OAAsB;QAC9B,OAAO,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAEM,GAAG,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAEM,IAAI;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAEM,cAAc,CAAC,UAAkB;QACpC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IACtE,CAAC;IAEM,QAAQ;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAC9D,CAAC;IAEM,KAAK,CAAC,UAAmB;QAC5B,IAAI,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,UAAU,EAAE,CAAC;YACb,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;QACjE,CAAC;QAED,OAAO;YACH,aAAa,EAAE,QAAQ,CAAC,MAAM;YAC9B,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;SACjE,CAAC;IACN,CAAC;CACJ"}
+{"version":3,"file":"invoice-store.js","sourceRoot":"","sources":["../../src/stores/invoice-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAsBvD,MAAM,OAAO,gBAAgB;IACjB,KAAK,CAAiC;IAE9C,YAAY,OAA6B;QACrC,IAAI,CAAC,KAAK,GAAG,IAAI,eAAe,CAAgB,OAAO,CAAC,CAAC;IAC7D,CAAC;IAEM,IAAI,CAAC,OAAsB;QAC9B,OAAO,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAEM,GAAG,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAEM,IAAI;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAEM,cAAc,CAAC,UAAkB;QACpC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IACtE,CAAC;IAEM,QAAQ;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAC9D,CAAC;IAEM,KAAK,CAAC,UAAmB;QAC5B,IAAI,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,UAAU,EAAE,CAAC;YACb,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;QACjE,CAAC;QAED,OAAO;YACH,aAAa,EAAE,QAAQ,CAAC,MAAM;YAC9B,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;SACjE,CAAC;IACN,CAAC;CACJ"}

package/dist/subscriptions.d.ts

@@ -0,0 +1,22 @@
+import { KaspaRpcClient } from "@hardkas/kaspa-rpc";
+export interface WalletSubscriptionEvent {
+    type: "transaction";
+    txid: string;
+    details?: any;
+}
+export type WalletWatchHandler = (event: WalletSubscriptionEvent) => void | Promise<void>;
+export declare class WalletSubscriptionManager {
+    private rpc;
+    private getAddress;
+    private seenTxIds;
+    private txIdQueue;
+    private readonly MAX_DEDUPE_CACHE;
+    private handlers;
+    private activeRpcSubscription?;
+    constructor(rpc: KaspaRpcClient, getAddress: () => Promise<string>);
+    watch(handler: WalletWatchHandler): Promise<{
+        unwatch: () => Promise<void>;
+    }>;
+    private handleRawUtxosChanged;
+}
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../src/subscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,GAAG,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1F,qBAAa,yBAAyB;IAStB,OAAO,CAAC,GAAG;IAAkB,OAAO,CAAC,UAAU;IAR3D,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IAGzC,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,qBAAqB,CAAC,CAAmD;gBAE7D,GAAG,EAAE,cAAc,EAAU,UAAU,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC;IAErE,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IA6B1F,OAAO,CAAC,qBAAqB;CAwDhC"}

package/dist/subscriptions.js

@@ -0,0 +1,91 @@
+import { logger } from "@hardkas/observability";
+export class WalletSubscriptionManager {
+    rpc;
+    getAddress;
+    seenTxIds = new Set();
+    txIdQueue = []; // Simple LRU tracking
+    MAX_DEDUPE_CACHE = 1000;
+    // Maintain a list of handlers per address
+    handlers = new Set();
+    activeRpcSubscription;
+    constructor(rpc, getAddress) {
+        this.rpc = rpc;
+        this.getAddress = getAddress;
+    }
+    async watch(handler) {
+        this.handlers.add(handler);
+        // If this is the first handler, spin up the underlying RPC subscription
+        if (this.handlers.size === 1 && !this.activeRpcSubscription) {
+            const addr = await this.getAddress();
+            const subscription = await this.rpc.subscribeToUtxosChanged([addr], (data) => {
+                this.handleRawUtxosChanged(data);
+            });
+            this.activeRpcSubscription = {
+                unsubscribe: async () => {
+                    await subscription.unsubscribe();
+                }
+            };
+        }
+        return {
+            unwatch: async () => {
+                this.handlers.delete(handler);
+                if (this.handlers.size === 0 && this.activeRpcSubscription) {
+                    await this.activeRpcSubscription.unsubscribe().catch(() => { });
+                    this.activeRpcSubscription = undefined;
+                }
+            }
+        };
+    }
+    handleRawUtxosChanged(data) {
+        // Data usually has 'added' and 'removed' arrays containing KaspaRpcUtxo
+        const added = data?.added || data?.utxosAdded || [];
+        const removed = data?.removed || data?.utxosRemoved || [];
+        // Extract all unique txids from this event
+        const incomingTxids = new Set();
+        const extractTxid = (utxos) => {
+            for (const u of utxos) {
+                const txid = u?.outpoint?.transactionId || u?.outpoint?.transaction_id || u?.outpoint?.txId;
+                if (txid) {
+                    incomingTxids.add(txid);
+                }
+            }
+        };
+        extractTxid(added);
+        extractTxid(removed);
+        for (const txid of incomingTxids) {
+            if (this.seenTxIds.has(txid)) {
+                logger.debug("WalletSubscriptionManager deduplicated event", { txid });
+                continue;
+            }
+            // Mark as seen
+            this.seenTxIds.add(txid);
+            this.txIdQueue.push(txid);
+            if (this.txIdQueue.length > this.MAX_DEDUPE_CACHE) {
+                const oldest = this.txIdQueue.shift();
+                if (oldest)
+                    this.seenTxIds.delete(oldest);
+            }
+            // Dispatch to all wallet-level handlers
+            const event = {
+                type: "transaction",
+                txid,
+                details: data
+            };
+            for (const handler of this.handlers) {
+                try {
+                    // Safe execution
+                    const res = handler(event);
+                    if (res instanceof Promise) {
+                        res.catch(err => {
+                            logger.error("Wallet watch async handler threw error", { error: err });
+                        });
+                    }
+                }
+                catch (err) {
+                    logger.error("Wallet watch sync handler threw error", { error: err });
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=subscriptions.js.map

package/dist/subscriptions.js.map

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

package/dist/wallet.d.ts

@@ -1,7 +1,14 @@
+import { WalletQueryProvider } from '@hardkas/query';
 import { WalletUtxoApi } from './utxos.js';
+import { WalletWatchHandler } from './subscriptions.js';
+import { FeePriority } from './fee-estimator.js';
 export interface WalletToolkitOptions {
     storePath?: string;
     network?: "simnet" | "testnet" | "mainnet";
+    provider?: WalletQueryProvider;
+    rpc?: any;
+    signer?: any;
+    coinbaseMaturity?: bigint;
 }
 export declare class WalletToolkit {
     readonly name: string;
@@ -11,24 +18,96 @@ export declare class WalletToolkit {
     private addressManager;
     private walletQuery;
     private _utxosApi;
+    private _subscriptionManager?;
     private constructor();
     static open(name: string, options?: WalletToolkitOptions): WalletToolkit;
     create(): Promise<void>;
-    address(): Promise<string>;
+    receive(): Promise<string>;
     balance(): Promise<bigint>;
     get utxos(): WalletUtxoApi;
     history(): Promise<any[]>;
+    watch(cb: WalletWatchHandler): Promise<{
+        unwatch: () => void;
+    }>;
     estimateFee(opts: {
         to: string;
         amount: bigint;
-    }): Promise<any>;
+        priority?: FeePriority;
+        feeRate?: bigint;
+    }): Promise<{
+        fee: bigint;
+        feeRate: bigint;
+        estimatedMass: bigint;
+        estimatedFee: bigint;
+        totalOut: bigint;
+        plan: any;
+        evidence: "dynamic" | "heuristic";
+        mempoolSize?: number;
+    }>;
+    /**
+     * @deprecated Use hardkas.tx.plan directly or the specific operation helpers like send() or consolidate()
+     */
     planSend(opts: {
         to: string;
         amount: bigint;
+        priority?: FeePriority;
+        feeRate?: bigint;
     }): Promise<any>;
+    /**
+     * @deprecated sendSimulated is moved to testing patterns. Use hardkas.localnet.mine() and standard send() flows.
+     */
     sendSimulated(opts: {
         to: string;
         amount: bigint;
+        priority?: FeePriority;
+        feeRate?: bigint;
     }): Promise<string>;
+    private signAndBroadcast;
+    send(opts: {
+        to: string;
+        amount: bigint;
+        priority?: FeePriority;
+        feeRate?: bigint;
+    }): Promise<{
+        txId: string;
+        plan: any;
+    }>;
+    payMany(opts: {
+        outputs: {
+            address: string;
+            amount: bigint;
+        }[];
+        priority?: FeePriority;
+        feeRate?: bigint;
+    }): Promise<{
+        txId: string;
+        plan: any;
+    }>;
+    sweep(opts: {
+        to: string;
+        priority?: FeePriority;
+        feeRate?: bigint;
+    }): Promise<{
+        txId: string;
+        plan: any;
+    }>;
+    consolidate(opts: {
+        to?: string;
+        priority?: FeePriority;
+        feeRate?: bigint;
+        maxUtxos?: number;
+    }): Promise<{
+        txId: string;
+        plan: any;
+    }>;
+    split(opts: {
+        outputsCount: number;
+        amountPerOutput: bigint;
+        priority?: FeePriority;
+        feeRate?: bigint;
+    }): Promise<{
+        txId: string;
+        plan: any;
+    }>;
 }
 //# sourceMappingURL=wallet.d.ts.map

package/dist/wallet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../src/wallet.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,MAAM,WAAW,oBAAoB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CAC9C;AAED,qBAAa,aAAa;aAQF,IAAI,EAAE,MAAM;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAT5B,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,WAAW,CAAc;IAEjC,OAAO,CAAC,SAAS,CAAgB;IAEjC,OAAO;WAsBO,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,aAAa;IAKtE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAY1B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvC,IAAW,KAAK,IAAI,aAAa,CAEhC;IAEY,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAKzB,WAAW,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAU/D,QAAQ,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAI5D,aAAa,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAGpF"}
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../src/wallet.ts"],"names":[],"mappings":"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"}

package/dist/wallet.js

@@ -1,7 +1,26 @@
 import { WalletManagerImpl, WalletStateStoreJson, AddressManager } from '@hardkas/accounts';
 import { WalletQuery } from '@hardkas/query';
+import { buildPaymentPlan, toTxBuilderUtxo } from '@hardkas/tx-builder';
 import { WalletUtxoApi } from './utxos.js';
 import { UtxoControlStore } from './stores/utxo-control-store.js';
+import { logger, metrics } from '@hardkas/observability';
+import { WalletSubscriptionManager } from './subscriptions.js';
+import { calculateDynamicFeeRate } from './fee-estimator.js';
+metrics.register({
+    name: "wallet_tx_generated_total",
+    help: "Total tx generated by wallet",
+    type: "counter"
+});
+metrics.register({
+    name: "wallet_tx_submitted_total",
+    help: "Total tx submitted by wallet",
+    type: "counter"
+});
+metrics.register({
+    name: "wallet_tx_failed_total",
+    help: "Total tx failed by wallet",
+    type: "counter"
+});
 export class WalletToolkit {
     name;
     store;
@@ -10,18 +29,66 @@ export class WalletToolkit {
     addressManager;
     walletQuery;
     _utxosApi;
+    _subscriptionManager;
     constructor(name, store, options) {
         this.name = name;
         this.store = store;
         this.options = options;
         this.walletManager = new WalletManagerImpl();
         this.addressManager = AddressManager;
-        this.walletQuery = new WalletQuery({});
+        let provider = options.provider;
+        if (!provider && options.rpc) {
+            provider = {
+                source: "rpc",
+                async getBalances(addresses) {
+                    const res = {};
+                    for (const addr of addresses) {
+                        const bal = await options.rpc.getBalanceByAddress(addr);
+                        res[addr] = bal.balanceSompi;
+                    }
+                    return res;
+                },
+                async getUtxos(addresses) {
+                    const res = {};
+                    for (const addr of addresses) {
+                        const utxos = await options.rpc.getUtxosByAddress(addr);
+                        res[addr] = utxos.map((u) => ({
+                            transactionId: u.outpoint.transactionId,
+                            outputIndex: u.outpoint.index,
+                            amountSompi: u.amountSompi,
+                            scriptPublicKey: u.scriptPublicKey,
+                            address: u.address,
+                            blockDaaScore: u.blockDaaScore,
+                            isCoinbase: u.isCoinbase
+                        }));
+                    }
+                    return res;
+                },
+                async getHistory() {
+                    return { items: [] };
+                }
+            };
+        }
+        else if (!provider) {
+            provider = {
+                source: "dummy",
+                async getBalances() { return {}; },
+                async getUtxos() { return {}; },
+                async getHistory() { return { items: [] }; }
+            };
+        }
+        this.walletQuery = new WalletQuery({ provider, network: options.network || "simnet" });
         const utxoControlPath = options.storePath
             ? options.storePath.replace('.json', '-utxo-control.json')
             : 'default-utxo-control.json';
         const utxoStore = new UtxoControlStore(utxoControlPath);
-        this._utxosApi = new WalletUtxoApi(async () => (await this.walletQuery.getUtxos([await this.address()])), async () => this.address(), async (inputs, outputs) => BigInt(inputs * 1000 + outputs * 1000), // Dummy fee estimation
+        this._utxosApi = new WalletUtxoApi(async () => {
+            const addr = await this.receive();
+            const res = await this.walletQuery.getUtxos([addr]);
+            if (!res.ok)
+                throw new Error(res.error || "Degraded query result");
+            return res.utxos[addr] || [];
+        }, async () => this.receive(), async (inputs, outputs) => BigInt(inputs * 1000 + outputs * 1000), // Dummy fee estimation
         utxoStore);
     }
     static open(name, options = {}) {
@@ -31,7 +98,7 @@ export class WalletToolkit {
     async create() {
         this.walletManager.create({ walletId: this.name });
     }
-    async address() {
+    async receive() {
         // High level facade: gets receive address
         const seedRef = this.walletManager.getSeedRef(this.name);
         return this.addressManager.derive({
@@ -43,30 +110,278 @@ export class WalletToolkit {
         }).address;
     }
     async balance() {
-        const addr = await this.address();
+        const addr = await this.receive();
         return (await this.walletQuery.getBalance([addr]));
     }
     get utxos() {
         return this._utxosApi;
     }
     async history() {
-        const addr = await this.address();
-        return (await this.walletQuery.getHistory({ addresses: [addr] }));
+        const addr = await this.receive();
+        // Return local observed history (best-effort locally + remote if available)
+        const remoteHistory = await this.walletQuery.getHistory({ addresses: [addr] });
+        // Enhance with local mock/artifacts if needed, but per specs:
+        // "txs enviadas por HardKAS, UTXO changes observados, receipts locales"
+        // For now, we return remoteHistory items + potentially local state from utxos store
+        const items = remoteHistory?.items || remoteHistory || [];
+        return items;
+    }
+    async watch(cb) {
+        if (!this.options.rpc || !this.options.rpc.subscribeToUtxosChanged) {
+            throw new Error("RPC client with subscription support is required for watch()");
+        }
+        if (!this._subscriptionManager) {
+            this._subscriptionManager = new WalletSubscriptionManager(this.options.rpc, async () => this.receive());
+        }
+        return this._subscriptionManager.watch(cb);
     }
     async estimateFee(opts) {
-        const u = await this.utxos.list();
-        // Since we are mocking the facade, just return a fake fee
+        const addr = await this.receive();
+        const availableUtxos = await this.utxos.list();
+        let finalFeeRate = opts.feeRate;
+        let evidence = "heuristic";
+        let mempoolSize;
+        if (!finalFeeRate) {
+            const dynamic = await calculateDynamicFeeRate(this.options.rpc, opts.priority || "normal");
+            finalFeeRate = dynamic.feeRate;
+            evidence = dynamic.evidence;
+            mempoolSize = dynamic.mempoolSize;
+        }
+        // Fetch current DAA score for coinbase maturity filtering
+        let virtualDaaScore;
+        let networkId;
+        if (this.options.rpc?.getBlockDagInfo) {
+            try {
+                const dagInfo = await this.options.rpc.getBlockDagInfo();
+                virtualDaaScore = dagInfo.virtualDaaScore;
+                networkId = dagInfo.networkId;
+            }
+            catch {
+                // If DAG info unavailable, proceed without maturity filtering
+            }
+        }
+        const plan = buildPaymentPlan({
+            fromAddress: addr,
+            outputs: [{ address: opts.to, amountSompi: opts.amount }],
+            availableUtxos: availableUtxos,
+            feeRateSompiPerMass: finalFeeRate || 1n,
+            changeAddress: addr,
+            coinbaseMaturity: networkId === "mainnet" ? 1000n : 100n,
+            ...(virtualDaaScore !== undefined ? { virtualDaaScore } : {}),
+            ...(networkId !== undefined ? { networkId } : {})
+        });
+        const exactMass = BigInt(plan.estimatedMass);
         return {
-            selectedUtxos: [],
-            fee: 1000n,
-            totalOut: BigInt(opts.amount) + 1000n
+            fee: plan.estimatedFeeSompi,
+            feeRate: finalFeeRate || 1n,
+            estimatedMass: exactMass,
+            estimatedFee: plan.estimatedFeeSompi,
+            totalOut: opts.amount + plan.estimatedFeeSompi,
+            plan,
+            evidence,
+            ...(mempoolSize !== undefined ? { mempoolSize } : {})
         };
     }
+    /**
+     * @deprecated Use hardkas.tx.plan directly or the specific operation helpers like send() or consolidate()
+     */
     async planSend(opts) {
-        return {};
+        return {
+            message: "This is a stub, as requested by P61 audit. Real planning requires UTXO orchestration."
+        };
     }
+    /**
+     * @deprecated sendSimulated is moved to testing patterns. Use hardkas.localnet.mine() and standard send() flows.
+     */
     async sendSimulated(opts) {
-        return `simulated_tx_${Date.now()}`;
+        return `sim_tx_${Date.now()}`;
+    }
+    async signAndBroadcast(plan) {
+        if (!this.options.signer) {
+            const err = new Error("MISSING_SIGNER: WalletToolkit requires an explicit signer to sign transactions.");
+            err.code = "MISSING_SIGNER";
+            throw err;
+        }
+        if (!this.options.rpc) {
+            throw new Error("RPC client is required for broadcast.");
+        }
+        const addr = await this.receive();
+        const fakeArtifact = {
+            schema: "hardkas.txPlan",
+            planId: "wallet-toolkit-inline",
+            networkId: this.options.network || "simnet",
+            mode: "real",
+            from: { address: addr },
+            to: { address: plan.outputs[0]?.address || addr },
+            amountSompi: plan.outputs.reduce((acc, out) => acc + BigInt(out.amountSompi), 0n).toString(),
+            estimatedFeeSompi: plan.estimatedFeeSompi.toString(),
+            inputs: plan.inputs,
+            outputs: plan.outputs,
+            change: plan.change,
+        };
+        const result = await (this.options.signer.signTxPlan
+            ? this.options.signer.signTxPlan({ planArtifact: fakeArtifact })
+            : this.options.signer.signTransaction(fakeArtifact));
+        const rawTx = JSON.parse(result.signedTransaction.payload);
+        const submitRes = await this.options.rpc.submitTransaction(rawTx);
+        metrics.inc("wallet_tx_submitted_total");
+        logger.info("Wallet tx submitted successfully", { txId: submitRes.transactionId || result.txId });
+        // Return full artifact/evidence format
+        return {
+            txId: submitRes.transactionId || result.txId,
+            plan
+        };
+    }
+    async send(opts) {
+        return this.payMany({
+            outputs: [{ address: opts.to, amount: opts.amount }],
+            ...(opts.priority !== undefined ? { priority: opts.priority } : {}),
+            ...(opts.feeRate !== undefined ? { feeRate: opts.feeRate } : {})
+        });
+    }
+    async payMany(opts) {
+        const addr = await this.receive();
+        const availableUtxos = await this.utxos.list();
+        let finalFeeRate = opts.feeRate;
+        if (!finalFeeRate) {
+            const dynamic = await calculateDynamicFeeRate(this.options.rpc, opts.priority || "normal");
+            finalFeeRate = dynamic.feeRate;
+        }
+        // Fetch current DAA score for coinbase maturity filtering
+        let virtualDaaScore;
+        let networkId;
+        if (this.options.rpc?.getBlockDagInfo) {
+            try {
+                const dagInfo = await this.options.rpc.getBlockDagInfo();
+                virtualDaaScore = dagInfo.virtualDaaScore;
+                networkId = dagInfo.networkId;
+            }
+            catch {
+                // If DAG info unavailable, proceed without maturity filtering
+            }
+        }
+        const builderOutputs = opts.outputs.map(o => ({ address: o.address, amountSompi: o.amount }));
+        const mappedUtxos = availableUtxos.map(u => toTxBuilderUtxo(u));
+        const plan = buildPaymentPlan({
+            fromAddress: addr,
+            outputs: builderOutputs,
+            availableUtxos: mappedUtxos,
+            feeRateSompiPerMass: finalFeeRate || 1n,
+            changeAddress: addr,
+            coinbaseMaturity: networkId === "mainnet" ? 1000n : 100n,
+            ...(virtualDaaScore !== undefined ? { virtualDaaScore } : {}),
+            ...(networkId !== undefined ? { networkId } : {})
+        });
+        return this.signAndBroadcast(plan);
+    }
+    async sweep(opts) {
+        const addr = await this.receive();
+        let availableUtxos = await this.utxos.list();
+        if (availableUtxos.length === 0)
+            throw new Error("No UTXOs to sweep");
+        let finalFeeRate = opts.feeRate;
+        if (!finalFeeRate) {
+            const dynamic = await calculateDynamicFeeRate(this.options.rpc, opts.priority || "normal");
+            finalFeeRate = dynamic.feeRate;
+        }
+        // Filter immature coinbase UTXOs
+        if (this.options.rpc?.getBlockDagInfo) {
+            try {
+                const dagInfo = await this.options.rpc.getBlockDagInfo();
+                const virtualDaaScore = dagInfo.virtualDaaScore;
+                if (virtualDaaScore !== undefined) {
+                    if (this.options.coinbaseMaturity === undefined) {
+                        throw new Error("COINBASE_MATURITY_UNRESOLVED: WalletToolkit requires coinbaseMaturity to be explicitly provided");
+                    }
+                    const COINBASE_MATURITY = this.options.coinbaseMaturity;
+                    availableUtxos = availableUtxos.filter((u) => {
+                        if (u.isCoinbase && u.blockDaaScore !== undefined &&
+                            (virtualDaaScore - BigInt(u.blockDaaScore)) < COINBASE_MATURITY) {
+                            return false;
+                        }
+                        return true;
+                    });
+                    if (availableUtxos.length === 0)
+                        throw new Error("No mature UTXOs to sweep");
+                }
+            }
+            catch (e) {
+                if (e.message?.includes("No mature UTXOs"))
+                    throw e;
+                // If DAG info unavailable, proceed without maturity filtering
+            }
+        }
+        const { estimateTransactionMass } = await import("@hardkas/tx-builder");
+        const massRes = estimateTransactionMass({
+            inputCount: availableUtxos.length,
+            outputs: [{ address: opts.to }],
+            payloadBytes: 0,
+            hasChange: false
+        });
+        const fee = massRes.mass * (finalFeeRate || 1n);
+        const totalValue = availableUtxos.reduce((acc, u) => acc + BigInt(u.amountSompi), 0n);
+        const sendValue = totalValue - fee;
+        if (sendValue <= 0n) {
+            throw new Error("Insufficient funds to cover sweep fee");
+        }
+        const plan = {
+            inputs: availableUtxos,
+            outputs: [{ address: opts.to, amountSompi: sendValue }],
+            estimatedMass: massRes.mass,
+            estimatedFeeSompi: fee
+        };
+        return this.signAndBroadcast(plan);
+    }
+    async consolidate(opts) {
+        const addr = await this.receive();
+        const availableUtxos = await this.utxos.list();
+        const maxUtxos = opts.maxUtxos || 100;
+        if (availableUtxos.length <= 1) {
+            throw new Error("Not enough UTXOs to consolidate");
+        }
+        // Sort by smallest first to consolidate dust
+        const sortedUtxos = [...availableUtxos].sort((a, b) => {
+            const diff = BigInt(a.amountSompi) - BigInt(b.amountSompi);
+            return diff < 0n ? -1 : diff > 0n ? 1 : 0;
+        });
+        const selectedUtxos = sortedUtxos.slice(0, maxUtxos);
+        const toAddress = opts.to || addr;
+        let finalFeeRate = opts.feeRate;
+        if (!finalFeeRate) {
+            const dynamic = await calculateDynamicFeeRate(this.options.rpc, opts.priority || "normal");
+            finalFeeRate = dynamic.feeRate;
+        }
+        const { estimateTransactionMass } = await import("@hardkas/tx-builder");
+        const massRes = estimateTransactionMass({
+            inputCount: selectedUtxos.length,
+            outputs: [{ address: toAddress }],
+            payloadBytes: 0,
+            hasChange: false
+        });
+        const fee = massRes.mass * (finalFeeRate || 1n);
+        const totalValue = selectedUtxos.reduce((acc, u) => acc + BigInt(u.amountSompi), 0n);
+        const sendValue = totalValue - fee;
+        if (sendValue <= 0n) {
+            throw new Error("Insufficient funds to cover consolidate fee");
+        }
+        const plan = {
+            inputs: selectedUtxos,
+            outputs: [{ address: toAddress, amountSompi: sendValue }],
+            estimatedMass: massRes.mass,
+            estimatedFeeSompi: fee
+        };
+        return this.signAndBroadcast(plan);
+    }
+    async split(opts) {
+        if (opts.outputsCount <= 0)
+            throw new Error("outputsCount must be greater than 0");
+        const addr = await this.receive();
+        const outputs = Array(opts.outputsCount).fill({ address: addr, amount: opts.amountPerOutput });
+        return this.payMany({
+            outputs,
+            ...(opts.priority !== undefined ? { priority: opts.priority } : {}),
+            ...(opts.feeRate !== undefined ? { feeRate: opts.feeRate } : {})
+        });
     }
 }
 //# sourceMappingURL=wallet.js.map