@xyo-network/chain-orchestration 1.20.28 → 1.21.0

package/dist/browser/node/config/capabilities/XL1ResolutionContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XL1ResolutionContext.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/capabilities/XL1ResolutionContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEtD;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAA;IACzC,QAAQ,CAAC,YAAY,EAAE,0BAA0B,CAAA;IACjD,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAA;CACzC"}

package/dist/browser/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/browser/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/browser/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/browser/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/browser/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/browser/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/browser/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/browser/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/browser/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/browser/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/browser/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/browser/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/browser/node/config/capabilities/defaultCapabilityRegistry.d.ts

@@ -0,0 +1,8 @@
+import type { CapabilityRegistryInstance } from './Capability.ts';
+/**
+ * Builds a fresh registry seeded with all known XL1 capabilities.
+ * Callers may add more (`registry.register(...)`) before passing it to
+ * `resolveProviders`.
+ */
+export declare function createDefaultCapabilityRegistry(): CapabilityRegistryInstance;
+//# sourceMappingURL=defaultCapabilityRegistry.d.ts.map

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

@@ -0,0 +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;AAyF7E;;;;GAIG;AACH,wBAAgB,+BAA+B,IAAI,0BAA0B,CAI5E"}

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

@@ -0,0 +1,19 @@
+import type { ProviderDescriptor } from './Provider.ts';
+import type { XL1ResolutionContext } from './XL1ResolutionContext.ts';
+/**
+ * Tier-1 descriptors mirroring today's `localLocatorFromConfig` registrations.
+ * These produce a behavior-equivalent locator when no remote config is set.
+ *
+ * Conventions:
+ * - `id` is the provider class name (used for snapshot diffing).
+ * - `tier: 1` — direct in-process backing-store access.
+ * - `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/browser/node/config/capabilities/descriptors.d.ts.map

@@ -0,0 +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;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,kBAAkB,CAAC,oBAAoB,CAAC,EAiMpF,CAAA"}

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

@@ -0,0 +1,11 @@
+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';
+export * from './XL1ResolutionContext.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"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/browser/node/config/capabilities/locatorFromActorNeeds.d.ts

@@ -0,0 +1,55 @@
+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 {
+    /**
+     * 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
+     * in `localLocatorFromConfig`).
+     */
+    validateDepsOnRegister?: boolean;
+}
+export interface LocatorFromActorNeedsResult {
+    readonly locator: ProviderFactoryLocatorInstance;
+    readonly plan: ResolutionPlan;
+    readonly process: XL1ResolutionContext['process'];
+}
+/**
+ * Builds a single shared `ProviderFactoryLocator` driven by the union of all
+ * actors' declared `needs`. Replaces the imperative pattern in
+ * `localLocatorFromConfig` with a data-driven plan.
+ *
+ * - 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.
+ */
+export declare function locatorFromActorNeeds(context: ActorConfigContext, actorNeeds: readonly ActorCapabilityNeeds[], options?: LocatorFromActorNeedsOptions): Promise<LocatorFromActorNeedsResult>;
+//# sourceMappingURL=locatorFromActorNeeds.d.ts.map

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

@@ -0,0 +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;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/browser/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/browser/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/browser/node/config/capabilities/resolveProviders.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The capability resolver is owned by `@xyo-network/xl1-protocol-sdk`. This
+ * file re-exports it so existing imports in this package keep working.
+ *
+ * New code may import these directly from `@xyo-network/xl1-protocol-sdk`.
+ */
+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/browser/node/config/capabilities/resolveProviders.d.ts.map

