@xyo-network/xl1-sdk 4.0.11 → 4.0.12

package/dist/browser/modules/protocol-sdk/capabilities/Backing.d.ts

@@ -0,0 +1,52 @@
+/**
+ * A `Backing` names a class of runtime resources a provider may need access to.
+ * Each backing is owned (writable) by exactly one actor in a deployment; other
+ * actors may hold it as read-only or not at all.
+ *
+ * - `chain-store` — finalized/canonical chain archivists. Owned by the Finalizer.
+ * - `mempool-store` — pending transaction and pending block archivists. Owned by the Mempool actor.
+ * - `dlq-store` — rejected blocks and rejected transactions archivists. Owned by the Finalizer.
+ * - `indexer-store` — derived summary maps (account balances, transfers, etc.).
+ *   Owned by the IndexerActor.
+ * - `evm-rpc` — connection to the backing EVM chain (Sepolia/Mainnet/Hardhat). Owned by the Bridge.
+ * - `wallet` — per-actor signing wallet. Each actor owns its own.
+ * - `network` — JSON-RPC transport to another XL1 actor. Pure transport; no ownership.
+ */
+export type Backing = 'chain-store' | 'mempool-store' | 'dlq-store' | 'indexer-store' | 'evm-rpc' | 'wallet' | 'network';
+/**
+ * A `BackingNeed` pairs a backing with the access mode required.
+ *
+ * - `read` is satisfied by either a `read` or `write` ownership in the locator.
+ * - `write` is only satisfied by `write` ownership.
+ *
+ * Descriptors declare the backings they need; locators declare the backings they have.
+ * The resolver filters out descriptors whose backings aren't a subset of the locator's.
+ */
+export interface BackingNeed {
+    readonly backing: Backing;
+    readonly mode: 'read' | 'write';
+}
+/**
+ * The two API surfaces exposed by an XL1 API actor over JSON-RPC.
+ *
+ * - `node` — point queries on canonical chain state (block/tx/mempool/finality/balance).
+ *   Analogous to a base Ethereum node's RPC. Exposed at `POST /rpc`.
+ * - `indexed` — cross-key or aggregate queries that require an indexer
+ *   (stake-by-staker, stake-events, NetworkStake step rewards, etc.).
+ *   Analogous to Etherscan-style APIs. Exposed at `POST /rpc/indexed`.
+ *
+ * The litmus test: if the query is `f(primary_key) → value` it's `node`; if it's
+ * `f(secondary_attribute) → list` it's `indexed`.
+ */
+export type Surface = 'node' | 'indexed';
+/**
+ * Returns true iff every need in `required` is satisfied by some entry in `available`.
+ * `read` is satisfied by either `read` or `write`; `write` requires `write`.
+ */
+export declare function backingsSatisfied(required: readonly BackingNeed[], available: readonly BackingNeed[]): boolean;
+/**
+ * Diagnostic helper: returns a human-readable description of which needs are unmet
+ * given the available backings.
+ */
+export declare function unmetBackings(required: readonly BackingNeed[], available: readonly BackingNeed[]): readonly BackingNeed[];
+//# sourceMappingURL=Backing.d.ts.map

package/dist/browser/modules/protocol-sdk/capabilities/Backing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Backing.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/capabilities/Backing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,OAAO,GACb,aAAa,GACb,eAAe,GACf,WAAW,GACX,eAAe,GACf,SAAS,GACT,QAAQ,GACR,SAAS,CAAA;AAEf;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAChC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;AAExC;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,SAAS,EAAE,SAAS,WAAW,EAAE,GAChC,OAAO,CAMT;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,SAAS,EAAE,SAAS,WAAW,EAAE,GAChC,SAAS,WAAW,EAAE,CAIxB"}

package/dist/browser/modules/protocol-sdk/capabilities/Capability.d.ts

