@ckb-ccc/core 1.9.0 → 1.10.0

package/dist.commonjs/ckb/transaction.js

@@ -28,6 +28,7 @@ const index_js_7 = require("../num/index.js");
 const index_js_8 = require("../utils/index.js");
 const script_js_1 = require("./script.js");
 const transaction_advanced_js_1 = require("./transaction.advanced.js");
+const transactionErrors_js_1 = require("./transactionErrors.js");
 exports.DepTypeCodec = index_js_6.mol.Codec.from({
     byteLength: 1,
     encode: depTypeToBytes,
@@ -127,6 +128,34 @@ let OutPoint = OutPoint_1 = class OutPoint extends index_js_6.mol.Entity.Base()
         }
         return new OutPoint_1((0, index_js_5.hexFrom)(outPoint.txHash), (0, index_js_7.numFrom)(outPoint.index));
     }
+    /**
+     * Clone a OutPoint.
+     *
+     * @returns A cloned OutPoint instance.
+     *
+     * @example
+     * ```typescript
+     * const outPoint1 = outPoint0.clone();
+     * ```
+     */
+    clone() {
+        return new OutPoint_1(this.txHash, this.index);
+    }
+    /**
+     * Check if the OutPoint is equal to another OutPoint.
+     * @public
+     * @param other - The other OutPoint to compare with
+     * @returns True if the OutPoints are equal, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const isEqual = outPoint0.eq(outPoint1);
+     * ```
+     */
+    eq(other) {
+        other = OutPoint_1.from(other);
+        return this.txHash === other.txHash && this.index === other.index;
+    }
 };
 exports.OutPoint = OutPoint;
 exports.OutPoint = OutPoint = OutPoint_1 = __decorate([
@@ -176,6 +205,19 @@ let CellOutput = CellOutput_1 = class CellOutput extends index_js_6.mol.Entity.B
         }
         return new CellOutput_1((0, index_js_7.numFrom)(cellOutput.capacity), script_js_1.Script.from(cellOutput.lock), (0, index_js_8.apply)(script_js_1.Script.from, cellOutput.type));
     }
