@hardkas/toolkit 0.11.1-alpha

package/dist/utxos.js

@@ -0,0 +1,331 @@
+export class WalletUtxoApi {
+    fetchUtxos;
+    address;
+    estimateFee;
+    store;
+    constructor(fetchUtxos, address, estimateFee, store) {
+        this.fetchUtxos = fetchUtxos;
+        this.address = address;
+        this.estimateFee = estimateFee;
+        this.store = store;
+    }
+    /**
+     * List UTXOs currently available in the wallet.
+     * Frozen UTXOs are excluded by default unless includeFrozen: true.
+     */
+    async list(opts) {
+        const all = await this.fetchUtxos();
+        const state = this.store.getState();
+        if (opts?.includeFrozen) {
+            return all;
+        }
+        return all.filter(u => !state.frozen[u.transactionId] && !state.frozen[`${u.transactionId}:${u.outputIndex}`]);
+    }
+    /**
+     * Return basic statistics about the UTXO set.
+     */
+    async statistics(opts) {
+        const allUtxos = await this.fetchUtxos();
+        const state = this.store.getState();
+        let totalUtxos = 0;
+        let availableUtxos = 0;
+        let frozenUtxos = 0;
+        let totalValue = 0n;
+        let availableValue = 0n;
+        let frozenValue = 0n;
+        let largest = -1n;
+        let smallest = -1n;
+        const includeFrozen = opts?.includeFrozen ?? false;
+        for (const u of allUtxos) {
+            const amt = BigInt(u.amountSompi);
+            const isFrozen = !!(state.frozen[u.transactionId] || state.frozen[`${u.transactionId}:${u.outputIndex}`]);
+            totalUtxos++;
+            totalValue += amt;
+            if (isFrozen) {
+                frozenUtxos++;
+                frozenValue += amt;
+            }
+            else {
+                availableUtxos++;
+                availableValue += amt;
+            }
+            // Largest/smallest only counts what is included
+            if (includeFrozen || !isFrozen) {
+                if (largest === -1n || amt > largest)
+                    largest = amt;
+                if (smallest === -1n || amt < smallest)
+                    smallest = amt;
+            }
+        }
+        const countForAvg = includeFrozen ? totalUtxos : availableUtxos;
+        const valueForAvg = includeFrozen ? totalValue : availableValue;
+        return {
+            totalUtxos,
+            availableUtxos,
+            frozenUtxos,
+            totalValue,
+            availableValue,
+            frozenValue,
+            averageValue: countForAvg === 0 ? 0n : valueForAvg / BigInt(countForAvg),
+            largest: largest === -1n ? 0n : largest,
+            smallest: smallest === -1n ? 0n : smallest,
+            includeFrozen
+        };
+    }
+    /**
+     * Classify UTXOs into dust and normal based on a threshold.
+     * Default threshold: 10 KAS (1_000_000_000 sompi).
+     */
+    async analyzeDust(opts) {
+        const threshold = opts?.thresholdSompi ?? 1000000000n;
+        const utxos = await this.list({ includeFrozen: opts?.includeFrozen });
+        const dustUtxos = [];
+        const normalUtxos = [];
+        let totalDustValue = 0n;
+        for (const u of utxos) {
+            const amt = BigInt(u.amountSompi);
+            if (amt < threshold) {
+                dustUtxos.push(u);
+                totalDustValue += amt;
+            }
+            else {
+                normalUtxos.push(u);
+            }
+        }
+        return {
+            dustUtxos,
+            normalUtxos,
+            totalDustValue,
+            dustPercentage: utxos.length > 0 ? dustUtxos.length / utxos.length : 0
+        };
+    }
+    /**
+     * High-level diagnostic analysis of the wallet's UTXO health.
+     */
+    async analyze(opts) {
+        const stats = await this.statistics(opts);
+        const dust = await this.analyzeDust(opts);
+        const fragmentationScore = dust.dustPercentage;
+        const actions = [];
+        // We base actions on available counts
+        const activeUtxoCount = opts?.includeFrozen ? stats.totalUtxos : stats.availableUtxos;
+        if (fragmentationScore > 0.5 && activeUtxoCount > 10) {
+            actions.push("consolidate");
+        }
+        else if (dust.dustUtxos.length > 5) {
+            actions.push("mergeDust");
+        }
+        // Simplistic threshold for splitLarge: if there are very few UTXOs but high value
+        if (activeUtxoCount < 3 && stats.largest > 10000000000n) {
+            actions.push("splitLarge");
+        }
+        if (actions.length === 0) {
+            actions.push("none");
+        }
+        return {
+            utxoCount: activeUtxoCount,
+            fragmentationScore,
+            dustCount: dust.dustUtxos.length,
+            totalValue: opts?.includeFrozen ? stats.totalValue : stats.availableValue,
+            recommendedActions: actions
+        };
+    }
+    /**
+     * Plan a UTXO management operation without executing it.
+     */
+    async plan(opts) {
+        const utxos = await this.list({ includeFrozen: opts.includeFrozen });
+        const myAddress = await this.address();
+        if (opts.strategy === "consolidation") {
+            // In a real scenario, the CoinSelector would chunk this to respect mass limits.
+            // For Phase 1A, we will just select up to 84 (a safe mass limit approximation for Kaspa).
+            const MAX_INPUTS = 84;
+            // Sort smallest first to consolidate dust
+            const sorted = [...utxos].sort((a, b) => (BigInt(a.amountSompi) < BigInt(b.amountSompi) ? -1 : 1));
+            const inputs = sorted.slice(0, MAX_INPUTS);
+            const estimatedFee = await this.estimateFee(inputs.length, 1);
+            const totalInputValue = inputs.reduce((sum, u) => sum + BigInt(u.amountSompi), 0n);
+            const warnings = [];
+            if (inputs.length < 2) {
+                warnings.push("Not enough UTXOs to consolidate.");
+            }
+            if (totalInputValue <= estimatedFee) {
+                warnings.push("Consolidation fee exceeds the value of the selected UTXOs.");
+            }
+            // If we spent these 84 UTXOs individually in the future, we would pay for 1 input each time.
+            // 84 txs with 1 input vs 1 tx with 84 inputs.
+            // This is a naive calculation for "estimated savings".
+            const individualFee = await this.estimateFee(1, 2);
+            const estimatedSavings = (individualFee * BigInt(inputs.length)) - estimatedFee;
+            return {
+                strategy: opts.strategy,
+                inputs,
+                outputs: [{ address: myAddress, amount: totalInputValue - estimatedFee }],
+                estimatedFee,
+                estimatedSavings: estimatedSavings > 0n ? estimatedSavings : 0n,
+                warnings
+            };
+        }
+        throw new Error(`Strategy '${opts.strategy}' not fully implemented yet.`);
+    }
+    /**
+     * Convenience alias for planning a consolidation.
+     */
+    async consolidate(opts) {
+        return this.plan({ strategy: "consolidation", includeFrozen: opts?.includeFrozen });
+    }
+    _assertNotFrozen(utxoId, includeFrozen) {
+        if (!includeFrozen && this.store.getState().frozen[utxoId]) {
+            throw new Error(`UTXO ${utxoId} is frozen and cannot be planned for execution`);
+        }
+    }
+    /**
+     * Plans the splitting of a specific large UTXO.
+     * Supports symmetric splits (intoCount) OR asymmetric splits (outputs).
+     */
+    async splitPlan(opts) {
+        this._assertNotFrozen(opts.utxoId, opts.includeFrozen);
+        const utxos = await this.list({ includeFrozen: opts.includeFrozen });
+        const targetUtxo = utxos.find(u => u.transactionId === opts.utxoId || `${u.transactionId}:${u.outputIndex}` === opts.utxoId);
+        if (!targetUtxo) {
+            throw new Error(`UTXO ${opts.utxoId} not found in wallet.`);
+        }
+        const myAddress = await this.address();
+        const warnings = [];
+        const planOutputs = [];
+        const targetAmount = BigInt(targetUtxo.amountSompi);
+        let outputCount = 0;
+        if (opts.intoCount !== undefined && opts.outputs === undefined) {
+            outputCount = opts.intoCount;
+            if (outputCount < 2)
+                throw new Error("splitPlan requires intoCount >= 2.");
+            const estimatedFee = await this.estimateFee(1, outputCount);
+            const remainingAmount = targetAmount - estimatedFee;
+            if (remainingAmount <= 0n) {
+                throw new Error("Target UTXO does not have enough funds to cover the split and fees.");
+            }
+            const chunkAmount = remainingAmount / BigInt(outputCount);
+            for (let i = 0; i < outputCount; i++) {
+                planOutputs.push({ address: myAddress, amount: chunkAmount });
+            }
+        }
+        else if (opts.outputs !== undefined && opts.intoCount === undefined) {
+            outputCount = opts.outputs.length;
+            if (outputCount < 2)
+                throw new Error("splitPlan requires outputs.length >= 2.");
+            const estimatedFee = await this.estimateFee(1, outputCount + 1); // +1 for change
+            let sumOutputs = 0n;
+            for (const out of opts.outputs) {
+                sumOutputs += out.amountSompi;
+                planOutputs.push({ address: myAddress, amount: out.amountSompi });
+            }
+            const changeAmount = targetAmount - sumOutputs - estimatedFee;
+            if (changeAmount < 0n) {
+                throw new Error("Target UTXO does not have enough funds to cover the requested outputs and fees.");
+            }
+            if (changeAmount > 0n) {
+                // Add change output
+                planOutputs.push({ address: myAddress, amount: changeAmount });
+            }
+        }
+        else {
+            throw new Error("splitPlan requires exactly one of 'intoCount' or 'outputs' to be defined.");
+        }
+        const estimatedFee = await this.estimateFee(1, planOutputs.length);
+        return {
+            strategy: "split",
+            inputs: [targetUtxo],
+            outputs: planOutputs,
+            estimatedFee,
+            estimatedSavings: 0n,
+            warnings
+        };
+    }
+    /**
+     * Plans the explicit merging of specific UTXOs.
+     */
+    async mergePlan(opts) {
+        for (const id of opts.utxoIds) {
+            this._assertNotFrozen(id, opts.includeFrozen);
+        }
+        const utxos = await this.list({ includeFrozen: opts.includeFrozen });
+        const inputs = [];
+        for (const id of opts.utxoIds) {
+            const u = utxos.find(utxo => utxo.transactionId === id || `${utxo.transactionId}:${utxo.outputIndex}` === id);
+            if (!u) {
+                throw new Error(`UTXO ${id} not found in wallet.`);
+            }
+            inputs.push(u);
+        }
+        if (inputs.length < 2) {
+            throw new Error("mergePlan requires at least 2 UTXOs to merge.");
+        }
+        const estimatedFee = await this.estimateFee(inputs.length, 1);
+        const totalInputValue = inputs.reduce((sum, u) => sum + BigInt(u.amountSompi), 0n);
+        const myAddress = await this.address();
+        const warnings = [];
+        if (totalInputValue <= estimatedFee) {
+            warnings.push("Merge fee exceeds the value of the selected UTXOs.");
+        }
+        const individualFee = await this.estimateFee(1, 2);
+        const estimatedSavings = (individualFee * BigInt(inputs.length)) - estimatedFee;
+        return {
+            strategy: "merge",
+            inputs,
+            outputs: [{ address: myAddress, amount: totalInputValue > estimatedFee ? totalInputValue - estimatedFee : 0n }],
+            estimatedFee,
+            estimatedSavings: estimatedSavings > 0n ? estimatedSavings : 0n,
+            warnings
+        };
+    }
+    /**
+     * Plans sweeping the entire wallet to a single destination address.
+     */
+    async sweepPlan(opts) {
+        const utxos = await this.list({ includeFrozen: opts.includeFrozen });
+        if (utxos.length === 0) {
+            throw new Error("Cannot sweep an empty wallet.");
+        }
+        const estimatedFee = await this.estimateFee(utxos.length, 1);
+        const totalInputValue = utxos.reduce((sum, u) => sum + BigInt(u.amountSompi), 0n);
+        const warnings = [];
+        if (totalInputValue <= estimatedFee) {
+            warnings.push("Sweep fee exceeds the entire wallet balance.");
+        }
+        return {
+            strategy: "sweep",
+            inputs: utxos,
+            outputs: [{ address: opts.destinationAddress, amount: totalInputValue > estimatedFee ? totalInputValue - estimatedFee : 0n }],
+            estimatedFee,
+            estimatedSavings: 0n,
+            warnings
+        };
+    }
+    // --- Coin Control Persistence ---
+    async controlState() {
+        return this.store.getState();
+    }
+    async freeze(utxoId, reason) {
+        this.store.freeze(utxoId, reason);
+    }
+    async unfreeze(utxoId) {
+        this.store.unfreeze(utxoId);
+    }
+    labels = {
+        set: async (utxoId, label) => {
+            this.store.setLabel(utxoId, label);
+        },
+        get: async (utxoId) => {
+            return this.store.getLabel(utxoId);
+        }
+    };
+    notes = {
+        set: async (utxoId, note) => {
+            this.store.setNote(utxoId, note);
+        },
+        get: async (utxoId) => {
+            return this.store.getNote(utxoId);
+        }
+    };
+}
+//# sourceMappingURL=utxos.js.map

