@xyo-network/xl1-sdk 4.0.10 → 4.0.12

package/dist/browser/browser/gateway.d.ts

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

package/dist/browser/browser/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../../src/browser/gateway.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAA"}

package/dist/browser/browser/providers.d.ts

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

package/dist/browser/browser/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../../src/browser/providers.ts"],"names":[],"mappings":"AACA,cAAc,+BAA+B,CAAA"}

package/dist/browser/driver-memory.d.ts

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

package/dist/browser/driver-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-memory.d.ts","sourceRoot":"","sources":["../../src/driver-memory.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAA"}

package/dist/browser/gateway.d.ts

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

package/dist/browser/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/gateway.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAA"}

package/dist/browser/gateway.mjs

@@ -0,0 +1,186 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/modules/gateway/dataLakes/PageProvider.ts
+import {
+  DataLakeRunnerMoniker,
+  DataLakeViewerMoniker
+} from "@xyo-network/xl1-protocol/protocol-lib";
+import { DataLakesGetMethod, DataLakesInsertMethod } from "#rpc";
+var AbstractDataLakePageProvider = class {
+  id;
+  transport;
+  constructor(transport, id) {
+    this.transport = transport;
+    this.id = id;
+  }
+  async get(hashes) {
+    return await this.transport.sendRequest(DataLakesGetMethod, [{ id: this.id, hashes }]);
+  }
+  next(_options) {
+    throw new Error("Method [next] not implemented.");
+  }
+};
+var DataLakePageViewer = class extends AbstractDataLakePageProvider {
+  moniker = DataLakeViewerMoniker;
+};
+var DataLakePageRunner = class extends AbstractDataLakePageProvider {
+  moniker = DataLakeRunnerMoniker;
+  clear() {
+    throw new Error("Method [clear] not implemented.");
+  }
+  delete(_hashes) {
+    throw new Error("Method [delete] not implemented.");
+  }
+  async insert(items) {
+    return await this.transport.sendRequest(DataLakesInsertMethod, [{ id: this.id, payloads: items }]);
+  }
+};
+
+// src/modules/gateway/GatewayBuilder.ts
+import { isDefined } from "@ariestools/sdk";
+import { XyoGatewayMoniker, XyoGatewayRunnerMoniker } from "@xyo-network/xl1-protocol/protocol-lib";
+import { basicRemoteRunnerLocator, basicRemoteViewerLocator } from "#providers";
+
+// src/modules/gateway/XyoSignerWrapper.ts
+import { XyoSignerMoniker } from "@xyo-network/xl1-protocol/protocol-lib";
+import {
+  AbstractCreatableProvider,
+  creatableProvider
+} from "#protocol-sdk";
+var XyoSignerWrapper = class extends AbstractCreatableProvider {
+  moniker = XyoSignerWrapper.defaultMoniker;
+  address() {
+    return this.params.signer.address();
+  }
+  sign(bw) {
+    return this.params.signer.sign(bw);
+  }
+  signTransaction(tx) {
+    return this.params.signer.signTransaction(tx);
+  }
+};
+__publicField(XyoSignerWrapper, "defaultMoniker", XyoSignerMoniker);
+__publicField(XyoSignerWrapper, "dependencies", []);
+__publicField(XyoSignerWrapper, "monikers", [XyoSignerMoniker]);
+XyoSignerWrapper = __decorateClass([
+  creatableProvider()
+], XyoSignerWrapper);
+
+// src/modules/gateway/GatewayBuilder.ts
+var GatewayBuilder = class {
+  _additionalProviders = [];
+  _additionalRunnerProviders = [];
+  _dataLakeEndpoint;
+  _name = "gateway-client";
+  _rpc;
+  _validators;
+  additionalProviders(factories) {
+    this._additionalProviders = factories;
+    return this;
+  }
+  additionalRunnerProviders(factories) {
+    this._additionalRunnerProviders = factories;
+    return this;
+  }
+  async build(signer) {
+    if (!isDefined(this._rpc)) {
+      throw new Error("GatewayBuilder: rpcUrl() or postMessage() must be set before build()");
+    }
+    const rpcConnection = this._rpc;
+    if (signer === void 0) {
+      const locator2 = await basicRemoteViewerLocator(this._name, rpcConnection, this._dataLakeEndpoint, {
+        validators: this._validators,
+        additionalProviders: this._additionalProviders
+      });
+      return await locator2.getInstance(XyoGatewayMoniker);
+    }
+    const signerFactory = XyoSignerWrapper.factory(XyoSignerWrapper.dependencies, { signer });
+    const locator = await basicRemoteRunnerLocator(this._name, rpcConnection, void 0, this._dataLakeEndpoint, {
+      validators: this._validators,
+      additionalProviders: this._additionalProviders,
+      additionalRunnerProviders: this._additionalRunnerProviders,
+      signerFactory
+    });
+    return await locator.getInstance(XyoGatewayRunnerMoniker);
+  }
+  dataLakeEndpoint(endpoint) {
+    this._dataLakeEndpoint = endpoint;
+    return this;
+  }
+  name(name) {
+    this._name = name;
+    return this;
+  }
+  postMessage(networkId, sessionId) {
+    this._rpc = {
+      protocol: "postMessage",
+      networkId,
+      sessionId
+    };
+    return this;
+  }
+  rpcUrl(url) {
+    this._rpc = { protocol: "http", url };
+    return this;
+  }
+  validators(validators) {
+    this._validators = validators;
+    return this;
+  }
+};
+
+// src/modules/gateway/getRestGateway.ts
+import { XyoGatewayMoniker as XyoGatewayMoniker2 } from "@xyo-network/xl1-protocol/protocol-lib";
+import { restConnectionFromS3Bucket } from "#protocol-sdk";
+import { basicRestViewerLocator } from "#providers";
+var STANDARD_ENDPOINT_SUBDOMAINS = {
+  blocks: "blocks",
+  chainState: "state",
+  index: "indexes"
+};
+function restGatewayConfigFromEndpoint(endpoint) {
+  const url = new URL(endpoint);
+  const bucketOrigin = (subdomain) => `${url.protocol}//${subdomain}.${url.host}`;
+  return {
+    blocks: { readUrl: bucketOrigin(STANDARD_ENDPOINT_SUBDOMAINS.blocks) },
+    chainState: { readUrl: bucketOrigin(STANDARD_ENDPOINT_SUBDOMAINS.chainState) },
+    index: { readUrl: bucketOrigin(STANDARD_ENDPOINT_SUBDOMAINS.index) }
+  };
+}
+async function getRestGateway(config) {
+  const resolved = typeof config === "string" ? restGatewayConfigFromEndpoint(config) : config;
+  const restConfig = {
+    blocks: restConnectionFromS3Bucket(resolved.blocks),
+    chainState: resolved.chainState ? restConnectionFromS3Bucket(resolved.chainState) : void 0,
+    index: resolved.index ? restConnectionFromS3Bucket(resolved.index) : void 0
+  };
+  const {
+    dataLakeEndpoint,
+    fetchFn,
+    initRewardsCache,
+    name
+  } = typeof config === "string" ? {} : config;
+  const locator = await basicRestViewerLocator(name ?? "rest-gateway-client", restConfig, dataLakeEndpoint, { fetchFn, initRewardsCache });
+  return await locator.getInstance(XyoGatewayMoniker2);
+}
+export {
+  AbstractDataLakePageProvider,
+  DataLakePageRunner,
+  DataLakePageViewer,
+  GatewayBuilder,
+  XyoSignerWrapper,
+  getRestGateway,
+  restGatewayConfigFromEndpoint
+};
+//# sourceMappingURL=gateway.mjs.map

