@xyo-network/chain-orchestration 1.20.29 → 1.21.2

package/dist/node/index.mjs

@@ -1,15 +1,26 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
-// src/shared/actor/FinalizerActor.ts
-import { creatable } from "@xylabs/sdk-js";
-import { processPendingBlocks } from "@xyo-network/chain-sdk";
-import { BlockValidationViewerMoniker, BlockViewerMoniker, DeadLetterQueueRunnerMoniker, FinalizationRunnerMoniker, MempoolViewerMoniker } from "@xyo-network/xl1-sdk";
-
 // src/shared/actor/v3/ActorV3.ts
 import { AbstractCreatable, assertEx, delay, IdLogger } from "@xylabs/sdk-js";
 import { Semaphore } from "async-mutex";
 import z from "zod";
+var noopCounter = {
+  add: /* @__PURE__ */ __name(() => {
+  }, "add")
+};
+var noopUpDownCounter = {
+  add: /* @__PURE__ */ __name(() => {
+  }, "add")
+};
+var noopGauge = {
+  record: /* @__PURE__ */ __name(() => {
+  }, "record")
+};
+var noopHistogram = {
+  record: /* @__PURE__ */ __name(() => {
+  }, "record")
+};
 var CreatableNameZod = z.custom((val) => typeof val === "string" && val.length > 0);
 var StatusReporterInstanceZod = z.custom((val) => val !== null && typeof val === "object" && "report" in val);
 var AccountInstanceZod = z.custom((val) => val !== null && typeof val === "object" && "address" in val);
@@ -185,12 +196,44 @@ var ActorV3 = class extends AbstractCreatable {
     }
   }
   /**
+  * Create a `Counter` instrument bound to this actor's meter, or a no-op
+  * stub if telemetry is not wired. Always returns a non-undefined value so
+  * call sites can drop the optional-chain on `.add()`.
+  *
+  * TODO: in a future pass, consider folding these single-instrument helpers
+  * into a declarative `createActorMeters({ counters: {...}, gauges: {...} })`
+  * spec API for actors with many instruments.
+  */
+  counter(name, description) {
+    return this.meter?.createCounter(name, {
+      description
+    }) ?? noopCounter;
+  }
+  /** Create a synchronous `Gauge` instrument, or a no-op stub if telemetry is not wired. */
+  gauge(name, description) {
+    return this.meter?.createGauge(name, {
+      description
+    }) ?? noopGauge;
+  }
+  /** Create a `Histogram` instrument, or a no-op stub if telemetry is not wired. */
+  histogram(name, description) {
+    return this.meter?.createHistogram(name, {
+      description
+    }) ?? noopHistogram;
+  }
+  /**
   * Override in subclasses to prove the actor can do useful work.
   * Default: no-op (the actor declares itself ready as soon as `start()` returns).
   */
   // eslint-disable-next-line @typescript-eslint/no-empty-function
   async readyHandler() {
   }
+  /** Create an `UpDownCounter` instrument, or a no-op stub if telemetry is not wired. */
+  upDownCounter(name, description) {
+    return this.meter?.createUpDownCounter(name, {
+      description
+    }) ?? noopUpDownCounter;
+  }
 };
 var Actor = class extends ActorV3 {
   static {
@@ -198,94 +241,6 @@ var Actor = class extends ActorV3 {
   }
 };
 
-// src/shared/actor/FinalizerActor.ts
-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 FinalizerActor = class extends ActorV3 {
-  static {
-    __name(this, "FinalizerActor");
-  }
-  static needs = {
-    required: [
-      BlockValidationViewerMoniker,
-      BlockViewerMoniker,
-      FinalizationRunnerMoniker,
-      MempoolViewerMoniker
-    ],
-    optional: [
-      DeadLetterQueueRunnerMoniker
-    ]
-  };
-  _blockValidationViewer;
-  _blockViewer;
-  _deadLetterQueueRunner;
-  _finalizationRunner;
-  _mempoolViewer;
-  get allowedProducers() {
-    return this.params.config.allowedProducers ?? [];
-  }
-  get blockValidationViewer() {
-    return this._blockValidationViewer;
-  }
-  get blockViewer() {
-    return this._blockViewer;
-  }
-  get finalizationRunner() {
-    return this._finalizationRunner;
-  }
-  get mempoolViewer() {
-    return this._mempoolViewer;
-  }
-  get minCandidates() {
-    return this.params.config.minCandidates;
-  }
-  async createHandler() {
-    await super.startHandler();
-    this._blockValidationViewer = await this.locator.getInstance(BlockValidationViewerMoniker);
-    this._blockViewer = await this.locator.getInstance(BlockViewerMoniker);
-    this._finalizationRunner = await this.locator.getInstance(FinalizationRunnerMoniker);
-    this._mempoolViewer = await this.locator.getInstance(MempoolViewerMoniker);
-    this._deadLetterQueueRunner = await this.locator.tryGetInstance(DeadLetterQueueRunnerMoniker);
-  }
-  async startHandler() {
-    await super.startHandler();
-    const interval = this.params.config.finalizationCheckInterval ?? 500;
-    this.registerTimer("FinalizerActor", async () => {
-      await this.runFinalizationPass();
-    }, 2e3, interval);
-  }
-  async readyHandler() {
-    await this.runFinalizationPass();
-  }
-  async runFinalizationPass() {
-    await this.spanAsync("processPendingBlocks", async () => {
-      this.logger?.debug("FinalizerActor: Processing pending blocks...");
-      await processPendingBlocks({
-        blockValidationViewer: this.blockValidationViewer,
-        context: this.context,
-        logger: this.logger,
-        mempoolViewer: this.mempoolViewer,
-        blockViewer: this.blockViewer,
-        finalizationRunner: this.finalizationRunner,
-        allowedProducers: this.allowedProducers,
-        minCandidates: this.minCandidates,
-        deadLetterQueueRunner: this._deadLetterQueueRunner
-      });
-    }, {
-      ...this.context,
-      timeBudgetLimit: 1500
-    });
-  }
-};
-FinalizerActor = _ts_decorate([
-  creatable()
-], FinalizerActor);
-
 // src/shared/buildTelemetryConfig.ts
 function buildTelemetryConfig(config, serviceName, serviceVersion, defaultMetricsScrapePort = 9464) {
   const { otlpEndpoint } = config.telemetry?.otel ?? {};
@@ -318,6 +273,46 @@ var ApiConfigZod = HostActorConfigZod.extend(z2.object({
     description: "Whether to initialize the rewards cache on startup",
     title: "api.initRewardsCache",
     type: "boolean"
+  }),
+  /**
+  * When `true`, the API actor runs in stateless mode: it holds no local
+  * backing-store ownership, never loads the local LMDB/MongoDB node, and
+  * federates every JSON-RPC request to upstream owner-actors via `JsonRpc*`
+  * providers. Multiple stateless API instances can run behind a load
+  * balancer for horizontal scaling. Requires `remote.rpc` to point at the
+  * upstream API/Finalizer/Mempool/Indexer surfaces.
+  */
+  stateless: z2.union([
+    z2.number(),
+    z2.string(),
+    z2.boolean()
+  ]).transform((v) => v === "1" || v === "true" || v === true || v == 1).default(false).register(globalRegistry, {
+    description: "Run the API actor as a stateless federation node (availableBackings: [network])",
+    title: "api.stateless",
+    type: "boolean"
+  }),
+  /**
+  * Back-compat for the surface-aware route split. When `true`, `POST /rpc`
+  * serves the full `XyoConnection` (both node-surface and indexed-surface
+  * methods), preserving pre-Phase-7 behavior for clients that haven't yet
+  * migrated to `POST /rpc/indexed`. When `false`, `/rpc` is strictly
+  * node-surface only and indexed methods are 404 at `/rpc`.
+  *
+  * `/rpc/indexed` mounts independently of this flag whenever the locator's
+  * connection has any indexed branch.
+  *
+  * Default `true` for the first release that includes Phase 7 — flip to
+  * `false` per environment once external clients (explorers, wallets, dApps)
+  * have moved their indexed-method calls to `/rpc/indexed`.
+  */
+  legacyMixedRpc: z2.union([
+    z2.number(),
+    z2.string(),
+    z2.boolean()
+  ]).transform((v) => v !== "0" && v !== "false" && v !== false && v != 0).default(true).register(globalRegistry, {
+    description: "Serve the full XyoConnection at POST /rpc (no surface filter). Set false to enforce node-surface-only at /rpc; indexed methods always available at /rpc/indexed regardless.",
+    title: "api.legacyMixedRpc",
+    type: "boolean"
   })
 }).shape);
 var isApiConfig = zodIsFactory(ApiConfigZod);
