@lodestar/builder 1.47.0-dev.b2cbfa50c2 → 1.47.0-dev.cec7fd63e3

package/lib/builder.d.ts

@@ -1,12 +1,16 @@
 import { ApiClient } from "@lodestar/api";
 import { ChainForkConfig } from "@lodestar/config";
 import { ClockOptions, IClock } from "@lodestar/state-transition";
+import { BuilderIndex, ExecutionAddress } from "@lodestar/types";
 import { Logger } from "@lodestar/utils";
 import { BuilderSigner, Keypair } from "./services/builderSigner.js";
+import { BuilderStatusTracker } from "./services/builderStatusTracker.js";
 export type BuilderModules = {
     opts: BuilderOptions;
     builderSigner: BuilderSigner;
+    builderStatusTracker: BuilderStatusTracker;
     clock: IClock;
+    index: BuilderIndex;
 };
 export type BuilderOptions = {
     logger: Logger;
@@ -15,15 +19,20 @@ export type BuilderOptions = {
     abortController: AbortController;
     api: ApiClient;
     clock?: ClockOptions;
+    executionFeeRecipient: ExecutionAddress;
 };
 /**
  * Main class for the Builder client.
  */
 export declare class Builder {
     readonly builderSigner: BuilderSigner;
+    private readonly builderStatusTracker;
     private readonly controller;
     private readonly clock;
-    constructor({ opts, builderSigner, clock }: BuilderModules);
+    private readonly index;
+    private readonly logger;
+    private readonly executionFeeRecipient;
+    constructor({ opts, builderSigner, builderStatusTracker, clock, index }: BuilderModules);
     static init(opts: BuilderOptions): Promise<Builder>;
     close(): Promise<void>;
 }

package/lib/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAS,MAAM,eAAe,CAAC;AAChD,OAAO,EAAC,eAAe,EAAwC,MAAM,kBAAkB,CAAC;AAExF,OAAO,EAAQ,YAAY,EAAE,MAAM,EAAC,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAC,MAAM,EAAC,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAC,aAAa,EAAE,OAAO,EAAC,MAAM,6BAA6B,CAAC;AAEnE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,eAAe,CAAC;IACjC,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,YAAY,EAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAC,EAAE,cAAc,EAMvD;IAED,OAAa,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAyCxD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;CACF"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,eAAe,CAAC;AACxC,OAAO,EAAC,eAAe,EAAwC,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAQ,YAAY,EAAE,MAAM,EAAC,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAC,YAAY,EAAE,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAC,MAAM,EAAmB,MAAM,iBAAiB,CAAC;AAIzD,OAAO,EAAC,aAAa,EAAE,OAAO,EAAC,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAC,oBAAoB,EAAC,MAAM,oCAAoC,CAAC;AAExE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,aAAa,EAAE,aAAa,CAAC;IAC7B,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,eAAe,CAAC;IACjC,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,qBAAqB,EAAE,gBAAgB,CAAC;CACzC,CAAC;AAEF;;GAEG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAuB;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAmB;IAEzD,YAAY,EAAC,IAAI,EAAE,aAAa,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAC,EAAE,cAAc,EAiBpF;IAED,OAAa,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAwBxD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;CACF"}

package/lib/builder.js

@@ -1,49 +1,54 @@
 import { assertEqualParams, createBeaconConfig } from "@lodestar/config";
-import { PAYLOAD_BUILDER_VERSION } from "@lodestar/params";
 import { Clock } from "@lodestar/state-transition";
+import { toHex, toRootHex } from "@lodestar/utils";
 import { waitForGenesis } from "./genesis.js";
+import { resolveBuilderIdentity } from "./identity.js";
+import { logNodeVersion, waitForNodeReady } from "./readiness.js";
 import { BuilderSigner } from "./services/builderSigner.js";