package/dist/browser/gateway.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/modules/gateway/dataLakes/PageProvider.ts", "../../src/modules/gateway/GatewayBuilder.ts", "../../src/modules/gateway/XyoSignerWrapper.ts", "../../src/modules/gateway/getRestGateway.ts"],
+  "sourcesContent": ["import type {\n  Hash, Promisable, PromisableArray,\n} from '@ariestools/sdk'\nimport type { NextOptions, Sequence } from '@xyo-network/sdk'\nimport {\n  type DataLakeData, type DataLakeRunnerMethods, DataLakeRunnerMoniker, type DataLakeViewerMethods,\n  DataLakeViewerMoniker,\n} from '@xyo-network/xl1-protocol/protocol-lib'\n\nimport type { DataLakePageRpcSchemas, RpcTransport } from '#rpc'\nimport { DataLakesGetMethod, DataLakesInsertMethod } from '#rpc'\n\n/**\n * Shared base for page-side data lake providers. Holds the wallet-mediated\n * JSON-RPC transport and the opaque per-origin lake `id`, and provides the\n * read-side implementations (`get`, `next`) common to viewers and runners.\n * Not constructable on its own \u2014 instantiate {@link DataLakePageViewer} or\n * {@link DataLakePageRunner} depending on the granted capability.\n */\nexport abstract class AbstractDataLakePageProvider {\n  protected readonly id: string\n  protected readonly transport: RpcTransport<DataLakePageRpcSchemas>\n\n  constructor(transport: RpcTransport<DataLakePageRpcSchemas>, id: string) {\n    this.transport = transport\n    this.id = id\n  }\n\n  async get(hashes: Hash[]): Promise<DataLakeData[]> {\n    return await this.transport.sendRequest(DataLakesGetMethod, [{ id: this.id, hashes }])\n  }\n\n  next(_options?: NextOptions<Sequence>): PromisableArray<DataLakeData> {\n    throw new Error('Method [next] not implemented.')\n  }\n}\n\n/**\n * Read-only page-side data lake provider \u2014 proxies `get` (and `next` once\n * implemented) through the wallet's JSON-RPC transport. Bound to a single\n * approved lake `id`; construct one instance per `viewer`-capability grant.\n */\nexport class DataLakePageViewer extends AbstractDataLakePageProvider implements DataLakeViewerMethods {\n  readonly moniker = DataLakeViewerMoniker\n}\n\n/**\n * Read/write page-side data lake provider \u2014 adds `insert` (and `clear` /\n * `delete` once implemented) on top of the viewer surface. Requires the\n * wallet grant to include the `runner` capability. Bound to a single\n * approved lake `id`.\n */\nexport class DataLakePageRunner extends AbstractDataLakePageProvider implements DataLakeRunnerMethods {\n  readonly moniker = DataLakeRunnerMoniker\n\n  clear(): Promisable<void> {\n    throw new Error('Method [clear] not implemented.')\n  }\n\n  delete(_hashes: Hash[]): PromisableArray<DataLakeData> {\n    throw new Error('Method [delete] not implemented.')\n  }\n\n  async insert(items: DataLakeData[]): Promise<DataLakeData[]> {\n    return await this.transport.sendRequest(DataLakesInsertMethod, [{ id: this.id, payloads: items }])\n  }\n}\n", "import { isDefined } from '@ariestools/sdk'\nimport type {\n  XyoGateway, XyoGatewayRunner, XyoSigner,\n} from '@xyo-network/xl1-protocol/protocol-lib'\nimport { XyoGatewayMoniker, XyoGatewayRunnerMoniker } from '@xyo-network/xl1-protocol/protocol-lib'\n\nimport type { CreatableProviderFactory, RpcRemoteConfig } from '#protocol-sdk'\nimport type { BlockValidators } from '#providers'\nimport { basicRemoteRunnerLocator, basicRemoteViewerLocator } from '#providers'\n\nimport { XyoSignerWrapper } from './XyoSignerWrapper.ts'\n\n/**\n * Fluent builder for client-side XL1 gateways. Hides the locator system from\n * 3rd parties so they can spin up a XyoGateway (read-only) or XyoGatewayRunner\n * (transacting) without touching ProviderFactoryLocator, connection config, or any\n * JsonRpc transport plumbing.\n *\n * @example\n * const gateway = await new GatewayBuilder()\n *   .rpcUrl('https://rpc.xl1.example')\n *   .build()\n *\n * @example\n * const runner = await new GatewayBuilder()\n *   .rpcUrl('https://rpc.xl1.example')\n *   .build(mySigner)\n */\nexport class GatewayBuilder {\n  private _additionalProviders: CreatableProviderFactory[] = []\n  private _additionalRunnerProviders: CreatableProviderFactory[] = []\n  private _dataLakeEndpoint: string | undefined\n  private _name = 'gateway-client'\n  private _rpc: RpcRemoteConfig | undefined\n  private _validators: BlockValidators | undefined\n\n  additionalProviders(factories: CreatableProviderFactory[]): this {\n    this._additionalProviders = factories\n    return this\n  }\n\n  additionalRunnerProviders(factories: CreatableProviderFactory[]): this {\n    this._additionalRunnerProviders = factories\n    return this\n  }\n\n  build(): Promise<XyoGateway>\n  build(signer: XyoSigner): Promise<XyoGatewayRunner>\n  async build(signer?: XyoSigner): Promise<XyoGateway | XyoGatewayRunner> {\n    if (!isDefined(this._rpc)) {\n      throw new Error('GatewayBuilder: rpcUrl() or postMessage() must be set before build()')\n    }\n    const rpcConnection = this._rpc\n\n    if (signer === undefined) {\n      const locator = await basicRemoteViewerLocator(this._name, rpcConnection, this._dataLakeEndpoint, {\n        validators: this._validators,\n        additionalProviders: this._additionalProviders,\n      })\n      return await locator.getInstance<XyoGateway>(XyoGatewayMoniker)\n    }\n\n    const signerFactory = XyoSignerWrapper.factory<XyoSignerWrapper>(XyoSignerWrapper.dependencies, { signer })\n    const locator = await basicRemoteRunnerLocator(this._name, rpcConnection, undefined, this._dataLakeEndpoint, {\n      validators: this._validators,\n      additionalProviders: this._additionalProviders,\n      additionalRunnerProviders: this._additionalRunnerProviders,\n      signerFactory,\n    })\n    return await locator.getInstance<XyoGatewayRunner>(XyoGatewayRunnerMoniker)\n  }\n\n  dataLakeEndpoint(endpoint: string): this {\n    this._dataLakeEndpoint = endpoint\n    return this\n  }\n\n  name(name: string): this {\n    this._name = name\n    return this\n  }\n\n  postMessage(networkId: string, sessionId: string): this {\n    this._rpc = {\n      protocol: 'postMessage', networkId, sessionId,\n    }\n    return this\n  }\n\n  rpcUrl(url: string): this {\n    this._rpc = { protocol: 'http', url }\n    return this\n  }\n\n  validators(validators: BlockValidators): this {\n    this._validators = validators\n    return this\n  }\n}\n", "import type { Promisable } from '@ariestools/sdk'\nimport type {\n  Payload, Signed, SignedHydratedBoundWitnessWithHashMeta, UnsignedBoundWitness, XyoAddress,\n} from '@xyo-network/sdk'\nimport type {\n  SignedHydratedTransactionWithHashMeta, UnsignedHydratedTransaction, XyoSigner,\n} from '@xyo-network/xl1-protocol/protocol-lib'\nimport { XyoSignerMoniker } from '@xyo-network/xl1-protocol/protocol-lib'\n\nimport type { CreatableProviderParams } from '#protocol-sdk'\nimport {\n  AbstractCreatableProvider,\n  creatableProvider,\n} from '#protocol-sdk'\n\n/** Parameters for XyoSignerWrapper. */\nexport interface XyoSignerWrapperParams extends CreatableProviderParams {\n  signer: XyoSigner\n}\n\n/**\n * Adapts a pre-built XyoSigner instance into a CreatableProvider so it can be\n * registered with a ProviderFactoryLocator. Used by GatewayBuilder.build(signer).\n */\n@creatableProvider()\nexport class XyoSignerWrapper extends AbstractCreatableProvider<XyoSignerWrapperParams> implements XyoSigner {\n  static readonly defaultMoniker = XyoSignerMoniker\n  static readonly dependencies = []\n  static readonly monikers = [XyoSignerMoniker]\n  moniker = XyoSignerWrapper.defaultMoniker\n\n  address(): Promisable<XyoAddress> {\n    return this.params.signer.address()\n  }\n\n  sign<T extends UnsignedBoundWitness>(bw: [T, Payload[]]): Promisable<SignedHydratedBoundWitnessWithHashMeta<Signed<T>>> {\n    return this.params.signer.sign(bw)\n  }\n\n  signTransaction(tx: UnsignedHydratedTransaction): Promisable<SignedHydratedTransactionWithHashMeta> {\n    return this.params.signer.signTransaction(tx)\n  }\n}\n", "import type { XyoGateway } from '@xyo-network/xl1-protocol/protocol-lib'\nimport { XyoGatewayMoniker } from '@xyo-network/xl1-protocol/protocol-lib'\n\nimport type { S3BucketConfig } from '#protocol-sdk'\nimport { restConnectionFromS3Bucket } from '#protocol-sdk'\nimport { basicRestViewerLocator } from '#providers'\n\n/** Config for a REST/S3-backed client gateway. */\nexport interface RestGatewayConfig {\n  /** The finalized blocks bucket \u2014 required. `readUrl` becomes the base for BlockViewer. */\n  blocks: S3BucketConfig\n  /** A separate chain-state bucket, when the head pointer (and chain-contract manifest) live apart from finalized blocks. Defaults to `blocks`. */\n  chainState?: S3BucketConfig\n  dataLakeEndpoint?: string\n  /** Custom fetch override for every REST viewer (custom agents, auth headers, tests). Defaults to the global fetch. */\n  fetchFn?: typeof globalThis.fetch\n  /** A separate index bucket, when step summaries live apart from finalized blocks. Defaults to `blocks`. */\n  index?: S3BucketConfig\n  /**\n   * Whether `XyoViewer` precomputes network-stake-reward positions across the whole chain at\n   * startup. Defaults to `true`, but that precompute issues one REST round trip per\n   * position/step, which can be slow or fragile against a large, live chain \u2014 set `false` for a\n   * lighter-weight client that doesn't need reward data.\n   */\n  initRewardsCache?: boolean\n  name?: string\n}\n\n/** Standard subdomain prefix for each S3 bucket under a network's root domain (see `getRestGateway`). */\nconst STANDARD_ENDPOINT_SUBDOMAINS = {\n  blocks: 'blocks',\n  chainState: 'state',\n  index: 'indexes',\n} as const\n\n/**\n * Derives the standard `{ blocks, chainState, index }` bucket config from a network's root\n * domain, e.g. `https://crypto-com.mainnet.xyo.space` becomes `https://blocks.crypto-com...`,\n * `https://state.crypto-com...`, `https://indexes.crypto-com...` \u2014 the subdomain-per-bucket\n * layout live XL1 networks publish under.\n */\nexport function restGatewayConfigFromEndpoint(endpoint: string): Pick<RestGatewayConfig, 'blocks' | 'chainState' | 'index'> {\n  const url = new URL(endpoint)\n  const bucketOrigin = (subdomain: string) => `${url.protocol}//${subdomain}.${url.host}`\n  return {\n    blocks: { readUrl: bucketOrigin(STANDARD_ENDPOINT_SUBDOMAINS.blocks) },\n    chainState: { readUrl: bucketOrigin(STANDARD_ENDPOINT_SUBDOMAINS.chainState) },\n    index: { readUrl: bucketOrigin(STANDARD_ENDPOINT_SUBDOMAINS.index) },\n  }\n}\n\n/**\n * Builds a read-only `XyoGateway` backed by the S3 static REST file layout instead of RPC:\n * `BlockViewer`/`ChainStateViewer`/`FinalizationViewer`/`ChainContractViewer` read directly from\n * the S3 CDN URLs, and every other viewer (account balances, stake, transactions, ...)\n * is computed on top of that data by the `Simple*` providers, caching what they derive in memory.\n * Same consumer-facing shape as `GatewayBuilder.build()` \u2014 `gateway.connection.viewer.currentBlock()`,\n * `gateway.connection.viewer.account.balance.accountBalance(...)`, etc.\n *\n * @example\n * // Network root domain \u2014 blocks/chainState/index subdomains are derived via\n * // `restGatewayConfigFromEndpoint` (blocks.<domain>, state.<domain>, indexes.<domain>).\n * const gateway = await getRestGateway('https://crypto-com.mainnet.xyo.space')\n *\n * @example\n * // Explicit buckets, for networks that don't follow the standard subpath layout.\n * const gateway = await getRestGateway({\n *   blocks: { readUrl: 'https://cdn.xl1.example/blocks' },\n *   chainState: { readUrl: 'https://cdn.xl1.example/chain-state' },\n * })\n */\nexport async function getRestGateway(config: string | RestGatewayConfig): Promise<XyoGateway> {\n  const resolved = typeof config === 'string' ? restGatewayConfigFromEndpoint(config) : config\n  const restConfig = {\n    blocks: restConnectionFromS3Bucket(resolved.blocks),\n    chainState: resolved.chainState ? restConnectionFromS3Bucket(resolved.chainState) : undefined,\n    index: resolved.index ? restConnectionFromS3Bucket(resolved.index) : undefined,\n  }\n  const {\n    dataLakeEndpoint, fetchFn, initRewardsCache, name,\n  } = typeof config === 'string' ? {} : config\n  const locator = await basicRestViewerLocator(name ?? 'rest-gateway-client', restConfig, dataLakeEndpoint, { fetchFn, initRewardsCache })\n  return await locator.getInstance<XyoGateway>(XyoGatewayMoniker)\n}\n"],
+  "mappings": "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",
+  "names": ["locator", "XyoGatewayMoniker"]
+}

