@mem-cash/core 0.0.1

package/README.md

@@ -0,0 +1,45 @@
+# @mem-cash/core
+
+Node engine, subscription manager, and mempool acceptance for mem-cash.
+
+## Node
+
+`createNode()` wires together in-memory storage with an optional transaction verifier:
+
+```typescript
+import { createNode } from "@mem-cash/core";
+import { createTxVerifier } from "@mem-cash/validation";
+
+const verifier = await createTxVerifier({ standard: false });
+const node = createNode({ verifier });
+
+node.setChainTip(200, 1700000000);
+node.addUtxo({ txid, vout: 0, satoshis: 10_000n, scriptHash, height: 100 });
+
+const result = node.submitTransaction(rawHex);
+// { success: true, txid, fee, size, affectedScriptHashes }
+
+// Debug without accepting to mempool (per-input VM traces)
+const debug = node.debugTransaction(rawHex);
+// { success: true, txid, fee, size, inputResults: [...] }
+```
+
+## Subscription Manager
+
+Tracks scripthash and header subscriptions, detects status changes, and dispatches notifications:
+
+```typescript
+const consumerId = node.subscriptions.addConsumer((notification) => {
+  if (notification.type === "scripthash") {
+    console.log(notification.scriptHash, notification.status);
+  } else {
+    console.log("new tip:", notification.header.height);
+  }
+});
+```
+
+Subscriber callbacks are isolated with try-catch -- a throwing callback is logged via `console.error` but does not prevent other subscribers from receiving their notifications.
+
+## Mempool Acceptance
+
+Two-phase pattern: the verifier validates (read-only), then `acceptToMempool` performs storage mutations and returns affected scripthashes for notification dispatch.

package/dist/accept.d.ts

@@ -0,0 +1,16 @@
+import type { ScriptHash, Storage } from "@mem-cash/types";
+import type { ValidatedTransaction } from "@mem-cash/validation";
+/** Result of accepting a validated transaction into the mempool. */
+export interface AcceptResult {
+    readonly affectedScriptHashes: ReadonlySet<ScriptHash>;
+}
+/**
+ * Accept a validated transaction into the mempool.
+ *
+ * This is the write side of the evaluate+accept two-phase pattern.
+ * The evaluator validates and returns a ValidatedTransaction (read-only);
+ * this function computes scripthashes from the decoded transaction and
+ * performs the storage mutations.
+ */
+export declare function acceptToMempool(storage: Storage, validatedTx: ValidatedTransaction): AcceptResult;
+//# sourceMappingURL=accept.d.ts.map

package/dist/accept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accept.d.ts","sourceRoot":"","sources":["../src/accept.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAIX,UAAU,EACV,OAAO,EAGP,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;CACvD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,oBAAoB,GAAG,YAAY,CAwFjG"}

package/dist/accept.js

