@mem-cash/electrum 0.0.1

package/dist/indexer.js

@@ -0,0 +1,216 @@
+import { binToHex, cashAddressToLockingBytecode, sha256 } from "@bitauth/libauth";
+import { createNode } from "@mem-cash/core";
+import { createDispatch } from "./dispatch.js";
+import { createTestHandlers } from "./test.js";
+import { formatHeaderResponse } from "./types.js";
+/** BCH mainnet genesis hash. */
+const BCH_GENESIS_HASH = "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f";
+/**
+ * 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 function createIndexer(config) {
+    const node = createNode(config);
+    const enableTest = config?.disableTestHandlers !== true;
+    const testHandlers = enableTest
+        ? new Map(createTestHandlers(node.storage))
+        : new Map();
+    const serverVersion = config?.serverVersion ?? "mem-cash/0.1";
+    const genesisHash = config?.genesisHash ?? BCH_GENESIS_HASH;
+    // Notification routing: per-scripthash, header, transaction, and dsproof callback sets
+    const scriptHashCallbacks = new Map();
+    const headerCallbacks = new Set();
+    const txCallbacks = new Map();
+    const dsproofCallbacks = new Map();
+    // In-memory dsproof store (populated by test.add_dsproof)
+    const dsproofs = new Map();
+    function getDsproof(txid) {
+        return dsproofs.get(txid) ?? null;
+    }
+    function notifyTxSubscriptions() {
+        if (txCallbacks.size === 0)
+            return;
+        const tip = node.getTip();
+        for (const [txHash, cbs] of txCallbacks) {
+            const record = node.getTx(txHash);
+            const memTx = node.getMempoolTx(txHash);
+            let confirmations = null;
+            if (record && record.height > 0 && tip) {
+                confirmations = tip.height - record.height + 1;
+            }
+            else if (record || memTx) {
+                confirmations = 0;
+            }
+            if (confirmations !== null) {
+                for (const cb of cbs)
+                    cb([txHash, confirmations]);
+            }
+        }
+    }
+    function onNotification(notification) {
+        if (notification.type === "scripthash") {
+            const cbs = scriptHashCallbacks.get(notification.scriptHash);
+            if (cbs) {
+                for (const cb of cbs) {
+                    cb([notification.scriptHash, notification.status]);
+                }
+            }
+        }
+        else {
+            for (const cb of headerCallbacks) {
+                cb([formatHeaderResponse(notification.header)]);
+            }
+        }
+        notifyTxSubscriptions();
+    }
+    const consumerId = node.subscriptions.addConsumer(onNotification);
+    const hooks = node.subscriptions.hooksForConsumer(consumerId);
+    // Register test.add_dsproof handler — stores a dsproof and notifies subscribers
+    if (enableTest) {
+        testHandlers.set("test.add_dsproof", (_ctx, params) => {
+            if (params.length < 2) {
+                return { error: { code: -32602, message: "Expected [txid, dsproof]" } };
+            }
+            const txid = params[0];
+            const dsproof = params[1];
+            dsproofs.set(txid, dsproof);
+            const cbs = dsproofCallbacks.get(txid);
+            if (cbs) {
+                for (const cb of cbs)
+                    cb([txid, dsproof]);
+            }
+            return { result: true };
+        });
+    }
+    // Build dispatch with test handlers only if enabled
+    const fullDispatch = createDispatch(enableTest ? testHandlers : undefined);
+    const ctx = {
+        node,
+        serverVersion,
+        protocolMin: "1.6",
+        protocolMax: "1.6",
+        genesisHash,
+        hashFunction: "sha256",
+        getDsproof,
+        listDsproofs: () => [...dsproofs.keys()],
+        ...hooks,
+        ...(config?.addressPrefix ? { addressPrefix: config.addressPrefix } : {}),
+        ...(config?.banner ? { banner: config.banner } : {}),
+        ...(config?.donationAddress ? { donationAddress: config.donationAddress } : {}),
+    };
+    function toArray(params) {
+        if (params === undefined)
+            return [];
+        if (Array.isArray(params))
+            return params;
+        return Object.values(params);
+    }
+    async function request(method, params) {
+        const handlerResult = await fullDispatch(ctx, method, toArray(params));
+        if ("error" in handlerResult) {
+            const e = new Error(handlerResult.error.message);
+            e.code = handlerResult.error.code;
+            throw e;
+        }
+        return handlerResult.result;
+    }
+    async function subscribe(method, params, callback) {
+        const paramsArray = toArray(params);
+        const handlerResult = await fullDispatch(ctx, method, paramsArray);
+        if ("error" in handlerResult) {
+            throw new Error(handlerResult.error.message);
+        }
+        if (method === "blockchain.scripthash.subscribe") {
+            const scriptHash = paramsArray[0];
+            let cbs = scriptHashCallbacks.get(scriptHash);
+            if (!cbs) {
+                cbs = new Set();
+                scriptHashCallbacks.set(scriptHash, cbs);
+            }
+            cbs.add(callback);
+            callback([scriptHash, handlerResult.result]);
+            return async () => {
+                cbs.delete(callback);
+                if (cbs.size === 0)
+                    scriptHashCallbacks.delete(scriptHash);
+                await fullDispatch(ctx, "blockchain.scripthash.unsubscribe", [scriptHash]);
+            };
+        }
+        if (method === "blockchain.address.subscribe") {
+            const address = paramsArray[0];
+            // The address handler delegates to scripthash.subscribe internally,
+            // so the subscription manager already tracks the scripthash.
+            // We register a callback that maps scripthash notifications to [address, status].
+            const decoded = cashAddressToLockingBytecode(address);
+            if (typeof decoded === "string")
+                throw new Error(`Invalid address: ${decoded}`);
+            const scriptHash = binToHex(sha256.hash(decoded.bytecode));
+            const wrappedCb = (data) => {
+                const [, status] = data;
+                callback([address, status]);
+            };
+            let cbs = scriptHashCallbacks.get(scriptHash);
+            if (!cbs) {
+                cbs = new Set();
+                scriptHashCallbacks.set(scriptHash, cbs);
+            }
+            cbs.add(wrappedCb);
+            // Deliver initial [address, status]
+            callback([address, handlerResult.result]);
+            return async () => {
+                cbs.delete(wrappedCb);
+                if (cbs.size === 0)
+                    scriptHashCallbacks.delete(scriptHash);
+                await fullDispatch(ctx, "blockchain.address.unsubscribe", [address]);
+            };
+        }
+        if (method === "blockchain.headers.subscribe") {
+            headerCallbacks.add(callback);
+            callback([handlerResult.result]);
+            return async () => {
+                headerCallbacks.delete(callback);
+                // Only unsubscribe from the protocol when no callbacks remain,
+                // so that other active header watchers keep receiving notifications.
+                if (headerCallbacks.size === 0) {
+                    await fullDispatch(ctx, "blockchain.headers.unsubscribe", []);
+                }
+            };
+        }
+        if (method === "blockchain.transaction.subscribe") {
+            const txHash = paramsArray[0];
+            let cbs = txCallbacks.get(txHash);
+            if (!cbs) {
+                cbs = new Set();
+                txCallbacks.set(txHash, cbs);
+            }
+            cbs.add(callback);
+            callback(handlerResult.result);
+            return async () => {
+                cbs.delete(callback);
+                if (cbs.size === 0)
+                    txCallbacks.delete(txHash);
+            };
+        }
+        if (method === "blockchain.transaction.dsproof.subscribe") {
+            const txHash = paramsArray[0];
+            let cbs = dsproofCallbacks.get(txHash);
+            if (!cbs) {
+                cbs = new Set();
+                dsproofCallbacks.set(txHash, cbs);
+            }
+            cbs.add(callback);
+            // Deliver initial status from handler result
+            callback(handlerResult.result);
+            return async () => {
+                cbs.delete(callback);
+                if (cbs.size === 0)
+                    dsproofCallbacks.delete(txHash);
+            };
+        }
+        throw new Error(`Method ${method} does not support subscriptions`);
+    }
+    return { ...node, request, subscribe };
+}
+//# sourceMappingURL=indexer.js.map

package/dist/indexer.js.map

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

package/dist/memCash.d.ts

@@ -0,0 +1,40 @@
+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 MemCash Electrum instance. */
+export interface MemCashConfig 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;
+}
+/** A core Node wrapped with Electrum RPC dispatch. */
+export interface MemCash<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 MemCash 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 createMemCash(config?: MemCashConfig): MemCash;
+//# sourceMappingURL=memCash.d.ts.map

