@xyo-network/xl1-protocol-sdk 3.0.3 → 3.0.5

package/dist/neutral/simple/transactionValidation/SimpleTransactionValidationViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SimpleTransactionValidationViewer.d.ts","sourceRoot":"","sources":["../../../../src/simple/transactionValidation/SimpleTransactionValidationViewer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,WAAW,EACX,mBAAmB,EAEnB,0CAA0C,EAC1C,kCAAkC,EAClC,qCAAqC,EACrC,yBAAyB,EACzB,qCAAqC,EACrC,2BAA2B,EAC3B,kCAAkC,EAClC,2BAA2B,EAC5B,MAAM,+BAA+B,CAAA;AAWtC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAA;AAC/E,OAAO,EAAE,yBAAyB,EAAqB,MAAM,kCAAkC,CAAA;AAE/F,wDAAwD;AACxD,MAAM,WAAW,uCAAwC,SAAQ,uBAAuB;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,EAAE,qCAAqC,CAAA;IAChD,KAAK,CAAC,EAAE,0CAA0C,CAAA;CACnD;AAED,wDAAwD;AACxD,qBACa,iCAAkC,SAC7C,yBAAyB,CAAC,uCAAuC,CAAE,YAAW,2BAA2B;IACzG,MAAM,CAAC,QAAQ,CAAC,eAAe,oCAAoC;IACnE,MAAM,CAAC,QAAQ,CAAC,cAAc,gCAAqC;IACnE,MAAM,CAAC,QAAQ,CAAC,YAAY,qEAAgF;IAC5G,MAAM,CAAC,QAAQ,CAAC,QAAQ,kCAAuC;IAC/D,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAG,MAAM,CAAS;IACzC,OAAO,gCAAmD;IAE1D,OAAO,CAAC,qBAAqB,CAAuB;IACpD,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,oBAAoB,CAAsB;IAElD,SAAS,KAAK,WAAW,+BAExB;IAED,SAAS,KAAK,mBAAmB,wBAEhC;IAED,SAAS,KAAK,kBAAkB,WAE/B;WAEqB,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,uCAAuC,CAAC,GAAG,OAAO,CAAC,uCAAuC,CAAC;IAShI,aAAa;IAOtB,4BAA4B,CAChC,KAAK,EAAE,qCAAqC,EAC5C,MAAM,CAAC,EAAE,2BAA2B,GACnC,OAAO,CAAC,CAAC,kCAAkC,EAAE,GAAG,qCAAqC,EAAE,kCAAkC,CAAC,CAAC;IAKxH,6BAA6B,CACjC,YAAY,EAAE,yBAAyB,EAAE,EACzC,MAAM,CAAC,EAAE,2BAA2B,GACnC,OAAO,CAAC,CAAC,CAAC,kCAAkC,EAAE,GAAG,qCAAqC,CAAC,EAAE,EAAE,kCAAkC,CAAC,CAAC;IA2ClI,sBAAsB,CACpB,aAAa,EAAE,yBAAyB,EAAE,EAC1C,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,CAAC,CAAC,kCAAkC,EAAE,GAAG,qCAAqC,CAAC,EAAE,EAAE,kCAAkC,CAAC,CAAC;IAI5H,mBAAmB,CACvB,KAAK,EAAE,yBAAyB,EAChC,MAAM,CAAC,EAAE,2BAA2B,GACnC,OAAO,CAAC,kCAAkC,EAAE,GAAG,qCAAqC,CAAC;IAKlF,oBAAoB,CACxB,YAAY,EAAE,yBAAyB,EAAE,EACzC,MAAM,CAAC,EAAE,2BAA2B,GACnC,OAAO,CAAC,CAAC,kCAAkC,EAAE,GAAG,qCAAqC,CAAC,EAAE,CAAC;YAK9E,kBAAkB;YAalB,eAAe;CAc9B"}
+{"version":3,"file":"SimpleTransactionValidationViewer.d.ts","sourceRoot":"","sources":["../../../../src/simple/transactionValidation/SimpleTransactionValidationViewer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,WAAW,EACX,mBAAmB,EAEnB,0CAA0C,EAC1C,kCAAkC,EAClC,qCAAqC,EACrC,yBAAyB,EACzB,qCAAqC,EACrC,2BAA2B,EAC3B,kCAAkC,EAClC,2BAA2B,EAC5B,MAAM,+BAA+B,CAAA;AAWtC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAA;AAC/E,OAAO,EAAE,yBAAyB,EAAqB,MAAM,kCAAkC,CAAA;AAE/F,wDAAwD;AACxD,MAAM,WAAW,uCAAwC,SAAQ,uBAAuB;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,EAAE,qCAAqC,CAAA;IAChD,KAAK,CAAC,EAAE,0CAA0C,CAAA;CACnD;AAED,wDAAwD;AACxD,qBACa,iCAAkC,SAC7C,yBAAyB,CAAC,uCAAuC,CAAE,YAAW,2BAA2B;IACzG,MAAM,CAAC,QAAQ,CAAC,eAAe,8CAA8C;IAC7E,MAAM,CAAC,QAAQ,CAAC,cAAc,gCAAqC;IACnE,MAAM,CAAC,QAAQ,CAAC,YAAY,qEAAgF;IAC5G,MAAM,CAAC,QAAQ,CAAC,QAAQ,kCAAuC;IAC/D,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAG,MAAM,CAAS;IACzC,OAAO,gCAAmD;IAE1D,OAAO,CAAC,qBAAqB,CAAuB;IACpD,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,oBAAoB,CAAsB;IAElD,SAAS,KAAK,WAAW,+BAExB;IAED,SAAS,KAAK,mBAAmB,wBAEhC;IAED,SAAS,KAAK,kBAAkB,WAE/B;WAEqB,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,uCAAuC,CAAC,GAAG,OAAO,CAAC,uCAAuC,CAAC;IAShI,aAAa;IAOtB,4BAA4B,CAChC,KAAK,EAAE,qCAAqC,EAC5C,MAAM,CAAC,EAAE,2BAA2B,GACnC,OAAO,CAAC,CAAC,kCAAkC,EAAE,GAAG,qCAAqC,EAAE,kCAAkC,CAAC,CAAC;IAKxH,6BAA6B,CACjC,YAAY,EAAE,yBAAyB,EAAE,EACzC,MAAM,CAAC,EAAE,2BAA2B,GACnC,OAAO,CAAC,CAAC,CAAC,kCAAkC,EAAE,GAAG,qCAAqC,CAAC,EAAE,EAAE,kCAAkC,CAAC,CAAC;IA2ClI,sBAAsB,CACpB,aAAa,EAAE,yBAAyB,EAAE,EAC1C,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,CAAC,CAAC,kCAAkC,EAAE,GAAG,qCAAqC,CAAC,EAAE,EAAE,kCAAkC,CAAC,CAAC;IAI5H,mBAAmB,CACvB,KAAK,EAAE,yBAAyB,EAChC,MAAM,CAAC,EAAE,2BAA2B,GACnC,OAAO,CAAC,kCAAkC,EAAE,GAAG,qCAAqC,CAAC;IAKlF,oBAAoB,CACxB,YAAY,EAAE,yBAAyB,EAAE,EACzC,MAAM,CAAC,EAAE,2BAA2B,GACnC,OAAO,CAAC,CAAC,kCAAkC,EAAE,GAAG,qCAAqC,CAAC,EAAE,CAAC;YAK9E,kBAAkB;YAalB,eAAe;CAc9B"}

package/dist/neutral/simple/windowedBlock/SimpleWindowedBlockViewer.d.ts

@@ -10,7 +10,7 @@ export interface SimpleWindowedBlockViewerParams extends CreatableProviderParams
 }
 /** SimpleWindowedBlockViewer implementation. */
 export declare class SimpleWindowedBlockViewer extends AbstractCreatableProvider<SimpleWindowedBlockViewerParams> implements WindowedBlockViewer {
-    static readonly connectionTypes: readonly ["lmdb", "mongo", "rpc"];
+    static readonly connectionTypes: readonly ["lmdb", "mongo", "memory", "rpc"];
     static readonly defaultMoniker: "WindowedBlockViewer";
     static readonly dependencies: "BlockViewer"[];
     static readonly monikers: "WindowedBlockViewer"[];

package/dist/neutral/simple/windowedBlock/SimpleWindowedBlockViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SimpleWindowedBlockViewer.d.ts","sourceRoot":"","sources":["../../../../src/simple/windowedBlock/SimpleWindowedBlockViewer.ts"],"names":[],"mappings":"AAAA,OAAO,EACa,KAAK,IAAI,EAAU,KAAK,UAAU,EACrD,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEhE,OAAO,KAAK,EACV,WAAW,EACX,OAAO,EAAE,yBAAyB,EAAE,+BAA+B,EAAW,mBAAmB,EAAE,cAAc,EAClH,MAAM,+BAA+B,CAAA;AAOtC,OAAO,EACL,yBAAyB,EAAqB,KAAK,uBAAuB,EAC3E,MAAM,kCAAkC,CAAA;AAEzC,gDAAgD;AAChD,MAAM,WAAW,+BAAgC,SAAQ,uBAAuB;IAC9E,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,gDAAgD;AAChD,qBACa,yBAA0B,SAAQ,yBAAyB,CAAC,+BAA+B,CAAE,YAAW,mBAAmB;IACtI,MAAM,CAAC,QAAQ,CAAC,eAAe,oCAAoC;IACnE,MAAM,CAAC,QAAQ,CAAC,cAAc,wBAA6B;IAC3D,MAAM,CAAC,QAAQ,CAAC,YAAY,kBAAuB;IACnD,MAAM,CAAC,QAAQ,CAAC,QAAQ,0BAA+B;IACvD,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAG,MAAM,CAAS;IACzC,OAAO,wBAA6B;IAEpC,OAAO,CAAC,aAAa,CAAiD;IACtE,OAAO,CAAC,eAAe,CAA2D;IAElF,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,mBAAmB,CAAiD;IAE5E,SAAS,KAAK,aAAa,WAE1B;IAED,SAAS,KAAK,YAAY,WAEzB;WAEqB,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,+BAA+B,CAAC,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAQhI,WAAW,CAAC,IAAI,EAAE,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAItB,aAAa,CAAC,WAAW,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAInC,sBAAsB,CAAC,IAAI,EAAE,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAKvC,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWvC,cAAc,CAAC,WAAW,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAW1D,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYjD,yBAAyB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,yBAAyB,EAAE,CAAC;IAIlF,OAAO,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IAIrC,aAAa;IAY5B,YAAY,IAAI,UAAU,CAAC,+BAA+B,CAAC;IAI3D,gBAAgB,IAAI,UAAU,CAAC,IAAI,CAAC;IAIpC,kBAAkB,IAAI,UAAU,CAAC,cAAc,CAAC;IAI1C,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAKtE,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;IAIrD,YAAY;IAOZ,WAAW;IAK1B,OAAO,CAAC,QAAQ;IAwBhB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,QAAQ;YAOF,IAAI;CAsBnB"}
+{"version":3,"file":"SimpleWindowedBlockViewer.d.ts","sourceRoot":"","sources":["../../../../src/simple/windowedBlock/SimpleWindowedBlockViewer.ts"],"names":[],"mappings":"AAAA,OAAO,EACa,KAAK,IAAI,EAAU,KAAK,UAAU,EACrD,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEhE,OAAO,KAAK,EACV,WAAW,EACX,OAAO,EAAE,yBAAyB,EAAE,+BAA+B,EAAW,mBAAmB,EAAE,cAAc,EAClH,MAAM,+BAA+B,CAAA;AAOtC,OAAO,EACL,yBAAyB,EAAqB,KAAK,uBAAuB,EAC3E,MAAM,kCAAkC,CAAA;AAEzC,gDAAgD;AAChD,MAAM,WAAW,+BAAgC,SAAQ,uBAAuB;IAC9E,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,gDAAgD;AAChD,qBACa,yBAA0B,SAAQ,yBAAyB,CAAC,+BAA+B,CAAE,YAAW,mBAAmB;IACtI,MAAM,CAAC,QAAQ,CAAC,eAAe,8CAA8C;IAC7E,MAAM,CAAC,QAAQ,CAAC,cAAc,wBAA6B;IAC3D,MAAM,CAAC,QAAQ,CAAC,YAAY,kBAAuB;IACnD,MAAM,CAAC,QAAQ,CAAC,QAAQ,0BAA+B;IACvD,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAG,MAAM,CAAS;IACzC,OAAO,wBAA6B;IAEpC,OAAO,CAAC,aAAa,CAAiD;IACtE,OAAO,CAAC,eAAe,CAA2D;IAElF,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,mBAAmB,CAAiD;IAE5E,SAAS,KAAK,aAAa,WAE1B;IAED,SAAS,KAAK,YAAY,WAEzB;WAEqB,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,+BAA+B,CAAC,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAQhI,WAAW,CAAC,IAAI,EAAE,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAItB,aAAa,CAAC,WAAW,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAInC,sBAAsB,CAAC,IAAI,EAAE,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAKvC,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWvC,cAAc,CAAC,WAAW,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAW1D,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYjD,yBAAyB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,yBAAyB,EAAE,CAAC;IAIlF,OAAO,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IAIrC,aAAa;IAY5B,YAAY,IAAI,UAAU,CAAC,+BAA+B,CAAC;IAI3D,gBAAgB,IAAI,UAAU,CAAC,IAAI,CAAC;IAIpC,kBAAkB,IAAI,UAAU,CAAC,cAAc,CAAC;IAI1C,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAKtE,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;IAIrD,YAAY;IAOZ,WAAW;IAK1B,OAAO,CAAC,QAAQ;IAwBhB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,QAAQ;YAOF,IAAI;CAsBnB"}

package/dist/neutral/test/index.mjs

@@ -1192,13 +1192,15 @@ var EvmRpcTransportConfigZod = z5.object({
     type: "string"
   })
 }).describe("EVM JSON-RPC transport");
