@mem-cash/storage

In-memory implementation of the Storage interface from @mem-cash/types.

Usage

import { createMemoryStorage } from "@mem-cash/storage";

const storage = createMemoryStorage();

// StorageReader methods
storage.getHeader(height);
storage.getHistory(scriptHash);
storage.getBalance(scriptHash);
storage.getUtxos(scriptHash);
storage.getScriptHashStatus(scriptHash);

// StorageWriter methods
storage.applyBlock(block);
storage.undoBlock(height);
storage.addMempoolTx(tx);

Defensive Copies

All reader methods that return UtxoEntry objects (getUtxos, getUtxoByOutpoint, getMempoolUtxo) return cloned entries with copied lockingBytecode buffers. This prevents external code from mutating internal storage state. getTxidsAtHeight also returns a shallow copy.

Undo snapshots created during applyBlock clone spent UTXOs so that reorgs restore clean data even if callers mutated returned entries.

Mempool Child Removal

removeMempoolTx uses iterative traversal (not recursion) to cascade-delete descendant transactions, preventing stack overflow on deep chains.

Test Helpers

createMemoryStorage() returns a TestableStorage with a _test namespace for direct state manipulation:

storage._test.utxo.add({ txid, vout, satoshis, scriptHash, height });
storage._test.header.add({ hash, height, timestamp });
storage._test.mempool.add({ txid, fee, size, inputs, outputs });
storage._test.tx.add({ txid, height, rawHex });
storage._test.history.add({ scriptHash, entries });
storage._test.reset();