@@ -0,0 +1,32 @@
+import type { ProviderMoniker } from '@xyo-network/xl1-protocol/protocol-model';
+import type { Surface } from './Backing.js';
+/**
+ * Declarative description of a capability that an actor may need.
+ *
+ * The capability registry is a sidecar to the moniker namespace — every
+ * moniker that an actor consumes should have a corresponding `Capability`
+ * entry. Plan-time transitive closure uses `ProviderDescriptor.dependencies`.
+ */
+export interface Capability {
+    /** Canonical id — equals the existing moniker constant string. */
+    readonly id: ProviderMoniker;
+    readonly kind: 'viewer' | 'runner' | 'gateway' | 'archivist' | 'signer';
+    /** Human label for diagnostics. */
+    readonly label: string;
+    /**
+     * Which API surface this capability is exposed under — `'node'` for point
+     * queries on canonical state (Ethereum-node analog) or `'indexed'` for
+     * cross-key/aggregate queries (Etherscan analog). Connection-level umbrellas
+     * (`XyoConnection`, `XyoGatewayRunner`) carry `'node'`; the actual filtering
+     * is done downstream by `connectionSubsetBySurface`.
+     */
+    readonly surface: Surface;
+}
+export interface CapabilityRegistryInstance {
+    get(id: ProviderMoniker): Capability;
+    register(cap: Capability): this;
+    toJson(): Record<ProviderMoniker, Omit<Capability, 'id'>>;
+    tryGet(id: ProviderMoniker): Capability | undefined;
+}
+export declare function createCapabilityRegistry(): CapabilityRegistryInstance;
+//# sourceMappingURL=Capability.d.ts.map

package/dist/browser/modules/protocol-sdk/capabilities/Capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Capability.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/capabilities/Capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAE/E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAA;IACvE,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,GAAG,CAAC,EAAE,EAAE,eAAe,GAAG,UAAU,CAAA;IACpC,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAAA;IAC/B,MAAM,IAAI,MAAM,CAAC,eAAe,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAA;IACzD,MAAM,CAAC,EAAE,EAAE,eAAe,GAAG,UAAU,GAAG,SAAS,CAAA;CACpD;AAiCD,wBAAgB,wBAAwB,IAAI,0BAA0B,CAErE"}

package/dist/browser/modules/protocol-sdk/capabilities/Provider.d.ts

@@ -0,0 +1,31 @@
+import type { ProviderMoniker } from '@xyo-network/xl1-protocol/protocol-model';
+import type { CreatableProvider, CreatableProviderConnectionType } from '../CreatableProvider/CreatableProvider.js';
+import type { Surface } from './Backing.js';
+/**
+ * Plan-time candidate for provider resolution (used by `resolveProviders`).
+ *
+ * Metadata (`connectionTypes`, `dependencies`, `surface`, `satisfies`) is
+ * derived from `CreatableProvider` class statics via `providerCandidateFromClass`.
+ * Selection is config-only: `providerBindings` + `connections` type matching.
+ */
+export interface ProviderDescriptor {
+    /**
+     * Connection kinds this candidate supports (e.g. `lmdb`, `rpc`). Empty array
+     * means wildcard — matches any bound connection type.
+     */
+    readonly connectionTypes: readonly CreatableProviderConnectionType[];
+    /** Implementation class selected when this candidate wins. */
+    readonly creatableProvider: CreatableProvider;
+    /**
+     * Monikers this provider resolves at register/create time. Drives plan-time
+     * transitive closure and topological ordering.
+     */
+    readonly dependencies?: readonly ProviderMoniker[];
+    /** Globally-unique key, usually the class name — used in snapshots and diagnostics. */
+    readonly id: string;
+    /** Capabilities this candidate satisfies (typically `monikers` from the class). */
+    readonly satisfies: readonly ProviderMoniker[];
+    /** Which API surface this capability is exposed under. */
+    readonly surface: Surface;
+}
+//# sourceMappingURL=Provider.d.ts.map

package/dist/browser/modules/protocol-sdk/capabilities/Provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/capabilities/Provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAE/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAA;AACnH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,SAAS,+BAA+B,EAAE,CAAA;IACpE,8DAA8D;IAC9D,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAA;IAC7C;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;IAClD,uFAAuF;IACvF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,mFAAmF;IACnF,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAA;IAC9C,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B"}