+    /**
+     * Clone a CellOutput.
+     *
+     * @returns A cloned CellOutput instance.
+     *
+     * @example
+     * ```typescript
+     * const cellOutput1 = cellOutput0.clone();
+     * ```
+     */
+    clone() {
+        return new CellOutput_1(this.capacity, this.lock.clone(), this.type?.clone());
+    }
 };
 exports.CellOutput = CellOutput;
 exports.CellOutput = CellOutput = CellOutput_1 = __decorate([
@@ -506,11 +548,18 @@ let CellInput = CellInput_1 = class CellInput extends index_js_6.mol.Entity.Base
     async getExtraCapacity(client) {
         return (await this.getCell(client)).getDaoProfit(client);
     }
+    /**
+     * Clone a CellInput.
+     *
+     * @returns A cloned CellInput instance.
+     *
+     * @example
+     * ```typescript
+     * const cellInput1 = cellInput0.clone();
+     * ```
+     */
     clone() {
-        const cloned = super.clone();
-        cloned.cellOutput = this.cellOutput;
-        cloned.outputData = this.outputData;
-        return cloned;
+        return new CellInput_1(this.previousOutput.clone(), this.since, this.cellOutput?.clone(), this.outputData);
     }
 };
 exports.CellInput = CellInput;
@@ -538,19 +587,6 @@ let CellDep = CellDep_1 = class CellDep extends index_js_6.mol.Entity.Base() {
         this.outPoint = outPoint;
         this.depType = depType;
     }
-    /**
-     * Clone a CellDep.
-     *
-     * @returns A cloned CellDep instance.
-     *
-     * @example
-     * ```typescript
-     * const cellDep1 = cellDep0.clone();
-     * ```
-     */
-    clone() {
-        return new CellDep_1(this.outPoint.clone(), this.depType);
-    }
     /**
      * Creates a CellDep instance from a CellDepLike object.
      *
@@ -571,6 +607,19 @@ let CellDep = CellDep_1 = class CellDep extends index_js_6.mol.Entity.Base() {
         }
         return new CellDep_1(OutPoint.from(cellDep.outPoint), depTypeFrom(cellDep.depType));
     }
+    /**
+     * Clone a CellDep.
+     *
+     * @returns A cloned CellDep instance.
+     *
+     * @example
+     * ```typescript
+     * const cellDep1 = cellDep0.clone();
+     * ```
+     */
+    clone() {
+        return new CellDep_1(this.outPoint.clone(), this.depType);
+    }
 };
 exports.CellDep = CellDep;
 exports.CellDep = CellDep = CellDep_1 = __decorate([
@@ -700,6 +749,46 @@ let Transaction = Transaction_1 = class Transaction extends index_js_6.mol.Entit
         this.outputsData = tx.outputsData;
         this.witnesses = tx.witnesses;
     }
+    /**
+     * Creates a deep copy of the transaction.
+     * This method creates a new Transaction instance with all nested objects cloned,
+     * ensuring that modifications to the cloned transaction do not affect the original.
+     *
+     * @returns A new Transaction instance that is a deep copy of the current transaction.
+     *
+     * @example
+     * ```typescript
+     * const originalTx = Transaction.from({
+     *   version: 0,
+     *   inputs: [{ previousOutput: { txHash: "0x...", index: 0 } }],
+     *   outputs: [{ capacity: 1000n, lock: lockScript }],
+     *   outputsData: ["0x"],
+     *   witnesses: ["0x"]
+     * });
+     *
+     * const clonedTx = originalTx.clone();
+     *
+     * // Modifications to clonedTx won't affect originalTx
+     * clonedTx.addOutput({ capacity: 2000n, lock: anotherLockScript });
+     * console.log(originalTx.outputs.length); // Still 1
+     * console.log(clonedTx.outputs.length);   // Now 2
+     * ```
+     *
+     * @remarks
+     * The clone operation performs deep copying for:
+     * - Cell dependencies (cellDeps) - each CellDep is cloned
+     * - Inputs - each CellInput is cloned
+     * - Outputs - each CellOutput is cloned
+     *
+     * The following are shallow copied (references to immutable data):
+     * - Header dependencies (headerDeps) - Hex strings are immutable
+     * - Output data (outputsData) - Hex strings are immutable
+     * - Witnesses - Hex strings are immutable
+     * - Version - bigint is immutable
+     */
+    clone() {
+        return new Transaction_1(this.version, this.cellDeps.map((c) => c.clone()), this.headerDeps.map((h) => h), this.inputs.map((i) => i.clone()), this.outputs.map((o) => o.clone()), this.outputsData.map((o) => o), this.witnesses.map((w) => w));
+    }
     /**
      * Creates a Transaction instance from a TransactionLike object.
      *
@@ -1253,7 +1342,7 @@ let Transaction = Transaction_1 = class Transaction extends index_js_6.mol.Entit
         if (accumulated === undefined) {
             return addedCount;
         }
-        throw new Error(`Insufficient CKB, need ${(0, index_js_3.fixedPointToString)(expectedCapacity - accumulated)} extra CKB`);
+        throw new transactionErrors_js_1.ErrorTransactionInsufficientCapacity(expectedCapacity - accumulated);
     }
     async completeInputsAll(from, filter) {
         const { addedCount } = await this.completeInputs(from, filter ?? {
@@ -1303,7 +1392,7 @@ let Transaction = Transaction_1 = class Transaction extends index_js_6.mol.Entit
         if (accumulated === undefined || accumulated >= expectedBalance) {
             return addedCount;
         }
-        throw new Error(`Insufficient coin, need ${expectedBalance - accumulated} extra coin`);
+        throw new transactionErrors_js_1.ErrorTransactionInsufficientCoin(expectedBalance - accumulated, type);
     }
     async completeInputsAddOne(from, filter) {
         const { addedCount, accumulated } = await this.completeInputs(from, filter ?? {
@@ -1333,6 +1422,44 @@ let Transaction = Transaction_1 = class Transaction extends index_js_6.mol.Entit
         // + 999 then / 1000 to ceil the calculated fee
         return ((0, index_js_7.numFrom)(txSize) * (0, index_js_7.numFrom)(feeRate) + (0, index_js_7.numFrom)(999)) / (0, index_js_7.numFrom)(1000);
     }
+    /**
+     * Completes the transaction fee by adding inputs and handling change outputs.
+     * This method automatically calculates the required fee based on the transaction size and fee rate,
+     * adds necessary inputs to cover the fee, and handles change outputs through the provided change function.
+     *
+     * @param from - The signer to complete inputs from and prepare the transaction.
+     * @param change - A function that handles change capacity. It receives the transaction and excess capacity,
+     *                 and should return the additional capacity needed (0 if change is handled successfully,
+     *                 positive number if more capacity is needed for change cell creation).
+     * @param expectedFeeRate - The expected fee rate in shannons per 1000 bytes. If not provided,
+     *                          it will be fetched from the client.
+     * @param filter - Optional filter for selecting cells when adding inputs.
+     * @param options - Optional configuration object.
+     * @param options.feeRateBlockRange - Block range for fee rate calculation when expectedFeeRate is not provided.
+     * @param options.maxFeeRate - Maximum allowed fee rate.
+     * @param options.shouldAddInputs - Whether to add inputs automatically. Defaults to true.
+     * @returns A promise that resolves to a tuple containing:
+     *          - The number of inputs added during the process
+     *          - A boolean indicating whether change outputs were created (true) or fee was paid without change (false)
+     *
+     * @throws {ErrorTransactionInsufficientCapacity} When there's not enough capacity to cover the fee.
+     * @throws {Error} When the change function doesn't properly handle the available capacity.
+     *
+     * @example
+     * ```typescript
+     * const [addedInputs, hasChange] = await tx.completeFee(
+     *   signer,
+     *   (tx, capacity) => {
+     *     if (capacity >= 61_00000000n) { // Minimum for a change cell
+     *       tx.addOutput({ capacity, lock: changeScript });
+     *       return 0;
+     *     }
+     *     return 61_00000000n; // Need more capacity for change cell
+     *   },
+     *   1000n // 1000 shannons per 1000 bytes
+     * );
+     * ```
+     */
     async completeFee(from, change, expectedFeeRate, filter, options) {
         const feeRate = expectedFeeRate ??
             (await from.client.getFeeRate(options?.feeRateBlockRange, options));
@@ -1343,12 +1470,22 @@ let Transaction = Transaction_1 = class Transaction extends index_js_6.mol.Entit
         while (true) {
             const tx = this.clone();
             const collected = await (async () => {
+                if (!(options?.shouldAddInputs ?? true)) {
+                    const fee = (await tx.getFee(from.client)) - leastFee - leastExtraCapacity;
+                    if (fee < index_js_3.Zero) {
+                        throw new transactionErrors_js_1.ErrorTransactionInsufficientCapacity(-fee);
+                    }
+                    return 0;
+                }
                 try {
                     return await tx.completeInputsByCapacity(from, leastFee + leastExtraCapacity, filter);
                 }
                 catch (err) {
-                    if (leastExtraCapacity !== index_js_3.Zero) {
-                        throw new Error("Not enough capacity for the change cell");
+                    if (err instanceof transactionErrors_js_1.ErrorTransactionInsufficientCapacity &&
+                        leastExtraCapacity !== index_js_3.Zero) {
+                        throw new transactionErrors_js_1.ErrorTransactionInsufficientCapacity(err.amount, {
+                            isForChange: true,
+                        });
                     }
                     throw err;
                 }
@@ -1388,7 +1525,7 @@ let Transaction = Transaction_1 = class Transaction extends index_js_6.mol.Entit
             leastFee = changedFee;
         }
     }
-    completeFeeChangeToLock(from, change, feeRate, filter) {
+    completeFeeChangeToLock(from, change, feeRate, filter, options) {
         const script = script_js_1.Script.from(change);
         return this.completeFee(from, (tx, capacity) => {
             const changeCell = CellOutput.from({ capacity: 0, lock: script });
@@ -1399,13 +1536,13 @@ let Transaction = Transaction_1 = class Transaction extends index_js_6.mol.Entit
             changeCell.capacity = capacity;
             tx.addOutput(changeCell);
             return 0;
-        }, feeRate, filter);
+        }, feeRate, filter, options);
     }
-    async completeFeeBy(from, feeRate, filter) {
+    async completeFeeBy(from, feeRate, filter, options) {
         const { script } = await from.getRecommendedAddressObj();
-        return this.completeFeeChangeToLock(from, script, feeRate, filter);
+        return this.completeFeeChangeToLock(from, script, feeRate, filter, options);
     }
-    completeFeeChangeToOutput(from, index, feeRate, filter) {
+    completeFeeChangeToOutput(from, index, feeRate, filter, options) {
         const change = Number((0, index_js_7.numFrom)(index));
         if (!this.outputs[change]) {
             throw new Error("Non-existed output to change");
@@ -1413,7 +1550,7 @@ let Transaction = Transaction_1 = class Transaction extends index_js_6.mol.Entit
         return this.completeFee(from, (tx, capacity) => {
             tx.outputs[change].capacity += capacity;
             return 0;
-        }, feeRate, filter);
+        }, feeRate, filter, options);
     }
 };
 exports.Transaction = Transaction;

package/dist.commonjs/ckb/transactionErrors.d.ts

@@ -0,0 +1,15 @@
+import { Num, NumLike } from "../num/index.js";
+import { Script, ScriptLike } from "./script.js";
+export declare class ErrorTransactionInsufficientCapacity extends Error {
+    readonly amount: Num;
+    readonly isForChange: boolean;
+    constructor(amountLike: NumLike, reason?: {
+        isForChange?: boolean;
+    });
+}
+export declare class ErrorTransactionInsufficientCoin extends Error {
+    readonly amount: Num;
+    readonly type: Script;
+    constructor(amountLike: NumLike, typeLike: ScriptLike);
+}
+//# sourceMappingURL=transactionErrors.d.ts.map

package/dist.commonjs/ckb/transactionErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionErrors.d.ts","sourceRoot":"","sources":["../../src/ckb/transactionErrors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAW,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEjD,qBAAa,oCAAqC,SAAQ,KAAK;IAC7D,SAAgB,MAAM,EAAE,GAAG,CAAC;IAC5B,SAAgB,WAAW,EAAE,OAAO,CAAC;gBAGnC,UAAU,EAAE,OAAO,EACnB,MAAM,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB;CAUJ;AAED,qBAAa,gCAAiC,SAAQ,KAAK;IACzD,SAAgB,MAAM,EAAE,GAAG,CAAC;IAC5B,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU;CAOtD"}

package/dist.commonjs/ckb/transactionErrors.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorTransactionInsufficientCoin = exports.ErrorTransactionInsufficientCapacity = void 0;
+const index_js_1 = require("../fixedPoint/index.js");
+const index_js_2 = require("../num/index.js");
+const script_js_1 = require("./script.js");
+class ErrorTransactionInsufficientCapacity extends Error {
+    constructor(amountLike, reason) {
+        const amount = (0, index_js_2.numFrom)(amountLike);
+        const isForChange = reason?.isForChange ?? false;
+        super(`Insufficient CKB, need ${(0, index_js_1.fixedPointToString)(amount)} extra CKB${isForChange ? " for the change cell" : ""}`);
+        this.amount = amount;
+        this.isForChange = isForChange;
+    }
+}
+exports.ErrorTransactionInsufficientCapacity = ErrorTransactionInsufficientCapacity;
+class ErrorTransactionInsufficientCoin extends Error {
+    constructor(amountLike, typeLike) {
+        const amount = (0, index_js_2.numFrom)(amountLike);
+        const type = script_js_1.Script.from(typeLike);
+        super(`Insufficient coin, need ${amount} extra coin`);
+        this.amount = amount;
+        this.type = type;
+    }
+}
+exports.ErrorTransactionInsufficientCoin = ErrorTransactionInsufficientCoin;

package/dist.commonjs/client/cache/cache.d.ts

@@ -87,5 +87,12 @@ export declare abstract class ClientCache {
      * @param _number
      */
     getBlockByNumber(_number: NumLike): Promise<ClientBlock | undefined>;
+    /**
+     * Checks if a block header is considered confirmed.
+     * The default implementation compares the header's timestamp against the current time
+     * and a configured confirmation time. Override this method for custom confirmation logic.
+     * @param header
+     */
+    hasHeaderConfirmed(header: ClientBlockHeader): boolean;
 }
 //# sourceMappingURL=cache.d.ts.map

package/dist.commonjs/client/cache/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/client/cache/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,yBAAyB,EACzB,6BAA6B,EAC9B,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,8BAAsB,WAAW;IAC/B,QAAQ,CAAC,iBAAiB,CACxB,GAAG,SAAS,EAAE,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC,EAAE,GACtC,OAAO,CAAC,IAAI,CAAC;IACV,UAAU,CAAC,GAAG,SAAS,EAAE,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxE,QAAQ,CAAC,YAAY,CACnB,GAAG,YAAY,EAAE,CAAC,YAAY,GAAG,YAAY,EAAE,CAAC,EAAE,GACjD,OAAO,CAAC,IAAI,CAAC;IACV,gBAAgB,CACpB,GAAG,eAAe,EAAE,CAAC,eAAe,GAAG,eAAe,EAAE,CAAC,EAAE,GAC1D,OAAO,CAAC,IAAI,CAAC;IA4BhB,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAChB,MAAM,EAAE,8BAA8B,GACrC,cAAc,CAAC,IAAI,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAMjE;;;;OAIG;IACG,WAAW,CAAC,GAAG,MAAM,EAAE,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IACtE;;;;OAIG;IACG,OAAO,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;IAIjE;;;;OAIG;IACG,0BAA0B,CAC9B,GAAG,aAAa,EAAE,CACd,6BAA6B,GAC7B,6BAA6B,EAAE,CAClC,EAAE,GACF,OAAO,CAAC,IAAI,CAAC;IAChB;;;;OAIG;IACG,sBAAsB,CAC1B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC;IAGjD;;;OAGG;IACG,kBAAkB,CACtB,GAAG,YAAY,EAAE,CAAC,eAAe,GAAG,eAAe,EAAE,CAAC,EAAE,GACvD,OAAO,CAAC,IAAI,CAAC;IAQhB;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAIvE;;;;OAIG;IACG,aAAa,CACjB,GAAG,QAAQ,EAAE,CAAC,qBAAqB,GAAG,qBAAqB,EAAE,CAAC,EAAE,GAC/D,OAAO,CAAC,IAAI,CAAC;IAChB;;;;OAIG;IACG,eAAe,CACnB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAGzC;;;;OAIG;IACG,iBAAiB,CACrB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAIzC;;;;OAIG;IACG,YAAY,CAChB,GAAG,OAAO,EAAE,CAAC,eAAe,GAAG,eAAe,EAAE,CAAC,EAAE,GAClD,OAAO,CAAC,IAAI,CAAC;IAChB;;;;OAIG;IACG,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAGtE;;;;OAIG;IACG,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;CAG3E"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/client/cache/cache.ts"],"names":[],"mappings":"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"}

package/dist.commonjs/client/cache/cache.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClientCache = void 0;
 const index_js_1 = require("../../ckb/index.js");
+const index_js_2 = require("../../num/index.js");
+const memory_advanced_js_1 = require("./memory.advanced.js");
 /**
  * @public
  * The ClientCache class is mainly designed for chained transactions.
@@ -128,5 +130,14 @@ class ClientCache {
     async getBlockByNumber(_number) {
         return;
     }
+    /**
+     * Checks if a block header is considered confirmed.
+     * The default implementation compares the header's timestamp against the current time
+     * and a configured confirmation time. Override this method for custom confirmation logic.
+     * @param header
+     */
+    hasHeaderConfirmed(header) {
+        return ((0, index_js_2.numFrom)(Date.now()) - header.timestamp >= memory_advanced_js_1.DEFAULT_CONFIRMED_BLOCK_TIME);
+    }
 }
 exports.ClientCache = ClientCache;

