@lodestar/builder 1.50.0-dev.4534e28b19 → 1.50.0-dev.45e4260336
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.
- package/README.md +1 -1
- package/lib/builder.d.ts +2 -0
- package/lib/builder.d.ts.map +1 -1
- package/lib/builder.js +56 -4
- package/lib/builder.js.map +1 -1
- package/lib/services/bidLedger.d.ts +8 -0
- package/lib/services/bidLedger.d.ts.map +1 -1
- package/lib/services/bidLedger.js +19 -10
- package/lib/services/bidLedger.js.map +1 -1
- package/lib/services/bidPublisher.d.ts +43 -0
- package/lib/services/bidPublisher.d.ts.map +1 -0
- package/lib/services/bidPublisher.js +50 -0
- package/lib/services/bidPublisher.js.map +1 -0
- package/lib/services/bidSelector.d.ts +67 -0
- package/lib/services/bidSelector.d.ts.map +1 -0
- package/lib/services/bidSelector.js +59 -0
- package/lib/services/bidSelector.js.map +1 -0
- package/lib/services/blockObserver.d.ts +1 -2
- package/lib/services/blockObserver.d.ts.map +1 -1
- package/lib/services/blockObserver.js +3 -35
- package/lib/services/blockObserver.js.map +1 -1
- package/lib/services/builderSigner.d.ts +2 -1
- package/lib/services/builderSigner.d.ts.map +1 -1
- package/lib/services/builderSigner.js.map +1 -1
- package/lib/services/envelopePublisher.d.ts +44 -0
- package/lib/services/envelopePublisher.d.ts.map +1 -0
- package/lib/services/envelopePublisher.js +96 -0
- package/lib/services/envelopePublisher.js.map +1 -0
- package/lib/services/executionPayloadEnvelope.d.ts +55 -0
- package/lib/services/executionPayloadEnvelope.d.ts.map +1 -0
- package/lib/services/executionPayloadEnvelope.js +79 -0
- package/lib/services/executionPayloadEnvelope.js.map +1 -0
- package/lib/services/payloadOrchestrator.d.ts +42 -0
- package/lib/services/payloadOrchestrator.d.ts.map +1 -0
- package/lib/services/payloadOrchestrator.js +60 -0
- package/lib/services/payloadOrchestrator.js.map +1 -0
- package/lib/services/proposerPreferencesTracker.d.ts +0 -6
- package/lib/services/proposerPreferencesTracker.d.ts.map +1 -1
- package/lib/services/proposerPreferencesTracker.js +0 -38
- package/lib/services/proposerPreferencesTracker.js.map +1 -1
- package/package.json +10 -10
- package/src/builder.ts +63 -5
- package/src/services/bidLedger.ts +33 -14
- package/src/services/bidPublisher.ts +95 -0
- package/src/services/bidSelector.ts +138 -0
- package/src/services/blockObserver.ts +3 -41
- package/src/services/builderSigner.ts +3 -1
- package/src/services/envelopePublisher.ts +154 -0
- package/src/services/executionPayloadEnvelope.ts +156 -0
- package/src/services/payloadOrchestrator.ts +107 -0
- package/src/services/proposerPreferencesTracker.ts +1 -36
|
@@ -25,47 +25,15 @@ export class BlockObserver {
|
|
|
25
25
|
this.retries = retries;
|
|
26
26
|
this.retryDelay = retryDelay;
|
|
27
27
|
this.maxSeenBlockRoots = maxSeenBlockRoots;
|
|
28
|
+
this.logger.info("Block observer initialized", { retries, retryDelay, maxSeenBlockRoots });
|
|
28
29
|
}
|
|
29
30
|
/**
|
|
30
|
-
* Register a block consumer. Consumers that require complete observation must register before
|
|
31
|
+
* Register a block consumer. Consumers that require complete observation must register before event delivery, because
|
|
31
32
|
* roots observed before registration remain consumed until normal FIFO eviction.
|
|
32
33
|
*/
|
|
33
34
|
runOnBlock(fn) {
|
|
34
35
|
this.fns.push(fn);
|
|
35
36
|
}
|
|
36
|
-
start(signal) {
|
|
37
|
-
this.logger.info("Subscribing to block events", {
|
|
38
|
-
retries: this.retries,
|
|
39
|
-
retryDelay: this.retryDelay,
|
|
40
|
-
maxSeenBlockRoots: this.maxSeenBlockRoots,
|
|
41
|
-
});
|
|
42
|
-
this.api.events
|
|
43
|
-
.eventstream({
|
|
44
|
-
topics: [EventType.block],
|
|
45
|
-
signal,
|
|
46
|
-
onEvent: (event) => {
|
|
47
|
-
if (event.type !== EventType.block) {
|
|
48
|
-
this.logger.debug("Ignoring unexpected beacon event", { eventType: event.type });
|
|
49
|
-
return;
|
|
50
|
-
}
|
|
51
|
-
void this.processBlockEvent(event.message, signal);
|
|
52
|
-
},
|
|
53
|
-
onError: (error) => {
|
|
54
|
-
this.logger.error("Failed to receive block event", {}, error);
|
|
55
|
-
},
|
|
56
|
-
onClose: () => {
|
|
57
|
-
if (signal.aborted) {
|
|
58
|
-
this.logger.debug("Closed stream for block events");
|
|
59
|
-
}
|
|
60
|
-
else {
|
|
61
|
-
this.logger.error("Block event stream closed unexpectedly", {});
|
|
62
|
-
}
|
|
63
|
-
},
|
|
64
|
-
})
|
|
65
|
-
.catch((error) => {
|
|
66
|
-
this.logger.error("Failed to subscribe to block events", {}, error instanceof Error ? error : Error(String(error)));
|
|
67
|
-
});
|
|
68
|
-
}
|
|
69
37
|
async processBlockEvent(event, signal) {
|
|
70
38
|
try {
|
|
71
39
|
const { slot, block: blockRoot, executionOptimistic } = event;
|
|
@@ -103,7 +71,7 @@ export class BlockObserver {
|
|
|
103
71
|
}
|
|
104
72
|
return null;
|
|
105
73
|
});
|
|
106
|
-
if (response === null) {
|
|
74
|
+
if (response === null || signal.aborted) {
|
|
107
75
|
return;
|
|
108
76
|
}
|
|
109
77
|
const { version } = response.meta();
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"blockObserver.js","sourceRoot":"","sources":["../../src/services/blockObserver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,QAAQ,EAAE,MAAM,EAAC,MAAM,eAAe,CAAC;AAE1D,OAAO,EAAgB,eAAe,EAAC,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAmC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAS,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAEpH,MAAM,EAAC,SAAS,EAAC,GAAG,MAAM,CAAC,MAAM,CAAC;AAqBlC;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAQL,MAAM;IACN,MAAM;IACN,GAAG;IATL,GAAG,GAAmB,EAAE,CAAC;IACzB,cAAc,GAAG,IAAI,GAAG,EAAW,CAAC;IACpC,OAAO,CAAS;IAChB,UAAU,CAAS;IACnB,iBAAiB,CAAS;IAE3C,YACmB,MAAuB,EACvB,MAAc,EACd,GAAc,EAC/B,EAAC,OAAO,GAAG,CAAC,EAAE,UAAU,GAAG,GAAG,EAAE,iBAAiB,GAAG,GAAG,EAAC,GAAyB,EAAE;sBAHlE,MAAM;sBACN,MAAM;mBACN,GAAG;QAGpB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"blockObserver.js","sourceRoot":"","sources":["../../src/services/blockObserver.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { PublicKey, SecretKey } from "@chainsafe/lodestar-z/blst";
|
|
2
2
|
import { BeaconConfig } from "@lodestar/config";
|
|
3
|
-
import { gloas } from "@lodestar/types";
|
|
3
|
+
import { gloas, heze } from "@lodestar/types";
|
|
4
4
|
export type Keypair = {
|
|
5
5
|
publicKey: PublicKey;
|
|
6
6
|
secretKey: SecretKey;
|
|
@@ -10,6 +10,7 @@ export declare class BuilderSigner {
|
|
|
10
10
|
private readonly keypair;
|
|
11
11
|
constructor(config: BeaconConfig, keypair: Keypair);
|
|
12
12
|
signExecutionPayloadEnvelope(envelope: gloas.ExecutionPayloadEnvelope): gloas.SignedExecutionPayloadEnvelope;
|
|
13
|
+
signExecutionPayloadBid(bid: heze.ExecutionPayloadBid): heze.SignedExecutionPayloadBid;
|
|
13
14
|
signExecutionPayloadBid(bid: gloas.ExecutionPayloadBid): gloas.SignedExecutionPayloadBid;
|
|
14
15
|
getPubkeyHex(): string;
|
|
15
16
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"builderSigner.d.ts","sourceRoot":"","sources":["../../src/services/builderSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,SAAS,EAAC,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAC,YAAY,EAAC,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAC,KAAK,EAAC,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"builderSigner.d.ts","sourceRoot":"","sources":["../../src/services/builderSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,SAAS,EAAC,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAC,YAAY,EAAC,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAC,KAAK,EAAE,IAAI,EAAC,MAAM,iBAAiB,CAAC;AAE5C,MAAM,MAAM,OAAO,GAAG;IAAC,SAAS,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAC,CAAC;AAEnE,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAElC,YAAY,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAGjD;IAED,4BAA4B,CAAC,QAAQ,EAAE,KAAK,CAAC,wBAAwB,GAAG,KAAK,CAAC,8BAA8B,CAO3G;IAED,uBAAuB,CAAC,GAAG,EAAE,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,yBAAyB,CAAC;IACvF,uBAAuB,CAAC,GAAG,EAAE,KAAK,CAAC,mBAAmB,GAAG,KAAK,CAAC,yBAAyB,CAAC;IAUzF,YAAY,IAAI,MAAM,CAErB;CACF"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"builderSigner.js","sourceRoot":"","sources":["../../src/services/builderSigner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,iCAAiC,EAAE,sCAAsC,EAAC,MAAM,4BAA4B,CAAC;AAKrH,MAAM,OAAO,aAAa;IACP,MAAM,CAAe;IACrB,OAAO,CAAU;IAElC,YAAY,MAAoB,EAAE,OAAgB;QAChD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,4BAA4B,CAAC,QAAwC;QACnE,MAAM,WAAW,GAAG,sCAAsC,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAElF,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;SAC9D,CAAC;IACJ,CAAC;
|
|
1
|
+
{"version":3,"file":"builderSigner.js","sourceRoot":"","sources":["../../src/services/builderSigner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,iCAAiC,EAAE,sCAAsC,EAAC,MAAM,4BAA4B,CAAC;AAKrH,MAAM,OAAO,aAAa;IACP,MAAM,CAAe;IACrB,OAAO,CAAU;IAElC,YAAY,MAAoB,EAAE,OAAgB;QAChD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,4BAA4B,CAAC,QAAwC;QACnE,MAAM,WAAW,GAAG,sCAAsC,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAElF,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;SAC9D,CAAC;IACJ,CAAC;IAID,uBAAuB,CAAC,GAA8B;QACpD,MAAM,WAAW,GAAG,iCAAiC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAExE,OAAO;YACL,OAAO,EAAE,GAAG;YACZ,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;SAC9D,CAAC;IACJ,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACxC,CAAC;CACF"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { type ApiClient } from "@lodestar/api";
|
|
2
|
+
import { type BuilderIndex, type RootHex, type gloas } from "@lodestar/types";
|
|
3
|
+
import { LodestarError } from "@lodestar/utils";
|
|
4
|
+
import type { BidIdentity, BidLedger } from "./bidLedger.js";
|
|
5
|
+
import type { BuilderSigner } from "./builderSigner.js";
|
|
6
|
+
import type { ExecutionPayloadEnvelopeContents } from "./executionPayloadEnvelope.js";
|
|
7
|
+
export type EnvelopeSelectionIdentity = BidIdentity & {
|
|
8
|
+
blockRoot: RootHex;
|
|
9
|
+
};
|
|
10
|
+
export type EnvelopePublisherModules = {
|
|
11
|
+
api: ApiClient;
|
|
12
|
+
signer: BuilderSigner;
|
|
13
|
+
ledger: BidLedger;
|
|
14
|
+
builderIndex: BuilderIndex;
|
|
15
|
+
};
|
|
16
|
+
export declare enum EnvelopePublisherErrorCode {
|
|
17
|
+
BUILDER_INDEX_MISMATCH = "ENVELOPE_PUBLISHER_ERROR_BUILDER_INDEX_MISMATCH",
|
|
18
|
+
SELECTION_NOT_RECORDED = "ENVELOPE_PUBLISHER_ERROR_SELECTION_NOT_RECORDED"
|
|
19
|
+
}
|
|
20
|
+
export type EnvelopePublisherErrorType = {
|
|
21
|
+
code: EnvelopePublisherErrorCode.BUILDER_INDEX_MISMATCH;
|
|
22
|
+
builderIndex: BuilderIndex;
|
|
23
|
+
envelopeBuilderIndex: BuilderIndex;
|
|
24
|
+
} | ({
|
|
25
|
+
code: EnvelopePublisherErrorCode.SELECTION_NOT_RECORDED;
|
|
26
|
+
} & EnvelopeSelectionIdentity);
|
|
27
|
+
export declare class EnvelopePublisherError extends LodestarError<EnvelopePublisherErrorType> {
|
|
28
|
+
}
|
|
29
|
+
export type EnvelopePublicationResult = {
|
|
30
|
+
status: "published";
|
|
31
|
+
signedEnvelope: gloas.SignedExecutionPayloadEnvelope;
|
|
32
|
+
} | {
|
|
33
|
+
status: "duplicate";
|
|
34
|
+
};
|
|
35
|
+
/** Signs and submits an envelope for a recorded local selection. */
|
|
36
|
+
export declare class EnvelopePublisher {
|
|
37
|
+
private readonly modules;
|
|
38
|
+
private readonly activePublications;
|
|
39
|
+
constructor(modules: EnvelopePublisherModules);
|
|
40
|
+
publish(contents: ExecutionPayloadEnvelopeContents, signal: AbortSignal): Promise<EnvelopePublicationResult>;
|
|
41
|
+
private waitForPublication;
|
|
42
|
+
private publishEnvelope;
|
|
43
|
+
}
|
|
44
|
+
//# sourceMappingURL=envelopePublisher.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"envelopePublisher.d.ts","sourceRoot":"","sources":["../../src/services/envelopePublisher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,SAAS,EAAS,MAAM,eAAe,CAAC;AACrD,OAAO,EAAC,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,KAAK,KAAK,EAAM,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAC,aAAa,EAAmB,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAC,WAAW,EAAE,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAC,gCAAgC,EAAC,MAAM,+BAA+B,CAAC;AAEpF,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG;IAAC,SAAS,EAAE,OAAO,CAAA;CAAC,CAAC;AAE3E,MAAM,MAAM,wBAAwB,GAAG;IACrC,GAAG,EAAE,SAAS,CAAC;IACf,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF,oBAAY,0BAA0B;IACpC,sBAAsB,oDAAoD;IAC1E,sBAAsB,oDAAoD;CAC3E;AAED,MAAM,MAAM,0BAA0B,GAClC;IACE,IAAI,EAAE,0BAA0B,CAAC,sBAAsB,CAAC;IACxD,YAAY,EAAE,YAAY,CAAC;IAC3B,oBAAoB,EAAE,YAAY,CAAC;CACpC,GACD,CAAC;IAAC,IAAI,EAAE,0BAA0B,CAAC,sBAAsB,CAAA;CAAC,GAAG,yBAAyB,CAAC,CAAC;AAE5F,qBAAa,sBAAuB,SAAQ,aAAa,CAAC,0BAA0B,CAAC;CAAG;AAExF,MAAM,MAAM,yBAAyB,GACjC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,cAAc,EAAE,KAAK,CAAC,8BAA8B,CAAA;CAAC,GAC3E;IAAC,MAAM,EAAE,WAAW,CAAA;CAAC,CAAC;AAQ1B,oEAAoE;AACpE,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAyC;IAE5E,YAA6B,OAAO,EAAE,wBAAwB,EAAI;IAE5D,OAAO,CAAC,QAAQ,EAAE,gCAAgC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAqDjH;YAEa,kBAAkB;YAyBlB,eAAe;CA0B9B"}
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
import { routes } from "@lodestar/api";
|
|
2
|
+
import { ssz } from "@lodestar/types";
|
|
3
|
+
import { LodestarError, defer, toRootHex } from "@lodestar/utils";
|
|
4
|
+
export var EnvelopePublisherErrorCode;
|
|
5
|
+
(function (EnvelopePublisherErrorCode) {
|
|
6
|
+
EnvelopePublisherErrorCode["BUILDER_INDEX_MISMATCH"] = "ENVELOPE_PUBLISHER_ERROR_BUILDER_INDEX_MISMATCH";
|
|
7
|
+
EnvelopePublisherErrorCode["SELECTION_NOT_RECORDED"] = "ENVELOPE_PUBLISHER_ERROR_SELECTION_NOT_RECORDED";
|
|
8
|
+
})(EnvelopePublisherErrorCode || (EnvelopePublisherErrorCode = {}));
|
|
9
|
+
export class EnvelopePublisherError extends LodestarError {
|
|
10
|
+
}
|
|
11
|
+
/** Signs and submits an envelope for a recorded local selection. */
|
|
12
|
+
export class EnvelopePublisher {
|
|
13
|
+
modules;
|
|
14
|
+
activePublications = new Map();
|
|
15
|
+
constructor(modules) {
|
|
16
|
+
this.modules = modules;
|
|
17
|
+
}
|
|
18
|
+
async publish(contents, signal) {
|
|
19
|
+
signal.throwIfAborted();
|
|
20
|
+
const { api, builderIndex, ledger, signer } = this.modules;
|
|
21
|
+
const { envelope } = contents;
|
|
22
|
+
if (envelope.builderIndex !== builderIndex) {
|
|
23
|
+
throw new EnvelopePublisherError({
|
|
24
|
+
code: EnvelopePublisherErrorCode.BUILDER_INDEX_MISMATCH,
|
|
25
|
+
builderIndex,
|
|
26
|
+
envelopeBuilderIndex: envelope.builderIndex,
|
|
27
|
+
}, `Envelope builder index does not match local builder index builderIndex=${builderIndex} envelopeBuilderIndex=${envelope.builderIndex}`);
|
|
28
|
+
}
|
|
29
|
+
const identity = {
|
|
30
|
+
slot: envelope.payload.slotNumber,
|
|
31
|
+
parentBlockHash: toRootHex(envelope.payload.parentHash),
|
|
32
|
+
parentBlockRoot: toRootHex(envelope.parentBeaconBlockRoot),
|
|
33
|
+
blockHash: toRootHex(envelope.payload.blockHash),
|
|
34
|
+
blockRoot: toRootHex(envelope.beaconBlockRoot),
|
|
35
|
+
};
|
|
36
|
+
if (!ledger.hasWon(identity, identity.blockRoot)) {
|
|
37
|
+
throw new EnvelopePublisherError({ code: EnvelopePublisherErrorCode.SELECTION_NOT_RECORDED, ...identity }, `Envelope selection is not recorded slot=${identity.slot} blockRoot=${identity.blockRoot} blockHash=${identity.blockHash}`);
|
|
38
|
+
}
|
|
39
|
+
const envelopeRoot = toRootHex(ssz.gloas.ExecutionPayloadEnvelope.hashTreeRoot(envelope));
|
|
40
|
+
ledger.recordReveal(identity.slot, identity.blockRoot, identity.blockHash, envelopeRoot);
|
|
41
|
+
if (ledger.hasPublishedReveal(identity.blockRoot)) {
|
|
42
|
+
return { status: "duplicate" };
|
|
43
|
+
}
|
|
44
|
+
let publication = this.activePublications.get(identity.blockRoot);
|
|
45
|
+
if (publication === undefined) {
|
|
46
|
+
const controller = new AbortController();
|
|
47
|
+
publication = {
|
|
48
|
+
controller,
|
|
49
|
+
waiters: 0,
|
|
50
|
+
promise: this.publishEnvelope(contents, identity, envelopeRoot, api, ledger, signer, controller.signal).finally(() => {
|
|
51
|
+
if (this.activePublications.get(identity.blockRoot)?.controller === controller) {
|
|
52
|
+
this.activePublications.delete(identity.blockRoot);
|
|
53
|
+
}
|
|
54
|
+
}),
|
|
55
|
+
};
|
|
56
|
+
this.activePublications.set(identity.blockRoot, publication);
|
|
57
|
+
}
|
|
58
|
+
return this.waitForPublication(identity.blockRoot, publication, signal);
|
|
59
|
+
}
|
|
60
|
+
async waitForPublication(blockRoot, publication, signal) {
|
|
61
|
+
const aborted = defer();
|
|
62
|
+
const onAbort = () => aborted.reject(signal.reason);
|
|
63
|
+
publication.waiters++;
|
|
64
|
+
signal.addEventListener("abort", onAbort, { once: true });
|
|
65
|
+
if (signal.aborted)
|
|
66
|
+
onAbort();
|
|
67
|
+
try {
|
|
68
|
+
return await Promise.race([publication.promise, aborted.promise]);
|
|
69
|
+
}
|
|
70
|
+
finally {
|
|
71
|
+
signal.removeEventListener("abort", onAbort);
|
|
72
|
+
publication.waiters--;
|
|
73
|
+
if (publication.waiters === 0 && signal.aborted) {
|
|
74
|
+
if (this.activePublications.get(blockRoot) === publication) {
|
|
75
|
+
this.activePublications.delete(blockRoot);
|
|
76
|
+
}
|
|
77
|
+
publication.controller.abort(signal.reason);
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
async publishEnvelope(contents, identity, envelopeRoot, api, ledger, signer, signal) {
|
|
82
|
+
const signedEnvelope = signer.signExecutionPayloadEnvelope(contents.envelope);
|
|
83
|
+
const response = await api.beacon.publishExecutionPayloadEnvelope({
|
|
84
|
+
signedEnvelopeOrContents: {
|
|
85
|
+
signedExecutionPayloadEnvelope: signedEnvelope,
|
|
86
|
+
kzgProofs: contents.kzgProofs,
|
|
87
|
+
blobs: contents.blobs,
|
|
88
|
+
},
|
|
89
|
+
broadcastValidation: routes.beacon.BroadcastValidation.gossip,
|
|
90
|
+
}, { signal });
|
|
91
|
+
response.assertOk();
|
|
92
|
+
ledger.recordRevealPublished(identity.slot, identity.blockRoot, identity.blockHash, envelopeRoot);
|
|
93
|
+
return { status: "published", signedEnvelope };
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
//# sourceMappingURL=envelopePublisher.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"envelopePublisher.js","sourceRoot":"","sources":["../../src/services/envelopePublisher.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import type { BuilderIndex, RootHex, Slot, deneb, gloas } from "@lodestar/types";
|
|
2
|
+
import { LodestarError } from "@lodestar/utils";
|
|
3
|
+
import type { StoredPayload } from "./payloadStore.js";
|
|
4
|
+
export type ExecutionPayloadEnvelopeInput = {
|
|
5
|
+
blockRoot: RootHex;
|
|
6
|
+
builderIndex: BuilderIndex;
|
|
7
|
+
selectedBid: gloas.ExecutionPayloadBid;
|
|
8
|
+
storedPayload: StoredPayload;
|
|
9
|
+
};
|
|
10
|
+
export type ExecutionPayloadEnvelopeContents = {
|
|
11
|
+
envelope: gloas.ExecutionPayloadEnvelope;
|
|
12
|
+
kzgProofs: deneb.KZGProofs;
|
|
13
|
+
blobs: deneb.Blobs;
|
|
14
|
+
};
|
|
15
|
+
export declare enum ExecutionPayloadEnvelopeErrorCode {
|
|
16
|
+
SLOT_MISMATCH = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_SLOT_MISMATCH",
|
|
17
|
+
PARENT_BLOCK_ROOT_MISMATCH = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_PARENT_BLOCK_ROOT_MISMATCH",
|
|
18
|
+
PARENT_BLOCK_HASH_MISMATCH = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_PARENT_BLOCK_HASH_MISMATCH",
|
|
19
|
+
BLOCK_HASH_MISMATCH = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_BLOCK_HASH_MISMATCH",
|
|
20
|
+
BUILDER_INDEX_MISMATCH = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_BUILDER_INDEX_MISMATCH",
|
|
21
|
+
BLOB_KZG_COMMITMENTS_MISMATCH = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_BLOB_KZG_COMMITMENTS_MISMATCH",
|
|
22
|
+
EXECUTION_REQUESTS_ROOT_MISMATCH = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_EXECUTION_REQUESTS_ROOT_MISMATCH"
|
|
23
|
+
}
|
|
24
|
+
export type ExecutionPayloadEnvelopeErrorType = {
|
|
25
|
+
code: ExecutionPayloadEnvelopeErrorCode.BUILDER_INDEX_MISMATCH;
|
|
26
|
+
builderIndex: BuilderIndex;
|
|
27
|
+
bidBuilderIndex: BuilderIndex;
|
|
28
|
+
} | {
|
|
29
|
+
code: ExecutionPayloadEnvelopeErrorCode.BLOB_KZG_COMMITMENTS_MISMATCH;
|
|
30
|
+
} | {
|
|
31
|
+
code: ExecutionPayloadEnvelopeErrorCode.EXECUTION_REQUESTS_ROOT_MISMATCH;
|
|
32
|
+
bidExecutionRequestsRoot: RootHex;
|
|
33
|
+
payloadExecutionRequestsRoot: RootHex;
|
|
34
|
+
} | {
|
|
35
|
+
code: ExecutionPayloadEnvelopeErrorCode.PARENT_BLOCK_ROOT_MISMATCH;
|
|
36
|
+
bidParentBlockRoot: RootHex;
|
|
37
|
+
storedParentBlockRoot: RootHex;
|
|
38
|
+
} | {
|
|
39
|
+
code: ExecutionPayloadEnvelopeErrorCode.SLOT_MISMATCH;
|
|
40
|
+
bidSlot: Slot;
|
|
41
|
+
payloadSlot: Slot;
|
|
42
|
+
} | {
|
|
43
|
+
code: ExecutionPayloadEnvelopeErrorCode.PARENT_BLOCK_HASH_MISMATCH;
|
|
44
|
+
bidParentBlockHash: RootHex;
|
|
45
|
+
payloadParentBlockHash: RootHex;
|
|
46
|
+
} | {
|
|
47
|
+
code: ExecutionPayloadEnvelopeErrorCode.BLOCK_HASH_MISMATCH;
|
|
48
|
+
bidBlockHash: RootHex;
|
|
49
|
+
payloadBlockHash: RootHex;
|
|
50
|
+
};
|
|
51
|
+
export declare class ExecutionPayloadEnvelopeError extends LodestarError<ExecutionPayloadEnvelopeErrorType> {
|
|
52
|
+
}
|
|
53
|
+
/** The caller must have matched the selected bid to its local ledger record. */
|
|
54
|
+
export declare function createExecutionPayloadEnvelopeContents({ blockRoot, builderIndex, selectedBid, storedPayload, }: ExecutionPayloadEnvelopeInput): ExecutionPayloadEnvelopeContents;
|
|
55
|
+
//# sourceMappingURL=executionPayloadEnvelope.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"executionPayloadEnvelope.d.ts","sourceRoot":"","sources":["../../src/services/executionPayloadEnvelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAC,MAAM,iBAAiB,CAAC;AAE/E,OAAO,EAAC,aAAa,EAAsC,MAAM,iBAAiB,CAAC;AACnF,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,6BAA6B,GAAG;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,KAAK,CAAC,mBAAmB,CAAC;IACvC,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,QAAQ,EAAE,KAAK,CAAC,wBAAwB,CAAC;IACzC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;CACpB,CAAC;AAEF,oBAAY,iCAAiC;IAC3C,aAAa,mDAAmD;IAChE,0BAA0B,gEAAgE;IAC1F,0BAA0B,gEAAgE;IAC1F,mBAAmB,yDAAyD;IAC5E,sBAAsB,4DAA4D;IAClF,6BAA6B,mEAAmE;IAChG,gCAAgC,sEAAsE;CACvG;AAED,MAAM,MAAM,iCAAiC,GACzC;IACE,IAAI,EAAE,iCAAiC,CAAC,sBAAsB,CAAC;IAC/D,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe,EAAE,YAAY,CAAC;CAC/B,GACD;IAAC,IAAI,EAAE,iCAAiC,CAAC,6BAA6B,CAAA;CAAC,GACvE;IACE,IAAI,EAAE,iCAAiC,CAAC,gCAAgC,CAAC;IACzE,wBAAwB,EAAE,OAAO,CAAC;IAClC,4BAA4B,EAAE,OAAO,CAAC;CACvC,GACD;IACE,IAAI,EAAE,iCAAiC,CAAC,0BAA0B,CAAC;IACnE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;CAChC,GACD;IACE,IAAI,EAAE,iCAAiC,CAAC,aAAa,CAAC;IACtD,OAAO,EAAE,IAAI,CAAC;IACd,WAAW,EAAE,IAAI,CAAC;CACnB,GACD;IACE,IAAI,EAAE,iCAAiC,CAAC,0BAA0B,CAAC;IACnE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,sBAAsB,EAAE,OAAO,CAAC;CACjC,GACD;IACE,IAAI,EAAE,iCAAiC,CAAC,mBAAmB,CAAC;IAC5D,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEN,qBAAa,6BAA8B,SAAQ,aAAa,CAAC,iCAAiC,CAAC;CAAG;AAEtG,gFAAgF;AAChF,wBAAgB,sCAAsC,CAAC,EACrD,SAAS,EACT,YAAY,EACZ,WAAW,EACX,aAAa,GACd,EAAE,6BAA6B,GAAG,gCAAgC,CAsFlE"}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
import { ssz } from "@lodestar/types";
|
|
2
|
+
import { LodestarError, byteArrayEquals, fromHex, toRootHex } from "@lodestar/utils";
|
|
3
|
+
export var ExecutionPayloadEnvelopeErrorCode;
|
|
4
|
+
(function (ExecutionPayloadEnvelopeErrorCode) {
|
|
5
|
+
ExecutionPayloadEnvelopeErrorCode["SLOT_MISMATCH"] = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_SLOT_MISMATCH";
|
|
6
|
+
ExecutionPayloadEnvelopeErrorCode["PARENT_BLOCK_ROOT_MISMATCH"] = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_PARENT_BLOCK_ROOT_MISMATCH";
|
|
7
|
+
ExecutionPayloadEnvelopeErrorCode["PARENT_BLOCK_HASH_MISMATCH"] = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_PARENT_BLOCK_HASH_MISMATCH";
|
|
8
|
+
ExecutionPayloadEnvelopeErrorCode["BLOCK_HASH_MISMATCH"] = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_BLOCK_HASH_MISMATCH";
|
|
9
|
+
ExecutionPayloadEnvelopeErrorCode["BUILDER_INDEX_MISMATCH"] = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_BUILDER_INDEX_MISMATCH";
|
|
10
|
+
ExecutionPayloadEnvelopeErrorCode["BLOB_KZG_COMMITMENTS_MISMATCH"] = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_BLOB_KZG_COMMITMENTS_MISMATCH";
|
|
11
|
+
ExecutionPayloadEnvelopeErrorCode["EXECUTION_REQUESTS_ROOT_MISMATCH"] = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_EXECUTION_REQUESTS_ROOT_MISMATCH";
|
|
12
|
+
})(ExecutionPayloadEnvelopeErrorCode || (ExecutionPayloadEnvelopeErrorCode = {}));
|
|
13
|
+
export class ExecutionPayloadEnvelopeError extends LodestarError {
|
|
14
|
+
}
|
|
15
|
+
/** The caller must have matched the selected bid to its local ledger record. */
|
|
16
|
+
export function createExecutionPayloadEnvelopeContents({ blockRoot, builderIndex, selectedBid, storedPayload, }) {
|
|
17
|
+
if (builderIndex !== selectedBid.builderIndex) {
|
|
18
|
+
throw new ExecutionPayloadEnvelopeError({
|
|
19
|
+
code: ExecutionPayloadEnvelopeErrorCode.BUILDER_INDEX_MISMATCH,
|
|
20
|
+
builderIndex,
|
|
21
|
+
bidBuilderIndex: selectedBid.builderIndex,
|
|
22
|
+
});
|
|
23
|
+
}
|
|
24
|
+
const bidParentBlockRoot = toRootHex(selectedBid.parentBlockRoot);
|
|
25
|
+
const storedParentBlockRoot = toRootHex(storedPayload.parentBlockRoot);
|
|
26
|
+
if (storedParentBlockRoot !== bidParentBlockRoot) {
|
|
27
|
+
throw new ExecutionPayloadEnvelopeError({
|
|
28
|
+
code: ExecutionPayloadEnvelopeErrorCode.PARENT_BLOCK_ROOT_MISMATCH,
|
|
29
|
+
bidParentBlockRoot,
|
|
30
|
+
storedParentBlockRoot,
|
|
31
|
+
}, `Selected bid beacon parent does not match retained payload bidParentBlockRoot=${bidParentBlockRoot} storedParentBlockRoot=${storedParentBlockRoot}`);
|
|
32
|
+
}
|
|
33
|
+
const { payload } = storedPayload;
|
|
34
|
+
const payloadSlot = payload.executionPayload.slotNumber;
|
|
35
|
+
if (payloadSlot !== selectedBid.slot) {
|
|
36
|
+
throw new ExecutionPayloadEnvelopeError({ code: ExecutionPayloadEnvelopeErrorCode.SLOT_MISMATCH, bidSlot: selectedBid.slot, payloadSlot }, `Selected bid slot does not match payload slot bidSlot=${selectedBid.slot} payloadSlot=${payloadSlot}`);
|
|
37
|
+
}
|
|
38
|
+
const payloadParentBlockHash = toRootHex(payload.executionPayload.parentHash);
|
|
39
|
+
const bidParentBlockHash = toRootHex(selectedBid.parentBlockHash);
|
|
40
|
+
if (payloadParentBlockHash !== bidParentBlockHash) {
|
|
41
|
+
throw new ExecutionPayloadEnvelopeError({
|
|
42
|
+
code: ExecutionPayloadEnvelopeErrorCode.PARENT_BLOCK_HASH_MISMATCH,
|
|
43
|
+
bidParentBlockHash,
|
|
44
|
+
payloadParentBlockHash,
|
|
45
|
+
}, `Selected bid parent does not match payload parent bidParentBlockHash=${bidParentBlockHash} payloadParentBlockHash=${payloadParentBlockHash}`);
|
|
46
|
+
}
|
|
47
|
+
const payloadBlockHash = toRootHex(payload.executionPayload.blockHash);
|
|
48
|
+
const bidBlockHash = toRootHex(selectedBid.blockHash);
|
|
49
|
+
if (payloadBlockHash !== bidBlockHash) {
|
|
50
|
+
throw new ExecutionPayloadEnvelopeError({
|
|
51
|
+
code: ExecutionPayloadEnvelopeErrorCode.BLOCK_HASH_MISMATCH,
|
|
52
|
+
bidBlockHash,
|
|
53
|
+
payloadBlockHash,
|
|
54
|
+
}, `Selected bid block hash does not match payload bidBlockHash=${bidBlockHash} payloadBlockHash=${payloadBlockHash}`);
|
|
55
|
+
}
|
|
56
|
+
if (!ssz.gloas.ExecutionPayloadBid.fields.blobKzgCommitments.equals(selectedBid.blobKzgCommitments, payload.blobsBundle.commitments)) {
|
|
57
|
+
throw new ExecutionPayloadEnvelopeError({ code: ExecutionPayloadEnvelopeErrorCode.BLOB_KZG_COMMITMENTS_MISMATCH });
|
|
58
|
+
}
|
|
59
|
+
const executionRequestsRoot = ssz.gloas.ExecutionRequests.hashTreeRoot(payload.executionRequests);
|
|
60
|
+
if (!byteArrayEquals(executionRequestsRoot, selectedBid.executionRequestsRoot)) {
|
|
61
|
+
throw new ExecutionPayloadEnvelopeError({
|
|
62
|
+
code: ExecutionPayloadEnvelopeErrorCode.EXECUTION_REQUESTS_ROOT_MISMATCH,
|
|
63
|
+
bidExecutionRequestsRoot: toRootHex(selectedBid.executionRequestsRoot),
|
|
64
|
+
payloadExecutionRequestsRoot: toRootHex(executionRequestsRoot),
|
|
65
|
+
});
|
|
66
|
+
}
|
|
67
|
+
return {
|
|
68
|
+
envelope: {
|
|
69
|
+
payload: payload.executionPayload,
|
|
70
|
+
executionRequests: payload.executionRequests,
|
|
71
|
+
builderIndex,
|
|
72
|
+
beaconBlockRoot: fromHex(blockRoot),
|
|
73
|
+
parentBeaconBlockRoot: selectedBid.parentBlockRoot,
|
|
74
|
+
},
|
|
75
|
+
kzgProofs: payload.blobsBundle.proofs,
|
|
76
|
+
blobs: payload.blobsBundle.blobs,
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
//# sourceMappingURL=executionPayloadEnvelope.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"executionPayloadEnvelope.js","sourceRoot":"","sources":["../../src/services/executionPayloadEnvelope.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import { LodestarError } from "@lodestar/utils";
|
|
2
|
+
import { type BuildRequest, type BuiltPayload, type PayloadSource } from "./payloadSource.js";
|
|
3
|
+
export type PayloadBuildJob = {
|
|
4
|
+
/** Jobs with the same ID share one build and its result. */
|
|
5
|
+
id: string;
|
|
6
|
+
request: BuildRequest;
|
|
7
|
+
/** Unix timestamp in milliseconds at which the prepared payload should be retrieved. */
|
|
8
|
+
getPayloadAt: number;
|
|
9
|
+
};
|
|
10
|
+
export type PayloadOrchestratorOptions = {
|
|
11
|
+
/** Maximum time in milliseconds to wait for payload retrieval. */
|
|
12
|
+
getPayloadTimeout: number;
|
|
13
|
+
};
|
|
14
|
+
export declare enum PayloadOrchestratorErrorCode {
|
|
15
|
+
PREPARE_DEADLINE_REACHED = "PAYLOAD_ORCHESTRATOR_ERROR_PREPARE_DEADLINE_REACHED",
|
|
16
|
+
PREPARE_TIMEOUT = "PAYLOAD_ORCHESTRATOR_ERROR_PREPARE_TIMEOUT",
|
|
17
|
+
GET_PAYLOAD_TIMEOUT = "PAYLOAD_ORCHESTRATOR_ERROR_GET_PAYLOAD_TIMEOUT"
|
|
18
|
+
}
|
|
19
|
+
export type PayloadOrchestratorErrorType = {
|
|
20
|
+
code: PayloadOrchestratorErrorCode.PREPARE_DEADLINE_REACHED;
|
|
21
|
+
jobId: string;
|
|
22
|
+
getPayloadAt: number;
|
|
23
|
+
} | {
|
|
24
|
+
code: PayloadOrchestratorErrorCode.PREPARE_TIMEOUT | PayloadOrchestratorErrorCode.GET_PAYLOAD_TIMEOUT;
|
|
25
|
+
jobId: string;
|
|
26
|
+
};
|
|
27
|
+
export declare class PayloadOrchestratorError extends LodestarError<PayloadOrchestratorErrorType> {
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Prepares a payload and retrieves it at the requested time. Preparation retries missing payload IDs until the
|
|
31
|
+
* retrieval time. Transport-level retries remain owned by the source.
|
|
32
|
+
*/
|
|
33
|
+
export declare class PayloadOrchestrator {
|
|
34
|
+
private readonly source;
|
|
35
|
+
private readonly options;
|
|
36
|
+
private readonly signal;
|
|
37
|
+
private readonly jobs;
|
|
38
|
+
constructor(source: PayloadSource, options: PayloadOrchestratorOptions, signal: AbortSignal);
|
|
39
|
+
run(job: PayloadBuildJob): Promise<BuiltPayload>;
|
|
40
|
+
private runJob;
|
|
41
|
+
}
|
|
42
|
+
//# sourceMappingURL=payloadOrchestrator.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"payloadOrchestrator.d.ts","sourceRoot":"","sources":["../../src/services/payloadOrchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAA0C,MAAM,iBAAiB,CAAC;AACvF,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAGnB,MAAM,oBAAoB,CAAC;AAI5B,MAAM,MAAM,eAAe,GAAG;IAC5B,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,wFAAwF;IACxF,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,kEAAkE;IAClE,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,oBAAY,4BAA4B;IACtC,wBAAwB,wDAAwD;IAChF,eAAe,+CAA+C;IAC9D,mBAAmB,mDAAmD;CACvE;AAED,MAAM,MAAM,4BAA4B,GACpC;IACE,IAAI,EAAE,4BAA4B,CAAC,wBAAwB,CAAC;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB,GACD;IACE,IAAI,EAAE,4BAA4B,CAAC,eAAe,GAAG,4BAA4B,CAAC,mBAAmB,CAAC;IACtG,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,qBAAa,wBAAyB,SAAQ,aAAa,CAAC,4BAA4B,CAAC;CAAG;AAE5F;;;GAGG;AACH,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4C;IAEjE,YACmB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,0BAA0B,EACnC,MAAM,EAAE,WAAW,EAClC;IAEJ,GAAG,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAQ/C;YAEa,MAAM;CAwCrB"}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import { LodestarError, TimeoutError, retry, sleep, withTimeout } from "@lodestar/utils";
|
|
2
|
+
import { PayloadSourceError, PayloadSourceErrorCode, } from "./payloadSource.js";
|
|
3
|
+
const PREPARE_RETRY_DELAY = 100;
|
|
4
|
+
export var PayloadOrchestratorErrorCode;
|
|
5
|
+
(function (PayloadOrchestratorErrorCode) {
|
|
6
|
+
PayloadOrchestratorErrorCode["PREPARE_DEADLINE_REACHED"] = "PAYLOAD_ORCHESTRATOR_ERROR_PREPARE_DEADLINE_REACHED";
|
|
7
|
+
PayloadOrchestratorErrorCode["PREPARE_TIMEOUT"] = "PAYLOAD_ORCHESTRATOR_ERROR_PREPARE_TIMEOUT";
|
|
8
|
+
PayloadOrchestratorErrorCode["GET_PAYLOAD_TIMEOUT"] = "PAYLOAD_ORCHESTRATOR_ERROR_GET_PAYLOAD_TIMEOUT";
|
|
9
|
+
})(PayloadOrchestratorErrorCode || (PayloadOrchestratorErrorCode = {}));
|
|
10
|
+
export class PayloadOrchestratorError extends LodestarError {
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Prepares a payload and retrieves it at the requested time. Preparation retries missing payload IDs until the
|
|
14
|
+
* retrieval time. Transport-level retries remain owned by the source.
|
|
15
|
+
*/
|
|
16
|
+
export class PayloadOrchestrator {
|
|
17
|
+
source;
|
|
18
|
+
options;
|
|
19
|
+
signal;
|
|
20
|
+
jobs = new Map();
|
|
21
|
+
constructor(source, options, signal) {
|
|
22
|
+
this.source = source;
|
|
23
|
+
this.options = options;
|
|
24
|
+
this.signal = signal;
|
|
25
|
+
}
|
|
26
|
+
run(job) {
|
|
27
|
+
const { id } = job;
|
|
28
|
+
let promise = this.jobs.get(id);
|
|
29
|
+
if (promise === undefined) {
|
|
30
|
+
promise = this.runJob(job).finally(() => this.jobs.delete(id));
|
|
31
|
+
this.jobs.set(id, promise);
|
|
32
|
+
}
|
|
33
|
+
return promise;
|
|
34
|
+
}
|
|
35
|
+
async runJob({ id, request, getPayloadAt }) {
|
|
36
|
+
const prepareTimeout = getPayloadAt - Date.now();
|
|
37
|
+
if (!(prepareTimeout > 0)) {
|
|
38
|
+
throw new PayloadOrchestratorError({ code: PayloadOrchestratorErrorCode.PREPARE_DEADLINE_REACHED, jobId: id, getPayloadAt }, `Payload preparation deadline reached jobId=${id} getPayloadAt=${getPayloadAt}`);
|
|
39
|
+
}
|
|
40
|
+
const handle = await withTimeout((signal = this.signal) => retry(() => this.source.prepare(request, signal), {
|
|
41
|
+
retries: Infinity,
|
|
42
|
+
retryDelay: PREPARE_RETRY_DELAY,
|
|
43
|
+
shouldRetry: (error) => error instanceof PayloadSourceError && error.type.code === PayloadSourceErrorCode.NO_PAYLOAD_ID,
|
|
44
|
+
signal,
|
|
45
|
+
}), prepareTimeout, this.signal).catch((error) => {
|
|
46
|
+
if (error instanceof TimeoutError) {
|
|
47
|
+
throw new PayloadOrchestratorError({ code: PayloadOrchestratorErrorCode.PREPARE_TIMEOUT, jobId: id });
|
|
48
|
+
}
|
|
49
|
+
throw error;
|
|
50
|
+
});
|
|
51
|
+
await sleep(getPayloadAt - Date.now(), this.signal);
|
|
52
|
+
return withTimeout((signal = this.signal) => this.source.getPayload(handle, signal), this.options.getPayloadTimeout, this.signal).catch((error) => {
|
|
53
|
+
if (error instanceof TimeoutError) {
|
|
54
|
+
throw new PayloadOrchestratorError({ code: PayloadOrchestratorErrorCode.GET_PAYLOAD_TIMEOUT, jobId: id });
|
|
55
|
+
}
|
|
56
|
+
throw error;
|
|
57
|
+
});
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
//# sourceMappingURL=payloadOrchestrator.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"payloadOrchestrator.js","sourceRoot":"","sources":["../../src/services/payloadOrchestrator.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,13 +1,7 @@
|
|
|
1
|
-
import { ApiClient } from "@lodestar/api";
|
|
2
1
|
import type { RootHex, Slot, gloas } from "@lodestar/types";
|
|
3
|
-
import { Logger } from "@lodestar/utils";
|
|
4
2
|
/** Retains validated proposer preferences by the branch-specific identity used for bid validation. */
|
|
5
3
|
export declare class ProposerPreferencesTracker {
|
|
6
|
-
private readonly api;
|
|
7
|
-
private readonly logger;
|
|
8
4
|
private readonly byDependentRootBySlot;
|
|
9
|
-
constructor(api: ApiClient, logger: Logger);
|
|
10
|
-
start(signal: AbortSignal): void;
|
|
11
5
|
onProposerPreferences(signedProposerPreferences: gloas.SignedProposerPreferences): boolean;
|
|
12
6
|
get(slot: Slot, dependentRoot: RootHex): gloas.SignedProposerPreferences | null;
|
|
13
7
|
prune(currentSlot: Slot): number;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"proposerPreferencesTracker.d.ts","sourceRoot":"","sources":["../../src/services/proposerPreferencesTracker.ts"],"names":[],"mappings":"AAAA,OAAO,
|
|
1
|
+
{"version":3,"file":"proposerPreferencesTracker.d.ts","sourceRoot":"","sources":["../../src/services/proposerPreferencesTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAC,MAAM,iBAAiB,CAAC;AAG1D,sGAAsG;AACtG,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAEpC;IAEF,qBAAqB,CAAC,yBAAyB,EAAE,KAAK,CAAC,yBAAyB,GAAG,OAAO,CAWzF;IAED,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,GAAG,KAAK,CAAC,yBAAyB,GAAG,IAAI,CAE9E;IAED,KAAK,CAAC,WAAW,EAAE,IAAI,GAAG,MAAM,CAW/B;CACF"}
|
|
@@ -1,45 +1,7 @@
|
|
|
1
|
-
import { routes } from "@lodestar/api";
|
|
2
1
|
import { MapDef, toRootHex } from "@lodestar/utils";
|
|
3
2
|
/** Retains validated proposer preferences by the branch-specific identity used for bid validation. */
|
|
4
3
|
export class ProposerPreferencesTracker {
|
|
5
|
-
api;
|
|
6
|
-
logger;
|
|
7
4
|
byDependentRootBySlot = new MapDef(() => new Map());
|
|
8
|
-
constructor(api, logger) {
|
|
9
|
-
this.api = api;
|
|
10
|
-
this.logger = logger;
|
|
11
|
-
}
|
|
12
|
-
start(signal) {
|
|
13
|
-
if (signal.aborted)
|
|
14
|
-
return;
|
|
15
|
-
this.logger.verbose("Subscribing to proposer preferences");
|
|
16
|
-
this.api.events
|
|
17
|
-
.eventstream({
|
|
18
|
-
topics: [routes.events.EventType.proposerPreferences],
|
|
19
|
-
signal,
|
|
20
|
-
onEvent: (event) => {
|
|
21
|
-
if (!signal.aborted && event.type === routes.events.EventType.proposerPreferences) {
|
|
22
|
-
this.onProposerPreferences(event.message.data);
|
|
23
|
-
}
|
|
24
|
-
},
|
|
25
|
-
onError: (error) => {
|
|
26
|
-
if (!signal.aborted)
|
|
27
|
-
this.logger.error("Failed to receive proposer preferences", {}, error);
|
|
28
|
-
},
|
|
29
|
-
onClose: () => {
|
|
30
|
-
if (signal.aborted) {
|
|
31
|
-
this.logger.verbose("Closed proposer preferences stream");
|
|
32
|
-
}
|
|
33
|
-
else {
|
|
34
|
-
this.logger.error("Proposer preferences stream closed unexpectedly", {});
|
|
35
|
-
}
|
|
36
|
-
},
|
|
37
|
-
})
|
|
38
|
-
.catch((error) => {
|
|
39
|
-
if (!signal.aborted)
|
|
40
|
-
this.logger.error("Failed to subscribe to proposer preferences", {}, error);
|
|
41
|
-
});
|
|
42
|
-
}
|
|
43
5
|
onProposerPreferences(signedProposerPreferences) {
|
|
44
6
|
const { proposalSlot, dependentRoot } = signedProposerPreferences.message;
|
|
45
7
|
const dependentRootHex = toRootHex(dependentRoot);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"proposerPreferencesTracker.js","sourceRoot":"","sources":["../../src/services/proposerPreferencesTracker.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"proposerPreferencesTracker.js","sourceRoot":"","sources":["../../src/services/proposerPreferencesTracker.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,MAAM,EAAE,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAElD,sGAAsG;AACtG,MAAM,OAAO,0BAA0B;IACpB,qBAAqB,GAAG,IAAI,MAAM,CACjD,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAChB,CAAC;IAEF,qBAAqB,CAAC,yBAA0D;QAC9E,MAAM,EAAC,YAAY,EAAE,aAAa,EAAC,GAAG,yBAAyB,CAAC,OAAO,CAAC;QACxE,MAAM,gBAAgB,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,eAAe,GAAG,IAAI,CAAC,qBAAqB,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QAE9E,IAAI,eAAe,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,eAAe,CAAC,GAAG,CAAC,gBAAgB,EAAE,yBAAyB,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,IAAU,EAAE,aAAsB;QACpC,OAAO,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,WAAiB;QACrB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YACjE,IAAI,IAAI,IAAI,WAAW,EAAE,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC;YAChC,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}
|