@xyo-network/xl1-sdk 4.0.10 → 4.0.12

package/dist/neutral/modules/providers/creators/createRestDataLake.d.ts

@@ -0,0 +1,32 @@
+import type { RestDataLakeViewerParams } from '../../protocol-sdk/index.js';
+import { RestDataLakeRunner, RestDataLakeViewer } from '../../protocol-sdk/index.js';
+/**
+ * Creates a read-only {@link RestDataLakeViewer} bound to the given REST
+ * endpoint, using a default {@link BaseConfig} context (see
+ * {@link baseConfigFactoryLocator}). The viewer is the only provider
+ * registered on the underlying locator, which is then frozen before the
+ * instance is resolved and returned.
+ *
+ * Use this for read-only data-lake access (e.g. `get(hashes)`) when you don't
+ * need a full actor or remote-RPC stack — only protocol defaults plus the
+ * data-lake endpoint.
+ *
+ * @param dataLakeEndpoint - Base URL of the REST data lake (e.g.
+ *   `https://beta.api.archivist.xyo.network/dataLake`).
+ */
+export declare function createRestDataLakeViewer(dataLakeEndpoint: string): Promise<import('../../protocol-sdk/index.js').CreatableProviderInstance<RestDataLakeViewer<RestDataLakeViewerParams>>>;
+/**
+ * Creates a read-write {@link RestDataLakeRunner} bound to the given REST
+ * endpoint, using a default {@link BaseConfig} context (see
+ * {@link baseConfigFactoryLocator}). The runner is the only provider
+ * registered on the underlying locator, which is then frozen before the
+ * instance is resolved and returned.
+ *
+ * Use this when you need to insert payloads into the data lake in addition to
+ * reading them, without spinning up a full actor or remote-RPC stack.
+ *
+ * @param dataLakeEndpoint - Base URL of the REST data lake (e.g.
+ *   `https://beta.api.archivist.xyo.network/dataLake`).
+ */
+export declare function createRestDataLakeRunner(dataLakeEndpoint: string): Promise<import('../../protocol-sdk/index.js').CreatableProviderInstance<RestDataLakeRunner<RestDataLakeViewerParams>>>;
+//# sourceMappingURL=createRestDataLake.d.ts.map

package/dist/neutral/modules/providers/creators/createRestDataLake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRestDataLake.d.ts","sourceRoot":"","sources":["../../../../../src/modules/providers/creators/createRestDataLake.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAItE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAC5C,gBAAgB,EAAE,MAAM,4GAUzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAC5C,gBAAgB,EAAE,MAAM,4GAUzB"}

package/dist/neutral/modules/providers/creators/index.d.ts

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

package/dist/neutral/modules/providers/creators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/providers/creators/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA"}

package/dist/neutral/modules/providers/index.d.ts

@@ -0,0 +1,13 @@
+export * from './buildSimpleXyoSigner.js';
+export * from './creators/index.js';
+export * from './locators/index.js';
+export * from './registerHelpers.js';
+export * from './SimpleDeadLetterQueueRunner.js';
+export * from './SimpleDeadLetterQueueViewer.js';
+export * from './SimpleNetworkStakeViewer.js';
+export * from './SimpleStepRewards/index.js';
+export * from './SimpleStepViewer.js';
+export * from './SimpleXyoConnectionRunner.js';
+export * from './SimpleXyoConnectionViewer.js';
+export * from './SimpleXyoViewer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,kCAAkC,CAAA;AAChD,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uBAAuB,CAAA;AACrC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,sBAAsB,CAAA"}

package/dist/neutral/modules/providers/locators/baseConfigFactoryLocator.d.ts

@@ -0,0 +1,17 @@
+import { ProviderFactoryLocator } from '../../protocol-sdk/index.js';
+/**
+ * Builds an empty {@link ProviderFactoryLocator} whose context carries a default
+ * {@link LocatorConfig} — i.e. `LocatorConfigFieldsZod.parse({})`.
+ *
+ * The resulting config is the schema's defaults only: `chain`, `connections`,
+ * `log`, `providerBindings`, `providers`, `telemetry`, and `validation` all
+ * populated from `*ConfigZod.parse({})`. There is no actor identity (no `name`,
+ * `accountPath`, or `healthCheckPort`) — that lives on `ActorConfig`, not
+ * locator process fields. Use this when you need a locator rooted in protocol
+ * defaults rather than an actor's configuration.
+ *
+ * No providers are registered on the returned locator and it is not frozen;
+ * the caller is expected to register what they need and (optionally) freeze it.
+ */
+export declare function baseConfigFactoryLocator(): Promise<ProviderFactoryLocator<import('../../protocol-sdk/index.js').CreatableProviderContextType, string[]>>;
+//# sourceMappingURL=baseConfigFactoryLocator.d.ts.map

package/dist/neutral/modules/providers/locators/baseConfigFactoryLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseConfigFactoryLocator.d.ts","sourceRoot":"","sources":["../../../../../src/modules/providers/locators/baseConfigFactoryLocator.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EACvB,MAAM,eAAe,CAAA;AAEtB;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,oGAK7C"}

package/dist/neutral/modules/providers/locators/basicRemoteRunnerLocator.d.ts