@@ -0,0 +1,103 @@
+import { binToHex, sha256 } from "@bitauth/libauth";
+import { makeOutpointKey } from "@mem-cash/types";
+/**
+ * Accept a validated transaction into the mempool.
+ *
+ * This is the write side of the evaluate+accept two-phase pattern.
+ * The evaluator validates and returns a ValidatedTransaction (read-only);
+ * this function computes scripthashes from the decoded transaction and
+ * performs the storage mutations.
+ */
+export function acceptToMempool(storage, validatedTx) {
+    const { txid, rawHex, fee, size, transaction, sourceOutputs } = validatedTx;
+    // Compute scripthashes for each output
+    const outputScriptHashes = [];
+    for (const output of transaction.outputs) {
+        const scriptHash = binToHex(sha256.hash(output.lockingBytecode));
+        outputScriptHashes.push(scriptHash);
+    }
+    // Create mempool UTXOs for each output
+    for (let vout = 0; vout < transaction.outputs.length; vout++) {
+        const output = transaction.outputs[vout];
+        const scriptHash = outputScriptHashes[vout];
+        if (!output || !scriptHash)
+            continue;
+        const key = makeOutpointKey(txid, vout);
+        const base = {
+            outpoint: { txid, vout },
+            satoshis: output.valueSatoshis,
+            scriptHash,
+            height: 0,
+            lockingBytecode: output.lockingBytecode,
+        };
+        const utxoEntry = output.token
+            ? {
+                ...base,
+                tokenData: {
+                    category: binToHex(output.token.category),
+                    amount: output.token.amount,
+                    ...(output.token.nft
+                        ? {
+                            nft: {
+                                capability: output.token.nft.capability,
+                                commitment: binToHex(output.token.nft.commitment),
+                            },
+                        }
+                        : {}),
+                },
+            }
+            : base;
+        storage.addMempoolUtxo(key, utxoEntry);
+    }
+    // Build MempoolTx entries map
+    const entriesMap = new Map();
+    const parents = new Set();
+    // Process inputs — derive scripthash and outpointKey from decoded tx + sourceOutputs
+    for (let i = 0; i < transaction.inputs.length; i++) {
+        const input = transaction.inputs[i];
+        const sourceOutput = sourceOutputs[i];
+        if (!input || !sourceOutput)
+            continue;
+        const parentTxid = binToHex(input.outpointTransactionHash);
+        const outpointKey = makeOutpointKey(parentTxid, input.outpointIndex);
+        const inputScriptHash = binToHex(sha256.hash(sourceOutput.lockingBytecode));
+        const entry = getOrCreateEntry(entriesMap, inputScriptHash);
+        if ((sourceOutput.height ?? 1) > 0) {
+            entry.confirmedSpends.push(outpointKey);
+        }
+        else {
+            entry.unconfirmedSpends.push(outpointKey);
+            parents.add(parentTxid);
+        }
+    }
+    // Process outputs
+    for (let vout = 0; vout < outputScriptHashes.length; vout++) {
+        const scriptHash = outputScriptHashes[vout];
+        if (!scriptHash)
+            continue;
+        const key = makeOutpointKey(txid, vout);
+        const entry = getOrCreateEntry(entriesMap, scriptHash);
+        entry.outputs.push(key);
+    }
+    const mempoolTx = {
+        txid,
+        fee,
+        size,
+        entries: entriesMap,
+        parents,
+        children: new Set(),
+    };
+    storage.storeRawTx(txid, rawHex);
+    const affectedScriptHashes = storage.addMempoolTx(mempoolTx);
+    return { affectedScriptHashes };
+}
+/** Get or create a MempoolTxScriptHashEntry in the map. */
+function getOrCreateEntry(map, scriptHash) {
+    let entry = map.get(scriptHash);
+    if (!entry) {
+        entry = { confirmedSpends: [], unconfirmedSpends: [], outputs: [] };
+        map.set(scriptHash, entry);
+    }
+    return entry;
+}
+//# sourceMappingURL=accept.js.map