package/dist/memCash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memCash.d.ts","sourceRoot":"","sources":["../src/memCash.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;CAClC;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,CA0N7D"}

package/dist/memCash.js

@@ -0,0 +1,212 @@
+import { binToHex, cashAddressToLockingBytecode, sha256 } from "@bitauth/libauth";
+import { createNode } from "@mem-cash/core";
+import { createDispatch } from "./dispatch.js";
+import { createTestHandlers } from "./test.js";
+import { formatHeaderResponse } from "./types.js";
+/** BCH mainnet genesis hash. */
+const BCH_GENESIS_HASH = "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f";
+/**
+ * Create a MemCash 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 function createMemCash(config) {
+    const node = createNode(config);
+    const baseTestHandlers = createTestHandlers(node.storage);
+    const testHandlers = new Map(baseTestHandlers);
+    const serverVersion = config?.serverVersion ?? "mem-cash/0.1";
+    const genesisHash = config?.genesisHash ?? BCH_GENESIS_HASH;
+    // Notification routing: per-scripthash, header, transaction, and dsproof callback sets
+    const scriptHashCallbacks = new Map();
+    const headerCallbacks = new Set();
+    const txCallbacks = new Map();
+    const dsproofCallbacks = new Map();
+    // In-memory dsproof store (populated by test.add_dsproof)
+    const dsproofs = new Map();
+    function getDsproof(txid) {
+        return dsproofs.get(txid) ?? null;
+    }
+    function notifyTxSubscriptions() {
+        if (txCallbacks.size === 0)
+            return;
+        const tip = node.getTip();
+        for (const [txHash, cbs] of txCallbacks) {
+            const record = node.getTx(txHash);
+            const memTx = node.getMempoolTx(txHash);
+            let confirmations = null;
+            if (record && record.height > 0 && tip) {
+                confirmations = tip.height - record.height + 1;
+            }
+            else if (record || memTx) {
+                confirmations = 0;
+            }
+            if (confirmations !== null) {
+                for (const cb of cbs)
+                    cb([txHash, confirmations]);
+            }
+        }
+    }
+    function onNotification(notification) {
+        if (notification.type === "scripthash") {
+            const cbs = scriptHashCallbacks.get(notification.scriptHash);
+            if (cbs) {
+                for (const cb of cbs) {
+                    cb([notification.scriptHash, notification.status]);
+                }
+            }
+        }
+        else {
+            for (const cb of headerCallbacks) {
+                cb([formatHeaderResponse(notification.header)]);
+            }
+        }
+        notifyTxSubscriptions();
+    }
+    const consumerId = node.subscriptions.addConsumer(onNotification);
+    const hooks = node.subscriptions.hooksForConsumer(consumerId);
+    // Register test.add_dsproof handler — stores a dsproof and notifies subscribers
+    testHandlers.set("test.add_dsproof", (_ctx, params) => {
+        if (params.length < 2) {
+            return { error: { code: -32602, message: "Expected [txid, dsproof]" } };
+        }
+        const txid = params[0];
+        const dsproof = params[1];
+        dsproofs.set(txid, dsproof);
+        const cbs = dsproofCallbacks.get(txid);
+        if (cbs) {
+            for (const cb of cbs)
+                cb([txid, dsproof]);
+        }
+        return { result: true };
+    });
+    // Rebuild dispatch with updated test handlers (now includes test.add_dsproof)
+    const fullDispatch = createDispatch(testHandlers);
+    const ctx = {
+        node,
+        serverVersion,
+        protocolMin: "1.6.0",
+        protocolMax: "1.6.0",
+        genesisHash,
+        hashFunction: "sha256",
+        getDsproof,
+        listDsproofs: () => [...dsproofs.keys()],
+        ...hooks,
+        ...(config?.addressPrefix ? { addressPrefix: config.addressPrefix } : {}),
+        ...(config?.banner ? { banner: config.banner } : {}),
+        ...(config?.donationAddress ? { donationAddress: config.donationAddress } : {}),
+    };
+    function toArray(params) {
+        if (params === undefined)
+            return [];
+        if (Array.isArray(params))
+            return params;
+        return Object.values(params);
+    }
+    async function request(method, params) {
+        const handlerResult = await fullDispatch(ctx, method, toArray(params));
+        if ("error" in handlerResult) {
+            const e = new Error(handlerResult.error.message);
+            e.code = handlerResult.error.code;
+            throw e;
+        }
+        return handlerResult.result;
+    }
+    async function subscribe(method, params, callback) {
+        const paramsArray = toArray(params);
+        const handlerResult = await fullDispatch(ctx, method, paramsArray);
+        if ("error" in handlerResult) {
+            throw new Error(handlerResult.error.message);
+        }
+        if (method === "blockchain.scripthash.subscribe") {
+            const scriptHash = paramsArray[0];
+            let cbs = scriptHashCallbacks.get(scriptHash);
+            if (!cbs) {
+                cbs = new Set();
+                scriptHashCallbacks.set(scriptHash, cbs);
+            }
+            cbs.add(callback);
+            callback([scriptHash, handlerResult.result]);
+            return async () => {
+                cbs.delete(callback);
+                if (cbs.size === 0)
+                    scriptHashCallbacks.delete(scriptHash);
+                await fullDispatch(ctx, "blockchain.scripthash.unsubscribe", [scriptHash]);
+            };
+        }
+        if (method === "blockchain.address.subscribe") {
+            const address = paramsArray[0];
+            // The address handler delegates to scripthash.subscribe internally,
+            // so the subscription manager already tracks the scripthash.
+            // We register a callback that maps scripthash notifications to [address, status].
+            const decoded = cashAddressToLockingBytecode(address);
+            if (typeof decoded === "string")
+                throw new Error(`Invalid address: ${decoded}`);
+            const scriptHash = binToHex(sha256.hash(decoded.bytecode));
+            const wrappedCb = (data) => {
+                const [, status] = data;
+                callback([address, status]);
+            };
+            let cbs = scriptHashCallbacks.get(scriptHash);
+            if (!cbs) {
+                cbs = new Set();
+                scriptHashCallbacks.set(scriptHash, cbs);
+            }
+            cbs.add(wrappedCb);
+            // Deliver initial [address, status]
+            callback([address, handlerResult.result]);
+            return async () => {
+                cbs.delete(wrappedCb);
+                if (cbs.size === 0)
+                    scriptHashCallbacks.delete(scriptHash);
+                await fullDispatch(ctx, "blockchain.address.unsubscribe", [address]);
+            };
+        }
+        if (method === "blockchain.headers.subscribe") {
+            headerCallbacks.add(callback);
+            callback([handlerResult.result]);
+            return async () => {
+                headerCallbacks.delete(callback);
+                // Only unsubscribe from the protocol when no callbacks remain,
+                // so that other active header watchers keep receiving notifications.
+                if (headerCallbacks.size === 0) {
+                    await fullDispatch(ctx, "blockchain.headers.unsubscribe", []);
+                }
+            };
+        }
+        if (method === "blockchain.transaction.subscribe") {
+            const txHash = paramsArray[0];
+            let cbs = txCallbacks.get(txHash);
+            if (!cbs) {
+                cbs = new Set();
+                txCallbacks.set(txHash, cbs);
+            }
+            cbs.add(callback);
+            callback(handlerResult.result);
+            return async () => {
+                cbs.delete(callback);
+                if (cbs.size === 0)
+                    txCallbacks.delete(txHash);
+            };
+        }
+        if (method === "blockchain.transaction.dsproof.subscribe") {
+            const txHash = paramsArray[0];
+            let cbs = dsproofCallbacks.get(txHash);
+            if (!cbs) {
+                cbs = new Set();
+                dsproofCallbacks.set(txHash, cbs);
+            }
+            cbs.add(callback);
+            // Deliver initial status from handler result
+            callback(handlerResult.result);
+            return async () => {
+                cbs.delete(callback);
+                if (cbs.size === 0)
+                    dsproofCallbacks.delete(txHash);
+            };
+        }
+        throw new Error(`Method ${method} does not support subscriptions`);
+    }
+    return { ...node, request, subscribe };
+}
+//# sourceMappingURL=memCash.js.map

package/dist/memCash.js.map

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

package/dist/mempool.d.ts

@@ -0,0 +1,6 @@
+import { type HandlerResult, type ProtocolContext } from "./types.js";
+/** mempool.get_fee_histogram */
+export declare function getFeeHistogram(ctx: ProtocolContext, _params: unknown[]): HandlerResult;
+/** mempool.get_info */
+export declare function getInfo(ctx: ProtocolContext, _params: unknown[]): HandlerResult;
+//# sourceMappingURL=mempool.d.ts.map