@@ -0,0 +1,10 @@
+import type { CreatableProviderFactory, ProviderFactoryLocatorInstance, RpcRemoteConfig } from '../../protocol-sdk/index.js';
+import type { RpcTransport, XyoSignerRpcSchemas } from '../../rpc/index.js';
+import type { BasicRemoteViewerLocatorOptions } from './basicRemoteViewerLocator.js';
+export interface BasicRemoteRunnerLocatorOptions extends BasicRemoteViewerLocatorOptions {
+    additionalRunnerProviders?: CreatableProviderFactory[];
+    signerFactory?: CreatableProviderFactory;
+    skipGatewayRunner?: boolean;
+}
+export declare function basicRemoteRunnerLocator(name: string, rpcConnection: RpcRemoteConfig, signerTransport: RpcTransport<XyoSignerRpcSchemas> | undefined, dataLakeEndpoint?: string, options?: BasicRemoteRunnerLocatorOptions): Promise<ProviderFactoryLocatorInstance>;
+//# sourceMappingURL=basicRemoteRunnerLocator.d.ts.map

package/dist/neutral/modules/providers/locators/basicRemoteRunnerLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basicRemoteRunnerLocator.d.ts","sourceRoot":"","sources":["../../../../../src/modules/providers/locators/basicRemoteRunnerLocator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EAAE,8BAA8B,EAA4B,eAAe,EACpG,MAAM,eAAe,CAAA;AAOtB,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAA;AAI7D,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAA;AAGpF,MAAM,WAAW,+BAAgC,SAAQ,+BAA+B;IACtF,yBAAyB,CAAC,EAAE,wBAAwB,EAAE,CAAA;IACtD,aAAa,CAAC,EAAE,wBAAwB,CAAA;IACxC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,eAAe,EAC9B,eAAe,EAAE,YAAY,CAAC,mBAAmB,CAAC,GAAG,SAAS,EAC9D,gBAAgB,CAAC,EAAE,MAAM,EACzB,OAAO,CAAC,EAAE,+BAA+B,GACxC,OAAO,CAAC,8BAA8B,CAAC,CAuCzC"}

package/dist/neutral/modules/providers/locators/basicRemoteViewerLocator.d.ts

@@ -0,0 +1,8 @@
+import type { CreatableProviderFactory, RpcRemoteConfig } from '../../protocol-sdk/index.js';
+import type { BlockValidators } from './remoteLocatorFromConfig.js';
+export interface BasicRemoteViewerLocatorOptions {
+    additionalProviders?: CreatableProviderFactory[];
+    validators?: BlockValidators;
+}
+export declare function basicRemoteViewerLocator(name: string, rpcConnection: RpcRemoteConfig, dataLakeEndpoint?: string, options?: BasicRemoteViewerLocatorOptions): Promise<import('../../protocol-sdk/index.js').ProviderFactoryLocatorInstance<import('../../protocol-sdk/index.js').CreatableProviderContextType>>;
+//# sourceMappingURL=basicRemoteViewerLocator.d.ts.map

package/dist/neutral/modules/providers/locators/basicRemoteViewerLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basicRemoteViewerLocator.d.ts","sourceRoot":"","sources":["../../../../../src/modules/providers/locators/basicRemoteViewerLocator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAS9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAGnE,MAAM,WAAW,+BAA+B;IAC9C,mBAAmB,CAAC,EAAE,wBAAwB,EAAE,CAAA;IAChD,UAAU,CAAC,EAAE,eAAe,CAAA;CAC7B;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,eAAe,EAC9B,gBAAgB,CAAC,EAAE,MAAM,EACzB,OAAO,CAAC,EAAE,+BAA+B,yHA4B1C"}

package/dist/neutral/modules/providers/locators/basicRestViewerLocator.d.ts

@@ -0,0 +1,33 @@
+import type { RestConnectionConfig } from '../../protocol-sdk/index.js';
+/** REST connection config for the S3-backed static file layout, split by bucket. */
+export interface RestRemoteConfig {
+    /** REST connection over the finalized blocks bucket (always required — the base for BlockViewer/ChainStateViewer/ChainContractViewer). */
+    blocks: RestConnectionConfig;
+    /** REST connection over a separate chain-state bucket, when the head pointer lives apart from finalized blocks. Defaults to `blocks`. */
+    chainState?: RestConnectionConfig;
+    /** REST connection over a separate index bucket, when step summaries live apart from finalized blocks. Defaults to `blocks`. */
+    index?: RestConnectionConfig;
+}
+export interface BasicRestViewerLocatorOptions {
+    dataLakeEndpoint?: string;
+    /** Custom fetch override for every REST viewer (custom agents, auth headers, tests). Defaults to the global fetch. */
+    fetchFn?: typeof globalThis.fetch;
+    /**
+     * Whether `XyoViewer` precomputes network-stake-reward positions across the whole chain at
+     * startup. Defaults to `false` here — unlike `SimpleXyoViewer`'s own node-side default of
+     * `true` — because that precompute issues one REST round trip per position/step, which against
+     * a large live chain turns gateway construction from seconds into minutes-or-worse. Set `true`
+     * only when the client actually needs reward data warmed at startup.
+     */
+    initRewardsCache?: boolean;
+}
+/**
+ * Builds a config-driven, connections-native locator for a REST/S3-backed read-only gateway:
+ * `BlockViewer`/`ChainStateViewer`/`FinalizationViewer`/`ChainContractViewer` are bound to REST
+ * connections over the S3 static file layout; every other viewer moniker
+ * (`synthesizeMemoryViewerBindings`) is bound to a shared `memory` connection, resolving to the
+ * `Simple*` implementations that compute their data from the injected `BlockViewer` instead of a
+ * dedicated remote source. Mirrors `basicRemoteViewerLocator`'s RPC-based counterpart.
+ */
+export declare function basicRestViewerLocator(name: string, restConfig: RestRemoteConfig, dataLakeEndpoint?: string, options?: BasicRestViewerLocatorOptions): Promise<import('../../protocol-sdk/index.js').ProviderFactoryLocatorInstance<import('../../protocol-sdk/index.js').CreatableProviderContextType>>;
+//# sourceMappingURL=basicRestViewerLocator.d.ts.map

