@xyo-network/chain-orchestration 1.20.29 → 1.21.2

package/dist/neutral/node/config/capabilities/ProcessSharedResources.d.ts

@@ -1,4 +1,4 @@
-import type { ActorConfigContext, HydratedBlockStateValidationFunction } from '@xyo-network/xl1-sdk';
+import type { ActorConfigContext } from '@xyo-network/xl1-sdk';
 /**
  * Live runtime resources that providers need to construct.
  * Built once per process; descriptors look these up via `XL1ResolutionContext.process`.
@@ -6,6 +6,13 @@ import type { ActorConfigContext, HydratedBlockStateValidationFunction } from '@
  * This struct is the union of everything `localLocatorFromConfig` builds before
  * registering providers — extracted so descriptors can reference it without
  * each one having to re-derive the archivists / summary maps / wallet.
+ *
+ * The flat shape is preserved for back-compat with existing descriptor `build()`
+ * functions. Internally, this is composed from per-backing builders in
+ * `./backings/` — each backing can be loaded independently by an actor that
+ * only owns or reads that backing. Genesis initialization lives inside
+ * `buildChainStoreBacking('write')` so it only runs on the chain-store owner
+ * (the Finalizer) — not every actor that incidentally builds this struct.
  */
 export type ProcessSharedResources = Awaited<ReturnType<typeof buildProcessSharedResources>>;
 export interface BuildProcessSharedResourcesOptions {
@@ -13,18 +20,18 @@ export interface BuildProcessSharedResourcesOptions {
 }
 export declare function buildProcessSharedResources(context: ActorConfigContext, options?: BuildProcessSharedResourcesOptions): Promise<{
     balancesSummaryMap: import("@xyo-network/xl1-sdk").MapType<string, import("@xyo-network/payload-model").WithStorageMeta<import("@xyo-network/xl1-sdk").BalancesStepSummary>>;
-    transfersSummaryMap: import("@xyo-network/xl1-sdk").MapType<string, import("@xyo-network/payload-model").WithStorageMeta<import("@xyo-network/xl1-sdk").TransfersStepSummary>>;
-    wallet: import("@xyo-network/wallet-model").WalletInstance;
+    blockProtocolValidator: import("@xyo-network/xl1-sdk").HydratedBlockValidationFunction;
+    blockStateValidator: import("@xyo-network/xl1-sdk").HydratedBlockStateValidationFunction;
     node: import("@xyo-network/sdk-js").NodeInstance<import("@xyo-network/sdk-js").NodeParams<import("@xyo-network/module-model").AnyConfigSchema<import("@xyo-network/sdk-js").NodeConfig>>, import("@xyo-network/sdk-js").NodeModuleEventData>;
-    writableChainArchivist: import("@xyo-network/sdk-js").ArchivistInstance<import("@xyo-network/sdk-js").ArchivistParams<import("@xyo-network/module-model").AnyConfigSchema<import("@xyo-network/sdk-js").ArchivistConfig<void, void>>>, import("@xyo-network/sdk-js").ArchivistModuleEventData, import("@xyo-network/payload-model").Payload<void, void>>;
-    readonlyChainArchivist: import("@xyo-network/sdk-js").ArchivistInstance<import("@xyo-network/sdk-js").ArchivistParams<import("@xyo-network/module-model").AnyConfigSchema<import("@xyo-network/sdk-js").ArchivistConfig<void, void>>>, import("@xyo-network/sdk-js").ArchivistModuleEventData, import("@xyo-network/payload-model").Payload<void, void>>;
-    pendingTransactionsArchivist: import("@xyo-network/sdk-js").ArchivistInstance<import("@xyo-network/sdk-js").ArchivistParams<import("@xyo-network/module-model").AnyConfigSchema<import("@xyo-network/sdk-js").ArchivistConfig<void, void>>>, import("@xyo-network/sdk-js").ArchivistModuleEventData, import("@xyo-network/payload-model").Payload<void, void>>;
-    pendingBlocksArchivist: import("@xyo-network/sdk-js").ArchivistInstance<import("@xyo-network/sdk-js").ArchivistParams<import("@xyo-network/module-model").AnyConfigSchema<import("@xyo-network/sdk-js").ArchivistConfig<void, void>>>, import("@xyo-network/sdk-js").ArchivistModuleEventData, import("@xyo-network/payload-model").Payload<void, void>>;
-    rejectedBlocksArchivist: import("@xyo-network/sdk-js").ArchivistInstance<import("@xyo-network/sdk-js").ArchivistParams<import("@xyo-network/module-model").AnyConfigSchema<import("@xyo-network/sdk-js").ArchivistConfig<void, void>>>, import("@xyo-network/sdk-js").ArchivistModuleEventData, import("@xyo-network/payload-model").Payload<void, void>>;
-    rejectedTransactionsArchivist: import("@xyo-network/sdk-js").ArchivistInstance<import("@xyo-network/sdk-js").ArchivistParams<import("@xyo-network/module-model").AnyConfigSchema<import("@xyo-network/sdk-js").ArchivistConfig<void, void>>>, import("@xyo-network/sdk-js").ArchivistModuleEventData, import("@xyo-network/payload-model").Payload<void, void>>;
-    blockProtocolValidator: (context: import("@xyo-network/xl1-sdk").BaseContext, hydratedBlock: import("@xyo-network/xl1-sdk").HydratedBlockWithHashMeta, chainIdAtBlockNumber?: (blockNumber: import("@xyo-network/xl1-sdk").XL1BlockNumber) => import("@xylabs/sdk-js").Promisable<import("@xyo-network/xl1-sdk").ChainId>, additionalValidators?: import("@xyo-network/xl1-sdk").HydratedBlockValidationFunction[], additionalBlockValidators?: import("@xyo-network/xl1-sdk").BlockValidatorFunction[]) => Promise<import("@xyo-network/xl1-sdk").HydratedBlockValidationError[]>;
-    blockStateValidator: HydratedBlockStateValidationFunction;
+    pendingBlocksArchivist: import("@xyo-network/sdk-js").ArchivistInstance<import("@xyo-network/sdk-js").ArchivistParams<import("@xyo-network/module-model").AnyConfigSchema<import("@xyo-network/sdk-js").ArchivistConfig>>, import("@xyo-network/sdk-js").ArchivistModuleEventData, import("@xyo-network/payload-model").Payload>;
+    pendingTransactionsArchivist: import("@xyo-network/sdk-js").ArchivistInstance<import("@xyo-network/sdk-js").ArchivistParams<import("@xyo-network/module-model").AnyConfigSchema<import("@xyo-network/sdk-js").ArchivistConfig>>, import("@xyo-network/sdk-js").ArchivistModuleEventData, import("@xyo-network/payload-model").Payload>;
+    readonlyChainArchivist: import("@xyo-network/sdk-js").ArchivistInstance<import("@xyo-network/sdk-js").ArchivistParams<import("@xyo-network/module-model").AnyConfigSchema<import("@xyo-network/sdk-js").ArchivistConfig>>, import("@xyo-network/sdk-js").ArchivistModuleEventData, import("@xyo-network/payload-model").Payload>;
+    rejectedBlocksArchivist: import("@xyo-network/sdk-js").ArchivistInstance<import("@xyo-network/sdk-js").ArchivistParams<import("@xyo-network/module-model").AnyConfigSchema<import("@xyo-network/sdk-js").ArchivistConfig>>, import("@xyo-network/sdk-js").ArchivistModuleEventData, import("@xyo-network/payload-model").Payload>;
+    rejectedTransactionsArchivist: import("@xyo-network/sdk-js").ArchivistInstance<import("@xyo-network/sdk-js").ArchivistParams<import("@xyo-network/module-model").AnyConfigSchema<import("@xyo-network/sdk-js").ArchivistConfig>>, import("@xyo-network/sdk-js").ArchivistModuleEventData, import("@xyo-network/payload-model").Payload>;
     transactionProtocolValidator: import("@xyo-network/xl1-sdk").HydratedTransactionValidationFunction;
     transactionStateValidator: import("@xyo-network/xl1-sdk").HydratedTransactionStateValidationFunction;
+    transfersSummaryMap: import("@xyo-network/xl1-sdk").MapType<string, import("@xyo-network/payload-model").WithStorageMeta<import("@xyo-network/xl1-sdk").TransfersStepSummary>>;
+    wallet: import("@xyo-network/wallet-model").WalletInstance;
+    writableChainArchivist: import("@xyo-network/sdk-js").ArchivistInstance<import("@xyo-network/sdk-js").ArchivistParams<import("@xyo-network/module-model").AnyConfigSchema<import("@xyo-network/sdk-js").ArchivistConfig>>, import("@xyo-network/sdk-js").ArchivistModuleEventData, import("@xyo-network/payload-model").Payload>;
 }>;
 //# sourceMappingURL=ProcessSharedResources.d.ts.map

package/dist/neutral/node/config/capabilities/ProcessSharedResources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProcessSharedResources.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/capabilities/ProcessSharedResources.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oCAAoC,EAAE,MAAM,sBAAsB,CAAA;AAmBpG;;;;;;;GAOG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC,CAAA;AAE5F,MAAM,WAAW,kCAAkC;IACjD,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/C;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,kCAAkC;;;;;;;;;;;;;;;GAwC7C"}
+{"version":3,"file":"ProcessSharedResources.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/capabilities/ProcessSharedResources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAY9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC,CAAA;AAE5F,MAAM,WAAW,kCAAkC;IACjD,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/C;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,kCAAkC;;;;;;;;;;;;;;;GAsC7C"}

package/dist/neutral/node/config/capabilities/Provider.d.ts

@@ -1,50 +1,12 @@
-import type { CreatableProviderFactory } from '@xyo-network/xl1-sdk';
-import type { CapabilityRegistryInstance, ProviderMoniker } from './Capability.ts';
 /**
- * Tier expresses *intrinsic strength* of a provider — lower numbers win.
+ * `ProviderDescriptor`, `ProviderTier`, and the abstract `ResolutionContext`
+ * are owned by `@xyo-network/xl1-protocol-sdk`. This file re-exports them so
+ * existing imports in this package keep working.
  *
- * - `1` — In-process, direct backing-store access (Simple* providers reading/writing the local archivist).
- * - `2` — Direct EVM contract access (Evm* providers calling Ethereum nodes for chain-of-truth data).
- * - `3` — Remote JSON-RPC to another XL1 node (JsonRpc* providers).
- * - `4` — Stub/fallback (Simple* providers fed empty arrays — usable only when nothing better exists).
+ * The XL1-specific `ResolutionContext` extension (with `actorContext` +
+ * `process` from `ProcessSharedResources`) lives in `XL1ResolutionContext.ts`
+ * — that one stays here because it knows about the orchestration-specific
+ * server-side runtime resources.
  */
-export type ProviderTier = 1 | 2 | 3 | 4;
-/**
- * Sidecar metadata for a `CreatableProviderFactory`-producing class. Tells the
- * resolver which capability the provider satisfies, at what tier, under what
- * preconditions, and how to construct the factory at plan time.
- *
- * Descriptors are deliberately separated from the provider classes themselves
- * so the SDK packages stay untouched — descriptors live in the consumer
- * (this repo).
- */
-export interface ProviderDescriptor<TCtx extends ResolutionContext = ResolutionContext> {
-    /** Globally-unique key, usually `<className>` — used in snapshots and diagnostics. */
-    readonly id: string;
-    /** Capabilities this provider satisfies (typically one moniker, occasionally several). */
-    readonly satisfies: readonly ProviderMoniker[];
-    readonly tier: ProviderTier;
-    /** Soft tie-break inside a tier; higher wins. Default 0. */
-    readonly priority?: number;
-    /**
-     * Returns true iff the provider can be constructed in this process given `ctx`.
-     * Pure & sync — must not read DB or do I/O.
-     */
-    preconditions(ctx: TCtx): boolean;
-    /**
-     * Build the factory args from the resolution context. Returning undefined
-     * signals "skip me at runtime" (preconditions said yes, but a missing optional
-     * resource was discovered during the build).
-     */
-    build(ctx: TCtx): CreatableProviderFactory | undefined;
-}
-/**
- * Inputs the resolver hands to descriptors. `capabilities` is the registry
- * the resolver consults for `implies` walks. Subtypes (e.g. `XL1ResolutionContext`)
- * extend this with live runtime resources — archivists, EVM provider, wallet —
- * that descriptors need at `build()` time.
- */
-export interface ResolutionContext {
-    readonly capabilities: CapabilityRegistryInstance;
-}
+export type { ProviderDescriptor, ProviderTier, ResolutionContext, } from '@xyo-network/xl1-protocol-sdk';
 //# sourceMappingURL=Provider.d.ts.map

package/dist/neutral/node/config/capabilities/Provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/capabilities/Provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAEpE,OAAO,KAAK,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAElF;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAExC;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB,CAAC,IAAI,SAAS,iBAAiB,GAAG,iBAAiB;IACpF,sFAAsF;IACtF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,0FAA0F;IAC1F,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAA;IAC9C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,aAAa,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAA;IACjC;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,IAAI,GAAG,wBAAwB,GAAG,SAAS,CAAA;CACvD;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,EAAE,0BAA0B,CAAA;CAClD"}
+{"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/capabilities/Provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,YAAY,EACV,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,GACpD,MAAM,+BAA+B,CAAA"}

package/dist/neutral/node/config/capabilities/backings/buildChainStoreBacking.d.ts

@@ -0,0 +1,36 @@
+import type { Logger } from '@xylabs/sdk-js';
+import type { ArchivistInstance, NodeInstance } from '@xyo-network/sdk-js';
+import type { WalletInstance } from '@xyo-network/wallet-model';
+import type { ActorConfig } from '@xyo-network/xl1-sdk';
+/**
+ * Resources for the `chain-store` backing — finalized/canonical chain archivists.
+ *
+ * - `read` mode exposes only `readonlyArchivist`.
+ * - `write` mode additionally exposes `writableArchivist` and runs genesis
+ *   initialization (`initFinalizationArchivistIfNeeded`) — this is the only
+ *   path that can create the genesis block(s). The chain-store has exactly one
+ *   writer per deployment: the Finalizer. All other actors hold it as `read`
+ *   or not at all.
+ */
+export interface ChainStoreReadBacking {
+    readonly mode: 'read';
+    readonly readonlyArchivist: ArchivistInstance;
+}
+export interface ChainStoreWriteBacking {
+    readonly mode: 'write';
+    readonly readonlyArchivist: ArchivistInstance;
+    readonly writableArchivist: ArchivistInstance;
+}
+export type ChainStoreBacking = ChainStoreReadBacking | ChainStoreWriteBacking;
+export interface BuildChainStoreWriteOptions {
+    /** Actor config — needed by genesis initialization (chain id, genesis reward address). */
+    readonly actorConfig: ActorConfig;
+    readonly logger?: Logger;
+    /** Called when about to use insecure default genesis reward accounts; throws to abort. */
+    readonly onInsecureGenesisConfirm?: () => Promise<void>;
+    /** Wallet of the actor that owns chain-store write — signs the genesis block if one is created. */
+    readonly wallet: WalletInstance;
+}
+export declare function buildChainStoreBacking(node: NodeInstance, mode: 'read'): Promise<ChainStoreReadBacking>;
+export declare function buildChainStoreBacking(node: NodeInstance, mode: 'write', options: BuildChainStoreWriteOptions): Promise<ChainStoreWriteBacking>;
+//# sourceMappingURL=buildChainStoreBacking.d.ts.map

package/dist/neutral/node/config/capabilities/backings/buildChainStoreBacking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildChainStoreBacking.d.ts","sourceRoot":"","sources":["../../../../../../src/node/config/capabilities/backings/buildChainStoreBacking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAE1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAIvD;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAA;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAA;IAC7C,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAA;CAC9C;AAED,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GAAG,sBAAsB,CAAA;AAE9E,MAAM,WAAW,2BAA2B;IAC1C,0FAA0F;IAC1F,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,0FAA0F;IAC1F,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACvD,mGAAmG;IACnG,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;CAChC;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;AAC9G,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA"}

package/dist/neutral/node/config/capabilities/backings/buildDlqStoreBacking.d.ts

@@ -0,0 +1,13 @@
+import type { ArchivistInstance, NodeInstance } from '@xyo-network/sdk-js';
+/**
+ * Resources for the `dlq-store` backing — rejected blocks and rejected
+ * transactions archivists. Owned by the Finalizer in a multi-process
+ * deployment (the actor that performs rejection).
+ */
+export interface DlqStoreBacking {
+    readonly mode: 'read' | 'write';
+    readonly rejectedBlocksArchivist: ArchivistInstance;
+    readonly rejectedTransactionsArchivist: ArchivistInstance;
+}
+export declare function buildDlqStoreBacking(node: NodeInstance, mode: 'read' | 'write'): Promise<DlqStoreBacking>;
+//# sourceMappingURL=buildDlqStoreBacking.d.ts.map

package/dist/neutral/node/config/capabilities/backings/buildDlqStoreBacking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildDlqStoreBacking.d.ts","sourceRoot":"","sources":["../../../../../../src/node/config/capabilities/backings/buildDlqStoreBacking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAG1E;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAC/B,QAAQ,CAAC,uBAAuB,EAAE,iBAAiB,CAAA;IACnD,QAAQ,CAAC,6BAA6B,EAAE,iBAAiB,CAAA;CAC1D;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,GAAG,OAAO,GACrB,OAAO,CAAC,eAAe,CAAC,CAY1B"}

package/dist/neutral/node/config/capabilities/backings/buildIndexerStoreBacking.d.ts

@@ -0,0 +1,57 @@
+import type { ActorConfigContext } from '@xyo-network/xl1-sdk';
+import { initBalanceSummaryMap, initTransferSummaryMap } from '../../../init/index.ts';
+/**
+ * Resources for the `indexer-store` backing — derived summary maps that
+ * back account-balance and transfer-history queries.
+ *
+ * These maps are **lazy read-through caches**, not write-through indexes.
+ * Whoever queries `SimpleAccountBalanceViewer.qualifiedAccountBalances()`
+ * (or any other consumer of `balancesSummary()` / `transfersSummary()` in
+ * `@xyo-network/xl1-protocol-sdk`) computes the missing summary on demand
+ * and writes it back via `summaryMap.set(...)` inside
+ * `balancesStepSummaryFromRange` / `transfersStepSummaryFromRange`.
+ *
+ * Today the cache is co-located with whichever process builds
+ * `ProcessSharedResources` (single-process dev/test, or any actor process
+ * that holds the indexer-store backing).
+ *
+ * TODO: Extract `IndexerActor` for horizontal-scale deployments
+ * ----------------------------------------------------------------
+ * When N stateless API instances run behind a load balancer, each
+ * currently maintains its own cold cache and re-warms on first query.
+ * A dedicated IndexerActor process would own the cache backing and serve
+ * indexed queries; the stateless APIs would federate via
+ * `JsonRpcAccountBalanceViewer` / `JsonRpcStakeViewer` pointed at it.
+ *
+ * Crucially there is **no separate writer to extract** — the summary maps
+ * are populated entirely from the read path. The IndexerActor's role is
+ * purely deployment shape: own the cache and answer queries.
+ *
+ * Implementation outline:
+ * 1. New package `packages/cli/packages/indexer/` (mirror `chain-mempool`):
+ *    - `IndexerActor` extending `ActorV3` with `needs`:
+ *      `{ required: [AccountBalanceViewerMoniker, BlockViewerMoniker, FinalizationViewerMoniker] }`
+ *    - `command.ts` + `run.ts` CLI entry
+ * 2. New `IndexerConfigZod` in `shared/config/actors/Indexer.ts`
+ *    + `IndexerConfigContext`.
+ * 3. New `indexerLocatorFromConfig` that builds via `locatorFromActorNeeds`
+ *    with `availableBackings: [{ indexer-store, write }, { chain-store, read }]`
+ *    in single-process or `[{ indexer-store, write }, { network, read }]`
+ *    in split-deployment.
+ * 4. Add `'indexer'` case to `locatorsFromConfig` dispatch.
+ * 5. Possibly update `allActorsAreSelfSufficient` if the indexer can run
+ *    standalone (it can, when chain reads come via `network`).
+ * 6. Add `pnpm run-indexer` script to root `package.json`.
+ * 7. Wire `indexerCommand` into `runCLI` alongside the other actors.
+ *
+ * Operationally, stateless API actors then point `remote.rpc` at the
+ * indexer's RPC endpoint (or an LB in front of one) so balance and
+ * indexed-surface queries land on the warm cache.
+ */
+export interface IndexerStoreBacking {
+    readonly balancesSummaryMap: Awaited<ReturnType<typeof initBalanceSummaryMap>>;
+    readonly mode: 'read' | 'write';
+    readonly transfersSummaryMap: Awaited<ReturnType<typeof initTransferSummaryMap>>;
+}
+export declare function buildIndexerStoreBacking(context: ActorConfigContext, mode: 'read' | 'write'): Promise<IndexerStoreBacking>;
+//# sourceMappingURL=buildIndexerStoreBacking.d.ts.map

package/dist/neutral/node/config/capabilities/backings/buildIndexerStoreBacking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildIndexerStoreBacking.d.ts","sourceRoot":"","sources":["../../../../../../src/node/config/capabilities/backings/buildIndexerStoreBacking.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAA;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAA;CACjF;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,MAAM,GAAG,OAAO,GACrB,OAAO,CAAC,mBAAmB,CAAC,CAM9B"}

package/dist/neutral/node/config/capabilities/backings/buildMempoolStoreBacking.d.ts

@@ -0,0 +1,12 @@
+import type { ArchivistInstance, NodeInstance } from '@xyo-network/sdk-js';
+/**
+ * Resources for the `mempool-store` backing — pending transactions and pending
+ * blocks archivists. Owned by the Mempool actor in a multi-process deployment.
+ */
+export interface MempoolStoreBacking {
+    readonly mode: 'read' | 'write';
+    readonly pendingBlocksArchivist: ArchivistInstance;
+    readonly pendingTransactionsArchivist: ArchivistInstance;
+}
+export declare function buildMempoolStoreBacking(node: NodeInstance, mode: 'read' | 'write'): Promise<MempoolStoreBacking>;
+//# sourceMappingURL=buildMempoolStoreBacking.d.ts.map

package/dist/neutral/node/config/capabilities/backings/buildMempoolStoreBacking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildMempoolStoreBacking.d.ts","sourceRoot":"","sources":["../../../../../../src/node/config/capabilities/backings/buildMempoolStoreBacking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAG1E;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAC/B,QAAQ,CAAC,sBAAsB,EAAE,iBAAiB,CAAA;IAClD,QAAQ,CAAC,4BAA4B,EAAE,iBAAiB,CAAA;CACzD;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,GAAG,OAAO,GACrB,OAAO,CAAC,mBAAmB,CAAC,CAY9B"}

package/dist/neutral/node/config/capabilities/backings/buildValidators.d.ts

@@ -0,0 +1,14 @@
+import type { HydratedBlockStateValidationFunction, HydratedBlockValidationFunction, HydratedTransactionStateValidationFunction, HydratedTransactionValidationFunction } from '@xyo-network/xl1-sdk';
+/**
+ * Pure-compute validator functions injected into validation viewers. No
+ * backing required — these are stateless functions that operate on the data
+ * passed to them.
+ */
+export interface Validators {
+    readonly blockProtocolValidator: HydratedBlockValidationFunction;
+    readonly blockStateValidator: HydratedBlockStateValidationFunction;
+    readonly transactionProtocolValidator: HydratedTransactionValidationFunction;
+    readonly transactionStateValidator: HydratedTransactionStateValidationFunction;
+}
+export declare function buildValidators(): Validators;
+//# sourceMappingURL=buildValidators.d.ts.map

package/dist/neutral/node/config/capabilities/backings/buildValidators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildValidators.d.ts","sourceRoot":"","sources":["../../../../../../src/node/config/capabilities/backings/buildValidators.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,oCAAoC,EACpC,+BAA+B,EAC/B,0CAA0C,EAC1C,qCAAqC,EACtC,MAAM,sBAAsB,CAAA;AAa7B;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,sBAAsB,EAAE,+BAA+B,CAAA;IAChE,QAAQ,CAAC,mBAAmB,EAAE,oCAAoC,CAAA;IAClE,QAAQ,CAAC,4BAA4B,EAAE,qCAAqC,CAAA;IAC5E,QAAQ,CAAC,yBAAyB,EAAE,0CAA0C,CAAA;CAC/E;AAED,wBAAgB,eAAe,IAAI,UAAU,CAO5C"}

package/dist/neutral/node/config/capabilities/backings/index.d.ts

@@ -0,0 +1,6 @@
+export * from './buildChainStoreBacking.ts';
+export * from './buildDlqStoreBacking.ts';
+export * from './buildIndexerStoreBacking.ts';
+export * from './buildMempoolStoreBacking.ts';
+export * from './buildValidators.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/neutral/node/config/capabilities/backings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/node/config/capabilities/backings/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,sBAAsB,CAAA"}

package/dist/neutral/node/config/capabilities/defaultCapabilityRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaultCapabilityRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/capabilities/defaultCapabilityRegistry.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAc,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AAwF7E;;;;GAIG;AACH,wBAAgB,+BAA+B,IAAI,0BAA0B,CAI5E"}
+{"version":3,"file":"defaultCapabilityRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/capabilities/defaultCapabilityRegistry.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAc,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AAyF7E;;;;GAIG;AACH,wBAAgB,+BAA+B,IAAI,0BAA0B,CAI5E"}

package/dist/neutral/node/config/capabilities/descriptors.d.ts

@@ -10,6 +10,10 @@ import type { XL1ResolutionContext } from './XL1ResolutionContext.ts';
  * - `preconditions` always returns true here because the constituent resources
  *   (archivists, summary maps) are required by the local node anyway; if they
  *   were missing, `buildProcessSharedResources` would have already thrown.
+ * - `backings` declares which backing resources `build()` reads from `ctx`.
+ *   The resolver uses this to skip descriptors whose backings aren't a subset
+ *   of the locator's `availableBackings`.
+ * - `surface` declares which API surface the capability is exposed under.
  */
 export declare const localTier1Descriptors: readonly ProviderDescriptor<XL1ResolutionContext>[];
 //# sourceMappingURL=descriptors.d.ts.map

package/dist/neutral/node/config/capabilities/descriptors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"descriptors.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/capabilities/descriptors.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAIrE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,kBAAkB,CAAC,oBAAoB,CAAC,EAmKpF,CAAA"}
+{"version":3,"file":"descriptors.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/capabilities/descriptors.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAIrE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,kBAAkB,CAAC,oBAAoB,CAAC,EAiMpF,CAAA"}