@@ -342,6 +337,7 @@ var DEFAULT_HARDHAT_REMOTE_CHAIN_WALLET_PRIVATE_KEY = toHex("0xac0974bec39a17e36
 var DEFAULT_HARDHAT_TOKEN_CONTRACT = toAddress("5FbDB2315678afecb367f032d93F642f64180aa3");
 var DEFAULT_MAX_BRIDGE_AMOUNT = toHex(XL1(1000000n) * AttoXL1ConvertFactor.xl1);
 var DEFAULT_MIN_BRIDGE_AMOUNT = toHex(XL1(1500n) * AttoXL1ConvertFactor.xl1);
+var DEFAULT_SCANNER_INTERVAL_MS = 3e4;
 var BasisPointsZod = z3.coerce.number().int().nonnegative().max(1e4);
 var BridgeConfigZod = HostActorConfigZod2.extend({
   escrowAddress: AddressZod.optional().register(globalRegistry2, {
@@ -390,6 +386,12 @@ var BridgeConfigZod = HostActorConfigZod2.extend({
     title: "bridge.redisPort",
     type: "number"
   }),
+  scannerIntervalMs: z3.coerce.number().int().positive().default(DEFAULT_SCANNER_INTERVAL_MS).register(globalRegistry2, {
+    default: DEFAULT_SCANNER_INTERVAL_MS,
+    description: "How often (ms) the EVM->XL1 scanner polls the remote bridge contract for new BridgedToRemote ids confirmed at depth.",
+    title: "bridge.scannerIntervalMs",
+    type: "number"
+  }),
   remoteBridgeContractAddress: AddressZod.default(DEFAULT_HARDHAT_BRIDGE_CONTRACT).register(globalRegistry2, {
     default: DEFAULT_HARDHAT_BRIDGE_CONTRACT,
     description: "Hex representation of remote token address used for bridging",
@@ -402,6 +404,14 @@ var BridgeConfigZod = HostActorConfigZod2.extend({
     title: "bridge.remoteChainId",
     type: "string"
   }),
+  remoteConfirmationDepth: z3.union([
+    z3.coerce.number().int().nonnegative(),
+    z3.literal("finalized")
+  ]).optional().register(globalRegistry2, {
+    description: "Block depth or BlockTag at which the remote (EVM) chain is read as canonical. Numeric: number of confirmations behind head. 'finalized': Casper FFG finalized block. Resolved per-chain by getRemoteConfirmationDepth when unset.",
+    title: "bridge.remoteConfirmationDepth",
+    type: "string"
+  }),
   remoteTokenAddress: HexZod.default(DEFAULT_HARDHAT_TOKEN_CONTRACT).register(globalRegistry2, {
     default: DEFAULT_HARDHAT_TOKEN_CONTRACT,
     description: "Hex representation of remote token address used for bridging",
@@ -653,8 +663,8 @@ var ServiceLifetime = {
   Transient: "Transient"
 };
 
-// src/shared/init/initActorAccount.ts
-import { isDefined } from "@xylabs/sdk-js";
+// src/shared/init/initActorSeedPhrase.ts
+import { assertEx as assertEx2, isString } from "@xylabs/sdk-js";
 
 // src/shared/init/walletResolution.ts
 import { HDWallet } from "@xyo-network/sdk-js";
@@ -962,21 +972,7 @@ async function resolveWalletForActor(actorName, accountPath) {
 }
 __name(resolveWalletForActor, "resolveWalletForActor");
 
-// src/shared/init/initActorAccount.ts
-var actorAccountSingletons = {};
-async function initActorAccount({ config, logger }) {
-  const actorName = config.name;
-  if (isDefined(actorAccountSingletons[actorName])) return actorAccountSingletons[actorName];
-  const accountPath = typeof config.accountPath === "string" ? config.accountPath : void 0;
-  const account = await resolveWalletForActor(actorName, accountPath);
-  logger?.debug(`[${actorName}] Using wallet address ${account.address}`);
-  actorAccountSingletons[actorName] = account;
-  return actorAccountSingletons[actorName];
-}
-__name(initActorAccount, "initActorAccount");
-
 // src/shared/init/initActorSeedPhrase.ts
-import { assertEx as assertEx2, isString } from "@xylabs/sdk-js";
 async function initActorSeedPhrase(context, bios) {
   const { logger, config } = context;
   const walletKind = config.name;
@@ -1039,22 +1035,28 @@ function initStatusReporter({ logger }) {
 __name(initStatusReporter, "initStatusReporter");
 
 // src/shared/init/initWallet.ts
+import { isDefined } from "@xylabs/sdk-js";
+var actorAccountSingletons = {};
 async function initActorWallet(context) {
   const actorName = context.config.name;
+  if (isDefined(actorAccountSingletons[actorName])) return actorAccountSingletons[actorName];
   const accountPath = typeof context.config.accountPath === "string" ? context.config.accountPath : void 0;
-  return await resolveWalletForActor(actorName, accountPath);
+  const account = await resolveWalletForActor(actorName, accountPath);
+  context.logger?.debug(`[${actorName}] Using wallet address ${account.address}`);
+  actorAccountSingletons[actorName] = account;
+  return actorAccountSingletons[actorName];
 }
 __name(initActorWallet, "initActorWallet");
 
 // src/shared/orchestrator/Orchestrator.ts
-import { AbstractCreatable as AbstractCreatable2, creatable as creatable2 } from "@xylabs/sdk-js";
-function _ts_decorate2(decorators, target, key, desc) {
+import { AbstractCreatable as AbstractCreatable2, creatable } from "@xylabs/sdk-js";
+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_decorate2, "_ts_decorate");
+__name(_ts_decorate, "_ts_decorate");
 var Orchestrator = class extends AbstractCreatable2 {
   static {
     __name(this, "Orchestrator");
@@ -1163,8 +1165,8 @@ var Orchestrator = class extends AbstractCreatable2 {
     }
   }
 };
-Orchestrator = _ts_decorate2([
-  creatable2()
+Orchestrator = _ts_decorate([
+  creatable()
 ], Orchestrator);
 function isLocalActor(actor) {
   return actor instanceof ActorV3;
@@ -1180,13 +1182,13 @@ __name(formatError, "formatError");
 // src/shared/provider/SimpleRejectedTransactionsArchivistProvider.ts
 import { assertEx as assertEx4 } from "@xylabs/sdk-js";
 import { AbstractCreatableProvider, creatableProvider } from "@xyo-network/xl1-sdk";
-function _ts_decorate3(decorators, target, key, desc) {
+function _ts_decorate2(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_decorate3, "_ts_decorate");
+__name(_ts_decorate2, "_ts_decorate");
 var RejectedTransactionsArchivistProviderMoniker = "RejectedTransactionsArchivistProvider";
 var SimpleRejectedTransactionsArchivistProvider = class _SimpleRejectedTransactionsArchivistProvider extends AbstractCreatableProvider {
   static {
@@ -1208,156 +1210,147 @@ var SimpleRejectedTransactionsArchivistProvider = class _SimpleRejectedTransacti
     };
   }
 };
-SimpleRejectedTransactionsArchivistProvider = _ts_decorate3([
+SimpleRejectedTransactionsArchivistProvider = _ts_decorate2([
   creatableProvider()
 ], SimpleRejectedTransactionsArchivistProvider);
 
+// src/node/config/capabilities/Backing.ts
+import { backingsSatisfied, unmetBackings } from "@xyo-network/xl1-protocol-sdk";
+
 // src/node/config/capabilities/Capability.ts
-var CapabilityRegistry = class CapabilityRegistry2 {
-  static {
-    __name(this, "CapabilityRegistry");
-  }
-  _entries = /* @__PURE__ */ new Map();
-  get(id) {
-    const cap = this._entries.get(id);
-    if (!cap) throw new Error(`Capability not found: ${id}`);
-    return cap;
-  }
-  register(cap) {
-    if (this._entries.has(cap.id)) {
-      throw new Error(`Capability already registered: ${cap.id}`);
-    }
-    this._entries.set(cap.id, cap);
-    return this;
-  }
-  toJson() {
-    const result = {};
-    for (const [id, cap] of this._entries.entries()) {
-      const { id: _, ...rest } = cap;
-      result[id] = rest;
-    }
-    return result;
-  }
-  tryGet(id) {
-    return this._entries.get(id);
-  }
-};
-function createCapabilityRegistry() {
-  return new CapabilityRegistry();
-}
-__name(createCapabilityRegistry, "createCapabilityRegistry");
+import { createCapabilityRegistry } from "@xyo-network/xl1-protocol-sdk";
 
 // src/node/config/capabilities/defaultCapabilityRegistry.ts
-import { AccountBalanceViewerMoniker, BlockRunnerMoniker, BlockValidationViewerMoniker as BlockValidationViewerMoniker2, BlockViewerMoniker as BlockViewerMoniker2, ChainContractViewerMoniker, DeadLetterQueueRunnerMoniker as DeadLetterQueueRunnerMoniker2, DeadLetterQueueViewerMoniker, FinalizationRunnerMoniker as FinalizationRunnerMoniker2, FinalizationViewerMoniker, MempoolRunnerMoniker, MempoolViewerMoniker as MempoolViewerMoniker2, StakeTotalsViewerMoniker, TimeSyncViewerMoniker, TransactionValidationViewerMoniker, TransactionViewerMoniker, WindowedBlockViewerMoniker, XyoViewerMoniker } from "@xyo-network/xl1-sdk";
+import { AccountBalanceViewerMoniker, BlockRunnerMoniker, BlockValidationViewerMoniker, BlockViewerMoniker, ChainContractViewerMoniker, DeadLetterQueueRunnerMoniker, DeadLetterQueueViewerMoniker, FinalizationRunnerMoniker, FinalizationViewerMoniker, MempoolRunnerMoniker, MempoolViewerMoniker, StakeTotalsViewerMoniker, TimeSyncViewerMoniker, TransactionValidationViewerMoniker, TransactionViewerMoniker, WindowedBlockViewerMoniker, XyoViewerMoniker } from "@xyo-network/xl1-sdk";
 var XyoConnectionMoniker = "XyoConnection";
 var XyoGatewayRunnerMoniker = "XyoGatewayRunner";
 var capabilities = [
   {
-    id: BlockViewerMoniker2,
+    id: BlockViewerMoniker,
     label: "Block viewer",
-    kind: "viewer"
+    kind: "viewer",
+    surface: "node"
   },
   {
     id: WindowedBlockViewerMoniker,
     label: "Windowed block viewer",
-    kind: "viewer"
+    kind: "viewer",
+    surface: "node"
   },
   {
-    id: MempoolViewerMoniker2,
+    id: MempoolViewerMoniker,
     label: "Mempool viewer",
-    kind: "viewer"
+    kind: "viewer",
+    surface: "node"
   },
   {
     id: MempoolRunnerMoniker,
     label: "Mempool runner",
-    kind: "runner"
+    kind: "runner",
+    surface: "node"
   },
   {
     id: AccountBalanceViewerMoniker,
     label: "Account balance viewer",
-    kind: "viewer"
+    kind: "viewer",
+    surface: "node"
   },
   {
     id: FinalizationViewerMoniker,
     label: "Finalization viewer",
-    kind: "viewer"
+    kind: "viewer",
+    surface: "node"
   },
   {
-    id: FinalizationRunnerMoniker2,
+    id: FinalizationRunnerMoniker,
     label: "Finalization runner",
-    kind: "runner"
+    kind: "runner",
+    surface: "node"
   },
   {
     id: TransactionViewerMoniker,
     label: "Transaction viewer",
-    kind: "viewer"
+    kind: "viewer",
+    surface: "node"
   },
   {
-    id: BlockValidationViewerMoniker2,
+    id: BlockValidationViewerMoniker,
     label: "Block validation viewer",
-    kind: "viewer"
+    kind: "viewer",
+    surface: "node"
   },
   {
     id: TransactionValidationViewerMoniker,
     label: "Transaction validation viewer",
-    kind: "viewer"
+    kind: "viewer",
+    surface: "node"
   },
   {
     id: DeadLetterQueueViewerMoniker,
     label: "Dead-letter queue viewer",
-    kind: "viewer"
+    kind: "viewer",
+    surface: "node"
   },
   {
-    id: DeadLetterQueueRunnerMoniker2,
+    id: DeadLetterQueueRunnerMoniker,
     label: "Dead-letter queue runner",
-    kind: "runner"
+    kind: "runner",
+    surface: "node"
   },
   {
     id: ChainContractViewerMoniker,
     label: "Chain contract viewer",
-    kind: "viewer"
+    kind: "viewer",
+    surface: "node"
   },
   {
     id: StakeTotalsViewerMoniker,
     label: "Stake totals viewer",
-    kind: "viewer"
+    kind: "viewer",
+    surface: "node"
   },
   {
     id: TimeSyncViewerMoniker,
     label: "Time sync viewer",
-    kind: "viewer"
+    kind: "viewer",
+    surface: "node"
   },
   {
     id: XyoViewerMoniker,
     label: "XYO viewer",
-    kind: "viewer"
+    kind: "viewer",
+    surface: "node"
   },
   {
     id: XyoConnectionMoniker,
     label: "XYO connection",
-    kind: "gateway"
+    kind: "gateway",
+    surface: "node"
   },
   {
     id: XyoGatewayRunnerMoniker,
     label: "XYO gateway runner",
-    kind: "gateway"
+    kind: "gateway",
+    surface: "node"
   },
   {
     id: RejectedTransactionsArchivistProviderMoniker,
     label: "Rejected transactions archivist provider",
-    kind: "archivist"
+    kind: "archivist",
+    surface: "node"
   },
   {
     id: BlockRunnerMoniker,
     label: "Block runner",
     kind: "runner",
+    surface: "node",
     implies: [
       AccountBalanceViewerMoniker,
-      BlockValidationViewerMoniker2,
+      BlockValidationViewerMoniker,
       ChainContractViewerMoniker,
       FinalizationViewerMoniker,
       MempoolRunnerMoniker,
-      MempoolViewerMoniker2,
+      MempoolViewerMoniker,
       TimeSyncViewerMoniker
     ]
   }
@@ -1379,6 +1372,13 @@ var localTier1Descriptors = [
       SimpleMempoolViewer.defaultMoniker
     ],
     tier: 1,
+    backings: [
+      {
+        backing: "mempool-store",
+        mode: "read"
+      }
+    ],
+    surface: "node",
     preconditions: passes,
     build: /* @__PURE__ */ __name((ctx) => SimpleMempoolViewer.factory(SimpleMempoolViewer.dependencies, {
       pendingTransactionsArchivist: ctx.process.pendingTransactionsArchivist,
@@ -1391,6 +1391,13 @@ var localTier1Descriptors = [
       SimpleMempoolRunner.defaultMoniker
     ],
     tier: 1,
+    backings: [
+      {
+        backing: "mempool-store",
+        mode: "write"
+      }
+    ],
+    surface: "node",
     preconditions: passes,
     build: /* @__PURE__ */ __name((ctx) => SimpleMempoolRunner.factory(SimpleMempoolRunner.dependencies, {
       pendingTransactionsArchivist: ctx.process.pendingTransactionsArchivist,
@@ -1403,6 +1410,13 @@ var localTier1Descriptors = [
       SimpleAccountBalanceViewer.defaultMoniker
     ],
     tier: 1,
+    backings: [
+      {
+        backing: "indexer-store",
+        mode: "read"
+      }
+    ],
+    surface: "node",
     preconditions: passes,
     build: /* @__PURE__ */ __name((ctx) => SimpleAccountBalanceViewer.factory(SimpleAccountBalanceViewer.dependencies, {
       balancesSummaryMap: ctx.process.balancesSummaryMap,
@@ -1415,6 +1429,13 @@ var localTier1Descriptors = [
       SimpleFinalizationViewer.defaultMoniker
     ],
     tier: 1,
+    backings: [
+      {
+        backing: "chain-store",
+        mode: "read"
+      }
+    ],
+    surface: "node",
     preconditions: passes,
     build: /* @__PURE__ */ __name((ctx) => SimpleFinalizationViewer.factory(SimpleFinalizationViewer.dependencies, {
       finalizedArchivist: ctx.process.readonlyChainArchivist
@@ -1426,6 +1447,13 @@ var localTier1Descriptors = [
       SimpleBlockViewer.defaultMoniker
     ],
     tier: 1,
+    backings: [
+      {
+        backing: "chain-store",
+        mode: "read"
+      }
+    ],
+    surface: "node",
     preconditions: passes,
     build: /* @__PURE__ */ __name((ctx) => SimpleBlockViewer.factory(SimpleBlockViewer.dependencies, {
       finalizedArchivist: ctx.process.readonlyChainArchivist
@@ -1437,6 +1465,8 @@ var localTier1Descriptors = [
       SimpleWindowedBlockViewer.defaultMoniker
     ],
     tier: 1,
+    backings: [],
+    surface: "node",
     preconditions: passes,
     build: /* @__PURE__ */ __name(() => SimpleWindowedBlockViewer.factory(SimpleWindowedBlockViewer.dependencies, {
       maxWindowSize: 1e3,
@@ -1449,6 +1479,8 @@ var localTier1Descriptors = [
       SimpleXyoConnectionViewer.defaultMoniker
     ],
     tier: 1,
+    backings: [],
+    surface: "node",
     preconditions: passes,
     build: /* @__PURE__ */ __name(() => SimpleXyoConnectionViewer.factory(SimpleXyoConnectionViewer.dependencies, {}), "build")
   },
@@ -1458,6 +1490,8 @@ var localTier1Descriptors = [
       SimpleTransactionViewer.defaultMoniker
     ],
     tier: 1,
+    backings: [],
+    surface: "node",
     preconditions: passes,
     build: /* @__PURE__ */ __name(() => SimpleTransactionViewer.factory(SimpleTransactionViewer.dependencies, {}), "build")
   },
@@ -1467,6 +1501,8 @@ var localTier1Descriptors = [
       SimpleXyoViewer.defaultMoniker
     ],
     tier: 1,
+    backings: [],
+    surface: "node",
     preconditions: passes,
     build: /* @__PURE__ */ __name(() => SimpleXyoViewer.factory(SimpleXyoViewer.dependencies, {}), "build")
   },
@@ -1476,6 +1512,13 @@ var localTier1Descriptors = [
       SimpleFinalizationRunner.defaultMoniker
     ],
     tier: 1,
+    backings: [
+      {
+        backing: "chain-store",
+        mode: "write"
+      }
+    ],
+    surface: "node",
     preconditions: passes,
     build: /* @__PURE__ */ __name((ctx) => SimpleFinalizationRunner.factory(SimpleFinalizationRunner.dependencies, {
       finalizedArchivist: ctx.process.writableChainArchivist
@@ -1487,6 +1530,8 @@ var localTier1Descriptors = [
       SimpleBlockValidationViewer.defaultMoniker
     ],
     tier: 1,
+    backings: [],
+    surface: "node",
     preconditions: passes,
     build: /* @__PURE__ */ __name((ctx) => SimpleBlockValidationViewer.factory(SimpleBlockValidationViewer.dependencies, {
       state: ctx.process.blockStateValidator,
@@ -1499,6 +1544,8 @@ var localTier1Descriptors = [
       SimpleTransactionValidationViewer.defaultMoniker
     ],
     tier: 1,
+    backings: [],
+    surface: "node",
     preconditions: passes,
     build: /* @__PURE__ */ __name((ctx) => SimpleTransactionValidationViewer.factory(SimpleTransactionValidationViewer.dependencies, {
       protocol: ctx.process.transactionProtocolValidator,
@@ -1511,6 +1558,13 @@ var localTier1Descriptors = [
       SimpleDeadLetterQueueRunner.defaultMoniker
     ],
     tier: 1,
+    backings: [
+      {
+        backing: "dlq-store",
+        mode: "write"
+      }
+    ],
+    surface: "node",
     preconditions: passes,
     build: /* @__PURE__ */ __name((ctx) => SimpleDeadLetterQueueRunner.factory(SimpleDeadLetterQueueRunner.dependencies, {
       rejectedBlocksArchivist: ctx.process.rejectedBlocksArchivist,
@@ -1523,6 +1577,13 @@ var localTier1Descriptors = [
       SimpleDeadLetterQueueViewer.defaultMoniker
     ],
     tier: 1,
+    backings: [
+      {
+        backing: "dlq-store",
+        mode: "read"
+      }
+    ],
+    surface: "node",
     preconditions: passes,
     build: /* @__PURE__ */ __name((ctx) => SimpleDeadLetterQueueViewer.factory(SimpleDeadLetterQueueViewer.dependencies, {
       rejectedBlocksArchivist: ctx.process.rejectedBlocksArchivist,
@@ -1535,6 +1596,13 @@ var localTier1Descriptors = [
       SimpleRejectedTransactionsArchivistProvider.defaultMoniker
     ],
     tier: 1,
+    backings: [
+      {
+        backing: "dlq-store",
+        mode: "read"
+      }
+    ],
+    surface: "node",
     preconditions: passes,
     build: /* @__PURE__ */ __name((ctx) => SimpleRejectedTransactionsArchivistProvider.factory(SimpleRejectedTransactionsArchivistProvider.dependencies, {
       archivist: ctx.process.rejectedTransactionsArchivist
@@ -1545,9 +1613,8 @@ var localTier1Descriptors = [
 // src/node/config/capabilities/locatorFromActorNeeds.ts
 import { ProviderFactoryLocator } from "@xyo-network/xl1-sdk";
 
-// src/node/config/capabilities/ProcessSharedResources.ts
-import { validateHydratedBlock, validateHydratedBlockState, validateHydratedTransactionState } from "@xyo-network/chain-validation";
-import { BlockCumulativeBalanceValidatorFactory, validateTransaction } from "@xyo-network/xl1-sdk";
+// src/node/config/capabilities/networkTier3Descriptors.ts
+import { indexedNetworkDescriptors, networkTier3Descriptors, nodeNetworkDescriptors } from "@xyo-network/xl1-sdk";
 
 // src/node/init/initBalanceSummaryMap.ts
 import { BaseMongoSdk } from "@xylabs/mongo";
@@ -1697,7 +1764,6 @@ import { isDefined as isDefined2 } from "@xylabs/sdk-js";
 import { LmdbArchivistConfigSchema } from "@xyo-network/archivist-lmdb";
 import { MongoDBArchivistV2 as MongoDBArchivistV22, MongoDBArchivistV2Deletable } from "@xyo-network/archivist-mongodb";
 import { ViewArchivist } from "@xyo-network/archivist-view";
-import { initTelemetry } from "@xyo-network/chain-telemetry";
 import { AbstractModule, LoggerModuleStatusReporter, MemoryArchivist, MemorySentinel, ModuleFactoryLocator } from "@xyo-network/sdk-js";
 import { hasMongoConfig as hasMongoConfig2 } from "@xyo-network/xl1-sdk";
 
@@ -1726,20 +1792,7 @@ var NamedLmdbArchivist = class extends LmdbArchivist {
 };
 
 // src/node/manifest/getLocator.ts
-var getLocator = /* @__PURE__ */ __name(async ({ logger, config }) => {
-  const { otlpEndpoint } = config.telemetry?.otel ?? {};
-  const { path: endpoint = "/metrics", port = 9465 } = config.telemetry?.metrics?.scrape ?? {};
-  const { traceProvider, meterProvider } = await initTelemetry({
-    attributes: {
-      serviceName: "xl1-api",
-      serviceVersion: "1.0.0"
-    },
-    otlpEndpoint,
-    metricsConfig: {
-      endpoint,
-      port
-    }
-  });
+var getLocator = /* @__PURE__ */ __name(async ({ logger, traceProvider, meterProvider, config }) => {
   if (isDefined2(logger)) AbstractModule.defaultLogger = logger;
   const statusReporter = logger ? new LoggerModuleStatusReporter(logger) : void 0;
   const locator = new ModuleFactoryLocator();
@@ -2102,7 +2155,86 @@ async function initTransferSummaryMap({ logger, config }) {
 }
 __name(initTransferSummaryMap, "initTransferSummaryMap");
 
-// src/node/config/capabilities/ProcessSharedResources.ts
+// src/node/config/capabilities/backings/buildChainStoreBacking.ts
+import { asArchivistInstance as asArchivistInstance2 } from "@xyo-network/sdk-js";
+async function buildChainStoreBacking(node, mode, options) {
+  const readonlyArchivist = asArchivistInstance2(await node.resolve("Chain:Validated"), {
+    required: true
+  });
+  if (mode === "read") {
+    return {
+      mode,
+      readonlyArchivist
+    };
+  }
+  if (!options) {
+    throw new Error("buildChainStoreBacking(write) requires options { actorConfig, wallet }");
+  }
+  const writableArchivist = asArchivistInstance2(await node.resolve("Chain:Validated"), {
+    required: true
+  });
+  await initFinalizationArchivistIfNeeded(writableArchivist, options.actorConfig, options.wallet, {
+    logger: options.logger,
+    onInsecureGenesisConfirm: options.onInsecureGenesisConfirm
+  });
+  return {
+    mode,
+    readonlyArchivist,
+    writableArchivist
+  };
+}
+__name(buildChainStoreBacking, "buildChainStoreBacking");
+
+// src/node/config/capabilities/backings/buildDlqStoreBacking.ts
+import { asArchivistInstance as asArchivistInstance3 } from "@xyo-network/sdk-js";
+async function buildDlqStoreBacking(node, mode) {
+  const rejectedBlocksArchivist = asArchivistInstance3(await node.resolve("XYOChain:DeadLetterQueue:RejectedBlocks"), {
+    required: true
+  });
+  const rejectedTransactionsArchivist = asArchivistInstance3(await node.resolve("XYOChain:DeadLetterQueue:RejectedTransactions"), {
+    required: true
+  });
+  return {
+    mode,
+    rejectedBlocksArchivist,
+    rejectedTransactionsArchivist
+  };
+}
+__name(buildDlqStoreBacking, "buildDlqStoreBacking");
+
+// src/node/config/capabilities/backings/buildIndexerStoreBacking.ts
+import { assertEx as assertEx9 } from "@xylabs/sdk-js";
+async function buildIndexerStoreBacking(context, mode) {
+  const balancesSummaryMap = assertEx9(await initBalanceSummaryMap(context), () => "Balance Summary Map not initialized");
+  const transfersSummaryMap = assertEx9(await initTransferSummaryMap(context), () => "Transfer Summary Map not initialized");
+  return {
+    balancesSummaryMap,
+    mode,
+    transfersSummaryMap
+  };
+}
+__name(buildIndexerStoreBacking, "buildIndexerStoreBacking");
+
+// src/node/config/capabilities/backings/buildMempoolStoreBacking.ts
+import { asArchivistInstance as asArchivistInstance4 } from "@xyo-network/sdk-js";
+async function buildMempoolStoreBacking(node, mode) {
+  const pendingTransactionsArchivist = asArchivistInstance4(await node.resolve("XYOChain:Pending:Transactions"), {
+    required: true
+  });
+  const pendingBlocksArchivist = asArchivistInstance4(await node.resolve("XYOChain:Pending:Blocks"), {
+    required: true
+  });
+  return {
+    mode,
+    pendingBlocksArchivist,
+    pendingTransactionsArchivist
+  };
+}
+__name(buildMempoolStoreBacking, "buildMempoolStoreBacking");
+
+// src/node/config/capabilities/backings/buildValidators.ts
+import { validateHydratedBlock, validateHydratedBlockState, validateHydratedTransactionState } from "@xyo-network/chain-validation";
+import { BlockCumulativeBalanceValidatorFactory, validateTransaction } from "@xyo-network/xl1-sdk";
 var cumulativeBalanceValidator = BlockCumulativeBalanceValidatorFactory();
 var validateHydratedBlockStateWithCumulativeBalance = /* @__PURE__ */ __name(async (context, block) => {
   const [stateErrors, cumulativeErrors] = await Promise.all([
@@ -2114,196 +2246,58 @@ var validateHydratedBlockStateWithCumulativeBalance = /* @__PURE__ */ __name(asy
     ...cumulativeErrors
   ];
 }, "validateHydratedBlockStateWithCumulativeBalance");
-async function buildProcessSharedResources(context, options) {
-  const balancesSummaryMap = await initBalanceSummaryMap(context);
-  if (!balancesSummaryMap) throw new Error("Balance Summary Map not initialized");
-  const transfersSummaryMap = await initTransferSummaryMap(context);
-  if (!transfersSummaryMap) throw new Error("Transfer Summary Map not initialized");
-  const wallet = await initActorWallet(context);
-  const serverNode = await initServerNode(context, wallet);
-  const { writableChainArchivist, readonlyChainArchivist, pendingTransactionsArchivist, pendingBlocksArchivist, rejectedBlocksArchivist, rejectedTransactionsArchivist } = serverNode;
-  await initFinalizationArchivistIfNeeded(writableChainArchivist, context.config, wallet, {
-    logger: context.logger,
-    onInsecureGenesisConfirm: options?.onInsecureGenesisConfirm
-  });
+function buildValidators() {
   return {
-    balancesSummaryMap,
-    transfersSummaryMap,
-    wallet,
-    node: serverNode.node,
-    writableChainArchivist,
-    readonlyChainArchivist,
-    pendingTransactionsArchivist,
-    pendingBlocksArchivist,
-    rejectedBlocksArchivist,
-    rejectedTransactionsArchivist,
     blockProtocolValidator: validateHydratedBlock,
     blockStateValidator: validateHydratedBlockStateWithCumulativeBalance,
     transactionProtocolValidator: validateTransaction,
     transactionStateValidator: validateHydratedTransactionState
   };
 }
-__name(buildProcessSharedResources, "buildProcessSharedResources");
+__name(buildValidators, "buildValidators");
 
-// src/node/config/capabilities/resolveProviders.ts
-var MissingCapabilityError = class extends Error {
-  static {
-    __name(this, "MissingCapabilityError");
-  }
-  moniker;
-  reasons;
-  constructor(moniker, reasons) {
-    const detail = reasons.length === 0 ? "(no candidates registered)" : reasons.join("; ");
-    super(`No provider satisfies capability '${moniker}': ${detail}`);
-    this.name = "MissingCapabilityError";
-    this.moniker = moniker;
-    this.reasons = reasons;
-  }
-};
-function resolveProviders(needs, candidates, ctx) {
-  const wanted = expandNeeds(needs, ctx);
-  const { surviving, rejected } = filterByPreconditions(candidates, ctx);
-  const byCapability = groupByCapability(surviving, wanted);
-  const { bindings, selectedById } = pickWinners(wanted, byCapability, rejected, candidates);
-  const selected = topoSort([
-    ...selectedById.values()
-  ], ctx);
-  return {
-    bindings,
-    rejected,
-    selected
-  };
-}
-__name(resolveProviders, "resolveProviders");
-function expandNeeds(needs, ctx) {
-  const wanted = new Set(needs);
-  const stack = [
-    ...needs
-  ];
-  while (stack.length > 0) {
-    const moniker = stack.pop();
-    const cap = ctx.capabilities.tryGet(moniker);
-    if (!cap?.implies) continue;
-    for (const dep of cap.implies) {
-      if (!wanted.has(dep)) {
-        wanted.add(dep);
-        stack.push(dep);
-      }
-    }
-  }
-  return wanted;
-}
-__name(expandNeeds, "expandNeeds");
-function filterByPreconditions(candidates, ctx) {
-  const surviving = [];
-  const rejected = [];
-  for (const descriptor of candidates) {
-    try {
-      if (descriptor.preconditions(ctx)) {
-        surviving.push(descriptor);
-      } else {
-        rejected.push({
-          descriptor,
-          reason: "preconditions returned false"
-        });
-      }
-    } catch (err) {
-      rejected.push({
-        descriptor,
-        reason: `preconditions threw: ${err instanceof Error ? err.message : String(err)}`
-      });
-    }
-  }
-  return {
-    surviving,
-    rejected
-  };
-}
-__name(filterByPreconditions, "filterByPreconditions");
-function groupByCapability(surviving, wanted) {
-  const byCapability = /* @__PURE__ */ new Map();
-  for (const descriptor of surviving) {
-    for (const moniker of descriptor.satisfies) {
-      if (!wanted.has(moniker)) continue;
-      const list = byCapability.get(moniker) ?? [];
-      list.push(descriptor);
-      byCapability.set(moniker, list);
-    }
-  }
-  return byCapability;
-}
-__name(groupByCapability, "groupByCapability");
-function pickWinners(wanted, byCapability, rejected, allCandidates) {
-  const bindings = {};
-  const selectedById = /* @__PURE__ */ new Map();
-  for (const moniker of wanted) {
-    const group = byCapability.get(moniker);
-    if (!group || group.length === 0) {
-      throw new MissingCapabilityError(moniker, reasonsFor(moniker, rejected, allCandidates));
-    }
-    const sorted = group.toSorted(compareDescriptors);
-    const winner = sorted[0];
-    bindings[moniker] = winner.id;
-    selectedById.set(winner.id, winner);
-    for (const loser of sorted.slice(1)) {
-      rejected.push({
-        descriptor: loser,
-        reason: `tier ${loser.tier} lost to ${winner.id} (tier ${winner.tier}) for ${moniker}`
-      });
-    }
-  }
+// src/node/config/capabilities/ProcessSharedResources.ts
+async function buildProcessSharedResources(context, options) {
+  const wallet = await initActorWallet(context);
+  const serverNode = await initServerNode(context, wallet);
+  const { node } = serverNode;
+  const [chainStore, mempoolStore, dlqStore, indexerStore] = await Promise.all([
+    buildChainStoreBacking(node, "write", {
+      actorConfig: context.config,
+      logger: context.logger,
+      onInsecureGenesisConfirm: options?.onInsecureGenesisConfirm,
+      wallet
+    }),
+    buildMempoolStoreBacking(node, "write"),
+    buildDlqStoreBacking(node, "write"),
+    buildIndexerStoreBacking(context, "write")
+  ]);
+  const validators = buildValidators();
   return {
-    bindings,
-    selectedById
+    balancesSummaryMap: indexerStore.balancesSummaryMap,
+    blockProtocolValidator: validators.blockProtocolValidator,
+    blockStateValidator: validators.blockStateValidator,
+    node,
+    pendingBlocksArchivist: mempoolStore.pendingBlocksArchivist,
+    pendingTransactionsArchivist: mempoolStore.pendingTransactionsArchivist,
+    readonlyChainArchivist: chainStore.readonlyArchivist,
+    rejectedBlocksArchivist: dlqStore.rejectedBlocksArchivist,
+    rejectedTransactionsArchivist: dlqStore.rejectedTransactionsArchivist,
+    transactionProtocolValidator: validators.transactionProtocolValidator,
+    transactionStateValidator: validators.transactionStateValidator,
+    transfersSummaryMap: indexerStore.transfersSummaryMap,
+    wallet,
+    writableChainArchivist: chainStore.writableArchivist
   };
 }
-__name(pickWinners, "pickWinners");
-function reasonsFor(moniker, rejected, allCandidates) {
-  const candidatesForMoniker = allCandidates.filter((c) => c.satisfies.includes(moniker));
-  if (candidatesForMoniker.length === 0) return [];
-  return rejected.filter((r) => r.descriptor.satisfies.includes(moniker)).map((r) => `${r.descriptor.id}: ${r.reason}`);
-}
-__name(reasonsFor, "reasonsFor");
-function compareDescriptors(a, b) {
-  if (a.tier !== b.tier) return a.tier - b.tier;
-  const pa = a.priority ?? 0;
-  const pb = b.priority ?? 0;
-  if (pa !== pb) return pb - pa;
-  return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
-}
-__name(compareDescriptors, "compareDescriptors");
-function topoSort(descriptors, ctx) {
-  const byMoniker = /* @__PURE__ */ new Map();
-  for (const d of descriptors) for (const m of d.satisfies) byMoniker.set(m, d);
-  const order = [];
-  const seen = /* @__PURE__ */ new Set();
-  const visiting = /* @__PURE__ */ new Set();
-  const visit = /* @__PURE__ */ __name((d) => {
-    if (seen.has(d.id)) return;
-    if (visiting.has(d.id)) {
-      throw new Error(`Cycle detected through provider ${d.id}`);
-    }
-    visiting.add(d.id);
-    for (const moniker of d.satisfies) {
-      const cap = ctx.capabilities.tryGet(moniker);
-      if (!cap?.implies) continue;
-      for (const dep of cap.implies) {
-        const depDesc = byMoniker.get(dep);
-        if (depDesc) visit(depDesc);
-      }
-    }
-    visiting.delete(d.id);
-    seen.add(d.id);
-    order.push(d);
-  }, "visit");
-  for (const d of descriptors) visit(d);
-  return order;
-}
-__name(topoSort, "topoSort");
+__name(buildProcessSharedResources, "buildProcessSharedResources");
+
+// src/node/config/capabilities/resolveProviders.ts
+import { MissingCapabilityError, resolveProviders } from "@xyo-network/xl1-protocol-sdk";
 
 // src/node/config/capabilities/locatorFromActorNeeds.ts
 async function locatorFromActorNeeds(context, actorNeeds, options = {}) {
-  const process2 = await buildProcessSharedResources(context, options);
+  const process2 = options.process ?? await buildProcessSharedResources(context, options);
   const capabilities2 = createDefaultCapabilityRegistry();
   const resolutionContext = {
     actorContext: context,
@@ -2313,9 +2307,12 @@ async function locatorFromActorNeeds(context, actorNeeds, options = {}) {
   const needs = unionNeeds(actorNeeds);
   const candidates = [
     ...localTier1Descriptors,
+    ...networkTier3Descriptors,
     ...options.extraDescriptors ?? []
   ];
-  const plan = resolveProviders(needs, candidates, resolutionContext);
+  const plan = resolveProviders(needs, candidates, resolutionContext, {
+    availableBackings: options.availableBackings
+  });
   const locator = new ProviderFactoryLocator(context, {}, options.validateDepsOnRegister ?? false);
   const factories = plan.selected.map((d) => d.build(resolutionContext)).filter((f) => f !== void 0);
   locator.registerMany(factories);
@@ -2375,12 +2372,29 @@ function basicRemoteViewerLocator(name, remoteConfig, dataLakeEndpoint, validato
 }
 __name(basicRemoteViewerLocator, "basicRemoteViewerLocator");
 
+// src/node/config/locators/buildStatelessApiLocator.ts
+var STATELESS_BACKINGS = [
+  {
+    backing: "network",
+    mode: "read"
+  }
+];
+async function buildStatelessApiLocator(context, needs) {
+  const stubProcess = {};
+  const result = await locatorFromActorNeeds(context, needs, {
+    availableBackings: STATELESS_BACKINGS,
+    process: stubProcess
+  });
+  return result.locator;
+}
+__name(buildStatelessApiLocator, "buildStatelessApiLocator");
+
 // src/node/config/locators/telemetryContextFromConfig.ts
-import { initTelemetry as initTelemetry2 } from "@xyo-network/chain-telemetry";
-async function telemetryContextFromConfig(config, serviceName, serviceVersion) {
+import { initTelemetry } from "@xyo-network/chain-telemetry";
+async function telemetryContextFromConfig(config, serviceName, serviceVersion, defaultScrapePort = 9464) {
   const { otlpEndpoint } = config.telemetry?.otel ?? {};
-  const { path: endpoint = "/metrics", port = 9466 } = config.telemetry?.metrics?.scrape ?? {};
-  return await initTelemetry2({
+  const { path: endpoint = "/metrics", port = defaultScrapePort } = config.telemetry?.metrics?.scrape ?? {};
+  return await initTelemetry({
     attributes: {
       serviceName,
       serviceVersion
@@ -2395,10 +2409,10 @@ async function telemetryContextFromConfig(config, serviceName, serviceVersion) {
 __name(telemetryContextFromConfig, "telemetryContextFromConfig");
 
 // src/node/config/locators/contextFromConfigWithoutLocator.ts
-async function contextFromConfigWithoutLocator(config, logger, serviceName, serviceVersion) {
+async function contextFromConfigWithoutLocator(config, logger, serviceName, serviceVersion, defaultScrapePort) {
   const singletons = {};
   const caches = {};
-  const telemetryConfig = await telemetryContextFromConfig(config, serviceName, serviceVersion);
+  const telemetryConfig = await telemetryContextFromConfig(config, serviceName, serviceVersion, defaultScrapePort);
   const statusReporter = initStatusReporter({
     logger
   });
@@ -2414,19 +2428,19 @@ async function contextFromConfigWithoutLocator(config, logger, serviceName, serv
 __name(contextFromConfigWithoutLocator, "contextFromConfigWithoutLocator");
 
 // src/node/config/locators/localLocatorFromConfig.ts
-import { AccountBalanceViewerMoniker as AccountBalanceViewerMoniker2, BlockValidationViewerMoniker as BlockValidationViewerMoniker3, BlockViewerMoniker as BlockViewerMoniker3, DeadLetterQueueRunnerMoniker as DeadLetterQueueRunnerMoniker3, DeadLetterQueueViewerMoniker as DeadLetterQueueViewerMoniker2, FinalizationRunnerMoniker as FinalizationRunnerMoniker3, FinalizationViewerMoniker as FinalizationViewerMoniker2, MempoolRunnerMoniker as MempoolRunnerMoniker2, MempoolViewerMoniker as MempoolViewerMoniker3, TransactionValidationViewerMoniker as TransactionValidationViewerMoniker2, TransactionViewerMoniker as TransactionViewerMoniker2, WindowedBlockViewerMoniker as WindowedBlockViewerMoniker2, XyoViewerMoniker as XyoViewerMoniker2 } from "@xyo-network/xl1-sdk";
+import { AccountBalanceViewerMoniker as AccountBalanceViewerMoniker2, BlockValidationViewerMoniker as BlockValidationViewerMoniker2, BlockViewerMoniker as BlockViewerMoniker2, DeadLetterQueueRunnerMoniker as DeadLetterQueueRunnerMoniker2, DeadLetterQueueViewerMoniker as DeadLetterQueueViewerMoniker2, FinalizationRunnerMoniker as FinalizationRunnerMoniker2, FinalizationViewerMoniker as FinalizationViewerMoniker2, MempoolRunnerMoniker as MempoolRunnerMoniker2, MempoolViewerMoniker as MempoolViewerMoniker2, TransactionValidationViewerMoniker as TransactionValidationViewerMoniker2, TransactionViewerMoniker as TransactionViewerMoniker2, WindowedBlockViewerMoniker as WindowedBlockViewerMoniker2, XyoViewerMoniker as XyoViewerMoniker2 } from "@xyo-network/xl1-sdk";
 var XyoConnectionMoniker2 = "XyoConnection";
 var LOCAL_LEGACY_NEEDS = {
   required: [
     AccountBalanceViewerMoniker2,
-    BlockValidationViewerMoniker3,
-    BlockViewerMoniker3,
-    DeadLetterQueueRunnerMoniker3,
+    BlockValidationViewerMoniker2,
+    BlockViewerMoniker2,
+    DeadLetterQueueRunnerMoniker2,
     DeadLetterQueueViewerMoniker2,
-    FinalizationRunnerMoniker3,
+    FinalizationRunnerMoniker2,
     FinalizationViewerMoniker2,
     MempoolRunnerMoniker2,
-    MempoolViewerMoniker3,
+    MempoolViewerMoniker2,
     RejectedTransactionsArchivistProviderMoniker,
     TransactionValidationViewerMoniker2,
     TransactionViewerMoniker2,
@@ -2450,8 +2464,31 @@ __name(localLocatorFromConfig, "localLocatorFromConfig");
 import { deepMerge as deepMerge2 } from "@xylabs/sdk-js";
 
 // src/node/config/locators/actors/apiLocatorFromConfig.ts
-import { ProviderFactoryLocator as ProviderFactoryLocator2, SimpleXyoConnectionRunner, SimpleXyoGateway, SimpleXyoRunner } from "@xyo-network/xl1-sdk";
-function apiLocatorFromConfig(context, parent) {
+import { AccountBalanceViewerMoniker as AccountBalanceViewerMoniker3, BlockViewerMoniker as BlockViewerMoniker3, FinalizationViewerMoniker as FinalizationViewerMoniker3, MempoolViewerMoniker as MempoolViewerMoniker3, ProviderFactoryLocator as ProviderFactoryLocator2, SimpleXyoConnectionRunner, SimpleXyoGateway, SimpleXyoRunner, TransactionViewerMoniker as TransactionViewerMoniker3, XyoConnectionMoniker as XyoConnectionMoniker3, XyoViewerMoniker as XyoViewerMoniker3 } from "@xyo-network/xl1-sdk";
+var API_NEEDS = {
+  required: [
+    AccountBalanceViewerMoniker3,
+    BlockViewerMoniker3,
+    FinalizationViewerMoniker3,
+    MempoolViewerMoniker3,
+    TransactionViewerMoniker3,
+    XyoConnectionMoniker3,
+    XyoViewerMoniker3
+  ]
+};
+async function apiLocatorFromConfig(context, parent) {
+  if (context.config.stateless) {
+    const locator2 = await buildStatelessApiLocator(context, [
+      API_NEEDS
+    ]);
+    locator2.registerMany([
+      SimpleXyoRunner.factory(SimpleXyoRunner.dependencies, {}),
+      SimpleXyoConnectionRunner.factory(SimpleXyoConnectionRunner.dependencies, {}),
+      SimpleXyoGateway.factory(SimpleXyoGateway.dependencies, {})
+    ]);
+    locator2.freeze();
+    return locator2;
+  }
   const locator = new ProviderFactoryLocator2({
     ...context,
     locator: parent
@@ -2476,7 +2513,7 @@ async function bridgeLocatorFromConfig(context, parent) {
   });
   const { config } = context;
   const { dataLake } = config;
-  const signerAccount = await initActorAccount(context);
+  const signerAccount = await initActorWallet(context);
   if (config.remote.rpc) {
     locator.registerMany([
       JsonRpcMempoolViewer.factory(JsonRpcMempoolViewer.dependencies, {}),
@@ -2556,7 +2593,7 @@ import { SimpleBlockRunner } from "@xyo-network/chain-services";
 import { ProviderFactoryLocator as ProviderFactoryLocator6 } from "@xyo-network/xl1-sdk";
 async function producerLocatorFromConfig(context, parent) {
   const { logger, config } = context;
-  const account = await initActorAccount(context);
+  const account = await initActorWallet(context);
   const locator = new ProviderFactoryLocator6({
     ...context,
     locator: parent
@@ -2592,7 +2629,7 @@ async function rewardRedemptionLocatorFromConfig(context, parent) {
     locator: parent
   });
   const { config } = context;
-  const account = await initActorAccount(context);
+  const account = await initActorWallet(context);
   if (config.remote.rpc) {
     locator.registerMany([
       JsonRpcMempoolViewer2.factory(JsonRpcMempoolViewer2.dependencies, {}),
@@ -2637,18 +2674,28 @@ async function rootLocatorFromConfig(context, validateDepsOnRegister = false, on
 __name(rootLocatorFromConfig, "rootLocatorFromConfig");
 
 // src/node/config/locators/locatorsFromConfig.ts
+function allActorsAreSelfSufficient(actors, config) {
+  if (actors.length === 0) return false;
+  return actors.every((actor) => {
+    if (actor.name !== "api") return false;
+    const merged = ApiConfigZod.parse(deepMerge2(config, actor));
+    return merged.stateless === true;
+  });
+}
+__name(allActorsAreSelfSufficient, "allActorsAreSelfSufficient");
 async function locatorsFromConfig(context, { actors, ...config }, onInsecureGenesisConfirm) {
-  const rootContext = {
-    ...context,
-    config: {
-      ...config,
-      name: "_root"
-    }
-  };
-  const rootLocator = await rootLocatorFromConfig(rootContext, false, onInsecureGenesisConfirm);
-  const result = {
-    _root: rootLocator
-  };
+  const result = {};
+  const skipRoot = allActorsAreSelfSufficient(actors, config);
+  if (!skipRoot) {
+    const rootContext = {
+      ...context,
+      config: {
+        ...config,
+        name: "_root"
+      }
+    };
+    result._root = await rootLocatorFromConfig(rootContext, false, onInsecureGenesisConfirm);
+  }
   for (const actorConfig of actors) {
     switch (actorConfig.name) {
       case "producer": {
@@ -2780,7 +2827,6 @@ export {
   DEFAULT_MEMPOOL_TRANSACTION_PRUNE_INTERVAL,
   DefaultServiceProvider,
   DerivationPathCollisionError,
-  FinalizerActor,
   FinalizerConfigContext,
   FinalizerConfigZod,
   GENESIS_REWARD_AMOUNT,
@@ -2815,10 +2861,12 @@ export {
   asRewardRedemptionConfig,
   asRewardRedemptionConfigContext,
   assertNoActorMnemonics,
+  backingsSatisfied,
   basicRemoteRunnerLocator,
   basicRemoteViewerLocator,
   buildInsecureGenesisRewardAccounts,
   buildProcessSharedResources,
+  buildStatelessApiLocator,
   buildTelemetryConfig,
   clearResolvedWalletReport,
   contextFromConfigWithoutLocator,
@@ -2833,7 +2881,7 @@ export {
   getInsecureGenesisRewardMnemonic,
   getLocator,
   getResolvedWalletReport,
-  initActorAccount,
+  indexedNetworkDescriptors,
   initActorSeedPhrase,
   initActorWallet,
   initBalanceSummaryMap,
@@ -2865,6 +2913,8 @@ export {
   locatorFromActorNeeds,
   locatorsFromConfig,
   mergeConfig,
+  networkTier3Descriptors,
+  nodeNetworkDescriptors,
   resolveActorAccountPath,
   resolveActorWallet,
   resolveGenesisRewardAddress,
@@ -2886,6 +2936,7 @@ export {
   toProducerConfigContext,
   toRewardRedemptionConfig,
   toRewardRedemptionConfigContext,
-  tryParseConfig
+  tryParseConfig,
+  unmetBackings
 };
 //# sourceMappingURL=index.mjs.map