package/dist/neutral/modules/providers/locators/basicRestViewerLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basicRestViewerLocator.d.ts","sourceRoot":"","sources":["../../../../../src/modules/providers/locators/basicRestViewerLocator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACiC,oBAAoB,EAChE,MAAM,eAAe,CAAA;AAgBtB,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC/B,0IAA0I;IAC1I,MAAM,EAAE,oBAAoB,CAAA;IAC5B,yIAAyI;IACzI,UAAU,CAAC,EAAE,oBAAoB,CAAA;IACjC,gIAAgI;IAChI,KAAK,CAAC,EAAE,oBAAoB,CAAA;CAC7B;AAED,MAAM,WAAW,6BAA6B;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,sHAAsH;IACtH,OAAO,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IACjC;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,gBAAgB,EAC5B,gBAAgB,CAAC,EAAE,MAAM,EACzB,OAAO,CAAC,EAAE,6BAA6B,yHAyExC"}

package/dist/neutral/modules/providers/locators/index.d.ts

@@ -0,0 +1,9 @@
+export * from './baseConfigFactoryLocator.js';
+export * from './basicRemoteRunnerLocator.js';
+export * from './basicRemoteViewerLocator.js';
+export * from './basicRestViewerLocator.js';
+export * from './locatorFromAdaptedConfig.js';
+export * from './providerCandidates.js';
+export * from './remoteLocatorFromConfig.js';
+export * from './rootLocatorFromConfig.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/providers/locators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/providers/locators/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,yBAAyB,CAAA;AACvC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,4BAA4B,CAAA"}

package/dist/neutral/modules/providers/locators/locatorFromAdaptedConfig.d.ts

@@ -0,0 +1,17 @@
+import type { ProviderMoniker } from '@xyo-network/xl1-protocol/protocol-model';
+import type { CreatableProviderContext, ProviderDescriptor, ProviderFactoryLocatorInstance } from '../../protocol-sdk/index.js';
+/** Options for building a locator from config-driven provider resolution. */
+export interface LocatorFromAdaptedConfigOptions {
+    readonly candidates?: readonly ProviderDescriptor[];
+    /** Host, actor, or run-config slice — locator fields are parsed strictly. */
+    readonly config: unknown;
+    readonly context?: Omit<CreatableProviderContext, 'config' | 'locator'>;
+    readonly needs?: ReadonlySet<ProviderMoniker>;
+    readonly validateDepsOnRegister?: boolean;
+}
+/**
+ * Builds a `ProviderFactoryLocator` by normalizing the config, resolving
+ * provider candidates from `providerBindings`, and registering winning factories.
+ */
+export declare function locatorFromAdaptedConfig(options: LocatorFromAdaptedConfigOptions): ProviderFactoryLocatorInstance;
+//# sourceMappingURL=locatorFromAdaptedConfig.d.ts.map

package/dist/neutral/modules/providers/locators/locatorFromAdaptedConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locatorFromAdaptedConfig.d.ts","sourceRoot":"","sources":["../../../../../src/modules/providers/locators/locatorFromAdaptedConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAE/E,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,8BAA8B,EAC/B,MAAM,eAAe,CAAA;AAYtB,6EAA6E;AAC7E,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;IACnD,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAA;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,CAAA;IAC7C,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAA;CAC1C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,8BAA8B,CAuBhC"}

package/dist/neutral/modules/providers/locators/providerCandidates.d.ts

@@ -0,0 +1,4 @@
+import type { ProviderDescriptor } from '../../protocol-sdk/index.js';
+/** All known provider implementations for config-driven locator resolution. */
+export declare function allProviderCandidates(): ProviderDescriptor[];
+//# sourceMappingURL=providerCandidates.d.ts.map

package/dist/neutral/modules/providers/locators/providerCandidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerCandidates.d.ts","sourceRoot":"","sources":["../../../../../src/modules/providers/locators/providerCandidates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAuH1E,+EAA+E;AAC/E,wBAAgB,qBAAqB,IAAI,kBAAkB,EAAE,CAE5D"}

package/dist/neutral/modules/providers/locators/remoteLocatorFromConfig.d.ts

@@ -0,0 +1,9 @@
+import type { Promisable } from '@ariestools/sdk';
+import type { HydratedBlockStateValidationFunction, HydratedBlockValidationFunction } from '@xyo-network/xl1-protocol/protocol-lib';
+import type { BaseConfigContext, ProviderFactoryLocatorInstance } from '../../protocol-sdk/index.js';
+export interface BlockValidators {
+    validateHydratedBlock?: HydratedBlockValidationFunction;
+    validateHydratedBlockState?: HydratedBlockStateValidationFunction;
+}
+export declare function remoteLocatorFromConfig(context: BaseConfigContext, validateDepsOnRegister?: boolean, validators?: BlockValidators): Promisable<ProviderFactoryLocatorInstance>;
+//# sourceMappingURL=remoteLocatorFromConfig.d.ts.map