package/dist/neutral/node/config/capabilities/index.d.ts

@@ -1,7 +1,9 @@
+export * from './Backing.ts';
 export * from './Capability.ts';
 export * from './defaultCapabilityRegistry.ts';
 export * from './descriptors.ts';
 export * from './locatorFromActorNeeds.ts';
+export * from './networkTier3Descriptors.ts';
 export * from './ProcessSharedResources.ts';
 export * from './Provider.ts';
 export * from './resolveProviders.ts';

package/dist/neutral/node/config/capabilities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/capabilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kBAAkB,CAAA;AAChC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,2BAA2B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/capabilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kBAAkB,CAAA;AAChC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,2BAA2B,CAAA"}

package/dist/neutral/node/config/capabilities/locatorFromActorNeeds.d.ts

@@ -1,15 +1,32 @@
 import type { ActorConfigContext, ProviderFactoryLocatorInstance } from '@xyo-network/xl1-sdk';
 import type { ActorCapabilityNeeds } from '../../../shared/actor/v3/index.ts';
+import type { BackingNeed } from './Backing.ts';
 import type { BuildProcessSharedResourcesOptions } from './ProcessSharedResources.ts';
 import type { ProviderDescriptor } from './Provider.ts';
 import type { ResolutionPlan } from './resolveProviders.ts';
 import type { XL1ResolutionContext } from './XL1ResolutionContext.ts';
 export interface LocatorFromActorNeedsOptions extends BuildProcessSharedResourcesOptions {
     /**
-     * Additional descriptors beyond the built-in tier-1 set. Use to inject
-     * actor-specific extras (e.g. `SimpleBlockRunner` for the producer).
+     * The backings the locator's process holds. If provided, the resolver filters
+     * out any candidate whose `backings` are not a subset of `availableBackings`.
+     * If omitted, defaults to the all-backings set (single-process developer path)
+     * to preserve back-compat — every tier-1 descriptor is eligible.
+     */
+    availableBackings?: readonly BackingNeed[];
+    /**
+     * Additional descriptors beyond the built-in tier-1 + tier-3 sets. Use to
+     * inject actor-specific extras (e.g. `SimpleBlockRunner` for the producer).
      */
     extraDescriptors?: readonly ProviderDescriptor<XL1ResolutionContext>[];
+    /**
+     * Pre-built process resources. When provided, `buildProcessSharedResources`
+     * is skipped and this object is used directly as `XL1ResolutionContext.process`.
+     * Required for stateless paths (e.g. a stateless API actor with
+     * `availableBackings: [{ backing: 'network', mode: 'read' }]`) where
+     * loading the local node would be wrong — the resolver picks tier-3
+     * `JsonRpc*` descriptors which don't reference `ctx.process` anyway.
+     */
+    process?: XL1ResolutionContext['process'];
     /**
      * Whether the underlying `ProviderFactoryLocator` should validate
      * dependencies at register time. Off by default (matches today's behavior
@@ -27,8 +44,10 @@ export interface LocatorFromActorNeedsResult {
  * actors' declared `needs`. Replaces the imperative pattern in
  * `localLocatorFromConfig` with a data-driven plan.
  *
- * - Builds `ProcessSharedResources` once.
+ * - Builds `ProcessSharedResources` once (or accepts a pre-built `process` via
+ *   `options.process` for stateless paths that skip the local node).
  * - Walks `Capability.implies` to expand transitive needs.
+ * - Filters candidates by `availableBackings` if provided.
  * - Picks one descriptor per moniker by tier/priority.
  * - Registers exactly those descriptors and freezes the locator.
  */

package/dist/neutral/node/config/capabilities/locatorFromActorNeeds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locatorFromActorNeeds.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/capabilities/locatorFromActorNeeds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAA;AAG9F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AAI7E,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,6BAA6B,CAAA;AAErF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAErE,MAAM,WAAW,4BAA6B,SAAQ,kCAAkC;IACtF;;;OAGG;IACH,gBAAgB,CAAC,EAAE,SAAS,kBAAkB,CAAC,oBAAoB,CAAC,EAAE,CAAA;IACtE;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAA;CACjC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,8BAA8B,CAAA;IAChD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAA;CAClD;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,EAC3B,UAAU,EAAE,SAAS,oBAAoB,EAAE,EAC3C,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,2BAA2B,CAAC,CAoBtC"}
+{"version":3,"file":"locatorFromActorNeeds.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/capabilities/locatorFromActorNeeds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAA;AAG9F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAK/C,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,6BAA6B,CAAA;AAErF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAErE,MAAM,WAAW,4BAA6B,SAAQ,kCAAkC;IACtF;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;IAC1C;;;OAGG;IACH,gBAAgB,CAAC,EAAE,SAAS,kBAAkB,CAAC,oBAAoB,CAAC,EAAE,CAAA;IACtE;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAA;IACzC;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAA;CACjC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,8BAA8B,CAAA;IAChD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAA;CAClD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,EAC3B,UAAU,EAAE,SAAS,oBAAoB,EAAE,EAC3C,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,2BAA2B,CAAC,CA6BtC"}

package/dist/neutral/node/config/capabilities/networkTier3Descriptors.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tier-3 `JsonRpc*` descriptors are owned by `@xyo-network/xl1-rpc` (the
+ * package that defines the JsonRpc provider classes). This file re-exports
+ * them so existing imports inside this package keep working without churn.
+ *
+ * The upstream pool ships more entries than the original local copy:
+ * - Node-surface adds `JsonRpcStakeTotalsViewer` and `JsonRpcTimeSyncViewer`.
+ * - Indexed-surface adds `JsonRpcStakeViewer`, `JsonRpcNetworkStakeViewer`,
+ *   and `JsonRpcNetworkStakeStepRewardsViewer`.
+ *
+ * `locatorFromActorNeeds` consumes the full union by default.
+ */
+export { indexedNetworkDescriptors, networkTier3Descriptors, nodeNetworkDescriptors, } from '@xyo-network/xl1-sdk';
+//# sourceMappingURL=networkTier3Descriptors.d.ts.map

package/dist/neutral/node/config/capabilities/networkTier3Descriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkTier3Descriptors.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/capabilities/networkTier3Descriptors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,yBAAyB,EAAE,uBAAuB,EAAE,sBAAsB,GAC3E,MAAM,sBAAsB,CAAA"}

package/dist/neutral/node/config/capabilities/resolveProviders.d.ts

@@ -1,30 +1,9 @@
-import type { ProviderMoniker } from './Capability.ts';
-import type { ProviderDescriptor, ResolutionContext } from './Provider.ts';
-export interface ResolutionPlan {
-    /** Capability moniker -> winning descriptor id (for snapshot diffing). */
-    readonly bindings: Readonly<Record<ProviderMoniker, string>>;
-    /** Descriptors that lost; included for diagnostics. */
-    readonly rejected: readonly RejectedDescriptor[];
-    /** Descriptors that should be instantiated, in topological order. */
-    readonly selected: readonly ProviderDescriptor[];
-}
-export interface RejectedDescriptor {
-    readonly descriptor: ProviderDescriptor;
-    readonly reason: string;
-}
-export declare class MissingCapabilityError extends Error {
-    readonly moniker: ProviderMoniker;
-    readonly reasons: readonly string[];
-    constructor(moniker: ProviderMoniker, reasons: readonly string[]);
-}
 /**
- * Plans which providers to register for a given set of needs.
+ * The capability resolver is owned by `@xyo-network/xl1-protocol-sdk`. This
+ * file re-exports it so existing imports in this package keep working.
  *
- * 1. Walk `Capability.implies` from the needs set to fixed point.
- * 2. Filter candidates by `preconditions(ctx)`.
- * 3. Pick the head of `(tier asc, priority desc, descriptor.id asc)` per moniker.
- * 4. Toposort selected descriptors using the registry's `implies`.
- * 5. Throw `MissingCapabilityError` if any wanted moniker has zero survivors.
+ * New code may import these directly from `@xyo-network/xl1-protocol-sdk`.
  */
-export declare function resolveProviders<TCtx extends ResolutionContext>(needs: ReadonlySet<ProviderMoniker>, candidates: readonly ProviderDescriptor<TCtx>[], ctx: TCtx): ResolutionPlan;
+export type { RejectedDescriptor, ResolutionPlan, ResolveProvidersOptions, } from '@xyo-network/xl1-protocol-sdk';
+export { MissingCapabilityError, resolveProviders } from '@xyo-network/xl1-protocol-sdk';
 //# sourceMappingURL=resolveProviders.d.ts.map

package/dist/neutral/node/config/capabilities/resolveProviders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveProviders.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/capabilities/resolveProviders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAE1E,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5D,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAChD,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;CACjD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;gBAEvB,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE;CAOjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,iBAAiB,EAC7D,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,EACnC,UAAU,EAAE,SAAS,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAC/C,GAAG,EAAE,IAAI,GACR,cAAc,CAShB"}
+{"version":3,"file":"resolveProviders.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/capabilities/resolveProviders.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,YAAY,EACV,kBAAkB,EAClB,cAAc,EAAE,uBAAuB,GACxC,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA"}

package/dist/neutral/node/config/locators/actors/apiLocatorFromConfig.d.ts

@@ -1,5 +1,5 @@
 import type { Promisable } from '@xylabs/sdk-js';
 import type { ProviderFactoryLocatorInstance } from '@xyo-network/xl1-sdk';
 import type { ApiConfigContext } from '../../../../neutral/index.ts';
-export declare function apiLocatorFromConfig(context: ApiConfigContext, parent?: ProviderFactoryLocatorInstance): Promisable<ProviderFactoryLocatorInstance>;
+export declare function apiLocatorFromConfig(context: ApiConfigContext, parent?: ProviderFactoryLocatorInstance): Promise<Promisable<ProviderFactoryLocatorInstance>>;
 //# sourceMappingURL=apiLocatorFromConfig.d.ts.map

package/dist/neutral/node/config/locators/actors/apiLocatorFromConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apiLocatorFromConfig.d.ts","sourceRoot":"","sources":["../../../../../../src/node/config/locators/actors/apiLocatorFromConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAA;AAQ1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAEpE,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,8BAA8B,GACtC,UAAU,CAAC,8BAA8B,CAAC,CAU5C"}
+{"version":3,"file":"apiLocatorFromConfig.d.ts","sourceRoot":"","sources":["../../../../../../src/node/config/locators/actors/apiLocatorFromConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAA;AAe1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAqBpE,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,8BAA8B,GACtC,OAAO,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC,CAyBrD"}

package/dist/neutral/node/config/locators/actors/bridgeLocatorFromConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridgeLocatorFromConfig.d.ts","sourceRoot":"","sources":["../../../../../../src/node/config/locators/actors/bridgeLocatorFromConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,OAAO,KAAK,EAAE,8BAA8B,EAA4B,MAAM,sBAAsB,CAAA;AAmBpG,OAAO,EAAE,KAAK,mBAAmB,EAAoB,MAAM,8BAA8B,CAAA;AAEzF,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,mBAAmB,EAC5B,MAAM,CAAC,EAAE,8BAA8B,GACtC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC,CAAC,CAmD9D"}
+{"version":3,"file":"bridgeLocatorFromConfig.d.ts","sourceRoot":"","sources":["../../../../../../src/node/config/locators/actors/bridgeLocatorFromConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,OAAO,KAAK,EAAE,8BAA8B,EAA4B,MAAM,sBAAsB,CAAA;AAmBpG,OAAO,EAAE,KAAK,mBAAmB,EAAmB,MAAM,8BAA8B,CAAA;AAExF,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,mBAAmB,EAC5B,MAAM,CAAC,EAAE,8BAA8B,GACtC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC,CAAC,CAmD9D"}

package/dist/neutral/node/config/locators/actors/rewardRedemptionLocatorFromConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rewardRedemptionLocatorFromConfig.d.ts","sourceRoot":"","sources":["../../../../../../src/node/config/locators/actors/rewardRedemptionLocatorFromConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAA;AAgB1E,OAAO,EAAoB,KAAK,6BAA6B,EAAE,MAAM,8BAA8B,CAAA;AAEnG,wBAAsB,iCAAiC,CACrD,OAAO,EAAE,6BAA6B,EACtC,MAAM,CAAC,EAAE,8BAA8B,GACtC,OAAO,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC,CAiCrD"}
+{"version":3,"file":"rewardRedemptionLocatorFromConfig.d.ts","sourceRoot":"","sources":["../../../../../../src/node/config/locators/actors/rewardRedemptionLocatorFromConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAA;AAgB1E,OAAO,EAAmB,KAAK,6BAA6B,EAAE,MAAM,8BAA8B,CAAA;AAElG,wBAAsB,iCAAiC,CACrD,OAAO,EAAE,6BAA6B,EACtC,MAAM,CAAC,EAAE,8BAA8B,GACtC,OAAO,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC,CAiCrD"}

package/dist/neutral/node/config/locators/buildStatelessApiLocator.d.ts

@@ -0,0 +1,20 @@
+import type { ActorConfigContext, ProviderFactoryLocatorInstance } from '@xyo-network/xl1-sdk';
+import type { ActorCapabilityNeeds } from '../../../shared/actor/v3/index.ts';
+/**
+ * Builds a network-only locator for a stateless API actor.
+ *
+ * The stateless API holds no local backing-store ownership — every required
+ * moniker resolves through `networkTier3Descriptors` to a `JsonRpc*` provider
+ * pointed at the owner-actors over the wire (Finalizer for chain state,
+ * Mempool actor for mempool state, IndexerActor for indexed state, etc.).
+ *
+ * Crucially this path skips `buildProcessSharedResources` so the API process
+ * never loads the local LMDB/MongoDB node — N copies of this actor can run
+ * behind a load balancer for horizontal scaling of client/standalone-actor
+ * traffic.
+ *
+ * The returned locator declares `availableBackings: [{ network, read }]` and
+ * a stub `process` (no descriptor with these backings reads from `ctx.process`).
+ */
+export declare function buildStatelessApiLocator(context: ActorConfigContext, needs: readonly ActorCapabilityNeeds[]): Promise<ProviderFactoryLocatorInstance>;
+//# sourceMappingURL=buildStatelessApiLocator.d.ts.map

package/dist/neutral/node/config/locators/buildStatelessApiLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildStatelessApiLocator.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/locators/buildStatelessApiLocator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAA;AAE9F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AAQ7E;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,SAAS,oBAAoB,EAAE,GACrC,OAAO,CAAC,8BAA8B,CAAC,CAOzC"}

package/dist/neutral/node/config/locators/contextFromConfigWithoutLocator.d.ts

@@ -1,4 +1,4 @@
 import type { Logger } from '@xylabs/sdk-js';
 import type { Config, CreatableProviderContext } from '@xyo-network/xl1-sdk';
-export declare function contextFromConfigWithoutLocator(config: Config, logger: Logger, serviceName: string, serviceVersion: string): Promise<Omit<CreatableProviderContext, 'locator'>>;
+export declare function contextFromConfigWithoutLocator(config: Config, logger: Logger, serviceName: string, serviceVersion: string, defaultScrapePort?: number): Promise<Omit<CreatableProviderContext, 'locator'>>;
 //# sourceMappingURL=contextFromConfigWithoutLocator.d.ts.map

package/dist/neutral/node/config/locators/contextFromConfigWithoutLocator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contextFromConfigWithoutLocator.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/locators/contextFromConfigWithoutLocator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAK5E,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC,CAapD"}
+{"version":3,"file":"contextFromConfigWithoutLocator.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/locators/contextFromConfigWithoutLocator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAK5E,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC,CAapD"}

package/dist/neutral/node/config/locators/index.d.ts

@@ -1,5 +1,6 @@
 export * from './basicRemoteRunnerLocator.ts';
 export * from './basicRemoteViewerLocator.ts';
+export * from './buildStatelessApiLocator.ts';
 export * from './contextFromConfigWithoutLocator.ts';
 export * from './localLocatorFromConfig.ts';
 export * from './locatorsFromConfig.ts';

package/dist/neutral/node/config/locators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/locators/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,sCAAsC,CAAA;AACpD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,yBAAyB,CAAA;AACvC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,iCAAiC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/locators/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,sCAAsC,CAAA;AACpD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,yBAAyB,CAAA;AACvC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,iCAAiC,CAAA"}

package/dist/neutral/node/config/locators/locatorsFromConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locatorsFromConfig.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/locators/locatorsFromConfig.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,MAAM,EAAE,KAAK,8BAA8B,EACjD,MAAM,sBAAsB,CAAA;AAW7B,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,MAAM,EAC7B,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC7C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,8BAA8B,CAAC,CAAC,CAyDzD"}
+{"version":3,"file":"locatorsFromConfig.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/locators/locatorsFromConfig.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,MAAM,EAAE,KAAK,8BAA8B,EACjD,MAAM,sBAAsB,CAAA;AA4B7B,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,MAAM,EAC7B,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC7C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,8BAA8B,CAAC,CAAC,CAiEzD"}

package/dist/neutral/node/config/locators/telemetryContextFromConfig.d.ts

@@ -1,3 +1,3 @@
 import type { Config } from '@xyo-network/xl1-sdk';
-export declare function telemetryContextFromConfig(config: Config, serviceName: string, serviceVersion: string): Promise<import("@xyo-network/chain-telemetry").TelemetryProviders>;
+export declare function telemetryContextFromConfig(config: Config, serviceName: string, serviceVersion: string, defaultScrapePort?: number): Promise<import("@xyo-network/chain-telemetry").TelemetryProviders>;
 //# sourceMappingURL=telemetryContextFromConfig.d.ts.map

package/dist/neutral/node/config/locators/telemetryContextFromConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetryContextFromConfig.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/locators/telemetryContextFromConfig.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAElD,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,sEAW3G"}
+{"version":3,"file":"telemetryContextFromConfig.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/locators/telemetryContextFromConfig.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAElD,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,iBAAiB,SAAO,sEAYzB"}

package/dist/neutral/node/config/tryParseConfig.d.ts

@@ -31,7 +31,7 @@ export declare function tryParseConfig(options?: {
         } | undefined;
     };
     log: {
-        logLevel: "log" | "error" | "warn" | "info" | "debug" | "trace";
+        logLevel: "error" | "log" | "info" | "warn" | "debug" | "trace";
         silent: boolean;
     };
     providers: {
@@ -105,7 +105,7 @@ export declare function tryParseConfig(options?: {
             } | undefined;
         };
         log: {
-            logLevel: "log" | "error" | "warn" | "info" | "debug" | "trace";
+            logLevel: "error" | "log" | "info" | "warn" | "debug" | "trace";
             silent: boolean;
         };
         providers: {
@@ -164,5 +164,6 @@ export declare function tryParseConfig(options?: {
         healthCheckPort?: number | undefined;
     }[];
     dataLake?: import("@xyo-network/xl1-sdk").DataLakeConfig | undefined;
+    healthCheckPort?: number | undefined;
 }>;
 //# sourceMappingURL=tryParseConfig.d.ts.map