+var MemoryTransportConfigZod = z5.object({ type: z5.literal("memory") }).describe("In-process memory transport");
 var TransportConfigZod = z5.discriminatedUnion("type", [
   LmdbTransportConfigZod,
   MongoTransportConfigZod,
   RpcTransportConfigZod,
   RestTransportConfigZod,
   S3TransportConfigZod,
-  EvmRpcTransportConfigZod
+  EvmRpcTransportConfigZod,
+  MemoryTransportConfigZod
 ]);
 var TransportsConfigZod = z5.record(z5.string(), TransportConfigZod).default({});
 
@@ -1782,6 +1784,70 @@ import {
 } from "@xyo-network/xl1-protocol-lib";
 import { Semaphore } from "async-mutex";
 
+// src/Archivists/ArchivistFactory.ts
+import { Mutex } from "async-mutex";
+var KEY_SEPARATOR = "::";
+function archivistCacheKey(connectionName, archivistName) {
+  return `${connectionName}${KEY_SEPARATOR}${archivistName}`;
+}
+var ArchivistInstanceCache = class {
+  cache = /* @__PURE__ */ new Map();
+  mutex = new Mutex();
+  async clear() {
+    await this.mutex.runExclusive(() => {
+      this.cache.clear();
+    });
+  }
+  async getOrCreate(connectionName, archivistName, create) {
+    const key = archivistCacheKey(connectionName, archivistName);
+    return await this.mutex.runExclusive(async () => {
+      const existing = this.cache.get(key);
+      if (existing !== void 0) return existing;
+      const created = await create();
+      this.cache.set(key, created);
+      return created;
+    });
+  }
+  has(connectionName, archivistName) {
+    return this.cache.has(archivistCacheKey(connectionName, archivistName));
+  }
+};
+
+// src/Archivists/archivistRoles.ts
+var CHAIN_ARCHIVIST_ROLE = "chain";
+
+// src/Archivists/MemoryArchivistFactory.ts
+import { MemoryArchivist as MemoryArchivist2 } from "@xyo-network/sdk-js";
+var MemoryArchivistFactory = class _MemoryArchivistFactory {
+  static cache = new ArchivistInstanceCache();
+  static async connect(connectionName, _config, options) {
+    const { name, max } = options;
+    return await _MemoryArchivistFactory.cache.getOrCreate(
+      connectionName,
+      name,
+      // Omit `max` when unset so the chain store inherits MemoryArchivist's default
+      // (the node-backed memory fallback never capped it — a small cap would evict blocks).
+      async () => await MemoryArchivist2.create({ account: "random", config: max === void 0 ? { name } : { max, name } })
+    );
+  }
+  /** Test-only: drop all cached memory archivists so a fresh process state can be simulated. */
+  static async reset() {
+    await _MemoryArchivistFactory.cache.clear();
+  }
+};
+
+// src/Archivists/connectArchivist.ts
+async function connectArchivist(binding, options) {
+  switch (binding.config.type) {
+    case "memory": {
+      return await MemoryArchivistFactory.connect(binding.name, binding.config, options);
+    }
+    default: {
+      throw new Error(`connectArchivist: connection type '${binding.config.type}' is not self-provisioned \u2014 inject the archivist instead`);
+    }
+  }
+}
+
 // src/utils/HydratedCache.ts
 import { LRUCache } from "lru-cache";
 var HydratedCache = class {
@@ -1820,7 +1886,7 @@ var SimpleBlockViewer = class extends AbstractCreatableProvider {
   _headPollTimer = null;
   _signedHydratedBlockCache;
   get finalizedArchivist() {
-    return this.params.finalizedArchivist;
+    return assertEx15(this.params.finalizedArchivist, () => "finalizedArchivist is required \u2014 inject it or bind a connection");
   }
   get blocksSummaryMap() {
     this._blocksSummaryMap ??= this.params.blocksSummaryMap ?? new LruCacheMap2({ max: 32 });
@@ -1846,10 +1912,12 @@ var SimpleBlockViewer = class extends AbstractCreatableProvider {
     if (headPollIntervalMs !== void 0) {
       assertEx15(headPollIntervalMs >= MIN_HEAD_POLL_INTERVAL_MS, () => `headPollIntervalMs must be at least ${MIN_HEAD_POLL_INTERVAL_MS}ms`);
     }
+    const connection = params.connection;
+    const finalizedArchivist = params.finalizedArchivist ?? (connection ? await connectArchivist(connection, { name: CHAIN_ARCHIVIST_ROLE }) : void 0);
     return {
       ...await super.paramsHandler(params),
       blocksSummaryMap: params.blocksSummaryMap,
-      finalizedArchivist: assertEx15(params.finalizedArchivist, () => "finalizedArchivist is required"),
+      finalizedArchivist: assertEx15(finalizedArchivist, () => "finalizedArchivist is required \u2014 inject it or bind a connection"),
       headPollIntervalMs
     };
   }
@@ -1947,7 +2015,7 @@ var SimpleBlockViewer = class extends AbstractCreatableProvider {
   async createHandler() {
     await super.createHandler();
     this.finalizationViewer = await this.locator.getInstance(FinalizationViewerMoniker);
-    this._store = { chainMap: this.params.finalizedArchivist };
+    this._store = { chainMap: this.finalizedArchivist };
   }
   async currentBlock() {
     return await this.finalizationViewer.head();
@@ -2047,7 +2115,7 @@ var SimpleBlockViewer = class extends AbstractCreatableProvider {
     this._headPollTimer = null;
   }
 };
-__publicField(SimpleBlockViewer, "connectionTypes", ["lmdb", "mongo"]);
+__publicField(SimpleBlockViewer, "connectionTypes", ["lmdb", "mongo", "memory"]);
 __publicField(SimpleBlockViewer, "defaultMoniker", BlockViewerMoniker);
 __publicField(SimpleBlockViewer, "dependencies", [FinalizationViewerMoniker]);
 __publicField(SimpleBlockViewer, "monikers", [BlockViewerMoniker]);
@@ -2107,7 +2175,7 @@ var SimpleChainContractViewer = class extends AbstractCreatableProvider {
     return this.params.stakingTokenAddress;
   }
 };
-__publicField(SimpleChainContractViewer, "connectionTypes", ["lmdb", "mongo"]);
+__publicField(SimpleChainContractViewer, "connectionTypes", ["lmdb", "mongo", "memory"]);
 __publicField(SimpleChainContractViewer, "defaultMoniker", ChainContractViewerMoniker);
 __publicField(SimpleChainContractViewer, "dependencies", [FinalizationViewerMoniker2]);
 __publicField(SimpleChainContractViewer, "monikers", [ChainContractViewerMoniker]);
@@ -2129,7 +2197,7 @@ var SimpleFinalizationViewer = class extends AbstractCreatableProvider {
   _store;
   _signedHydratedBlockCache;
   get finalizedArchivist() {
-    return this.params.finalizedArchivist;
+    return assertEx17(this.params.finalizedArchivist, () => "finalizedArchivist is required \u2014 inject it or bind a connection");
   }
   get hydratedBlockCache() {
     if (this._signedHydratedBlockCache) return this._signedHydratedBlockCache;
@@ -2144,9 +2212,11 @@ var SimpleFinalizationViewer = class extends AbstractCreatableProvider {
     return this._store;
   }
   static async paramsHandler(params) {
+    const connection = params.connection;
+    const finalizedArchivist = params.finalizedArchivist ?? (connection ? await connectArchivist(connection, { name: CHAIN_ARCHIVIST_ROLE }) : void 0);
     return {
       ...await super.paramsHandler(params),
-      finalizedArchivist: assertEx17(params.finalizedArchivist, () => "finalizedArchivist is required")
+      finalizedArchivist: assertEx17(finalizedArchivist, () => "finalizedArchivist is required \u2014 inject it or bind a connection")
     };
   }
   chainId() {
@@ -2154,9 +2224,10 @@ var SimpleFinalizationViewer = class extends AbstractCreatableProvider {
   }
   async createHandler() {
     await super.createHandler();
-    const mostRecentBlock = await findMostRecentBlock(this.params.finalizedArchivist);
+    const finalizedArchivist = this.finalizedArchivist;
+    const mostRecentBlock = await findMostRecentBlock(finalizedArchivist);
     this._chainId = assertEx17(this.config.chain.id ?? mostRecentBlock?.chain, () => "chain.id is required if empty archivist");
-    this._store = { chainMap: this.params.finalizedArchivist };
+    this._store = { chainMap: finalizedArchivist };
   }
   async head() {
     return await this.spanAsync("head", async () => {
@@ -2201,7 +2272,7 @@ var SimpleFinalizationViewer = class extends AbstractCreatableProvider {
     return result;
   }
 };
-__publicField(SimpleFinalizationViewer, "connectionTypes", ["lmdb", "mongo"]);
+__publicField(SimpleFinalizationViewer, "connectionTypes", ["lmdb", "mongo", "memory"]);
 __publicField(SimpleFinalizationViewer, "defaultMoniker", FinalizationViewerMoniker3);
 __publicField(SimpleFinalizationViewer, "dependencies", [ChainContractViewerMoniker2]);
 __publicField(SimpleFinalizationViewer, "monikers", [FinalizationViewerMoniker3]);