package/dist/neutral/modules/providers/locators/remoteLocatorFromConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteLocatorFromConfig.d.ts","sourceRoot":"","sources":["../../../../../src/modules/providers/locators/remoteLocatorFromConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EACV,oCAAoC,EACpC,+BAA+B,EAChC,MAAM,wCAAwC,CAAA;AAE/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAA;AAYtF,MAAM,WAAW,eAAe;IAC9B,qBAAqB,CAAC,EAAE,+BAA+B,CAAA;IACvD,0BAA0B,CAAC,EAAE,oCAAoC,CAAA;CAClE;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,iBAAiB,EAC1B,sBAAsB,UAAQ,EAC9B,UAAU,CAAC,EAAE,eAAe,GAC3B,UAAU,CAAC,8BAA8B,CAAC,CA8C5C"}

package/dist/neutral/modules/providers/locators/rootLocatorFromConfig.d.ts

@@ -0,0 +1,4 @@
+import type { ActorConfigContext, ProviderFactoryLocatorInstance } from '../../protocol-sdk/index.js';
+import type { BlockValidators } from './remoteLocatorFromConfig.js';
+export declare function rootLocatorFromConfig(context: ActorConfigContext, validateDepsOnRegister?: boolean, validators?: BlockValidators): Promise<ProviderFactoryLocatorInstance>;
+//# sourceMappingURL=rootLocatorFromConfig.d.ts.map

package/dist/neutral/modules/providers/locators/rootLocatorFromConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rootLocatorFromConfig.d.ts","sourceRoot":"","sources":["../../../../../src/modules/providers/locators/rootLocatorFromConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAA;AAEvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAGnE,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,EAC3B,sBAAsB,UAAQ,EAC9B,UAAU,CAAC,EAAE,eAAe,GAC3B,OAAO,CAAC,8BAA8B,CAAC,CAUzC"}

package/dist/neutral/modules/providers/registerHelpers.d.ts

@@ -0,0 +1,18 @@
+import type { AccountInstance } from '@xyo-network/sdk';
+import type { Position } from '@xyo-network/xl1-protocol/protocol-lib';
+import type { ProviderFactoryLocator } from '../protocol-sdk/index.js';
+/**
+ * Registers a SimpleXyoGateway and SimpleXyoConnection with the locator
+ * @param locator The ProviderFactoryLocator to register the signer with
+ * @param account Optional AccountInstance to register a SimpleXyoSigner and SimpleXyoGatewayRunner with the locator
+ * @returns The updated ProviderFactoryLocator
+ */
+export declare const registerGatewayWithLocator: (locator: ProviderFactoryLocator, account?: AccountInstance) => ProviderFactoryLocator<import('../protocol-sdk/index.js').CreatableProviderContextType, string[]>;
+/**
+ * Registers a SimpleStakeViewer with the locator
+ * @param locator The ProviderFactoryLocator to register the signer with
+ * @param positions The positions to be used by the SimpleStakeViewer and SimpleStakeEventsViewer instances
+ * @returns The updated ProviderFactoryLocator
+ */
+export declare const registerSimpleStakeViewerWithLocator: (locator: ProviderFactoryLocator, positions: Position[]) => ProviderFactoryLocator<import('../protocol-sdk/index.js').CreatableProviderContextType, string[]>;
+//# sourceMappingURL=registerHelpers.d.ts.map

package/dist/neutral/modules/providers/registerHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerHelpers.d.ts","sourceRoot":"","sources":["../../../../src/modules/providers/registerHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAA;AAEtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAU3D;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GACrC,SAAS,sBAAsB,EAC/B,UAAU,eAAe,2FAa1B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,GAC/C,SAAS,sBAAsB,EAC/B,WAAW,QAAQ,EAAE,2FAOtB,CAAA"}

package/dist/neutral/modules/rest-block-viewer/RestBlockViewer.d.ts