package/dist/utxos.js.map

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

package/dist/wallet.d.ts

@@ -0,0 +1,34 @@
+import { WalletUtxoApi } from './utxos.js';
+export interface WalletToolkitOptions {
+    storePath?: string;
+    network?: "simnet" | "testnet" | "mainnet";
+}
+export declare class WalletToolkit {
+    readonly name: string;
+    private readonly store;
+    private readonly options;
+    private walletManager;
+    private addressManager;
+    private walletQuery;
+    private _utxosApi;
+    private constructor();
+    static open(name: string, options?: WalletToolkitOptions): WalletToolkit;
+    create(): Promise<void>;
+    address(): Promise<string>;
+    balance(): Promise<bigint>;
+    get utxos(): WalletUtxoApi;
+    history(): Promise<any[]>;
+    estimateFee(opts: {
+        to: string;
+        amount: bigint;
+    }): Promise<any>;
+    planSend(opts: {
+        to: string;
+        amount: bigint;
+    }): Promise<any>;
+    sendSimulated(opts: {
+        to: string;
+        amount: bigint;
+    }): Promise<string>;
+}
+//# sourceMappingURL=wallet.d.ts.map

package/dist/wallet.d.ts.map

@@ -0,0 +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"}

package/dist/wallet.js

@@ -0,0 +1,72 @@
+import { WalletManagerImpl, WalletStateStoreJson, AddressManager } from '@hardkas/accounts';
+import { WalletQuery } from '@hardkas/query';
+import { WalletUtxoApi } from './utxos.js';
+import { UtxoControlStore } from './stores/utxo-control-store.js';
+export class WalletToolkit {
+    name;
+    store;
+    options;
+    walletManager;
+    addressManager;
+    walletQuery;
+    _utxosApi;
+    constructor(name, store, options) {
+        this.name = name;
+        this.store = store;
+        this.options = options;
+        this.walletManager = new WalletManagerImpl();
+        this.addressManager = AddressManager;
+        this.walletQuery = new WalletQuery({});
+        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
+        utxoStore);
+    }
+    static open(name, options = {}) {
+        const store = new WalletStateStoreJson({ filePath: options.storePath || 'default.json' });
+        return new WalletToolkit(name, store, options);
+    }
+    async create() {
+        this.walletManager.create({ walletId: this.name });
+    }
+    async address() {
+        // High level facade: gets receive address
+        const seedRef = this.walletManager.getSeedRef(this.name);
+        return this.addressManager.derive({
+            seedRef,
+            accountIndex: 0,
+            chain: 'receive',
+            addressIndex: 0,
+            network: this.options.network || 'simnet'
+        }).address;
+    }
+    async balance() {
+        const addr = await this.address();
+        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] }));
+    }
+    async estimateFee(opts) {
+        const u = await this.utxos.list();
+        // Since we are mocking the facade, just return a fake fee
+        return {
+            selectedUtxos: [],
+            fee: 1000n,
+            totalOut: BigInt(opts.amount) + 1000n
+        };
+    }
+    async planSend(opts) {
+        return {};
+    }
+    async sendSimulated(opts) {
+        return `simulated_tx_${Date.now()}`;
+    }
+}
+//# sourceMappingURL=wallet.js.map