package/dist/browser/index.d.ts

@@ -0,0 +1,8 @@
+export * from '@xyo-network/xl1-protocol';
+export * from './modules/driver-memory/index.js';
+export * from './modules/gateway/index.js';
+export * from './modules/protocol-sdk/index.js';
+export * from './modules/providers/index.js';
+export * from './modules/rpc/index.js';
+export * from './modules/wrappers/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,2BAA2B,CAAA;AACzC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,MAAM,CAAA;AACpB,cAAc,WAAW,CAAA"}

package/dist/browser/modules/driver-memory/LruCacheMap.d.ts

@@ -0,0 +1,15 @@
+import type { SyncMap } from '@xyo-network/xl1-protocol/protocol-lib';
+import { LRUCache } from 'lru-cache';
+/** LruCacheMap implementation. */
+export declare class LruCacheMap<K extends {}, V extends string | number | bigint | {}, FC = () => void> implements SyncMap<K, V> {
+    private lruCache;
+    constructor(options?: LRUCache.Options<K, V, FC>);
+    clear(): void;
+    delete(id: K): boolean;
+    get(id: K): V | undefined;
+    getMany(id: K[]): V[];
+    has(id: K): boolean;
+    set(id: K, data: V): void;
+    setMany(entries: [K, V][]): void;
+}
+//# sourceMappingURL=LruCacheMap.d.ts.map