@@ -0,0 +1,288 @@
+import type { Hash } from '@ariestools/sdk';
+import type { Payload, WithHashMeta } from '@xyo-network/sdk';
+import type { BlockRate, BlockViewer, ChainId, SignedHydratedBlockWithHashMeta, SingleTimeConfig, TimeDurations, XL1BlockNumber, XL1BlockRange } from '@xyo-network/xl1-protocol/protocol-lib';
+import { LruCacheMap } from '../driver-memory/index.js';
+import type { CreatableProviderParams } from '../protocol-sdk/index.js';
+import { AbstractCreatableProvider } from '../protocol-sdk/index.js';
+/** Parameters for RestBlockViewer. */
+export interface RestBlockViewerParams extends CreatableProviderParams {
+    /**
+     * Base URL serving the mutable chain state (the head pointer, `chain/head.json`) when it
+     * lives in a separate bucket/domain from the finalized files. Defaults to `finalizedBaseUrl`.
+     */
+    chainStateBaseUrl?: string;
+    /** Optional fetch override (custom agents, auth headers, tests). Defaults to the global fetch. */
+    fetchFn?: typeof globalThis.fetch;
+    /** Base URL of the finalized (immutable) static chain files (e.g. a public R2 bucket or CDN domain). */
+    finalizedBaseUrl: string;
+    headPollIntervalMs?: number;
+    /**
+     * Base URL serving the chain index files (the step-summary families) when the index lives in
+     * its own bucket/domain. Defaults to `finalizedBaseUrl`.
+     */
+    indexBaseUrl?: string;
+}
+/**
+ * A BlockViewer over a statically generated REST file layout (see `@xyo-network/xl1-network-model`).
+ *
+ * Reads are anonymous HTTP GETs against immutable files, so everything except the head
+ * pointer is cached aggressively. The head pointer is read from `chainStateBaseUrl` when
+ * the chain state and finalized files live in separate buckets/domains, and reused for
+ * `CURRENT_BLOCK_CACHE_TTL_MS` so a burst of concurrent `currentBlock()` callers share one
+ * fetch instead of each issuing their own. `blocksByStep` serves only completed steps — the
+ * in-flight tail step has no static file and returns [].
+ */
+export declare class RestBlockViewer extends AbstractCreatableProvider<RestBlockViewerParams, BlockViewer['eventData']> implements BlockViewer {
+    static readonly connectionTypes: readonly ["rest"];
+    static readonly defaultMoniker: "BlockViewer";
+    static readonly dependencies: never[];
+    static readonly monikers: "BlockViewer"[];
+    static readonly surface: "node";
+    moniker: "BlockViewer";
+    protected blockByHashCache: LruCacheMap<import("@ariestools/sdk").BrandedHash, [{
+        schema: "network.xyo.boundwitness" & {
+            readonly __schema: true;
+        };
+        addresses: (import("@xyo-network/sdk").XyoQuantAddress | (Lowercase<string> & {
+            readonly __hex: true;
+        } & {
+            readonly __address: true;
+        }))[];
+        payload_hashes: import("@ariestools/sdk").BrandedHash[];
+        payload_schemas: import("@xyo-network/sdk").BrandedSchema<string>[];
+        previous_hashes: (import("@ariestools/sdk").BrandedHash | null)[];
+        $signatures: import("@ariestools/sdk").BrandedHex[];
+        block: XL1BlockNumber;
+        chain: import("@ariestools/sdk").BrandedHex;
+        previous: import("@ariestools/sdk").BrandedHash | null;
+        $epoch: number;
+        _hash: import("@ariestools/sdk").BrandedHash;
+        _dataHash: import("@ariestools/sdk").BrandedHash;
+        $destination?: import("@xyo-network/sdk").XyoQuantAddress | (Lowercase<string> & {
+            readonly __hex: true;
+        } & {
+            readonly __address: true;
+        }) | undefined;
+        $sourceQuery?: import("@ariestools/sdk").BrandedHash | undefined;
+        protocol?: number | undefined;
+        step_hashes?: import("@ariestools/sdk").BrandedHash[] | undefined;
+    }, {
+        [x: string]: unknown;
+        schema: import("@xyo-network/sdk").BrandedSchema<string>;
+        _hash: import("@ariestools/sdk").BrandedHash;
+        _dataHash: import("@ariestools/sdk").BrandedHash;
+    }[]], () => void>;
+    protected blockByHashInFlight: Map<import("@ariestools/sdk").BrandedHash, Promise<[{
+        schema: "network.xyo.boundwitness" & {
+            readonly __schema: true;
+        };
+        addresses: (import("@xyo-network/sdk").XyoQuantAddress | (Lowercase<string> & {
+            readonly __hex: true;
+        } & {
+            readonly __address: true;
+        }))[];
+        payload_hashes: import("@ariestools/sdk").BrandedHash[];
+        payload_schemas: import("@xyo-network/sdk").BrandedSchema<string>[];
+        previous_hashes: (import("@ariestools/sdk").BrandedHash | null)[];
+        $signatures: import("@ariestools/sdk").BrandedHex[];
+        block: XL1BlockNumber;
+        chain: import("@ariestools/sdk").BrandedHex;
+        previous: import("@ariestools/sdk").BrandedHash | null;
+        $epoch: number;
+        _hash: import("@ariestools/sdk").BrandedHash;
+        _dataHash: import("@ariestools/sdk").BrandedHash;
+        $destination?: import("@xyo-network/sdk").XyoQuantAddress | (Lowercase<string> & {
+            readonly __hex: true;
+        } & {
+            readonly __address: true;
+        }) | undefined;
+        $sourceQuery?: import("@ariestools/sdk").BrandedHash | undefined;
+        protocol?: number | undefined;
+        step_hashes?: import("@ariestools/sdk").BrandedHash[] | undefined;
+    }, {
+        [x: string]: unknown;
+        schema: import("@xyo-network/sdk").BrandedSchema<string>;
+        _hash: import("@ariestools/sdk").BrandedHash;
+        _dataHash: import("@ariestools/sdk").BrandedHash;
+    }[]] | null>>;
+    protected blockByNumberCache: LruCacheMap<XL1BlockNumber, [{
+        schema: "network.xyo.boundwitness" & {
+            readonly __schema: true;
+        };
+        addresses: (import("@xyo-network/sdk").XyoQuantAddress | (Lowercase<string> & {
+            readonly __hex: true;
+        } & {
+            readonly __address: true;
+        }))[];
+        payload_hashes: import("@ariestools/sdk").BrandedHash[];
+        payload_schemas: import("@xyo-network/sdk").BrandedSchema<string>[];
+        previous_hashes: (import("@ariestools/sdk").BrandedHash | null)[];
+        $signatures: import("@ariestools/sdk").BrandedHex[];
+        block: XL1BlockNumber;
+        chain: import("@ariestools/sdk").BrandedHex;
+        previous: import("@ariestools/sdk").BrandedHash | null;
+        $epoch: number;
+        _hash: import("@ariestools/sdk").BrandedHash;
+        _dataHash: import("@ariestools/sdk").BrandedHash;
+        $destination?: import("@xyo-network/sdk").XyoQuantAddress | (Lowercase<string> & {
+            readonly __hex: true;
+        } & {
+            readonly __address: true;
+        }) | undefined;
+        $sourceQuery?: import("@ariestools/sdk").BrandedHash | undefined;
+        protocol?: number | undefined;
+        step_hashes?: import("@ariestools/sdk").BrandedHash[] | undefined;
+    }, {
+        [x: string]: unknown;
+        schema: import("@xyo-network/sdk").BrandedSchema<string>;
+        _hash: import("@ariestools/sdk").BrandedHash;
+        _dataHash: import("@ariestools/sdk").BrandedHash;
+    }[]], () => void>;
+    protected blockByNumberInFlight: Map<XL1BlockNumber, Promise<[{
+        schema: "network.xyo.boundwitness" & {
+            readonly __schema: true;
+        };
+        addresses: (import("@xyo-network/sdk").XyoQuantAddress | (Lowercase<string> & {
+            readonly __hex: true;
+        } & {
+            readonly __address: true;
+        }))[];
+        payload_hashes: import("@ariestools/sdk").BrandedHash[];
+        payload_schemas: import("@xyo-network/sdk").BrandedSchema<string>[];
+        previous_hashes: (import("@ariestools/sdk").BrandedHash | null)[];
+        $signatures: import("@ariestools/sdk").BrandedHex[];
+        block: XL1BlockNumber;
+        chain: import("@ariestools/sdk").BrandedHex;
+        previous: import("@ariestools/sdk").BrandedHash | null;
+        $epoch: number;
+        _hash: import("@ariestools/sdk").BrandedHash;
+        _dataHash: import("@ariestools/sdk").BrandedHash;
+        $destination?: import("@xyo-network/sdk").XyoQuantAddress | (Lowercase<string> & {
+            readonly __hex: true;
+        } & {
+            readonly __address: true;
+        }) | undefined;
+        $sourceQuery?: import("@ariestools/sdk").BrandedHash | undefined;
+        protocol?: number | undefined;
+        step_hashes?: import("@ariestools/sdk").BrandedHash[] | undefined;
+    }, {
+        [x: string]: unknown;
+        schema: import("@xyo-network/sdk").BrandedSchema<string>;
+        _hash: import("@ariestools/sdk").BrandedHash;
+        _dataHash: import("@ariestools/sdk").BrandedHash;
+    }[]] | null>>;
+    protected currentBlockCache: LruCacheMap<string, Promise<[{
+        schema: "network.xyo.boundwitness" & {
+            readonly __schema: true;
+        };
+        addresses: (import("@xyo-network/sdk").XyoQuantAddress | (Lowercase<string> & {
+            readonly __hex: true;
+        } & {
+            readonly __address: true;
+        }))[];
+        payload_hashes: import("@ariestools/sdk").BrandedHash[];
+        payload_schemas: import("@xyo-network/sdk").BrandedSchema<string>[];
+        previous_hashes: (import("@ariestools/sdk").BrandedHash | null)[];
+        $signatures: import("@ariestools/sdk").BrandedHex[];
+        block: XL1BlockNumber;
+        chain: import("@ariestools/sdk").BrandedHex;
+        previous: import("@ariestools/sdk").BrandedHash | null;
+        $epoch: number;
+        _hash: import("@ariestools/sdk").BrandedHash;
+        _dataHash: import("@ariestools/sdk").BrandedHash;
+        $destination?: import("@xyo-network/sdk").XyoQuantAddress | (Lowercase<string> & {
+            readonly __hex: true;
+        } & {
+            readonly __address: true;
+        }) | undefined;
+        $sourceQuery?: import("@ariestools/sdk").BrandedHash | undefined;
+        protocol?: number | undefined;
+        step_hashes?: import("@ariestools/sdk").BrandedHash[] | undefined;
+    }, {
+        [x: string]: unknown;
+        schema: import("@xyo-network/sdk").BrandedSchema<string>;
+        _hash: import("@ariestools/sdk").BrandedHash;
+        _dataHash: import("@ariestools/sdk").BrandedHash;
+    }[]]>, () => void>;
+    protected payloadCache: LruCacheMap<import("@ariestools/sdk").BrandedHash, WithHashMeta<Payload>, () => void>;
+    protected stepCache: LruCacheMap<string, [{
+        schema: "network.xyo.boundwitness" & {
+            readonly __schema: true;
+        };
+        addresses: (import("@xyo-network/sdk").XyoQuantAddress | (Lowercase<string> & {
+            readonly __hex: true;
+        } & {
+            readonly __address: true;
+        }))[];
+        payload_hashes: import("@ariestools/sdk").BrandedHash[];
+        payload_schemas: import("@xyo-network/sdk").BrandedSchema<string>[];
+        previous_hashes: (import("@ariestools/sdk").BrandedHash | null)[];
+        $signatures: import("@ariestools/sdk").BrandedHex[];
+        block: XL1BlockNumber;
+        chain: import("@ariestools/sdk").BrandedHex;
+        previous: import("@ariestools/sdk").BrandedHash | null;
+        $epoch: number;
+        _hash: import("@ariestools/sdk").BrandedHash;
+        _dataHash: import("@ariestools/sdk").BrandedHash;
+        $destination?: import("@xyo-network/sdk").XyoQuantAddress | (Lowercase<string> & {
+            readonly __hex: true;
+        } & {
+            readonly __address: true;
+        }) | undefined;
+        $sourceQuery?: import("@ariestools/sdk").BrandedHash | undefined;
+        protocol?: number | undefined;
+        step_hashes?: import("@ariestools/sdk").BrandedHash[] | undefined;
+    }, {
+        [x: string]: unknown;
+        schema: import("@xyo-network/sdk").BrandedSchema<string>;
+        _hash: import("@ariestools/sdk").BrandedHash;
+        _dataHash: import("@ariestools/sdk").BrandedHash;
+    }[]][], () => void>;
+    private _headPollHash?;
+    private _headPollInProgress;
+    private _headPollTimer;
+    get chainStateBaseUrl(): string;
+    get finalizedBaseUrl(): string;
+    get indexBaseUrl(): string;
+    protected get fetchFn(): typeof globalThis.fetch;
+    protected get headPollIntervalMs(): number | undefined;
+    static paramsHandler(params: Partial<RestBlockViewerParams>): Promise<{
+        chainStateBaseUrl: string | undefined;
+        fetchFn: typeof fetch | undefined;
+        finalizedBaseUrl: string;
+        headPollIntervalMs: number | undefined;
+        indexBaseUrl: string | undefined;
+        context: import('../protocol-sdk/index.js').CreatableProviderContextType;
+        name?: import("@ariestools/sdk").CreatableName;
+        statusReporter?: import("@ariestools/sdk").CreatableStatusReporter<void> | undefined;
+        logger?: import("@ariestools/sdk").Logger;
+        meterProvider?: import("@opentelemetry/api").MeterProvider;
+        traceProvider?: import("@opentelemetry/api").TracerProvider;
+    }>;
+    blockByHash(hash: Hash): Promise<SignedHydratedBlockWithHashMeta | null>;
+    blockByNumber(blockNumber: XL1BlockNumber): Promise<SignedHydratedBlockWithHashMeta | null>;
+    blocksByHash(hash: Hash, limit?: number): Promise<SignedHydratedBlockWithHashMeta[]>;
+    blocksByNumber(blockNumber: XL1BlockNumber, limit?: number): Promise<SignedHydratedBlockWithHashMeta[]>;
+    blocksByStep(stepLevel: number, stepIndex: number): Promise<SignedHydratedBlockWithHashMeta[]>;
+    chainId(): Promise<ChainId>;
+    chainId(blockNumber: XL1BlockNumber): Promise<ChainId>;
+    chainId(blockNumber: 'latest'): Promise<ChainId>;
+    currentBlock(): Promise<SignedHydratedBlockWithHashMeta>;
+    currentBlockHash(): Promise<Hash>;
+    currentBlockNumber(): Promise<XL1BlockNumber>;
+    payloadByHash(hash: Hash): Promise<WithHashMeta<Payload> | null>;
+    payloadsByHash(hashes: Hash[]): Promise<WithHashMeta<Payload>[]>;
+    rate(range: XL1BlockRange, timeUnit?: keyof TimeDurations): Promise<BlockRate>;
+    stepSizeRate(start: XL1BlockNumber, stepIndex: number, count?: number, timeUnit?: keyof TimeDurations): Promise<BlockRate>;
+    timeDurationRate(timeConfig: SingleTimeConfig, startBlockNumber?: XL1BlockNumber, timeUnit?: keyof TimeDurations, toleranceMs?: number, maxAttempts?: number): Promise<BlockRate>;
+    protected startHandler(): Promise<void>;
+    protected stopHandler(): Promise<void>;
+    /** Validates a parsed block file and populates both block caches. */
+    private cacheBlock;
+    private fetchCurrentBlock;
+    private fetchJson;
+    private pollHead;
+    private startHeadPolling;
+    private stopHeadPolling;
+}
+//# sourceMappingURL=RestBlockViewer.d.ts.map