package/dist.commonjs/client/cache/memory.advanced.d.ts

@@ -2,6 +2,7 @@ import { Cell, CellLike, ScriptLike } from "../../ckb/index.js";
 import { HexLike } from "../../hex/index.js";
 import { NumLike } from "../../num/index.js";
 import { ClientCollectableSearchKeyLike } from "../clientTypes.advanced.js";
+export declare const DEFAULT_CONFIRMED_BLOCK_TIME: bigint;
 export type CellRecord = [
     false,
     Pick<Cell, "outPoint"> & Partial<Pick<Cell, "cellOutput" | "outputData">>
@@ -11,12 +12,44 @@ export declare function filterScript(valueLike: ScriptLike | undefined, filterLi
 export declare function filterNumByRange(lengthLike: NumLike, range: [NumLike, NumLike] | undefined): boolean;
 export declare function filterScriptByLenRange(valueLike?: ScriptLike, scriptLenRange?: [NumLike, NumLike]): boolean;
 export declare function filterCell(searchKeyLike: ClientCollectableSearchKeyLike, cellLike: CellLike): boolean;
+/**
+ * A Least Recently Used (LRU) cache implemented using a Map.
+ *
+ * This class extends the built-in Map to provide an LRU cache with a fixed capacity.
+ * When the cache is full, the least recently used entry is automatically evicted.
+ *
+ * @template K The type of the keys in the cache.
+ * @template V The type of the values in the cache.
+ */
 export declare class MapLru<K, V> extends Map<K, V> {
     private readonly capacity;
-    private readonly lru;
+    /**
+     * Constructs a new MapLru instance.
+     *
+     * @param capacity The maximum number of entries the cache can hold. Must be a positive integer.
+     * @throws {Error} If the capacity is not a positive integer.
+     */
     constructor(capacity: number);
-    get(key: K): (V & ({} | null)) | undefined;
+    /**
+     * Retrieves a value from the cache.
+     *
+     * If the key is present in the cache, the value is moved to the most-recently-used position.
+     *
+     * @param key The key of the value to retrieve.
+     * @returns The value associated with the key, or undefined if the key is not present.
+     */
+    get(key: K): V | undefined;
+    /**
+     * Inserts a new value into the cache, or updates an existing value.
+     *
+     * If the key is already present in the cache, it is first deleted so that the re-insertion
+     * moves it to the most-recently-used position.
+     * If the cache is over capacity after the insertion, the least recently used entry is evicted.
+     *
+     * @param key The key of the value to insert or update.
+     * @param value The value to associate with the key.
+     * @returns This MapLru instance.
+     */
     set(key: K, value: V): this;
-    delete(key: K): boolean;
 }
 //# sourceMappingURL=memory.advanced.d.ts.map

package/dist.commonjs/client/cache/memory.advanced.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.advanced.d.ts","sourceRoot":"","sources":["../../../src/client/cache/memory.advanced.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAU,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAW,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAW,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,8BAA8B,EAE/B,MAAM,4BAA4B,CAAC;AAIpC,MAAM,MAAM,UAAU,GAClB;IACE,KAAK;IACL,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAAC,CAAC;CAC1E,GACD,CAAC,IAAI,EAAE,IAAI,CAAC,GACZ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAEtB,wBAAgB,UAAU,CACxB,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,OAAO,GAAG,SAAS,EAC/B,UAAU,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GACzC,OAAO,CAgBT;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,UAAU,GAAG,SAAS,EACjC,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,UAAU,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,GACzC,OAAO,CAkBT;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,OAAO,EACnB,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,GACpC,OAAO,CAQT;AAED,wBAAgB,sBAAsB,CACpC,SAAS,CAAC,EAAE,UAAU,EACtB,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,GAClC,OAAO,CAYT;AAED,wBAAgB,UAAU,CACxB,aAAa,EAAE,8BAA8B,EAC7C,QAAQ,EAAE,QAAQ,GACjB,OAAO,CA4CT;AAED,qBAAa,MAAM,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAG7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAW;gBAEF,QAAQ,EAAE,MAAM;IAI7C,GAAG,CAAC,GAAG,EAAE,CAAC;IAmBV,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;IAOpB,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;CAYxB"}
+{"version":3,"file":"memory.advanced.d.ts","sourceRoot":"","sources":["../../../src/client/cache/memory.advanced.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAU,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAW,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAW,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,8BAA8B,EAE/B,MAAM,4BAA4B,CAAC;AAGpC,eAAO,MAAM,4BAA4B,QAA0B,CAAC;AAGpE,MAAM,MAAM,UAAU,GAClB;IACE,KAAK;IACL,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAAC,CAAC;CAC1E,GACD,CAAC,IAAI,EAAE,IAAI,CAAC,GACZ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAEtB,wBAAgB,UAAU,CACxB,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,OAAO,GAAG,SAAS,EAC/B,UAAU,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GACzC,OAAO,CAgBT;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,UAAU,GAAG,SAAS,EACjC,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,UAAU,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,GACzC,OAAO,CAkBT;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,OAAO,EACnB,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,GACpC,OAAO,CAQT;AAED,wBAAgB,sBAAsB,CACpC,SAAS,CAAC,EAAE,UAAU,EACtB,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,GAClC,OAAO,CAYT;AAED,wBAAgB,UAAU,CACxB,aAAa,EAAE,8BAA8B,EAC7C,QAAQ,EAAE,QAAQ,GACjB,OAAO,CA4CT;AAED;;;;;;;;GAQG;AACH,qBAAa,MAAM,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAO7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IANrC;;;;;OAKG;gBAC0B,QAAQ,EAAE,MAAM;IAO7C;;;;;;;OAOG;IACM,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAenC;;;;;;;;;;OAUG;IACM,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;CAarC"}

package/dist.commonjs/client/cache/memory.advanced.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MapLru = void 0;
+exports.MapLru = exports.DEFAULT_CONFIRMED_BLOCK_TIME = void 0;
 exports.filterData = filterData;
 exports.filterScript = filterScript;
 exports.filterNumByRange = filterNumByRange;
@@ -12,6 +12,7 @@ const index_js_3 = require("../../hex/index.js");
 const index_js_4 = require("../../num/index.js");
 const clientTypes_advanced_js_1 = require("../clientTypes.advanced.js");
 const clientTypes_js_1 = require("../clientTypes.js");
+exports.DEFAULT_CONFIRMED_BLOCK_TIME = (0, index_js_4.numFrom)(1000 * 10 * 50); // 50 blocks * 10s
 function filterData(dataLike, filterLike, filterMode) {
     if (!filterLike) {
         return true;
@@ -86,42 +87,69 @@ function filterCell(searchKeyLike, cellLike) {
     }
     return true;
 }
+/**
+ * A Least Recently Used (LRU) cache implemented using a Map.
+ *
+ * This class extends the built-in Map to provide an LRU cache with a fixed capacity.
+ * When the cache is full, the least recently used entry is automatically evicted.
+ *
+ * @template K The type of the keys in the cache.
+ * @template V The type of the values in the cache.
+ */
 class MapLru extends Map {
+    /**
+     * Constructs a new MapLru instance.
+     *
+     * @param capacity The maximum number of entries the cache can hold. Must be a positive integer.
+     * @throws {Error} If the capacity is not a positive integer.
+     */
     constructor(capacity) {
         super();
         this.capacity = capacity;
-        this.lru = [];
+        if (!Number.isInteger(capacity) || capacity < 1) {
+            throw new Error("Capacity must be a positive integer");
+        }
     }
+    /**
+     * Retrieves a value from the cache.
+     *
+     * If the key is present in the cache, the value is moved to the most-recently-used position.
+     *
+     * @param key The key of the value to retrieve.
+     * @returns The value associated with the key, or undefined if the key is not present.
+     */
     get(key) {
-        const val = super.get(key);
-        if (val === undefined) {
-            return;
-        }
-        const index = this.lru.indexOf(key);
-        if (index !== -1) {
-            this.lru.splice(index, 1);
-        }
-        this.lru.push(key);
-        if (this.lru.length > this.capacity) {
-            this.delete(this.lru[0]);
-            this.lru.shift();
+        // Check if the key exists. If not, return undefined.
+        if (!super.has(key)) {
+            return undefined;
         }
-        return val;
+        const value = super.get(key);
+        // Move to most-recently-used position
+        super.delete(key);
+        super.set(key, value);
+        return value;
     }
+    /**
+     * Inserts a new value into the cache, or updates an existing value.
+     *
+     * If the key is already present in the cache, it is first deleted so that the re-insertion
+     * moves it to the most-recently-used position.
+     * If the cache is over capacity after the insertion, the least recently used entry is evicted.
+     *
+     * @param key The key of the value to insert or update.
+     * @param value The value to associate with the key.
+     * @returns This MapLru instance.
+     */
     set(key, value) {
-        this.get(key);
+        // Delete and re-insert to move key to the end (most-recently-used)
+        super.delete(key);
         super.set(key, value);
-        return this;
-    }
-    delete(key) {
-        if (!super.delete(key)) {
-            return false;
-        }
-        const index = this.lru.indexOf(key);
-        if (index !== -1) {
-            this.lru.splice(index, 1);
+        // Evict oldest if over capacity
+        if (super.size > this.capacity) {
+            const oldestKey = super.keys().next().value;
+            super.delete(oldestKey);
         }
-        return true;
+        return this;
     }
 }
 exports.MapLru = MapLru;

package/dist.commonjs/client/cache/memory.d.ts

@@ -8,6 +8,7 @@ export declare class ClientCacheMemory extends ClientCache {
     private readonly maxCells;
     private readonly maxTxs;
     private readonly maxBlocks;
+    private readonly confirmedBlockTime;
     /**
      * OutPoint => [isLive, Cell | OutPoint]
      */
@@ -24,7 +25,14 @@ export declare class ClientCacheMemory extends ClientCache {
      * Block Hash => Block Header / Full Block
      */
     private readonly knownBlocks;
-    constructor(maxCells?: number, maxTxs?: number, maxBlocks?: number);
+    /**
+     * @param maxCells - Maximum number of cells to store in the cache. Defaults to 512.
+     * @param maxTxs - Maximum number of transactions to store in the cache. Defaults to 256.
+     * @param maxBlocks - Maximum number of blocks to store in the cache. Defaults to 128.
+     * @param confirmedBlockTime - Time in milliseconds after which a block is considered confirmed.
+     *                              Defaults to DEFAULT_CONFIRMED_BLOCK_TIME (50 blocks * 10s).
+     */
+    constructor(maxCells?: number, maxTxs?: number, maxBlocks?: number, confirmedBlockTime?: bigint);
     markUsableNoCache(...cellLikes: (CellLike | CellLike[])[]): Promise<void>;
     markUnusable(...outPointLikes: (OutPointLike | OutPointLike[])[]): Promise<void>;
     clear(): Promise<void>;
@@ -40,5 +48,6 @@ export declare class ClientCacheMemory extends ClientCache {
     recordBlocks(...blocks: (ClientBlockLike | ClientBlockLike[])[]): Promise<void>;
     getBlockByHash(hashLike: HexLike): Promise<ClientBlock | undefined>;
     getBlockByNumber(numberLike: NumLike): Promise<ClientBlock | undefined>;
+    hasHeaderConfirmed(header: ClientBlockHeader): boolean;
 }
 //# sourceMappingURL=memory.d.ts.map

package/dist.commonjs/client/cache/memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/client/cache/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAY,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAW,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAgB,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,yBAAyB,EACzB,6BAA6B,EAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,qBAAa,iBAAkB,SAAQ,WAAW;IAyB9C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IA1B5B;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IAEnD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4C;IAE9E;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsB;IAEvD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAG1B;gBAGiB,QAAQ,SAAM,EACd,MAAM,SAAM,EACZ,SAAS,SAAM;IAe5B,iBAAiB,CACrB,GAAG,SAAS,EAAE,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC,EAAE,GACtC,OAAO,CAAC,IAAI,CAAC;IASV,YAAY,CAChB,GAAG,aAAa,EAAE,CAAC,YAAY,GAAG,YAAY,EAAE,CAAC,EAAE,GAClD,OAAO,CAAC,IAAI,CAAC;IAcV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB,SAAS,CACd,OAAO,EAAE,8BAA8B,GACtC,cAAc,CAAC,IAAI,CAAC;IAcjB,UAAU,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAMxD,WAAW,CAAC,GAAG,KAAK,EAAE,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/D,OAAO,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;IAS9D,0BAA0B,CAC9B,GAAG,YAAY,EAAE,CACb,6BAA6B,GAC7B,6BAA6B,EAAE,CAClC,EAAE,GACF,OAAO,CAAC,IAAI,CAAC;IAMV,sBAAsB,CAC1B,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC;IAK3C,aAAa,CACjB,GAAG,OAAO,EAAE,CAAC,qBAAqB,GAAG,qBAAqB,EAAE,CAAC,EAAE,GAC9D,OAAO,CAAC,IAAI,CAAC;IAaV,eAAe,CACnB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAQnC,iBAAiB,CACrB,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAUnC,YAAY,CAChB,GAAG,MAAM,EAAE,CAAC,eAAe,GAAG,eAAe,EAAE,CAAC,EAAE,GACjD,OAAO,CAAC,IAAI,CAAC;IAQV,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAWnE,gBAAgB,CACpB,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;CASpC"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/client/cache/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAY,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAW,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAgB,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,yBAAyB,EACzB,6BAA6B,EAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQzC,qBAAa,iBAAkB,SAAQ,WAAW;IAgC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAlCrC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IAEnD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4C;IAE9E;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsB;IAEvD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAG1B;IAEF;;;;;;OAMG;gBAEgB,QAAQ,SAAM,EACd,MAAM,SAAM,EACZ,SAAS,SAAM,EACf,kBAAkB,SAA+B;IAe9D,iBAAiB,CACrB,GAAG,SAAS,EAAE,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC,EAAE,GACtC,OAAO,CAAC,IAAI,CAAC;IASV,YAAY,CAChB,GAAG,aAAa,EAAE,CAAC,YAAY,GAAG,YAAY,EAAE,CAAC,EAAE,GAClD,OAAO,CAAC,IAAI,CAAC;IAcV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB,SAAS,CACd,OAAO,EAAE,8BAA8B,GACtC,cAAc,CAAC,IAAI,CAAC;IAcjB,UAAU,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAMxD,WAAW,CAAC,GAAG,KAAK,EAAE,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/D,OAAO,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;IAS9D,0BAA0B,CAC9B,GAAG,YAAY,EAAE,CACb,6BAA6B,GAC7B,6BAA6B,EAAE,CAClC,EAAE,GACF,OAAO,CAAC,IAAI,CAAC;IAMV,sBAAsB,CAC1B,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC;IAK3C,aAAa,CACjB,GAAG,OAAO,EAAE,CAAC,qBAAqB,GAAG,qBAAqB,EAAE,CAAC,EAAE,GAC9D,OAAO,CAAC,IAAI,CAAC;IAaV,eAAe,CACnB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAQnC,iBAAiB,CACrB,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAUnC,YAAY,CAChB,GAAG,MAAM,EAAE,CAAC,eAAe,GAAG,eAAe,EAAE,CAAC,EAAE,GACjD,OAAO,CAAC,IAAI,CAAC;IAQV,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAWnE,gBAAgB,CACpB,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAUnC,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO;CAGvD"}

package/dist.commonjs/client/cache/memory.js

@@ -8,11 +8,19 @@ const clientTypes_js_1 = require("../clientTypes.js");
 const cache_js_1 = require("./cache.js");
 const memory_advanced_js_1 = require("./memory.advanced.js");
 class ClientCacheMemory extends cache_js_1.ClientCache {
-    constructor(maxCells = 512, maxTxs = 256, maxBlocks = 128) {
+    /**
+     * @param maxCells - Maximum number of cells to store in the cache. Defaults to 512.
+     * @param maxTxs - Maximum number of transactions to store in the cache. Defaults to 256.
+     * @param maxBlocks - Maximum number of blocks to store in the cache. Defaults to 128.
+     * @param confirmedBlockTime - Time in milliseconds after which a block is considered confirmed.
+     *                              Defaults to DEFAULT_CONFIRMED_BLOCK_TIME (50 blocks * 10s).
+     */
+    constructor(maxCells = 512, maxTxs = 256, maxBlocks = 128, confirmedBlockTime = memory_advanced_js_1.DEFAULT_CONFIRMED_BLOCK_TIME) {
         super();
         this.maxCells = maxCells;
         this.maxTxs = maxTxs;
         this.maxBlocks = maxBlocks;
+        this.confirmedBlockTime = confirmedBlockTime;
         this.cells = new memory_advanced_js_1.MapLru(this.maxCells);
         this.knownTransactions = new memory_advanced_js_1.MapLru(this.maxTxs);
         this.knownBlockHashes = new memory_advanced_js_1.MapLru(this.maxBlocks);
@@ -137,5 +145,8 @@ class ClientCacheMemory extends cache_js_1.ClientCache {
         }
         return this.getBlockByHash(hash);
     }
+    hasHeaderConfirmed(header) {
+        return (0, index_js_3.numFrom)(Date.now()) - header.timestamp >= this.confirmedBlockTime;
+    }
 }
 exports.ClientCacheMemory = ClientCacheMemory;