package/dist/browser/modules/driver-memory/LruCacheMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LruCacheMap.d.ts","sourceRoot":"","sources":["../../../../src/modules/driver-memory/LruCacheMap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC,kCAAkC;AAClC,qBAAa,WAAW,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,EAAE,EAAE,EAAE,GAAG,MAAM,IAAI,CAAE,YAAW,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACvH,OAAO,CAAC,QAAQ,CAAoB;gBAExB,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;IAIhD,KAAK,IAAI,IAAI;IAIb,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO;IAItB,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAIzB,OAAO,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAWrB,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO;IAInB,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;IAIlB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI;CAKjC"}

package/dist/browser/modules/driver-memory/MemoryMap.d.ts

@@ -0,0 +1,14 @@
+import type { SyncMap } from '@xyo-network/xl1-protocol/protocol-lib';
+/** MemoryMap implementation. */
+export declare class MemoryMap<K extends {}, V = {}> implements SyncMap<K, V> {
+    private map;
+    constructor();
+    clear(): void;
+    delete(id: K): boolean;
+    get(id: K): V | undefined;
+    getMany(ids: K[]): V[];
+    has(id: K): boolean;
+    set(id: K, data: V): void;
+    setMany(entries: [K, V][]): void;
+}
+//# sourceMappingURL=MemoryMap.d.ts.map