package/dist/neutral/modules/rest-block-viewer/RestBlockViewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestBlockViewer.d.ts","sourceRoot":"","sources":["../../../../src/modules/rest-block-viewer/RestBlockViewer.ts"],"names":[],"mappings":"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"}

package/dist/neutral/modules/rest-block-viewer/RestChainContractViewer.d.ts

@@ -0,0 +1,57 @@
+import { type Hash } from '@ariestools/sdk';
+import type { XyoAddress } from '@xyo-network/sdk';
+import type { ChainContractViewer, ChainId, XL1BlockNumber } from '@xyo-network/xl1-protocol/protocol-lib';
+import type { CreatableProviderParams } from '../protocol-sdk/index.js';
+import { AbstractCreatableProvider } from '../protocol-sdk/index.js';
+/** Parameters for RestChainContractViewer. */
+export interface RestChainContractViewerParams extends CreatableProviderParams {
+    /** Base URL serving the chain-contract manifest (`chain/contract.json`). Falls back to config resolution when omitted. */
+    contractBaseUrl: string;
+    /** Optional fetch override (custom agents, auth headers, tests). Defaults to the global fetch. */
+    fetchFn?: typeof globalThis.fetch;
+}
+/**
+ * A ChainContractViewer that sources `rewardsContract`/`stakingTokenAddress`/`minWithdrawalBlocks`/fork
+ * fields from the published chain-contract manifest (see `@xyo-network/xl1-network-model`) instead of
+ * requiring them as constructor params — unlike `SimpleChainContractViewer`, whose params are the only
+ * source of that data today. `chainId()` still delegates to the injected `FinalizationViewer`, avoiding
+ * `SimpleFinalizationViewer`'s mutual dependency on `ChainContractViewer`.
+ *
+ * The manifest is static (published once), so it's fetched at most once per instance and cached.
+ */
+export declare class RestChainContractViewer extends AbstractCreatableProvider<RestChainContractViewerParams> implements ChainContractViewer {
+    static readonly connectionTypes: readonly ["rest"];
+    static readonly defaultMoniker: "ChainContractViewer";
+    static readonly dependencies: "FinalizationViewer"[];
+    static readonly monikers: "ChainContractViewer"[];
+    static readonly surface: "node";
+    moniker: "ChainContractViewer";
+    private _finalizationViewer;
+    private _manifestPromise?;
+    get contractBaseUrl(): string;
+    protected get fetchFn(): typeof globalThis.fetch;
+    static paramsHandler(params: Partial<RestChainContractViewerParams>): Promise<{
+        contractBaseUrl: string;
+        fetchFn: typeof fetch | undefined;
+        context: import('../protocol-sdk/index.js').CreatableProviderContextType;
+        name?: import("@ariestools/sdk").CreatableName;
+        statusReporter?: import("@ariestools/sdk").CreatableStatusReporter<void> | undefined;
+        logger?: import("@ariestools/sdk").Logger;
+        meterProvider?: import("@opentelemetry/api").MeterProvider;
+        traceProvider?: import("@opentelemetry/api").TracerProvider;
+    }>;
+    chainId(): Promise<ChainId>;
+    chainIdAtBlockNumber(blockNumber: XL1BlockNumber | 'latest'): Promise<ChainId>;
+    createHandler(): Promise<void>;
+    forkedAtBlockNumber(): Promise<XL1BlockNumber | null>;
+    forkedAtHash(): Promise<Hash | null>;
+    /** Fork-chain traversal isn't supported over REST yet — the ancestor chain's own bucket isn't known here. */
+    forkedChainContractViewer(): Promise<ChainContractViewer | null>;
+    forkedChainId(): Promise<ChainId | null>;
+    minWithdrawalBlocks(): Promise<number>;
+    rewardsContract(): Promise<XyoAddress>;
+    stakingTokenAddress(): Promise<XyoAddress>;
+    private fetchManifest;
+    private manifest;
+}
+//# sourceMappingURL=RestChainContractViewer.d.ts.map