package/dist/browser/modules/protocol-sdk/capabilities/connectionSubsetBySurface.d.ts

@@ -0,0 +1,17 @@
+import type { XyoConnection } from '@xyo-network/xl1-protocol/protocol-lib';
+import type { Surface } from './Backing.js';
+/**
+ * Returns a shallow-cloned `XyoConnection` retaining only the branches whose
+ * surface matches the requested one.
+ *
+ * The filter walks a fixed structural map of `XyoConnection` (see
+ * `surfaceMap.ts`). Branches whose surface differs are omitted from the
+ * returned connection so that downstream consumers (`rpcMethodHandlersFromConnection`,
+ * `rpcServerFromConnection`, etc.) naturally produce a smaller method set
+ * without having to know about surfaces themselves.
+ *
+ * Used by API actor route wiring to mount `POST /rpc` (node-only) and
+ * `POST /rpc/indexed` (indexer-only) over the same underlying connection.
+ */
+export declare function connectionSubsetBySurface(connection: XyoConnection, surface: Surface): XyoConnection;
+//# sourceMappingURL=connectionSubsetBySurface.d.ts.map

package/dist/browser/modules/protocol-sdk/capabilities/connectionSubsetBySurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionSubsetBySurface.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/capabilities/connectionSubsetBySurface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAE3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAM3C;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,aAAa,EACzB,OAAO,EAAE,OAAO,GACf,aAAa,CAcf"}

package/dist/browser/modules/protocol-sdk/capabilities/connectionTypes.d.ts

@@ -0,0 +1,10 @@
+import type { ConnectionKind } from '../config/connections/Connection.js';
+import type { CreatableProviderConnectionType } from '../CreatableProvider/CreatableProvider.js';
+import type { ProviderDescriptor } from './Provider.js';
+/**
+ * Connection types a descriptor supports. An empty array is a wildcard: the
+ * descriptor matches any bound connection type (used by in-process memory stubs).
+ */
+export declare function descriptorConnectionTypes(descriptor: Pick<ProviderDescriptor, 'connectionTypes'>): readonly CreatableProviderConnectionType[];
+export declare function descriptorMatchesConnectionType(descriptor: Pick<ProviderDescriptor, 'connectionTypes'>, connectionType: ConnectionKind): boolean;
+//# sourceMappingURL=connectionTypes.d.ts.map

package/dist/browser/modules/protocol-sdk/capabilities/connectionTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionTypes.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/capabilities/connectionTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAA;AACzE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAA;AAChG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,GACtD,SAAS,+BAA+B,EAAE,CAE5C;AAED,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,EACvD,cAAc,EAAE,cAAc,GAC7B,OAAO,CAMT"}

package/dist/browser/modules/protocol-sdk/capabilities/factoryBrand.d.ts

