@xyo-network/xl1-protocol-sdk 3.0.0 → 3.0.2

package/dist/neutral/index.mjs

@@ -1040,6 +1040,337 @@ function factoryBackingsCompatible(declared, available) {
   return backingsSatisfied(declared, available);
 }
 
+// src/config/normalizeConnectionsConfig.ts
+function mergeConnectionMaps(transports, connections) {
+  return { ...transports, ...connections };
+}
+function normalizeProviderBinding(binding) {
+  const connectionName = binding.connection ?? binding.transport;
+  if (connectionName === void 0 || connectionName === "") {
+    return binding;
+  }
+  return {
+    ...binding,
+    connection: connectionName,
+    transport: connectionName
+  };
+}
+function normalizeProviderBindings(bindings) {
+  const normalized = {};
+  for (const [moniker, binding] of Object.entries(bindings)) {
+    if (binding === void 0) continue;
+    normalized[moniker] = normalizeProviderBinding(binding);
+  }
+  return normalized;
+}
+function normalizeConnectionsConfig(config) {
+  const transports = config.transports ?? {};
+  const connections = config.connections ?? {};
+  const merged = mergeConnectionMaps(transports, connections);
+  return {
+    ...config,
+    connections: merged,
+    providerBindings: normalizeProviderBindings(config.providerBindings ?? {}),
+    transports: merged
+  };
+}
+function hasDeclaredConnectionProfiles(config) {
+  return Object.keys(config.transports ?? {}).length > 0 || Object.keys(config.connections ?? {}).length > 0;
+}
+
+// src/CreatableProvider/ProviderFactoryLocator.ts
+import { hasAllLabels } from "@xylabs/sdk-js";
+import { assertEx as assertEx9 } from "@xylabs/sdk-js";
+
+// src/CreatableProvider/CreatableProviderRegistry.ts
+import { isTruthy } from "@xylabs/sdk-js";
+
+// src/CreatableProvider/ProviderFactory.ts
+import { assertEx as assertEx8 } from "@xylabs/sdk-js";
+function providerFactoryDescription(factory, labels) {
+  return `${factory.providerName}:${factory.defaultMoniker}:${JSON.stringify(labels ?? factory.labels ?? {})}`;
+}
+var ProviderFactory = class _ProviderFactory {
+  creatableProvider;
+  defaultMoniker;
+  defaultParams;
+  dependencies;
+  labels;
+  monikers;
+  providerName;
+  scope;
+  _uniqueId;
+  constructor(creatableProvider2, dependencies, params, labels = {}, scope = "context") {
+    this.creatableProvider = creatableProvider2;
+    this.defaultParams = params;
+    this.defaultMoniker = creatableProvider2.defaultMoniker;
+    this.dependencies = dependencies;
+    this.monikers = creatableProvider2.monikers;
+    this.scope = scope;
+    assertEx8(this.monikers.includes(this.defaultMoniker), () => "defaultMoniker must be in monikers");
+    this.labels = Object.assign({}, creatableProvider2.labels ?? {}, labels ?? {});
+    this.providerName = creatableProvider2.name;
+    this._uniqueId = Symbol(providerFactoryDescription(this));
+  }
+  get resolvedMoniker() {
+    const labels = this.labels ?? {};
+    const labelString = Object.entries(labels).map(([key, value]) => `${key}=${value}`).join(",");
+    return labelString.length === 0 ? this.defaultMoniker : `${this.defaultMoniker}|${labelString}`;
+  }
+  get uniqueId() {
+    return this._uniqueId;
+  }
+  static withParams(creatableProvider2, dependencies, params, labels = {}) {
+    return new _ProviderFactory(creatableProvider2, dependencies, params, labels);
+  }
+  factory(dependencies, params, labels = {}) {
+    return new _ProviderFactory(this.creatableProvider, dependencies, params, labels);
+  }
+  async getInstance(params, { start = true }) {
+    let scopeObject;
+    switch (this.scope) {
+      case "global": {
+        scopeObject = getOrCreateGlobalSingletons();
+        break;
+      }
+      case "context": {
+        const context = assertEx8(
+          params?.context,
+          () => "Context is required for context-scoped providers"
+        );
+        context.singletons ??= {};
+        scopeObject = context.singletons;
+        break;
+      }
+      default: {
+        scopeObject = {};
+        break;
+      }
+    }
+    const mergedParams = {
+      ...this.defaultParams,
+      ...params
+    };
+    const resultPromise = scopeObject[this.resolvedMoniker] ?? this.creatableProvider.create(mergedParams);
+    scopeObject[this.resolvedMoniker] = resultPromise;
+    const result = await resultPromise;
+    if (start) {
+      assertEx8(await result.start(), () => `Failed to start provider instance [${this.resolvedMoniker}]`);
+    }
+    return result;
+  }
+  async tryGetInstance(params, options) {
+    try {
+      return await this.getInstance(params, options);
+    } catch {
+      return;
+    }
+  }
+};
+function getOrCreateGlobalSingletons() {
+  const existing = globalThis.xyoServiceSingletons;
+  if (existing !== void 0) {
+    return existing;
+  }
+  const singletons = {};
+  Reflect.set(globalThis, "xyoServiceSingletons", singletons);
+  return singletons;
+}
+
+// src/CreatableProvider/CreatableProviderRegistry.ts
+var buildProviderFactory = (provider, defaultParams, labels) => {
+  const factory = {
+    monikers: provider.monikers,
+    uniqueId: Symbol(providerFactoryDescription(provider, labels)),
+    // Merge module & supplied labels
+    labels: { ...provider.labels, ...labels },
+    creatableProvider: provider.creatableProvider,
+    dependencies: provider.dependencies,
+    resolvedMoniker: provider.resolvedMoniker,
+    providerName: provider.providerName,
+    scope: provider.scope,
+    defaultParams,
+    getInstance: provider.getInstance.bind(provider),
+    tryGetInstance: provider.tryGetInstance?.bind(provider),
+    defaultMoniker: provider.defaultMoniker,
+    factory: provider.factory.bind(provider)
+  };
+  return factory;
+};
+var registerCreatableProviderFactory = (registry, factory, labels, primary = false) => {
+  const primaryMonikers = primary !== true && isTruthy(primary) ? Array.isArray(primary) ? primary : [primary] : [];
+  for (const primaryMoniker of primaryMonikers) {
+    if (!factory.monikers.includes(primaryMoniker)) {
+      throw new Error(`Primary moniker ${String(primaryMoniker)} not found in factory monikers`);
+    }
+  }
+  const isPrimaryForMoniker = (moniker) => {
+    switch (typeof primary) {
+      case "boolean": {
+        return primary;
+      }
+      case "string": {
+        return moniker === primary;
+      }
+      case "object": {
+        if (Array.isArray(primary)) {
+          return primary.includes(moniker);
+        }
+      }
+    }
+    throw new Error(`Invalid primary value: ${String(primary)}`);
+  };
+  const factoryClone = buildProviderFactory(factory, factory.defaultParams, labels);
+  registry[factoryClone.defaultMoniker] = [factoryClone, ...registry[factoryClone.defaultMoniker] ?? []];
+  for (const moniker of factoryClone.monikers) {
+    if (moniker === factoryClone.defaultMoniker) continue;
+    registry[moniker] = isPrimaryForMoniker(moniker) ? [factoryClone, ...registry[moniker] ?? []] : [...registry[moniker] ?? [], factoryClone];
+  }
+};
+var registerCreatableProviderFactories = (factories, registry = {}, primary = false) => {
+  for (const factory of factories) {
+    registerCreatableProviderFactory(registry, factory, void 0, primary);
+  }
+  return registry;
+};
+
+// src/CreatableProvider/LabeledCreatableProviderFactory.ts
+var hasLabels = (factory) => {
+  return factory.labels !== void 0;
+};
+function labeledCreatableProviderFactory() {
+  return (constructor) => {
+    constructor;
+  };
+}
+
+// src/CreatableProvider/ProviderFactoryLocator.ts
+var ProviderFactoryLocator = class _ProviderFactoryLocator {
+  _context;
+  _registry;
+  _frozen = false;
+  _parent;
+  _validateDepsOnRegister;
+  constructor(context, registry = {}, validateDepsOnRegister = false) {
+    this._registry = registry;
+    this._context = { ...context, locator: this };
+    this._parent = context.locator;
+    this._validateDepsOnRegister = validateDepsOnRegister;
+  }
+  get context() {
+    return this._context;
+  }
+  get logger() {
+    return this.context.logger;
+  }
+  /**
+   * The current registry for the module factory
+   */
+  get registry() {
+    return this._registry;
+  }
+  get validateDepsOnRegister() {
+    return this._validateDepsOnRegister;
+  }
+  freeze() {
+    this._frozen = true;
+  }
+  async getInstance(moniker, { start = true, labels } = {}) {
+    return assertEx9(
+      await this.tryGetInstance(moniker, { start, labels }),
+      () => `No provider instance for the supplied config moniker [${moniker}]${labels ? ` & labels [${JSON.stringify(labels)}]` : ""} could be created`
+    );
+  }
+  has(moniker) {
+    return Object.hasOwn(this._registry, moniker);
+  }
+  /**
+   * Locates a provider factory that matches the supplied moniker and labels
+   * @param moniker The config moniker for the provider
+   * @param labels The labels for the provider factory
+   * @returns A provider factory that matches the supplied moniker and labels or throws if one is not found
+   */
+  locate(moniker, labels) {
+    return assertEx9(
+      this.tryLocate(moniker, labels),
+      () => `No module factory for the supplied config moniker [${moniker}]${labels ? ` & labels [${JSON.stringify(labels)}]` : ""} registered`
+    );
+  }
+  merge(locator) {
+    const registry = { ...this.registry };
+    for (const moniker in locator.registry) {
+      const existing = registry[moniker];
+      if (existing === void 0) {
+        registry[moniker] = locator.registry[moniker];
+      } else {
+        existing.push(...locator.registry[moniker] ?? []);
+      }
+    }
+    return new _ProviderFactoryLocator(this.context, registry);
+  }
+  /**
+   * Registers a single module factory (with optional tags) with the locator
+   * @param factory The factory to register
+   * @param labels The labels for the module factory
+   */
+  register(factory, labels, primary = false) {
+    assertEx9(!this._frozen, () => "Cannot register a module factory after the locator has been frozen");
+    if (this.validateDepsOnRegister) {
+      const missingDeps = factory.dependencies.filter((dep) => !this.registered(dep));
+      assertEx9(missingDeps.length === 0, () => `Cannot register module factory [${factory.uniqueId.description}] due to missing dependencies: ${missingDeps.join(", ")}`);
+    }
+    registerCreatableProviderFactory(this._registry, factory, labels, primary);
+    return this;
+  }
+  /**
+   * Registers multiple module factories with the locator
+   * @param factories The factories to register
+   */
+  registerMany(factories) {
+    for (const factory of factories) {
+      this.register(factory);
+    }
+    return this;
+  }
+  registered(moniker) {
+    return Object.hasOwn(this.registry, moniker) || (this._parent?.registered(moniker) ?? false);
+  }
+  async tryGetInstance(moniker, { start = true, labels } = {}) {
+    const resolvedParams = { context: this.context };
+    const factory = this.tryLocate(moniker, labels);
+    if (factory !== void 0) {
+      if (Object.hasOwn(this.context.singletons, factory.uniqueId)) {
+        return this.context.singletons[factory.uniqueId];
+      }
+      this.logger?.debug(`Creating provider instance for moniker [${moniker}]${labels ? ` with labels [${JSON.stringify(labels)}]` : ""} using factory [${factory.uniqueId.description}]`);
+      const result = await factory.getInstance(resolvedParams, { start });
+      this.context.singletons[factory.uniqueId] = result;
+      return result;
+    }
+  }
+  /**
+   * Tries to locate a module factory that matches the supplied moniker and labels
+   * @param moniker The config moniker for the module
+   * @param labels The labels for the module factory
+   * @returns A module factory that matches the supplied moniker and labels or undefined
+   */
+  tryLocate(moniker, labels) {
+    const result = (labels ? this._registry[moniker]?.filter(hasLabels).find((factory) => hasAllLabels(factory?.labels, labels)) ?? this._registry[moniker]?.[0] : this._registry[moniker]?.[0]) ?? this._parent?.tryLocate(moniker, labels);
+    return result;
+  }
+  validateDependencies(recursive = false) {
+    if (recursive) {
+      this._parent?.validateDependencies();
+    }
+    for (const moniker in this.registry) {
+      for (const factory of this.registry[moniker] ?? []) {
+        const missingDeps = factory.dependencies.filter((dep) => !this.registered(dep));
+        assertEx9(missingDeps.length === 0, () => `Module factory [${factory.uniqueId.description}] is missing dependencies: ${missingDeps.join(", ")}`);
+      }
+    }
+  }
+};
+
 // src/capabilities/resolveProviders.ts
 import { isDefined as isDefined4 } from "@xylabs/sdk-js";
 var MissingCapabilityError = class extends Error {
@@ -1086,14 +1417,12 @@ var UnknownConnectionError = class extends Error {
     this.connectionName = connectionName;
   }
 };