package/dist/accept.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { AcceptResult } from "./accept.js";
+export { acceptToMempool } from "./accept.js";
+export type { AddUtxoParams, MineResult, Node, NodeConfig, SubmitFailure, SubmitResult, SubmitSuccess, } from "./node.js";
+export { createNode } from "./node.js";
+export type { ConsumerHooks, ConsumerId, HeaderNotification, Notification, NotificationCallback, ScriptHashNotification, SubscriptionManager, SubscriptionManagerConfig, } from "./subscriptionManager.js";
+export { createSubscriptionManager } from "./subscriptionManager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EACX,aAAa,EACb,UAAU,EACV,IAAI,EACJ,UAAU,EACV,aAAa,EACb,YAAY,EACZ,aAAa,GACb,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EACX,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { acceptToMempool } from "./accept.js";
+export { createNode } from "./node.js";
+export { createSubscriptionManager } from "./subscriptionManager.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":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAU9C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAWvC,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,74 @@
+import type { TestableStorage } from "@mem-cash/storage";
+import type { ScriptHash, StorageReader } from "@mem-cash/types";
+import type { DebugResult, TxVerifier } from "@mem-cash/validation";
+import type { SubscriptionManager } from "./subscriptionManager.js";
+/** Configuration for the Node. All fields optional. */
+export interface NodeConfig {
+    /** Transaction verifier. When provided, submitTransaction runs full validation. */
+    readonly verifier?: TxVerifier;
+}
+/** Parameters for adding a UTXO. */
+export interface AddUtxoParams {
+    readonly txid: string;
+    readonly vout: number;
+    readonly satoshis: bigint;
+    readonly scriptHash: string;
+    readonly height: number;
+    readonly lockingBytecode?: Uint8Array;
+    readonly isCoinbase?: boolean;
+}
+/** Successful transaction submission. */
+export interface SubmitSuccess {
+    readonly success: true;
+    readonly txid: string;
+    readonly fee: bigint;
+    readonly size: number;
+    readonly affectedScriptHashes: ReadonlySet<ScriptHash>;
+}
+/** Failed transaction submission. */
+export interface SubmitFailure {
+    readonly success: false;
+    /** BCHN reject code (e.g. REJECT_INVALID, REJECT_NONSTANDARD). */
+    readonly code: number;
+    /** BCHN strRejectReason. */
+    readonly error: string;
+    /** BCHN strDebugMessage — optional extra context. */
+    readonly debugMessage?: string;
+}
+/** Result of submitting a transaction. */
+export type SubmitResult = SubmitSuccess | SubmitFailure;
+/** Result of mining blocks. */
+export interface MineResult {
+    /** New chain tip height after mining. */
+    readonly height: number;
+    /** All scripthashes affected by confirming mempool transactions. */
+    readonly affectedScriptHashes: ReadonlySet<ScriptHash>;
+}
+/** The core node engine with in-memory storage. */
+export interface Node extends StorageReader {
+    /** Submit a raw transaction hex. */
+    readonly submitTransaction: (rawHex: string) => SubmitResult;
+    /** Debug a raw transaction: run full validation with per-input traces, without accepting to mempool. */
+    readonly debugTransaction: (rawHex: string) => DebugResult | SubmitFailure;
+    /** Mine a block: confirms all mempool transactions, advances chain tip. */
+    readonly mine: (timestamp?: number) => MineResult;
+    /** Set chain tip with 11 headers at the given timestamp (sets both height and MTP). */
+    readonly setChainTip: (height: number, timestamp: number) => void;
+    /** Add a UTXO to the confirmed set. */
+    readonly addUtxo: (params: AddUtxoParams) => void;
+    /** The underlying storage with test helpers for direct manipulation. */
+    readonly storage: TestableStorage;
+    /** The subscription manager. */
+    readonly subscriptions: SubscriptionManager;
+}
+/**
+ * Create a core node with in-memory storage.
+ *
+ * Wires together storage, optional transaction verifier, and subscription manager.
+ *
+ * When `config.verifier` is provided, `submitTransaction` runs full consensus
+ * and policy checks. Without a verifier, transactions are decoded and accepted
+ * directly (useful for testing or trusted-input scenarios).
+ */
+export declare function createNode(config?: NodeConfig): Node;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,KAAK,EAMX,UAAU,EACV,aAAa,EAEb,MAAM,iBAAiB,CAAC;AAOzB,OAAO,KAAK,EAEX,WAAW,EAEX,UAAU,EAEV,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,uDAAuD;AACvD,MAAM,WAAW,UAAU;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;CAC/B;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;CACvD;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,0CAA0C;AAC1C,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,aAAa,CAAC;AAEzD,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;CACvD;AAED,mDAAmD;AACnD,MAAM,WAAW,IAAK,SAAQ,aAAa;IAC1C,oCAAoC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,YAAY,CAAC;IAE7D,wGAAwG;IACxG,QAAQ,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,WAAW,GAAG,aAAa,CAAC;IAE3E,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,UAAU,CAAC;IAElD,uFAAuF;IACvF,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAElE,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAElD,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAElC,gCAAgC;IAChC,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;CAC5C;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAuPpD"}

package/dist/node.js