@@ -0,0 +1,46 @@
+import type { CreatableProviderFactory } from '../CreatableProvider/index.js';
+import type { BackingNeed } from './Backing.js';
+/**
+ * Phantom-typed brand on `CreatableProviderFactory` recording which backings
+ * the factory's underlying provider needs.
+ *
+ * Purely a compile-time tag — there is no runtime impact. Runtime callers
+ * that don't care can keep using the bare `CreatableProviderFactory` type;
+ * locators that want to enforce a backing-subset rule at compile time can
+ * accept `BrandedFactory<L>` parameters that constrain what factories may be
+ * registered.
+ */
+export type BrandedFactory<B extends readonly BackingNeed[] = readonly BackingNeed[]> = CreatableProviderFactory & {
+    readonly __backings?: B;
+};
+/**
+ * Brand a factory with the backings it depends on. Returns the same value at
+ * runtime — the brand is only a phantom type.
+ *
+ * @example
+ *   const f = backedFactory(
+ *     [{ backing: 'chain-store', mode: 'write' }] as const,
+ *     SimpleFinalizationRunner.factory(SimpleFinalizationRunner.dependencies, {...}),
+ *   )
+ *   // f is BrandedFactory<readonly [{backing: 'chain-store', mode: 'write'}]>
+ */
+export declare function backedFactory<B extends readonly BackingNeed[]>(_backings: B, factory: CreatableProviderFactory): BrandedFactory<B>;
+/**
+ * Helper: brand a factory as needing only the network transport. Convenient
+ * shorthand for `JsonRpc*` factories.
+ */
+export declare function networkBackedFactory(factory: CreatableProviderFactory): BrandedFactory<readonly [{
+    readonly backing: 'network';
+    readonly mode: 'read';
+}]>;
+/**
+ * Runtime check: is `factory`'s declared backings a subset of `availableBackings`?
+ *
+ * The brand is type-only, so at runtime we have no way to inspect what backings
+ * the factory was branded with. This helper exists for cases where the caller
+ * has the backings array separately (e.g. from the descriptor that built the
+ * factory) and wants a runtime gate. Use `backingsSatisfied` directly with the
+ * descriptor's `backings` field.
+ */
+export declare function factoryBackingsCompatible(declared: readonly BackingNeed[], available: readonly BackingNeed[]): boolean;
+//# sourceMappingURL=factoryBrand.d.ts.map

package/dist/browser/modules/protocol-sdk/capabilities/factoryBrand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factoryBrand.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/capabilities/factoryBrand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAG/C;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,SAAS,WAAW,EAAE,GAAG,SAAS,WAAW,EAAE,IAChF,wBAAwB,GAAG;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA;AAE1D;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,SAAS,WAAW,EAAE,EAC5D,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,wBAAwB,GAChC,cAAc,CAAC,CAAC,CAAC,CAEnB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,wBAAwB,GAChC,cAAc,CAAC,SAAS,CAAC;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAEnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,SAAS,EAAE,SAAS,WAAW,EAAE,GAChC,OAAO,CAET"}

package/dist/browser/modules/protocol-sdk/capabilities/index.d.ts

@@ -0,0 +1,12 @@
+export * from './Backing.js';
+export * from './Capability.js';
+export * from './connectionSubsetBySurface.js';
+export * from './connectionTypes.js';
+export * from './factoryBrand.js';
+export * from './locatorFromConfig.js';
+export * from './needsFromProviderBindings.js';
+export * from './Provider.js';
+export * from './providerCandidateFromClass.js';
+export * from './resolveProviders.js';
+export * from './surfaceMap.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/modules/protocol-sdk/capabilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/capabilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gCAAgC,CAAA;AAC9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,eAAe,CAAA;AAC7B,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA"}

package/dist/browser/modules/protocol-sdk/capabilities/locatorFromConfig.d.ts

@@ -0,0 +1,29 @@
+import type { ProviderMoniker } from '@xyo-network/xl1-protocol/protocol-model';
+import type { LocatorConfig } from '../config/LocatorConfigFields.js';
+import { ProviderFactoryLocator } from '../CreatableProvider/ProviderFactoryLocator.js';
+import type { CreatableProviderContext } from '../model/index.js';
+import type { ProviderDescriptor } from './Provider.js';
+import { type ResolutionPlan } from './resolveProviders.js';
+/** Options for building a locator from config-driven provider resolution. */
+export interface LocatorFromConfigOptions {
+    readonly candidates: readonly ProviderDescriptor[];
+    readonly config: LocatorConfig;
+    readonly context?: Omit<CreatableProviderContext, 'config' | 'locator'>;
+    readonly needs: ReadonlySet<ProviderMoniker>;
+}
+/**
+ * Resolves which provider classes to register for the given config bindings.
+ * Selection uses only `providerBindings` + `connections` — no runtime preconditions.
+ */
+export declare function resolveProvidersFromConfig(needs: ReadonlySet<ProviderMoniker>, candidates: readonly ProviderDescriptor[], config: LocatorConfig): ResolutionPlan;
+/**
+ * Registers factories for a resolution plan. Params are empty — implementations
+ * are expected to read their bound connection from `context.config` at runtime.
+ */
+export declare function registerFactoriesFromPlan(locator: ProviderFactoryLocator, plan: ResolutionPlan): void;
+/**
+ * Builds a `ProviderFactoryLocator` from config: resolve candidates, then register
+ * winning factories. Connection profiles come from config, not factory params.
+ */
+export declare function locatorFromConfig(options: LocatorFromConfigOptions): ProviderFactoryLocator;
+//# sourceMappingURL=locatorFromConfig.d.ts.map

