@xyo-network/chain-sdk 5.1.1 → 5.2.1

package/dist/neutral/modules/services/implementation/processPendingBlocks.d.ts

@@ -14,6 +14,11 @@ interface ProcessPendingBlocksParams {
     /** Computes producer standing, for the shadow and enforce postures. */
     eligibility?: ProducerEligibilityEvaluator;
     finalizationRunner: FinalizationRunner;
+    /**
+     * Minimum epoch spacing (ms) between transaction-less heartbeat blocks the head selector will
+     * qualify; transaction-carrying candidates are exempt. Undefined disables the pace check.
+     */
+    heartbeatInterval?: number;
     logger?: Logger;
     mempoolViewer: MempoolViewer;
     minCandidates?: number;
@@ -25,7 +30,7 @@ interface ProcessPendingBlocksParams {
     /** Where to publish what both admission gates concluded, in shadow posture. */
     publishAdmissionShadow?: (report: AdmissionShadowReport) => Promise<void>;
 }
-export declare function processPendingBlocks({ blockValidationViewer, blockViewer, context, logger, mempoolViewer, finalizationRunner, allowedProducers, backoffMs, minCandidates, deadLetterQueueRunner, observer, admission, eligibility, publishAdmissionShadow, }: ProcessPendingBlocksParams): Promise<[{
+export declare function processPendingBlocks({ blockValidationViewer, blockViewer, context, logger, mempoolViewer, finalizationRunner, allowedProducers, backoffMs, heartbeatInterval, minCandidates, deadLetterQueueRunner, observer, admission, eligibility, publishAdmissionShadow, }: ProcessPendingBlocksParams): Promise<[{
     schema: "network.xyo.boundwitness" & {
         readonly __schema: true;
     };

package/dist/neutral/modules/services/implementation/processPendingBlocks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"processPendingBlocks.d.ts","sourceRoot":"","sources":["../../../../../src/modules/services/implementation/processPendingBlocks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EACV,WAAW,EAAE,qBAAqB,EAAE,WAAW,EAAE,qBAAqB,EAAE,kBAAkB,EAA6B,aAAa,EACrI,MAAM,sBAAsB,CAAA;AAK7B,OAAO,KAAK,EACV,aAAa,EAAE,qBAAqB,EAAE,4BAA4B,EACnE,MAAM,UAAU,CAAA;AAKjB,UAAU,0BAA0B;IAClC,uFAAuF;IACvF,SAAS,CAAC,EAAE,aAAa,CAAA;IACzB,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qBAAqB,EAAE,qBAAqB,CAAA;IAC5C,WAAW,EAAE,WAAW,CAAA;IACxB,OAAO,EAAE,WAAW,CAAA;IACpB,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;IAC7C,uEAAuE;IACvE,WAAW,CAAC,EAAE,4BAA4B,CAAA;IAC1C,kBAAkB,EAAE,kBAAkB,CAAA;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,aAAa,CAAA;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,+EAA+E;IAC/E,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1E;AAgCD,wBAAsB,oBAAoB,CAAC,EACzC,qBAAqB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAE,qBAAqB,EAAE,QAAQ,EACnK,SAAS,EAAE,WAAW,EAAE,sBAAsB,GAC/C,EAAE,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA2E5B"}
+{"version":3,"file":"processPendingBlocks.d.ts","sourceRoot":"","sources":["../../../../../src/modules/services/implementation/processPendingBlocks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EACV,WAAW,EAAE,qBAAqB,EAAE,WAAW,EAAE,qBAAqB,EAAE,kBAAkB,EAA6B,aAAa,EACrI,MAAM,sBAAsB,CAAA;AAK7B,OAAO,KAAK,EACV,aAAa,EAAE,qBAAqB,EAAE,4BAA4B,EACnE,MAAM,UAAU,CAAA;AAKjB,UAAU,0BAA0B;IAClC,uFAAuF;IACvF,SAAS,CAAC,EAAE,aAAa,CAAA;IACzB,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qBAAqB,EAAE,qBAAqB,CAAA;IAC5C,WAAW,EAAE,WAAW,CAAA;IACxB,OAAO,EAAE,WAAW,CAAA;IACpB,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;IAC7C,uEAAuE;IACvE,WAAW,CAAC,EAAE,4BAA4B,CAAA;IAC1C,kBAAkB,EAAE,kBAAkB,CAAA;IACtC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,aAAa,CAAA;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,+EAA+E;IAC/E,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1E;AAgCD,wBAAsB,oBAAoB,CAAC,EACzC,qBAAqB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,SAAS,EAAE,iBAAiB,EAAE,aAAa,EAAE,qBAAqB,EAAE,QAAQ,EACtL,SAAS,EAAE,WAAW,EAAE,sBAAsB,GAC/C,EAAE,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA4E5B"}

package/dist/neutral/modules/services/simple/block/runner/SimpleBlockRunner.d.ts

@@ -3,10 +3,23 @@ import type { AccountInstance, ArchivistInstance, WithHashMeta } from '@xyo-netw
 import type { AccountBalanceViewer, BlockBoundWitness, BlockRewardViewer, BlockRunner, BlockValidationViewer, ChainStakeIntent, CreatableProviderParams, DeadLetterQueueRunner, FinalizationViewer, HydratedBlockStateValidationFunction, MempoolViewer, SignedBlockBoundWitnessWithHashMeta, SignedHydratedBlockWithHashMeta, TimeSyncViewer, Transfer } from '@xyo-network/xl1-sdk';
 import { AbstractCreatableProvider } from '@xyo-network/xl1-sdk';
 import type { BlockRewardDiviner } from '../../../../modules/index.js';
+import type { OffendingTxReason } from './identifyOffendingTransactions.js';
+/** Why and at which build height a transaction was excluded from future candidates. */
+interface ExcludedTransactionEntry {
+    excludedAtBlock: number;
+    reason: OffendingTxReason;
+}
 /**
  * The default block size for a block
  */
 export declare const DEFAULT_BLOCK_SIZE = 10;
+/**
+ * Default minimum age (ms) of the head before a producer emits a transaction-less heartbeat
+ * block. Five minutes keeps a quiet chain visibly alive without accumulating meaningful storage
+ * or block-reward drift. Finalizers use the same default as the floor for how fast they will
+ * finalize heartbeat blocks.
+ */
+export declare const DEFAULT_HEARTBEAT_INTERVAL = 300000;
 /**
  * The amount of time for which a producer will restake their intent
  */
@@ -35,6 +48,12 @@ export interface SimpleBlockRunnerParams extends CreatableProviderParams {
     validateHydratedBlockState?: HydratedBlockStateValidationFunction;
 }
 export declare class SimpleBlockRunner extends AbstractCreatableProvider<SimpleBlockRunnerParams> implements BlockRunner {
+    /**
+     * Minimum time between build attempts after a fully-rejected build (validation exhausted with
+     * no attributable transaction to exclude). Such a build fails identically until external state
+     * changes, so retrying at the production tick rate only churns build → validate → DLQ.
+     */
+    static readonly RejectedBuildBackoffMs = 1000;
     static readonly connectionTypes: readonly ["lmdb", "mongo", "memory"];
     static readonly defaultMoniker: "BlockRunner";
     static readonly dependencies: ("AccountBalanceViewer" | "MempoolViewer" | "BlockRewardViewer" | "BlockValidationViewer" | "FinalizationViewer" | "TimeSyncViewer")[];
@@ -43,7 +62,7 @@ export declare class SimpleBlockRunner extends AbstractCreatableProvider<SimpleB
     moniker: "BlockRunner";
     protected _blockRewardDiviner?: BlockRewardDiviner;
     protected _deadLetterQueueRunner?: DeadLetterQueueRunner;
-    protected _excludedTransactionHashes: Set<import("@ariestools/sdk").BrandedHash>;
+    protected _excludedTransactionHashes: Map<import("@ariestools/sdk").BrandedHash, ExcludedTransactionEntry>;
     protected _lastRedeclarationBlock?: number;
     protected _rejectedTransactionsArchivist?: ArchivistInstance;
     private _account?;
@@ -53,6 +72,7 @@ export declare class SimpleBlockRunner extends AbstractCreatableProvider<SimpleB
     private _blockValidationViewer?;
     private _chainParamsViewer?;
     private _finalizationViewer?;
+    private _lastRejectedBuildAt;
     /** Cache of the last candidate this runner signed; the mempool is the source of truth. */
     private _lastSignedCandidate?;
     private _mempoolViewer?;
@@ -137,6 +157,8 @@ export declare class SimpleBlockRunner extends AbstractCreatableProvider<SimpleB
         _hash: import("@ariestools/sdk").BrandedHash;
         _dataHash: import("@ariestools/sdk").BrandedHash;
     }[]] | undefined>;
+    private addTransferOutflow;
+    private commitProposedBlock;
     /**
      * Compute the cumulative outflow a single tx would charge to its `from`
      * address, using the same rule as `BlockCumulativeBalanceValidator`:
@@ -146,8 +168,13 @@ export declare class SimpleBlockRunner extends AbstractCreatableProvider<SimpleB
      * reject, which would otherwise wedge the chain because the producer's
      * `_lastProducedBlock` cache mutes retries.
      */
-    private addTransferOutflow;
     private computeTransactionOutflow;
+    /**
+     * Drops head-relative ('block-balance') exclusions once the head has advanced past the height
+     * they were recorded at — the sender's funding is re-evaluated by filterByFunded at the new
+     * head. Deterministic ('tx-invalid') exclusions are kept for the process lifetime.
+     */
+    private evictStaleExclusions;
     private filterByFunded;
     private generateTimePayload;
     /**
@@ -156,6 +183,7 @@ export declare class SimpleBlockRunner extends AbstractCreatableProvider<SimpleB
      * @returns True if a heartbeat is required, false otherwise
      */
     private heartbeatRequired;
+    private isWithinRejectedBuildBackoff;
     /**
      * The hash of this producer's own earlier candidate at the same height and parent, if any.
      *
@@ -189,4 +217,5 @@ export declare class SimpleBlockRunner extends AbstractCreatableProvider<SimpleB
     private resolveSupersedes;
     private runBuildValidateRetryLoop;
 }
+export {};
 //# sourceMappingURL=SimpleBlockRunner.d.ts.map

package/dist/neutral/modules/services/simple/block/runner/SimpleBlockRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SimpleBlockRunner.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/services/simple/block/runner/SimpleBlockRunner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SimpleBlockRunner.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/services/simple/block/runner/SimpleBlockRunner.ts"],"names":[],"mappings":"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"}

package/dist/neutral/services.mjs

@@ -168,6 +168,7 @@ async function processPendingBlocks({
   finalizationRunner,
   allowedProducers,
   backoffMs,
+  heartbeatInterval,
   minCandidates,
   deadLetterQueueRunner,
   observer,
@@ -185,6 +186,7 @@ async function processPendingBlocks({
     windowedFinalizedChain: [currentBlock],
     allowedProducers,
     backoffMs,
+    heartbeatInterval,
     minCandidates,
     admission,
     eligibility,
@@ -450,15 +452,19 @@ function producerTuningFromConfig(config) {
 
 // src/modules/services/simple/block/runner/SimpleBlockRunner.ts
 var DEFAULT_BLOCK_SIZE = 10;
+var DEFAULT_HEARTBEAT_INTERVAL = 3e5;
 var XYO_PRODUCER_REDECLARATION_DURATION = 100;
 var XYO_PRODUCER_REDECLARATION_WINDOW = 100;
 var SimpleBlockRunner = class extends AbstractCreatableProvider4 {
   moniker = SimpleBlockRunner.defaultMoniker;
   _blockRewardDiviner;
   _deadLetterQueueRunner;
-  // TODO(producer-exclusion-set): uncapped for v1. If memory grows in long-running producers,
-  // add FIFO eviction or a TTL keyed off block number.
-  _excludedTransactionHashes = /* @__PURE__ */ new Set();
+  // Reason-scoped: deterministic ('tx-invalid') exclusions last the process lifetime, while
+  // head-relative ('block-balance') exclusions evict once the head advances past the height they
+  // were recorded at — a sender underfunded at head H may be funded at H+k, and permanent
+  // exclusion would censor them. TODO(producer-exclusion-set): 'tx-invalid' entries are still
+  // uncapped; add FIFO eviction if memory grows in long-running producers.
+  _excludedTransactionHashes = /* @__PURE__ */ new Map();
   _lastRedeclarationBlock;
   _rejectedTransactionsArchivist;
   _account;
@@ -468,6 +474,7 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider4 {
   _blockValidationViewer;
   _chainParamsViewer;
   _finalizationViewer;
+  _lastRejectedBuildAt = 0;
   /** Cache of the last candidate this runner signed; the mempool is the source of truth. */
   _lastSignedCandidate;
   _mempoolViewer;
@@ -512,7 +519,7 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider4 {
     return this._finalizationViewer;
   }
   get heartbeatInterval() {
-    return this.params.heartbeatInterval ?? this.producerTuning.heartbeatInterval ?? 36e5;
+    return this.params.heartbeatInterval ?? this.producerTuning.heartbeatInterval ?? DEFAULT_HEARTBEAT_INTERVAL;
   }
   get mempoolViewer() {
     return this._mempoolViewer;
@@ -607,10 +614,12 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider4 {
     const shouldValidateBalances = validateBalances ?? this.params.validateBalances ?? true;
     return await this.spanAsync("proposeNextValidBlock", async () => {
       try {
+        if (this.isWithinRejectedBuildBackoff(force)) return;
         const { block: previousBlock } = assertEx4(asBlockBoundWitness(head), () => "Invalid head block");
         const nextBlock = previousBlock + 1;
         const chainId = await this.finalizationViewer.chainId();
         const pendingTransactionsRaw = await this.mempoolViewer.pendingTransactions({ limit: SimpleBlockRunner.DefaultBlockSize });
+        this.evictStaleExclusions(previousBlock);
         const pendingTransactions = pendingTransactionsRaw.filter((tx) => !this._excludedTransactionHashes.has(tx[0]._hash));
         const nextBlockTransactions = await this.rejectWrongChainTransactions(pendingTransactions, chainId);
         this.logger?.log(`Pending Tx Count ${nextBlockTransactions.length}`);
@@ -621,16 +630,11 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider4 {
         const rewardTransferPayloads = await this.getBlockRewardTransfers(nextBlock);
         nonTxPayloads.push(...rewardTransferPayloads);
         const transactionTransfers = await generateTransactionFeeTransfers(this.address, nextBlockTransactions);
-        const timeStart = Date.now();
         const timePayload = await this.generateTimePayload();
-        const timeDuration = Date.now() - timeStart;
-        if (timeDuration > 100) {
-          this.logger?.warn(`[Slow] Generated time payload in ${timeDuration}ms`);
-        }
         const [initialFundedTransactions, initialFundedTransfers] = await this.filterByFunded(head, nextBlockTransactions, transactionTransfers, shouldValidateBalances);
         const stepRewardBalances = await this.accountBalanceViewer.accountBalances([XYO_STEP_REWARD_ADDRESS]);
         const stepRewardPoolBalance = stepRewardBalances[String(XYO_STEP_REWARD_ADDRESS)];
-        const result = await this.runBuildValidateRetryLoop({
+        const { block: proposedBlock, errors: proposedErrors } = await this.runBuildValidateRetryLoop({
           head,
           chainId,
           stepRewardPoolBalance,
@@ -639,17 +643,31 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider4 {
           initialFundedTransactions,
           initialFundedTransfers
         });
-        const { block: proposedBlock, errors: proposedErrors } = result;
-        if (isSignedHydratedBlockWithHashMeta2(proposedBlock)) {
-          return proposedBlock;
-        }
-        if (proposedBlock !== void 0) await this.rejectExhaustedBlock(proposedBlock, proposedErrors);
+        return await this.commitProposedBlock(proposedBlock, proposedErrors);
       } catch (error) {
         this.logger?.error(`Error proposing next valid block: ${error.message}`);
         throw error;
       }
     }, this.context);
   }
+  addTransferOutflow(outflow, payload) {
+    let result = outflow;
+    for (const [to, amount] of Object.entries(payload.transfers)) {
+      if (to === payload.from) continue;
+      result += hexToBigInt(amount ?? "00");
+    }
+    return result;
+  }
+  async commitProposedBlock(proposedBlock, proposedErrors) {
+    if (proposedErrors.length === 0 && isSignedHydratedBlockWithHashMeta2(proposedBlock)) {
+      this._lastRejectedBuildAt = 0;
+      return proposedBlock;
+    }
+    if (proposedBlock !== void 0) {
+      this._lastRejectedBuildAt = Date.now();
+      await this.rejectExhaustedBlock(proposedBlock, proposedErrors);
+    }
+  }
   /**
    * Compute the cumulative outflow a single tx would charge to its `from`
    * address, using the same rule as `BlockCumulativeBalanceValidator`:
@@ -659,14 +677,6 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider4 {
    * reject, which would otherwise wedge the chain because the producer's
    * `_lastProducedBlock` cache mutes retries.
    */
-  addTransferOutflow(outflow, payload) {
-    let result = outflow;
-    for (const [to, amount] of Object.entries(payload.transfers)) {
-      if (to === payload.from) continue;
-      result += hexToBigInt(amount ?? "00");
-    }
-    return result;
-  }
   computeTransactionOutflow(tx) {
     const [bw, payloads] = tx;
     const {
@@ -684,6 +694,18 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider4 {
     }
     return outflow;
   }
+  /**
+   * Drops head-relative ('block-balance') exclusions once the head has advanced past the height
+   * they were recorded at — the sender's funding is re-evaluated by filterByFunded at the new
+   * head. Deterministic ('tx-invalid') exclusions are kept for the process lifetime.
+   */
+  evictStaleExclusions(headBlock) {
+    for (const [hash, entry] of this._excludedTransactionHashes) {
+      if (entry.reason === "block-balance" && headBlock > entry.excludedAtBlock) {
+        this._excludedTransactionHashes.delete(hash);
+      }
+    }
+  }
   // remove unfunded transactions and block transfers
   async filterByFunded(head, txs, transfers, validateBalances = false) {
     const fundedTransfers = [];
@@ -719,7 +741,13 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider4 {
     return [fundedTransactions, fundedTransfers];
   }
   async generateTimePayload() {
-    return await this.timeSyncViewer.currentTimePayload();
+    const timeStart = Date.now();
+    const timePayload = await this.timeSyncViewer.currentTimePayload();
+    const timeDuration = Date.now() - timeStart;
+    if (timeDuration > 100) {
+      this.logger?.warn(`[Slow] Generated time payload in ${timeDuration}ms`);
+    }
+    return timePayload;
   }
   /**
    * Check if a heartbeat block is required based on network activity.
@@ -733,6 +761,11 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider4 {
     }
     return false;
   }
+  isWithinRejectedBuildBackoff(force) {
+    if (force || Date.now() - this._lastRejectedBuildAt >= SimpleBlockRunner.RejectedBuildBackoffMs) return false;
+    this.logger?.debug("Skipping block production during rejected-build backoff");
+    return true;
+  }
   /**
    * The hash of this producer's own earlier candidate at the same height and parent, if any.
    *
@@ -850,7 +883,11 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider4 {
         chainId,
         supersedes
       );
-      const validated = await this.blockValidationViewer.validateBlock(lastBlock, { head: head._hash });
+      const validated = await this.blockValidationViewer.validateBlock(lastBlock, {
+        value: true,
+        state: true,
+        head: head._hash
+      });
       if (isSignedHydratedBlockWithHashMeta2(validated)) {
         this._lastSignedCandidate = {
           block: validated[0].block,
@@ -863,7 +900,9 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider4 {
       if (attempt === maxAttempts) break;
       const { offendingHashes, reason } = await identifyOffendingTransactions({ candidateTransactions, errors: validated });
       if (offendingHashes.length === 0 || reason === "unknown") break;
-      for (const offendingHash of offendingHashes) this._excludedTransactionHashes.add(offendingHash);
+      for (const offendingHash of offendingHashes) {
+        this._excludedTransactionHashes.set(offendingHash, { excludedAtBlock: head.block, reason });
+      }
       const offendingSet = new Set(offendingHashes);
       candidateTransactions = candidateTransactions.filter((tx) => !offendingSet.has(tx[0]._hash));
       const remainingFromAddresses = new Set(candidateTransactions.map((tx) => tx[0].from));
@@ -874,6 +913,12 @@ var SimpleBlockRunner = class extends AbstractCreatableProvider4 {
     return { block: lastBlock, errors: lastErrors };
   }
 };
+/**
+ * Minimum time between build attempts after a fully-rejected build (validation exhausted with
+ * no attributable transaction to exclude). Such a build fails identically until external state
+ * changes, so retrying at the production tick rate only churns build → validate → DLQ.
+ */
+__publicField(SimpleBlockRunner, "RejectedBuildBackoffMs", 1e3);
 __publicField(SimpleBlockRunner, "connectionTypes", ["lmdb", "mongo", "memory"]);
 __publicField(SimpleBlockRunner, "defaultMoniker", BlockRunnerMoniker);
 __publicField(SimpleBlockRunner, "dependencies", [
@@ -908,6 +953,7 @@ export {
   BaseElectionService,
   BaseNetworkStakeStepRewardService,
   DEFAULT_BLOCK_SIZE,
+  DEFAULT_HEARTBEAT_INTERVAL,
   EvmBlockRewardViewer,
   SimpleBlockRunner,
   ValidatorMoniker,