package/dist/browser/modules/driver-memory/MemoryMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryMap.d.ts","sourceRoot":"","sources":["../../../../src/modules/driver-memory/MemoryMap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AAErE,gCAAgC;AAChC,qBAAa,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,EAAE,CAAE,YAAW,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAW;;IAMtB,KAAK,IAAI,IAAI;IAIb,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO;IAItB,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAIzB,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAWtB,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO;IAInB,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;IAIlB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI;CAKjC"}

package/dist/browser/modules/driver-memory/index.d.ts

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

package/dist/browser/modules/driver-memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/driver-memory/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA"}

package/dist/browser/modules/gateway/GatewayBuilder.d.ts

@@ -0,0 +1,37 @@
+import type { XyoGateway, XyoGatewayRunner, XyoSigner } from '@xyo-network/xl1-protocol/protocol-lib';
+import type { CreatableProviderFactory } from '../protocol-sdk/index.js';
+import type { BlockValidators } from '../providers/index.js';
+/**
+ * Fluent builder for client-side XL1 gateways. Hides the locator system from
+ * 3rd parties so they can spin up a XyoGateway (read-only) or XyoGatewayRunner
+ * (transacting) without touching ProviderFactoryLocator, connection config, or any
+ * JsonRpc transport plumbing.
+ *
+ * @example
+ * const gateway = await new GatewayBuilder()
+ *   .rpcUrl('https://rpc.xl1.example')
+ *   .build()
+ *
+ * @example
+ * const runner = await new GatewayBuilder()
+ *   .rpcUrl('https://rpc.xl1.example')
+ *   .build(mySigner)
+ */
+export declare class GatewayBuilder {
+    private _additionalProviders;
+    private _additionalRunnerProviders;
+    private _dataLakeEndpoint;
+    private _name;
+    private _rpc;
+    private _validators;
+    additionalProviders(factories: CreatableProviderFactory[]): this;
+    additionalRunnerProviders(factories: CreatableProviderFactory[]): this;
+    build(): Promise<XyoGateway>;
+    build(signer: XyoSigner): Promise<XyoGatewayRunner>;
+    dataLakeEndpoint(endpoint: string): this;
+    name(name: string): this;
+    postMessage(networkId: string, sessionId: string): this;
+    rpcUrl(url: string): this;
+    validators(validators: BlockValidators): this;
+}
+//# sourceMappingURL=GatewayBuilder.d.ts.map

package/dist/browser/modules/gateway/GatewayBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GatewayBuilder.d.ts","sourceRoot":"","sources":["../../../../src/modules/gateway/GatewayBuilder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAAE,gBAAgB,EAAE,SAAS,EACxC,MAAM,wCAAwC,CAAA;AAG/C,OAAO,KAAK,EAAE,wBAAwB,EAAmB,MAAM,eAAe,CAAA;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAKjD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,oBAAoB,CAAiC;IAC7D,OAAO,CAAC,0BAA0B,CAAiC;IACnE,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,WAAW,CAA6B;IAEhD,mBAAmB,CAAC,SAAS,EAAE,wBAAwB,EAAE,GAAG,IAAI;IAKhE,yBAAyB,CAAC,SAAS,EAAE,wBAAwB,EAAE,GAAG,IAAI;IAKtE,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAC5B,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyBnD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKxC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAOvD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKzB,UAAU,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;CAI9C"}

package/dist/browser/modules/gateway/XyoSignerWrapper.d.ts

@@ -0,0 +1,23 @@
+import type { Promisable } from '@ariestools/sdk';
+import type { Payload, Signed, SignedHydratedBoundWitnessWithHashMeta, UnsignedBoundWitness, XyoAddress } from '@xyo-network/sdk';
+import type { SignedHydratedTransactionWithHashMeta, UnsignedHydratedTransaction, XyoSigner } from '@xyo-network/xl1-protocol/protocol-lib';
+import type { CreatableProviderParams } from '../protocol-sdk/index.js';
+import { AbstractCreatableProvider } from '../protocol-sdk/index.js';
+/** Parameters for XyoSignerWrapper. */
+export interface XyoSignerWrapperParams extends CreatableProviderParams {
+    signer: XyoSigner;
+}
+/**
+ * Adapts a pre-built XyoSigner instance into a CreatableProvider so it can be
+ * registered with a ProviderFactoryLocator. Used by GatewayBuilder.build(signer).
+ */
+export declare class XyoSignerWrapper extends AbstractCreatableProvider<XyoSignerWrapperParams> implements XyoSigner {
+    static readonly defaultMoniker: "XyoSigner";
+    static readonly dependencies: never[];
+    static readonly monikers: "XyoSigner"[];
+    moniker: "XyoSigner";
+    address(): Promisable<XyoAddress>;
+    sign<T extends UnsignedBoundWitness>(bw: [T, Payload[]]): Promisable<SignedHydratedBoundWitnessWithHashMeta<Signed<T>>>;
+    signTransaction(tx: UnsignedHydratedTransaction): Promisable<SignedHydratedTransactionWithHashMeta>;
+}
+//# sourceMappingURL=XyoSignerWrapper.d.ts.map