package/dist/browser/modules/protocol-sdk/capabilities/locatorFromConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locatorFromConfig.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/capabilities/locatorFromConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAE/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAErE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAA;AACvF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,EAAE,KAAK,cAAc,EAAoB,MAAM,uBAAuB,CAAA;AAE7E,6EAA6E;AAC7E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAClD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAA;IACvE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,CAAA;CAC7C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,EACnC,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,MAAM,EAAE,aAAa,GACpB,cAAc,CAMhB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,cAAc,GACnB,IAAI,CAMN;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,sBAAsB,CAWxB"}

package/dist/browser/modules/protocol-sdk/capabilities/needsFromProviderBindings.d.ts

@@ -0,0 +1,8 @@
+import type { ProviderMoniker } from '@xyo-network/xl1-protocol/protocol-model';
+import type { Config } from '../config/Config.js';
+import type { ConnectionKind } from '../config/connections/Connection.js';
+/** Derives resolution needs from every moniker declared in `providerBindings`. */
+export declare function needsFromProviderBindings(config: Pick<Config, 'providerBindings'>): ReadonlySet<ProviderMoniker>;
+/** Derives needs for monikers whose bound connection matches one of the given types. */
+export declare function needsFromConnectionTypes(config: Pick<Config, 'connections' | 'providerBindings'>, connectionTypes: readonly ConnectionKind[]): ReadonlySet<ProviderMoniker>;
+//# sourceMappingURL=needsFromProviderBindings.d.ts.map

package/dist/browser/modules/protocol-sdk/capabilities/needsFromProviderBindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"needsFromProviderBindings.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/capabilities/needsFromProviderBindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAE/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAA;AAEzE,kFAAkF;AAClF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,GACvC,WAAW,CAAC,eAAe,CAAC,CAE9B;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAAC,EACxD,eAAe,EAAE,SAAS,cAAc,EAAE,GACzC,WAAW,CAAC,eAAe,CAAC,CAgB9B"}

package/dist/browser/modules/protocol-sdk/capabilities/providerCandidateFromClass.d.ts

@@ -0,0 +1,7 @@
+import type { CreatableProvider } from '../CreatableProvider/CreatableProvider.js';
+import type { ProviderDescriptor } from './Provider.js';
+/** Derives a resolution candidate from a `CreatableProvider` implementation class. */
+export declare function providerCandidateFromClass(creatableProvider: CreatableProvider, id?: string): ProviderDescriptor;
+/** Derives resolution candidates from a list of provider implementation classes. */
+export declare function providerCandidatesFromClasses(creatableProviders: readonly CreatableProvider[]): ProviderDescriptor[];
+//# sourceMappingURL=providerCandidateFromClass.d.ts.map

package/dist/browser/modules/protocol-sdk/capabilities/providerCandidateFromClass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerCandidateFromClass.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/capabilities/providerCandidateFromClass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAA;AAClF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD,sFAAsF;AACtF,wBAAgB,0BAA0B,CACxC,iBAAiB,EAAE,iBAAiB,EACpC,EAAE,GAAE,MAA+B,GAClC,kBAAkB,CASpB;AAED,oFAAoF;AACpF,wBAAgB,6BAA6B,CAC3C,kBAAkB,EAAE,SAAS,iBAAiB,EAAE,GAC/C,kBAAkB,EAAE,CAEtB"}

package/dist/browser/modules/protocol-sdk/capabilities/resolveProviders.d.ts