@@ -0,0 +1 @@
+{"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/browser/node/config/index.d.ts

@@ -1,3 +1,4 @@
+export * from './capabilities/index.ts';
 export * from './locators/index.ts';
 export * from './tryParseConfig.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/node/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/node/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA"}

package/dist/browser/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/browser/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/browser/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/browser/node/config/locators/actors/producerLocatorFromConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"producerLocatorFromConfig.d.ts","sourceRoot":"","sources":["../../../../../../src/node/config/locators/actors/producerLocatorFromConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAA;AAG1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAOzE,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,8BAA8B,GACtC,OAAO,CAAC,8BAA8B,CAAC,CA4BzC"}
+{"version":3,"file":"producerLocatorFromConfig.d.ts","sourceRoot":"","sources":["../../../../../../src/node/config/locators/actors/producerLocatorFromConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAA;AAG1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAOzE,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,8BAA8B,GACtC,OAAO,CAAC,8BAA8B,CAAC,CAkCzC"}

package/dist/browser/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/browser/node/config/locators/basicRemoteViewerLocator.d.ts

@@ -1,3 +1,3 @@
 import type { BlockValidators, RemoteConfig } from '@xyo-network/xl1-sdk';
-export declare function basicRemoteViewerLocator(name: string, remoteConfig: RemoteConfig, dataLakeEndpoint?: string, validators?: BlockValidators): Promise<import("@xyo-network/xl1-sdk").ProviderFactoryLocator<import("@xyo-network/xl1-sdk").CreatableProviderContextType, string[]>>;
+export declare function basicRemoteViewerLocator(name: string, remoteConfig: RemoteConfig, dataLakeEndpoint?: string, validators?: BlockValidators): Promise<import("@xyo-network/xl1-sdk").ProviderFactoryLocatorInstance<import("@xyo-network/xl1-sdk").CreatableProviderContextType>>;
 //# sourceMappingURL=basicRemoteViewerLocator.d.ts.map

package/dist/browser/node/config/locators/basicRemoteViewerLocator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basicRemoteViewerLocator.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/locators/basicRemoteViewerLocator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAMzE,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,YAAY,EAC1B,gBAAgB,CAAC,EAAE,MAAM,EACzB,UAAU,CAAC,EAAE,eAAe,yIAW7B"}
+{"version":3,"file":"basicRemoteViewerLocator.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/locators/basicRemoteViewerLocator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAMzE,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,YAAY,EAC1B,gBAAgB,CAAC,EAAE,MAAM,EACzB,UAAU,CAAC,EAAE,eAAe,uIAW7B"}

package/dist/browser/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/browser/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/browser/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/browser/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/browser/node/config/locators/localLocatorFromConfig.d.ts

@@ -1,4 +1,12 @@
 import type { ActorConfigContext } from '@xyo-network/xl1-sdk';
-import { ProviderFactoryLocator } from '@xyo-network/xl1-sdk';
-export declare function localLocatorFromConfig(context: ActorConfigContext, validateDepsOnRegister?: boolean, onInsecureGenesisConfirm?: () => Promise<void>): Promise<ProviderFactoryLocator<import("@xyo-network/xl1-sdk").CreatableProviderContextType, string[]>>;
+/**
+ * Builds a locator with all Tier-1 in-process providers registered.
+ *
+ * As of the capability-registry refactor this is a thin shim over
+ * `locatorFromActorNeeds`. The first parameter is preserved for
+ * backward-compat; `validateDepsOnRegister` is forwarded to the underlying
+ * locator. `onInsecureGenesisConfirm` is forwarded to
+ * `buildProcessSharedResources`.
+ */
+export declare function localLocatorFromConfig(context: ActorConfigContext, validateDepsOnRegister?: boolean, onInsecureGenesisConfirm?: () => Promise<void>): Promise<import("@xyo-network/xl1-sdk").ProviderFactoryLocatorInstance<import("@xyo-network/xl1-sdk").CreatableProviderContextType>>;
 //# sourceMappingURL=localLocatorFromConfig.d.ts.map

package/dist/browser/node/config/locators/localLocatorFromConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"localLocatorFromConfig.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/locators/localLocatorFromConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAwC,MAAM,sBAAsB,CAAA;AACpG,OAAO,EAEL,sBAAsB,EAgBvB,MAAM,sBAAsB,CAAA;AAkB7B,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,kBAAkB,EAC3B,sBAAsB,UAAQ,EAC9B,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,0GA4D/C"}
+{"version":3,"file":"localLocatorFromConfig.d.ts","sourceRoot":"","sources":["../../../../../src/node/config/locators/localLocatorFromConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAqD9D;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,kBAAkB,EAC3B,sBAAsB,UAAQ,EAC9B,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,uIAO/C"}

package/dist/browser/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/browser/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

package/dist/browser/node/config/tryParseConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tryParseConfig.d.ts","sourceRoot":"","sources":["../../../../src/node/config/tryParseConfig.ts"],"names":[],"mappings":"AAcA,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,UAAU,EAAE,MAAM;CAI/B;AAUD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkC9F"}
+{"version":3,"file":"tryParseConfig.d.ts","sourceRoot":"","sources":["../../../../src/node/config/tryParseConfig.ts"],"names":[],"mappings":"AAcA,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,UAAU,EAAE,MAAM;CAI/B;AAUD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkC9F"}

package/dist/browser/shared/actor/index.d.ts

@@ -1,2 +1,2 @@
-export * from './FinalizerActor.ts';
+export * from './v3/index.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/browser/shared/actor/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/actor/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/actor/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA"}

package/dist/browser/shared/actor/v3/ActorV3.d.ts

@@ -0,0 +1,102 @@
+import type { Counter, Gauge, Histogram, UpDownCounter } from '@opentelemetry/api';
+import type { CreatableInstance, CreatableName, CreatableParams, CreatableStatusReporter, EmptyObject, Logger } from '@xylabs/sdk-js';
+import { AbstractCreatable } from '@xylabs/sdk-js';
+import type { AccountInstance } from '@xyo-network/sdk-js';
+import type { CreatableProviderContextType, ProviderFactoryLocatorInstance } from '@xyo-network/xl1-sdk';
+import { Semaphore } from 'async-mutex';
+import z from 'zod';
+export declare const ActorParamsV3Zod: z.ZodObject<{
+    account: z.ZodCustom<AccountInstance, AccountInstance>;
+    locator: z.ZodUnknown;
+    name: z.ZodCustom<CreatableName, CreatableName>;
+    statusReporter: z.ZodOptional<z.ZodCustom<CreatableStatusReporter<void>, CreatableStatusReporter<void>>>;
+}, z.z.core.$strip>;
+export type ActorParamsV3<T extends EmptyObject | void = void> = CreatableParams & {
+    account: AccountInstance;
+    locator: ProviderFactoryLocatorInstance;
+} & (T extends void ? EmptyObject : T);
+export type ActorInstanceV3<T extends ActorParamsV3 = ActorParamsV3> = CreatableInstance<T>;
+export type ReadyState = 'pending' | 'ready' | 'failed';
+export interface ReadinessSignal {
+    readonly readyError?: Error;
+    readonly readyState: ReadyState;
+    whenReady(timeoutMs?: number): Promise<void>;
+}
+/**
+ * Declarative description of the providers an actor needs from a locator.
+ * Surfaced as `static readonly needs` on each `ActorV3` subclass; consumed
+ * by `locatorFromActorNeeds` to plan which providers to register in a
+ * shared per-process locator.
+ *
+ * `required` monikers must resolve or boot fails fast.
+ * `optional` monikers are looked up via `tryGetInstance` and tolerate absence.
+ */
+export interface ActorCapabilityNeeds {
+    readonly optional?: readonly string[];
+    readonly required: readonly string[];
+}
+/**
+ * In-repo fork of `ActorV3` from `@xyo-network/xl1-sdk`, extended with a
+ * readiness contract.
+ *
+ * - `start()` (inherited from `AbstractCreatable`) brings up machinery: timers
+ *   registered, servers bound. Status transitions to `started`.
+ * - `runReadyHandler()` is invoked by the `Orchestrator` after `start()` to
+ *   run a warm-pass via `readyHandler()`. Subclasses override `readyHandler`
+ *   if they need to prove they can do useful work (first block produced,
+ *   first finalization pass, first prune, etc).
+ * - `whenReady()` resolves once `readyHandler` resolves; rejects on warm-pass
+ *   failure.
+ */
+export declare abstract class ActorV3<TParams extends ActorParamsV3 = ActorParamsV3> extends AbstractCreatable<TParams> implements ReadinessSignal {
+    protected readonly _intervals: Map<string, NodeJS.Timeout>;
+    protected readonly _semaphores: Map<string, Semaphore>;
+    protected readonly _timeouts: Map<string, NodeJS.Timeout>;
+    private _logger?;
+    private _readyDeferred;
+    private _readyError?;
+    private _readyState;
+    get logger(): Logger;
+    get readyError(): Error | undefined;
+    get readyState(): ReadyState;
+    protected get account(): AccountInstance;
+    protected get context(): CreatableProviderContextType;
+    protected get locator(): ProviderFactoryLocatorInstance;
+    static paramsHandler<T extends ActorInstanceV3>(params: Partial<T['params']>): Promise<T['params']>;
+    /**
+     * The timer runs until the actor is deactivated (or you manually stop it).
+     */
+    registerTimer(timerName: string, callback: () => Promise<void>, dueTimeMs: number, periodMs: number): void;
+    /**
+     * Invoked by the Orchestrator after `start()` to run the warm-pass.
+     * Idempotent: returns immediately if already invoked.
+     * Throws if `readyHandler` throws; resolves once `readyHandler` resolves.
+     */
+    runReadyHandler(): Promise<void>;
+    stopHandler(): Promise<void>;
+    whenReady(timeoutMs?: number): Promise<void>;
+    /**
+     * Create a `Counter` instrument bound to this actor's meter, or a no-op
+     * stub if telemetry is not wired. Always returns a non-undefined value so
+     * call sites can drop the optional-chain on `.add()`.
+     *
+     * TODO: in a future pass, consider folding these single-instrument helpers
+     * into a declarative `createActorMeters({ counters: {...}, gauges: {...} })`
+     * spec API for actors with many instruments.
+     */
+    protected counter(name: string, description: string): Counter;
+    /** Create a synchronous `Gauge` instrument, or a no-op stub if telemetry is not wired. */
+    protected gauge(name: string, description: string): Gauge;
+    /** Create a `Histogram` instrument, or a no-op stub if telemetry is not wired. */
+    protected histogram(name: string, description: string): Histogram;
+    /**
+     * Override in subclasses to prove the actor can do useful work.
+     * Default: no-op (the actor declares itself ready as soon as `start()` returns).
+     */
+    protected readyHandler(): Promise<void>;
+    /** Create an `UpDownCounter` instrument, or a no-op stub if telemetry is not wired. */
+    protected upDownCounter(name: string, description: string): UpDownCounter;
+}
+export declare abstract class Actor<TParams extends ActorParamsV3 = ActorParamsV3> extends ActorV3<TParams> {
+}
+//# sourceMappingURL=ActorV3.d.ts.map

package/dist/browser/shared/actor/v3/ActorV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorV3.d.ts","sourceRoot":"","sources":["../../../../../src/shared/actor/v3/ActorV3.ts"],"names":[],"mappings":"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"}