@lodestar/builder 1.50.0-dev.be50566b7e → 1.50.0-dev.c04a499311
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/services/bidLedger.d.ts +1 -0
- package/lib/services/bidLedger.d.ts.map +1 -1
- package/lib/services/bidLedger.js +4 -0
- package/lib/services/bidLedger.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/package.json +10 -10
- package/src/services/bidLedger.ts +5 -0
- package/src/services/envelopePublisher.ts +154 -0
- package/src/services/executionPayloadEnvelope.ts +156 -0
- package/src/services/payloadOrchestrator.ts +107 -0
package/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Lodestar Builder
|
|
2
2
|
|
|
3
3
|
[](https://discord.gg/aMxzVcr)
|
|
4
|
-
[](https://github.com/ethereum/consensus-specs/releases/tag/v1.7.0-beta.3)
|
|
5
5
|
|
|
6
6
|
|
|
7
7
|
|
|
@@ -53,6 +53,7 @@ export declare class BidLedger {
|
|
|
53
53
|
assertCanRecordBid({ slot, parentBlockHash, parentBlockRoot, }: Pick<SubmittedBid, "slot" | "parentBlockHash" | "parentBlockRoot">): void;
|
|
54
54
|
recordBid(bid: SubmittedBid): BidLedgerRecord;
|
|
55
55
|
recordWin(identity: BidIdentity & Pick<SubmittedBid, "signedBidRoot">, blockRoot: RootHex): BidLedgerRecord | null;
|
|
56
|
+
hasWon(identity: BidIdentity, blockRoot: RootHex): boolean;
|
|
56
57
|
/** Release a winning bid liability only after its payment is known to be reflected in Builder balance. */
|
|
57
58
|
recordPaymentSettled(identity: BidIdentity): BidLedgerRecord | null;
|
|
58
59
|
canReveal(blockRoot: RootHex, blockHash: RootHex, envelopeRoot: RootHex): boolean;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bidLedger.d.ts","sourceRoot":"","sources":["../../src/services/bidLedger.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"bidLedger.d.ts","sourceRoot":"","sources":["../../src/services/bidLedger.ts"],"names":[],"mappings":"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"}
|
|
@@ -51,6 +51,10 @@ export class BidLedger {
|
|
|
51
51
|
record.wonBlockRoots.add(blockRoot);
|
|
52
52
|
return toRecord(record);
|
|
53
53
|
}
|
|
54
|
+
hasWon(identity, blockRoot) {
|
|
55
|
+
const record = this.getBid(identity.slot, identity.parentBlockHash, identity.parentBlockRoot);
|
|
56
|
+
return record !== null && record.blockHash === identity.blockHash && record.wonBlockRoots.has(blockRoot);
|
|
57
|
+
}
|
|
54
58
|
/** Release a winning bid liability only after its payment is known to be reflected in Builder balance. */
|
|
55
59
|
recordPaymentSettled(identity) {
|
|
56
60
|
const record = this.getBid(identity.slot, identity.parentBlockHash, identity.parentBlockRoot);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bidLedger.js","sourceRoot":"","sources":["../../src/services/bidLedger.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"bidLedger.js","sourceRoot":"","sources":["../../src/services/bidLedger.ts"],"names":[],"mappings":"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"}
|
|
@@ -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":"AAAA,OAAO,EAAC,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAC,MAAM,iBAAiB,CAAC;AACvF,OAAO,EAIL,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAehC,MAAM,CAAN,IAAY,4BAIX;AAJD,WAAY,4BAA4B;IACtC,gHAAgF,CAAA;IAChF,8FAA8D,CAAA;IAC9D,sGAAsE,CAAA;AACxE,CAAC,EAJW,4BAA4B,KAA5B,4BAA4B,QAIvC;AAaD,MAAM,OAAO,wBAAyB,SAAQ,aAA2C;CAAG;AAE5F;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAIX,MAAM;IACN,OAAO;IACP,MAAM;IALR,IAAI,GAAG,IAAI,GAAG,EAAiC,CAAC;IAEjE,YACmB,MAAqB,EACrB,OAAmC,EACnC,MAAmB;sBAFnB,MAAM;uBACN,OAAO;sBACP,MAAM;IACtB,CAAC;IAEJ,GAAG,CAAC,GAAoB;QACtB,MAAM,EAAC,EAAE,EAAC,GAAG,GAAG,CAAC;QACjB,IAAI,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,EAAC,EAAE,EAAE,OAAO,EAAE,YAAY,EAAkB;QAC/D,MAAM,cAAc,GAAG,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjD,IAAI,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,wBAAwB,CAChC,EAAC,IAAI,EAAE,4BAA4B,CAAC,wBAAwB,EAAE,KAAK,EAAE,EAAE,EAAE,YAAY,EAAC,EACtF,8CAA8C,EAAE,iBAAiB,YAAY,EAAE,CAChF,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,CACvB,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE;YAChD,OAAO,EAAE,QAAQ;YACjB,UAAU,EAAE,mBAAmB;YAC/B,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CACrB,KAAK,YAAY,kBAAkB,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,sBAAsB,CAAC,aAAa;YACjG,MAAM;SACP,CAAC,EACJ,cAAc,EACd,IAAI,CAAC,MAAM,CACZ,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACzB,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;gBAClC,MAAM,IAAI,wBAAwB,CAAC,EAAC,IAAI,EAAE,4BAA4B,CAAC,eAAe,EAAE,KAAK,EAAE,EAAE,EAAC,CAAC,CAAC;YACtG,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAEpD,OAAO,WAAW,CAChB,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,EAChE,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAC9B,IAAI,CAAC,MAAM,CACZ,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACzB,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;gBAClC,MAAM,IAAI,wBAAwB,CAAC,EAAC,IAAI,EAAE,4BAA4B,CAAC,mBAAmB,EAAE,KAAK,EAAE,EAAE,EAAC,CAAC,CAAC;YAC1G,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lodestar/builder",
|
|
3
|
-
"version": "1.50.0-dev.
|
|
3
|
+
"version": "1.50.0-dev.c04a499311",
|
|
4
4
|
"description": "A Typescript implementation of the builder client",
|
|
5
5
|
"author": "ChainSafe Systems",
|
|
6
6
|
"license": "Apache-2.0",
|
|
@@ -48,16 +48,16 @@
|
|
|
48
48
|
"dependencies": {
|
|
49
49
|
"@chainsafe/lodestar-z": "catalog:",
|
|
50
50
|
"@chainsafe/ssz": "^1.8.0",
|
|
51
|
-
"@lodestar/api": "^1.50.0-dev.
|
|
52
|
-
"@lodestar/config": "^1.50.0-dev.
|
|
53
|
-
"@lodestar/params": "^1.50.0-dev.
|
|
54
|
-
"@lodestar/state-transition": "^1.50.0-dev.
|
|
55
|
-
"@lodestar/types": "^1.50.0-dev.
|
|
56
|
-
"@lodestar/utils": "^1.50.0-dev.
|
|
51
|
+
"@lodestar/api": "^1.50.0-dev.c04a499311",
|
|
52
|
+
"@lodestar/config": "^1.50.0-dev.c04a499311",
|
|
53
|
+
"@lodestar/params": "^1.50.0-dev.c04a499311",
|
|
54
|
+
"@lodestar/state-transition": "^1.50.0-dev.c04a499311",
|
|
55
|
+
"@lodestar/types": "^1.50.0-dev.c04a499311",
|
|
56
|
+
"@lodestar/utils": "^1.50.0-dev.c04a499311"
|
|
57
57
|
},
|
|
58
58
|
"devDependencies": {
|
|
59
|
-
"@lodestar/logger": "^1.50.0-dev.
|
|
60
|
-
"@lodestar/test-utils": "^1.50.0-dev.
|
|
59
|
+
"@lodestar/logger": "^1.50.0-dev.c04a499311",
|
|
60
|
+
"@lodestar/test-utils": "^1.50.0-dev.c04a499311"
|
|
61
61
|
},
|
|
62
|
-
"gitHead": "
|
|
62
|
+
"gitHead": "ab3d37a400831b38acbd3bf3dcf6b15c4ef0345c"
|
|
63
63
|
}
|
|
@@ -128,6 +128,11 @@ export class BidLedger {
|
|
|
128
128
|
return toRecord(record);
|
|
129
129
|
}
|
|
130
130
|
|
|
131
|
+
hasWon(identity: BidIdentity, blockRoot: RootHex): boolean {
|
|
132
|
+
const record = this.getBid(identity.slot, identity.parentBlockHash, identity.parentBlockRoot);
|
|
133
|
+
return record !== null && record.blockHash === identity.blockHash && record.wonBlockRoots.has(blockRoot);
|
|
134
|
+
}
|
|
135
|
+
|
|
131
136
|
/** Release a winning bid liability only after its payment is known to be reflected in Builder balance. */
|
|
132
137
|
recordPaymentSettled(identity: BidIdentity): BidLedgerRecord | null {
|
|
133
138
|
const record = this.getBid(identity.slot, identity.parentBlockHash, identity.parentBlockRoot);
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
import {type ApiClient, routes} from "@lodestar/api";
|
|
2
|
+
import {type BuilderIndex, type RootHex, type gloas, ssz} from "@lodestar/types";
|
|
3
|
+
import {LodestarError, defer, toRootHex} 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
|
+
|
|
8
|
+
export type EnvelopeSelectionIdentity = BidIdentity & {blockRoot: RootHex};
|
|
9
|
+
|
|
10
|
+
export type EnvelopePublisherModules = {
|
|
11
|
+
api: ApiClient;
|
|
12
|
+
signer: BuilderSigner;
|
|
13
|
+
ledger: BidLedger;
|
|
14
|
+
builderIndex: BuilderIndex;
|
|
15
|
+
};
|
|
16
|
+
|
|
17
|
+
export enum EnvelopePublisherErrorCode {
|
|
18
|
+
BUILDER_INDEX_MISMATCH = "ENVELOPE_PUBLISHER_ERROR_BUILDER_INDEX_MISMATCH",
|
|
19
|
+
SELECTION_NOT_RECORDED = "ENVELOPE_PUBLISHER_ERROR_SELECTION_NOT_RECORDED",
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export type EnvelopePublisherErrorType =
|
|
23
|
+
| {
|
|
24
|
+
code: EnvelopePublisherErrorCode.BUILDER_INDEX_MISMATCH;
|
|
25
|
+
builderIndex: BuilderIndex;
|
|
26
|
+
envelopeBuilderIndex: BuilderIndex;
|
|
27
|
+
}
|
|
28
|
+
| ({code: EnvelopePublisherErrorCode.SELECTION_NOT_RECORDED} & EnvelopeSelectionIdentity);
|
|
29
|
+
|
|
30
|
+
export class EnvelopePublisherError extends LodestarError<EnvelopePublisherErrorType> {}
|
|
31
|
+
|
|
32
|
+
export type EnvelopePublicationResult =
|
|
33
|
+
| {status: "published"; signedEnvelope: gloas.SignedExecutionPayloadEnvelope}
|
|
34
|
+
| {status: "duplicate"};
|
|
35
|
+
|
|
36
|
+
type ActivePublication = {
|
|
37
|
+
controller: AbortController;
|
|
38
|
+
promise: Promise<EnvelopePublicationResult>;
|
|
39
|
+
waiters: number;
|
|
40
|
+
};
|
|
41
|
+
|
|
42
|
+
/** Signs and submits an envelope for a recorded local selection. */
|
|
43
|
+
export class EnvelopePublisher {
|
|
44
|
+
private readonly activePublications = new Map<RootHex, ActivePublication>();
|
|
45
|
+
|
|
46
|
+
constructor(private readonly modules: EnvelopePublisherModules) {}
|
|
47
|
+
|
|
48
|
+
async publish(contents: ExecutionPayloadEnvelopeContents, signal: AbortSignal): Promise<EnvelopePublicationResult> {
|
|
49
|
+
signal.throwIfAborted();
|
|
50
|
+
|
|
51
|
+
const {api, builderIndex, ledger, signer} = this.modules;
|
|
52
|
+
const {envelope} = contents;
|
|
53
|
+
if (envelope.builderIndex !== builderIndex) {
|
|
54
|
+
throw new EnvelopePublisherError(
|
|
55
|
+
{
|
|
56
|
+
code: EnvelopePublisherErrorCode.BUILDER_INDEX_MISMATCH,
|
|
57
|
+
builderIndex,
|
|
58
|
+
envelopeBuilderIndex: envelope.builderIndex,
|
|
59
|
+
},
|
|
60
|
+
`Envelope builder index does not match local builder index builderIndex=${builderIndex} envelopeBuilderIndex=${envelope.builderIndex}`
|
|
61
|
+
);
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
const identity: EnvelopeSelectionIdentity = {
|
|
65
|
+
slot: envelope.payload.slotNumber,
|
|
66
|
+
parentBlockHash: toRootHex(envelope.payload.parentHash),
|
|
67
|
+
parentBlockRoot: toRootHex(envelope.parentBeaconBlockRoot),
|
|
68
|
+
blockHash: toRootHex(envelope.payload.blockHash),
|
|
69
|
+
blockRoot: toRootHex(envelope.beaconBlockRoot),
|
|
70
|
+
};
|
|
71
|
+
if (!ledger.hasWon(identity, identity.blockRoot)) {
|
|
72
|
+
throw new EnvelopePublisherError(
|
|
73
|
+
{code: EnvelopePublisherErrorCode.SELECTION_NOT_RECORDED, ...identity},
|
|
74
|
+
`Envelope selection is not recorded slot=${identity.slot} blockRoot=${identity.blockRoot} blockHash=${identity.blockHash}`
|
|
75
|
+
);
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
const envelopeRoot = toRootHex(ssz.gloas.ExecutionPayloadEnvelope.hashTreeRoot(envelope));
|
|
79
|
+
ledger.recordReveal(identity.slot, identity.blockRoot, identity.blockHash, envelopeRoot);
|
|
80
|
+
if (ledger.hasPublishedReveal(identity.blockRoot)) {
|
|
81
|
+
return {status: "duplicate"};
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
let publication = this.activePublications.get(identity.blockRoot);
|
|
85
|
+
if (publication === undefined) {
|
|
86
|
+
const controller = new AbortController();
|
|
87
|
+
publication = {
|
|
88
|
+
controller,
|
|
89
|
+
waiters: 0,
|
|
90
|
+
promise: this.publishEnvelope(contents, identity, envelopeRoot, api, ledger, signer, controller.signal).finally(
|
|
91
|
+
() => {
|
|
92
|
+
if (this.activePublications.get(identity.blockRoot)?.controller === controller) {
|
|
93
|
+
this.activePublications.delete(identity.blockRoot);
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
),
|
|
97
|
+
};
|
|
98
|
+
this.activePublications.set(identity.blockRoot, publication);
|
|
99
|
+
}
|
|
100
|
+
return this.waitForPublication(identity.blockRoot, publication, signal);
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
private async waitForPublication(
|
|
104
|
+
blockRoot: RootHex,
|
|
105
|
+
publication: ActivePublication,
|
|
106
|
+
signal: AbortSignal
|
|
107
|
+
): Promise<EnvelopePublicationResult> {
|
|
108
|
+
const aborted = defer<never>();
|
|
109
|
+
const onAbort = (): void => aborted.reject(signal.reason);
|
|
110
|
+
publication.waiters++;
|
|
111
|
+
signal.addEventListener("abort", onAbort, {once: true});
|
|
112
|
+
if (signal.aborted) onAbort();
|
|
113
|
+
|
|
114
|
+
try {
|
|
115
|
+
return await Promise.race([publication.promise, aborted.promise]);
|
|
116
|
+
} finally {
|
|
117
|
+
signal.removeEventListener("abort", onAbort);
|
|
118
|
+
publication.waiters--;
|
|
119
|
+
if (publication.waiters === 0 && signal.aborted) {
|
|
120
|
+
if (this.activePublications.get(blockRoot) === publication) {
|
|
121
|
+
this.activePublications.delete(blockRoot);
|
|
122
|
+
}
|
|
123
|
+
publication.controller.abort(signal.reason);
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
private async publishEnvelope(
|
|
129
|
+
contents: ExecutionPayloadEnvelopeContents,
|
|
130
|
+
identity: EnvelopeSelectionIdentity,
|
|
131
|
+
envelopeRoot: RootHex,
|
|
132
|
+
api: ApiClient,
|
|
133
|
+
ledger: BidLedger,
|
|
134
|
+
signer: BuilderSigner,
|
|
135
|
+
signal: AbortSignal
|
|
136
|
+
): Promise<EnvelopePublicationResult> {
|
|
137
|
+
const signedEnvelope = signer.signExecutionPayloadEnvelope(contents.envelope);
|
|
138
|
+
|
|
139
|
+
const response = await api.beacon.publishExecutionPayloadEnvelope(
|
|
140
|
+
{
|
|
141
|
+
signedEnvelopeOrContents: {
|
|
142
|
+
signedExecutionPayloadEnvelope: signedEnvelope,
|
|
143
|
+
kzgProofs: contents.kzgProofs,
|
|
144
|
+
blobs: contents.blobs,
|
|
145
|
+
},
|
|
146
|
+
broadcastValidation: routes.beacon.BroadcastValidation.gossip,
|
|
147
|
+
},
|
|
148
|
+
{signal}
|
|
149
|
+
);
|
|
150
|
+
response.assertOk();
|
|
151
|
+
ledger.recordRevealPublished(identity.slot, identity.blockRoot, identity.blockHash, envelopeRoot);
|
|
152
|
+
return {status: "published", signedEnvelope};
|
|
153
|
+
}
|
|
154
|
+
}
|
|
@@ -0,0 +1,156 @@
|
|
|
1
|
+
import type {BuilderIndex, RootHex, Slot, deneb, gloas} from "@lodestar/types";
|
|
2
|
+
import {ssz} from "@lodestar/types";
|
|
3
|
+
import {LodestarError, byteArrayEquals, fromHex, toRootHex} from "@lodestar/utils";
|
|
4
|
+
import type {StoredPayload} from "./payloadStore.js";
|
|
5
|
+
|
|
6
|
+
export type ExecutionPayloadEnvelopeInput = {
|
|
7
|
+
blockRoot: RootHex;
|
|
8
|
+
builderIndex: BuilderIndex;
|
|
9
|
+
selectedBid: gloas.ExecutionPayloadBid;
|
|
10
|
+
storedPayload: StoredPayload;
|
|
11
|
+
};
|
|
12
|
+
|
|
13
|
+
export type ExecutionPayloadEnvelopeContents = {
|
|
14
|
+
envelope: gloas.ExecutionPayloadEnvelope;
|
|
15
|
+
kzgProofs: deneb.KZGProofs;
|
|
16
|
+
blobs: deneb.Blobs;
|
|
17
|
+
};
|
|
18
|
+
|
|
19
|
+
export enum ExecutionPayloadEnvelopeErrorCode {
|
|
20
|
+
SLOT_MISMATCH = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_SLOT_MISMATCH",
|
|
21
|
+
PARENT_BLOCK_ROOT_MISMATCH = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_PARENT_BLOCK_ROOT_MISMATCH",
|
|
22
|
+
PARENT_BLOCK_HASH_MISMATCH = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_PARENT_BLOCK_HASH_MISMATCH",
|
|
23
|
+
BLOCK_HASH_MISMATCH = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_BLOCK_HASH_MISMATCH",
|
|
24
|
+
BUILDER_INDEX_MISMATCH = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_BUILDER_INDEX_MISMATCH",
|
|
25
|
+
BLOB_KZG_COMMITMENTS_MISMATCH = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_BLOB_KZG_COMMITMENTS_MISMATCH",
|
|
26
|
+
EXECUTION_REQUESTS_ROOT_MISMATCH = "EXECUTION_PAYLOAD_ENVELOPE_ERROR_EXECUTION_REQUESTS_ROOT_MISMATCH",
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
export type ExecutionPayloadEnvelopeErrorType =
|
|
30
|
+
| {
|
|
31
|
+
code: ExecutionPayloadEnvelopeErrorCode.BUILDER_INDEX_MISMATCH;
|
|
32
|
+
builderIndex: BuilderIndex;
|
|
33
|
+
bidBuilderIndex: BuilderIndex;
|
|
34
|
+
}
|
|
35
|
+
| {code: ExecutionPayloadEnvelopeErrorCode.BLOB_KZG_COMMITMENTS_MISMATCH}
|
|
36
|
+
| {
|
|
37
|
+
code: ExecutionPayloadEnvelopeErrorCode.EXECUTION_REQUESTS_ROOT_MISMATCH;
|
|
38
|
+
bidExecutionRequestsRoot: RootHex;
|
|
39
|
+
payloadExecutionRequestsRoot: RootHex;
|
|
40
|
+
}
|
|
41
|
+
| {
|
|
42
|
+
code: ExecutionPayloadEnvelopeErrorCode.PARENT_BLOCK_ROOT_MISMATCH;
|
|
43
|
+
bidParentBlockRoot: RootHex;
|
|
44
|
+
storedParentBlockRoot: RootHex;
|
|
45
|
+
}
|
|
46
|
+
| {
|
|
47
|
+
code: ExecutionPayloadEnvelopeErrorCode.SLOT_MISMATCH;
|
|
48
|
+
bidSlot: Slot;
|
|
49
|
+
payloadSlot: Slot;
|
|
50
|
+
}
|
|
51
|
+
| {
|
|
52
|
+
code: ExecutionPayloadEnvelopeErrorCode.PARENT_BLOCK_HASH_MISMATCH;
|
|
53
|
+
bidParentBlockHash: RootHex;
|
|
54
|
+
payloadParentBlockHash: RootHex;
|
|
55
|
+
}
|
|
56
|
+
| {
|
|
57
|
+
code: ExecutionPayloadEnvelopeErrorCode.BLOCK_HASH_MISMATCH;
|
|
58
|
+
bidBlockHash: RootHex;
|
|
59
|
+
payloadBlockHash: RootHex;
|
|
60
|
+
};
|
|
61
|
+
|
|
62
|
+
export class ExecutionPayloadEnvelopeError extends LodestarError<ExecutionPayloadEnvelopeErrorType> {}
|
|
63
|
+
|
|
64
|
+
/** The caller must have matched the selected bid to its local ledger record. */
|
|
65
|
+
export function createExecutionPayloadEnvelopeContents({
|
|
66
|
+
blockRoot,
|
|
67
|
+
builderIndex,
|
|
68
|
+
selectedBid,
|
|
69
|
+
storedPayload,
|
|
70
|
+
}: ExecutionPayloadEnvelopeInput): ExecutionPayloadEnvelopeContents {
|
|
71
|
+
if (builderIndex !== selectedBid.builderIndex) {
|
|
72
|
+
throw new ExecutionPayloadEnvelopeError({
|
|
73
|
+
code: ExecutionPayloadEnvelopeErrorCode.BUILDER_INDEX_MISMATCH,
|
|
74
|
+
builderIndex,
|
|
75
|
+
bidBuilderIndex: selectedBid.builderIndex,
|
|
76
|
+
});
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
const bidParentBlockRoot = toRootHex(selectedBid.parentBlockRoot);
|
|
80
|
+
const storedParentBlockRoot = toRootHex(storedPayload.parentBlockRoot);
|
|
81
|
+
if (storedParentBlockRoot !== bidParentBlockRoot) {
|
|
82
|
+
throw new ExecutionPayloadEnvelopeError(
|
|
83
|
+
{
|
|
84
|
+
code: ExecutionPayloadEnvelopeErrorCode.PARENT_BLOCK_ROOT_MISMATCH,
|
|
85
|
+
bidParentBlockRoot,
|
|
86
|
+
storedParentBlockRoot,
|
|
87
|
+
},
|
|
88
|
+
`Selected bid beacon parent does not match retained payload bidParentBlockRoot=${bidParentBlockRoot} storedParentBlockRoot=${storedParentBlockRoot}`
|
|
89
|
+
);
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
const {payload} = storedPayload;
|
|
93
|
+
const payloadSlot = payload.executionPayload.slotNumber;
|
|
94
|
+
if (payloadSlot !== selectedBid.slot) {
|
|
95
|
+
throw new ExecutionPayloadEnvelopeError(
|
|
96
|
+
{code: ExecutionPayloadEnvelopeErrorCode.SLOT_MISMATCH, bidSlot: selectedBid.slot, payloadSlot},
|
|
97
|
+
`Selected bid slot does not match payload slot bidSlot=${selectedBid.slot} payloadSlot=${payloadSlot}`
|
|
98
|
+
);
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
const payloadParentBlockHash = toRootHex(payload.executionPayload.parentHash);
|
|
102
|
+
const bidParentBlockHash = toRootHex(selectedBid.parentBlockHash);
|
|
103
|
+
if (payloadParentBlockHash !== bidParentBlockHash) {
|
|
104
|
+
throw new ExecutionPayloadEnvelopeError(
|
|
105
|
+
{
|
|
106
|
+
code: ExecutionPayloadEnvelopeErrorCode.PARENT_BLOCK_HASH_MISMATCH,
|
|
107
|
+
bidParentBlockHash,
|
|
108
|
+
payloadParentBlockHash,
|
|
109
|
+
},
|
|
110
|
+
`Selected bid parent does not match payload parent bidParentBlockHash=${bidParentBlockHash} payloadParentBlockHash=${payloadParentBlockHash}`
|
|
111
|
+
);
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
const payloadBlockHash = toRootHex(payload.executionPayload.blockHash);
|
|
115
|
+
const bidBlockHash = toRootHex(selectedBid.blockHash);
|
|
116
|
+
if (payloadBlockHash !== bidBlockHash) {
|
|
117
|
+
throw new ExecutionPayloadEnvelopeError(
|
|
118
|
+
{
|
|
119
|
+
code: ExecutionPayloadEnvelopeErrorCode.BLOCK_HASH_MISMATCH,
|
|
120
|
+
bidBlockHash,
|
|
121
|
+
payloadBlockHash,
|
|
122
|
+
},
|
|
123
|
+
`Selected bid block hash does not match payload bidBlockHash=${bidBlockHash} payloadBlockHash=${payloadBlockHash}`
|
|
124
|
+
);
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
if (
|
|
128
|
+
!ssz.gloas.ExecutionPayloadBid.fields.blobKzgCommitments.equals(
|
|
129
|
+
selectedBid.blobKzgCommitments,
|
|
130
|
+
payload.blobsBundle.commitments
|
|
131
|
+
)
|
|
132
|
+
) {
|
|
133
|
+
throw new ExecutionPayloadEnvelopeError({code: ExecutionPayloadEnvelopeErrorCode.BLOB_KZG_COMMITMENTS_MISMATCH});
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
const executionRequestsRoot = ssz.gloas.ExecutionRequests.hashTreeRoot(payload.executionRequests);
|
|
137
|
+
if (!byteArrayEquals(executionRequestsRoot, selectedBid.executionRequestsRoot)) {
|
|
138
|
+
throw new ExecutionPayloadEnvelopeError({
|
|
139
|
+
code: ExecutionPayloadEnvelopeErrorCode.EXECUTION_REQUESTS_ROOT_MISMATCH,
|
|
140
|
+
bidExecutionRequestsRoot: toRootHex(selectedBid.executionRequestsRoot),
|
|
141
|
+
payloadExecutionRequestsRoot: toRootHex(executionRequestsRoot),
|
|
142
|
+
});
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
return {
|
|
146
|
+
envelope: {
|
|
147
|
+
payload: payload.executionPayload,
|
|
148
|
+
executionRequests: payload.executionRequests,
|
|
149
|
+
builderIndex,
|
|
150
|
+
beaconBlockRoot: fromHex(blockRoot),
|
|
151
|
+
parentBeaconBlockRoot: selectedBid.parentBlockRoot,
|
|
152
|
+
},
|
|
153
|
+
kzgProofs: payload.blobsBundle.proofs,
|
|
154
|
+
blobs: payload.blobsBundle.blobs,
|
|
155
|
+
};
|
|
156
|
+
}
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
import {LodestarError, TimeoutError, retry, sleep, withTimeout} from "@lodestar/utils";
|
|
2
|
+
import {
|
|
3
|
+
type BuildRequest,
|
|
4
|
+
type BuiltPayload,
|
|
5
|
+
type PayloadSource,
|
|
6
|
+
PayloadSourceError,
|
|
7
|
+
PayloadSourceErrorCode,
|
|
8
|
+
} from "./payloadSource.js";
|
|
9
|
+
|
|
10
|
+
const PREPARE_RETRY_DELAY = 100;
|
|
11
|
+
|
|
12
|
+
export type PayloadBuildJob = {
|
|
13
|
+
/** Jobs with the same ID share one build and its result. */
|
|
14
|
+
id: string;
|
|
15
|
+
request: BuildRequest;
|
|
16
|
+
/** Unix timestamp in milliseconds at which the prepared payload should be retrieved. */
|
|
17
|
+
getPayloadAt: number;
|
|
18
|
+
};
|
|
19
|
+
|
|
20
|
+
export type PayloadOrchestratorOptions = {
|
|
21
|
+
/** Maximum time in milliseconds to wait for payload retrieval. */
|
|
22
|
+
getPayloadTimeout: number;
|
|
23
|
+
};
|
|
24
|
+
|
|
25
|
+
export enum PayloadOrchestratorErrorCode {
|
|
26
|
+
PREPARE_DEADLINE_REACHED = "PAYLOAD_ORCHESTRATOR_ERROR_PREPARE_DEADLINE_REACHED",
|
|
27
|
+
PREPARE_TIMEOUT = "PAYLOAD_ORCHESTRATOR_ERROR_PREPARE_TIMEOUT",
|
|
28
|
+
GET_PAYLOAD_TIMEOUT = "PAYLOAD_ORCHESTRATOR_ERROR_GET_PAYLOAD_TIMEOUT",
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
export type PayloadOrchestratorErrorType =
|
|
32
|
+
| {
|
|
33
|
+
code: PayloadOrchestratorErrorCode.PREPARE_DEADLINE_REACHED;
|
|
34
|
+
jobId: string;
|
|
35
|
+
getPayloadAt: number;
|
|
36
|
+
}
|
|
37
|
+
| {
|
|
38
|
+
code: PayloadOrchestratorErrorCode.PREPARE_TIMEOUT | PayloadOrchestratorErrorCode.GET_PAYLOAD_TIMEOUT;
|
|
39
|
+
jobId: string;
|
|
40
|
+
};
|
|
41
|
+
|
|
42
|
+
export class PayloadOrchestratorError extends LodestarError<PayloadOrchestratorErrorType> {}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Prepares a payload and retrieves it at the requested time. Preparation retries missing payload IDs until the
|
|
46
|
+
* retrieval time. Transport-level retries remain owned by the source.
|
|
47
|
+
*/
|
|
48
|
+
export class PayloadOrchestrator {
|
|
49
|
+
private readonly jobs = new Map<string, Promise<BuiltPayload>>();
|
|
50
|
+
|
|
51
|
+
constructor(
|
|
52
|
+
private readonly source: PayloadSource,
|
|
53
|
+
private readonly options: PayloadOrchestratorOptions,
|
|
54
|
+
private readonly signal: AbortSignal
|
|
55
|
+
) {}
|
|
56
|
+
|
|
57
|
+
run(job: PayloadBuildJob): Promise<BuiltPayload> {
|
|
58
|
+
const {id} = job;
|
|
59
|
+
let promise = this.jobs.get(id);
|
|
60
|
+
if (promise === undefined) {
|
|
61
|
+
promise = this.runJob(job).finally(() => this.jobs.delete(id));
|
|
62
|
+
this.jobs.set(id, promise);
|
|
63
|
+
}
|
|
64
|
+
return promise;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
private async runJob({id, request, getPayloadAt}: PayloadBuildJob): Promise<BuiltPayload> {
|
|
68
|
+
const prepareTimeout = getPayloadAt - Date.now();
|
|
69
|
+
if (!(prepareTimeout > 0)) {
|
|
70
|
+
throw new PayloadOrchestratorError(
|
|
71
|
+
{code: PayloadOrchestratorErrorCode.PREPARE_DEADLINE_REACHED, jobId: id, getPayloadAt},
|
|
72
|
+
`Payload preparation deadline reached jobId=${id} getPayloadAt=${getPayloadAt}`
|
|
73
|
+
);
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
const handle = await withTimeout(
|
|
77
|
+
(signal = this.signal) =>
|
|
78
|
+
retry(() => this.source.prepare(request, signal), {
|
|
79
|
+
retries: Infinity,
|
|
80
|
+
retryDelay: PREPARE_RETRY_DELAY,
|
|
81
|
+
shouldRetry: (error) =>
|
|
82
|
+
error instanceof PayloadSourceError && error.type.code === PayloadSourceErrorCode.NO_PAYLOAD_ID,
|
|
83
|
+
signal,
|
|
84
|
+
}),
|
|
85
|
+
prepareTimeout,
|
|
86
|
+
this.signal
|
|
87
|
+
).catch((error: unknown) => {
|
|
88
|
+
if (error instanceof TimeoutError) {
|
|
89
|
+
throw new PayloadOrchestratorError({code: PayloadOrchestratorErrorCode.PREPARE_TIMEOUT, jobId: id});
|
|
90
|
+
}
|
|
91
|
+
throw error;
|
|
92
|
+
});
|
|
93
|
+
|
|
94
|
+
await sleep(getPayloadAt - Date.now(), this.signal);
|
|
95
|
+
|
|
96
|
+
return withTimeout(
|
|
97
|
+
(signal = this.signal) => this.source.getPayload(handle, signal),
|
|
98
|
+
this.options.getPayloadTimeout,
|
|
99
|
+
this.signal
|
|
100
|
+
).catch((error: unknown) => {
|
|
101
|
+
if (error instanceof TimeoutError) {
|
|
102
|
+
throw new PayloadOrchestratorError({code: PayloadOrchestratorErrorCode.GET_PAYLOAD_TIMEOUT, jobId: id});
|
|
103
|
+
}
|
|
104
|
+
throw error;
|
|
105
|
+
});
|
|
106
|
+
}
|
|
107
|
+
}
|