package/dist/mempool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mempool.d.ts","sourceRoot":"","sources":["../src/mempool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAM,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAE1E,gCAAgC;AAChC,wBAAgB,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,aAAa,CAqCvF;AAED,uBAAuB;AACvB,wBAAgB,OAAO,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,aAAa,CAQ/E"}

package/dist/mempool.js

@@ -0,0 +1,46 @@
+import { ok } from "./types.js";
+/** mempool.get_fee_histogram */
+export function getFeeHistogram(ctx, _params) {
+    const txids = ctx.node.getMempoolTxids();
+    // Collect fee rates (sat/byte) for each mempool tx
+    const entries = [];
+    for (const txid of txids) {
+        const tx = ctx.node.getMempoolTx(txid);
+        if (!tx || tx.size === 0)
+            continue;
+        entries.push({
+            feeRate: Number(tx.fee) / tx.size,
+            size: tx.size,
+        });
+    }
+    // Sort by fee rate descending
+    entries.sort((a, b) => b.feeRate - a.feeRate);
+    // Build histogram buckets: [fee_rate, cumulative_vsize]
+    // Use logarithmic boundaries matching ElectrumX/Fulcrum convention
+    const bucketBoundaries = [1000, 500, 200, 100, 50, 20, 10, 5, 2, 1, 0.5, 0.2, 0.1, 0.01, 0];
+    const histogram = [];
+    let idx = 0;
+    for (const boundary of bucketBoundaries) {
+        let cumulativeSize = 0;
+        let entry = entries[idx];
+        while (entry && entry.feeRate >= boundary) {
+            cumulativeSize += entry.size;
+            idx++;
+            entry = entries[idx];
+        }
+        if (cumulativeSize > 0) {
+            histogram.push([boundary, cumulativeSize]);
+        }
+    }
+    return ok(histogram);
+}
+/** mempool.get_info */
+export function getInfo(ctx, _params) {
+    // Default BCH relay fee: 1000 sat/kB = 0.00001 BCH/kB
+    const relayFee = ctx.getRelayFee ? ctx.getRelayFee() : 0.00001;
+    return ok({
+        mempoolminfee: relayFee,
+        minrelaytxfee: relayFee,
+    });
+}
+//# sourceMappingURL=mempool.js.map

