@lodestar/beacon-node 1.41.0-dev.3b98c59c64 → 1.41.0-dev.477bc362ce

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (210) hide show
  1. package/lib/api/impl/beacon/blocks/index.d.ts.map +1 -1
  2. package/lib/api/impl/beacon/blocks/index.js +3 -2
  3. package/lib/api/impl/beacon/blocks/index.js.map +1 -1
  4. package/lib/api/impl/debug/index.d.ts.map +1 -1
  5. package/lib/api/impl/debug/index.js +1 -0
  6. package/lib/api/impl/debug/index.js.map +1 -1
  7. package/lib/api/impl/node/utils.d.ts +1 -1
  8. package/lib/api/impl/node/utils.d.ts.map +1 -1
  9. package/lib/api/impl/node/utils.js.map +1 -1
  10. package/lib/api/impl/validator/index.js +2 -2
  11. package/lib/api/impl/validator/index.js.map +1 -1
  12. package/lib/chain/archiveStore/utils/updateBackfillRange.js +1 -1
  13. package/lib/chain/archiveStore/utils/updateBackfillRange.js.map +1 -1
  14. package/lib/chain/blocks/blockInput/blockInput.d.ts +20 -2
  15. package/lib/chain/blocks/blockInput/blockInput.d.ts.map +1 -1
  16. package/lib/chain/blocks/blockInput/blockInput.js +47 -0
  17. package/lib/chain/blocks/blockInput/blockInput.js.map +1 -1
  18. package/lib/chain/blocks/blockInput/types.d.ts +2 -1
  19. package/lib/chain/blocks/blockInput/types.d.ts.map +1 -1
  20. package/lib/chain/blocks/blockInput/types.js +1 -0
  21. package/lib/chain/blocks/blockInput/types.js.map +1 -1
  22. package/lib/chain/blocks/importBlock.d.ts.map +1 -1
  23. package/lib/chain/blocks/importBlock.js +26 -3
  24. package/lib/chain/blocks/importBlock.js.map +1 -1
  25. package/lib/chain/blocks/verifyBlocksDataAvailability.d.ts.map +1 -1
  26. package/lib/chain/blocks/verifyBlocksDataAvailability.js +3 -0
  27. package/lib/chain/blocks/verifyBlocksDataAvailability.js.map +1 -1
  28. package/lib/chain/blocks/verifyBlocksExecutionPayloads.d.ts +4 -0
  29. package/lib/chain/blocks/verifyBlocksExecutionPayloads.d.ts.map +1 -1
  30. package/lib/chain/blocks/verifyBlocksExecutionPayloads.js +5 -1
  31. package/lib/chain/blocks/verifyBlocksExecutionPayloads.js.map +1 -1
  32. package/lib/chain/blocks/verifyBlocksSanityChecks.d.ts.map +1 -1
  33. package/lib/chain/blocks/verifyBlocksSanityChecks.js +4 -1
  34. package/lib/chain/blocks/verifyBlocksSanityChecks.js.map +1 -1
  35. package/lib/chain/chain.js +6 -6
  36. package/lib/chain/chain.js.map +1 -1
  37. package/lib/chain/emitter.d.ts +3 -3
  38. package/lib/chain/emitter.d.ts.map +1 -1
  39. package/lib/chain/errors/executionPayloadEnvelope.d.ts +2 -2
  40. package/lib/chain/errors/executionPayloadEnvelope.d.ts.map +1 -1
  41. package/lib/chain/errors/executionPayloadEnvelope.js.map +1 -1
  42. package/lib/chain/forkChoice/index.d.ts.map +1 -1
  43. package/lib/chain/forkChoice/index.js +30 -24
  44. package/lib/chain/forkChoice/index.js.map +1 -1
  45. package/lib/chain/opPools/aggregatedAttestationPool.js +1 -1
  46. package/lib/chain/opPools/aggregatedAttestationPool.js.map +1 -1
  47. package/lib/chain/produceBlock/produceBlockBody.d.ts.map +1 -1
  48. package/lib/chain/produceBlock/produceBlockBody.js +1 -2
  49. package/lib/chain/produceBlock/produceBlockBody.js.map +1 -1
  50. package/lib/chain/regen/queued.d.ts.map +1 -1
  51. package/lib/chain/regen/queued.js +4 -1
  52. package/lib/chain/regen/queued.js.map +1 -1
  53. package/lib/chain/regen/regen.d.ts.map +1 -1
  54. package/lib/chain/regen/regen.js +5 -1
  55. package/lib/chain/regen/regen.js.map +1 -1
  56. package/lib/chain/seenCache/seenGossipBlockInput.d.ts.map +1 -1
  57. package/lib/chain/seenCache/seenGossipBlockInput.js +15 -7
  58. package/lib/chain/seenCache/seenGossipBlockInput.js.map +1 -1
  59. package/lib/chain/validation/aggregateAndProof.js +1 -1
  60. package/lib/chain/validation/aggregateAndProof.js.map +1 -1
  61. package/lib/chain/validation/attestation.js +3 -3
  62. package/lib/chain/validation/attestation.js.map +1 -1
  63. package/lib/chain/validation/attesterSlashing.d.ts.map +1 -1
  64. package/lib/chain/validation/attesterSlashing.js +8 -1
  65. package/lib/chain/validation/attesterSlashing.js.map +1 -1
  66. package/lib/chain/validation/blobSidecar.js +2 -2
  67. package/lib/chain/validation/blobSidecar.js.map +1 -1
  68. package/lib/chain/validation/block.d.ts.map +1 -1
  69. package/lib/chain/validation/block.js +6 -3
  70. package/lib/chain/validation/block.js.map +1 -1
  71. package/lib/chain/validation/dataColumnSidecar.js +1 -1
  72. package/lib/chain/validation/dataColumnSidecar.js.map +1 -1
  73. package/lib/chain/validation/executionPayloadBid.js +1 -2
  74. package/lib/chain/validation/executionPayloadBid.js.map +1 -1
  75. package/lib/chain/validation/executionPayloadEnvelope.js +4 -4
  76. package/lib/chain/validation/executionPayloadEnvelope.js.map +1 -1
  77. package/lib/chain/validation/payloadAttestationMessage.js +1 -2
  78. package/lib/chain/validation/payloadAttestationMessage.js.map +1 -1
  79. package/lib/db/repositories/blockArchive.d.ts.map +1 -1
  80. package/lib/db/repositories/blockArchive.js +1 -2
  81. package/lib/db/repositories/blockArchive.js.map +1 -1
  82. package/lib/execution/engine/http.d.ts +1 -0
  83. package/lib/execution/engine/http.d.ts.map +1 -1
  84. package/lib/execution/engine/http.js +3 -0
  85. package/lib/execution/engine/http.js.map +1 -1
  86. package/lib/metrics/metrics/lodestar.d.ts +3 -0
  87. package/lib/metrics/metrics/lodestar.d.ts.map +1 -1
  88. package/lib/metrics/metrics/lodestar.js +5 -0
  89. package/lib/metrics/metrics/lodestar.js.map +1 -1
  90. package/lib/network/core/networkCore.d.ts +3 -3
  91. package/lib/network/core/networkCore.d.ts.map +1 -1
  92. package/lib/network/core/networkCore.js.map +1 -1
  93. package/lib/network/core/networkCoreWorkerHandler.d.ts +3 -3
  94. package/lib/network/core/networkCoreWorkerHandler.d.ts.map +1 -1
  95. package/lib/network/core/types.d.ts +2 -2
  96. package/lib/network/core/types.d.ts.map +1 -1
  97. package/lib/network/events.d.ts +2 -1
  98. package/lib/network/events.d.ts.map +1 -1
  99. package/lib/network/events.js.map +1 -1
  100. package/lib/network/gossip/encoding.d.ts +3 -3
  101. package/lib/network/gossip/encoding.d.ts.map +1 -1
  102. package/lib/network/gossip/encoding.js.map +1 -1
  103. package/lib/network/gossip/gossipsub.d.ts +13 -4
  104. package/lib/network/gossip/gossipsub.d.ts.map +1 -1
  105. package/lib/network/gossip/gossipsub.js +47 -20
  106. package/lib/network/gossip/gossipsub.js.map +1 -1
  107. package/lib/network/gossip/interface.d.ts +3 -3
  108. package/lib/network/gossip/interface.d.ts.map +1 -1
  109. package/lib/network/gossip/scoringParameters.d.ts +1 -1
  110. package/lib/network/gossip/scoringParameters.d.ts.map +1 -1
  111. package/lib/network/gossip/scoringParameters.js +1 -1
  112. package/lib/network/gossip/scoringParameters.js.map +1 -1
  113. package/lib/network/interface.d.ts +3 -3
  114. package/lib/network/interface.d.ts.map +1 -1
  115. package/lib/network/libp2p/index.d.ts +1 -1
  116. package/lib/network/libp2p/index.d.ts.map +1 -1
  117. package/lib/network/libp2p/index.js +7 -2
  118. package/lib/network/libp2p/index.js.map +1 -1
  119. package/lib/network/network.d.ts +2 -2
  120. package/lib/network/network.d.ts.map +1 -1
  121. package/lib/network/network.js.map +1 -1
  122. package/lib/network/options.d.ts.map +1 -1
  123. package/lib/network/options.js +3 -0
  124. package/lib/network/options.js.map +1 -1
  125. package/lib/network/peers/datastore.d.ts +7 -5
  126. package/lib/network/peers/datastore.d.ts.map +1 -1
  127. package/lib/network/peers/datastore.js +10 -10
  128. package/lib/network/peers/datastore.js.map +1 -1
  129. package/lib/network/peers/peerManager.d.ts +1 -0
  130. package/lib/network/peers/peerManager.d.ts.map +1 -1
  131. package/lib/network/peers/peerManager.js +51 -29
  132. package/lib/network/peers/peerManager.js.map +1 -1
  133. package/lib/network/peers/utils/prioritizePeers.d.ts +3 -3
  134. package/lib/network/peers/utils/prioritizePeers.d.ts.map +1 -1
  135. package/lib/network/processor/gossipHandlers.d.ts.map +1 -1
  136. package/lib/network/processor/gossipHandlers.js +4 -1
  137. package/lib/network/processor/gossipHandlers.js.map +1 -1
  138. package/lib/network/processor/gossipValidatorFn.js +1 -1
  139. package/lib/network/processor/types.d.ts +1 -1
  140. package/lib/network/processor/types.d.ts.map +1 -1
  141. package/lib/network/reqresp/handlers/blobSidecarsByRoot.js +1 -1
  142. package/lib/network/reqresp/handlers/blobSidecarsByRoot.js.map +1 -1
  143. package/lib/network/reqresp/handlers/dataColumnSidecarsByRoot.js +1 -1
  144. package/lib/network/reqresp/handlers/dataColumnSidecarsByRoot.js.map +1 -1
  145. package/lib/network/reqresp/score.d.ts.map +1 -1
  146. package/lib/network/reqresp/score.js +0 -1
  147. package/lib/network/reqresp/score.js.map +1 -1
  148. package/lib/network/util.js +2 -2
  149. package/lib/network/util.js.map +1 -1
  150. package/lib/util/clock.d.ts +6 -0
  151. package/lib/util/clock.d.ts.map +1 -1
  152. package/lib/util/clock.js +9 -3
  153. package/lib/util/clock.js.map +1 -1
  154. package/package.json +38 -41
  155. package/src/api/impl/beacon/blocks/index.ts +3 -2
  156. package/src/api/impl/debug/index.ts +1 -0
  157. package/src/api/impl/node/utils.ts +3 -3
  158. package/src/api/impl/validator/index.ts +2 -2
  159. package/src/chain/archiveStore/utils/updateBackfillRange.ts +1 -1
  160. package/src/chain/blocks/blockInput/blockInput.ts +68 -3
  161. package/src/chain/blocks/blockInput/types.ts +1 -0
  162. package/src/chain/blocks/importBlock.ts +34 -3
  163. package/src/chain/blocks/verifyBlocksDataAvailability.ts +3 -0
  164. package/src/chain/blocks/verifyBlocksExecutionPayloads.ts +9 -2
  165. package/src/chain/blocks/verifyBlocksSanityChecks.ts +7 -2
  166. package/src/chain/chain.ts +6 -6
  167. package/src/chain/emitter.ts +3 -3
  168. package/src/chain/errors/executionPayloadEnvelope.ts +6 -2
  169. package/src/chain/forkChoice/index.ts +39 -21
  170. package/src/chain/opPools/aggregatedAttestationPool.ts +1 -1
  171. package/src/chain/produceBlock/produceBlockBody.ts +1 -2
  172. package/src/chain/regen/queued.ts +7 -2
  173. package/src/chain/regen/regen.ts +8 -2
  174. package/src/chain/seenCache/seenGossipBlockInput.ts +16 -7
  175. package/src/chain/validation/aggregateAndProof.ts +1 -1
  176. package/src/chain/validation/attestation.ts +3 -3
  177. package/src/chain/validation/attesterSlashing.ts +9 -0
  178. package/src/chain/validation/blobSidecar.ts +2 -2
  179. package/src/chain/validation/block.ts +9 -4
  180. package/src/chain/validation/dataColumnSidecar.ts +1 -1
  181. package/src/chain/validation/executionPayloadBid.ts +1 -2
  182. package/src/chain/validation/executionPayloadEnvelope.ts +4 -4
  183. package/src/chain/validation/payloadAttestationMessage.ts +1 -2
  184. package/src/db/repositories/blockArchive.ts +1 -2
  185. package/src/execution/engine/http.ts +3 -0
  186. package/src/metrics/metrics/lodestar.ts +5 -0
  187. package/src/network/core/networkCore.ts +3 -3
  188. package/src/network/core/networkCoreWorkerHandler.ts +3 -3
  189. package/src/network/core/types.ts +2 -2
  190. package/src/network/events.ts +2 -1
  191. package/src/network/gossip/encoding.ts +3 -3
  192. package/src/network/gossip/gossipsub.ts +86 -25
  193. package/src/network/gossip/interface.ts +3 -3
  194. package/src/network/gossip/scoringParameters.ts +4 -4
  195. package/src/network/interface.ts +3 -3
  196. package/src/network/libp2p/index.ts +8 -3
  197. package/src/network/network.ts +3 -3
  198. package/src/network/options.ts +3 -0
  199. package/src/network/peers/datastore.ts +13 -10
  200. package/src/network/peers/peerManager.ts +56 -30
  201. package/src/network/peers/utils/prioritizePeers.ts +3 -3
  202. package/src/network/processor/gossipHandlers.ts +12 -3
  203. package/src/network/processor/gossipValidatorFn.ts +1 -1
  204. package/src/network/processor/types.ts +1 -1
  205. package/src/network/reqresp/handlers/blobSidecarsByRoot.ts +1 -1
  206. package/src/network/reqresp/handlers/dataColumnSidecarsByRoot.ts +1 -1
  207. package/src/network/reqresp/score.ts +0 -1
  208. package/src/network/util.ts +2 -2
  209. package/src/util/clock.ts +9 -4
  210. package/src/util/workerEvents.ts +1 -1