package/dist/browser/modules/gateway/XyoSignerWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XyoSignerWrapper.d.ts","sourceRoot":"","sources":["../../../../src/modules/gateway/XyoSignerWrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EACV,OAAO,EAAE,MAAM,EAAE,sCAAsC,EAAE,oBAAoB,EAAE,UAAU,EAC1F,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EACV,qCAAqC,EAAE,2BAA2B,EAAE,SAAS,EAC9E,MAAM,wCAAwC,CAAA;AAG/C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EACL,yBAAyB,EAE1B,MAAM,eAAe,CAAA;AAEtB,uCAAuC;AACvC,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB;IACrE,MAAM,EAAE,SAAS,CAAA;CAClB;AAED;;;GAGG;AACH,qBACa,gBAAiB,SAAQ,yBAAyB,CAAC,sBAAsB,CAAE,YAAW,SAAS;IAC1G,MAAM,CAAC,QAAQ,CAAC,cAAc,cAAmB;IACjD,MAAM,CAAC,QAAQ,CAAC,YAAY,UAAK;IACjC,MAAM,CAAC,QAAQ,CAAC,QAAQ,gBAAqB;IAC7C,OAAO,cAAkC;IAEzC,OAAO,IAAI,UAAU,CAAC,UAAU,CAAC;IAIjC,IAAI,CAAC,CAAC,SAAS,oBAAoB,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,sCAAsC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAIvH,eAAe,CAAC,EAAE,EAAE,2BAA2B,GAAG,UAAU,CAAC,qCAAqC,CAAC;CAGpG"}

package/dist/browser/modules/gateway/dataLakes/PageProvider.d.ts

@@ -0,0 +1,39 @@
+import type { Hash, Promisable, PromisableArray } from '@ariestools/sdk';
+import type { NextOptions, Sequence } from '@xyo-network/sdk';
+import { type DataLakeData, type DataLakeRunnerMethods, type DataLakeViewerMethods } from '@xyo-network/xl1-protocol/protocol-lib';
+import type { DataLakePageRpcSchemas, RpcTransport } from '../../rpc/index.js';
+/**
+ * Shared base for page-side data lake providers. Holds the wallet-mediated
+ * JSON-RPC transport and the opaque per-origin lake `id`, and provides the
+ * read-side implementations (`get`, `next`) common to viewers and runners.
+ * Not constructable on its own — instantiate {@link DataLakePageViewer} or
+ * {@link DataLakePageRunner} depending on the granted capability.
+ */
+export declare abstract class AbstractDataLakePageProvider {
+    protected readonly id: string;
+    protected readonly transport: RpcTransport<DataLakePageRpcSchemas>;
+    constructor(transport: RpcTransport<DataLakePageRpcSchemas>, id: string);
+    get(hashes: Hash[]): Promise<DataLakeData[]>;
+    next(_options?: NextOptions<Sequence>): PromisableArray<DataLakeData>;
+}
+/**
+ * Read-only page-side data lake provider — proxies `get` (and `next` once
+ * implemented) through the wallet's JSON-RPC transport. Bound to a single
+ * approved lake `id`; construct one instance per `viewer`-capability grant.
+ */
+export declare class DataLakePageViewer extends AbstractDataLakePageProvider implements DataLakeViewerMethods {
+    readonly moniker: "DataLakeViewer";
+}
+/**
+ * Read/write page-side data lake provider — adds `insert` (and `clear` /
+ * `delete` once implemented) on top of the viewer surface. Requires the
+ * wallet grant to include the `runner` capability. Bound to a single
+ * approved lake `id`.
+ */
+export declare class DataLakePageRunner extends AbstractDataLakePageProvider implements DataLakeRunnerMethods {
+    readonly moniker: "DataLakeRunner";
+    clear(): Promisable<void>;
+    delete(_hashes: Hash[]): PromisableArray<DataLakeData>;
+    insert(items: DataLakeData[]): Promise<DataLakeData[]>;
+}
+//# sourceMappingURL=PageProvider.d.ts.map

package/dist/browser/modules/gateway/dataLakes/PageProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageProvider.d.ts","sourceRoot":"","sources":["../../../../../src/modules/gateway/dataLakes/PageProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EAAE,UAAU,EAAE,eAAe,EAClC,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EACL,KAAK,YAAY,EAAE,KAAK,qBAAqB,EAAyB,KAAK,qBAAqB,EAEjG,MAAM,wCAAwC,CAAA;AAE/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAGhE;;;;;;GAMG;AACH,8BAAsB,4BAA4B;IAChD,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAC7B,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,sBAAsB,CAAC,CAAA;gBAEtD,SAAS,EAAE,YAAY,CAAC,sBAAsB,CAAC,EAAE,EAAE,EAAE,MAAM;IAKjE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAIlD,IAAI,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,eAAe,CAAC,YAAY,CAAC;CAGtE;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,4BAA6B,YAAW,qBAAqB;IACnG,QAAQ,CAAC,OAAO,mBAAwB;CACzC;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,4BAA6B,YAAW,qBAAqB;IACnG,QAAQ,CAAC,OAAO,mBAAwB;IAExC,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC;IAIzB,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,eAAe,CAAC,YAAY,CAAC;IAIhD,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAG7D"}