-function resolveProviders(needs, candidates, ctx, options = {}) {
+function resolveProviders(needs, candidates, options = {}) {
   const rejected = [];
-  const { preconditionFiltered, preconditionRejected } = filterByPreconditions(candidates, ctx);
-  rejected.push(...preconditionRejected);
   const wanted = new Set(needs);
   const bindings = {};
   const selectedById = /* @__PURE__ */ new Map();
-  const candidatesByMoniker = indexCandidatesByMoniker(preconditionFiltered);
+  const candidatesByMoniker = indexCandidatesByMoniker(candidates);
   expandBindingClosure(
     wanted,
     bindings,
@@ -1195,25 +1524,6 @@ function filterByConnection(group, connectionType, connectionName) {
   });
   return { filtered, rejected };
 }
-function filterByPreconditions(candidates, ctx) {
-  const preconditionFiltered = [];
-  const preconditionRejected = [];
-  for (const descriptor of candidates) {
-    try {
-      if (descriptor.preconditions(ctx)) {
-        preconditionFiltered.push(descriptor);
-      } else {
-        preconditionRejected.push({ descriptor, reason: "preconditions returned false" });
-      }
-    } catch (err) {
-      preconditionRejected.push({
-        descriptor,
-        reason: `preconditions threw: ${err instanceof Error ? err.message : String(err)}`
-      });
-    }
-  }
-  return { preconditionFiltered, preconditionRejected };
-}
 function reasonsFor(moniker, rejected, allCandidates) {
   const candidatesForMoniker = allCandidates.filter((candidate) => candidate.satisfies.includes(moniker));
   if (candidatesForMoniker.length === 0) {
@@ -1256,6 +1566,70 @@ function topoSort(descriptors, bindings, selectedById) {
   return order;
 }
 
+// src/capabilities/locatorFromConfig.ts
+function resolveProvidersFromConfig(needs, candidates, config) {
+  const normalized = normalizeConnectionsConfig(config);
+  return resolveProviders(needs, candidates, {
+    connections: normalized.connections,
+    providerBindings: normalized.providerBindings
+  });
+}
+function registerFactoriesFromPlan(locator, plan) {
+  for (const descriptor of plan.selected) {
+    const { creatableProvider: creatableProvider2 } = descriptor;
+    const dependencies = [...descriptor.dependencies ?? creatableProvider2.dependencies];
+    locator.register(creatableProvider2.factory(dependencies, {}));
+  }
+}
+function locatorFromConfig(options) {
+  const normalized = normalizeConnectionsConfig(options.config);
+  const plan = resolveProvidersFromConfig(options.needs, options.candidates, normalized);
+  const locator = new ProviderFactoryLocator({
+    singletons: {},
+    caches: {},
+    ...options.context,
+    config: normalized
+  });
+  registerFactoriesFromPlan(locator, plan);
+  return locator;
+}
+
+// src/capabilities/needsFromProviderBindings.ts
+function needsFromProviderBindings(config) {
+  return new Set(Object.keys(config.providerBindings));
+}
+function needsFromConnectionTypes(config, connectionTypes) {
+  const allowed = new Set(connectionTypes);
+  const needs = /* @__PURE__ */ new Set();
+  for (const moniker of Object.keys(config.providerBindings)) {
+    const binding = config.providerBindings[moniker];
+    const connectionName = binding?.connection ?? binding?.transport;
+    if (connectionName === void 0 || connectionName === "") {
+      continue;
+    }
+    const connection = config.connections[connectionName];
+    if (connection !== void 0 && allowed.has(connection.type)) {
+      needs.add(moniker);
+    }
+  }
+  return needs;
+}
+
+// src/capabilities/providerCandidateFromClass.ts
+function providerCandidateFromClass(creatableProvider2, id = creatableProvider2.name) {
+  return {
+    connectionTypes: creatableProvider2.connectionTypes ?? [],
+    creatableProvider: creatableProvider2,
+    dependencies: creatableProvider2.dependencies,
+    id,
+    satisfies: creatableProvider2.monikers,
+    surface: creatableProvider2.surface ?? "node"
+  };
+}
+function providerCandidatesFromClasses(creatableProviders) {
+  return creatableProviders.map((provider) => providerCandidateFromClass(provider));
+}
+
 // src/config/Actor.ts
 import {
   zodAsFactory as zodAsFactory3,
@@ -1667,7 +2041,7 @@ import { isDefined as isDefined8, isFalsy } from "@xylabs/sdk-js";
 import { asXL1BlockRange } from "@xyo-network/xl1-protocol-lib";
 
 // src/primitives/block/rate/timeHelpers.ts
-import { assertEx as assertEx8, isDefined as isDefined7 } from "@xylabs/sdk-js";
+import { assertEx as assertEx10, isDefined as isDefined7 } from "@xylabs/sdk-js";
 var rateMultipliers = {
   millis: 1,
   seconds: 1e3,
@@ -1685,7 +2059,7 @@ var timeDurations = (timeInMs) => ({
   weeks: timeInMs / (1e3 * 60 * 60 * 24 * 7)
 });
 var getTimeConfigInMilliseconds = (timeConfig) => {
-  const assertedTimeConfig = assertEx8(isDefined7(timeConfig) ? timeConfig : void 0, () => "Time configuration must be provided");
+  const assertedTimeConfig = assertEx10(isDefined7(timeConfig) ? timeConfig : void 0, () => "Time configuration must be provided");
   let totalMilliseconds = 0;
   if ("years" in assertedTimeConfig) {
     totalMilliseconds += assertedTimeConfig.years * 31536e6;
@@ -1758,7 +2132,7 @@ var calculateBlockRate = async (viewer, range, timeUnit) => {
 };
 
 // src/primitives/block/rate/stepRate.ts
-import { assertEx as assertEx9 } from "@xylabs/sdk-js";
+import { assertEx as assertEx11 } from "@xylabs/sdk-js";
 import {
   asXL1BlockRange as asXL1BlockRange2,
   isValidStep,
@@ -1770,14 +2144,14 @@ var stepRate = async (viewer, start, step, count = 1, timeUnit) => {
   return await calculateBlockRate(viewer, range, timeUnit);
 };
 var calculateStepSizeRate = async (viewer, start, stepIndex, count = 1, timeUnit) => {
-  assertEx9(isValidStep(stepIndex), () => `Invalid step index: ${stepIndex}`);
+  assertEx11(isValidStep(stepIndex), () => `Invalid step index: ${stepIndex}`);
   const step = StepSizes4[stepIndex];
   return await stepRate(viewer, start, step, count, timeUnit);
 };
 
 // src/primitives/block/rate/timeRate.ts
 import {
-  assertEx as assertEx10,
+  assertEx as assertEx12,
   isDefined as isDefined9,
   isDefinedNotNull
 } from "@xylabs/sdk-js";
@@ -1785,13 +2159,13 @@ import { asXL1BlockNumber as asXL1BlockNumber3, asXL1BlockRange as asXL1BlockRan
 var DEFAULT_TOLERANCE_MS = 3e4;
 var DEFAULT_MAX_ATTEMPTS = 10;
 var calculateTimeRate = async (viewer, timeConfig, startBlockNumber, timeUnit, toleranceMs = DEFAULT_TOLERANCE_MS, maxAttempts = DEFAULT_MAX_ATTEMPTS) => {
-  assertEx10(Object.keys(timeConfig ?? {}).length === 1, () => "Only one time unit should be specified in timeConfig");
+  assertEx12(Object.keys(timeConfig ?? {}).length === 1, () => "Only one time unit should be specified in timeConfig");
   const startBlock = isDefinedNotNull(startBlockNumber) ? await viewer.blockByNumber(startBlockNumber) : null;
   const currentBlockResult = await viewer.currentBlock();
   const blockResult = isDefinedNotNull(startBlock) ? startBlock : currentBlockResult;
   const resolvedStartBlock = blockResult[0];
   const timeInMilliseconds = getTimeConfigInMilliseconds(timeConfig);
-  assertEx10(timeInMilliseconds > 0, () => "Time duration must be greater than zero");
+  assertEx12(timeInMilliseconds > 0, () => "Time duration must be greater than zero");
   const blocksPerMillisecondRate = 1 / (12 * 1e3);
   const initialBlocksInDuration = Math.floor(blocksPerMillisecondRate * timeInMilliseconds);
   const endBlockNumber = await findEndBlockRecursive(
@@ -1809,14 +2183,14 @@ var calculateTimeRate = async (viewer, timeConfig, startBlockNumber, timeUnit, t
   );
 };
 var findEndBlockRecursive = async (viewer, startBlock, targetTimeMs, estimatedBlocksBack, toleranceMs, attemptsRemaining) => {
-  assertEx10(attemptsRemaining >= 0, () => "Maximum attempts reached while searching for end block");
+  assertEx12(attemptsRemaining >= 0, () => "Maximum attempts reached while searching for end block");
   const startBlockEpoch = startBlock.$epoch;
   const estimatedEndBlockNumber = asXL1BlockNumber3(startBlock.block - estimatedBlocksBack, true);
   if (estimatedEndBlockNumber < 0) {
     throw new Error("Estimated end block number is less than zero");
   }
   const endBlock = await viewer.blockByNumber(estimatedEndBlockNumber);
-  const resolvedEndBlock = assertEx10(
+  const resolvedEndBlock = assertEx12(
     isDefined9(endBlock?.[0]) ? endBlock[0] : void 0,
     () => `Could not retrieve block ${estimatedEndBlockNumber} for time rate calculation`
   );
@@ -1853,7 +2227,7 @@ var findEndBlockRecursive = async (viewer, startBlock, targetTimeMs, estimatedBl
 
 // src/primitives/chain/getWindowedChain.ts
 import {
-  assertEx as assertEx11,
+  assertEx as assertEx13,
   isDefined as isDefined10,
   isNull,
   spanRootAsync
@@ -1870,12 +2244,12 @@ async function getWindowedChain(context, blockViewer, maxWindowSize, previousCha
       const nextBlock = newChain[0];
       if (isDefined10(nextBlock)) {
         const nextBlockNumber = nextBlock[0].block;
-        assertEx11(
+        assertEx13(
           currentBlockNumber === nextBlockNumber - 1,
           () => `[getWindowedChain] Non-monotonic block sequence detected: current=${currentBlockNumber}, next=${nextBlockNumber}`
         );
       }
-      assertEx11(
+      assertEx13(
         currentBlockNumber <= head[0].block,
         () => `[getWindowedChain] Current block number (${currentBlockNumber}) exceeds head block number (${head[0].block})`
       );
@@ -1889,7 +2263,7 @@ async function getWindowedChain(context, blockViewer, maxWindowSize, previousCha
 }
 
 // src/primitives/chain/step/chainStepRewardAddress.ts
-import { assertEx as assertEx14, exists } from "@xylabs/sdk-js";
+import { assertEx as assertEx16, exists } from "@xylabs/sdk-js";
 import { toXyoAddress as toXyoAddress2 } from "@xyo-network/sdk-js";
 import {
   asTransfer,
@@ -1921,7 +2295,7 @@ function stepBlockRange({ block, step }) {
 }
 
 // src/primitives/step/stepTransferIndex.ts
-import { assertEx as assertEx12 } from "@xylabs/sdk-js";
+import { assertEx as assertEx14 } from "@xylabs/sdk-js";
 import { StepSizes as StepSizes6 } from "@xyo-network/xl1-protocol-lib";
 function stepTransferIndex(block, step) {
   let rewardTransferCount = 0;
@@ -1935,16 +2309,16 @@ function stepTransferIndex(block, step) {
       rewardTransferCount++;
     }
   }
-  assertEx12(rewardTransferIndex >= 0, () => `Could not find step size for step ${step} at block ${block}`);
+  assertEx14(rewardTransferIndex >= 0, () => `Could not find step size for step ${step} at block ${block}`);
   return [rewardTransferIndex, rewardTransferCount];
 }
 
 // src/primitives/chain/step/stepRewardBlock.ts
-import { assertEx as assertEx13 } from "@xylabs/sdk-js";
+import { assertEx as assertEx15 } from "@xylabs/sdk-js";
 import { StepSizes as StepSizes7 } from "@xyo-network/xl1-protocol-lib";
 async function stepRewardBlock(context, blockViewer, { block, step }) {
-  assertEx13(block % StepSizes7[step] === 0, () => `Block must be the first block of the step [${StepSizes7[step]}], got ${block}`);
-  return assertEx13(await blockViewer.blockByNumber(block), () => `Could not find block for block number ${block}`);
+  assertEx15(block % StepSizes7[step] === 0, () => `Block must be the first block of the step [${StepSizes7[step]}], got ${block}`);
+  return assertEx15(await blockViewer.blockByNumber(block), () => `Could not find block for block number ${block}`);
 }
 
 // src/primitives/chain/step/chainStepRewardAddress.ts
@@ -1957,7 +2331,7 @@ async function chainStepRewardAddress(context, blockViewer, { block, step }) {
   const rewardEntry = Object.entries(mergedTransfers).find(([address]) => address === XYO_STEP_REWARD_ADDRESS);
   const fromEntries = Object.entries(rewardEntry?.[1] ?? {});
   const sortedTransferAmounts = fromEntries.toSorted(([, a], [, b]) => a > b ? -1 : a < b ? 1 : 0);
-  assertEx14(
+  assertEx16(
     sortedTransferAmounts.length === transferCount,
     () => `Step Transfers mismatch ${block} (${blockBw._hash}) [${sortedTransferAmounts.length} - ${transferCount}]`
   );
@@ -1965,7 +2339,7 @@ async function chainStepRewardAddress(context, blockViewer, { block, step }) {
 }
 
 // src/primitives/chain/step/stepRewardTotal.ts
-import { assertEx as assertEx15, isDefined as isDefined11 } from "@xylabs/sdk-js";
+import { assertEx as assertEx17, isDefined as isDefined11 } from "@xylabs/sdk-js";
 import {
   asAttoXL1,
   asXL1BlockRange as asXL1BlockRange5,
@@ -2061,15 +2435,15 @@ async function stepRewardTotal(context, blockViewer, { block, step }, multiplier
   const cacheKey = `${block}|${step}|${isDefined11(multipliers)}`;
   return await withContextCacheResponse(context, "stepRewardTotal", cacheKey, async () => {
     const [blockBw, payloads] = await stepRewardBlock(context, blockViewer, { block, step });
-    assertEx15(blockBw.block === block, () => `Block Mismatch: expected ${block}, got ${blockBw.block}`);
+    assertEx17(blockBw.block === block, () => `Block Mismatch: expected ${block}, got ${blockBw.block}`);
     const [transferIndex] = stepTransferIndex(block, step);
-    const stepTransfer = assertEx15(
+    const stepTransfer = assertEx17(
       payloads.find((p) => isTransfer5(p) && p.from === XYO_STEP_REWARD_ADDRESS2),
       () => `No step transfer found for step ${step} at block ${block} (${blockBw._hash})`
     );
     const netTransfers = netTransfersForPayloads(context, [stepTransfer]);
     const rewardEntry = Object.entries(netTransfers).find(([address]) => address === XYO_STEP_REWARD_ADDRESS2);
-    const rewards = assertEx15(
+    const rewards = assertEx17(
       rewardEntry?.[1],
       () => `No rewards found for step reward address ${XYO_STEP_REWARD_ADDRESS2} at block ${block} (${blockBw._hash})`
     );
@@ -2112,7 +2486,7 @@ async function stepsRewardTotal(context, blockViewer, steps, multipliers) {
 }
 
 // src/primitives/chain/time/externalBlockNumberFromXl1BlockNumber.ts
-import { assertEx as assertEx16, isArray } from "@xylabs/sdk-js";
+import { assertEx as assertEx18, isArray } from "@xylabs/sdk-js";
 import {
   asBlockNumber,
   asTimePayload,
@@ -2123,7 +2497,7 @@ async function externalBlockNumberFromXL1BlockNumber(context, blockViewer, xl1Bl
   const cacheKey = `${xl1BlockNumber}-${externalTimeName}-${externalGenesisTime ?? "default"}`;
   return await withContextCacheResponse(context, functionName, cacheKey, async () => {
     const [, payloads = []] = await blockViewer.blockByNumber(xl1BlockNumber) ?? [];
-    assertEx16(isArray(payloads));
+    assertEx18(isArray(payloads));
     const timePayload = asTimePayload(payloads.find(isTimePayload));
     return asBlockNumber(
       timePayload?.[externalTimeName] ?? externalGenesisTime ?? 23372716,
@@ -2440,7 +2814,7 @@ var findMostRecentBlock = async (chainArchivist, nextOptions = DEFAULT_NEXT_OPTI
 };
 
 // src/primitives/state/hydratedBlockByNumber.ts
-import { assertEx as assertEx17, spanAsync as spanAsync2 } from "@xylabs/sdk-js";
+import { assertEx as assertEx19, spanAsync as spanAsync2 } from "@xylabs/sdk-js";
 async function hydratedBlockByNumber(context, blockNumber) {
   return await spanAsync2("hydratedBlockByNumber", async () => {
     if (blockNumber < 0) throw new Error(`Block number ${blockNumber} is less than 0`);
@@ -2448,7 +2822,7 @@ async function hydratedBlockByNumber(context, blockNumber) {
     if (blockNumber % 1 !== 0) throw new Error(`Block number ${blockNumber} is not an integer`);
     const cacheKey = String(blockNumber);
     return await withContextCacheResponse(context, "hydratedBlockByNumber", cacheKey, async () => {
-      const block = assertEx17(
+      const block = assertEx19(
         await blockFromBlockNumber(context, blockNumber),
         () => `Could not find block for block number ${blockNumber}`
       );
@@ -2499,7 +2873,7 @@ function findBestUncle(finalizedWindowedChain, uncles, options) {
 
 // src/primitives/uncle/findUncles.ts
 import {
-  assertEx as assertEx18,
+  assertEx as assertEx20,
   exists as exists2
 } from "@xylabs/sdk-js";
 import { isTransactionBoundWitness as isTransactionBoundWitness2 } from "@xyo-network/xl1-protocol-lib";
@@ -2532,7 +2906,7 @@ function blocksToChains(blocks) {
 }
 function toValidUncle(_context, finalizedWindowedChain, possibleUncle) {
   const finalizedWindowStartBlockNumber = finalizedWindowedChain.at(0)?.[0].block ?? -1;
-  const finalizedHead = assertEx18(finalizedWindowedChain.at(-1), () => "finalizedWindowedChain is empty");
+  const finalizedHead = assertEx20(finalizedWindowedChain.at(-1), () => "finalizedWindowedChain is empty");
   const prunedPossibleUncle = possibleUncle.filter((b) => b[0].block > finalizedHead[0].block);
   if (prunedPossibleUncle.length === 0) {
     return;
@@ -2651,44 +3025,6 @@ function resolveConfig(config) {
   return parsedConfig;
 }
 
-// src/config/normalizeConnectionsConfig.ts
-function mergeConnectionMaps(transports, connections) {
-  return { ...transports, ...connections };
-}
-function normalizeProviderBinding(binding) {
-  const connectionName = binding.connection ?? binding.transport;
-  if (connectionName === void 0 || connectionName === "") {
-    return binding;
-  }
-  return {
-    ...binding,
-    connection: connectionName,
-    transport: connectionName
-  };
-}
-function normalizeProviderBindings(bindings) {
-  const normalized = {};
-  for (const [moniker, binding] of Object.entries(bindings)) {
-    if (binding === void 0) continue;
-    normalized[moniker] = normalizeProviderBinding(binding);
-  }
-  return normalized;
-}
-function normalizeConnectionsConfig(config) {
-  const transports = config.transports ?? {};
-  const connections = config.connections ?? {};
-  const merged = mergeConnectionMaps(transports, connections);
-  return {
-    ...config,
-    connections: merged,
-    providerBindings: normalizeProviderBindings(config.providerBindings ?? {}),
-    transports: merged
-  };
-}
-function hasDeclaredConnectionProfiles(config) {
-  return Object.keys(config.transports ?? {}).length > 0 || Object.keys(config.connections ?? {}).length > 0;
-}
-
 // src/config/adaptLegacyConfig.ts
 var DEFAULT_LMDB_TRANSPORT = "local-store";
 var DEFAULT_RPC_TRANSPORT = "default-rpc";
@@ -2767,9 +3103,16 @@ var LMDB_MONIKERS = [
   "FinalizationViewer",
   "MempoolRunner",
   "MempoolViewer",
+  "NetworkStakeViewer",
+  "NetworkStakeStepRewardsByPositionViewer",
+  "NetworkStakeStepRewardsByStakerViewer",
+  "NetworkStakeStepRewardsByStepViewer",
+  "NetworkStakeStepRewardsTotalViewer",
+  "NetworkStakeStepRewardsViewer",
   "StakeEventsViewer",
   "StakeTotalsViewer",
   "StakeViewer",
+  "StepViewer",
   "TimeSyncViewer",
   "TransactionValidationViewer",
   "TransactionViewer",
@@ -2779,6 +3122,27 @@ var LMDB_MONIKERS = [
   "XyoRunner",
   "XyoViewer"
 ];
+var RPC_MONIKERS = [
+  "AccountBalanceViewer",
+  "BlockRewardViewer",
+  "BlockViewer",
+  "FinalizationViewer",
+  "MempoolRunner",
+  "MempoolViewer",
+  "NetworkStakeViewer",
+  "NetworkStakeStepRewardsByPositionViewer",
+  "NetworkStakeStepRewardsByStakerViewer",
+  "NetworkStakeStepRewardsByStepViewer",
+  "NetworkStakeStepRewardsTotalViewer",
+  "NetworkStakeStepRewardsViewer",
+  "StakeEventsViewer",
+  "StakeViewer",
+  "StepViewer",
+  "TimeSyncViewer",
+  "TransactionViewer",
+  "WindowedBlockViewer",
+  "XyoViewer"
+];
 function synthesizeLmdbProviderBindings(transports) {
   const bindings = {};
   if (!hasTransport(transports, DEFAULT_LMDB_TRANSPORT)) {
@@ -2792,11 +3156,9 @@ function synthesizeLmdbProviderBindings(transports) {
 function synthesizeProviderBindings(transports) {
   const bindings = {};
   if (hasTransport(transports, DEFAULT_RPC_TRANSPORT)) {
-    bindMoniker2(bindings, "BlockViewer", DEFAULT_RPC_TRANSPORT);
-    bindMoniker2(bindings, "MempoolViewer", DEFAULT_RPC_TRANSPORT);
-    bindMoniker2(bindings, "FinalizationViewer", DEFAULT_RPC_TRANSPORT);
-    bindMoniker2(bindings, "TransactionViewer", DEFAULT_RPC_TRANSPORT);
-    bindMoniker2(bindings, "AccountBalanceViewer", DEFAULT_RPC_TRANSPORT);
+    for (const moniker of RPC_MONIKERS) {
+      bindMoniker2(bindings, moniker, DEFAULT_RPC_TRANSPORT);
+    }
   }
   if (hasTransport(transports, S3_FINALIZED_TRANSPORT)) {
     bindMoniker2(bindings, "BlockPublishRunner", S3_FINALIZED_TRANSPORT);
@@ -2989,7 +3351,7 @@ import { PayloadBundleSchema as PayloadBundleSchema2 } from "@xyo-network/sdk-js
 import { PayloadBuilder as PayloadBuilder12 } from "@xyo-network/sdk-js";
 
 // src/transaction/buildTransaction.ts
-import { assertEx as assertEx19, toHex } from "@xylabs/sdk-js";
+import { assertEx as assertEx21, toHex } from "@xylabs/sdk-js";
 import {
   asAnyPayload as asAnyPayload2,
   BoundWitnessBuilder,
@@ -3015,7 +3377,7 @@ async function buildTransaction(chain, onChainPayloads, offChainPayloads, signer
   const script = Array.from(elevatedHashes, (elevatedHash) => `elevate|${elevatedHash}`);
   const fields = {
     ...txBoundWitnessFields,
-    from: from ?? (Array.isArray(signer) ? assertEx19(signer.at(0)?.address) : signer.address)
+    from: from ?? (Array.isArray(signer) ? assertEx21(signer.at(0)?.address) : signer.address)
   };
   if (script.length > 0) {
     fields.script = script;
@@ -3100,7 +3462,7 @@ var confirmSubmittedTransaction = async (viewer, txHash, options) => {
 };
 
 // src/transaction/hydrateTransaction.ts
-import { assertEx as assertEx20 } from "@xylabs/sdk-js";
+import { assertEx as assertEx22 } from "@xylabs/sdk-js";
 import {
   asAnyPayload as asAnyPayload3,
   hydrateTypedBoundWitness,
@@ -3171,7 +3533,7 @@ var tryHydrateElevatedTransaction = async ({ chainMap }, hash) => {
   return void 0;
 };
 var hydrateElevatedTransaction = async (context, hash) => {
-  return assertEx20(await tryHydrateElevatedTransaction(context, hash), () => "Hydration failed");
+  return assertEx22(await tryHydrateElevatedTransaction(context, hash), () => "Hydration failed");
 };
 
 // src/transaction/primitives/transactionBlockByteCount.ts
@@ -3224,13 +3586,13 @@ function transactionRequiredGas(hydratedTransaction) {
 
 // src/transaction/signTransaction.ts
 import {
-  assertEx as assertEx21,
+  assertEx as assertEx23,
   hexFromArrayBuffer,
   toArrayBuffer
 } from "@xylabs/sdk-js";
 import { PayloadBuilder as PayloadBuilder10 } from "@xyo-network/sdk-js";
 async function signTransaction(tx, account) {
-  assertEx21(tx.from === account.address, () => "Signer address does not match transaction from address");
+  assertEx23(tx.from === account.address, () => "Signer address does not match transaction from address");
   const unsignedTx = structuredClone(tx);
   unsignedTx.addresses = [account.address];
   unsignedTx.previous_hashes = [account.previousHash ?? null];
@@ -3245,7 +3607,7 @@ async function signTransaction(tx, account) {
 }
 
 // src/transaction/TransactionBuilder.ts
-import { assertEx as assertEx22, Base } from "@xylabs/sdk-js";
+import { assertEx as assertEx24, Base } from "@xylabs/sdk-js";
 import { PayloadBuilder as PayloadBuilder11 } from "@xyo-network/sdk-js";
 import {
   asXL1BlockNumber as asXL1BlockNumber4,
@@ -3265,9 +3627,9 @@ var TransactionBuilder = class extends Base {
     super(options);
   }
   async build() {
-    const chain = assertEx22(this._chain, () => "Chain must be set before building the transaction");
-    const fees = assertEx22(this._fees, () => "Fees must be set before building the transaction");
-    const blockRange = assertEx22(this._blockRange, () => "Block range must be set before building the transaction");
+    const chain = assertEx24(this._chain, () => "Chain must be set before building the transaction");
+    const fees = assertEx24(this._fees, () => "Fees must be set before building the transaction");
+    const blockRange = assertEx24(this._blockRange, () => "Block range must be set before building the transaction");
     return await buildTransaction(
       chain,
       this._elevatedPayloads,
@@ -3297,7 +3659,7 @@ var TransactionBuilder = class extends Base {
   }
   elevatedPayload(payload) {
     const allowedPayload = isAllowedBlockPayload2(payload) ? payload : void 0;
-    const allowPayloadExists = assertEx22(allowedPayload, () => "Payload must be an AllowedBlockPayload");
+    const allowPayloadExists = assertEx24(allowedPayload, () => "Payload must be an AllowedBlockPayload");
     this._elevatedPayloads.push(allowPayloadExists);
     return this;
   }
@@ -3346,158 +3708,64 @@ var TransactionBuilder = class extends Base {
   async removeElevatedPayload(payload) {
     const hash = await PayloadBuilder11.hash(payload);
     const existingHashes = await PayloadBuilder11.hashes(this._elevatedPayloads);
-    const existingPayloadIndex = existingHashes.indexOf(hash);
-    if (existingPayloadIndex === -1) {
-      throw new Error("Payload not found in the transaction");
-    }
-    this._elevatedPayloads = this._elevatedPayloads.filter((_, index) => index !== existingPayloadIndex);
-    return this;
-  }
-  async removePayload(payload) {
-    const hash = await PayloadBuilder11.hash(payload);
-    const existingHashes = await PayloadBuilder11.hashes(this._payloads);
-    const existingPayloadIndex = existingHashes.indexOf(hash);
-    if (existingPayloadIndex === -1) {
-      throw new Error("Payload not found in the transaction");
-    }
-    this._payloads = this._payloads.filter((_, index) => index !== existingPayloadIndex);
-    return this;
-  }
-  signer(signer) {
-    if (signer) {
-      this._signers.push(signer);
-    }
-    return this;
-  }
-  signers(signers) {
-    if (signers)
-      for (const signer of signers) {
-        if (signer !== null) {
-          this.signer(signer);
-        }
-      }
-    return this;
-  }
-};
-
-// src/model/PayloadBundle/hydratedTransactionToPayloadBundle.ts
-var hydratedTransactionToPayloadBundle = (transaction) => {
-  const root = transaction[0]._hash;
-  return bundle2(root, transaction);
-};
-var bundle2 = (root, transaction) => {
-  const payloads = flattenHydratedTransaction(transaction);
-  const payloadBuilder = new PayloadBuilder12({ schema: PayloadBundleSchema2 });
-  const builder = payloadBuilder.fields({ payloads, root });
-  return builder.build();
-};
-
-// src/context/Actor.ts
-var ActorConfigContext = z26.extend(BaseConfigContextZod, { config: ActorConfigZod });
-var isActorConfigContext = zodIsFactory5(ActorConfigContext);
-var asActorConfigContext = zodAsFactory6(ActorConfigContext, "asActorConfigContext");
-var toActorConfigContext = zodToFactory5(ActorConfigContext, "toActorConfigContext");
-
-// src/CreatableProvider/AbstractCreatableProvider.ts
-import {
-  AbstractCreatable,
-  assertEx as assertEx24,
-  IdLogger
-} from "@xylabs/sdk-js";
-
-// src/CreatableProvider/ProviderFactory.ts
-import { assertEx as assertEx23 } from "@xylabs/sdk-js";
-function providerFactoryDescription(factory, labels) {
-  return `${factory.providerName}:${factory.defaultMoniker}:${JSON.stringify(labels ?? factory.labels ?? {})}`;
-}
-var ProviderFactory = class _ProviderFactory {
-  creatableProvider;
-  defaultMoniker;
-  defaultParams;
-  dependencies;
-  labels;
-  monikers;
-  providerName;
-  scope;
-  _uniqueId;
-  constructor(creatableProvider2, dependencies, params, labels = {}, scope = "context") {
-    this.creatableProvider = creatableProvider2;
-    this.defaultParams = params;
-    this.defaultMoniker = creatableProvider2.defaultMoniker;
-    this.dependencies = dependencies;
-    this.monikers = creatableProvider2.monikers;
-    this.scope = scope;
-    assertEx23(this.monikers.includes(this.defaultMoniker), () => "defaultMoniker must be in monikers");
-    this.labels = Object.assign({}, creatableProvider2.labels ?? {}, labels ?? {});
-    this.providerName = creatableProvider2.name;
-    this._uniqueId = Symbol(providerFactoryDescription(this));
-  }
-  get resolvedMoniker() {
-    const labels = this.labels ?? {};
-    const labelString = Object.entries(labels).map(([key, value]) => `${key}=${value}`).join(",");
-    return labelString.length === 0 ? this.defaultMoniker : `${this.defaultMoniker}|${labelString}`;
-  }
-  get uniqueId() {
-    return this._uniqueId;
-  }
-  static withParams(creatableProvider2, dependencies, params, labels = {}) {
-    return new _ProviderFactory(creatableProvider2, dependencies, params, labels);
-  }
-  factory(dependencies, params, labels = {}) {
-    return new _ProviderFactory(this.creatableProvider, dependencies, params, labels);
-  }
-  async getInstance(params, { start = true }) {
-    let scopeObject;
-    switch (this.scope) {
-      case "global": {
-        scopeObject = getOrCreateGlobalSingletons();
-        break;
-      }
-      case "context": {
-        const context = assertEx23(
-          params?.context,
-          () => "Context is required for context-scoped providers"
-        );
-        context.singletons ??= {};
-        scopeObject = context.singletons;
-        break;
-      }
-      default: {
-        scopeObject = {};
-        break;
-      }
-    }
-    const mergedParams = {
-      ...this.defaultParams,
-      ...params
-    };
-    const resultPromise = scopeObject[this.resolvedMoniker] ?? this.creatableProvider.create(mergedParams);
-    scopeObject[this.resolvedMoniker] = resultPromise;
-    const result = await resultPromise;
-    if (start) {
-      assertEx23(await result.start(), () => `Failed to start provider instance [${this.resolvedMoniker}]`);
+    const existingPayloadIndex = existingHashes.indexOf(hash);
+    if (existingPayloadIndex === -1) {
+      throw new Error("Payload not found in the transaction");
     }
-    return result;
+    this._elevatedPayloads = this._elevatedPayloads.filter((_, index) => index !== existingPayloadIndex);
+    return this;
   }
-  async tryGetInstance(params, options) {
-    try {
-      return await this.getInstance(params, options);
-    } catch {
-      return;
+  async removePayload(payload) {
+    const hash = await PayloadBuilder11.hash(payload);
+    const existingHashes = await PayloadBuilder11.hashes(this._payloads);
+    const existingPayloadIndex = existingHashes.indexOf(hash);
+    if (existingPayloadIndex === -1) {
+      throw new Error("Payload not found in the transaction");
     }
+    this._payloads = this._payloads.filter((_, index) => index !== existingPayloadIndex);
+    return this;
   }
-};
-function getOrCreateGlobalSingletons() {
-  const existing = globalThis.xyoServiceSingletons;
-  if (existing !== void 0) {
-    return existing;
+  signer(signer) {
+    if (signer) {
+      this._signers.push(signer);
+    }
+    return this;
   }
-  const singletons = {};
-  Reflect.set(globalThis, "xyoServiceSingletons", singletons);
-  return singletons;
-}
+  signers(signers) {
+    if (signers)
+      for (const signer of signers) {
+        if (signer !== null) {
+          this.signer(signer);
+        }
+      }
+    return this;
+  }
+};
+
+// src/model/PayloadBundle/hydratedTransactionToPayloadBundle.ts
+var hydratedTransactionToPayloadBundle = (transaction) => {
+  const root = transaction[0]._hash;
+  return bundle2(root, transaction);
+};
+var bundle2 = (root, transaction) => {
+  const payloads = flattenHydratedTransaction(transaction);
+  const payloadBuilder = new PayloadBuilder12({ schema: PayloadBundleSchema2 });
+  const builder = payloadBuilder.fields({ payloads, root });
+  return builder.build();
+};
+
+// src/context/Actor.ts
+var ActorConfigContext = z26.extend(BaseConfigContextZod, { config: ActorConfigZod });
+var isActorConfigContext = zodIsFactory5(ActorConfigContext);
+var asActorConfigContext = zodAsFactory6(ActorConfigContext, "asActorConfigContext");
+var toActorConfigContext = zodToFactory5(ActorConfigContext, "toActorConfigContext");
 
 // src/CreatableProvider/AbstractCreatableProvider.ts
+import {
+  AbstractCreatable,
+  assertEx as assertEx25,
+  IdLogger
+} from "@xylabs/sdk-js";
 var AbstractCreatableProvider = class extends AbstractCreatable {
   dependencies = {};
   _contextCache;
@@ -3529,9 +3797,9 @@ var AbstractCreatableProvider = class extends AbstractCreatable {
     return factory;
   }
   static async paramsHandler(params = {}) {
-    const context = assertEx24(params.context, () => new Error("Context is required"));
-    const config = assertEx24(context.config, () => new Error("Context config is required"));
-    const locator = assertEx24(context.locator, () => new Error("Context locator is required"));
+    const context = assertEx25(params.context, () => new Error("Context is required"));
+    const config = assertEx25(context.config, () => new Error("Context config is required"));
+    const locator = assertEx25(context.locator, () => new Error("Context locator is required"));
     return await super.paramsHandler({
       ...params,
       statusReporter: params.statusReporter ?? context.statusReporter,
@@ -3573,203 +3841,6 @@ function labeledCreatableProvider() {
   };
 }
 
-// src/CreatableProvider/CreatableProviderRegistry.ts
-import { isTruthy } from "@xylabs/sdk-js";
-var buildProviderFactory = (provider, defaultParams, labels) => {
-  const factory = {
-    monikers: provider.monikers,
-    uniqueId: Symbol(providerFactoryDescription(provider, labels)),
-    // Merge module & supplied labels
-    labels: { ...provider.labels, ...labels },
-    creatableProvider: provider.creatableProvider,
-    dependencies: provider.dependencies,
-    resolvedMoniker: provider.resolvedMoniker,
-    providerName: provider.providerName,
-    scope: provider.scope,
-    defaultParams,
-    getInstance: provider.getInstance.bind(provider),
-    tryGetInstance: provider.tryGetInstance?.bind(provider),
-    defaultMoniker: provider.defaultMoniker,
-    factory: provider.factory.bind(provider)
-  };
-  return factory;
-};
-var registerCreatableProviderFactory = (registry, factory, labels, primary = false) => {
-  const primaryMonikers = primary !== true && isTruthy(primary) ? Array.isArray(primary) ? primary : [primary] : [];
-  for (const primaryMoniker of primaryMonikers) {
-    if (!factory.monikers.includes(primaryMoniker)) {
-      throw new Error(`Primary moniker ${String(primaryMoniker)} not found in factory monikers`);
-    }
-  }
-  const isPrimaryForMoniker = (moniker) => {
-    switch (typeof primary) {
-      case "boolean": {
-        return primary;
-      }
-      case "string": {
-        return moniker === primary;
-      }
-      case "object": {
-        if (Array.isArray(primary)) {
-          return primary.includes(moniker);
-        }
-      }
-    }
-    throw new Error(`Invalid primary value: ${String(primary)}`);
-  };
-  const factoryClone = buildProviderFactory(factory, factory.defaultParams, labels);
-  registry[factoryClone.defaultMoniker] = [factoryClone, ...registry[factoryClone.defaultMoniker] ?? []];
-  for (const moniker of factoryClone.monikers) {
-    if (moniker === factoryClone.defaultMoniker) continue;
-    registry[moniker] = isPrimaryForMoniker(moniker) ? [factoryClone, ...registry[moniker] ?? []] : [...registry[moniker] ?? [], factoryClone];
-  }
-};
-var registerCreatableProviderFactories = (factories, registry = {}, primary = false) => {
-  for (const factory of factories) {
-    registerCreatableProviderFactory(registry, factory, void 0, primary);
-  }
-  return registry;
-};
-
-// src/CreatableProvider/LabeledCreatableProviderFactory.ts
-var hasLabels = (factory) => {
-  return factory.labels !== void 0;
-};
-function labeledCreatableProviderFactory() {
-  return (constructor) => {
-    constructor;
-  };
-}
-
-// src/CreatableProvider/ProviderFactoryLocator.ts
-import { hasAllLabels } from "@xylabs/sdk-js";
-import { assertEx as assertEx25 } from "@xylabs/sdk-js";
-var ProviderFactoryLocator = class _ProviderFactoryLocator {
-  _context;
-  _registry;
-  _frozen = false;
-  _parent;
-  _validateDepsOnRegister;
-  constructor(context, registry = {}, validateDepsOnRegister = false) {
-    this._registry = registry;
-    this._context = { ...context, locator: this };
-    this._parent = context.locator;
-    this._validateDepsOnRegister = validateDepsOnRegister;
-  }
-  get context() {
-    return this._context;
-  }
-  get logger() {
-    return this.context.logger;
-  }
-  /**
-   * The current registry for the module factory
-   */
-  get registry() {
-    return this._registry;
-  }
-  get validateDepsOnRegister() {
-    return this._validateDepsOnRegister;
-  }
-  freeze() {
-    this._frozen = true;
-  }
-  async getInstance(moniker, { start = true, labels } = {}) {
-    return assertEx25(
-      await this.tryGetInstance(moniker, { start, labels }),
-      () => `No provider instance for the supplied config moniker [${moniker}]${labels ? ` & labels [${JSON.stringify(labels)}]` : ""} could be created`
-    );
-  }
-  has(moniker) {
-    return Object.hasOwn(this._registry, moniker);
-  }
-  /**
-   * Locates a provider factory that matches the supplied moniker and labels
-   * @param moniker The config moniker for the provider
-   * @param labels The labels for the provider factory
-   * @returns A provider factory that matches the supplied moniker and labels or throws if one is not found
-   */
-  locate(moniker, labels) {
-    return assertEx25(
-      this.tryLocate(moniker, labels),
-      () => `No module factory for the supplied config moniker [${moniker}]${labels ? ` & labels [${JSON.stringify(labels)}]` : ""} registered`
-    );
-  }
-  merge(locator) {
-    const registry = { ...this.registry };
-    for (const moniker in locator.registry) {
-      const existing = registry[moniker];
-      if (existing === void 0) {
-        registry[moniker] = locator.registry[moniker];
-      } else {
-        existing.push(...locator.registry[moniker] ?? []);
-      }
-    }
-    return new _ProviderFactoryLocator(this.context, registry);
-  }
-  /**
-   * Registers a single module factory (with optional tags) with the locator
-   * @param factory The factory to register
-   * @param labels The labels for the module factory
-   */
-  register(factory, labels, primary = false) {
-    assertEx25(!this._frozen, () => "Cannot register a module factory after the locator has been frozen");
-    if (this.validateDepsOnRegister) {
-      const missingDeps = factory.dependencies.filter((dep) => !this.registered(dep));
-      assertEx25(missingDeps.length === 0, () => `Cannot register module factory [${factory.uniqueId.description}] due to missing dependencies: ${missingDeps.join(", ")}`);
-    }
-    registerCreatableProviderFactory(this._registry, factory, labels, primary);
-    return this;
-  }
-  /**
-   * Registers multiple module factories with the locator
-   * @param factories The factories to register
-   */
-  registerMany(factories) {
-    for (const factory of factories) {
-      this.register(factory);
-    }
-    return this;
-  }
-  registered(moniker) {
-    return Object.hasOwn(this.registry, moniker) || (this._parent?.registered(moniker) ?? false);
-  }
-  async tryGetInstance(moniker, { start = true, labels } = {}) {
-    const resolvedParams = { context: this.context };
-    const factory = this.tryLocate(moniker, labels);
-    if (factory !== void 0) {
-      if (Object.hasOwn(this.context.singletons, factory.uniqueId)) {
-        return this.context.singletons[factory.uniqueId];
-      }
-      this.logger?.debug(`Creating provider instance for moniker [${moniker}]${labels ? ` with labels [${JSON.stringify(labels)}]` : ""} using factory [${factory.uniqueId.description}]`);
-      const result = await factory.getInstance(resolvedParams, { start });
-      this.context.singletons[factory.uniqueId] = result;
-      return result;
-    }
-  }
-  /**
-   * Tries to locate a module factory that matches the supplied moniker and labels
-   * @param moniker The config moniker for the module
-   * @param labels The labels for the module factory
-   * @returns A module factory that matches the supplied moniker and labels or undefined
-   */
-  tryLocate(moniker, labels) {
-    const result = (labels ? this._registry[moniker]?.filter(hasLabels).find((factory) => hasAllLabels(factory?.labels, labels)) ?? this._registry[moniker]?.[0] : this._registry[moniker]?.[0]) ?? this._parent?.tryLocate(moniker, labels);
-    return result;
-  }
-  validateDependencies(recursive = false) {
-    if (recursive) {
-      this._parent?.validateDependencies();
-    }
-    for (const moniker in this.registry) {
-      for (const factory of this.registry[moniker] ?? []) {
-        const missingDeps = factory.dependencies.filter((dep) => !this.registered(dep));
-        assertEx25(missingDeps.length === 0, () => `Module factory [${factory.uniqueId.description}] is missing dependencies: ${missingDeps.join(", ")}`);
-      }
-    }
-  }
-};
-
 // src/context/getEmptyProviderContext.ts
 function getEmptyProviderContext(config) {
   const singletons = {};
@@ -4638,9 +4709,11 @@ var SimpleAccountBalanceViewer = class extends AbstractCreatableProvider {
     }, this.context);
   }
 };
+__publicField(SimpleAccountBalanceViewer, "connectionTypes", ["lmdb", "mongo"]);
 __publicField(SimpleAccountBalanceViewer, "defaultMoniker", AccountBalanceViewerMoniker);
 __publicField(SimpleAccountBalanceViewer, "dependencies", [BlockViewerMoniker]);
 __publicField(SimpleAccountBalanceViewer, "monikers", [AccountBalanceViewerMoniker]);
+__publicField(SimpleAccountBalanceViewer, "surface", "node");
 SimpleAccountBalanceViewer = __decorateClass([
   creatableProvider()
 ], SimpleAccountBalanceViewer);
@@ -4938,9 +5011,11 @@ var SimpleBlockViewer = class extends AbstractCreatableProvider {
     this._headPollTimer = null;
   }
 };
+__publicField(SimpleBlockViewer, "connectionTypes", ["lmdb", "mongo"]);
 __publicField(SimpleBlockViewer, "defaultMoniker", BlockViewerMoniker2);
 __publicField(SimpleBlockViewer, "dependencies", [FinalizationViewerMoniker]);
 __publicField(SimpleBlockViewer, "monikers", [BlockViewerMoniker2]);
+__publicField(SimpleBlockViewer, "surface", "node");
 SimpleBlockViewer = __decorateClass([
   creatableProvider()
 ], SimpleBlockViewer);
@@ -4955,9 +5030,11 @@ var SimpleBlockRewardViewer = class extends AbstractCreatableProvider {
     );
   }
 };
+__publicField(SimpleBlockRewardViewer, "connectionTypes", ["lmdb", "mongo", "rpc"]);
 __publicField(SimpleBlockRewardViewer, "defaultMoniker", BlockRewardViewerMoniker);
 __publicField(SimpleBlockRewardViewer, "dependencies", []);
 __publicField(SimpleBlockRewardViewer, "monikers", [BlockRewardViewerMoniker]);
+__publicField(SimpleBlockRewardViewer, "surface", "node");
 SimpleBlockRewardViewer = __decorateClass([
   creatableProvider()
 ], SimpleBlockRewardViewer);
@@ -5097,9 +5174,11 @@ var SimpleBlockValidationViewer = class extends AbstractCreatableProvider {
     return [...this._uncleWindowedChainCache];
   }
 };
+__publicField(SimpleBlockValidationViewer, "connectionTypes", ["lmdb", "mongo", "rpc"]);
 __publicField(SimpleBlockValidationViewer, "defaultMoniker", BlockValidationViewerMoniker);
 __publicField(SimpleBlockValidationViewer, "dependencies", [AccountBalanceViewerMoniker2, BlockViewerMoniker3, ChainContractViewerMoniker]);
 __publicField(SimpleBlockValidationViewer, "monikers", [BlockValidationViewerMoniker]);
+__publicField(SimpleBlockValidationViewer, "surface", "node");
 SimpleBlockValidationViewer = __decorateClass([
   creatableProvider()
 ], SimpleBlockValidationViewer);
@@ -5155,9 +5234,11 @@ var SimpleChainContractViewer = class extends AbstractCreatableProvider {
     return this.params.stakingTokenAddress;
   }
 };
+__publicField(SimpleChainContractViewer, "connectionTypes", ["lmdb", "mongo"]);
 __publicField(SimpleChainContractViewer, "defaultMoniker", ChainContractViewerMoniker2);
 __publicField(SimpleChainContractViewer, "dependencies", [FinalizationViewerMoniker2]);
 __publicField(SimpleChainContractViewer, "monikers", [ChainContractViewerMoniker2]);
+__publicField(SimpleChainContractViewer, "surface", "node");
 SimpleChainContractViewer = __decorateClass([
   creatableProvider()
 ], SimpleChainContractViewer);
@@ -5258,9 +5339,11 @@ var RestDataLakeRunner = class extends AbstractRestDataLake {
     return [];
   }
 };
+__publicField(RestDataLakeRunner, "connectionTypes", ["rest"]);
 __publicField(RestDataLakeRunner, "defaultMoniker", DataLakeRunnerMoniker);
 __publicField(RestDataLakeRunner, "dependencies", []);
 __publicField(RestDataLakeRunner, "monikers", [DataLakeRunnerMoniker]);
+__publicField(RestDataLakeRunner, "surface", "node");
 RestDataLakeRunner = __decorateClass([
   creatableProvider()
 ], RestDataLakeRunner);
@@ -5270,9 +5353,11 @@ import { DataLakeViewerMoniker } from "@xyo-network/xl1-protocol-lib";
 var RestDataLakeViewer = class extends AbstractRestDataLake {
   moniker = RestDataLakeViewer.defaultMoniker;
 };
+__publicField(RestDataLakeViewer, "connectionTypes", ["rest"]);
 __publicField(RestDataLakeViewer, "defaultMoniker", DataLakeViewerMoniker);
 __publicField(RestDataLakeViewer, "dependencies", []);
 __publicField(RestDataLakeViewer, "monikers", [DataLakeViewerMoniker]);
+__publicField(RestDataLakeViewer, "surface", "node");
 RestDataLakeViewer = __decorateClass([
   creatableProvider()
 ], RestDataLakeViewer);
@@ -5341,9 +5426,11 @@ var SimpleDataLakeRunner = class extends AbstractSimpleDataLake {
     return hashPairs.map(([payload]) => payload);
   }
 };
+__publicField(SimpleDataLakeRunner, "connectionTypes", []);
 __publicField(SimpleDataLakeRunner, "defaultMoniker", DataLakeRunnerMoniker2);
 __publicField(SimpleDataLakeRunner, "dependencies", []);
 __publicField(SimpleDataLakeRunner, "monikers", [DataLakeRunnerMoniker2]);
+__publicField(SimpleDataLakeRunner, "surface", "node");
 SimpleDataLakeRunner = __decorateClass([
   creatableProvider()
 ], SimpleDataLakeRunner);
@@ -5353,9 +5440,11 @@ import { DataLakeViewerMoniker as DataLakeViewerMoniker2 } from "@xyo-network/xl
 var SimpleDataLakeViewer = class extends AbstractSimpleDataLake {
   moniker = SimpleDataLakeViewer.defaultMoniker;
 };
+__publicField(SimpleDataLakeViewer, "connectionTypes", []);
 __publicField(SimpleDataLakeViewer, "defaultMoniker", DataLakeViewerMoniker2);
 __publicField(SimpleDataLakeViewer, "dependencies", []);
 __publicField(SimpleDataLakeViewer, "monikers", [DataLakeViewerMoniker2]);
+__publicField(SimpleDataLakeViewer, "surface", "node");
 SimpleDataLakeViewer = __decorateClass([
   creatableProvider()
 ], SimpleDataLakeViewer);
@@ -5383,9 +5472,11 @@ var SimpleFinalizationRunner = class extends AbstractCreatableProvider {
     return sortedBlocks.map((b) => b[0]._hash);
   }
 };
+__publicField(SimpleFinalizationRunner, "connectionTypes", ["lmdb", "mongo"]);
 __publicField(SimpleFinalizationRunner, "defaultMoniker", FinalizationRunnerMoniker);
 __publicField(SimpleFinalizationRunner, "dependencies", []);
 __publicField(SimpleFinalizationRunner, "monikers", [FinalizationRunnerMoniker]);
+__publicField(SimpleFinalizationRunner, "surface", "node");
 SimpleFinalizationRunner = __decorateClass([
   creatableProvider()
 ], SimpleFinalizationRunner);
@@ -5475,9 +5566,11 @@ var SimpleFinalizationViewer = class extends AbstractCreatableProvider {
     return result;
   }
 };
+__publicField(SimpleFinalizationViewer, "connectionTypes", ["lmdb", "mongo"]);
 __publicField(SimpleFinalizationViewer, "defaultMoniker", FinalizationViewerMoniker3);
 __publicField(SimpleFinalizationViewer, "dependencies", [ChainContractViewerMoniker3]);
 __publicField(SimpleFinalizationViewer, "monikers", [FinalizationViewerMoniker3]);
+__publicField(SimpleFinalizationViewer, "surface", "node");
 SimpleFinalizationViewer = __decorateClass([
   creatableProvider()
 ], SimpleFinalizationViewer);
@@ -6025,9 +6118,11 @@ var SimpleMempoolRunner = class extends AbstractCreatableProvider {
     this.logger?.debug(`Synced ${externalTxs.length} transactions from external mempool`);
   }
 };
+__publicField(SimpleMempoolRunner, "connectionTypes", ["lmdb", "mongo"]);
 __publicField(SimpleMempoolRunner, "defaultMoniker", MempoolRunnerMoniker);
 __publicField(SimpleMempoolRunner, "dependencies", [FinalizationViewerMoniker4, BlockValidationViewerMoniker2, TransactionValidationViewerMoniker, ChainContractViewerMoniker4]);
 __publicField(SimpleMempoolRunner, "monikers", [MempoolRunnerMoniker]);
+__publicField(SimpleMempoolRunner, "surface", "node");
 SimpleMempoolRunner = __decorateClass([
   creatableProvider()
 ], SimpleMempoolRunner);
@@ -6242,9 +6337,11 @@ var SimpleMempoolViewer = class extends AbstractCreatableProvider {
     return deduplicateWithBundleBySigner(randomSelected).slice(0, effectiveLimit);
   }
 };
+__publicField(SimpleMempoolViewer, "connectionTypes", ["lmdb", "mongo"]);
 __publicField(SimpleMempoolViewer, "defaultMoniker", MempoolViewerMoniker2);
 __publicField(SimpleMempoolViewer, "dependencies", [WindowedBlockViewerMoniker]);
 __publicField(SimpleMempoolViewer, "monikers", [MempoolViewerMoniker2]);
+__publicField(SimpleMempoolViewer, "surface", "node");
 SimpleMempoolViewer = __decorateClass([
   creatableProvider()
 ], SimpleMempoolViewer);
@@ -6433,9 +6530,11 @@ var SimpleXyoRunner = class extends AbstractCreatableProvider {
     this._mempoolRunner = await this.locator.getInstance(MempoolRunnerMoniker2);
   }
 };
+__publicField(SimpleXyoRunner, "connectionTypes", ["lmdb", "mongo"]);
 __publicField(SimpleXyoRunner, "defaultMoniker", XyoRunnerMoniker);
 __publicField(SimpleXyoRunner, "dependencies", [MempoolRunnerMoniker2]);
 __publicField(SimpleXyoRunner, "monikers", [XyoRunnerMoniker]);
+__publicField(SimpleXyoRunner, "surface", "node");
 SimpleXyoRunner = __decorateClass([
   creatableProvider()
 ], SimpleXyoRunner);
@@ -6447,9 +6546,11 @@ import {
   XyoSignerMoniker as XyoSignerMoniker2
 } from "@xyo-network/xl1-protocol-lib";
 var SimpleXyoSigner = class _SimpleXyoSigner extends AbstractCreatableProvider {
+  static connectionTypes = ["wallet"];
   static defaultMoniker = XyoSignerMoniker2;
   static dependencies = [];
   static monikers = [XyoSignerMoniker2];
+  static surface = "node";
   moniker = _SimpleXyoSigner.defaultMoniker;
   static async paramsHandler(params) {
     let account;
@@ -6559,9 +6660,11 @@ var SimpleStakeEventsViewer = class extends AbstractCreatableProvider {
     return filteredPositions;
   }
 };
+__publicField(SimpleStakeEventsViewer, "connectionTypes", []);
 __publicField(SimpleStakeEventsViewer, "defaultMoniker", StakeEventsViewerMoniker);
 __publicField(SimpleStakeEventsViewer, "dependencies", []);
 __publicField(SimpleStakeEventsViewer, "monikers", [StakeEventsViewerMoniker]);
+__publicField(SimpleStakeEventsViewer, "surface", "node");
 SimpleStakeEventsViewer = __decorateClass([
   creatableProvider()
 ], SimpleStakeEventsViewer);
@@ -6657,9 +6760,11 @@ var SimpleStakeTotalsViewer = class extends AbstractCreatableProvider {
     return withdrawn;
   }
 };
+__publicField(SimpleStakeTotalsViewer, "connectionTypes", ["lmdb", "mongo"]);
 __publicField(SimpleStakeTotalsViewer, "defaultMoniker", StakeTotalsViewerMoniker);
 __publicField(SimpleStakeTotalsViewer, "dependencies", [StakeTotalsViewerMoniker]);
 __publicField(SimpleStakeTotalsViewer, "monikers", [StakeTotalsViewerMoniker]);
+__publicField(SimpleStakeTotalsViewer, "surface", "node");
 SimpleStakeTotalsViewer = __decorateClass([
   creatableProvider()
 ], SimpleStakeTotalsViewer);
@@ -6787,9 +6892,11 @@ var SimpleStakeViewer = class extends AbstractCreatableProvider {
     return this.positions.filter((s) => s.withdrawBlock !== 0);
   }
 };
+__publicField(SimpleStakeViewer, "connectionTypes", ["lmdb", "mongo"]);
 __publicField(SimpleStakeViewer, "defaultMoniker", StakeViewerMoniker2);
 __publicField(SimpleStakeViewer, "dependencies", [StakeEventsViewerMoniker2]);
 __publicField(SimpleStakeViewer, "monikers", [StakeViewerMoniker2]);
+__publicField(SimpleStakeViewer, "surface", "node");
 SimpleStakeViewer = __decorateClass([
   creatableProvider()
 ], SimpleStakeViewer);
@@ -6957,9 +7064,11 @@ var SimpleTimeSyncViewer = class extends AbstractCreatableProvider {
     return timePayload;
   }
 };
+__publicField(SimpleTimeSyncViewer, "connectionTypes", ["lmdb", "mongo"]);
 __publicField(SimpleTimeSyncViewer, "defaultMoniker", TimeSyncViewerMoniker);
 __publicField(SimpleTimeSyncViewer, "dependencies", [BlockViewerMoniker4]);
 __publicField(SimpleTimeSyncViewer, "monikers", [TimeSyncViewerMoniker]);
+__publicField(SimpleTimeSyncViewer, "surface", "node");
 SimpleTimeSyncViewer = __decorateClass([
   creatableProvider()
 ], SimpleTimeSyncViewer);
@@ -7081,9 +7190,11 @@ var SimpleTransactionValidationViewer = class extends AbstractCreatableProvider
     }));
   }
 };
+__publicField(SimpleTransactionValidationViewer, "connectionTypes", ["lmdb", "mongo", "rpc"]);
 __publicField(SimpleTransactionValidationViewer, "defaultMoniker", TransactionValidationViewerMoniker2);
 __publicField(SimpleTransactionValidationViewer, "dependencies", [AccountBalanceViewerMoniker3, ChainContractViewerMoniker5, BlockViewerMoniker5]);
 __publicField(SimpleTransactionValidationViewer, "monikers", [TransactionValidationViewerMoniker2]);
+__publicField(SimpleTransactionValidationViewer, "surface", "node");
 SimpleTransactionValidationViewer = __decorateClass([
   creatableProvider()
 ], SimpleTransactionValidationViewer);
@@ -7161,6 +7272,7 @@ var SimpleTransactionViewer = class extends AbstractCreatableProvider {
     return await this.byHash(transactionHash);
   }
 };
+__publicField(SimpleTransactionViewer, "connectionTypes", ["lmdb", "mongo"]);
 __publicField(SimpleTransactionViewer, "defaultMoniker", TransactionViewerMoniker);
 __publicField(SimpleTransactionViewer, "dependencies", [BlockViewerMoniker6]);
 __publicField(SimpleTransactionViewer, "monikers", [TransactionViewerMoniker]);
@@ -7337,9 +7449,11 @@ var SimpleWindowedBlockViewer = class extends AbstractCreatableProvider {
     });
   }
 };
+__publicField(SimpleWindowedBlockViewer, "connectionTypes", ["lmdb", "mongo", "rpc"]);
 __publicField(SimpleWindowedBlockViewer, "defaultMoniker", WindowedBlockViewerMoniker2);
 __publicField(SimpleWindowedBlockViewer, "dependencies", [BlockViewerMoniker7]);
 __publicField(SimpleWindowedBlockViewer, "monikers", [WindowedBlockViewerMoniker2]);
+__publicField(SimpleWindowedBlockViewer, "surface", "node");
 SimpleWindowedBlockViewer = __decorateClass([
   creatableProvider()
 ], SimpleWindowedBlockViewer);
@@ -8110,9 +8224,12 @@ export {
   isZodError,
   labeledCreatableProvider,
   labeledCreatableProviderFactory,
+  locatorFromConfig,
   mapToMapType,
   mergeTransfers,
   mergedAddRemoveStakeEventsByPosition,
+  needsFromConnectionTypes,
+  needsFromProviderBindings,
   netBalancesForPayloads,
   netSchemasForPayloads,
   netTransfersForPayloads,
@@ -8122,13 +8239,17 @@ export {
   parseSignedBigInt,
   payloadMapFromStore,
   prettifyZodError,
+  providerCandidateFromClass,
+  providerCandidatesFromClasses,
   providerFactoryDescription,
   rateMultipliers,
   readPayloadMapFromStore,
   registerCreatableProviderFactories,
   registerCreatableProviderFactory,
+  registerFactoriesFromPlan,
   resolveConfig,
   resolveProviders,
+  resolveProvidersFromConfig,
   resolveS3Bucket,
   rewardFromBlockNumber,
   schemasMaxStep,