@@ -0,0 +1,251 @@
+import { binToHex, decodeTransactionBch, hashTransactionUiOrder, hexToBin, sha256, utf8ToBin, } from "@bitauth/libauth";
+import { createMemoryStorage } from "@mem-cash/storage";
+import { computeMedianTimePast, makeOutpointKey, REJECT_INVALID, REJECT_MALFORMED, } from "@mem-cash/types";
+import { acceptToMempool } from "./accept.js";
+import { createSubscriptionManager } from "./subscriptionManager.js";
+/**
+ * Create a core node with in-memory storage.
+ *
+ * Wires together storage, optional transaction verifier, and subscription manager.
+ *
+ * When `config.verifier` is provided, `submitTransaction` runs full consensus
+ * and policy checks. Without a verifier, transactions are decoded and accepted
+ * directly (useful for testing or trusted-input scenarios).
+ */
+export function createNode(config) {
+    const storage = createMemoryStorage();
+    const verifier = config?.verifier;
+    const subscriptions = createSubscriptionManager(storage);
+    function deriveChainState() {
+        const tip = storage.getTip();
+        if (!tip)
+            return null;
+        return {
+            height: tip.height,
+            medianTimePast: computeMedianTimePast(storage, tip.height),
+        };
+    }
+    function resolveSourceOutputs(rawHex) {
+        const rawBytes = hexToBin(rawHex);
+        const decoded = decodeTransactionBch(rawBytes);
+        if (typeof decoded === "string")
+            return {
+                ok: false,
+                code: REJECT_MALFORMED,
+                error: "TX decode failed",
+                debugMessage: decoded,
+            };
+        const sourceOutputs = [];
+        for (const input of decoded.inputs) {
+            const parentTxid = binToHex(input.outpointTransactionHash);
+            const key = makeOutpointKey(parentTxid, input.outpointIndex);
+            const utxo = storage.getUtxoByOutpoint(key);
+            if (!utxo) {
+                return { ok: false, code: REJECT_INVALID, error: "bad-txns-inputs-missingorspent" };
+            }
+            sourceOutputs.push(utxoToSourceOutput(utxo));
+        }
+        return { ok: true, outputs: sourceOutputs };
+    }
+    /** Convert a reject failure to a SubmitFailure, avoiding undefined in optional fields. */
+    function toSubmitFailure(f) {
+        const result = { success: false, code: f.code, error: f.error };
+        if (f.debugMessage != null)
+            result.debugMessage = f.debugMessage;
+        return result;
+    }
+    function submitTransaction(rawHex) {
+        const resolved = resolveSourceOutputs(rawHex);
+        if (!resolved.ok)
+            return toSubmitFailure(resolved);
+        const sourceOutputs = resolved.outputs;
+        let validatedTx;
+        if (verifier) {
+            const chainState = deriveChainState();
+            if (!chainState) {
+                return { success: false, code: REJECT_INVALID, error: "No chain tip set" };
+            }
+            const result = verifier.verify(rawHex, sourceOutputs, chainState);
+            if (!result.success)
+                return toSubmitFailure(result);
+            validatedTx = result.validatedTx;
+        }
+        else {
+            const rawBytes = hexToBin(rawHex);
+            const decoded = decodeTransactionBch(rawBytes);
+            if (typeof decoded === "string") {
+                return {
+                    success: false,
+                    code: REJECT_MALFORMED,
+                    error: "TX decode failed",
+                    debugMessage: decoded,
+                };
+            }
+            const txid = binToHex(hashTransactionUiOrder(rawBytes));
+            const inputSum = sourceOutputs.reduce((sum, so) => sum + so.valueSatoshis, 0n);
+            const outputSum = decoded.outputs.reduce((sum, o) => sum + o.valueSatoshis, 0n);
+            validatedTx = {
+                txid,
+                rawHex,
+                fee: inputSum - outputSum,
+                size: rawBytes.length,
+                transaction: decoded,
+                sourceOutputs,
+            };
+        }
+        const { affectedScriptHashes } = acceptToMempool(storage, validatedTx);
+        subscriptions.notifyChanges(affectedScriptHashes);
+        return {
+            success: true,
+            txid: validatedTx.txid,
+            fee: validatedTx.fee,
+            size: validatedTx.size,
+            affectedScriptHashes,
+        };
+    }
+    function debugTransaction(rawHex) {
+        if (!verifier) {
+            return { success: false, code: REJECT_INVALID, error: "No verifier configured" };
+        }
+        const resolved = resolveSourceOutputs(rawHex);
+        if (!resolved.ok)
+            return toSubmitFailure(resolved);
+        const chainState = deriveChainState();
+        if (!chainState) {
+            return { success: false, code: REJECT_INVALID, error: "No chain tip set" };
+        }
+        return verifier.debug(rawHex, resolved.outputs, chainState);
+    }
+    function setChainTip(height, timestamp) {
+        const startHeight = Math.max(0, height - 10);
+        for (let h = startHeight; h <= height; h++) {
+            storage._test.header.add({
+                hash: h.toString(16).padStart(64, "0"),
+                height: h,
+                timestamp,
+            });
+        }
+    }
+    function addUtxo(params) {
+        storage._test.utxo.add(Object.assign({
+            txid: params.txid,
+            vout: params.vout,
+            satoshis: params.satoshis,
+            scriptHash: params.scriptHash,
+            height: params.height,
+            lockingBytecode: params.lockingBytecode ?? new Uint8Array(0),
+        }, params.isCoinbase ? { isCoinbase: true } : {}));
+    }
+    function mine(timestamp) {
+        const tip = storage.getTip();
+        const newHeight = (tip?.height ?? 0) + 1;
+        const ts = timestamp ?? 1700000000 + newHeight;
+        const txids = storage.getMempoolTxids();
+        const processedTxs = [];
+        for (const txid of txids) {
+            const mempoolTx = storage.getMempoolTx(txid);
+            if (!mempoolTx)
+                continue;
+            const rawHex = storage.getRawTx(txid);
+            const inputs = [];
+            const outputs = [];
+            for (const [, entry] of mempoolTx.entries) {
+                for (const key of entry.confirmedSpends) {
+                    const [prevTxid, prevVout] = key.split(":");
+                    inputs.push({ prevOutpoint: { txid: prevTxid, vout: Number(prevVout) } });
+                }
+                for (const key of entry.unconfirmedSpends) {
+                    const [prevTxid, prevVout] = key.split(":");
+                    inputs.push({ prevOutpoint: { txid: prevTxid, vout: Number(prevVout) } });
+                }
+                for (const key of entry.outputs) {
+                    const utxo = storage.getMempoolUtxo(key);
+                    if (utxo) {
+                        outputs.push({ outpointKey: key, utxo: { ...utxo, height: newHeight } });
+                    }
+                }
+            }
+            const ptx = { txid, inputs, outputs, fee: mempoolTx.fee };
+            if (rawHex)
+                ptx.rawHex = rawHex;
+            processedTxs.push(ptx);
+        }
+        storage.clearMempool();
+        const blockHash = binToHex(sha256.hash(utf8ToBin(`block-${newHeight}`)));
+        const header = {
+            hash: blockHash,
+            height: newHeight,
+            version: 1,
+            prevHash: tip?.hash ?? "0".repeat(64),
+            merkleRoot: "0".repeat(64),
+            timestamp: ts,
+            bits: 0x1d00ffff,
+            nonce: 0,
+            hex: "0".repeat(160),
+        };
+        const block = {
+            height: newHeight,
+            hash: blockHash,
+            header,
+            transactions: processedTxs,
+        };
+        const affectedScriptHashes = storage.applyBlock(block);
+        setChainTip(newHeight, ts);
+        subscriptions.notifyChanges(affectedScriptHashes);
+        subscriptions.notifyNewTip(header);
+        return { height: newHeight, affectedScriptHashes };
+    }
+    return {
+        // StorageReader delegation
+        getHeader: storage.getHeader,
+        getHeaderByHash: storage.getHeaderByHash,
+        getTip: storage.getTip,
+        getHistory: storage.getHistory,
+        getMempoolHistory: storage.getMempoolHistory,
+        getBalance: storage.getBalance,
+        getUtxos: storage.getUtxos,
+        getTx: storage.getTx,
+        getRawTx: storage.getRawTx,
+        getScriptHashStatus: storage.getScriptHashStatus,
+        getMempoolTx: storage.getMempoolTx,
+        getTxidsAtHeight: storage.getTxidsAtHeight,
+        getUtxoByOutpoint: storage.getUtxoByOutpoint,
+        getMempoolTxids: storage.getMempoolTxids,
+        getMempoolUtxo: storage.getMempoolUtxo,
+        // Node operations
+        submitTransaction,
+        debugTransaction,
+        mine,
+        setChainTip,
+        addUtxo,
+        storage,
+        subscriptions,
+    };
+}
+/** Map a storage UtxoEntry to a validation SourceOutput. */
+function utxoToSourceOutput(utxo) {
+    const so = {
+        lockingBytecode: utxo.lockingBytecode,
+        valueSatoshis: utxo.satoshis,
+    };
+    if (utxo.height > 0) {
+        so.height = utxo.height;
+    }
+    if (utxo.isCoinbase) {
+        so.isCoinbase = true;
+    }
+    if (utxo.tokenData) {
+        so.token = {
+            category: hexToBin(utxo.tokenData.category),
+            amount: utxo.tokenData.amount,
+            nft: utxo.tokenData.nft
+                ? {
+                    commitment: hexToBin(utxo.tokenData.nft.commitment),
+                    capability: utxo.tokenData.nft.capability,
+                }
+                : undefined,
+        };
+    }
+    return so;
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

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

package/dist/subscriptionManager.d.ts

@@ -0,0 +1,83 @@
+import type { BlockHeader, ScriptHash, StorageReader } from "@mem-cash/types";
+/** Opaque consumer identifier. */
+export type ConsumerId = number;
+/** Notification sent when a scripthash status changes. */
+export interface ScriptHashNotification {
+    readonly type: "scripthash";
+    readonly scriptHash: ScriptHash;
+    readonly status: string | null;
+}
+/** Notification sent when a new block header arrives. */
+export interface HeaderNotification {
+    readonly type: "header";
+    readonly header: BlockHeader;
+}
+/** Union of all notification types. */
+export type Notification = ScriptHashNotification | HeaderNotification;
+/** Callback invoked when a subscribed event fires. */
+export type NotificationCallback = (notification: Notification) => void;
+/** Subscription hooks bound to a single consumer. */
+export interface ConsumerHooks {
+    readonly subscribeScriptHash: (scriptHash: ScriptHash) => void;
+    readonly unsubscribeScriptHash: (scriptHash: ScriptHash) => boolean;
+    readonly subscribeHeaders: () => void;
+    readonly unsubscribeHeaders: () => boolean;
+}
+/** Optional configuration for the subscription manager. */
+export interface SubscriptionManagerConfig {
+    /** Maximum scripthash subscriptions per consumer. 0 = unlimited. */
+    readonly maxSubscriptionsPerConsumer?: number;
+}
+/** Manages scripthash and header subscriptions across multiple consumers. */
+export interface SubscriptionManager {
+    /**
+     * Register a new consumer with the given notification callback.
+     * Returns the consumer's unique ID.
+     */
+    addConsumer(callback: NotificationCallback): ConsumerId;
+    /** Remove a consumer and all its subscriptions. */
+    removeConsumer(id: ConsumerId): void;
+    /**
+     * Subscribe a consumer to a scripthash.
+     * Records the current status as baseline so notifications only fire on changes.
+     */
+    subscribeScriptHash(consumerId: ConsumerId, scriptHash: ScriptHash): void;
+    /** Unsubscribe a consumer from a scripthash. Returns true if was subscribed. */
+    unsubscribeScriptHash(consumerId: ConsumerId, scriptHash: ScriptHash): boolean;
+    /** Subscribe a consumer to header notifications. */
+    subscribeHeaders(consumerId: ConsumerId): void;
+    /** Unsubscribe a consumer from headers. Returns true if was subscribed. */
+    unsubscribeHeaders(consumerId: ConsumerId): boolean;
+    /**
+     * Process a set of affected scripthashes (e.g. after a block or mempool change).
+     * Recomputes status for each affected scripthash, compares with last-notified
+     * status per subscriber, and dispatches notifications for changes.
+     * Returns the number of notifications dispatched.
+     */
+    notifyChanges(affectedScriptHashes: ReadonlySet<ScriptHash>): number;
+    /**
+     * Notify all header subscribers of a new chain tip.
+     * Returns the number of notifications dispatched.
+     */
+    notifyNewTip(header: BlockHeader): number;
+    /** Generate subscription hooks bound to a specific consumer. */
+    hooksForConsumer(consumerId: ConsumerId): ConsumerHooks;
+    /** Number of consumers subscribed to a specific scripthash. */
+    getScriptHashSubscriberCount(scriptHash: ScriptHash): number;
+    /** Number of consumers subscribed to header notifications. */
+    getHeaderSubscriberCount(): number;
+    /** Number of scripthash subscriptions for a consumer. */
+    getConsumerSubscriptionCount(consumerId: ConsumerId): number;
+    /** Total number of registered consumers. */
+    getConsumerCount(): number;
+    /** Total number of unique scripthash subscriptions across all consumers. */
+    getTotalSubscriptionCount(): number;
+}
+/**
+ * Create a new subscription manager.
+ *
+ * @param storage - Read-only storage for status hash computation
+ * @param config - Optional configuration
+ */
+export declare function createSubscriptionManager(storage: StorageReader, config?: SubscriptionManagerConfig): SubscriptionManager;
+//# sourceMappingURL=subscriptionManager.d.ts.map

package/dist/subscriptionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptionManager.d.ts","sourceRoot":"","sources":["../src/subscriptionManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE9E,kCAAkC;AAClC,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAIhC,0DAA0D;AAC1D,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC7B;AAED,uCAAuC;AACvC,MAAM,MAAM,YAAY,GAAG,sBAAsB,GAAG,kBAAkB,CAAC;AAEvE,sDAAsD;AACtD,MAAM,MAAM,oBAAoB,GAAG,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;AAIxE,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAC/D,QAAQ,CAAC,qBAAqB,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,OAAO,CAAC;IACpE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,IAAI,CAAC;IACtC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CAAC;CAC3C;AAID,2DAA2D;AAC3D,MAAM,WAAW,yBAAyB;IACzC,oEAAoE;IACpE,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM,CAAC;CAC9C;AAID,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IACnC;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,oBAAoB,GAAG,UAAU,CAAC;IAExD,mDAAmD;IACnD,cAAc,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAAC;IAErC;;;OAGG;IACH,mBAAmB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAE1E,gFAAgF;IAChF,qBAAqB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC;IAE/E,oDAAoD;IACpD,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAE/C,2EAA2E;IAC3E,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC;IAEpD;;;;;OAKG;IACH,aAAa,CAAC,oBAAoB,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC;IAErE;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;IAE1C,gEAAgE;IAChE,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,CAAC;IAIxD,+DAA+D;IAC/D,4BAA4B,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC;IAE7D,8DAA8D;IAC9D,wBAAwB,IAAI,MAAM,CAAC;IAEnC,yDAAyD;IACzD,4BAA4B,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC;IAE7D,4CAA4C;IAC5C,gBAAgB,IAAI,MAAM,CAAC;IAE3B,4EAA4E;IAC5E,yBAAyB,IAAI,MAAM,CAAC;CACpC;AAcD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,yBAAyB,GAChC,mBAAmB,CAgNrB"}

package/dist/subscriptionManager.js

@@ -0,0 +1,193 @@
+// --- Factory ---
+/**
+ * Create a new subscription manager.
+ *
+ * @param storage - Read-only storage for status hash computation
+ * @param config - Optional configuration
+ */
+export function createSubscriptionManager(storage, config) {
+    let nextId = 1;
+    const consumers = new Map();
+    const scriptHashSubs = new Map();
+    const headerSubs = new Set();
+    const maxSubs = config?.maxSubscriptionsPerConsumer ?? 0;
+    function addConsumer(callback) {
+        const id = nextId++;
+        consumers.set(id, {
+            callback,
+            scriptHashes: new Set(),
+            headerSubscribed: false,
+            lastStatuses: new Map(),
+        });
+        return id;
+    }
+    function removeConsumer(id) {
+        const state = consumers.get(id);
+        if (!state)
+            return;
+        // Remove from all scripthash subscriber sets
+        for (const sh of state.scriptHashes) {
+            const subs = scriptHashSubs.get(sh);
+            if (subs) {
+                subs.delete(id);
+                if (subs.size === 0)
+                    scriptHashSubs.delete(sh);
+            }
+        }
+        // Remove from header subscribers
+        headerSubs.delete(id);
+        consumers.delete(id);
+    }
+    function subscribeScriptHash(consumerId, scriptHash) {
+        const state = consumers.get(consumerId);
+        if (!state)
+            return;
+        // Already subscribed — idempotent
+        if (state.scriptHashes.has(scriptHash))
+            return;
+        // Check subscription limit
+        if (maxSubs > 0 && state.scriptHashes.size >= maxSubs)
+            return;
+        // Register
+        state.scriptHashes.add(scriptHash);
+        let subs = scriptHashSubs.get(scriptHash);
+        if (!subs) {
+            subs = new Set();
+            scriptHashSubs.set(scriptHash, subs);
+        }
+        subs.add(consumerId);
+        // Record baseline status so first notification only fires on actual change
+        const currentStatus = storage.getScriptHashStatus(scriptHash);
+        state.lastStatuses.set(scriptHash, currentStatus);
+    }
+    function unsubscribeScriptHash(consumerId, scriptHash) {
+        const state = consumers.get(consumerId);
+        if (!state)
+            return false;
+        if (!state.scriptHashes.has(scriptHash))
+            return false;
+        state.scriptHashes.delete(scriptHash);
+        state.lastStatuses.delete(scriptHash);
+        const subs = scriptHashSubs.get(scriptHash);
+        if (subs) {
+            subs.delete(consumerId);
+            if (subs.size === 0)
+                scriptHashSubs.delete(scriptHash);
+        }
+        return true;
+    }
+    function subscribeHeaders(consumerId) {
+        const state = consumers.get(consumerId);
+        if (!state)
+            return;
+        state.headerSubscribed = true;
+        headerSubs.add(consumerId);
+    }
+    function unsubscribeHeaders(consumerId) {
+        const state = consumers.get(consumerId);
+        if (!state)
+            return false;
+        if (!state.headerSubscribed)
+            return false;
+        state.headerSubscribed = false;
+        headerSubs.delete(consumerId);
+        return true;
+    }
+    function notifyChanges(affectedScriptHashes) {
+        let count = 0;
+        for (const scriptHash of affectedScriptHashes) {
+            const subs = scriptHashSubs.get(scriptHash);
+            if (!subs || subs.size === 0)
+                continue;
+            // Compute status once per scripthash
+            const newStatus = storage.getScriptHashStatus(scriptHash);
+            for (const consumerId of subs) {
+                const state = consumers.get(consumerId);
+                if (!state)
+                    continue;
+                const lastStatus = state.lastStatuses.get(scriptHash);
+                // Only notify if status actually changed
+                // undefined means never subscribed (shouldn't happen), treat as changed
+                if (lastStatus !== undefined && lastStatus === newStatus)
+                    continue;
+                state.lastStatuses.set(scriptHash, newStatus);
+                try {
+                    state.callback({
+                        type: "scripthash",
+                        scriptHash,
+                        status: newStatus,
+                    });
+                }
+                catch (e) {
+                    console.error("Subscriber callback threw during scripthash notification:", e);
+                }
+                count++;
+            }
+        }
+        return count;
+    }
+    function notifyNewTip(header) {
+        let count = 0;
+        const notification = {
+            type: "header",
+            header,
+        };
+        for (const consumerId of headerSubs) {
+            const state = consumers.get(consumerId);
+            if (!state)
+                continue;
+            try {
+                state.callback(notification);
+            }
+            catch (e) {
+                console.error("Subscriber callback threw during header notification:", e);
+            }
+            count++;
+        }
+        return count;
+    }
+    function hooksForConsumer(consumerId) {
+        return {
+            subscribeScriptHash: (scriptHash) => subscribeScriptHash(consumerId, scriptHash),
+            unsubscribeScriptHash: (scriptHash) => unsubscribeScriptHash(consumerId, scriptHash),
+            subscribeHeaders: () => subscribeHeaders(consumerId),
+            unsubscribeHeaders: () => unsubscribeHeaders(consumerId),
+        };
+    }
+    function getScriptHashSubscriberCount(scriptHash) {
+        return scriptHashSubs.get(scriptHash)?.size ?? 0;
+    }
+    function getHeaderSubscriberCount() {
+        return headerSubs.size;
+    }
+    function getConsumerSubscriptionCount(consumerId) {
+        return consumers.get(consumerId)?.scriptHashes.size ?? 0;
+    }
+    function getConsumerCount() {
+        return consumers.size;
+    }
+    function getTotalSubscriptionCount() {
+        let total = 0;
+        for (const subs of scriptHashSubs.values()) {
+            total += subs.size;
+        }
+        return total;
+    }
+    return {
+        addConsumer,
+        removeConsumer,
+        subscribeScriptHash,
+        unsubscribeScriptHash,
+        subscribeHeaders,
+        unsubscribeHeaders,
+        notifyChanges,
+        notifyNewTip,
+        hooksForConsumer,
+        getScriptHashSubscriberCount,
+        getHeaderSubscriberCount,
+        getConsumerSubscriptionCount,
+        getConsumerCount,
+        getTotalSubscriptionCount,
+    };
+}
+//# sourceMappingURL=subscriptionManager.js.map

package/dist/subscriptionManager.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+	"name": "@mem-cash/core",
+	"version": "0.0.1",
+	"description": "Node engine, subscription manager, and mempool acceptance for mem-cash",
+	"type": "module",
+	"sideEffects": false,
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist/",
+		"README.md",
+		"LICENSE"
+	],
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/mainnet-pat/mem-cash.git",
+		"directory": "packages/core"
+	},
+	"keywords": [
+		"bitcoin-cash",
+		"electrum",
+		"node",
+		"subscriptions",
+		"mempool"
+	],
+	"engines": {
+		"node": ">=20"
+	},
+	"scripts": {
+		"prepublishOnly": "tsc -b"
+	},
+	"dependencies": {
+		"@bitauth/libauth": "^3.1.0-next.8",
+		"@mem-cash/storage": "0.0.1",
+		"@mem-cash/types": "0.0.1"
+	},
+	"peerDependencies": {
+		"@mem-cash/validation": "0.0.1"
+	},
+	"peerDependenciesMeta": {
+		"@mem-cash/validation": {
+			"optional": true
+		}
+	}
+}