package/dist/wallet.js.map

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

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@hardkas/toolkit",
+  "version": "0.11.1-alpha",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "fs-extra": "^11.2.0",
+    "@hardkas/tx-builder": "0.11.1-alpha",
+    "@hardkas/core": "0.11.1-alpha",
+    "@hardkas/jobs": "0.11.1-alpha",
+    "@hardkas/accounts": "0.11.1-alpha",
+    "@hardkas/query-store": "0.11.1-alpha",
+    "@hardkas/artifacts": "0.11.1-alpha",
+    "@hardkas/query": "0.11.1-alpha"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.2",
+    "@types/node": "^20.12.7",
+    "@types/fs-extra": "^11.0.4"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  }
+}

package/src/dag/consensus.ts

@@ -0,0 +1,150 @@
+import { LocalDagStore } from './store.js';
+import { DAGTopology } from './topology.js';
+import { DagBlock, DagStatistics } from './types.js';
+
+export class ConsensusView {
+    // Memoize calculated blue scores to prevent exponential recursion
+    private blueScoreCache = new Map<string, number>();
+
+    public constructor(
+        private readonly store: LocalDagStore,
+        private readonly topology: DAGTopology
+    ) {}
+
+    public clearCache(): void {
+        this.blueScoreCache.clear();
+    }
+
+    public async blueScore(hash: string): Promise<number> {
+        // If provided explicitly in the payload, use it
+        const b = await this.topology.block(hash);
+        if (b.blueScore !== undefined) {
+            return b.blueScore;
+        }
+
+        if (this.blueScoreCache.has(hash)) {
+            return this.blueScoreCache.get(hash)!;
+        }
+
+        if (b.parents.length === 0) {
+            this.blueScoreCache.set(hash, 0);
+            return 0;
+        }
+
+        let maxScore = 0;
+        for (const p of b.parents) {
+            try {
+                const score = await this.blueScore(p);
+                if (score > maxScore) maxScore = score;
+            } catch (e) {
+                // Ignore missing parents (orphans)
+            }
+        }
+
+        const calculatedScore = maxScore + 1;
+        this.blueScoreCache.set(hash, calculatedScore);
+        return calculatedScore;
+    }
+
+    public async confirmations(hash: string): Promise<number> {
+        const isOrphan = await this.isOrphan(hash);
+        if (isOrphan) return 0;
+
+        const allBlocks = this.store.getAllBlocks();
+        const tips = allBlocks.filter(b => this.store.getChildrenHashes(b.hash).length === 0);
+        
+        if (tips.length === 0) return 0;
+
+        let maxScore = -1;
+        let heaviestTip: DagBlock | null = null;
+
+        for (const tip of tips) {
+            const score = await this.blueScore(tip.hash);
+            if (score > maxScore) {
+                maxScore = score;
+                heaviestTip = tip;
+            }
+        }
+
+        if (!heaviestTip) return 0;
+
+        // Verify reachability: does the heaviest tip actually include this block in its past?
+        const reachable = await this.topology.reachability(hash, heaviestTip.hash);
+        if (!reachable) return 0;
+
+        const blockScore = await this.blueScore(hash);
+        return Math.max(0, maxScore - blockScore);
+    }
+
+    private async isOrphan(hash: string): Promise<boolean> {
+        const b = this.store.getBlock(hash);
+        if (!b) return false;
+        if (b.parents.length === 0) return false;
+
+        for (const p of b.parents) {
+            if (!this.store.getBlock(p)) return true;
+        }
+        return false;
+    }
+
+    public async trace(txid: string): Promise<{ txid: string, status: string, foundIn: string[] }> {
+        const allBlocks = this.store.getAllBlocks();
+        const foundInBlocks: string[] = [];
+
+        for (const block of allBlocks) {
+            if (block.transactions && block.transactions.some(tx => tx.id === txid)) {
+                foundInBlocks.push(block.hash);
+            }
+        }
+
+        if (foundInBlocks.length === 0) {
+            return { txid, status: "not_found", foundIn: [] };
+        }
+
+        if (foundInBlocks.length === 1) {
+            const blockHash = foundInBlocks[0]!;
+            const isOrphan = await this.isOrphan(blockHash);
+            return { txid, status: isOrphan ? "orphan" : "accepted", foundIn: foundInBlocks };
+        }
+
+        // Parallel branch conflict detection
+        let isConflict = false;
+        for (let i = 0; i < foundInBlocks.length; i++) {
+            for (let j = i + 1; j < foundInBlocks.length; j++) {
+                const b1 = foundInBlocks[i]!;
+                const b2 = foundInBlocks[j]!;
+                
+                const reach1 = await this.topology.reachability(b1, b2);
+                const reach2 = await this.topology.reachability(b2, b1);
+
+                if (!reach1 && !reach2) {
+                    isConflict = true;
+                    break;
+                }
+            }
+        }
+
+        return {
+            txid,
+            status: isConflict ? "conflict" : "merged",
+            foundIn: foundInBlocks
+        };
+    }
+
+    public async statistics(): Promise<DagStatistics> {
+        const allBlocks = this.store.getAllBlocks();
+        const tips = allBlocks.filter(b => this.store.getChildrenHashes(b.hash).length === 0);
+        
+        let highestBlueScore = 0;
+        for (const b of allBlocks) {
+            const score = await this.blueScore(b.hash);
+            if (score > highestBlueScore) highestBlueScore = score;
+        }
+
+        return {
+            totalBlocks: allBlocks.length,
+            totalTips: tips.length,
+            highestBlueScore
+        };
+    }
+}