+import { BuilderStatusTracker } from "./services/builderStatusTracker.js";
 /**
  * Main class for the Builder client.
  */
 export class Builder {
     builderSigner;
+    builderStatusTracker;
     controller;
     clock;
-    constructor({ opts, builderSigner, clock }) {
+    index;
+    logger;
+    executionFeeRecipient;
+    constructor({ opts, builderSigner, builderStatusTracker, clock, index }) {
         this.builderSigner = builderSigner;
+        this.builderStatusTracker = builderStatusTracker;
         this.clock = clock;
         this.controller = opts.abortController;
+        this.logger = opts.logger;
+        this.index = index;
+        this.executionFeeRecipient = opts.executionFeeRecipient;
+        this.clock.runEveryEpoch(() => this.builderStatusTracker.poll());
         this.clock.start(this.controller.signal);
+        this.logger.info("Builder client initialized", {
+            index: this.index,
+            executionFeeRecipient: toHex(this.executionFeeRecipient),
+        });
     }
     static async init(opts) {
-        const genesis = await waitForGenesis(opts.api, opts.logger, opts.abortController.signal);
-        opts.logger.info("Genesis fetched from the beacon node");
-        const specRes = await opts.api.config.getSpec();
+        const { api, logger } = opts;
+        const genesis = await waitForGenesis(api, logger, opts.abortController.signal);
+        logger.info("Genesis fetched from the beacon node", {
+            genesisValidatorsRoot: toRootHex(genesis.genesisValidatorsRoot),
+        });
+        const specRes = await api.config.getSpec();
         assertEqualParams(opts.config, specRes.value());
-        opts.logger.info("Verified connected beacon node and builder have the same config");
+        logger.info("Verified connected beacon node and builder have the same config");
         const config = createBeaconConfig(opts.config, genesis.genesisValidatorsRoot);
         const builderSigner = new BuilderSigner(config, opts.keypair);
-        const builderRes = await opts.api.beacon.getStateBuilders({
-            stateId: "head",
-            builderIds: [builderSigner.getPubkeyHex()],
-        });
-        if (!builderRes.ok) {
-            throw Error(`Getting state builders from BN failed: ${builderRes.status}`);
-        }
-        const builders = builderRes.value();
-        if (builders.length === 0) {
-            throw Error(`Builder not registered: ${builderSigner.getPubkeyHex()}`);
-        }
-        const builderStatus = builders[0];
-        if (builderStatus.status !== "active") {
-            throw Error(`Builder not active: ${builderStatus.status}`);
-        }
-        if (builderStatus.builder.version !== PAYLOAD_BUILDER_VERSION) {
-            throw Error(`Builder version mismatch: got ${builderStatus.builder.version}, expected ${PAYLOAD_BUILDER_VERSION}`);
-        }
-        const clock = new Clock(config, opts.logger, { genesisTime: Number(genesis.genesisTime), ...opts.clock });
-        return new Builder({ opts, builderSigner, clock });
+        await waitForNodeReady(api, logger, opts.abortController.signal);
+        await logNodeVersion(api, logger);
+        const index = await resolveBuilderIdentity(api, logger, builderSigner.getPubkeyHex(), opts.abortController.signal);
+        const clock = new Clock(config, logger, { genesisTime: Number(genesis.genesisTime), ...opts.clock });
+        const builderStatusTracker = new BuilderStatusTracker(api, logger, index);
+        return new Builder({ opts, builderSigner, builderStatusTracker, clock, index });
     }
     async close() {
         this.controller.abort();

package/lib/builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"builder.js","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,iBAAiB,EAAE,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAC,uBAAuB,EAAC,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAC,KAAK,EAAuB,MAAM,4BAA4B,CAAC;AAEvE,OAAO,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAC,aAAa,EAAU,MAAM,6BAA6B,CAAC;AAiBnE;;GAEG;AACH,MAAM,OAAO,OAAO;IACT,aAAa,CAAgB;IACrB,UAAU,CAAkB;IAC5B,KAAK,CAAS;IAE/B,YAAY,EAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAiB;QACtD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC;QAEvC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAoB;QACpC,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QACzF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QAEzD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAChD,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QAEpF,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAC9E,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAE9D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC;YACxD,OAAO,EAAE,MAAM;YACf,UAAU,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC;SAC3C,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,MAAM,KAAK,CAAC,0CAA0C,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7E,CAAC;QAED,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC;QAEpC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,CAAC,2BAA2B,aAAa,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,aAAa,GAAkC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAEjE,IAAI,aAAa,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,KAAK,CAAC,uBAAuB,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,aAAa,CAAC,OAAO,CAAC,OAAO,KAAK,uBAAuB,EAAE,CAAC;YAC9D,MAAM,KAAK,CACT,iCAAiC,aAAa,CAAC,OAAO,CAAC,OAAO,cAAc,uBAAuB,EAAE,CACtG,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAC,CAAC,CAAC;QAExG,OAAO,IAAI,OAAO,CAAC,EAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAC,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACF"}
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}

package/lib/defaults.d.ts

@@ -1,4 +1,5 @@
 export declare const defaultOptions: {
     beaconNodeUrl: string;
+    requestTimeout: number;
 };
 //# sourceMappingURL=defaults.d.ts.map

package/lib/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;IAEzB,aAAa;CACd,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;IAEzB,aAAa;IACb,cAAc;CACf,CAAC"}

package/lib/defaults.js

@@ -1,5 +1,6 @@
 export const defaultOptions = {
     // Source beacon node the builder connects to
     beaconNodeUrl: "http://127.0.0.1:9596",
+    requestTimeout: 10_000,
 };
 //# sourceMappingURL=defaults.js.map

package/lib/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,6CAA6C;IAC7C,aAAa,EAAE,uBAAuB;CACvC,CAAC"}
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,6CAA6C;IAC7C,aAAa,EAAE,uBAAuB;IACtC,cAAc,EAAE,MAAM;CACvB,CAAC"}

package/lib/genesis.d.ts

@@ -1,5 +1,5 @@
 import { ApiClient } from "@lodestar/api";
 import { Genesis } from "@lodestar/types/phase0";
 import { Logger } from "@lodestar/utils";
-export declare function waitForGenesis(api: ApiClient, logger: Logger, signal?: AbortSignal): Promise<Genesis>;
+export declare function waitForGenesis(api: ApiClient, logger: Logger, signal: AbortSignal): Promise<Genesis>;
 //# sourceMappingURL=genesis.d.ts.map

package/lib/genesis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"genesis.d.ts","sourceRoot":"","sources":["../src/genesis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAA2B,MAAM,eAAe,CAAC;AAClE,OAAO,EAAC,OAAO,EAAC,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAC,MAAM,EAAQ,MAAM,iBAAiB,CAAC;AAK9C,wBAAsB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAa3G"}
+{"version":3,"file":"genesis.d.ts","sourceRoot":"","sources":["../src/genesis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAA2B,MAAM,eAAe,CAAC;AAClE,OAAO,EAAC,OAAO,EAAC,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAC,MAAM,EAAQ,MAAM,iBAAiB,CAAC;AAK9C,wBAAsB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAa1G"}

package/lib/genesis.js.map

@@ -1 +1 @@
-{"version":3,"file":"genesis.js","sourceRoot":"","sources":["../src/genesis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,QAAQ,EAAE,cAAc,EAAC,MAAM,eAAe,CAAC;AAElE,OAAO,EAAS,KAAK,EAAC,MAAM,iBAAiB,CAAC;AAE9C,sDAAsD;AACtD,MAAM,2BAA2B,GAAG,EAAE,GAAG,IAAI,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAc,EAAE,MAAc,EAAE,MAAoB;IACvF,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QACjD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,cAAc,CAAC,SAAS,EAAE,CAAC;gBACnE,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAC,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAC,OAAO,EAAG,CAAW,CAAC,OAAO,EAAC,CAAC,CAAC;YAC1E,CAAC;YACD,MAAM,KAAK,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"genesis.js","sourceRoot":"","sources":["../src/genesis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,QAAQ,EAAE,cAAc,EAAC,MAAM,eAAe,CAAC;AAElE,OAAO,EAAS,KAAK,EAAC,MAAM,iBAAiB,CAAC;AAE9C,sDAAsD;AACtD,MAAM,2BAA2B,GAAG,EAAE,GAAG,IAAI,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAc,EAAE,MAAc,EAAE,MAAmB;IACtF,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QACjD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,cAAc,CAAC,SAAS,EAAE,CAAC;gBACnE,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAC,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAC,OAAO,EAAG,CAAW,CAAC,OAAO,EAAC,CAAC,CAAC;YAC1E,CAAC;YACD,MAAM,KAAK,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;AACH,CAAC"}

package/lib/identity.d.ts

@@ -0,0 +1,10 @@
+import { ApiClient, routes } from "@lodestar/api";
+import { BuilderIndex, BuilderStatus } from "@lodestar/types";
+import { Logger } from "@lodestar/utils";
+export declare const WAITING_FOR_BUILDER_POLL_MS: number;
+export declare function resolveBuilderIdentity(api: ApiClient, logger: Logger, id: routes.beacon.BuilderId, signal: AbortSignal): Promise<BuilderIndex>;
+export declare function getBuilderStatus(api: ApiClient, logger: Logger, id: routes.beacon.BuilderId): Promise<{
+    status: BuilderStatus;
+    balance: number;
+} | null>;
+//# sourceMappingURL=identity.d.ts.map

package/lib/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,MAAM,EAAC,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAC,YAAY,EAAE,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAC,MAAM,EAAe,MAAM,iBAAiB,CAAC;AAErD,eAAO,MAAM,2BAA2B,QAAY,CAAC;AAErD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,EAC3B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAevB;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,GAC1B,OAAO,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,GAAG,IAAI,CAAC,CAe1D"}

package/lib/identity.js

@@ -0,0 +1,72 @@
+import { PAYLOAD_BUILDER_VERSION } from "@lodestar/params";
+import { sleep, toHex } from "@lodestar/utils";
+export const WAITING_FOR_BUILDER_POLL_MS = 10 * 1000;
+export async function resolveBuilderIdentity(api, logger, id, signal) {
+    const builderEntry = await waitForBuilder(api, logger, id, signal);
+    if (builderEntry.builder.version !== PAYLOAD_BUILDER_VERSION) {
+        throw Error(`Builder version mismatch: got ${builderEntry.builder.version}, expected ${PAYLOAD_BUILDER_VERSION}`);
+    }
+    logger.info("Builder identity resolved", {
+        index: builderEntry.index,
+        status: builderEntry.status,
+        balanceGwei: builderEntry.builder.balance,
+        executionAddress: toHex(builderEntry.builder.executionAddress),
+    });
+    return builderEntry.index;
+}
+export async function getBuilderStatus(api, logger, id) {
+    try {
+        const builderEntry = await fetchBuilder(api, id);
+        if (builderEntry) {
+            return {
+                status: builderEntry.status,
+                balance: builderEntry.builder.balance,
+            };
+        }
+        logger.warn("Builder status not available in beacon node");
+        return null;
+    }
+    catch (e) {
+        logger.warn("Couldn't fetch the builder", {}, e);
+        return null;
+    }
+}
+async function waitForBuilder(api, logger, id, signal) {
+    while (true) {
+        const builder = await fetchBuilder(api, id);
+        if (builder?.status === "active") {
+            return builder;
+        }
+        if (builder?.status === "exited") {
+            throw Error(`Builder exited: id=${id}`);
+        }
+        if (builder?.status === "pending") {
+            logger.info("Waiting for builder deposit to be finalized", { id });
+        }
+        else {
+            logger.info("Waiting for builder to be known to the beacon node", { id });
+        }
+        await sleep(WAITING_FOR_BUILDER_POLL_MS, signal);
+    }
+}
+async function fetchBuilder(api, id) {
+    const builderRes = await api.beacon.getStateBuilders({
+        stateId: "head",
+        builderIds: [id],
+    });
+    const builders = builderRes.value();
+    if (builders.length === 0) {
+        return null;
+    }
+    const builder = builders[0];
+    if (typeof id === "number") {
+        if (id !== builder.index) {
+            throw Error(`Index mismatch: got=${builder.index} expected=${id}`);
+        }
+    }
+    else if (id !== toHex(builder.builder.pubkey)) {
+        throw Error(`Pubkey mismatch: got=${toHex(builder.builder.pubkey)} expected=${id}`);
+    }
+    return builder;
+}
+//# sourceMappingURL=identity.js.map

package/lib/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"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"}

package/lib/readiness.d.ts

@@ -0,0 +1,5 @@
+import { ApiClient } from "@lodestar/api";
+import { Logger } from "@lodestar/utils";
+export declare function waitForNodeReady(api: ApiClient, logger: Logger, signal: AbortSignal): Promise<void>;
+export declare function logNodeVersion(api: ApiClient, logger: Logger): Promise<void>;
+//# sourceMappingURL=readiness.d.ts.map

package/lib/readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../src/readiness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,eAAe,CAAC;AACxC,OAAO,EAAC,MAAM,EAAQ,MAAM,iBAAiB,CAAC;AAK9C,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzG;AA0CD,wBAAsB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAalF"}

package/lib/readiness.js

@@ -0,0 +1,55 @@
+import { sleep } from "@lodestar/utils";
+/** The time between polls when waiting for BN to be ready */
+const WAITING_FOR_NODE_READY_POLL_MS = 5 * 1000;
+export async function waitForNodeReady(api, logger, signal) {
+    while (!(await isNodeReady(api, logger))) {
+        await sleep(WAITING_FOR_NODE_READY_POLL_MS, signal);
+    }
+}
+async function isNodeReady(api, logger) {
+    try {
+        const syncingStatusRes = await api.node.getSyncingStatus();
+        if (!syncingStatusRes.ok) {
+            logger.warn("Cannot get node sync status", {
+                status: syncingStatusRes.status,
+                message: syncingStatusRes.error()?.message,
+            });
+            return false;
+        }
+        const syncingStatus = syncingStatusRes.value();
+        if (syncingStatus.isSyncing || syncingStatus.elOffline) {
+            logger.info(syncingStatus.elOffline ? "Beacon node EL is offline, unable to submit bids" : "Beacon node is not ready yet", {
+                headSlot: syncingStatus.headSlot,
+                syncDistance: syncingStatus.syncDistance,
+                elOffline: syncingStatus.elOffline,
+            });
+            return false;
+        }
+        if (syncingStatus.isOptimistic) {
+            logger.warn("Beacon node head is optimistic, execution payloads are not yet verified - unable to submit bids");
+            return false;
+        }
+        logger.info("Beacon node is ready", { headSlot: syncingStatus.headSlot });
+        return true;
+    }
+    catch (e) {
+        logger.warn("Cannot reach the beacon node", {}, e);
+        return false;
+    }
+}
+export async function logNodeVersion(api, logger) {
+    try {
+        const versionRes = await api.node.getNodeVersionV2();
+        const version = versionRes.value();
+        logger.info("Connected node version", {
+            beaconNode: `${version.beaconNode.name}/${version.beaconNode.version}`,
+            executionClient: version.executionClient
+                ? `${version.executionClient.name}/${version.executionClient.version}`
+                : "unknown",
+        });
+    }
+    catch (e) {
+        logger.warn("Failed to get node version", {}, e);
+    }
+}
+//# sourceMappingURL=readiness.js.map

package/lib/readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../src/readiness.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,KAAK,EAAC,MAAM,iBAAiB,CAAC;AAE9C,6DAA6D;AAC7D,MAAM,8BAA8B,GAAG,CAAC,GAAG,IAAI,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAc,EAAE,MAAc,EAAE,MAAmB;IACxF,OAAO,CAAC,CAAC,MAAM,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;QACzC,MAAM,KAAK,CAAC,8BAA8B,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,GAAc,EAAE,MAAc;IACvD,IAAI,CAAC;QACH,MAAM,gBAAgB,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE3D,IAAI,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;gBACzC,MAAM,EAAE,gBAAgB,CAAC,MAAM;gBAC/B,OAAO,EAAE,gBAAgB,CAAC,KAAK,EAAE,EAAE,OAAO;aAC3C,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,aAAa,GAAG,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAE/C,IAAI,aAAa,CAAC,SAAS,IAAI,aAAa,CAAC,SAAS,EAAE,CAAC;YACvD,MAAM,CAAC,IAAI,CACT,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,kDAAkD,CAAC,CAAC,CAAC,8BAA8B,EAC7G;gBACE,QAAQ,EAAE,aAAa,CAAC,QAAQ;gBAChC,YAAY,EAAE,aAAa,CAAC,YAAY;gBACxC,SAAS,EAAE,aAAa,CAAC,SAAS;aACnC,CACF,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,aAAa,CAAC,YAAY,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,iGAAiG,CAAC,CAAC;YAC/G,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAC,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAC,CAAC,CAAC;QAExE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,EAAE,CAAU,CAAC,CAAC;QAC5D,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAc,EAAE,MAAc;IACjE,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACrD,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE;YACpC,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE;YACtE,eAAe,EAAE,OAAO,CAAC,eAAe;gBACtC,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC,OAAO,EAAE;gBACtE,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,EAAE,CAAU,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/lib/services/builderStatusTracker.d.ts

@@ -0,0 +1,21 @@
+import { ApiClient } from "@lodestar/api";
+import { BuilderIndex, BuilderStatus } from "@lodestar/types";
+import { Logger } from "@lodestar/utils";
+/**
+ * Service for tracking builder status.
+ * Provides regular builder status and balance updates for operator diagnostics.
+ */
+export declare class BuilderStatusTracker {
+    private readonly api;
+    private readonly logger;
+    private readonly index;
+    private status?;
+    private balanceGwei?;
+    constructor(api: ApiClient, logger: Logger, index: BuilderIndex);
+    poll(): Promise<void>;
+    getStatus(): {
+        status: BuilderStatus | undefined;
+        balance: number | undefined;
+    };
+}
+//# sourceMappingURL=builderStatusTracker.d.ts.map

package/lib/services/builderStatusTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builderStatusTracker.d.ts","sourceRoot":"","sources":["../../src/services/builderStatusTracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,eAAe,CAAC;AACxC,OAAO,EAAC,YAAY,EAAE,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAC,MAAM,EAAC,MAAM,iBAAiB,CAAC;AAGvC;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IAErC,OAAO,CAAC,MAAM,CAAC,CAAgB;IAC/B,OAAO,CAAC,WAAW,CAAC,CAAS;IAE7B,YAAY,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAI9D;IAEK,IAAI,kBAUT;IAED,SAAS,IAAI;QAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;KAAC,CAK5E;CACF"}

package/lib/services/builderStatusTracker.js

@@ -0,0 +1,35 @@
+import { getBuilderStatus } from "../identity.js";
+/**
+ * Service for tracking builder status.
+ * Provides regular builder status and balance updates for operator diagnostics.
+ */
+export class BuilderStatusTracker {
+    api;
+    logger;
+    index;
+    status;
+    balanceGwei;
+    constructor(api, logger, index) {
+        this.api = api;
+        this.logger = logger;
+        this.index = index;
+    }
+    async poll() {
+        const builderStatus = await getBuilderStatus(this.api, this.logger, this.index);
+        if (builderStatus !== null) {
+            if (this.status !== undefined && this.status !== builderStatus.status) {
+                this.logger.info("Builder status changed", { from: this.status, to: builderStatus.status });
+            }
+            this.status = builderStatus.status;
+            this.balanceGwei = builderStatus.balance;
+            this.logger.info("Builder status", { status: builderStatus.status, balance: builderStatus.balance });
+        }
+    }
+    getStatus() {
+        return {
+            status: this.status,
+            balance: this.balanceGwei,
+        };
+    }
+}
+//# sourceMappingURL=builderStatusTracker.js.map

package/lib/services/builderStatusTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builderStatusTracker.js","sourceRoot":"","sources":["../../src/services/builderStatusTracker.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,gBAAgB,EAAC,MAAM,gBAAgB,CAAC;AAEhD;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACd,GAAG,CAAY;IACf,MAAM,CAAS;IACf,KAAK,CAAe;IAE7B,MAAM,CAAiB;IACvB,WAAW,CAAU;IAE7B,YAAY,GAAc,EAAE,MAAc,EAAE,KAAmB;QAC7D,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,aAAa,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAChF,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC,MAAM,EAAE,CAAC;gBACtE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,aAAa,CAAC,MAAM,EAAC,CAAC,CAAC;YAC5F,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;YACnC,IAAI,CAAC,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAC,MAAM,EAAE,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,OAAO,EAAC,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;IAED,SAAS;QACP,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,WAAW;SAC1B,CAAC;IACJ,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lodestar/builder",
-  "version": "1.47.0-dev.b2cbfa50c2",
+  "version": "1.47.0-dev.cec7fd63e3",
   "description": "A Typescript implementation of the builder client",
   "author": "ChainSafe Systems",
   "license": "Apache-2.0",
@@ -48,16 +48,16 @@
   "dependencies": {
     "@chainsafe/blst": "^2.2.0",
     "@chainsafe/ssz": "^1.6.2",
-    "@lodestar/api": "^1.47.0-dev.b2cbfa50c2",
-    "@lodestar/config": "^1.47.0-dev.b2cbfa50c2",
-    "@lodestar/params": "^1.47.0-dev.b2cbfa50c2",
-    "@lodestar/state-transition": "^1.47.0-dev.b2cbfa50c2",
-    "@lodestar/types": "^1.47.0-dev.b2cbfa50c2",
-    "@lodestar/utils": "^1.47.0-dev.b2cbfa50c2"
+    "@lodestar/api": "^1.47.0-dev.cec7fd63e3",
+    "@lodestar/config": "^1.47.0-dev.cec7fd63e3",
+    "@lodestar/params": "^1.47.0-dev.cec7fd63e3",
+    "@lodestar/state-transition": "^1.47.0-dev.cec7fd63e3",
+    "@lodestar/types": "^1.47.0-dev.cec7fd63e3",
+    "@lodestar/utils": "^1.47.0-dev.cec7fd63e3"
   },
   "devDependencies": {
-    "@lodestar/logger": "^1.47.0-dev.b2cbfa50c2",
-    "@lodestar/test-utils": "^1.47.0-dev.b2cbfa50c2"
+    "@lodestar/logger": "^1.47.0-dev.cec7fd63e3",
+    "@lodestar/test-utils": "^1.47.0-dev.cec7fd63e3"
   },
-  "gitHead": "454c68e85c88fe2ba8e533d5f84eba6c8b4dafb5"
+  "gitHead": "f2fc097b6c8f4baec5d104d07d2418e0643ea84f"
 }

package/src/builder.ts

@@ -1,15 +1,20 @@
-import {ApiClient, routes} from "@lodestar/api";
+import {ApiClient} from "@lodestar/api";
 import {ChainForkConfig, assertEqualParams, createBeaconConfig} from "@lodestar/config";
-import {PAYLOAD_BUILDER_VERSION} from "@lodestar/params";
 import {Clock, ClockOptions, IClock} from "@lodestar/state-transition";
-import {Logger} from "@lodestar/utils";
+import {BuilderIndex, ExecutionAddress} from "@lodestar/types";
+import {Logger, toHex, toRootHex} from "@lodestar/utils";
 import {waitForGenesis} from "./genesis.js";
+import {resolveBuilderIdentity} from "./identity.js";
+import {logNodeVersion, waitForNodeReady} from "./readiness.js";
 import {BuilderSigner, Keypair} from "./services/builderSigner.js";
+import {BuilderStatusTracker} from "./services/builderStatusTracker.js";
 
 export type BuilderModules = {
   opts: BuilderOptions;
   builderSigner: BuilderSigner;
+  builderStatusTracker: BuilderStatusTracker;
   clock: IClock;
+  index: BuilderIndex;
 };
 
 export type BuilderOptions = {
@@ -19,6 +24,7 @@ export type BuilderOptions = {
   abortController: AbortController;
   api: ApiClient;
   clock?: ClockOptions;
+  executionFeeRecipient: ExecutionAddress;
 };
 
 /**
@@ -26,58 +32,56 @@ export type BuilderOptions = {
  */
 export class Builder {
   readonly builderSigner: BuilderSigner;
+  private readonly builderStatusTracker: BuilderStatusTracker;
   private readonly controller: AbortController;
   private readonly clock: IClock;
+  private readonly index: BuilderIndex;
+  private readonly logger: Logger;
+  private readonly executionFeeRecipient: ExecutionAddress;
 
-  constructor({opts, builderSigner, clock}: BuilderModules) {
+  constructor({opts, builderSigner, builderStatusTracker, clock, index}: BuilderModules) {
     this.builderSigner = builderSigner;
+    this.builderStatusTracker = builderStatusTracker;
     this.clock = clock;
     this.controller = opts.abortController;
+    this.logger = opts.logger;
+    this.index = index;
 
+    this.executionFeeRecipient = opts.executionFeeRecipient;
+
+    this.clock.runEveryEpoch(() => this.builderStatusTracker.poll());
     this.clock.start(this.controller.signal);
+
+    this.logger.info("Builder client initialized", {
+      index: this.index,
+      executionFeeRecipient: toHex(this.executionFeeRecipient),
+    });
   }
 
   static async init(opts: BuilderOptions): Promise<Builder> {
-    const genesis = await waitForGenesis(opts.api, opts.logger, opts.abortController.signal);
-    opts.logger.info("Genesis fetched from the beacon node");
+    const {api, logger} = opts;
+    const genesis = await waitForGenesis(api, logger, opts.abortController.signal);
+    logger.info("Genesis fetched from the beacon node", {
+      genesisValidatorsRoot: toRootHex(genesis.genesisValidatorsRoot),
+    });
 
-    const specRes = await opts.api.config.getSpec();
+    const specRes = await api.config.getSpec();
     assertEqualParams(opts.config, specRes.value());
-    opts.logger.info("Verified connected beacon node and builder have the same config");
+    logger.info("Verified connected beacon node and builder have the same config");
 
     const config = createBeaconConfig(opts.config, genesis.genesisValidatorsRoot);
     const builderSigner = new BuilderSigner(config, opts.keypair);
 
-    const builderRes = await opts.api.beacon.getStateBuilders({
-      stateId: "head",
-      builderIds: [builderSigner.getPubkeyHex()],
-    });
-
-    if (!builderRes.ok) {
-      throw Error(`Getting state builders from BN failed: ${builderRes.status}`);
-    }
-
-    const builders = builderRes.value();
-
-    if (builders.length === 0) {
-      throw Error(`Builder not registered: ${builderSigner.getPubkeyHex()}`);
-    }
-
-    const builderStatus: routes.beacon.BuilderResponse = builders[0];
+    await waitForNodeReady(api, logger, opts.abortController.signal);
+    await logNodeVersion(api, logger);
 
-    if (builderStatus.status !== "active") {
-      throw Error(`Builder not active: ${builderStatus.status}`);
-    }
+    const index = await resolveBuilderIdentity(api, logger, builderSigner.getPubkeyHex(), opts.abortController.signal);
 
-    if (builderStatus.builder.version !== PAYLOAD_BUILDER_VERSION) {
-      throw Error(
-        `Builder version mismatch: got ${builderStatus.builder.version}, expected ${PAYLOAD_BUILDER_VERSION}`
-      );
-    }
+    const clock = new Clock(config, logger, {genesisTime: Number(genesis.genesisTime), ...opts.clock});
 
-    const clock = new Clock(config, opts.logger, {genesisTime: Number(genesis.genesisTime), ...opts.clock});
+    const builderStatusTracker = new BuilderStatusTracker(api, logger, index);
 
-    return new Builder({opts, builderSigner, clock});
+    return new Builder({opts, builderSigner, builderStatusTracker, clock, index});
   }
 
   async close(): Promise<void> {

package/src/defaults.ts

@@ -1,4 +1,5 @@
 export const defaultOptions = {
   // Source beacon node the builder connects to
   beaconNodeUrl: "http://127.0.0.1:9596",
+  requestTimeout: 10_000,
 };

package/src/genesis.ts

@@ -5,7 +5,7 @@ import {Logger, sleep} from "@lodestar/utils";
 /** The time between polls when waiting for genesis */
 const WAITING_FOR_GENESIS_POLL_MS = 12 * 1000;
 
-export async function waitForGenesis(api: ApiClient, logger: Logger, signal?: AbortSignal): Promise<Genesis> {
+export async function waitForGenesis(api: ApiClient, logger: Logger, signal: AbortSignal): Promise<Genesis> {
   while (true) {
     try {
       return (await api.beacon.getGenesis()).value();

package/src/identity.ts

@@ -0,0 +1,100 @@
+import {ApiClient, routes} from "@lodestar/api";
+import {PAYLOAD_BUILDER_VERSION} from "@lodestar/params";
+import {BuilderIndex, BuilderStatus} from "@lodestar/types";
+import {Logger, sleep, toHex} from "@lodestar/utils";
+
+export const WAITING_FOR_BUILDER_POLL_MS = 10 * 1000;
+
+export async function resolveBuilderIdentity(
+  api: ApiClient,
+  logger: Logger,
+  id: routes.beacon.BuilderId,
+  signal: AbortSignal
+): Promise<BuilderIndex> {
+  const builderEntry = await waitForBuilder(api, logger, id, signal);
+
+  if (builderEntry.builder.version !== PAYLOAD_BUILDER_VERSION) {
+    throw Error(`Builder version mismatch: got ${builderEntry.builder.version}, expected ${PAYLOAD_BUILDER_VERSION}`);
+  }
+
+  logger.info("Builder identity resolved", {
+    index: builderEntry.index,
+    status: builderEntry.status,
+    balanceGwei: builderEntry.builder.balance,
+    executionAddress: toHex(builderEntry.builder.executionAddress),
+  });
+
+  return builderEntry.index;
+}
+
+export async function getBuilderStatus(
+  api: ApiClient,
+  logger: Logger,
+  id: routes.beacon.BuilderId
+): Promise<{status: BuilderStatus; balance: number} | null> {
+  try {
+    const builderEntry = await fetchBuilder(api, id);
+    if (builderEntry) {
+      return {
+        status: builderEntry.status,
+        balance: builderEntry.builder.balance,
+      };
+    }
+    logger.warn("Builder status not available in beacon node");
+    return null;
+  } catch (e) {
+    logger.warn("Couldn't fetch the builder", {}, e as Error);
+    return null;
+  }
+}
+
+async function waitForBuilder(
+  api: ApiClient,
+  logger: Logger,
+  id: routes.beacon.BuilderId,
+  signal: AbortSignal
+): Promise<routes.beacon.BuilderResponse> {
+  while (true) {
+    const builder = await fetchBuilder(api, id);
+    if (builder?.status === "active") {
+      return builder;
+    }
+    if (builder?.status === "exited") {
+      throw Error(`Builder exited: id=${id}`);
+    }
+    if (builder?.status === "pending") {
+      logger.info("Waiting for builder deposit to be finalized", {id});
+    } else {
+      logger.info("Waiting for builder to be known to the beacon node", {id});
+    }
+    await sleep(WAITING_FOR_BUILDER_POLL_MS, signal);
+  }
+}
+
+async function fetchBuilder(
+  api: ApiClient,
+  id: routes.beacon.BuilderId
+): Promise<routes.beacon.BuilderResponse | null> {
+  const builderRes = await api.beacon.getStateBuilders({
+    stateId: "head",
+    builderIds: [id],
+  });
+
+  const builders = builderRes.value();
+
+  if (builders.length === 0) {
+    return null;
+  }
+
+  const builder = builders[0];
+
+  if (typeof id === "number") {
+    if (id !== builder.index) {
+      throw Error(`Index mismatch: got=${builder.index} expected=${id}`);
+    }
+  } else if (id !== toHex(builder.builder.pubkey)) {
+    throw Error(`Pubkey mismatch: got=${toHex(builder.builder.pubkey)} expected=${id}`);
+  }
+
+  return builder;
+}

package/src/readiness.ts

@@ -0,0 +1,66 @@
+import {ApiClient} from "@lodestar/api";
+import {Logger, sleep} from "@lodestar/utils";
+
+/** The time between polls when waiting for BN to be ready */
+const WAITING_FOR_NODE_READY_POLL_MS = 5 * 1000;
+
+export async function waitForNodeReady(api: ApiClient, logger: Logger, signal: AbortSignal): Promise<void> {
+  while (!(await isNodeReady(api, logger))) {
+    await sleep(WAITING_FOR_NODE_READY_POLL_MS, signal);
+  }
+}
+
+async function isNodeReady(api: ApiClient, logger: Logger): Promise<boolean> {
+  try {
+    const syncingStatusRes = await api.node.getSyncingStatus();
+
+    if (!syncingStatusRes.ok) {
+      logger.warn("Cannot get node sync status", {
+        status: syncingStatusRes.status,
+        message: syncingStatusRes.error()?.message,
+      });
+      return false;
+    }
+
+    const syncingStatus = syncingStatusRes.value();
+
+    if (syncingStatus.isSyncing || syncingStatus.elOffline) {
+      logger.info(
+        syncingStatus.elOffline ? "Beacon node EL is offline, unable to submit bids" : "Beacon node is not ready yet",
+        {
+          headSlot: syncingStatus.headSlot,
+          syncDistance: syncingStatus.syncDistance,
+          elOffline: syncingStatus.elOffline,
+        }
+      );
+      return false;
+    }
+
+    if (syncingStatus.isOptimistic) {
+      logger.warn("Beacon node head is optimistic, execution payloads are not yet verified - unable to submit bids");
+      return false;
+    }
+
+    logger.info("Beacon node is ready", {headSlot: syncingStatus.headSlot});
+
+    return true;
+  } catch (e) {
+    logger.warn("Cannot reach the beacon node", {}, e as Error);
+    return false;
+  }
+}
+
+export async function logNodeVersion(api: ApiClient, logger: Logger): Promise<void> {
+  try {
+    const versionRes = await api.node.getNodeVersionV2();
+    const version = versionRes.value();
+    logger.info("Connected node version", {
+      beaconNode: `${version.beaconNode.name}/${version.beaconNode.version}`,
+      executionClient: version.executionClient
+        ? `${version.executionClient.name}/${version.executionClient.version}`
+        : "unknown",
+    });
+  } catch (e) {
+    logger.warn("Failed to get node version", {}, e as Error);
+  }
+}

package/src/services/builderStatusTracker.ts

@@ -0,0 +1,42 @@
+import {ApiClient} from "@lodestar/api";
+import {BuilderIndex, BuilderStatus} from "@lodestar/types";
+import {Logger} from "@lodestar/utils";
+import {getBuilderStatus} from "../identity.js";
+
+/**
+ * Service for tracking builder status.
+ * Provides regular builder status and balance updates for operator diagnostics.
+ */
+export class BuilderStatusTracker {
+  private readonly api: ApiClient;
+  private readonly logger: Logger;
+  private readonly index: BuilderIndex;
+
+  private status?: BuilderStatus;
+  private balanceGwei?: number;
+
+  constructor(api: ApiClient, logger: Logger, index: BuilderIndex) {
+    this.api = api;
+    this.logger = logger;
+    this.index = index;
+  }
+
+  async poll() {
+    const builderStatus = await getBuilderStatus(this.api, this.logger, this.index);
+    if (builderStatus !== null) {
+      if (this.status !== undefined && this.status !== builderStatus.status) {
+        this.logger.info("Builder status changed", {from: this.status, to: builderStatus.status});
+      }
+      this.status = builderStatus.status;
+      this.balanceGwei = builderStatus.balance;
+      this.logger.info("Builder status", {status: builderStatus.status, balance: builderStatus.balance});
+    }
+  }
+
+  getStatus(): {status: BuilderStatus | undefined; balance: number | undefined} {
+    return {
+      status: this.status,
+      balance: this.balanceGwei,
+    };
+  }
+}