@@ -9,7 +9,7 @@ import {
9
9
  isExecutionEnabled,
10
10
  isExecutionStateType,
11
11
  } from "@lodestar/state-transition";
12
- import {SignedBeaconBlock, deneb, gloas} from "@lodestar/types";
12
+ import {SignedBeaconBlock, deneb, gloas, isGloasBeaconBlock} from "@lodestar/types";
13
13
  import {byteArrayEquals, sleep, toRootHex} from "@lodestar/utils";
14
14
  import {BlockErrorCode, BlockGossipError, GossipAction} from "../errors/index.js";
15
15
  import {IBeaconChain} from "../interface.js";
@@ -56,7 +56,7 @@ export async function validateGossipBlock(
56
56
  // check, we will load the parent and state from disk only to find out later that we
57
57
  // already know this block.
58
58
  const blockRoot = toRootHex(config.getForkTypes(blockSlot).BeaconBlock.hashTreeRoot(block));
59
- if (chain.forkChoice.getBlockHex(blockRoot) !== null) {
59
+ if (chain.forkChoice.getBlockHexDefaultStatus(blockRoot) !== null) {
60
60
  throw new BlockGossipError(GossipAction.IGNORE, {code: BlockErrorCode.ALREADY_KNOWN, root: blockRoot});
61
61
  }
62
62
 
@@ -72,7 +72,12 @@ export async function validateGossipBlock(
72
72
  // [REJECT] The current finalized_checkpoint is an ancestor of block -- i.e.
73
73
  // get_ancestor(store, block.parent_root, compute_start_slot_at_epoch(store.finalized_checkpoint.epoch)) == store.finalized_checkpoint.root
74
74
  const parentRoot = toRootHex(block.parentRoot);
75
- const parentBlock = chain.forkChoice.getBlockHex(parentRoot);
75
+ const parentBlock = isGloasBeaconBlock(block)
76
+ ? chain.forkChoice.getBlockHexAndBlockHash(
77
+ parentRoot,
78
+ toRootHex(block.body.signedExecutionPayloadBid.message.parentBlockHash)
79
+ )
80
+ : chain.forkChoice.getBlockHexDefaultStatus(parentRoot);
76
81
  if (parentBlock === null) {
77
82
  // If fork choice does *not* consider the parent to be a descendant of the finalized block,
78
83
  // then there are two more cases:
@@ -104,7 +109,7 @@ export async function validateGossipBlock(
104
109
 
105
110
  // [REJECT] The block is from a higher slot than its parent.
106
111
  if (parentBlock.slot >= blockSlot) {
107
- throw new BlockGossipError(GossipAction.IGNORE, {
112
+ throw new BlockGossipError(GossipAction.REJECT, {
108
113
  code: BlockErrorCode.NOT_LATER_THAN_PARENT,
109
114
  parentSlot: parentBlock.slot,
110
115
  slot: blockSlot,
@@ -73,7 +73,7 @@ export async function validateGossipDataColumnSidecar(
73
73
  // 6) [IGNORE] The sidecar's block's parent (defined by block_header.parent_root) has been seen (via gossip
74
74
  // or non-gossip sources)
75
75
  const parentRoot = toRootHex(blockHeader.parentRoot);
76
- const parentBlock = chain.forkChoice.getBlockHex(parentRoot);
76
+ const parentBlock = chain.forkChoice.getBlockHexDefaultStatus(parentRoot);
77
77
  if (parentBlock === null) {
78
78
  // If fork choice does *not* consider the parent to be a descendant of the finalized block,
79
79
  // then there are two more cases:
@@ -113,8 +113,7 @@ async function validateExecutionPayloadBid(
113
113
 
114
114
  // [IGNORE] `bid.parent_block_root` is the hash tree root of a known beacon
115
115
  // block in fork choice.
116
- const block = chain.forkChoice.getBlock(bid.parentBlockRoot);
117
- if (block === null) {
116
+ if (!chain.forkChoice.hasBlock(bid.parentBlockRoot)) {
118
117
  throw new ExecutionPayloadBidError(GossipAction.IGNORE, {
119
118
  code: ExecutionPayloadBidErrorCode.UNKNOWN_BLOCK_ROOT,
120
119
  parentBlockRoot: parentBlockRootHex,
@@ -37,7 +37,7 @@ async function validateExecutionPayloadEnvelope(
37
37
  // the block is retrieved).
38
38
  // TODO GLOAS: Need to review this, we should queue the envelope for later
39
39
  // processing if the block is not yet known, otherwise we would ignore it here
40
- const block = chain.forkChoice.getBlock(envelope.beaconBlockRoot);
40
+ const block = chain.forkChoice.getBlockDefaultStatus(envelope.beaconBlockRoot);
41
41
  if (block === null) {
42
42
  throw new ExecutionPayloadEnvelopeError(GossipAction.IGNORE, {
43
43
  code: ExecutionPayloadEnvelopeErrorCode.BLOCK_ROOT_UNKNOWN,
@@ -79,7 +79,7 @@ async function validateExecutionPayloadEnvelope(
79
79
  });
80
80
  }
81
81
 
82
- if (block.builderIndex === undefined || block.blockHashHex === undefined) {
82
+ if (block.builderIndex == null || block.blockHashFromBid == null) {
83
83
  // This indicates this block is a pre-gloas block which is wrong
84
84
  throw new ExecutionPayloadEnvelopeError(GossipAction.IGNORE, {
85
85
  code: ExecutionPayloadEnvelopeErrorCode.CACHE_FAIL,
@@ -97,11 +97,11 @@ async function validateExecutionPayloadEnvelope(
97
97
  }
98
98
 
99
99
  // [REJECT] `payload.block_hash == bid.block_hash`
100
- if (toRootHex(payload.blockHash) !== block.blockHashHex) {
100
+ if (toRootHex(payload.blockHash) !== block.blockHashFromBid) {
101
101
  throw new ExecutionPayloadEnvelopeError(GossipAction.REJECT, {
102
102
  code: ExecutionPayloadEnvelopeErrorCode.BLOCK_HASH_MISMATCH,
103
103
  envelopeBlockHash: toRootHex(payload.blockHash),
104
- bidBlockHash: block.blockHashHex,
104
+ bidBlockHash: block.blockHashFromBid,
105
105
  });
106
106
  }
107
107
 
@@ -59,8 +59,7 @@ async function validatePayloadAttestationMessage(
59
59
  // [IGNORE] The message's block `data.beacon_block_root` has been seen (via
60
60
  // gossip or non-gossip sources) (a client MAY queue attestation for processing
61
61
  // once the block is retrieved. Note a client might want to request payload after).
62
- const block = chain.forkChoice.getBlock(data.beaconBlockRoot);
63
- if (block === null) {
62
+ if (!chain.forkChoice.hasBlock(data.beaconBlockRoot)) {
64
63
  throw new PayloadAttestationError(GossipAction.IGNORE, {
65
64
  code: PayloadAttestationErrorCode.UNKNOWN_BLOCK_ROOT,
66
65
  blockRoot: toRootHex(data.beaconBlockRoot),
@@ -1,4 +1,3 @@
1
- import all from "it-all";
2
1
  import {ChainForkConfig} from "@lodestar/config";
3
2
  import {Db, FilterOptions, KeyValue, Repository} from "@lodestar/db";
4
3
  import {Root, SignedBeaconBlock, Slot, ssz} from "@lodestar/types";
@@ -121,7 +120,7 @@ export class BlockArchiveRepository extends Repository<Slot, SignedBeaconBlock>
121
120
  }
122
121
 
123
122
  async values(opts?: BlockFilterOptions): Promise<SignedBeaconBlock[]> {
124
- return all(this.valuesStream(opts));
123
+ return await Array.fromAsync(this.valuesStream(opts));
125
124
  }
126
125
 
127
126
  // INDEX
@@ -128,6 +128,7 @@ const getClientVersionOpts: ReqOpts = {routeId: "getClientVersion"};
128
128
  */
129
129
  export class ExecutionEngineHttp implements IExecutionEngine {
130
130
  private logger: Logger;
131
+ private metrics: Metrics | null;
131
132
 
132
133
  // The default state is ONLINE, it will be updated to SYNCING once we receive the first payload
133
134
  // This assumption is better than the OFFLINE state, since we can't be sure if the EL is offline and being offline may trigger some notifications
@@ -167,6 +168,7 @@ export class ExecutionEngineHttp implements IExecutionEngine {
167
168
  metrics?.engineHttpProcessorQueue
168
169
  );
169
170
  this.logger = logger;
171
+ this.metrics = metrics ?? null;
170
172
 
171
173
  this.rpc.emitter.on(JsonRpcHttpClientEvent.ERROR, ({error}) => {
172
174
  this.updateEngineState(getExecutionEngineState({payloadError: error, oldState: this.state}));
@@ -369,6 +371,7 @@ export class ExecutionEngineHttp implements IExecutionEngine {
369
371
  } = await request;
370
372
 
371
373
  this.updateEngineState(getExecutionEngineState({payloadStatus: status, oldState: this.state}));
374
+ this.metrics?.engineNotifyForkchoiceUpdateResult.inc({result: status});
372
375
 
373
376
  switch (status) {
374
377
  case ExecutionPayloadStatus.VALID:
@@ -928,6 +928,11 @@ export function createLodestarMetrics(
928
928
  help: "The total result of calling notifyNewPayload execution engine api",
929
929
  labelNames: ["result"],
930
930
  }),
931
+ engineNotifyForkchoiceUpdateResult: register.gauge<{result: ExecutionPayloadStatus}>({
932
+ name: "lodestar_execution_engine_notify_forkchoice_update_result_total",
933
+ help: "The total result of calling notifyForkchoiceUpdate execution engine api",
934
+ labelNames: ["result"],
935
+ }),
931
936
  backfillSync: {
932
937
  backfilledTillSlot: register.gauge({
933
938
  name: "lodestar_backfill_till_slot",
@@ -1,8 +1,8 @@
1
- import {Connection, PrivateKey} from "@libp2p/interface";
1
+ import type {PeerScoreStatsDump} from "@libp2p/gossipsub/score";
2
+ import type {PublishOpts} from "@libp2p/gossipsub/types";
3
+ import type {Connection, PrivateKey} from "@libp2p/interface";
2
4
  import {peerIdFromPrivateKey} from "@libp2p/peer-id";
3
5
  import {multiaddr} from "@multiformats/multiaddr";
4
- import {PeerScoreStatsDump} from "@chainsafe/libp2p-gossipsub/score";
5
- import {PublishOpts} from "@chainsafe/libp2p-gossipsub/types";
6
6
  import {routes} from "@lodestar/api";
7
7
  import {BeaconConfig, ForkBoundary} from "@lodestar/config";
8
8
  import type {LoggerNode} from "@lodestar/logger/node";
@@ -1,9 +1,9 @@
1
1
  import path from "node:path";
2
2
  import workerThreads from "node:worker_threads";
3
3
  import {privateKeyToProtobuf} from "@libp2p/crypto/keys";
4
- import {PrivateKey} from "@libp2p/interface";
5
- import {PeerScoreStatsDump} from "@chainsafe/libp2p-gossipsub/score";
6
- import {PublishOpts} from "@chainsafe/libp2p-gossipsub/types";
4
+ import type {PeerScoreStatsDump} from "@libp2p/gossipsub/score";
5
+ import type {PublishOpts} from "@libp2p/gossipsub/types";
6
+ import type {PrivateKey} from "@libp2p/interface";
7
7
  import {ModuleThread, Thread, Worker, spawn} from "@chainsafe/threads";
8
8
  import {routes} from "@lodestar/api";
9
9
  import {BeaconConfig, chainConfigToJson} from "@lodestar/config";
@@ -1,5 +1,5 @@
1
- import {PeerScoreStatsDump} from "@chainsafe/libp2p-gossipsub/score";
2
- import {PublishOpts} from "@chainsafe/libp2p-gossipsub/types";
1
+ import type {PeerScoreStatsDump} from "@libp2p/gossipsub/score";
2
+ import type {PublishOpts} from "@libp2p/gossipsub/types";
3
3
  import {routes} from "@lodestar/api";
4
4
  import {SpecJson} from "@lodestar/config";
5
5
  import {LoggerNodeOpts} from "@lodestar/logger/node";
@@ -1,5 +1,6 @@
1
1
  import {EventEmitter} from "node:events";
2
- import {PeerId, TopicValidatorResult} from "@libp2p/interface";
2
+ import type {TopicValidatorResult} from "@libp2p/gossipsub";
3
+ import type {PeerId} from "@libp2p/interface";
3
4
  import {CustodyIndex, Status} from "@lodestar/types";
4
5
  import {PeerIdStr} from "../util/peerId.js";
5
6
  import {StrictEventEmitterSingleArg} from "../util/strictEvents.js";
@@ -1,9 +1,9 @@
1
- import {Message} from "@libp2p/interface";
1
+ import type {Message} from "@libp2p/gossipsub";
2
+ import type {RPC} from "@libp2p/gossipsub/message";
3
+ import type {DataTransform} from "@libp2p/gossipsub/types";
2
4
  // snappyjs is better for compression for smaller payloads
3
5
  import xxhashFactory from "xxhash-wasm";
4
6
  import {digest} from "@chainsafe/as-sha256";
5
- import {RPC} from "@chainsafe/libp2p-gossipsub/message";
6
- import {DataTransform} from "@chainsafe/libp2p-gossipsub/types";
7
7
  import snappyWasm from "@chainsafe/snappy-wasm";
8
8
  import {ForkName} from "@lodestar/params";
9
9
  import {intToBytes} from "@lodestar/utils";
@@ -1,10 +1,18 @@
1
+ import {
2
+ type GossipSub,
3
+ type GossipSubEvents,
4
+ type PublishResult,
5
+ StrictNoSign,
6
+ type TopicValidatorResult,
7
+ gossipsub,
8
+ } from "@libp2p/gossipsub";
9
+ import type {MetricsRegister, TopicLabel, TopicStrToLabel} from "@libp2p/gossipsub/metrics";
10
+ import type {PeerScoreParams, PeerScoreStatsDump} from "@libp2p/gossipsub/score";
11
+ import type {AddrInfo, PublishOpts, TopicStr} from "@libp2p/gossipsub/types";
12
+ import type {PeerId} from "@libp2p/interface";
1
13
  import {peerIdFromString} from "@libp2p/peer-id";
2
14
  import {multiaddr} from "@multiformats/multiaddr";
3
15
  import {ENR} from "@chainsafe/enr";
4
- import {GossipSub, GossipsubEvents} from "@chainsafe/libp2p-gossipsub";
5
- import {MetricsRegister, TopicLabel, TopicStrToLabel} from "@chainsafe/libp2p-gossipsub/metrics";
6
- import {PeerScoreParams} from "@chainsafe/libp2p-gossipsub/score";
7
- import {AddrInfo, SignaturePolicy, TopicStr} from "@chainsafe/libp2p-gossipsub/types";
8
16
  import {routes} from "@lodestar/api";
9
17
  import {BeaconConfig, ForkBoundary} from "@lodestar/config";
10
18
  import {ATTESTATION_SUBNET_COUNT, SLOTS_PER_EPOCH, SYNC_COMMITTEE_SUBNET_COUNT} from "@lodestar/params";
@@ -69,6 +77,24 @@ export type Eth2GossipsubOpts = {
69
77
 
70
78
  export type ForkBoundaryLabel = string;
71
79
 
80
+ // Many of the internal properties we need are not available on the public interface,
81
+ // so we create an extended type here to avoid excessive type assertions throughout the codebase.
82
+ // Mind that any updates to the gossipsub package may require updates to this type.
83
+ type GossipSubInternal = GossipSub & {
84
+ mesh: Map<string, Set<string>>;
85
+ peers: Map<string, PeerId>;
86
+ score: {score: (peerIdStr: string) => number};
87
+ direct: Set<string>;
88
+ topics: Map<string, Set<string>>;
89
+ start: () => Promise<void>;
90
+ stop: () => Promise<void>;
91
+ publish: (topic: TopicStr, data: Uint8Array, opts?: PublishOpts) => Promise<PublishResult>;
92
+ getMeshPeers: (topic: TopicStr) => string[];
93
+ dumpPeerScoreStats: () => PeerScoreStatsDump;
94
+ getScore: (peerIdStr: string) => number;
95
+ reportMessageValidationResult: (msgId: string, propagationSource: string, acceptance: TopicValidatorResult) => void;
96
+ };
97
+
72
98
  /**
73
99
  * Wrapper around js-libp2p-gossipsub with the following extensions:
74
100
  * - Eth2 message id
@@ -82,13 +108,14 @@ export type ForkBoundaryLabel = string;
82
108
  *
83
109
  * See https://github.com/ethereum/consensus-specs/blob/v1.1.10/specs/phase0/p2p-interface.md#the-gossip-domain-gossipsub
84
110
  */
85
- export class Eth2Gossipsub extends GossipSub {
111
+ export class Eth2Gossipsub {
86
112
  readonly scoreParams: Partial<PeerScoreParams>;
87
113
  private readonly config: BeaconConfig;
88
114
  private readonly logger: Logger;
89
115
  private readonly peersData: PeersData;
90
116
  private readonly events: NetworkEventBus;
91
117
  private readonly libp2p: Libp2p;
118
+ private readonly gossipsub: GossipSubInternal;
92
119
 
93
120
  // Internal caches
94
121
  private readonly gossipTopicCache: GossipTopicCache;
@@ -103,9 +130,6 @@ export class Eth2Gossipsub extends GossipSub {
103
130
  let metrics: Eth2GossipsubMetrics | null = null;
104
131
  if (metricsRegister) {
105
132
  metrics = createEth2GossipsubMetrics(metricsRegister);
106
- metrics.gossipMesh.peersByType.addCollect(() =>
107
- this.onScrapeLodestarMetrics(metrics as Eth2GossipsubMetrics, networkConfig)
108
- );
109
133
  }
110
134
 
111
135
  // Parse direct peers from multiaddr strings to AddrInfo objects
@@ -113,8 +137,8 @@ export class Eth2Gossipsub extends GossipSub {
113
137
 
114
138
  // Gossipsub parameters defined here:
115
139
  // https://github.com/ethereum/consensus-specs/blob/v1.1.10/specs/phase0/p2p-interface.md#the-gossip-domain-gossipsub
116
- super(modules.libp2p.services.components, {
117
- globalSignaturePolicy: SignaturePolicy.StrictNoSign,
140
+ const gossipsubInstance = gossipsub({
141
+ globalSignaturePolicy: StrictNoSign,
118
142
  allowPublishToZeroTopicPeers: allowPublishToZeroPeers,
119
143
  D: gossipsubD ?? GOSSIP_D,
120
144
  Dlo: gossipsubDLow ?? GOSSIP_D_LOW,
@@ -155,7 +179,12 @@ export class Eth2Gossipsub extends GossipSub {
155
179
  // This should be large enough to not send IDONTWANT for "small" messages
156
180
  // See https://github.com/ChainSafe/lodestar/pull/7077#issuecomment-2383679472
157
181
  idontwantMinDataSize: 16829,
158
- });
182
+ })(modules.libp2p.services.components) as GossipSubInternal;
183
+
184
+ if (metrics) {
185
+ metrics.gossipMesh.peersByType.addCollect(() => this.onScrapeLodestarMetrics(metrics, networkConfig));
186
+ }
187
+ this.gossipsub = gossipsubInstance;
159
188
  this.scoreParams = scoreParams;
160
189
  this.config = config;
161
190
  this.logger = logger;
@@ -164,7 +193,7 @@ export class Eth2Gossipsub extends GossipSub {
164
193
  this.libp2p = modules.libp2p;
165
194
  this.gossipTopicCache = gossipTopicCache;
166
195
 
167
- this.addEventListener("gossipsub:message", this.onGossipsubMessage.bind(this));
196
+ this.gossipsub.addEventListener("gossipsub:message", this.onGossipsubMessage.bind(this));
168
197
  this.events.on(NetworkEvent.gossipMessageValidationResult, this.onValidationResult.bind(this));
169
198
 
170
199
  // Having access to this data is CRUCIAL for debugging. While this is a massive log, it must not be deleted.
@@ -174,6 +203,38 @@ export class Eth2Gossipsub extends GossipSub {
174
203
  }
175
204
  }
176
205
 
206
+ async start(): Promise<void> {
207
+ await this.gossipsub.start();
208
+ }
209
+
210
+ async stop(): Promise<void> {
211
+ await this.gossipsub.stop();
212
+ }
213
+
214
+ get mesh(): Map<string, Set<string>> {
215
+ return this.gossipsub.mesh;
216
+ }
217
+
218
+ getTopics(): TopicStr[] {
219
+ return this.gossipsub.getTopics();
220
+ }
221
+
222
+ getMeshPeers(topic: TopicStr): string[] {
223
+ return this.gossipsub.getMeshPeers(topic);
224
+ }
225
+
226
+ publish(topic: TopicStr, data: Uint8Array, opts?: PublishOpts): Promise<PublishResult> {
227
+ return this.gossipsub.publish(topic, data, opts);
228
+ }
229
+
230
+ dumpPeerScoreStats(): PeerScoreStatsDump {
231
+ return this.gossipsub.dumpPeerScoreStats();
232
+ }
233
+
234
+ getScore(peerIdStr: string): number {
235
+ return this.gossipsub.getScore(peerIdStr);
236
+ }
237
+
177
238
  /**
178
239
  * Subscribe to a `GossipTopic`
179
240
  */
@@ -183,7 +244,7 @@ export class Eth2Gossipsub extends GossipSub {
183
244
  this.gossipTopicCache.setTopic(topicStr, topic);
184
245
 
185
246
  this.logger.verbose("Subscribe to gossipsub topic", {topic: topicStr});
186
- this.subscribe(topicStr);
247
+ this.gossipsub.subscribe(topicStr);
187
248
  }
188
249
 
189
250
  /**
@@ -192,15 +253,14 @@ export class Eth2Gossipsub extends GossipSub {
192
253
  unsubscribeTopic(topic: GossipTopic): void {
193
254
  const topicStr = stringifyGossipTopic(this.config, topic);
194
255
  this.logger.verbose("Unsubscribe to gossipsub topic", {topic: topicStr});
195
- this.unsubscribe(topicStr);
256
+ this.gossipsub.unsubscribe(topicStr);
196
257
  }
197
258
 
198
259
  private onScrapeLodestarMetrics(metrics: Eth2GossipsubMetrics, networkConfig: NetworkConfig): void {
199
- const mesh = this.mesh;
200
- // biome-ignore lint/complexity/useLiteralKeys: `topics` is a private attribute
201
- const topics = this["topics"] as Map<string, Set<string>>;
202
- const peers = this.peers;
203
- const score = this.score;
260
+ const mesh = this.gossipsub.mesh;
261
+ const topics = this.gossipsub.topics;
262
+ const peers = this.gossipsub.peers;
263
+ const score = this.gossipsub.score;
204
264
  const meshPeersByClient = new Map<string, number>();
205
265
  const meshPeerIdStrs = new Set<string>();
206
266
 
@@ -305,7 +365,7 @@ export class Eth2Gossipsub extends GossipSub {
305
365
  metrics.gossipPeer.score.set(gossipScores);
306
366
  }
307
367
 
308
- private onGossipsubMessage(event: GossipsubEvents["gossipsub:message"]): void {
368
+ private onGossipsubMessage(event: GossipSubEvents["gossipsub:message"]): void {
309
369
  const {propagationSource, msgId, msg} = event.detail;
310
370
 
311
371
  // Also validates that the topicStr is known
@@ -341,7 +401,7 @@ export class Eth2Gossipsub extends GossipSub {
341
401
  // Without this we'll have huge event loop lag
342
402
  // See https://github.com/ChainSafe/lodestar/issues/5604
343
403
  callInNextEventLoop(() => {
344
- this.reportMessageValidationResult(data.msgId, data.propagationSource, data.acceptance);
404
+ this.gossipsub.reportMessageValidationResult(data.msgId, data.propagationSource, data.acceptance);
345
405
  });
346
406
  }
347
407
 
@@ -379,7 +439,7 @@ export class Eth2Gossipsub extends GossipSub {
379
439
  }
380
440
 
381
441
  // Add to direct peers set only after addresses are stored
382
- this.direct.add(peerIdStr);
442
+ this.gossipsub.direct.add(peerIdStr);
383
443
 
384
444
  this.logger.info("Added direct peer via API", {peerId: peerIdStr});
385
445
  return peerIdStr;
@@ -389,7 +449,7 @@ export class Eth2Gossipsub extends GossipSub {
389
449
  * Remove a peer from direct peers.
390
450
  */
391
451
  removeDirectPeer(peerIdStr: string): boolean {
392
- const removed = this.direct.delete(peerIdStr);
452
+ const removed = this.gossipsub.direct.delete(peerIdStr);
393
453
  if (removed) {
394
454
  this.logger.info("Removed direct peer via API", {peerId: peerIdStr});
395
455
  }
@@ -400,7 +460,7 @@ export class Eth2Gossipsub extends GossipSub {
400
460
  * Get list of current direct peer IDs.
401
461
  */
402
462
  getDirectPeers(): string[] {
403
- return Array.from(this.direct);
463
+ return Array.from(this.gossipsub.direct);
404
464
  }
405
465
  }
406
466
 
@@ -498,7 +558,8 @@ export function parseDirectPeers(directPeerStrs: routes.lodestar.DirectPeer[], l
498
558
  try {
499
559
  const ma = multiaddr(peerStr);
500
560
 
501
- const peerIdStr = ma.getPeerId();
561
+ const peerIdComponent = ma.getComponents().findLast((component) => component.name === "p2p");
562
+ const peerIdStr = peerIdComponent?.value;
502
563
  if (!peerIdStr) {
503
564
  logger.warn("Direct peer multiaddr must contain /p2p/ component with peer ID", {multiaddr: peerStr});
504
565
  continue;
@@ -1,6 +1,6 @@
1
- import {Message, TopicValidatorResult} from "@libp2p/interface";
2
- import {Libp2p} from "libp2p";
3
- import {PeerIdStr} from "@chainsafe/libp2p-gossipsub/types";
1
+ import type {Message, TopicValidatorResult} from "@libp2p/gossipsub";
2
+ import type {PeerIdStr} from "@libp2p/gossipsub/types";
3
+ import type {Libp2p} from "libp2p";
4
4
  import {BeaconConfig, ForkBoundary} from "@lodestar/config";
5
5
  import {
6
6
  AttesterSlashing,
@@ -1,9 +1,9 @@
1
1
  import {
2
- PeerScoreParams,
3
- PeerScoreThresholds,
4
- TopicScoreParams,
2
+ type PeerScoreParams,
3
+ type PeerScoreThresholds,
4
+ type TopicScoreParams,
5
5
  defaultTopicScoreParams,
6
- } from "@chainsafe/libp2p-gossipsub/score";
6
+ } from "@libp2p/gossipsub/score";
7
7
  import {BeaconConfig} from "@lodestar/config";
8
8
  import {ATTESTATION_SUBNET_COUNT, PTC_SIZE, SLOTS_PER_EPOCH, TARGET_AGGREGATORS_PER_COMMITTEE} from "@lodestar/params";
9
9
  import {computeCommitteeCount} from "@lodestar/state-transition";
@@ -1,5 +1,5 @@
1
- import {Identify} from "@libp2p/identify";
2
- import {
1
+ import type {Identify} from "@libp2p/identify";
2
+ import type {
3
3
  ComponentLogger,
4
4
  ConnectionGater,
5
5
  ConnectionProtector,
@@ -16,7 +16,7 @@ import {
16
16
  } from "@libp2p/interface";
17
17
  import type {AddressManager, ConnectionManager, Registrar, TransportManager} from "@libp2p/interface-internal";
18
18
  import type {Datastore} from "interface-datastore";
19
- import {Libp2p as ILibp2p} from "libp2p";
19
+ import type {Libp2p as ILibp2p} from "libp2p";
20
20
  import {
21
21
  AttesterSlashing,
22
22
  DataColumnSidecar,
@@ -1,6 +1,6 @@
1
1
  import {bootstrap} from "@libp2p/bootstrap";
2
2
  import {identify} from "@libp2p/identify";
3
- import {PrivateKey} from "@libp2p/interface";
3
+ import type {PrivateKey} from "@libp2p/interface";
4
4
  import {mdns} from "@libp2p/mdns";
5
5
  import {mplex} from "@libp2p/mplex";
6
6
  import {prometheusMetrics} from "@libp2p/prometheus-metrics";
@@ -39,6 +39,7 @@ export async function createNodeJsLibp2p(
39
39
  nodeJsLibp2pOpts: NodeJsLibp2pOpts = {}
40
40
  ): Promise<Libp2p> {
41
41
  const localMultiaddrs = networkOpts.localMultiaddrs || defaultNetworkOptions.localMultiaddrs;
42
+ const disconnectThreshold = networkOpts.disconnectThreshold ?? defaultNetworkOptions.disconnectThreshold;
42
43
  const {peerStoreDir, disablePeerDiscovery} = nodeJsLibp2pOpts;
43
44
 
44
45
  let datastore: undefined | Eth2PeerDataStore = undefined;
@@ -74,6 +75,11 @@ export async function createNodeJsLibp2p(
74
75
 
75
76
  return createLibp2p({
76
77
  privateKey,
78
+ nodeInfo: {
79
+ name: "lodestar",
80
+ version: networkOpts.version ?? "unknown",
81
+ userAgent: networkOpts.private ? "" : networkOpts.version ? `lodestar/${networkOpts.version}` : "lodestar",
82
+ },
77
83
  addresses: {
78
84
  listen: localMultiaddrs,
79
85
  announce: [],
@@ -93,7 +99,7 @@ export async function createNodeJsLibp2p(
93
99
  },
94
100
  }),
95
101
  ],
96
- streamMuxers: [mplex({maxInboundStreams: 256, disconnectThreshold: networkOpts.disconnectThreshold})],
102
+ streamMuxers: [mplex({disconnectThreshold})],
97
103
  peerDiscovery,
98
104
  metrics: nodeJsLibp2pOpts.metrics
99
105
  ? prometheusMetrics({
@@ -124,7 +130,6 @@ export async function createNodeJsLibp2p(
124
130
  datastore,
125
131
  services: {
126
132
  identify: identify({
127
- agentVersion: networkOpts.private ? "" : networkOpts.version ? `lodestar/${networkOpts.version}` : "lodestar",
128
133
  runOnConnectionOpen: false,
129
134
  }),
130
135
  // individual components are specified because the components object is a Proxy
@@ -1,7 +1,7 @@
1
- import {PeerId, PrivateKey} from "@libp2p/interface";
1
+ import type {PeerScoreStatsDump} from "@libp2p/gossipsub/score";
2
+ import type {PublishOpts} from "@libp2p/gossipsub/types";
3
+ import type {PeerId, PrivateKey} from "@libp2p/interface";
2
4
  import {peerIdFromPrivateKey} from "@libp2p/peer-id";
3
- import {PeerScoreStatsDump} from "@chainsafe/libp2p-gossipsub/score";
4
- import {PublishOpts} from "@chainsafe/libp2p-gossipsub/types";
5
5
  import {routes} from "@lodestar/api";
6
6
  import {BeaconConfig} from "@lodestar/config";
7
7
  import {LoggerNode} from "@lodestar/logger/node";
@@ -72,4 +72,7 @@ export const defaultNetworkOptions: NetworkOptions = {
72
72
  // - for fusaka-devnets, we have 25-30 peers per subnet
73
73
  // - for public testnets or mainnet, average number of peers per group is SAMPLES_PER_SLOT * targetPeers / NUMBER_OF_CUSTODY_GROUPS = 6.25 so this should not be an issue
74
74
  targetGroupPeers: 6,
75
+ // Keep this high enough for normal req/resp bursts on stable connections.
76
+ // libp2p-mplex default (5) is too low and can cause frequent connection resets.
77
+ disconnectThreshold: 50,
75
78
  };
@@ -8,6 +8,9 @@ type MemoryItem = {
8
8
  data: Uint8Array;
9
9
  };
10
10
 
11
+ // biome-ignore lint/suspicious/noExplicitAny: used below (copied from upstream)
12
+ type AwaitGenerator<T, TReturn = any, TNext = any> = Generator<T, TReturn, TNext> | AsyncGenerator<T, TReturn, TNext>;
13
+
11
14
  /**
12
15
  * Before libp2p 0.35, peerstore stays in memory and periodically write to db after n dirty items
13
16
  * This has a memory issue because all peer data stays in memory and loaded at startup time
@@ -93,7 +96,7 @@ export class Eth2PeerDataStore extends BaseDatastore {
93
96
  * This throws error if not found
94
97
  * see https://github.com/ipfs/js-datastore-level/blob/38f44058dd6be858e757a1c90b8edb31590ec0bc/src/index.js#L102
95
98
  */
96
- async get(key: Key): Promise<Uint8Array> {
99
+ async get(key: Key, options?: AbortOptions): Promise<Uint8Array> {
97
100
  const keyStr = key.toString();
98
101
  const memoryItem = this._memoryDatastore.get(keyStr);
99
102
  if (memoryItem) {
@@ -102,16 +105,16 @@ export class Eth2PeerDataStore extends BaseDatastore {
102
105
  }
103
106
 
104
107
  // this throws error if not found
105
- const dbValue = await this._dbDatastore.get(key);
108
+ const dbValue = await this._dbDatastore.get(key, options);
106
109
  // don't call this._memoryDatastore.set directly
107
110
  // we want to get through prune() logic with fromDb as true
108
111
  await this._put(key, dbValue, true);
109
112
  return dbValue;
110
113
  }
111
114
 
112
- async has(key: Key): Promise<boolean> {
115
+ async has(key: Key, options?: AbortOptions): Promise<boolean> {
113
116
  try {
114
- await this.get(key);
117
+ await this.get(key, options);
115
118
  } catch (err) {
116
119
  // this is the same to how js-datastore-level handles notFound error
117
120
  // https://github.com/ipfs/js-datastore-level/blob/38f44058dd6be858e757a1c90b8edb31590ec0bc/src/index.js#L121
@@ -121,26 +124,26 @@ export class Eth2PeerDataStore extends BaseDatastore {
121
124
  return true;
122
125
  }
123
126
 
124
- async delete(key: Key): Promise<void> {
127
+ async delete(key: Key, options?: AbortOptions): Promise<void> {
125
128
  this._memoryDatastore.delete(key.toString());
126
- await this._dbDatastore.delete(key);
129
+ await this._dbDatastore.delete(key, options);
127
130
  }
128
131
 
129
- async *_all(q: Query): AsyncIterable<Pair> {
132
+ async *_all(q: Query, options?: AbortOptions): AwaitGenerator<Pair> {
130
133
  for (const [key, value] of this._memoryDatastore.entries()) {
131
134
  yield {
132
135
  key: new Key(key),
133
136
  value: value.data,
134
137
  };
135
138
  }
136
- yield* this._dbDatastore.query(q);
139
+ yield* this._dbDatastore.query(q, options);
137
140
  }
138
141
 
139
- async *_allKeys(q: KeyQuery): AsyncIterable<Key> {
142
+ async *_allKeys(q: KeyQuery, options?: AbortOptions): AwaitGenerator<Key> {
140
143
  for (const key of this._memoryDatastore.keys()) {
141
144
  yield new Key(key);
142
145
  }
143
- yield* this._dbDatastore.queryKeys(q);
146
+ yield* this._dbDatastore.queryKeys(q, options);
144
147
  }
145
148
 
146
149
  private async _addDirtyItem(keyStr: string): Promise<void> {