@xyo-network/chain-producer 1.17.1

package/LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

package/README.md

@@ -0,0 +1,112 @@
+# @xyo-network/chain-api
+
+[![logo][]](https://xyo.network)
+
+[![npm-badge][]][npm-link]
+[![npm-downloads-badge][]][npm-link]
+[![jsdelivr-badge][]][jsdelivr-link]
+[![npm-license-badge][]](LICENSE)
+[![socket-badge][]][socket-link]
+
+XYO Layer One API
+
+
+
+## Reference
+
+**@xyo-network/chain-api**
+
+***
+
+## Functions
+
+- [getApp](#functions/getApp)
+- [getServer](#functions/getServer)
+
+### functions
+
+  ### <a id="getApp"></a>getApp
+
+[**@xyo-network/chain-api**](#../README)
+
+***
+
+```ts
+function getApp(
+   node, 
+   transferSummaryMap, 
+   stakedChainContext, 
+initRewardsCache?): Promise<Express>;
+```
+
+## Parameters
+
+### node
+
+`NodeInstance`
+
+### transferSummaryMap
+
+`MapType`\<`string`, `WithStorageMeta`\<`TransfersStepSummary`\>\>
+
+### stakedChainContext
+
+`StakedChainContextRead`
+
+### initRewardsCache?
+
+`boolean`
+
+## Returns
+
+`Promise`\<`Express`\>
+
+  ### <a id="getServer"></a>getServer
+
+[**@xyo-network/chain-api**](#../README)
+
+***
+
+```ts
+function getServer(context): Promise<Server<typeof IncomingMessage, typeof ServerResponse>>;
+```
+
+## Parameters
+
+### context
+
+`GetServerContext`
+
+## Returns
+
+`Promise`\<`Server`\<*typeof* `IncomingMessage`, *typeof* `ServerResponse`\>\>
+
+
+## Maintainers
+
+-   [Arie Trouw](https://github.com/arietrouw) ([arietrouw.com](https://arietrouw.com))
+-   [Matt Jones](https://github.com/jonesmac)
+-   [Joel Carter](https://github.com/JoelBCarter)
+-   [Jordan Trouw](https://github.com/jordantrouw)
+
+## License
+
+> See the [LICENSE](LICENSE) file for license details
+
+## Credits
+
+[Made with 🔥 and ❄️ by XYO](https://xyo.network)
+
+[logo]: https://cdn.xy.company/img/brand/XYO_full_colored.png
+
+[npm-badge]: https://img.shields.io/npm/v/@xyo-network/chain-api.svg
+[npm-link]: https://www.npmjs.com/package/@xyo-network/chain-api
+
+[npm-downloads-badge]: https://img.shields.io/npm/dw/@xyo-network/chain-api
+[npm-license-badge]: https://img.shields.io/npm/l/@xyo-network/chain-api
+
+[jsdelivr-badge]: https://data.jsdelivr.com/v1/package/npm/@xyo-network/chain-api/badge
+[jsdelivr-link]: https://www.jsdelivr.com/package/npm/@xyo-network/chain-api
+
+[socket-badge]: https://socket.dev/api/badge/npm/package/@xyo-network/chain-api
+[socket-link]: https://socket.dev/npm/package/@xyo-network/chain-api

package/dist/node/ProducerActor.d.ts

@@ -0,0 +1,138 @@
+import type { Attributes, Counter } from '@opentelemetry/api';
+import type { CreatableName } from '@xylabs/sdk-js';
+import { AccountInstance } from '@xyo-network/account-model';
+import { Actor, type ActorParams } from '@xyo-network/chain-orchestration';
+import type { ChainId, ChainStakeIntent, HydratedBlockWithHashMeta, XL1BlockNumber } from '@xyo-network/xl1-protocol';
+import { AccountBalanceViewer, BlockProducerService, BlockRewardViewer, BlockViewer, Config, MempoolRunner, MempoolViewer, StakeTotalsViewer, TimeSyncViewer } from '@xyo-network/xl1-protocol-sdk';
+export type ProducerActorParams = ActorParams<{
+    account: AccountInstance;
+    blockRewardViewer: BlockRewardViewer;
+    chainId: ChainId;
+    config: Config;
+    runners: {
+        mempoolRunner: MempoolRunner;
+    };
+    viewers: {
+        accountBalanceViewer: AccountBalanceViewer;
+        blockViewer: BlockViewer;
+        mempoolViewer: MempoolViewer;
+        stakeTotalsViewer: StakeTotalsViewer;
+        time: TimeSyncViewer;
+    };
+}>;
+export declare class ProducerActor extends Actor<ProducerActorParams> {
+    protected _lastProducedBlock: HydratedBlockWithHashMeta | undefined;
+    protected _lastRedeclarationIntent: ChainStakeIntent | undefined;
+    protected _metricAttributes: Attributes | undefined;
+    protected _producerActorBlockProductionAttempts: Counter<Attributes> | undefined;
+    protected _producerActorBlockProductionChecks: Counter<Attributes> | undefined;
+    protected _producerActorBlocksProduced: Counter<Attributes> | undefined;
+    protected _producerActorBlocksPublished: Counter<Attributes> | undefined;
+    private _produceBlockMutex;
+    private _producer;
+    protected get account(): AccountInstance;
+    protected get accountBalanceViewer(): AccountBalanceViewer;
+    protected get blockViewer(): BlockViewer;
+    protected get chainId(): import("@xylabs/sdk-js").Hex;
+    protected get config(): {
+        api: {
+            host: string;
+            initRewardsCache: boolean;
+            port: number;
+            mnemonic?: string | undefined;
+        };
+        bridge: {
+            host: string;
+            port: number;
+            mnemonic?: string | undefined;
+        };
+        chain: {
+            id?: string | undefined;
+            genesisRewardAddress?: import("@xylabs/sdk-js").Address | undefined;
+        };
+        evm: {
+            chainId?: string | undefined;
+            infura?: {
+                projectId?: string | undefined;
+                projectSecret?: string | undefined;
+            } | undefined;
+            jsonRpc?: {
+                url?: string | undefined;
+            } | undefined;
+        };
+        mempool: {
+            enabled: boolean;
+            host: string;
+            port: number;
+            mnemonic?: string | undefined;
+        };
+        producer: {
+            heartbeatInterval: number;
+            minStake: number;
+            port: number;
+            allowlist?: import("@xylabs/sdk-js").Address[] | undefined;
+            disableIntentRedeclaration?: boolean | undefined;
+            healthCheckPort?: number | undefined;
+            mnemonic?: string | undefined;
+            rewardAddress?: string | undefined;
+        };
+        rewardRedemptionApi: {
+            chainRpcApiUrl: string;
+            host: string;
+            port: number;
+            mnemonic?: string | undefined;
+        };
+        services: {
+            accountBalanceViewerEndpoint?: string | undefined;
+            apiEndpoint?: string | undefined;
+        };
+        storage: {
+            mongo?: {
+                connectionString?: string | undefined;
+                database?: string | undefined;
+                domain?: string | undefined;
+                password?: string | undefined;
+                username?: string | undefined;
+            } | undefined;
+            root?: string | undefined;
+        };
+        telemetry: {
+            metrics?: {
+                scrape: {
+                    path: string;
+                    port: number;
+                };
+            } | undefined;
+            otel?: {
+                otlpEndpoint?: string | undefined;
+            } | undefined;
+        };
+        validation: {
+            allowedRewardRedeemers?: import("@xylabs/sdk-js").Address[] | undefined;
+            allowedRewardEscrowAccountSigners?: import("@xylabs/sdk-js").Address[] | undefined;
+        };
+        logLevel: "info" | "warn" | "error" | "log" | "debug" | "trace";
+        silent: boolean;
+    };
+    protected get mempoolRunner(): MempoolRunner;
+    protected get mempoolViewer(): MempoolViewer;
+    protected get producer(): BlockProducerService;
+    protected get stakeTotalsViewer(): StakeTotalsViewer;
+    static paramsHandler<T extends ActorParams>(params?: Partial<T>): Promise<{
+        displayName: CreatableName | NonNullable<T["displayName"]> | undefined;
+        id: CreatableName | T["id"] | undefined;
+        logger: import("@xylabs/sdk-js").Logger;
+        name?: import("@xylabs/sdk-js").CreatableName;
+        statusReporter?: import("@xylabs/sdk-js").CreatableStatusReporter<void> | undefined;
+        meterProvider?: import("@opentelemetry/api").MeterProvider;
+        traceProvider?: import("@opentelemetry/api").TracerProvider;
+    }>;
+    createHandler(): Promise<void>;
+    startHandler(): Promise<void>;
+    protected produceBlock(): Promise<void>;
+    protected redeclareIntent(): Promise<void>;
+    protected submitRedeclarationIntent(currentBlock: XL1BlockNumber, redeclarationIntent: ChainStakeIntent): Promise<void>;
+    protected validateCurrentBalance(): Promise<boolean>;
+    protected validateCurrentStake(): Promise<boolean>;
+}
+//# sourceMappingURL=ProducerActor.d.ts.map

package/dist/node/ProducerActor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProducerActor.d.ts","sourceRoot":"","sources":["../../src/ProducerActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAMnD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAC5D,OAAO,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAG1E,OAAO,KAAK,EACV,OAAO,EACP,gBAAgB,EAAE,yBAAyB,EAC3C,cAAc,EACf,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EAAE,iBAAiB,EAAE,WAAW,EACpD,MAAM,EACN,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,cAAc,EACf,MAAM,+BAA+B,CAAA;AAGtC,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC;IAC5C,OAAO,EAAE,eAAe,CAAA;IACxB,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE;QACP,aAAa,EAAE,aAAa,CAAA;KAC7B,CAAA;IACD,OAAO,EAAE;QACP,oBAAoB,EAAE,oBAAoB,CAAA;QAC1C,WAAW,EAAE,WAAW,CAAA;QACxB,aAAa,EAAE,aAAa,CAAA;QAC5B,iBAAiB,EAAE,iBAAiB,CAAA;QACpC,IAAI,EAAE,cAAc,CAAA;KACrB,CAAA;CACF,CAAC,CAAA;AAKF,qBACa,aAAc,SAAQ,KAAK,CAAC,mBAAmB,CAAC;IAC3D,SAAS,CAAC,kBAAkB,EAAE,yBAAyB,GAAG,SAAS,CAAA;IACnE,SAAS,CAAC,wBAAwB,EAAE,gBAAgB,GAAG,SAAS,CAAA;IAChE,SAAS,CAAC,iBAAiB,EAAE,UAAU,GAAG,SAAS,CAAA;IACnD,SAAS,CAAC,qCAAqC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,CAAA;IAChF,SAAS,CAAC,mCAAmC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,CAAA;IAC9E,SAAS,CAAC,4BAA4B,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,CAAA;IACvE,SAAS,CAAC,6BAA6B,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,CAAA;IAExE,OAAO,CAAC,kBAAkB,CAAc;IACxC,OAAO,CAAC,SAAS,CAAkC;IAEnD,SAAS,KAAK,OAAO,oBAEpB;IAED,SAAS,KAAK,oBAAoB,yBAEjC;IAED,SAAS,KAAK,WAAW,gBAExB;IAED,SAAS,KAAK,OAAO,iCAEpB;IAED,SAAS,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAEnB;IAED,SAAS,KAAK,aAAa,kBAE1B;IAED,SAAS,KAAK,aAAa,kBAE1B;IAED,SAAS,KAAK,QAAQ,yBAErB;IAED,SAAS,KAAK,iBAAiB,sBAE9B;WAEqB,aAAa,CAAC,CAAC,SAAS,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;;;;;;;;;IAI/D,aAAa;IAuCb,YAAY;cAiCX,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;cA4C7B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;cAiEhC,yBAAyB,CAAC,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;cAkB7G,sBAAsB,IAAI,OAAO,CAAC,OAAO,CAAC;cAe1C,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC;CAWzD"}

package/dist/node/index.d.ts

@@ -0,0 +1,3 @@
+export * from './ProducerActor.ts';
+export * from './runProducer.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA"}

package/dist/node/index.mjs

@@ -0,0 +1,302 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/ProducerActor.ts
+import { asAddress, creatable, isDefined, isUndefined, toHex, ZERO_ADDRESS } from "@xylabs/sdk-js";
+import { Actor } from "@xyo-network/chain-orchestration";
+import { createDeclarationIntent } from "@xyo-network/chain-protocol";
+import { SimpleBlockRunner } from "@xyo-network/chain-services";
+import { asXL1BlockNumber } from "@xyo-network/xl1-protocol";
+import { buildTransaction } from "@xyo-network/xl1-protocol-sdk";
+import { Mutex } from "async-mutex";
+function _ts_decorate(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate, "_ts_decorate");
+var SHOULD_REGISTER_REDECLARATION_INTENT_TIMER = true;
+var TEN_MINUTES = 10 * 60 * 1e3;
+var ProducerActor = class extends Actor {
+  static {
+    __name(this, "ProducerActor");
+  }
+  _lastProducedBlock;
+  _lastRedeclarationIntent;
+  _metricAttributes;
+  _producerActorBlockProductionAttempts;
+  _producerActorBlockProductionChecks;
+  _producerActorBlocksProduced;
+  _producerActorBlocksPublished;
+  _produceBlockMutex = new Mutex();
+  _producer;
+  get account() {
+    return this.params.account;
+  }
+  get accountBalanceViewer() {
+    return this.params.viewers.accountBalanceViewer;
+  }
+  get blockViewer() {
+    return this.params.viewers.blockViewer;
+  }
+  get chainId() {
+    return this.params.chainId;
+  }
+  get config() {
+    return this.params.config;
+  }
+  get mempoolRunner() {
+    return this.params.runners.mempoolRunner;
+  }
+  get mempoolViewer() {
+    return this.params.viewers.mempoolViewer;
+  }
+  get producer() {
+    return this._producer;
+  }
+  get stakeTotalsViewer() {
+    return this.params.viewers.stakeTotalsViewer;
+  }
+  static async paramsHandler(params) {
+    return await super.paramsHandler({
+      ...params,
+      name: params?.name ?? "Producer"
+    });
+  }
+  async createHandler() {
+    await super.createHandler();
+    this._metricAttributes = {
+      address: this.account.address.toString()
+    };
+    this._producerActorBlockProductionChecks = this.meter?.createCounter("producer_actor_block_production_checks", {
+      description: "Number of block production checks"
+    });
+    this._producerActorBlockProductionAttempts = this.meter?.createCounter("producer_actor_block_production_attempts", {
+      description: "Number of block production attempts"
+    });
+    this._producerActorBlocksProduced = this.meter?.createCounter("producer_actor_blocks_produced", {
+      description: "Number of blocks produced"
+    });
+    this._producerActorBlocksPublished = this.meter?.createCounter("producer_actor_blocks_published", {
+      description: "Number of blocks published"
+    });
+    const params = {
+      account: this.account,
+      balanceViewer: this.accountBalanceViewer,
+      config: this.config,
+      chainId: this.chainId,
+      mempoolRunner: this.mempoolRunner,
+      mempoolViewer: this.mempoolViewer,
+      blockRewardViewer: this.params.blockRewardViewer,
+      rewardAddress: asAddress(this.config.producer.rewardAddress ?? ZERO_ADDRESS, () => `Producer config must have a valid reward address configured [${this.params.config.producer.rewardAddress}]`),
+      time: this.params.viewers.time
+    };
+    this._producer = await SimpleBlockRunner.create(params);
+  }
+  async startHandler() {
+    await super.startHandler();
+    this.registerTimer(
+      "BlockProductionTimer",
+      async () => {
+        await this.produceBlock();
+      },
+      2e3,
+      1500
+      /* 500 */
+    );
+    if (SHOULD_REGISTER_REDECLARATION_INTENT_TIMER) {
+      this.registerTimer("ProducerRedeclarationTimer", async () => {
+        await this.redeclareIntent();
+      }, TEN_MINUTES, TEN_MINUTES);
+    }
+  }
+  // protected async calculateBlocksUntilProducerDeclarationExpiration(currentBlock: number): Promise<number> {
+  //   // Decide if we need to redeclare intent
+  //   const ranges = await this.stakeIntentService.getDeclaredCandidateRanges(this.account.address, 'producer')
+  //   // TODO: This doesn't handle the case where the producer had declared a range for the future
+  //   // but we're in a range that's not the future
+  //   // Sort in ascending order based on ending range to get range with highest ending block
+  //   const lastRange = ranges.toSorted((a, b) => a[1] > b[1] ? 1 : -1).at(-1)
+  //   // Use the most recent range's end block as the current declaration end OR
+  //   const [, currentDeclarationEnd] = lastRange
+  //   // If we have no ranges, we need to declare intent, so use the current block
+  //     ?? [undefined, currentBlock]
+  //   // Calculate the time until the producer's declaration expires
+  //   const timeToProducerExpiration = currentDeclarationEnd - currentBlock
+  //   return timeToProducerExpiration
+  // }
+  async produceBlock() {
+    this._producerActorBlockProductionChecks?.add(1, this._metricAttributes);
+    await this.spanAsync("produceBlock", async () => {
+      if (this._produceBlockMutex.isLocked()) {
+        this.logger?.log("Skipping block production, previous production still in progress");
+        return;
+      }
+      await this._produceBlockMutex.runExclusive(async () => {
+        const headStart = Date.now();
+        const head = (await this.blockViewer.currentBlock())[0];
+        const headDuration = Date.now() - headStart;
+        if (headDuration > 500) this.logger?.warn(`[Slow] Fetched head in ${headDuration}ms: 0x${toHex(head._hash)}`);
+        const headHash = head._hash;
+        if (this._lastProducedBlock && this._lastProducedBlock[0].previous === headHash) {
+          this.logger?.log("Block already produced:", `0x${toHex(this._lastProducedBlock[0].block)}`, this._lastProducedBlock[0].block);
+        } else {
+          this._producerActorBlockProductionAttempts?.add(1, this._metricAttributes);
+          const nextStart = Date.now();
+          const nextBlock = await this.producer.next(head);
+          const nextDuration = Date.now() - nextStart;
+          if (nextDuration > 1e3) this.logger?.warn(`[Slow] Generated next block in ${nextDuration}ms, block: ${nextBlock?.[0]._hash}`);
+          if (nextBlock) {
+            const displayBlockNumber = `0x${toHex(nextBlock[0].block)}`;
+            this.logger?.log("Produced block:", displayBlockNumber);
+            this._producerActorBlocksProduced?.add(1, this._metricAttributes);
+            await this.mempoolRunner.submitBlocks([
+              nextBlock
+            ]);
+            this.logger?.log("Published block:", displayBlockNumber, nextBlock[0].block);
+            this._producerActorBlocksPublished?.add(1, this._metricAttributes);
+            this._lastProducedBlock = nextBlock;
+          }
+        }
+      });
+    });
+  }
+  async redeclareIntent() {
+    await this.spanAsync("redeclareIntent", async () => {
+      if (this.params.config.producer.disableIntentRedeclaration) return;
+      const head = (await this.blockViewer.currentBlock())[0];
+      if (isUndefined(head)) return;
+      const currentBlock = head.block;
+      if (this._lastRedeclarationIntent) {
+        if (this._lastRedeclarationIntent.exp > currentBlock) return;
+        this._lastRedeclarationIntent = void 0;
+      }
+      if (!await this.validateCurrentBalance()) {
+        this.logger?.error(`Add balance to address ${this.account.address} for the producer to declare it's intent.`);
+        return;
+      }
+      if (!await this.validateCurrentStake()) {
+        this.logger?.error(`Add stake to contract address ${this.params.config.chain.id} for the producer to declare it's intent.`);
+        return;
+      }
+      this.logger?.log("Creating redeclaration intent for producer:", this.account.address);
+      const redeclarationIntent = createDeclarationIntent(this.account.address, "producer", currentBlock, currentBlock + SimpleBlockRunner.RedeclarationDuration);
+      await this.submitRedeclarationIntent(currentBlock, redeclarationIntent);
+      this._lastRedeclarationIntent = redeclarationIntent;
+    });
+  }
+  async submitRedeclarationIntent(currentBlock, redeclarationIntent) {
+    this.logger?.log("Submitting redeclaration intent for producer:", this.account.address);
+    const tx = await buildTransaction(this.chainId, [
+      redeclarationIntent
+    ], [], this.account, currentBlock, asXL1BlockNumber(currentBlock + 1e3, true));
+    await this.mempoolRunner.submitTransactions([
+      tx
+    ]);
+    this.logger?.log("Submitted redeclaration intent for producer:", this.account.address);
+  }
+  async validateCurrentBalance() {
+    const head = this._lastProducedBlock?.[0]._hash;
+    if (isDefined(head)) {
+      const balances = await this.accountBalanceViewer.accountBalances([
+        this.account.address
+      ], head);
+      const currentBalance = balances[this.account.address] ?? 0n;
+      if (currentBalance <= 0n) {
+        this.logger?.error(`Producer ${this.account.address} has no balance.`);
+        return false;
+      }
+      return true;
+    }
+    return true;
+  }
+  async validateCurrentStake() {
+    const requiredMinimumStake = 1n;
+    const currentStake = await this.stakeTotalsViewer.activeByStaked(this.account.address);
+    if (currentStake < requiredMinimumStake) {
+      this.logger?.error(`Producer ${this.account.address} has insufficient stake.`);
+      return false;
+    }
+    return true;
+  }
+};
+ProducerActor = _ts_decorate([
+  creatable()
+], ProducerActor);
+
+// src/runProducer.ts
+import { assertEx, exists } from "@xylabs/sdk-js";
+import { initProducerAccount } from "@xyo-network/chain-orchestration";
+import { initBlockRewardViewer, initChainService, initTimeService } from "@xyo-network/chain-services";
+import { AccountBalanceViewerRpcSchemas, BlockViewerRpcSchemas, HttpRpcTransport, JsonRpcAccountBalanceViewer, JsonRpcBlockViewer, JsonRpcMempoolRunner, JsonRpcMempoolViewer, JsonRpcStakeTotalsViewer, MempoolRunnerRpcSchemas, MempoolViewerRpcSchemas, StakeTotalsViewerRpcSchemas } from "@xyo-network/xl1-rpc";
+var runProducer = /* @__PURE__ */ __name(async (context) => {
+  const { config, logger, orchestrator } = context;
+  const endpoint = assertEx(config.services?.apiEndpoint, () => "No API endpoint configured");
+  const account = await initProducerAccount({
+    config,
+    logger
+  });
+  const accountBalanceViewer = new JsonRpcAccountBalanceViewer(new HttpRpcTransport(endpoint, {
+    ...AccountBalanceViewerRpcSchemas
+  }));
+  const blockViewer = new JsonRpcBlockViewer(new HttpRpcTransport(endpoint, {
+    ...BlockViewerRpcSchemas
+  }));
+  const stakeTotalsViewer = new JsonRpcStakeTotalsViewer(new HttpRpcTransport(endpoint, {
+    ...StakeTotalsViewerRpcSchemas
+  }));
+  const chainId = (await blockViewer.currentBlock())[0].chain;
+  const mempoolViewer = new JsonRpcMempoolViewer(new HttpRpcTransport(endpoint, {
+    ...MempoolViewerRpcSchemas
+  }));
+  const mempoolRunner = new JsonRpcMempoolRunner(new HttpRpcTransport(endpoint, {
+    ...MempoolRunnerRpcSchemas
+  }));
+  const chainContractViewer = await initChainService({
+    account,
+    config,
+    logger
+  });
+  const blockRewardViewer = await initBlockRewardViewer({
+    config,
+    logger,
+    chainContractViewer
+  });
+  const timeSyncViewer = await initTimeService({
+    config,
+    logger,
+    blockViewer
+  });
+  const params = {
+    account,
+    id: "ProducerActor",
+    chainId,
+    config,
+    viewers: {
+      accountBalanceViewer,
+      blockViewer,
+      stakeTotalsViewer,
+      mempoolViewer,
+      time: timeSyncViewer
+    },
+    blockRewardViewer,
+    runners: {
+      mempoolRunner
+    },
+    logger
+  };
+  const producer = await ProducerActor.create(params);
+  const actors = [
+    producer
+  ].filter(exists);
+  for (const actor of actors) {
+    await orchestrator.registerActor(actor);
+  }
+  await orchestrator.start();
+}, "runProducer");
+export {
+  ProducerActor,
+  runProducer
+};
+//# sourceMappingURL=index.mjs.map

package/dist/node/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ProducerActor.ts","../../src/runProducer.ts"],"sourcesContent":["import type { Attributes, Counter } from '@opentelemetry/api'\nimport type { CreatableName } from '@xylabs/sdk-js'\nimport {\n  asAddress,\n  creatable, isDefined, isUndefined, toHex,\n  ZERO_ADDRESS,\n} from '@xylabs/sdk-js'\nimport { AccountInstance } from '@xyo-network/account-model'\nimport { Actor, type ActorParams } from '@xyo-network/chain-orchestration'\nimport { createDeclarationIntent } from '@xyo-network/chain-protocol'\nimport { SimpleBlockRunner, SimpleBlockRunnerParams } from '@xyo-network/chain-services'\nimport type {\n  ChainId,\n  ChainStakeIntent, HydratedBlockWithHashMeta,\n  XL1BlockNumber,\n} from '@xyo-network/xl1-protocol'\nimport { asXL1BlockNumber } from '@xyo-network/xl1-protocol'\nimport {\n  AccountBalanceViewer,\n  BlockProducerService, BlockRewardViewer, BlockViewer, buildTransaction,\n  Config,\n  MempoolRunner,\n  MempoolViewer,\n  StakeTotalsViewer,\n  TimeSyncViewer,\n} from '@xyo-network/xl1-protocol-sdk'\nimport { Mutex } from 'async-mutex'\n\nexport type ProducerActorParams = ActorParams<{\n  account: AccountInstance\n  blockRewardViewer: BlockRewardViewer\n  chainId: ChainId\n  config: Config\n  runners: {\n    mempoolRunner: MempoolRunner\n  }\n  viewers: {\n    accountBalanceViewer: AccountBalanceViewer\n    blockViewer: BlockViewer\n    mempoolViewer: MempoolViewer\n    stakeTotalsViewer: StakeTotalsViewer\n    time: TimeSyncViewer\n  }\n}>\n\nconst SHOULD_REGISTER_REDECLARATION_INTENT_TIMER = true\nconst TEN_MINUTES = 10 * 60 * 1000 // 10 minutes in milliseconds\n\n@creatable()\nexport class ProducerActor extends Actor<ProducerActorParams> {\n  protected _lastProducedBlock: HydratedBlockWithHashMeta | undefined\n  protected _lastRedeclarationIntent: ChainStakeIntent | undefined\n  protected _metricAttributes: Attributes | undefined\n  protected _producerActorBlockProductionAttempts: Counter<Attributes> | undefined\n  protected _producerActorBlockProductionChecks: Counter<Attributes> | undefined\n  protected _producerActorBlocksProduced: Counter<Attributes> | undefined\n  protected _producerActorBlocksPublished: Counter<Attributes> | undefined\n\n  private _produceBlockMutex = new Mutex()\n  private _producer: BlockProducerService | undefined\n\n  protected get account() {\n    return this.params.account!\n  }\n\n  protected get accountBalanceViewer() {\n    return this.params.viewers.accountBalanceViewer!\n  }\n\n  protected get blockViewer() {\n    return this.params.viewers.blockViewer!\n  }\n\n  protected get chainId() {\n    return this.params.chainId!\n  }\n\n  protected get config() {\n    return this.params.config!\n  }\n\n  protected get mempoolRunner() {\n    return this.params.runners.mempoolRunner!\n  }\n\n  protected get mempoolViewer() {\n    return this.params.viewers.mempoolViewer!\n  }\n\n  protected get producer() {\n    return this._producer!\n  }\n\n  protected get stakeTotalsViewer() {\n    return this.params.viewers.stakeTotalsViewer!\n  }\n\n  static override async paramsHandler<T extends ActorParams>(params?: Partial<T>) {\n    return await super.paramsHandler({ ...params, name: (params?.name ?? 'Producer') as CreatableName })\n  }\n\n  override async createHandler() {\n    await super.createHandler()\n    // Create the consistent meter attributes that will\n    // be included with all metrics from this actor\n    this._metricAttributes = { address: this.account.address.toString() }\n    // Create the metrics\n    this._producerActorBlockProductionChecks = this.meter?.createCounter(\n      'producer_actor_block_production_checks',\n      { description: 'Number of block production checks' },\n    )\n    this._producerActorBlockProductionAttempts = this.meter?.createCounter(\n      'producer_actor_block_production_attempts',\n      { description: 'Number of block production attempts' },\n    )\n    this._producerActorBlocksProduced = this.meter?.createCounter(\n      'producer_actor_blocks_produced',\n      { description: 'Number of blocks produced' },\n    )\n    this._producerActorBlocksPublished = this.meter?.createCounter(\n      'producer_actor_blocks_published',\n      { description: 'Number of blocks published' },\n    )\n    const params = {\n      account: this.account,\n      balanceViewer: this.accountBalanceViewer,\n      config: this.config,\n      chainId: this.chainId,\n      mempoolRunner: this.mempoolRunner,\n      mempoolViewer: this.mempoolViewer,\n      blockRewardViewer: this.params.blockRewardViewer!,\n      rewardAddress: asAddress(\n        this.config.producer.rewardAddress ?? ZERO_ADDRESS,\n        () => `Producer config must have a valid reward address configured [${this.params.config.producer.rewardAddress}]`,\n      ),\n      time: this.params.viewers.time!,\n    } satisfies SimpleBlockRunnerParams\n    this._producer = await SimpleBlockRunner.create(params)\n  }\n\n  override async startHandler() {\n    await super.startHandler()\n    // Register a timer to check if we should produce a block\n    this.registerTimer('BlockProductionTimer', async () => {\n      await this.produceBlock()\n    }, 2000, 1500/* 500 */)\n\n    if (SHOULD_REGISTER_REDECLARATION_INTENT_TIMER) {\n      // Register a timer to check if we should redeclare the producer\n      this.registerTimer('ProducerRedeclarationTimer', async () => {\n        await this.redeclareIntent()\n      }, TEN_MINUTES, TEN_MINUTES)\n    }\n  }\n\n  // protected async calculateBlocksUntilProducerDeclarationExpiration(currentBlock: number): Promise<number> {\n  //   // Decide if we need to redeclare intent\n  //   const ranges = await this.stakeIntentService.getDeclaredCandidateRanges(this.account.address, 'producer')\n  //   // TODO: This doesn't handle the case where the producer had declared a range for the future\n  //   // but we're in a range that's not the future\n  //   // Sort in ascending order based on ending range to get range with highest ending block\n  //   const lastRange = ranges.toSorted((a, b) => a[1] > b[1] ? 1 : -1).at(-1)\n\n  //   // Use the most recent range's end block as the current declaration end OR\n  //   const [, currentDeclarationEnd] = lastRange\n  //   // If we have no ranges, we need to declare intent, so use the current block\n  //     ?? [undefined, currentBlock]\n\n  //   // Calculate the time until the producer's declaration expires\n  //   const timeToProducerExpiration = currentDeclarationEnd - currentBlock\n  //   return timeToProducerExpiration\n  // }\n\n  protected async produceBlock(): Promise<void> {\n    this._producerActorBlockProductionChecks?.add(1, this._metricAttributes)\n    await this.spanAsync('produceBlock', async () => {\n      if (this._produceBlockMutex.isLocked()) {\n        this.logger?.log('Skipping block production, previous production still in progress')\n        return\n      }\n\n      await this._produceBlockMutex.runExclusive(async () => {\n      // Get the updated head\n        const headStart = Date.now()\n        const head = (await this.blockViewer.currentBlock())[0]\n        const headDuration = Date.now() - headStart\n        if (headDuration > 500) this.logger?.warn(`[Slow] Fetched head in ${headDuration}ms: 0x${toHex(head._hash)}`)\n        // Check if we've already produced the next block for this head\n        const headHash = head._hash\n        // If our last produced block was the next block for the current head, we do not\n        // need to produce another. This prevents duplicate blocks from being produced\n        if (this._lastProducedBlock && this._lastProducedBlock[0].previous === headHash) {\n          this.logger?.log('Block already produced:', `0x${toHex(this._lastProducedBlock[0].block)}`, this._lastProducedBlock[0].block)\n        } else {\n          this._producerActorBlockProductionAttempts?.add(1, this._metricAttributes)\n          // Produce the next block\n          const nextStart = Date.now()\n          const nextBlock = await this.producer.next(head)\n          const nextDuration = Date.now() - nextStart\n          if (nextDuration > 1000) this.logger?.warn(`[Slow] Generated next block in ${nextDuration}ms, block: ${nextBlock?.[0]._hash}`)\n          // If it was produced\n          if (nextBlock) {\n            const displayBlockNumber = `0x${toHex(nextBlock[0].block)}`\n            this.logger?.log('Produced block:', displayBlockNumber)\n            this._producerActorBlocksProduced?.add(1, this._metricAttributes)\n            // Insert the block into the chain\n            await this.mempoolRunner.submitBlocks([nextBlock])\n            this.logger?.log('Published block:', displayBlockNumber, nextBlock[0].block)\n            this._producerActorBlocksPublished?.add(1, this._metricAttributes)\n            // Record that we have produced a block so we do not produce it again\n            this._lastProducedBlock = nextBlock\n          }\n        }\n      })\n    })\n  }\n\n  protected async redeclareIntent(): Promise<void> {\n    await this.spanAsync('redeclareIntent', async () => {\n      // Decide if we should redeclare intent\n      if (this.params.config.producer.disableIntentRedeclaration) return\n\n      // Get the current block\n      const head = (await this.blockViewer.currentBlock())[0]\n      if (isUndefined(head)) return\n      const currentBlock = head.block\n\n      // // Calculate the time until the producer's declaration expires\n      // const blocksUntilExpiration = await this.calculateBlocksUntilProducerDeclarationExpiration(currentBlock)\n\n      // // Allow the producer time to redeclare itself via block production\n      // // (for free) before submitting a redeclaration intent transaction.\n      // if (blocksUntilExpiration > BaseBlockProducerService.RedeclarationWindow * 0.1) {\n      //   // Clear any previous redeclaration intent\n      //   this._lastRedeclarationIntent = undefined\n      //   // No need to redeclare yet\n      //   return\n      // }\n\n      // If we already have a valid redeclaration intent, do not create another\n      // unless it has expired.\n      if (this._lastRedeclarationIntent) {\n        // Check if the last redeclaration intent is still valid\n        if (this._lastRedeclarationIntent.exp > currentBlock) return\n        // If it has expired, clear the last redeclaration intent\n        this._lastRedeclarationIntent = undefined\n      }\n\n      // Check if we have a valid balance before declaring intent\n      if (!await this.validateCurrentBalance()) {\n        this.logger?.error(\n          `Add balance to address ${this.account.address} for the producer to declare it's intent.`,\n        )\n        return\n      }\n\n      // Check if we have a valid stake before declaring intent\n      if (!(await this.validateCurrentStake())) {\n        this.logger?.error(\n          `Add stake to contract address ${this.params.config.chain.id}`\n          + ' for the producer to declare it\\'s intent.',\n        )\n        return\n      }\n\n      // Create a redeclaration intent\n      this.logger?.log('Creating redeclaration intent for producer:', this.account.address)\n      const redeclarationIntent = createDeclarationIntent(\n        this.account.address,\n        'producer',\n        currentBlock,\n        currentBlock + SimpleBlockRunner.RedeclarationDuration,\n      )\n\n      // Submit the redeclaration intent\n      await this.submitRedeclarationIntent(currentBlock, redeclarationIntent)\n\n      // On successful submission, save the redeclaration intent\n      this._lastRedeclarationIntent = redeclarationIntent\n    })\n  }\n\n  protected async submitRedeclarationIntent(currentBlock: XL1BlockNumber, redeclarationIntent: ChainStakeIntent): Promise<void> {\n    this.logger?.log('Submitting redeclaration intent for producer:', this.account.address)\n    // Create a transaction to submit the redeclaration intent\n    const tx = await buildTransaction(\n      this.chainId,\n      [redeclarationIntent],\n      [],\n      this.account,\n      currentBlock,\n      asXL1BlockNumber(currentBlock + 1000, true),\n    )\n\n    // Submit the redeclaration intent\n    await this.mempoolRunner.submitTransactions([tx])\n\n    this.logger?.log('Submitted redeclaration intent for producer:', this.account.address)\n  }\n\n  protected async validateCurrentBalance(): Promise<boolean> {\n    // Check if we have a valid balance before declaring intent\n    const head = this._lastProducedBlock?.[0]._hash\n    if (isDefined(head)) {\n      const balances = await this.accountBalanceViewer.accountBalances([this.account.address], head)\n      const currentBalance = balances[this.account.address] ?? 0n\n      if (currentBalance <= 0n) {\n        this.logger?.error(`Producer ${this.account.address} has no balance.`)\n        return false\n      }\n      return true\n    }\n    return true\n  }\n\n  protected async validateCurrentStake(): Promise<boolean> {\n    // Use StakeIntentService to get the required minimum stake\n    const requiredMinimumStake = 1n // this.stakeIntentService.getRequiredMinimumStakeForIntent('producer')\n    // Check if we have a valid stake before declaring intent\n    const currentStake = await this.stakeTotalsViewer.activeByStaked(this.account.address)\n    if (currentStake < requiredMinimumStake) {\n      this.logger?.error(`Producer ${this.account.address} has insufficient stake.`)\n      return false\n    }\n    return true\n  }\n}\n","import {\n  assertEx, exists, type Logger,\n} from '@xylabs/sdk-js'\nimport {\n  initProducerAccount, initStakeViewer, type OrchestratorInstance,\n} from '@xyo-network/chain-orchestration'\nimport {\n  initBlockRewardViewer, initChainService, initTimeService,\n} from '@xyo-network/chain-services'\nimport { type Config } from '@xyo-network/xl1-protocol-sdk'\nimport {\n  AccountBalanceViewerRpcSchemas, BlockViewerRpcSchemas, HttpRpcTransport, JsonRpcAccountBalanceViewer,\n  JsonRpcBlockViewer,\n  JsonRpcMempoolRunner,\n  JsonRpcMempoolViewer,\n  JsonRpcStakeTotalsViewer,\n  MempoolRunnerRpcSchemas,\n  MempoolViewerRpcSchemas,\n  StakeTotalsViewerRpcSchemas,\n} from '@xyo-network/xl1-rpc'\n\nimport { ProducerActor, type ProducerActorParams } from './ProducerActor.ts'\n\ninterface RunProducerContext {\n  config: Config\n  logger: Logger\n  orchestrator: OrchestratorInstance\n}\n\nexport const runProducer = async (context: RunProducerContext) => {\n  const {\n    config, logger, orchestrator,\n  } = context\n\n  const endpoint = assertEx(config.services?.apiEndpoint, () => 'No API endpoint configured')\n  const account = await initProducerAccount({ config, logger })\n  const accountBalanceViewer = new JsonRpcAccountBalanceViewer(new HttpRpcTransport(endpoint, { ...AccountBalanceViewerRpcSchemas }))\n  const blockViewer = new JsonRpcBlockViewer(new HttpRpcTransport(endpoint, { ...BlockViewerRpcSchemas }))\n  const stakeTotalsViewer = new JsonRpcStakeTotalsViewer(new HttpRpcTransport(endpoint, { ...StakeTotalsViewerRpcSchemas }))\n  const chainId = (await blockViewer.currentBlock())[0].chain\n  const mempoolViewer = new JsonRpcMempoolViewer(new HttpRpcTransport(endpoint, { ...MempoolViewerRpcSchemas }))\n  const mempoolRunner = new JsonRpcMempoolRunner(new HttpRpcTransport(endpoint, { ...MempoolRunnerRpcSchemas }))\n  const chainContractViewer = await initChainService({\n    account, config, logger,\n  })\n  const blockRewardViewer = await initBlockRewardViewer({\n    config, logger, chainContractViewer,\n  })\n  const timeSyncViewer = await initTimeService({\n    config, logger, blockViewer,\n  })\n\n  // Create actors\n  const params = {\n    account,\n    id: 'ProducerActor',\n    chainId,\n    config,\n    viewers: {\n      accountBalanceViewer,\n      blockViewer,\n      stakeTotalsViewer,\n      mempoolViewer,\n      time: timeSyncViewer,\n    },\n    blockRewardViewer,\n    runners: { mempoolRunner },\n    logger,\n  } satisfies ProducerActorParams\n  // const apiEndpoint = config.services.apiEndpoint\n  // const balances = isDefined(apiEndpoint) ? undefined : await BalanceActor.create(params)\n  const producer = await ProducerActor.create(params)\n  const actors = [producer].filter(exists)\n\n  for (const actor of actors) {\n  // Register the actor with the orchestrator\n    await orchestrator.registerActor(actor)\n  }\n  // Start the orchestrator => automatically activates the actor\n  await orchestrator.start()\n}\n"],"mappings":"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","names":["asAddress","creatable","isDefined","isUndefined","toHex","ZERO_ADDRESS","Actor","createDeclarationIntent","SimpleBlockRunner","asXL1BlockNumber","buildTransaction","Mutex","SHOULD_REGISTER_REDECLARATION_INTENT_TIMER","TEN_MINUTES","ProducerActor","Actor","_lastProducedBlock","_lastRedeclarationIntent","_metricAttributes","_producerActorBlockProductionAttempts","_producerActorBlockProductionChecks","_producerActorBlocksProduced","_producerActorBlocksPublished","_produceBlockMutex","Mutex","_producer","account","params","accountBalanceViewer","viewers","blockViewer","chainId","config","mempoolRunner","runners","mempoolViewer","producer","stakeTotalsViewer","paramsHandler","name","createHandler","address","toString","meter","createCounter","description","balanceViewer","blockRewardViewer","rewardAddress","asAddress","ZERO_ADDRESS","time","SimpleBlockRunner","create","startHandler","registerTimer","produceBlock","redeclareIntent","add","spanAsync","isLocked","logger","log","runExclusive","headStart","Date","now","head","currentBlock","headDuration","warn","toHex","_hash","headHash","previous","block","nextStart","nextBlock","next","nextDuration","displayBlockNumber","submitBlocks","disableIntentRedeclaration","isUndefined","exp","undefined","validateCurrentBalance","error","validateCurrentStake","chain","id","redeclarationIntent","createDeclarationIntent","RedeclarationDuration","submitRedeclarationIntent","tx","buildTransaction","asXL1BlockNumber","submitTransactions","isDefined","balances","accountBalances","currentBalance","requiredMinimumStake","currentStake","activeByStaked","assertEx","exists","initProducerAccount","initBlockRewardViewer","initChainService","initTimeService","AccountBalanceViewerRpcSchemas","BlockViewerRpcSchemas","HttpRpcTransport","JsonRpcAccountBalanceViewer","JsonRpcBlockViewer","JsonRpcMempoolRunner","JsonRpcMempoolViewer","JsonRpcStakeTotalsViewer","MempoolRunnerRpcSchemas","MempoolViewerRpcSchemas","StakeTotalsViewerRpcSchemas","runProducer","context","config","logger","orchestrator","endpoint","assertEx","services","apiEndpoint","account","initProducerAccount","accountBalanceViewer","JsonRpcAccountBalanceViewer","HttpRpcTransport","AccountBalanceViewerRpcSchemas","blockViewer","JsonRpcBlockViewer","BlockViewerRpcSchemas","stakeTotalsViewer","JsonRpcStakeTotalsViewer","StakeTotalsViewerRpcSchemas","chainId","currentBlock","chain","mempoolViewer","JsonRpcMempoolViewer","MempoolViewerRpcSchemas","mempoolRunner","JsonRpcMempoolRunner","MempoolRunnerRpcSchemas","chainContractViewer","initChainService","blockRewardViewer","initBlockRewardViewer","timeSyncViewer","initTimeService","params","id","viewers","time","runners","producer","ProducerActor","create","actors","filter","exists","actor","registerActor","start"]}

package/dist/node/runProducer.d.ts

@@ -0,0 +1,11 @@
+import { type Logger } from '@xylabs/sdk-js';
+import { type OrchestratorInstance } from '@xyo-network/chain-orchestration';
+import { type Config } from '@xyo-network/xl1-protocol-sdk';
+interface RunProducerContext {
+    config: Config;
+    logger: Logger;
+    orchestrator: OrchestratorInstance;
+}
+export declare const runProducer: (context: RunProducerContext) => Promise<void>;
+export {};
+//# sourceMappingURL=runProducer.d.ts.map

package/dist/node/runProducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runProducer.d.ts","sourceRoot":"","sources":["../../src/runProducer.ts"],"names":[],"mappings":"AAAA,OAAO,EACa,KAAK,MAAM,EAC9B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACiC,KAAK,oBAAoB,EAChE,MAAM,kCAAkC,CAAA;AAIzC,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,+BAA+B,CAAA;AAc3D,UAAU,kBAAkB;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,oBAAoB,CAAA;CACnC;AAED,eAAO,MAAM,WAAW,GAAU,SAAS,kBAAkB,kBAmD5D,CAAA"}

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@xyo-network/chain-producer",
+  "version": "1.17.1",
+  "description": "XYO Layer One Producer",
+  "homepage": "https://xylabs.com",
+  "bugs": {
+    "url": "git+https://github.com/xylabs/xyo-chain/issues",
+    "email": "support@xylabs.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xylabs/xyo-chain.git"
+  },
+  "license": "LGPL-3.0-only",
+  "author": {
+    "name": "XY Labs Development Team",
+    "email": "support@xylabs.com",
+    "url": "https://xylabs.com"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/node/index.d.ts",
+      "source": "./src/index.ts",
+      "default": "./dist/node/index.mjs"
+    },
+    "./package.json": "./package.json",
+    "./README.md": "./README.md"
+  },
+  "module": "./dist/node/index.mjs",
+  "source": "./src/index.ts",
+  "types": "./dist/node/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "!**/*.bench.*",
+    "!**/*.spec.*",
+    "!**/*.test.*"
+  ],
+  "scripts": {
+    "build-tests": "tsc --noEmit --lib dom,esnext",
+    "deploy": "echo Deploy not allowed!",
+    "deploy3": "echo Deploy3 not allowed!",
+    "start": "nodemon",
+    "start-esm": "node ./dist/node/index.mjs",
+    "test": "vitest run",
+    "test:ci": "vitest run",
+    "types": "tsc --noEmit -p tsconfig.test.json"
+  },
+  "dependencies": {
+    "@xylabs/sdk-js": "~5.0.48",
+    "@xyo-network/chain-orchestration": "~1.17.1",
+    "@xyo-network/chain-protocol": "~1.17.1",
+    "@xyo-network/chain-services": "~1.17.1",
+    "@xyo-network/xl1-protocol": "~1.14.16",
+    "@xyo-network/xl1-protocol-sdk": "~1.17.1",
+    "@xyo-network/xl1-rpc": "~1.17.1",
+    "async-mutex": "~0.5.0"
+  },
+  "devDependencies": {
+    "@opentelemetry/api": "~1.9.0",
+    "@types/compression": "~1.8.1",
+    "@types/cors": "~2.8.19",
+    "@types/express": "5.0.6",
+    "@types/express-serve-static-core": "~5.1.0",
+    "@types/node": "~24.10.1",
+    "@xylabs/sdk-js": "~5.0.48",
+    "@xylabs/ts-scripts-yarn3": "~7.2.8",
+    "@xylabs/tsconfig": "~7.2.8",
+    "@xyo-network/account": "~5.2.13",
+    "@xyo-network/account-model": "~5.2.13",
+    "@xyo-network/archivist-abstract": "~5.2.13",
+    "@xyo-network/bios-model": "~7.2.0",
+    "@xyo-network/boundwitness-builder": "~5.2.13",
+    "@xyo-network/chain-services": "~1.17.1",
+    "@xyo-network/module-abstract-mongodb": "~5.2.13",
+    "@xyo-network/module-model-mongodb": "~5.2.13",
+    "@xyo-network/node-memory": "~5.2.13",
+    "@xyo-network/xl1-protocol": "~1.14.16",
+    "dotenv": "~17.2.3",
+    "eslint": "^9.39.1",
+    "nodemon": "~3.1.11",
+    "tslib": "~2.8.1",
+    "typescript": "~5.9.3",
+    "vitest": "~4.0.15",
+    "vitest-mock-extended": "~3.1.0"
+  },
+  "engines": {
+    "node": ">=22.3 <23"
+  },
+  "engineStrict": true,
+  "publishConfig": {
+    "access": "restricted"
+  }
+}

package/src/ProducerActor.ts

@@ -0,0 +1,327 @@
+import type { Attributes, Counter } from '@opentelemetry/api'
+import type { CreatableName } from '@xylabs/sdk-js'
+import {
+  asAddress,
+  creatable, isDefined, isUndefined, toHex,
+  ZERO_ADDRESS,
+} from '@xylabs/sdk-js'
+import { AccountInstance } from '@xyo-network/account-model'
+import { Actor, type ActorParams } from '@xyo-network/chain-orchestration'
+import { createDeclarationIntent } from '@xyo-network/chain-protocol'
+import { SimpleBlockRunner, SimpleBlockRunnerParams } from '@xyo-network/chain-services'
+import type {
+  ChainId,
+  ChainStakeIntent, HydratedBlockWithHashMeta,
+  XL1BlockNumber,
+} from '@xyo-network/xl1-protocol'
+import { asXL1BlockNumber } from '@xyo-network/xl1-protocol'
+import {
+  AccountBalanceViewer,
+  BlockProducerService, BlockRewardViewer, BlockViewer, buildTransaction,
+  Config,
+  MempoolRunner,
+  MempoolViewer,
+  StakeTotalsViewer,
+  TimeSyncViewer,
+} from '@xyo-network/xl1-protocol-sdk'
+import { Mutex } from 'async-mutex'
+
+export type ProducerActorParams = ActorParams<{
+  account: AccountInstance
+  blockRewardViewer: BlockRewardViewer
+  chainId: ChainId
+  config: Config
+  runners: {
+    mempoolRunner: MempoolRunner
+  }
+  viewers: {
+    accountBalanceViewer: AccountBalanceViewer
+    blockViewer: BlockViewer
+    mempoolViewer: MempoolViewer
+    stakeTotalsViewer: StakeTotalsViewer
+    time: TimeSyncViewer
+  }
+}>
+
+const SHOULD_REGISTER_REDECLARATION_INTENT_TIMER = true
+const TEN_MINUTES = 10 * 60 * 1000 // 10 minutes in milliseconds
+
+@creatable()
+export class ProducerActor extends Actor<ProducerActorParams> {
+  protected _lastProducedBlock: HydratedBlockWithHashMeta | undefined
+  protected _lastRedeclarationIntent: ChainStakeIntent | undefined
+  protected _metricAttributes: Attributes | undefined
+  protected _producerActorBlockProductionAttempts: Counter<Attributes> | undefined
+  protected _producerActorBlockProductionChecks: Counter<Attributes> | undefined
+  protected _producerActorBlocksProduced: Counter<Attributes> | undefined
+  protected _producerActorBlocksPublished: Counter<Attributes> | undefined
+
+  private _produceBlockMutex = new Mutex()
+  private _producer: BlockProducerService | undefined
+
+  protected get account() {
+    return this.params.account!
+  }
+
+  protected get accountBalanceViewer() {
+    return this.params.viewers.accountBalanceViewer!
+  }
+
+  protected get blockViewer() {
+    return this.params.viewers.blockViewer!
+  }
+
+  protected get chainId() {
+    return this.params.chainId!
+  }
+
+  protected get config() {
+    return this.params.config!
+  }
+
+  protected get mempoolRunner() {
+    return this.params.runners.mempoolRunner!
+  }
+
+  protected get mempoolViewer() {
+    return this.params.viewers.mempoolViewer!
+  }
+
+  protected get producer() {
+    return this._producer!
+  }
+
+  protected get stakeTotalsViewer() {
+    return this.params.viewers.stakeTotalsViewer!
+  }
+
+  static override async paramsHandler<T extends ActorParams>(params?: Partial<T>) {
+    return await super.paramsHandler({ ...params, name: (params?.name ?? 'Producer') as CreatableName })
+  }
+
+  override async createHandler() {
+    await super.createHandler()
+    // Create the consistent meter attributes that will
+    // be included with all metrics from this actor
+    this._metricAttributes = { address: this.account.address.toString() }
+    // Create the metrics
+    this._producerActorBlockProductionChecks = this.meter?.createCounter(
+      'producer_actor_block_production_checks',
+      { description: 'Number of block production checks' },
+    )
+    this._producerActorBlockProductionAttempts = this.meter?.createCounter(
+      'producer_actor_block_production_attempts',
+      { description: 'Number of block production attempts' },
+    )
+    this._producerActorBlocksProduced = this.meter?.createCounter(
+      'producer_actor_blocks_produced',
+      { description: 'Number of blocks produced' },
+    )
+    this._producerActorBlocksPublished = this.meter?.createCounter(
+      'producer_actor_blocks_published',
+      { description: 'Number of blocks published' },
+    )
+    const params = {
+      account: this.account,
+      balanceViewer: this.accountBalanceViewer,
+      config: this.config,
+      chainId: this.chainId,
+      mempoolRunner: this.mempoolRunner,
+      mempoolViewer: this.mempoolViewer,
+      blockRewardViewer: this.params.blockRewardViewer!,
+      rewardAddress: asAddress(
+        this.config.producer.rewardAddress ?? ZERO_ADDRESS,
+        () => `Producer config must have a valid reward address configured [${this.params.config.producer.rewardAddress}]`,
+      ),
+      time: this.params.viewers.time!,
+    } satisfies SimpleBlockRunnerParams
+    this._producer = await SimpleBlockRunner.create(params)
+  }
+
+  override async startHandler() {
+    await super.startHandler()
+    // Register a timer to check if we should produce a block
+    this.registerTimer('BlockProductionTimer', async () => {
+      await this.produceBlock()
+    }, 2000, 1500/* 500 */)
+
+    if (SHOULD_REGISTER_REDECLARATION_INTENT_TIMER) {
+      // Register a timer to check if we should redeclare the producer
+      this.registerTimer('ProducerRedeclarationTimer', async () => {
+        await this.redeclareIntent()
+      }, TEN_MINUTES, TEN_MINUTES)
+    }
+  }
+
+  // protected async calculateBlocksUntilProducerDeclarationExpiration(currentBlock: number): Promise<number> {
+  //   // Decide if we need to redeclare intent
+  //   const ranges = await this.stakeIntentService.getDeclaredCandidateRanges(this.account.address, 'producer')
+  //   // TODO: This doesn't handle the case where the producer had declared a range for the future
+  //   // but we're in a range that's not the future
+  //   // Sort in ascending order based on ending range to get range with highest ending block
+  //   const lastRange = ranges.toSorted((a, b) => a[1] > b[1] ? 1 : -1).at(-1)
+
+  //   // Use the most recent range's end block as the current declaration end OR
+  //   const [, currentDeclarationEnd] = lastRange
+  //   // If we have no ranges, we need to declare intent, so use the current block
+  //     ?? [undefined, currentBlock]
+
+  //   // Calculate the time until the producer's declaration expires
+  //   const timeToProducerExpiration = currentDeclarationEnd - currentBlock
+  //   return timeToProducerExpiration
+  // }
+
+  protected async produceBlock(): Promise<void> {
+    this._producerActorBlockProductionChecks?.add(1, this._metricAttributes)
+    await this.spanAsync('produceBlock', async () => {
+      if (this._produceBlockMutex.isLocked()) {
+        this.logger?.log('Skipping block production, previous production still in progress')
+        return
+      }
+
+      await this._produceBlockMutex.runExclusive(async () => {
+      // Get the updated head
+        const headStart = Date.now()
+        const head = (await this.blockViewer.currentBlock())[0]
+        const headDuration = Date.now() - headStart
+        if (headDuration > 500) this.logger?.warn(`[Slow] Fetched head in ${headDuration}ms: 0x${toHex(head._hash)}`)
+        // Check if we've already produced the next block for this head
+        const headHash = head._hash
+        // If our last produced block was the next block for the current head, we do not
+        // need to produce another. This prevents duplicate blocks from being produced
+        if (this._lastProducedBlock && this._lastProducedBlock[0].previous === headHash) {
+          this.logger?.log('Block already produced:', `0x${toHex(this._lastProducedBlock[0].block)}`, this._lastProducedBlock[0].block)
+        } else {
+          this._producerActorBlockProductionAttempts?.add(1, this._metricAttributes)
+          // Produce the next block
+          const nextStart = Date.now()
+          const nextBlock = await this.producer.next(head)
+          const nextDuration = Date.now() - nextStart
+          if (nextDuration > 1000) this.logger?.warn(`[Slow] Generated next block in ${nextDuration}ms, block: ${nextBlock?.[0]._hash}`)
+          // If it was produced
+          if (nextBlock) {
+            const displayBlockNumber = `0x${toHex(nextBlock[0].block)}`
+            this.logger?.log('Produced block:', displayBlockNumber)
+            this._producerActorBlocksProduced?.add(1, this._metricAttributes)
+            // Insert the block into the chain
+            await this.mempoolRunner.submitBlocks([nextBlock])
+            this.logger?.log('Published block:', displayBlockNumber, nextBlock[0].block)
+            this._producerActorBlocksPublished?.add(1, this._metricAttributes)
+            // Record that we have produced a block so we do not produce it again
+            this._lastProducedBlock = nextBlock
+          }
+        }
+      })
+    })
+  }
+
+  protected async redeclareIntent(): Promise<void> {
+    await this.spanAsync('redeclareIntent', async () => {
+      // Decide if we should redeclare intent
+      if (this.params.config.producer.disableIntentRedeclaration) return
+
+      // Get the current block
+      const head = (await this.blockViewer.currentBlock())[0]
+      if (isUndefined(head)) return
+      const currentBlock = head.block
+
+      // // Calculate the time until the producer's declaration expires
+      // const blocksUntilExpiration = await this.calculateBlocksUntilProducerDeclarationExpiration(currentBlock)
+
+      // // Allow the producer time to redeclare itself via block production
+      // // (for free) before submitting a redeclaration intent transaction.
+      // if (blocksUntilExpiration > BaseBlockProducerService.RedeclarationWindow * 0.1) {
+      //   // Clear any previous redeclaration intent
+      //   this._lastRedeclarationIntent = undefined
+      //   // No need to redeclare yet
+      //   return
+      // }
+
+      // If we already have a valid redeclaration intent, do not create another
+      // unless it has expired.
+      if (this._lastRedeclarationIntent) {
+        // Check if the last redeclaration intent is still valid
+        if (this._lastRedeclarationIntent.exp > currentBlock) return
+        // If it has expired, clear the last redeclaration intent
+        this._lastRedeclarationIntent = undefined
+      }
+
+      // Check if we have a valid balance before declaring intent
+      if (!await this.validateCurrentBalance()) {
+        this.logger?.error(
+          `Add balance to address ${this.account.address} for the producer to declare it's intent.`,
+        )
+        return
+      }
+
+      // Check if we have a valid stake before declaring intent
+      if (!(await this.validateCurrentStake())) {
+        this.logger?.error(
+          `Add stake to contract address ${this.params.config.chain.id}`
+          + ' for the producer to declare it\'s intent.',
+        )
+        return
+      }
+
+      // Create a redeclaration intent
+      this.logger?.log('Creating redeclaration intent for producer:', this.account.address)
+      const redeclarationIntent = createDeclarationIntent(
+        this.account.address,
+        'producer',
+        currentBlock,
+        currentBlock + SimpleBlockRunner.RedeclarationDuration,
+      )
+
+      // Submit the redeclaration intent
+      await this.submitRedeclarationIntent(currentBlock, redeclarationIntent)
+
+      // On successful submission, save the redeclaration intent
+      this._lastRedeclarationIntent = redeclarationIntent
+    })
+  }
+
+  protected async submitRedeclarationIntent(currentBlock: XL1BlockNumber, redeclarationIntent: ChainStakeIntent): Promise<void> {
+    this.logger?.log('Submitting redeclaration intent for producer:', this.account.address)
+    // Create a transaction to submit the redeclaration intent
+    const tx = await buildTransaction(
+      this.chainId,
+      [redeclarationIntent],
+      [],
+      this.account,
+      currentBlock,
+      asXL1BlockNumber(currentBlock + 1000, true),
+    )
+
+    // Submit the redeclaration intent
+    await this.mempoolRunner.submitTransactions([tx])
+
+    this.logger?.log('Submitted redeclaration intent for producer:', this.account.address)
+  }
+
+  protected async validateCurrentBalance(): Promise<boolean> {
+    // Check if we have a valid balance before declaring intent
+    const head = this._lastProducedBlock?.[0]._hash
+    if (isDefined(head)) {
+      const balances = await this.accountBalanceViewer.accountBalances([this.account.address], head)
+      const currentBalance = balances[this.account.address] ?? 0n
+      if (currentBalance <= 0n) {
+        this.logger?.error(`Producer ${this.account.address} has no balance.`)
+        return false
+      }
+      return true
+    }
+    return true
+  }
+
+  protected async validateCurrentStake(): Promise<boolean> {
+    // Use StakeIntentService to get the required minimum stake
+    const requiredMinimumStake = 1n // this.stakeIntentService.getRequiredMinimumStakeForIntent('producer')
+    // Check if we have a valid stake before declaring intent
+    const currentStake = await this.stakeTotalsViewer.activeByStaked(this.account.address)
+    if (currentStake < requiredMinimumStake) {
+      this.logger?.error(`Producer ${this.account.address} has insufficient stake.`)
+      return false
+    }
+    return true
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './ProducerActor.ts'
+export * from './runProducer.ts'

package/src/runProducer.ts

@@ -0,0 +1,81 @@
+import {
+  assertEx, exists, type Logger,
+} from '@xylabs/sdk-js'
+import {
+  initProducerAccount, initStakeViewer, type OrchestratorInstance,
+} from '@xyo-network/chain-orchestration'
+import {
+  initBlockRewardViewer, initChainService, initTimeService,
+} from '@xyo-network/chain-services'
+import { type Config } from '@xyo-network/xl1-protocol-sdk'
+import {
+  AccountBalanceViewerRpcSchemas, BlockViewerRpcSchemas, HttpRpcTransport, JsonRpcAccountBalanceViewer,
+  JsonRpcBlockViewer,
+  JsonRpcMempoolRunner,
+  JsonRpcMempoolViewer,
+  JsonRpcStakeTotalsViewer,
+  MempoolRunnerRpcSchemas,
+  MempoolViewerRpcSchemas,
+  StakeTotalsViewerRpcSchemas,
+} from '@xyo-network/xl1-rpc'
+
+import { ProducerActor, type ProducerActorParams } from './ProducerActor.ts'
+
+interface RunProducerContext {
+  config: Config
+  logger: Logger
+  orchestrator: OrchestratorInstance
+}
+
+export const runProducer = async (context: RunProducerContext) => {
+  const {
+    config, logger, orchestrator,
+  } = context
+
+  const endpoint = assertEx(config.services?.apiEndpoint, () => 'No API endpoint configured')
+  const account = await initProducerAccount({ config, logger })
+  const accountBalanceViewer = new JsonRpcAccountBalanceViewer(new HttpRpcTransport(endpoint, { ...AccountBalanceViewerRpcSchemas }))
+  const blockViewer = new JsonRpcBlockViewer(new HttpRpcTransport(endpoint, { ...BlockViewerRpcSchemas }))
+  const stakeTotalsViewer = new JsonRpcStakeTotalsViewer(new HttpRpcTransport(endpoint, { ...StakeTotalsViewerRpcSchemas }))
+  const chainId = (await blockViewer.currentBlock())[0].chain
+  const mempoolViewer = new JsonRpcMempoolViewer(new HttpRpcTransport(endpoint, { ...MempoolViewerRpcSchemas }))
+  const mempoolRunner = new JsonRpcMempoolRunner(new HttpRpcTransport(endpoint, { ...MempoolRunnerRpcSchemas }))
+  const chainContractViewer = await initChainService({
+    account, config, logger,
+  })
+  const blockRewardViewer = await initBlockRewardViewer({
+    config, logger, chainContractViewer,
+  })
+  const timeSyncViewer = await initTimeService({
+    config, logger, blockViewer,
+  })
+
+  // Create actors
+  const params = {
+    account,
+    id: 'ProducerActor',
+    chainId,
+    config,
+    viewers: {
+      accountBalanceViewer,
+      blockViewer,
+      stakeTotalsViewer,
+      mempoolViewer,
+      time: timeSyncViewer,
+    },
+    blockRewardViewer,
+    runners: { mempoolRunner },
+    logger,
+  } satisfies ProducerActorParams
+  // const apiEndpoint = config.services.apiEndpoint
+  // const balances = isDefined(apiEndpoint) ? undefined : await BalanceActor.create(params)
+  const producer = await ProducerActor.create(params)
+  const actors = [producer].filter(exists)
+
+  for (const actor of actors) {
+  // Register the actor with the orchestrator
+    await orchestrator.registerActor(actor)
+  }
+  // Start the orchestrator => automatically activates the actor
+  await orchestrator.start()
+}