@@ -0,0 +1,56 @@
+import type { ProviderMoniker } from '@xyo-network/xl1-protocol/protocol-model';
+import type { ConnectionConfig } from '../config/connections/Connection.js';
+import type { ProviderDescriptor } from './Provider.js';
+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[]);
+}
+export declare class AmbiguousProviderError extends Error {
+    readonly candidates: readonly string[];
+    readonly moniker: ProviderMoniker;
+    constructor(moniker: ProviderMoniker, candidates: readonly ProviderDescriptor[]);
+}
+export declare class UnboundProviderError extends Error {
+    readonly moniker: ProviderMoniker;
+    constructor(moniker: ProviderMoniker);
+}
+export declare class UnknownConnectionError extends Error {
+    readonly connectionName: string;
+    readonly moniker: ProviderMoniker;
+    constructor(moniker: ProviderMoniker, connectionName: string);
+}
+interface ProviderBindingLike {
+    connection?: string;
+}
+export interface ResolveProvidersOptions {
+    readonly connections?: Readonly<Record<string, ConnectionConfig>>;
+    readonly providerBindings?: Readonly<Partial<Record<ProviderMoniker, ProviderBindingLike>>>;
+}
+/**
+ * Plans which providers to register for a given set of needs.
+ *
+ * 1. Fixpoint-expand monikers from selected descriptor `dependencies`.
+ * 2. Require `providerBindings[moniker].connection` for every connection-consuming
+ *    moniker. A moniker satisfied by a single wildcard candidate consumes no
+ *    connection of its own (it delegates storage to its dependencies) and binds
+ *    directly, with no binding required.
+ * 3. Filter candidates by bound connection type.
+ * 4. Throw when zero or multiple candidates remain.
+ * 5. Toposort selected descriptors using `dependencies`.
+ */
+export declare function resolveProviders(needs: ReadonlySet<ProviderMoniker>, candidates: readonly ProviderDescriptor[], options?: ResolveProvidersOptions): ResolutionPlan;
+export {};
+//# sourceMappingURL=resolveProviders.d.ts.map

package/dist/browser/modules/protocol-sdk/capabilities/resolveProviders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveProviders.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/capabilities/resolveProviders.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAE/E,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,qCAAqC,CAAA;AAE3F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD,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,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;gBAErB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,kBAAkB,EAAE;CAShF;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;gBAErB,OAAO,EAAE,eAAe;CAKrC;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;gBAErB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM;CAQ7D;AAED,UAAU,mBAAmB;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAA;IACjE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;CAC5F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,EACnC,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,OAAO,GAAE,uBAA4B,GACpC,cAAc,CAsBhB"}

package/dist/browser/modules/protocol-sdk/capabilities/surfaceMap.d.ts

@@ -0,0 +1,11 @@
+import type { Surface } from './Backing.js';
+export declare function surfaceForBranch(branch: string): Surface | undefined;
+/**
+ * Branch keys on `XyoViewer` that may need to be filtered by surface.
+ * `connectionSubsetBySurface` iterates over this list to decide what to keep.
+ *
+ * Each entry is `[viewerKey, fully-qualified-branch-key]`.
+ */
+export declare const VIEWER_BRANCH_KEYS: readonly [readonly ["block", "viewer.block"], readonly ["transaction", "viewer.transaction"], readonly ["mempool", "viewer.mempool"], readonly ["finalization", "viewer.finalization"], readonly ["time", "viewer.time"], readonly ["account", "viewer.account.balance"], readonly ["networkStake", "viewer.networkStake"], readonly ["stake", "viewer.stake"], readonly ["step", "viewer.step"]];
+export type ViewerBranchKey = (typeof VIEWER_BRANCH_KEYS)[number][0];
+//# sourceMappingURL=surfaceMap.d.ts.map

package/dist/browser/modules/protocol-sdk/capabilities/surfaceMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceMap.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/capabilities/surfaceMap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAgC3C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEpE;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,mYAUrB,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA"}