@mem-cash/core

@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:

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:

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.