package/dist/neutral/modules/rest-block-viewer/RestChainContractViewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestChainContractViewer.d.ts","sourceRoot":"","sources":["../../../../src/modules/rest-block-viewer/RestChainContractViewer.ts"],"names":[],"mappings":"AAAA,OAAO,EACK,KAAK,IAAI,EACpB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAGlD,OAAO,KAAK,EACV,mBAAmB,EAAE,OAAO,EAAuC,cAAc,EAClF,MAAM,wCAAwC,CAAA;AAG/C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EACL,yBAAyB,EAC1B,MAAM,eAAe,CAAA;AAEtB,8CAA8C;AAC9C,MAAM,WAAW,6BAA8B,SAAQ,uBAAuB;IAC5E,0HAA0H;IAC1H,eAAe,EAAE,MAAM,CAAA;IACvB,kGAAkG;IAClG,OAAO,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAClC;AAED;;;;;;;;GAQG;AACH,qBACa,uBAAwB,SAAQ,yBAAyB,CAAC,6BAA6B,CAAE,YAAW,mBAAmB;IAClI,MAAM,CAAC,QAAQ,CAAC,eAAe,oBAAoB;IACnD,MAAM,CAAC,QAAQ,CAAC,cAAc,wBAA6B;IAC3D,MAAM,CAAC,QAAQ,CAAC,YAAY,yBAA8B;IAC1D,MAAM,CAAC,QAAQ,CAAC,QAAQ,0BAA+B;IACvD,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAG,MAAM,CAAS;IACzC,OAAO,wBAAyC;IAEhD,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,gBAAgB,CAAC,CAAgC;IAEzD,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,SAAS,KAAK,OAAO,IAAI,OAAO,UAAU,CAAC,KAAK,CAE/C;WAEqB,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,6BAA6B,CAAC;;;;;;;;;;IAe5E,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAI3B,oBAAoB,CAAC,WAAW,EAAE,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBrE,aAAa;IAKtB,mBAAmB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAIrD,YAAY,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAI1C,6GAA6G;IAC7G,yBAAyB,IAAI,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAI1D,aAAa,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAIxC,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAItC,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC;IAItC,mBAAmB,IAAI,OAAO,CAAC,UAAU,CAAC;YAIlC,aAAa;YAOb,QAAQ;CAIvB"}