@lodestar/builder 1.47.0-dev.d9c16ea16f → 1.47.0-dev.e91bc3e859

package/README.md

@@ -1,7 +1,7 @@
 # Lodestar Builder
 
 [![Discord](https://img.shields.io/discord/593655374469660673.svg?label=Discord&logo=discord)](https://discord.gg/aMxzVcr)
-[![Eth Consensus Spec v1.7.0-alpha.13](https://img.shields.io/badge/ETH%20consensus--spec-1.7.0_alpha.13-blue)](https://github.com/ethereum/consensus-specs/releases/tag/v1.7.0-alpha.13)
+[![Eth Consensus Spec v1.7.0-alpha.14](https://img.shields.io/badge/ETH%20consensus--spec-1.7.0_alpha.14-blue)](https://github.com/ethereum/consensus-specs/releases/tag/v1.7.0-alpha.14)
 ![ES Version](https://img.shields.io/badge/ES-2021-yellow)
 ![Node Version](https://img.shields.io/badge/node-24.x-green)
 

package/lib/builder.d.ts

@@ -1,12 +1,17 @@
 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 { Metrics } from "./metrics.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 = {
     logger: Logger;
@@ -15,15 +20,21 @@ export type BuilderOptions = {
     abortController: AbortController;
     api: ApiClient;
     clock?: ClockOptions;
+    executionFeeRecipient: ExecutionAddress;
+    metrics: Metrics | null;
 };
 /**
  * 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;AAGzD,OAAO,EAAC,OAAO,EAAC,MAAM,cAAc,CAAC;AAErC,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;IACxC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACzB,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,CA+BxD;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((epoch) => this.builderStatusTracker.poll(epoch));
         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 clock = new Clock(config, logger, { genesisTime: Number(genesis.genesisTime), ...opts.clock });
+        const index = await resolveBuilderIdentity(api, logger, builderSigner.getPubkeyHex(), opts.abortController.signal, clock, config);
+        const builderStatusTracker = new BuilderStatusTracker(api, logger, index, opts.metrics);
+        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":"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"}
+{"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,EAAe,MAAM,EAAQ,MAAM,iBAAiB,CAAC;AAK5D,wBAAsB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAc1G"}

package/lib/genesis.js

@@ -1,9 +1,9 @@
 import { ApiError, HttpStatusCode } from "@lodestar/api";
-import { sleep } from "@lodestar/utils";
+import { ErrorAborted, 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, logger, signal) {
-    while (true) {
+    while (!signal.aborted) {
         try {
             return (await api.beacon.getGenesis()).value();
         }
@@ -17,5 +17,6 @@ export async function waitForGenesis(api, logger, signal) {
             await sleep(WAITING_FOR_GENESIS_POLL_MS, signal);
         }
     }
+    throw new ErrorAborted("waitForGenesis");
 }
 //# sourceMappingURL=genesis.js.map

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,EAAC,YAAY,EAAU,KAAK,EAAC,MAAM,iBAAiB,CAAC;AAE5D,sDAAsD;AACtD,MAAM,2BAA2B,GAAG,EAAE,GAAG,IAAI,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAc,EAAE,MAAc,EAAE,MAAmB;IACtF,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,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;IACD,MAAM,IAAI,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAC3C,CAAC"}

package/lib/identity.d.ts

@@ -0,0 +1,12 @@
+import { ApiClient, routes } from "@lodestar/api";
+import { ChainForkConfig } from "@lodestar/config";
+import { IClock } from "@lodestar/state-transition";
+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, clock: IClock, config: ChainForkConfig): 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,EAA4B,MAAM,EAAC,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAC,MAAM,EAAC,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAC,YAAY,EAAE,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAe,MAAM,EAAe,MAAM,iBAAiB,CAAC;AAEnE,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,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,YAAY,CAAC,CAgBvB;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,104 @@
+import { ApiError, HttpStatusCode } from "@lodestar/api";
+import { PAYLOAD_BUILDER_VERSION } from "@lodestar/params";
+import { ErrorAborted, sleep, toHex } from "@lodestar/utils";
+export const WAITING_FOR_BUILDER_POLL_MS = 10 * 1000;
+export async function resolveBuilderIdentity(api, logger, id, signal, clock, config) {
+    const builderEntry = await waitForBuilder(api, logger, id, signal, clock, config);
+    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),
+        slot: clock.getCurrentSlot(),
+    });
+    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, clock, config) {
+    const gloasForkEpoch = config.GLOAS_FORK_EPOCH;
+    while (!signal.aborted) {
+        const currentEpoch = clock.getCurrentEpoch();
+        if (currentEpoch < gloasForkEpoch) {
+            // Builders only exist post-gloas, the beacon node returns an error for pre-gloas state
+            logger.info("Waiting for Gloas fork before resolving builder identity", {
+                gloasForkEpoch,
+                currentEpoch,
+                slot: clock.getCurrentSlot(),
+            });
+            await sleep(WAITING_FOR_BUILDER_POLL_MS, signal);
+            continue;
+        }
+        let builder = null;
+        try {
+            builder = await fetchBuilder(api, id);
+        }
+        catch (e) {
+            // At the fork boundary getStateBuilders("head") can still 400: it serves the head block's
+            // post-state, which stays pre-gloas until a gloas-epoch block is head. Keep polling on the transient.
+            if (e instanceof ApiError && e.status === HttpStatusCode.BAD_REQUEST) {
+                logger.info("Waiting for Gloas state to be available at head", {
+                    gloasForkEpoch,
+                    currentEpoch,
+                    slot: clock.getCurrentSlot(),
+                });
+                await sleep(WAITING_FOR_BUILDER_POLL_MS, signal);
+                continue;
+            }
+            throw e;
+        }
+        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, slot: clock.getCurrentSlot() });
+        }
+        else {
+            logger.info("Waiting for builder to be known to the beacon node", { id, slot: clock.getCurrentSlot() });
+        }
+        await sleep(WAITING_FOR_BUILDER_POLL_MS, signal);
+    }
+    throw new ErrorAborted("waitForBuilder");
+}
+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/metrics.d.ts

@@ -1,4 +1,37 @@
+import { BuilderStatus } from "@lodestar/types";
 import { MetricsRegisterExtra } from "@lodestar/utils";
 export type Metrics = ReturnType<typeof getMetrics>;
-export declare function getMetrics(_register: MetricsRegisterExtra): {};
+export type LodestarGitData = {
+    /** "0.16.0 developer/feature-1 4f816b16" */
+    version: string;
+    /** "4f816b16dfde718e2d74f95f2c8292596138c248" */
+    commit: string;
+    /** "hoodi" */
+    network: string;
+};
+export declare const builderStatusValue: Record<BuilderStatus, number>;
+export declare function getMetrics(register: MetricsRegisterExtra, gitData: LodestarGitData): {
+    builderStatus: import("@lodestar/utils").GaugeExtra<import("@lodestar/utils").NoLabels>;
+    builderBalance: import("@lodestar/utils").GaugeExtra<import("@lodestar/utils").NoLabels>;
+    restApiClient: {
+        requestTime: import("@lodestar/utils").Histogram<{
+            routeId: string;
+        }>;
+        streamTime: import("@lodestar/utils").Histogram<{
+            routeId: string;
+        }>;
+        requestErrors: import("@lodestar/utils").GaugeExtra<{
+            routeId: string;
+            baseUrl: string;
+        }>;
+        requestToFallbacks: import("@lodestar/utils").GaugeExtra<{
+            routeId: string;
+            baseUrl: string;
+        }>;
+        urlsScore: import("@lodestar/utils").GaugeExtra<{
+            urlIndex: number;
+            baseUrl: string;
+        }>;
+    };
+};
 //# sourceMappingURL=metrics.d.ts.map

package/lib/metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,iBAAiB,CAAC;AAErD,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,wBAAgB,UAAU,CAAC,SAAS,EAAE,oBAAoB,MAEzD"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAC,oBAAoB,EAAC,MAAM,iBAAiB,CAAC;AAErD,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,MAAM,MAAM,eAAe,GAAG;IAC5B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAsC,CAAC;AAEpG,wBAAgB,UAAU,CAAC,QAAQ,EAAE,oBAAoB,EAAE,OAAO,EAAE,eAAe;IAU/E,aAAa;IAKb,cAAc;IAOd,aAAa;QACX,WAAW;qBAA+B,MAAM;;QAQhD,UAAU;qBAA+B,MAAM;;QAQ/C,aAAa;qBAA2B,MAAM;qBAAW,MAAM;;QAM/D,kBAAkB;qBAA2B,MAAM;qBAAW,MAAM;;QAMpE,SAAS;sBAA4B,MAAM;qBAAW,MAAM;;;EAOjE"}

package/lib/metrics.js

@@ -1,4 +1,53 @@
-export function getMetrics(_register) {
-    return {};
+export const builderStatusValue = { pending: 0, active: 1, exited: 2 };
+export function getMetrics(register, gitData) {
+    register
+        .gauge({
+        name: "lodestar_version",
+        help: "Lodestar version",
+        labelNames: Object.keys(gitData),
+    })
+        .set(gitData, 1);
+    return {
+        builderStatus: register.gauge({
+            name: "bc_builder_status",
+            help: "Current builder status: pending=0, active=1, exited=2",
+        }),
+        builderBalance: register.gauge({
+            name: "bc_builder_balance_gwei",
+            help: "Current builder balance in gwei",
+        }),
+        // REST API client
+        restApiClient: {
+            requestTime: register.histogram({
+                name: "bc_rest_api_client_request_time_seconds",
+                help: "Histogram of REST API client request time by routeId",
+                labelNames: ["routeId"],
+                // Expected times are ~ 50-500ms, but in an overload NodeJS they can be greater
+                buckets: [0.01, 0.1, 1, 2, 5],
+            }),
+            streamTime: register.histogram({
+                name: "bc_rest_api_client_stream_time_seconds",
+                help: "Histogram of REST API client streaming time by routeId",
+                labelNames: ["routeId"],
+                // Expected times are ~ 50-500ms, but in an overload NodeJS they can be greater
+                buckets: [0.01, 0.1, 1, 2, 5],
+            }),
+            requestErrors: register.gauge({
+                name: "bc_rest_api_client_request_errors_total",
+                help: "Total count of errors on REST API client requests by routeId",
+                labelNames: ["routeId", "baseUrl"],
+            }),
+            requestToFallbacks: register.gauge({
+                name: "bc_rest_api_client_request_to_fallbacks_total",
+                help: "Total count of requests to fallback URLs on REST API by routeId",
+                labelNames: ["routeId", "baseUrl"],
+            }),
+            urlsScore: register.gauge({
+                name: "bc_rest_api_client_urls_score",
+                help: "Current score of REST API URLs by url index",
+                labelNames: ["urlIndex", "baseUrl"],
+            }),
+        },
+    };
 }
 //# sourceMappingURL=metrics.js.map

package/lib/metrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,UAAU,CAAC,SAA+B;IACxD,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,kBAAkB,GAAkC,EAAC,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAC,CAAC;AAEpG,MAAM,UAAU,UAAU,CAAC,QAA8B,EAAE,OAAwB;IACjF,QAAQ;SACL,KAAK,CAAkB;QACtB,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,kBAAkB;QACxB,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAA4B;KAC5D,CAAC;SACD,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAEnB,OAAO;QACL,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC;YAC5B,IAAI,EAAE,mBAAmB;YACzB,IAAI,EAAE,uDAAuD;SAC9D,CAAC;QAEF,cAAc,EAAE,QAAQ,CAAC,KAAK,CAAC;YAC7B,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE,iCAAiC;SACxC,CAAC;QAEF,kBAAkB;QAElB,aAAa,EAAE;YACb,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAoB;gBACjD,IAAI,EAAE,yCAAyC;gBAC/C,IAAI,EAAE,sDAAsD;gBAC5D,UAAU,EAAE,CAAC,SAAS,CAAC;gBACvB,+EAA+E;gBAC/E,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;aAC9B,CAAC;YAEF,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAoB;gBAChD,IAAI,EAAE,wCAAwC;gBAC9C,IAAI,EAAE,wDAAwD;gBAC9D,UAAU,EAAE,CAAC,SAAS,CAAC;gBACvB,+EAA+E;gBAC/E,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;aAC9B,CAAC;YAEF,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAqC;gBAChE,IAAI,EAAE,yCAAyC;gBAC/C,IAAI,EAAE,8DAA8D;gBACpE,UAAU,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;aACnC,CAAC;YAEF,kBAAkB,EAAE,QAAQ,CAAC,KAAK,CAAqC;gBACrE,IAAI,EAAE,+CAA+C;gBACrD,IAAI,EAAE,iEAAiE;gBACvE,UAAU,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;aACnC,CAAC;YAEF,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAsC;gBAC7D,IAAI,EAAE,+BAA+B;gBACrC,IAAI,EAAE,6CAA6C;gBACnD,UAAU,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;aACpC,CAAC;SACH;KACF,CAAC;AACJ,CAAC"}

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;AA6CD,wBAAsB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAalF"}

package/lib/readiness.js

@@ -0,0 +1,58 @@
+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", {
+                headSlot: syncingStatus.headSlot,
+                syncDistance: syncingStatus.syncDistance,
+            });
+            return false;
+        }
+        logger.info("Beacon node is ready", { headSlot: syncingStatus.headSlot });
+        return true;
+    }
+    catch (e) {
+        logger.error("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,EAAE;gBAC7G,QAAQ,EAAE,aAAa,CAAC,QAAQ;gBAChC,YAAY,EAAE,aAAa,CAAC,YAAY;aACzC,CAAC,CAAC;YACH,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,KAAK,CAAC,8BAA8B,EAAE,EAAE,EAAE,CAAU,CAAC,CAAC;QAC7D,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,23 @@
+import { ApiClient } from "@lodestar/api";
+import { BuilderIndex, BuilderStatus, Epoch } from "@lodestar/types";
+import { Logger } from "@lodestar/utils";
+import { Metrics } from "../metrics.js";
+/**
+ * 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 readonly metrics;
+    private status?;
+    private balanceGwei?;
+    constructor(api: ApiClient, logger: Logger, index: BuilderIndex, metrics: Metrics | null);
+    poll(currentEpoch: Epoch): 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,EAAE,KAAK,EAAC,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAC,MAAM,EAAC,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAC,OAAO,EAAqB,MAAM,eAAe,CAAC;AAE1D;;;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;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IAEzC,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,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,EAKvF;IAEK,IAAI,CAAC,YAAY,EAAE,KAAK,iBAgB7B;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,44 @@
+import { getBuilderStatus } from "../identity.js";
+import { builderStatusValue } from "../metrics.js";
+/**
+ * Service for tracking builder status.
+ * Provides regular builder status and balance updates for operator diagnostics.
+ */
+export class BuilderStatusTracker {
+    api;
+    logger;
+    index;
+    metrics;
+    status;
+    balanceGwei;
+    constructor(api, logger, index, metrics) {
+        this.api = api;
+        this.logger = logger;
+        this.index = index;
+        this.metrics = metrics;
+    }
+    async poll(currentEpoch) {
+        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, epoch: currentEpoch });
+            }
+            this.status = builderStatus.status;
+            this.balanceGwei = builderStatus.balance;
+            this.logger.info("Builder status", {
+                status: builderStatus.status,
+                balance: builderStatus.balance,
+                epoch: currentEpoch,
+            });
+            this.metrics?.builderStatus.set(builderStatusValue[builderStatus.status]);
+            this.metrics?.builderBalance.set(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;AAChD,OAAO,EAAU,kBAAkB,EAAC,MAAM,eAAe,CAAC;AAE1D;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACd,GAAG,CAAY;IACf,MAAM,CAAS;IACf,KAAK,CAAe;IACpB,OAAO,CAAiB;IAEjC,MAAM,CAAiB;IACvB,WAAW,CAAU;IAE7B,YAAY,GAAc,EAAE,MAAc,EAAE,KAAmB,EAAE,OAAuB;QACtF,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,YAAmB;QAC5B,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,EAAE,KAAK,EAAE,YAAY,EAAC,CAAC,CAAC;YACjH,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;gBACjC,MAAM,EAAE,aAAa,CAAC,MAAM;gBAC5B,OAAO,EAAE,aAAa,CAAC,OAAO;gBAC9B,KAAK,EAAE,YAAY;aACpB,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,kBAAkB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;YAC1E,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC1D,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.d9c16ea16f",
+  "version": "1.47.0-dev.e91bc3e859",
   "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.d9c16ea16f",
-    "@lodestar/config": "^1.47.0-dev.d9c16ea16f",
-    "@lodestar/params": "^1.47.0-dev.d9c16ea16f",
-    "@lodestar/state-transition": "^1.47.0-dev.d9c16ea16f",
-    "@lodestar/types": "^1.47.0-dev.d9c16ea16f",
-    "@lodestar/utils": "^1.47.0-dev.d9c16ea16f"
+    "@lodestar/api": "^1.47.0-dev.e91bc3e859",
+    "@lodestar/config": "^1.47.0-dev.e91bc3e859",
+    "@lodestar/params": "^1.47.0-dev.e91bc3e859",
+    "@lodestar/state-transition": "^1.47.0-dev.e91bc3e859",
+    "@lodestar/types": "^1.47.0-dev.e91bc3e859",
+    "@lodestar/utils": "^1.47.0-dev.e91bc3e859"
   },
   "devDependencies": {
-    "@lodestar/logger": "^1.47.0-dev.d9c16ea16f",
-    "@lodestar/test-utils": "^1.47.0-dev.d9c16ea16f"
+    "@lodestar/logger": "^1.47.0-dev.e91bc3e859",
+    "@lodestar/test-utils": "^1.47.0-dev.e91bc3e859"
   },
-  "gitHead": "8f55fe85416ebef254c015d9d7bd2cc8735c4d66"
+  "gitHead": "1bf64c513fe8c47184808c7fca42bed23ad28277"
 }

package/src/builder.ts

@@ -1,15 +1,21 @@
-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 {Metrics} from "./metrics.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 +25,8 @@ export type BuilderOptions = {
   abortController: AbortController;
   api: ApiClient;
   clock?: ClockOptions;
+  executionFeeRecipient: ExecutionAddress;
+  metrics: Metrics | null;
 };
 
 /**
@@ -26,58 +34,63 @@ 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((epoch) => this.builderStatusTracker.poll(epoch));
     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 clock = new Clock(config, logger, {genesisTime: Number(genesis.genesisTime), ...opts.clock});
 
-    if (builderStatus.builder.version !== PAYLOAD_BUILDER_VERSION) {
-      throw Error(
-        `Builder version mismatch: got ${builderStatus.builder.version}, expected ${PAYLOAD_BUILDER_VERSION}`
-      );
-    }
+    const index = await resolveBuilderIdentity(
+      api,
+      logger,
+      builderSigner.getPubkeyHex(),
+      opts.abortController.signal,
+      clock,
+      config
+    );
 
-    const clock = new Clock(config, opts.logger, {genesisTime: Number(genesis.genesisTime), ...opts.clock});
+    const builderStatusTracker = new BuilderStatusTracker(api, logger, index, opts.metrics);
 
-    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

@@ -1,12 +1,12 @@
 import {ApiClient, ApiError, HttpStatusCode} from "@lodestar/api";
 import {Genesis} from "@lodestar/types/phase0";
-import {Logger, sleep} from "@lodestar/utils";
+import {ErrorAborted, 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> {
-  while (true) {
+export async function waitForGenesis(api: ApiClient, logger: Logger, signal: AbortSignal): Promise<Genesis> {
+  while (!signal.aborted) {
     try {
       return (await api.beacon.getGenesis()).value();
     } catch (e) {
@@ -18,4 +18,5 @@ export async function waitForGenesis(api: ApiClient, logger: Logger, signal?: Ab
       await sleep(WAITING_FOR_GENESIS_POLL_MS, signal);
     }
   }
+  throw new ErrorAborted("waitForGenesis");
 }

package/src/identity.ts

@@ -0,0 +1,138 @@
+import {ApiClient, ApiError, HttpStatusCode, routes} from "@lodestar/api";
+import {ChainForkConfig} from "@lodestar/config";
+import {PAYLOAD_BUILDER_VERSION} from "@lodestar/params";
+import {IClock} from "@lodestar/state-transition";
+import {BuilderIndex, BuilderStatus} from "@lodestar/types";
+import {ErrorAborted, 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,
+  clock: IClock,
+  config: ChainForkConfig
+): Promise<BuilderIndex> {
+  const builderEntry = await waitForBuilder(api, logger, id, signal, clock, config);
+
+  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),
+    slot: clock.getCurrentSlot(),
+  });
+
+  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,
+  clock: IClock,
+  config: ChainForkConfig
+): Promise<routes.beacon.BuilderResponse> {
+  const gloasForkEpoch = config.GLOAS_FORK_EPOCH;
+  while (!signal.aborted) {
+    const currentEpoch = clock.getCurrentEpoch();
+    if (currentEpoch < gloasForkEpoch) {
+      // Builders only exist post-gloas, the beacon node returns an error for pre-gloas state
+      logger.info("Waiting for Gloas fork before resolving builder identity", {
+        gloasForkEpoch,
+        currentEpoch,
+        slot: clock.getCurrentSlot(),
+      });
+      await sleep(WAITING_FOR_BUILDER_POLL_MS, signal);
+      continue;
+    }
+
+    let builder: routes.beacon.BuilderResponse | null = null;
+    try {
+      builder = await fetchBuilder(api, id);
+    } catch (e) {
+      // At the fork boundary getStateBuilders("head") can still 400: it serves the head block's
+      // post-state, which stays pre-gloas until a gloas-epoch block is head. Keep polling on the transient.
+      if (e instanceof ApiError && e.status === HttpStatusCode.BAD_REQUEST) {
+        logger.info("Waiting for Gloas state to be available at head", {
+          gloasForkEpoch,
+          currentEpoch,
+          slot: clock.getCurrentSlot(),
+        });
+        await sleep(WAITING_FOR_BUILDER_POLL_MS, signal);
+        continue;
+      }
+      throw e;
+    }
+
+    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, slot: clock.getCurrentSlot()});
+    } else {
+      logger.info("Waiting for builder to be known to the beacon node", {id, slot: clock.getCurrentSlot()});
+    }
+    await sleep(WAITING_FOR_BUILDER_POLL_MS, signal);
+  }
+  throw new ErrorAborted("waitForBuilder");
+}
+
+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/metrics.ts

@@ -1,7 +1,75 @@
+import {BuilderStatus} from "@lodestar/types";
 import {MetricsRegisterExtra} from "@lodestar/utils";
 
 export type Metrics = ReturnType<typeof getMetrics>;
 
-export function getMetrics(_register: MetricsRegisterExtra) {
-  return {};
+export type LodestarGitData = {
+  /** "0.16.0 developer/feature-1 4f816b16" */
+  version: string;
+  /** "4f816b16dfde718e2d74f95f2c8292596138c248" */
+  commit: string;
+  /** "hoodi" */
+  network: string;
+};
+
+export const builderStatusValue: Record<BuilderStatus, number> = {pending: 0, active: 1, exited: 2};
+
+export function getMetrics(register: MetricsRegisterExtra, gitData: LodestarGitData) {
+  register
+    .gauge<LodestarGitData>({
+      name: "lodestar_version",
+      help: "Lodestar version",
+      labelNames: Object.keys(gitData) as [keyof LodestarGitData],
+    })
+    .set(gitData, 1);
+
+  return {
+    builderStatus: register.gauge({
+      name: "bc_builder_status",
+      help: "Current builder status: pending=0, active=1, exited=2",
+    }),
+
+    builderBalance: register.gauge({
+      name: "bc_builder_balance_gwei",
+      help: "Current builder balance in gwei",
+    }),
+
+    // REST API client
+
+    restApiClient: {
+      requestTime: register.histogram<{routeId: string}>({
+        name: "bc_rest_api_client_request_time_seconds",
+        help: "Histogram of REST API client request time by routeId",
+        labelNames: ["routeId"],
+        // Expected times are ~ 50-500ms, but in an overload NodeJS they can be greater
+        buckets: [0.01, 0.1, 1, 2, 5],
+      }),
+
+      streamTime: register.histogram<{routeId: string}>({
+        name: "bc_rest_api_client_stream_time_seconds",
+        help: "Histogram of REST API client streaming time by routeId",
+        labelNames: ["routeId"],
+        // Expected times are ~ 50-500ms, but in an overload NodeJS they can be greater
+        buckets: [0.01, 0.1, 1, 2, 5],
+      }),
+
+      requestErrors: register.gauge<{routeId: string; baseUrl: string}>({
+        name: "bc_rest_api_client_request_errors_total",
+        help: "Total count of errors on REST API client requests by routeId",
+        labelNames: ["routeId", "baseUrl"],
+      }),
+
+      requestToFallbacks: register.gauge<{routeId: string; baseUrl: string}>({
+        name: "bc_rest_api_client_request_to_fallbacks_total",
+        help: "Total count of requests to fallback URLs on REST API by routeId",
+        labelNames: ["routeId", "baseUrl"],
+      }),
+
+      urlsScore: register.gauge<{urlIndex: number; baseUrl: string}>({
+        name: "bc_rest_api_client_urls_score",
+        help: "Current score of REST API URLs by url index",
+        labelNames: ["urlIndex", "baseUrl"],
+      }),
+    },
+  };
 }

package/src/readiness.ts

@@ -0,0 +1,69 @@
+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", {
+        headSlot: syncingStatus.headSlot,
+        syncDistance: syncingStatus.syncDistance,
+      });
+      return false;
+    }
+
+    logger.info("Beacon node is ready", {headSlot: syncingStatus.headSlot});
+
+    return true;
+  } catch (e) {
+    logger.error("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,51 @@
+import {ApiClient} from "@lodestar/api";
+import {BuilderIndex, BuilderStatus, Epoch} from "@lodestar/types";
+import {Logger} from "@lodestar/utils";
+import {getBuilderStatus} from "../identity.js";
+import {Metrics, builderStatusValue} from "../metrics.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 readonly metrics: Metrics | null;
+
+  private status?: BuilderStatus;
+  private balanceGwei?: number;
+
+  constructor(api: ApiClient, logger: Logger, index: BuilderIndex, metrics: Metrics | null) {
+    this.api = api;
+    this.logger = logger;
+    this.index = index;
+    this.metrics = metrics;
+  }
+
+  async poll(currentEpoch: Epoch) {
+    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, epoch: currentEpoch});
+      }
+      this.status = builderStatus.status;
+      this.balanceGwei = builderStatus.balance;
+      this.logger.info("Builder status", {
+        status: builderStatus.status,
+        balance: builderStatus.balance,
+        epoch: currentEpoch,
+      });
+      this.metrics?.builderStatus.set(builderStatusValue[builderStatus.status]);
+      this.metrics?.builderBalance.set(builderStatus.balance);
+    }
+  }
+
+  getStatus(): {status: BuilderStatus | undefined; balance: number | undefined} {
+    return {
+      status: this.status,
+      balance: this.balanceGwei,
+    };
+  }
+}