package/dist/mempool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mempool.js","sourceRoot":"","sources":["../src/mempool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,EAAE,EAAwB,MAAM,YAAY,CAAC;AAE1E,gCAAgC;AAChC,MAAM,UAAU,eAAe,CAAC,GAAoB,EAAE,OAAkB;IACvE,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;IAEzC,mDAAmD;IACnD,MAAM,OAAO,GAAwC,EAAE,CAAC;IACxD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC;YAAE,SAAS;QACnC,OAAO,CAAC,IAAI,CAAC;YACZ,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI;YACjC,IAAI,EAAE,EAAE,CAAC,IAAI;SACb,CAAC,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;IAE9C,wDAAwD;IACxD,mEAAmE;IACnE,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE5F,MAAM,SAAS,GAAuB,EAAE,CAAC;IACzC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,QAAQ,IAAI,gBAAgB,EAAE,CAAC;QACzC,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACzB,OAAO,KAAK,IAAI,KAAK,CAAC,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC3C,cAAc,IAAI,KAAK,CAAC,IAAI,CAAC;YAC7B,GAAG,EAAE,CAAC;YACN,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QACD,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;YACxB,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;QAC5C,CAAC;IACF,CAAC;IAED,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;AACtB,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,OAAO,CAAC,GAAoB,EAAE,OAAkB;IAC/D,sDAAsD;IACtD,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAE/D,OAAO,EAAE,CAAC;QACT,aAAa,EAAE,QAAQ;QACvB,aAAa,EAAE,QAAQ;KACvB,CAAC,CAAC;AACJ,CAAC"}