package/dist/browser/modules/gateway/dataLakes/index.d.ts

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

package/dist/browser/modules/gateway/dataLakes/index.d.ts.map

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

package/dist/browser/modules/gateway/getRestGateway.d.ts

@@ -0,0 +1,51 @@
+import type { XyoGateway } from '@xyo-network/xl1-protocol/protocol-lib';
+import type { S3BucketConfig } from '../protocol-sdk/index.js';
+/** Config for a REST/S3-backed client gateway. */
+export interface RestGatewayConfig {
+    /** The finalized blocks bucket — required. `readUrl` becomes the base for BlockViewer. */
+    blocks: S3BucketConfig;
+    /** A separate chain-state bucket, when the head pointer (and chain-contract manifest) live apart from finalized blocks. Defaults to `blocks`. */
+    chainState?: S3BucketConfig;
+    dataLakeEndpoint?: string;
+    /** Custom fetch override for every REST viewer (custom agents, auth headers, tests). Defaults to the global fetch. */
+    fetchFn?: typeof globalThis.fetch;
+    /** A separate index bucket, when step summaries live apart from finalized blocks. Defaults to `blocks`. */
+    index?: S3BucketConfig;
+    /**
+     * Whether `XyoViewer` precomputes network-stake-reward positions across the whole chain at
+     * startup. Defaults to `true`, but that precompute issues one REST round trip per
+     * position/step, which can be slow or fragile against a large, live chain — set `false` for a
+     * lighter-weight client that doesn't need reward data.
+     */
+    initRewardsCache?: boolean;
+    name?: string;
+}
+/**
+ * Derives the standard `{ blocks, chainState, index }` bucket config from a network's root
+ * domain, e.g. `https://crypto-com.mainnet.xyo.space` becomes `https://blocks.crypto-com...`,
+ * `https://state.crypto-com...`, `https://indexes.crypto-com...` — the subdomain-per-bucket
+ * layout live XL1 networks publish under.
+ */
+export declare function restGatewayConfigFromEndpoint(endpoint: string): Pick<RestGatewayConfig, 'blocks' | 'chainState' | 'index'>;
+/**
+ * Builds a read-only `XyoGateway` backed by the S3 static REST file layout instead of RPC:
+ * `BlockViewer`/`ChainStateViewer`/`FinalizationViewer`/`ChainContractViewer` read directly from
+ * the S3 CDN URLs, and every other viewer (account balances, stake, transactions, ...)
+ * is computed on top of that data by the `Simple*` providers, caching what they derive in memory.
+ * Same consumer-facing shape as `GatewayBuilder.build()` — `gateway.connection.viewer.currentBlock()`,
+ * `gateway.connection.viewer.account.balance.accountBalance(...)`, etc.
+ *
+ * @example
+ * // Network root domain — blocks/chainState/index subdomains are derived via
+ * // `restGatewayConfigFromEndpoint` (blocks.<domain>, state.<domain>, indexes.<domain>).
+ * const gateway = await getRestGateway('https://crypto-com.mainnet.xyo.space')
+ *
+ * @example
+ * // Explicit buckets, for networks that don't follow the standard subpath layout.
+ * const gateway = await getRestGateway({
+ *   blocks: { readUrl: 'https://cdn.xl1.example/blocks' },
+ *   chainState: { readUrl: 'https://cdn.xl1.example/chain-state' },
+ * })
+ */
+export declare function getRestGateway(config: string | RestGatewayConfig): Promise<XyoGateway>;
+//# sourceMappingURL=getRestGateway.d.ts.map

package/dist/browser/modules/gateway/getRestGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRestGateway.d.ts","sourceRoot":"","sources":["../../../../src/modules/gateway/getRestGateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAA;AAGxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAInD,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,0FAA0F;IAC1F,MAAM,EAAE,cAAc,CAAA;IACtB,iJAAiJ;IACjJ,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,sHAAsH;IACtH,OAAO,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IACjC,2GAA2G;IAC3G,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AASD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC,CAQ1H;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAY5F"}

package/dist/browser/modules/gateway/index.d.ts

@@ -0,0 +1,5 @@
+export * from './dataLakes/index.js';
+export * from './GatewayBuilder.js';
+export * from './getRestGateway.js';
+export * from './XyoSignerWrapper.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/modules/gateway/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/gateway/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA"}

package/dist/browser/modules/protocol-sdk/Archivists/ArchivistConnectOptions.d.ts

@@ -0,0 +1,8 @@
+/** Logical archivist identity + tuning, independent of substrate. */
+export interface ArchivistConnectOptions {
+    /** Optional maximum entry count for the underlying store. Omit to use the substrate default. */
+    max?: number;
+    /** Logical archivist name (role) within the connection — half of the cache key. */
+    name: string;
+}
+//# sourceMappingURL=ArchivistConnectOptions.d.ts.map

package/dist/browser/modules/protocol-sdk/Archivists/ArchivistConnectOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArchivistConnectOptions.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/Archivists/ArchivistConnectOptions.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,WAAW,uBAAuB;IACtC,gGAAgG;IAChG,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAA;CACb"}

package/dist/browser/modules/protocol-sdk/Archivists/ArchivistFactory.d.ts

