@mem-cash/electrum 0.0.1

package/README.md

@@ -0,0 +1,143 @@
+# @mem-cash/electrum
+
+Electrum Cash protocol handlers, dispatch, and the `Indexer` facade. Modelled after
+[Fulcrum](https://github.com/cculianu/Fulcrum), the production C++ Electrum Cash indexer -- error messages, history sort order, status hash computation, and
+protocol behavior are aligned with Fulcrum's implementation.
+
+## Protocol Coverage
+
+All 53 Fulcrum client RPC methods are implemented:
+
+| Category | Methods |
+|---|---|
+| `blockchain.scripthash.*` | get_balance, get_history, get_mempool, listunspent, subscribe, unsubscribe, get_status, get_first_use |
+| `blockchain.address.*` | get_balance, get_history, get_mempool, listunspent, subscribe, unsubscribe, get_scripthash, get_status, get_first_use |
+| `blockchain.transaction.*` | get, get_merkle, id_from_pos, broadcast, broadcast_package, get_height, get_confirmed_blockhash, subscribe, unsubscribe |
+| `blockchain.transaction.dsproof.*` | get, list, subscribe, unsubscribe |
+| `blockchain.block.*` / `blockchain.headers.*` | header, headers, header.get, headers.get_tip, headers.subscribe, headers.unsubscribe |
+| `blockchain.utxo.*` | get_info |
+| `mempool.*` | get_fee_histogram, get_info |
+| `server.*` | version, ping, features, banner, donation_address, add_peer, peers.subscribe |
+| `blockchain.estimatefee` / `blockchain.relayfee` | fee estimation |
+| `blockchain.rpa.*` / `blockchain.reusable.*` / `daemon.passthrough` | stubs (not supported) |
+
+## Quick Start
+
+`createIndexer()` wires together storage, validation, subscriptions, and protocol
+dispatch into a single instance. All interaction goes through `request()`.
+
+```typescript
+import { createIndexer } from "@mem-cash/electrum";
+import { binToHex, sha256 } from "@bitauth/libauth";
+
+const indexer = createIndexer({ standard: false });
+indexer.setChainTip(200, 1700000000);
+
+// OP_1 (always-true script) for simplicity
+const lockingBytecode = Uint8Array.of(0x51);
+const scriptHash = binToHex(sha256.hash(lockingBytecode));
+
+indexer.addUtxo({
+    txid: "aa".repeat(32),
+    vout: 0,
+    satoshis: 10_000n,
+    scriptHash,
+    height: 100,
+    lockingBytecode,
+});
+
+// Query balance
+const balance = await indexer.request("blockchain.scripthash.get_balance", [scriptHash]);
+
+// Query unspent outputs
+const utxos = await indexer.request("blockchain.scripthash.listunspent", [scriptHash]);
+
+// Submit a transaction (verify + accept to mempool in one call)
+const result = indexer.submitTransaction(rawHex);
+
+// Or broadcast via the Electrum protocol method
+const txid = await indexer.request("blockchain.transaction.broadcast", [rawHex]);
+```
+
+## Subscriptions
+
+```typescript
+// Subscribe to scripthash status changes
+const unsub = await indexer.subscribe(
+    "blockchain.scripthash.subscribe",
+    [scriptHash],
+    ([sh, status]) => console.log("status changed:", sh, status),
+);
+
+// Subscribe to new block headers
+await indexer.subscribe(
+    "blockchain.headers.subscribe",
+    [],
+    ([header]) => console.log("new tip:", header.height),
+);
+
+// Unsubscribe
+await unsub();
+```
+
+## Test Helpers
+
+`test.*` RPC methods are available by default for setting up chain state.
+To disable them (e.g. in production), pass `disableTestHandlers: true`:
+
+```typescript
+const indexer = createIndexer({ disableTestHandlers: true });
+```
+
+When enabled:
+
+```typescript
+await indexer.request("test.set_chain_tip", [200, 1700000000]);
+await indexer.request("test.add_utxo", [address, { satoshis: 10000, height: 100 }]);
+await indexer.request("test.mine", [address, 1]); // max 1000 blocks per call
+
+// Debug a transaction (per-input VM traces, without accepting to mempool)
+const debug = await indexer.request("test.debugTransaction", [rawHex]);
+// → { success: true, txid, fee, size, inputResults: [{ inputIndex: 0, success: true }, ...] }
+// → { success: false, code, error, inputResults: [{ inputIndex: 0, success: false, error: "..." }] }
+
+await indexer.request("test.reset", []);
+```
+
+## Resource Limits
+
+- **`blockchain.block.header` / `blockchain.block.headers`** -- `cp_height` capped at 1,000,000 to prevent DoS via huge merkle tree allocations
+- **`blockchain.transaction.broadcast_package`** -- max 1,000 transactions per call
+- **`test.mine`** -- max 1,000 blocks per call
+- Internal decoder errors are not exposed in RPC responses
+
+## Fulcrum Compatibility
+
+- **Error strings** match BCHN's `strRejectReason` (e.g. `bad-txns-prevout-null`, `min relay fee not met`)
+- **Reject codes** use BCHN values (`REJECT_INVALID`, `REJECT_NONSTANDARD`, etc.)
+- **Broadcast errors** use Fulcrum's format: `"the transaction was rejected by network rules.\n\n<reason> (code <code>)\n"`
+- **Mempool history sort** matches Fulcrum: height 0 (confirmed parents) before height -1 (unconfirmed parents), within each group sorted by txHash
+- **Status hash** computation uses the same `txHash:height:` concatenation and single SHA-256
+- **Two-pass script verification** distinguishes `mandatory-script-verify-flag-failed` from `non-mandatory-script-verify-flag`
+
+## Architecture
+
+```
++-----------------------------------------+
+|            Protocol Layer               |
+|  dispatch() -> handler -> storage query |
+|  subscriptions -> notifyChanges()       |
+|  acceptToMempool() -> storage mutations |
++-----------------------------------------+
+|           Validation Layer              |
+|  createTxVerifier() -> verify()/debug() |
+|  consensus checks -> policy -> VM       |
++-----------------------------------------+
+|            Storage Layer                |
+|  createMemoryStorage() -> Storage       |
+|  UTXO set, history, headers, mempool   |
++-----------------------------------------+
+|              Core Layer                 |
+|  types, primitives, storage interfaces |
++-----------------------------------------+
+```

package/dist/address.d.ts

@@ -0,0 +1,20 @@
+import type { HandlerResult, ProtocolContext } from "./types.js";
+/** blockchain.address.get_balance */
+export declare const addressGetBalance: (ctx: ProtocolContext, params: unknown[]) => HandlerResult;
+/** blockchain.address.get_history */
+export declare const addressGetHistory: (ctx: ProtocolContext, params: unknown[]) => HandlerResult;
+/** blockchain.address.get_mempool */
+export declare const addressGetMempool: (ctx: ProtocolContext, params: unknown[]) => HandlerResult;
+/** blockchain.address.listunspent */
+export declare const addressListUnspent: (ctx: ProtocolContext, params: unknown[]) => HandlerResult;
+/** blockchain.address.subscribe — delegates to scripthash.subscribe. */
+export declare const addressSubscribe: (ctx: ProtocolContext, params: unknown[]) => HandlerResult;
+/** blockchain.address.unsubscribe */
+export declare const addressUnsubscribe: (ctx: ProtocolContext, params: unknown[]) => HandlerResult;
+/** blockchain.address.get_status */
+export declare const addressGetStatus: (ctx: ProtocolContext, params: unknown[]) => HandlerResult;
+/** blockchain.address.get_first_use */
+export declare const addressGetFirstUse: (ctx: ProtocolContext, params: unknown[]) => HandlerResult;
+/** blockchain.address.get_scripthash */
+export declare function addressGetScripthash(_ctx: ProtocolContext, params: unknown[]): HandlerResult;
+//# sourceMappingURL=address.d.ts.map

package/dist/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA0BjE,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,QAVrB,eAAe,UAAU,OAAO,EAAE,KAAK,aAU8B,CAAC;AAE/E,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,QAbrB,eAAe,UAAU,OAAO,EAAE,KAAK,aAa8B,CAAC;AAE/E,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,QAhBrB,eAAe,UAAU,OAAO,EAAE,KAAK,aAgB8B,CAAC;AAE/E,qCAAqC;AACrC,eAAO,MAAM,kBAAkB,QAnBtB,eAAe,UAAU,OAAO,EAAE,KAAK,aAmBgC,CAAC;AAEjF,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,QAtBpB,eAAe,UAAU,OAAO,EAAE,KAAK,aAsB4B,CAAC;AAE7E,qCAAqC;AACrC,eAAO,MAAM,kBAAkB,QAzBtB,eAAe,UAAU,OAAO,EAAE,KAAK,aAyBgC,CAAC;AAEjF,oCAAoC;AACpC,eAAO,MAAM,gBAAgB,QA5BpB,eAAe,UAAU,OAAO,EAAE,KAAK,aA4B4B,CAAC;AAE7E,uCAAuC;AACvC,eAAO,MAAM,kBAAkB,QA/BtB,eAAe,UAAU,OAAO,EAAE,KAAK,aA+BgC,CAAC;AAEjF,wCAAwC;AACxC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAK5F"}

package/dist/address.js

@@ -0,0 +1,51 @@
+import { binToHex, cashAddressToLockingBytecode, sha256 } from "@bitauth/libauth";
+import * as scripthashHandlers from "./scripthash.js";
+import { invalidParams } from "./types.js";
+/** Decode a cash address to its scripthash. Returns null on failure. */
+function addressToScriptHash(address) {
+    const result = cashAddressToLockingBytecode(address);
+    if (typeof result === "string")
+        return null;
+    return binToHex(sha256.hash(result.bytecode));
+}
+/**
+ * Rewrite params[0] from address to scripthash, then delegate to a
+ * scripthash handler. The response is identical — Fulcrum's address.*
+ * methods return the same shapes as scripthash.* methods.
+ */
+function withScriptHash(handler) {
+    return (ctx, params) => {
+        if (typeof params[0] !== "string")
+            return invalidParams("Invalid address");
+        const scriptHash = addressToScriptHash(params[0]);
+        if (scriptHash === null)
+            return invalidParams("Invalid address");
+        return handler(ctx, [scriptHash, ...params.slice(1)]);
+    };
+}
+/** blockchain.address.get_balance */
+export const addressGetBalance = withScriptHash(scripthashHandlers.getBalance);
+/** blockchain.address.get_history */
+export const addressGetHistory = withScriptHash(scripthashHandlers.getHistory);
+/** blockchain.address.get_mempool */
+export const addressGetMempool = withScriptHash(scripthashHandlers.getMempool);
+/** blockchain.address.listunspent */
+export const addressListUnspent = withScriptHash(scripthashHandlers.listUnspent);
+/** blockchain.address.subscribe — delegates to scripthash.subscribe. */
+export const addressSubscribe = withScriptHash(scripthashHandlers.subscribe);
+/** blockchain.address.unsubscribe */
+export const addressUnsubscribe = withScriptHash(scripthashHandlers.unsubscribe);
+/** blockchain.address.get_status */
+export const addressGetStatus = withScriptHash(scripthashHandlers.getStatus);
+/** blockchain.address.get_first_use */
+export const addressGetFirstUse = withScriptHash(scripthashHandlers.getFirstUse);
+/** blockchain.address.get_scripthash */
+export function addressGetScripthash(_ctx, params) {
+    if (typeof params[0] !== "string")
+        return invalidParams("Invalid address");
+    const scriptHash = addressToScriptHash(params[0]);
+    if (scriptHash === null)
+        return invalidParams("Invalid address");
+    return { result: scriptHash };
+}
+//# sourceMappingURL=address.js.map

package/dist/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,4BAA4B,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,KAAK,kBAAkB,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,wEAAwE;AACxE,SAAS,mBAAmB,CAAC,OAAe;IAC3C,MAAM,MAAM,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CACtB,OAAmE;IAEnE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;QACtB,IAAI,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ;YAAE,OAAO,aAAa,CAAC,iBAAiB,CAAC,CAAC;QAC3E,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO,aAAa,CAAC,iBAAiB,CAAC,CAAC;QACjE,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC;AACH,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;AAE/E,qCAAqC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;AAE/E,qCAAqC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;AAE/E,qCAAqC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;AAEjF,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;AAE7E,qCAAqC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;AAEjF,oCAAoC;AACpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;AAE7E,uCAAuC;AACvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;AAEjF,wCAAwC;AACxC,MAAM,UAAU,oBAAoB,CAAC,IAAqB,EAAE,MAAiB;IAC5E,IAAI,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACjE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAC/B,CAAC"}

package/dist/dispatch.d.ts

@@ -0,0 +1,18 @@
+import type { Handler, HandlerResult, ProtocolContext } from "./types.js";
+/**
+ * Dispatch a JSON-RPC method call to the appropriate handler.
+ *
+ * @param ctx - Protocol context with storage, server info, and hooks
+ * @param method - The JSON-RPC method name
+ * @param params - The method parameters
+ * @returns The handler result (success or error)
+ */
+export declare function dispatch(ctx: ProtocolContext, method: string, params: unknown[]): Promise<HandlerResult>;
+/** Get the list of all supported method names. */
+export declare function getSupportedMethods(): string[];
+/**
+ * Create a dispatch function with optional extra handlers merged on top of
+ * the built-in protocol handlers.
+ */
+export declare function createDispatch(extraHandlers?: ReadonlyMap<string, Handler>): (ctx: ProtocolContext, method: string, params: unknown[]) => Promise<HandlerResult>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAgF1E;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC7B,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EAAE,GACf,OAAO,CAAC,aAAa,CAAC,CAMxB;AAED,kDAAkD;AAClD,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC7B,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,aAAa,CAAC,CAOrF"}

package/dist/dispatch.js

@@ -0,0 +1,108 @@
+import * as addressHandlers from "./address.js";
+import * as headersHandlers from "./headers.js";
+import * as mempoolHandlers from "./mempool.js";
+import * as scripthashHandlers from "./scripthash.js";
+import * as serverHandlers from "./server.js";
+import * as stubHandlers from "./stubs.js";
+import * as transactionHandlers from "./transaction.js";
+import { ERR_METHOD_NOT_FOUND, err } from "./types.js";
+import * as utxoHandlers from "./utxo.js";
+/** Registry of Electrum Cash protocol method handlers. */
+const methodHandlers = new Map([
+    // blockchain.address.* (Fulcrum extension — delegates to scripthash handlers)
+    ["blockchain.address.get_balance", addressHandlers.addressGetBalance],
+    ["blockchain.address.get_first_use", addressHandlers.addressGetFirstUse],
+    ["blockchain.address.get_history", addressHandlers.addressGetHistory],
+    ["blockchain.address.get_mempool", addressHandlers.addressGetMempool],
+    ["blockchain.address.get_scripthash", addressHandlers.addressGetScripthash],
+    ["blockchain.address.get_status", addressHandlers.addressGetStatus],
+    ["blockchain.address.listunspent", addressHandlers.addressListUnspent],
+    ["blockchain.address.subscribe", addressHandlers.addressSubscribe],
+    ["blockchain.address.unsubscribe", addressHandlers.addressUnsubscribe],
+    // blockchain.scripthash.*
+    ["blockchain.scripthash.get_balance", scripthashHandlers.getBalance],
+    ["blockchain.scripthash.get_first_use", scripthashHandlers.getFirstUse],
+    ["blockchain.scripthash.get_history", scripthashHandlers.getHistory],
+    ["blockchain.scripthash.get_mempool", scripthashHandlers.getMempool],
+    ["blockchain.scripthash.listunspent", scripthashHandlers.listUnspent],
+    ["blockchain.scripthash.subscribe", scripthashHandlers.subscribe],
+    ["blockchain.scripthash.unsubscribe", scripthashHandlers.unsubscribe],
+    ["blockchain.scripthash.get_status", scripthashHandlers.getStatus],
+    // blockchain.headers.*
+    ["blockchain.header.get", headersHandlers.headerGet],
+    ["blockchain.headers.get_tip", headersHandlers.headersGetTip],
+    ["blockchain.headers.subscribe", headersHandlers.headersSubscribe],
+    ["blockchain.headers.unsubscribe", headersHandlers.headersUnsubscribe],
+    // blockchain.block.*
+    ["blockchain.block.header", headersHandlers.blockHeader],
+    ["blockchain.block.headers", headersHandlers.blockHeaders],
+    // blockchain.transaction.*
+    ["blockchain.transaction.broadcast", transactionHandlers.broadcast],
+    ["blockchain.transaction.broadcast_package", transactionHandlers.broadcastPackage],
+    ["blockchain.transaction.get", transactionHandlers.get],
+    ["blockchain.transaction.get_confirmed_blockhash", transactionHandlers.getConfirmedBlockhash],
+    ["blockchain.transaction.get_height", transactionHandlers.getHeight],
+    ["blockchain.transaction.get_merkle", transactionHandlers.getMerkle],
+    ["blockchain.transaction.id_from_pos", transactionHandlers.idFromPos],
+    ["blockchain.transaction.subscribe", transactionHandlers.txSubscribe],
+    ["blockchain.transaction.unsubscribe", transactionHandlers.txUnsubscribe],
+    ["blockchain.transaction.dsproof.get", transactionHandlers.dsproofGet],
+    ["blockchain.transaction.dsproof.list", transactionHandlers.dsproofList],
+    ["blockchain.transaction.dsproof.subscribe", transactionHandlers.dsproofSubscribe],
+    ["blockchain.transaction.dsproof.unsubscribe", transactionHandlers.dsproofUnsubscribe],
+    // blockchain.utxo.*
+    ["blockchain.utxo.get_info", utxoHandlers.getInfo],
+    // mempool.*
+    ["mempool.get_fee_histogram", mempoolHandlers.getFeeHistogram],
+    ["mempool.get_info", mempoolHandlers.getInfo],
+    // server.*
+    ["server.add_peer", serverHandlers.addPeer],
+    ["server.banner", serverHandlers.banner],
+    ["server.donation_address", serverHandlers.donationAddress],
+    ["server.features", serverHandlers.features],
+    ["server.peers.subscribe", serverHandlers.peersSubscribe],
+    ["server.ping", serverHandlers.ping],
+    ["server.version", serverHandlers.version],
+    // fee estimation
+    ["blockchain.estimatefee", serverHandlers.estimateFee],
+    ["blockchain.relayfee", serverHandlers.relayFee],
+    // stubs (not supported in Phase 1)
+    ["blockchain.rpa.get_history", stubHandlers.rpaGetHistory],
+    ["blockchain.rpa.get_mempool", stubHandlers.rpaGetMempool],
+    ["blockchain.reusable.get_history", stubHandlers.reusableGetHistory],
+    ["blockchain.reusable.get_mempool", stubHandlers.reusableGetMempool],
+    ["daemon.passthrough", stubHandlers.daemonPassthrough],
+]);
+/**
+ * Dispatch a JSON-RPC method call to the appropriate handler.
+ *
+ * @param ctx - Protocol context with storage, server info, and hooks
+ * @param method - The JSON-RPC method name
+ * @param params - The method parameters
+ * @returns The handler result (success or error)
+ */
+export async function dispatch(ctx, method, params) {
+    const handler = methodHandlers.get(method);
+    if (!handler) {
+        return err(ERR_METHOD_NOT_FOUND, `Unknown method: ${method}`);
+    }
+    return handler(ctx, params);
+}
+/** Get the list of all supported method names. */
+export function getSupportedMethods() {
+    return [...methodHandlers.keys()];
+}
+/**
+ * Create a dispatch function with optional extra handlers merged on top of
+ * the built-in protocol handlers.
+ */
+export function createDispatch(extraHandlers) {
+    const handlers = extraHandlers ? new Map([...methodHandlers, ...extraHandlers]) : methodHandlers;
+    return async (ctx, method, params) => {
+        const handler = handlers.get(method);
+        if (!handler)
+            return err(ERR_METHOD_NOT_FOUND, `Unknown method: ${method}`);
+        return handler(ctx, params);
+    };
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/dispatch.js.map

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

package/dist/headers.d.ts

@@ -0,0 +1,14 @@
+import { type HandlerResult, type ProtocolContext } from "./types.js";
+/** blockchain.block.header */
+export declare function blockHeader(ctx: ProtocolContext, params: unknown[]): HandlerResult;
+/** blockchain.block.headers (plural — returns a range of consecutive headers) */
+export declare function blockHeaders(ctx: ProtocolContext, params: unknown[]): HandlerResult;
+/** blockchain.header.get — retrieve a single header by height or hash. */
+export declare function headerGet(ctx: ProtocolContext, params: unknown[]): HandlerResult;
+/** blockchain.headers.get_tip — return the current chain tip. */
+export declare function headersGetTip(ctx: ProtocolContext, _params: unknown[]): HandlerResult;
+/** blockchain.headers.subscribe */
+export declare function headersSubscribe(ctx: ProtocolContext, _params: unknown[]): HandlerResult;
+/** blockchain.headers.unsubscribe */
+export declare function headersUnsubscribe(ctx: ProtocolContext, _params: unknown[]): HandlerResult;
+//# sourceMappingURL=headers.d.ts.map

package/dist/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../src/headers.ts"],"names":[],"mappings":"AACA,OAAO,EAIN,KAAK,aAAa,EAGlB,KAAK,eAAe,EAEpB,MAAM,YAAY,CAAC;AAsBpB,8BAA8B;AAC9B,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CA2ClF;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CA2DnF;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAchF;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,aAAa,CAIrF;AAED,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,aAAa,CAWxF;AAED,qCAAqC;AACrC,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,aAAa,CAO1F"}

package/dist/headers.js

@@ -0,0 +1,156 @@
+import { computeHeaderMerkleBranch } from "@mem-cash/types";
+import { ERR_BAD_REQUEST, err, formatHeaderResponse, invalidParams, ok, validateNonNegativeInt, } from "./types.js";
+/** Maximum number of headers returned in a single `blockchain.block.headers` request. */
+const MAX_HEADERS_PER_REQUEST = 2016;
+/** Maximum cp_height for merkle proof computation (prevents DoS via huge allocations). */
+const MAX_CHECKPOINT_HEIGHT = 1_000_000;
+/**
+ * Collect block hashes for heights 0..cpHeight (inclusive) from storage.
+ * Returns null if any header in the range is missing.
+ */
+function collectHeaderHashes(ctx, cpHeight) {
+    const hashes = [];
+    for (let h = 0; h <= cpHeight; h++) {
+        const header = ctx.node.getHeader(h);
+        if (!header)
+            return null;
+        hashes.push(header.hash);
+    }
+    return hashes;
+}
+/** blockchain.block.header */
+export function blockHeader(ctx, params) {
+    const height = validateNonNegativeInt(params[0]);
+    if (height === null)
+        return invalidParams("Invalid height");
+    const header = ctx.node.getHeader(height);
+    if (!header) {
+        return err(ERR_BAD_REQUEST, "Invalid height");
+    }
+    // Without checkpoint: return raw header hex
+    if (params[1] === undefined || params[1] === null) {
+        return ok(header.hex);
+    }
+    // With checkpoint height: return header + merkle proof
+    const cpHeight = validateNonNegativeInt(params[1]);
+    if (cpHeight === null)
+        return invalidParams("Invalid cp_height");
+    if (height > cpHeight) {
+        return invalidParams("height must be <= cp_height");
+    }
+    if (cpHeight > MAX_CHECKPOINT_HEIGHT) {
+        return invalidParams("cp_height exceeds maximum allowed value");
+    }
+    const tip = ctx.node.getTip();
+    if (!tip || cpHeight > tip.height) {
+        return invalidParams("cp_height exceeds chain tip");
+    }
+    const hashes = collectHeaderHashes(ctx, cpHeight);
+    if (!hashes) {
+        return err(ERR_BAD_REQUEST, "Missing headers in checkpoint range");
+    }
+    const { branch, root } = computeHeaderMerkleBranch(hashes, height);
+    return ok({
+        header: header.hex,
+        branch,
+        root,
+    });
+}
+/** blockchain.block.headers (plural — returns a range of consecutive headers) */
+export function blockHeaders(ctx, params) {
+    const startHeight = validateNonNegativeInt(params[0]);
+    if (startHeight === null)
+        return invalidParams("Invalid start_height");
+    let count = validateNonNegativeInt(params[1]);
+    if (count === null)
+        return invalidParams("Invalid count");
+    // Clamp count to maximum
+    count = Math.min(count, MAX_HEADERS_PER_REQUEST);
+    // Clamp to available headers
+    const tip = ctx.node.getTip();
+    if (tip) {
+        count = Math.min(count, tip.height - startHeight + 1);
+    }
+    count = Math.max(count, 0);
+    // Collect headers
+    let hex = "";
+    let actual = 0;
+    for (let h = startHeight; h < startHeight + count; h++) {
+        const header = ctx.node.getHeader(h);
+        if (!header)
+            break;
+        hex += header.hex;
+        actual++;
+    }
+    const result = {
+        count: actual,
+        hex,
+        max: MAX_HEADERS_PER_REQUEST,
+    };
+    // Optional checkpoint proof
+    if (params[2] !== undefined && params[2] !== null) {
+        const cpHeight = validateNonNegativeInt(params[2]);
+        if (cpHeight === null)
+            return invalidParams("Invalid cp_height");
+        if (actual > 0 && cpHeight >= startHeight + actual - 1 && cpHeight <= MAX_CHECKPOINT_HEIGHT) {
+            if (tip && cpHeight <= tip.height) {
+                const hashes = collectHeaderHashes(ctx, cpHeight);
+                if (hashes) {
+                    // Prove the last header in the returned range
+                    const lastHeight = startHeight + actual - 1;
+                    const proof = computeHeaderMerkleBranch(hashes, lastHeight);
+                    result.branch = proof.branch;
+                    result.root = proof.root;
+                }
+            }
+        }
+    }
+    return ok(result);
+}
+/** blockchain.header.get — retrieve a single header by height or hash. */
+export function headerGet(ctx, params) {
+    const param = params[0];
+    let header;
+    if (typeof param === "number") {
+        const height = validateNonNegativeInt(param);
+        if (height === null)
+            return invalidParams("Invalid height");
+        header = ctx.node.getHeader(height);
+    }
+    else if (typeof param === "string" && param.length === 64) {
+        header = ctx.node.getHeaderByHash(param);
+    }
+    else {
+        return invalidParams("Expected block height (number) or hash (64-char hex)");
+    }
+    if (!header)
+        return err(ERR_BAD_REQUEST, "Invalid height");
+    return ok(formatHeaderResponse(header));
+}
+/** blockchain.headers.get_tip — return the current chain tip. */
+export function headersGetTip(ctx, _params) {
+    const tip = ctx.node.getTip();
+    if (!tip)
+        return err(ERR_BAD_REQUEST, "No blocks available");
+    return ok(formatHeaderResponse(tip));
+}
+/** blockchain.headers.subscribe */
+export function headersSubscribe(ctx, _params) {
+    const tip = ctx.node.getTip();
+    if (!tip) {
+        return err(ERR_BAD_REQUEST, "No blocks available");
+    }
+    if (ctx.subscribeHeaders) {
+        ctx.subscribeHeaders();
+    }
+    return ok(formatHeaderResponse(tip));
+}
+/** blockchain.headers.unsubscribe */
+export function headersUnsubscribe(ctx, _params) {
+    if (!ctx.unsubscribeHeaders) {
+        return err(ERR_BAD_REQUEST, "Subscriptions not supported");
+    }
+    const wasSubscribed = ctx.unsubscribeHeaders();
+    return ok(wasSubscribed);
+}
+//# sourceMappingURL=headers.js.map

package/dist/headers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { createDispatch, dispatch, getSupportedMethods } from "./dispatch.js";
+export { blockHeader, blockHeaders, headerGet, headersGetTip, headersSubscribe, headersUnsubscribe, } from "./headers.js";
+export type { Indexer, IndexerConfig, Unsubscribe } from "./indexer.js";
+export { createIndexer } from "./indexer.js";
+export type { AnySchema, ElectrumCashSchema, ElectrumCashSchema_1_5_3, ElectrumCashSchema_1_6_0, ElectrumCashTestSchema, ExtractEntry, ExtractMethod, ExtractParams, ExtractRequestMethod, ExtractReturn, ExtractSubscriptionMethod, OverrideRequests, Schema, SchemaEntry, } from "./schema.js";
+export { getBalance, getHistory, getMempool, getStatus, listUnspent, subscribe, unsubscribe, } from "./scripthash.js";
+export { estimateFee, features, ping, relayFee, version, } from "./server.js";
+export { createTestHandlers } from "./test.js";
+export type { TokenDetails, Utxo } from "./testUtils.js";
+export { randomNFT, randomToken, randomUtxo } from "./testUtils.js";
+export { broadcast, dsproofSubscribe, dsproofUnsubscribe, get, getMerkle, idFromPos, txSubscribe, txUnsubscribe, } from "./transaction.js";
+export type { IndexerTransport } from "./transport.js";
+export { asTransport } from "./transport.js";
+export type { DsproofData, Handler, HandlerResult, ProtocolContext, ProtocolError, } from "./types.js";
+export { ERR_BAD_REQUEST, ERR_DAEMON_ERROR, ERR_INTERNAL, ERR_INVALID_PARAMS, ERR_INVALID_REQUEST, ERR_METHOD_NOT_FOUND, err, formatHeaderResponse, internalError, invalidParams, ok, validateNonNegativeInt, validateOptionalBool, validateScriptHash, validateTxid, } from "./types.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,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EACN,WAAW,EACX,YAAY,EACZ,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EACX,SAAS,EACT,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,yBAAyB,EACzB,gBAAgB,EAChB,MAAM,EACN,WAAW,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,UAAU,EACV,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,WAAW,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,OAAO,GACP,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EACN,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,GAAG,EACH,SAAS,EACT,SAAS,EACT,WAAW,EACX,aAAa,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EACX,WAAW,EACX,OAAO,EACP,aAAa,EACb,eAAe,EACf,aAAa,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,GAAG,EACH,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,EAAE,EACF,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { createDispatch, dispatch, getSupportedMethods } from "./dispatch.js";
+export { blockHeader, blockHeaders, headerGet, headersGetTip, headersSubscribe, headersUnsubscribe, } from "./headers.js";
+export { createIndexer } from "./indexer.js";
+export { getBalance, getHistory, getMempool, getStatus, listUnspent, subscribe, unsubscribe, } from "./scripthash.js";
+export { estimateFee, features, ping, relayFee, version, } from "./server.js";
+export { createTestHandlers } from "./test.js";
+export { randomNFT, randomToken, randomUtxo } from "./testUtils.js";
+export { broadcast, dsproofSubscribe, dsproofUnsubscribe, get, getMerkle, idFromPos, txSubscribe, txUnsubscribe, } from "./transaction.js";
+export { asTransport } from "./transport.js";
+export { ERR_BAD_REQUEST, ERR_DAEMON_ERROR, ERR_INTERNAL, ERR_INVALID_PARAMS, ERR_INVALID_REQUEST, ERR_METHOD_NOT_FOUND, err, formatHeaderResponse, internalError, invalidParams, ok, validateNonNegativeInt, validateOptionalBool, validateScriptHash, validateTxid, } from "./types.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":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EACN,WAAW,EACX,YAAY,EACZ,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAiB7C,OAAO,EACN,UAAU,EACV,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,WAAW,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,OAAO,GACP,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EACN,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,GAAG,EACH,SAAS,EACT,SAAS,EACT,WAAW,EACX,aAAa,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAQ7C,OAAO,EACN,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,GAAG,EACH,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,EAAE,EACF,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,GACZ,MAAM,YAAY,CAAC"}

package/dist/indexer.d.ts

@@ -0,0 +1,42 @@
+import type { Node, NodeConfig } from "@mem-cash/core";
+import type { ElectrumCashTestSchema, ExtractParams, ExtractRequestMethod, ExtractReturn, ExtractSubscriptionMethod, Schema } from "./schema.js";
+/** Function that tears down a subscription. */
+export type Unsubscribe = () => Promise<void>;
+/** Configuration for the Indexer Electrum instance. */
+export interface IndexerConfig extends NodeConfig {
+    /** Server version string (default: "mem-cash/0.1"). */
+    readonly serverVersion?: string;
+    /** Genesis hash (default: BCH mainnet). */
+    readonly genesisHash?: string;
+    /** CashAddress prefix for address encoding (default: "bitcoincash"). */
+    readonly addressPrefix?: string;
+    /** Server banner text. */
+    readonly banner?: string;
+    /** Server donation address. */
+    readonly donationAddress?: string;
+    /** Disable test.* RPC handlers. Set to true to exclude them (e.g. in production). */
+    readonly disableTestHandlers?: boolean;
+}
+/** A core Node wrapped with Electrum RPC dispatch. */
+export interface Indexer<S extends Schema = ElectrumCashTestSchema> extends Node {
+    /**
+     * Dispatch an Electrum RPC method.
+     * Params can be a positional array or a named-parameter object.
+     * Returns the unwrapped result; throws on RPC error.
+     */
+    readonly request: <M extends ExtractRequestMethod<S>>(method: M, params?: ExtractParams<S, M>) => Promise<ExtractReturn<S, M>>;
+    /**
+     * Subscribe to an Electrum method. The callback receives the initial
+     * result immediately and subsequent notifications as they occur.
+     * Returns an unsubscribe function.
+     */
+    readonly subscribe: <M extends ExtractSubscriptionMethod<S>>(method: M, params: ExtractParams<S, M>, callback: (data: ExtractReturn<S, M>) => void) => Promise<Unsubscribe>;
+}
+/**
+ * Create a Indexer instance: a core Node with Electrum RPC dispatch.
+ *
+ * All `test.*` RPC methods are available via `request()`.
+ * Core node methods (`submitTransaction`, `mine`, etc.) are available directly.
+ */
+export declare function createIndexer(config?: IndexerConfig): Indexer;
+//# sourceMappingURL=indexer.d.ts.map

package/dist/indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../src/indexer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAgB,MAAM,gBAAgB,CAAC;AAIrE,OAAO,KAAK,EACX,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,yBAAyB,EACzB,MAAM,EACN,MAAM,aAAa,CAAC;AAQrB,+CAA+C;AAC/C,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9C,uDAAuD;AACvD,MAAM,WAAW,aAAc,SAAQ,UAAU;IAChD,uDAAuD;IACvD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,qFAAqF;IACrF,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,sDAAsD;AACtD,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,sBAAsB,CAAE,SAAQ,IAAI;IAC/E;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,oBAAoB,CAAC,CAAC,CAAC,EACnD,MAAM,EAAE,CAAC,EACT,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,KACxB,OAAO,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAElC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,yBAAyB,CAAC,CAAC,CAAC,EAC1D,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAC3B,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,KACzC,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CA8N7D"}