@@ -0,0 +1,31 @@
+import type { ArchivistInstance } from '@xyo-network/sdk';
+import type { ConnectionConfig } from '../config/connections/Connection.js';
+import type { ArchivistConnectOptions } from './ArchivistConnectOptions.js';
+/** A connection binding handed to a factory: the connection's name plus its config. */
+export interface ArchivistConnectionBinding {
+    config: ConnectionConfig;
+    name: string;
+}
+/**
+ * Contract every substrate factory implements. `connect` is a static method on the
+ * concrete class (see MemoryArchivistFactory); this interface documents the shape and
+ * lets call sites depend on the abstraction rather than a concrete factory.
+ */
+export interface ArchivistFactory {
+    connect(connectionName: string, config: ConnectionConfig, options: ArchivistConnectOptions): Promise<ArchivistInstance>;
+}
+/** Compose the cache key from the connection name and the logical archivist name. */
+export declare function archivistCacheKey(connectionName: string, archivistName: string): string;
+/**
+ * Per-substrate cache of archivist instances keyed by (connectionName, archivistName).
+ * A single Mutex serializes creation so concurrent callers with the same key share
+ * one instance rather than racing to create two.
+ */
+export declare class ArchivistInstanceCache {
+    private readonly cache;
+    private readonly mutex;
+    clear(): Promise<void>;
+    getOrCreate(connectionName: string, archivistName: string, create: () => Promise<ArchivistInstance>): Promise<ArchivistInstance>;
+    has(connectionName: string, archivistName: string): boolean;
+}
+//# sourceMappingURL=ArchivistFactory.d.ts.map

package/dist/browser/modules/protocol-sdk/Archivists/ArchivistFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArchivistFactory.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/Archivists/ArchivistFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAGzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAC3E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAE3E,uFAAuF;AACvF,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,gBAAgB,CAAA;IACxB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACxH;AAKD,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED;;;;GAIG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAC7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IAE9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,WAAW,CACf,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,GACvC,OAAO,CAAC,iBAAiB,CAAC;IAW7B,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO;CAG5D"}

package/dist/browser/modules/protocol-sdk/Archivists/MemoryArchivistFactory.d.ts

@@ -0,0 +1,19 @@
+import type { ArchivistInstance } from '@xyo-network/sdk';
+import type { ConnectionConfig } from '../config/connections/Connection.js';
+import type { ArchivistConnectOptions } from './ArchivistConnectOptions.js';
+/**
+ * Static, process-global factory for in-memory archivists. `connect` caches by
+ * (connectionName, archivistName) so two callers binding the same memory connection
+ * and role share one MemoryArchivist — i.e. the same physical store. Without this,
+ * each caller would create an isolated Map and silently read/write divergent data.
+ *
+ * `connect` accepts the wide `ConnectionConfig` (the memory variant carries no fields)
+ * so the class satisfies `ArchivistFactory` and can be held in the factory registry.
+ */
+export declare class MemoryArchivistFactory {
+    private static readonly cache;
+    static connect(connectionName: string, _config: ConnectionConfig, options: ArchivistConnectOptions): Promise<ArchivistInstance>;
+    /** Test-only: drop all cached memory archivists so a fresh process state can be simulated. */
+    static reset(): Promise<void>;
+}
+//# sourceMappingURL=MemoryArchivistFactory.d.ts.map

package/dist/browser/modules/protocol-sdk/Archivists/MemoryArchivistFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryArchivistFactory.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/Archivists/MemoryArchivistFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAGzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAC3E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAG3E;;;;;;;;GAQG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAA+B;WAE/C,OAAO,CAClB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;IAW7B,8FAA8F;WACjF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC"}

package/dist/browser/modules/protocol-sdk/Archivists/archivistFactoryRegistry.d.ts

@@ -0,0 +1,9 @@
+import type { ConnectionConfig } from '../config/connections/Connection.js';
+import type { ArchivistFactory } from './ArchivistFactory.js';
+/** Register the factory used to self-provision archivists for a connection type. */
+export declare function registerArchivistFactory(type: ConnectionConfig['type'], factory: ArchivistFactory): void;
+/** The factory registered for a connection type, or undefined if none. */
+export declare function getArchivistFactory(type: ConnectionConfig['type']): ArchivistFactory | undefined;
+/** Test-only: clear host-registered factories, restoring the default (memory-only) state. */
+export declare function resetArchivistFactories(): void;
+//# sourceMappingURL=archivistFactoryRegistry.d.ts.map

package/dist/browser/modules/protocol-sdk/Archivists/archivistFactoryRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archivistFactoryRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/Archivists/archivistFactoryRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAY7D,oFAAoF;AACpF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAExG;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,gBAAgB,GAAG,SAAS,CAEhG;AAKD,6FAA6F;AAC7F,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C"}

package/dist/browser/modules/protocol-sdk/Archivists/archivistRoles.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Canonical logical archivist names ("roles") within a connection. Providers and
+ * bootstrap genesis must agree on these strings — they form half of the
+ * ArchivistFactory cache key (connectionName, archivistName), so a mismatch would
+ * silently split a store that callers expect to share.
+ */
+export declare const CHAIN_ARCHIVIST_ROLE = "chain";
+export declare const PENDING_TRANSACTIONS_ARCHIVIST_ROLE = "pending-transactions";
+export declare const PENDING_BLOCKS_ARCHIVIST_ROLE = "pending-blocks";
+export declare const REJECTED_BLOCKS_ARCHIVIST_ROLE = "rejected-blocks";
+export declare const REJECTED_TRANSACTIONS_ARCHIVIST_ROLE = "rejected-transactions";
+//# sourceMappingURL=archivistRoles.d.ts.map

package/dist/browser/modules/protocol-sdk/Archivists/archivistRoles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archivistRoles.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-sdk/Archivists/archivistRoles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,UAAU,CAAA;AAC3C,eAAO,MAAM,mCAAmC,yBAAyB,CAAA;AACzE,eAAO,MAAM,6BAA6B,mBAAmB,CAAA;AAC7D,eAAO,MAAM,8BAA8B,oBAAoB,CAAA;AAC/D,eAAO,MAAM,oCAAoC,0BAA0B,CAAA"}