@xyo-network/chain-bridge 1.15.2

package/dist/node/server/routes/address/AddressPathParams.d.ts

@@ -0,0 +1,4 @@
+export type AddressPathParams = {
+    address: string;
+};
+//# sourceMappingURL=AddressPathParams.d.ts.map

package/dist/node/server/routes/address/AddressPathParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddressPathParams.d.ts","sourceRoot":"","sources":["../../../../../src/server/routes/address/AddressPathParams.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA"}

package/dist/node/server/routes/address/addNodeRoutes.d.ts

@@ -0,0 +1,3 @@
+import type { Express } from 'express';
+export declare const addNodeRoutes: (app: Express) => void;
+//# sourceMappingURL=addNodeRoutes.d.ts.map

package/dist/node/server/routes/address/addNodeRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addNodeRoutes.d.ts","sourceRoot":"","sources":["../../../../../src/server/routes/address/addNodeRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAMtC,eAAO,MAAM,aAAa,GAAI,KAAK,OAAO,SAczC,CAAA"}

package/dist/node/server/routes/address/get/get.d.ts

@@ -0,0 +1,4 @@
+import type { Payload } from '@xyo-network/payload-model';
+import type { AddressPathParams } from '../AddressPathParams.ts';
+export declare const getAddress: (req: import("express").Request<AddressPathParams, Payload[], any, import("qs").ParsedQs, Record<string, any>>, res: import("express").Response<Payload[], Record<string, any>>, next: import("express").NextFunction) => Promise<unknown>;
+//# sourceMappingURL=get.d.ts.map

package/dist/node/server/routes/address/get/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../../../src/server/routes/address/get/get.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAIzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAwBhE,eAAO,MAAM,UAAU,4OAAwB,CAAA"}

package/dist/node/server/routes/address/get/index.d.ts

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

package/dist/node/server/routes/address/get/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/server/routes/address/get/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA"}

package/dist/node/server/routes/address/index.d.ts

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

package/dist/node/server/routes/address/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/server/routes/address/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA"}

package/dist/node/server/routes/address/post/getQueryConfig.d.ts

@@ -0,0 +1,6 @@
+import type { QueryBoundWitness } from '@xyo-network/boundwitness-model';
+import type { ModuleConfig, ModuleInstance } from '@xyo-network/module-model';
+import type { Payload } from '@xyo-network/payload-model';
+import type { Request } from 'express';
+export declare const getQueryConfig: (mod: ModuleInstance, req: Request, bw: QueryBoundWitness, payloads?: Payload[]) => ModuleConfig | undefined;
+//# sourceMappingURL=getQueryConfig.d.ts.map

package/dist/node/server/routes/address/post/getQueryConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getQueryConfig.d.ts","sourceRoot":"","sources":["../../../../../../src/server/routes/address/post/getQueryConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAEtF,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAItC,eAAO,MAAM,cAAc,GAAI,KAAK,cAAc,EAAE,KAAK,OAAO,EAAE,IAAI,iBAAiB,EAAE,WAAW,OAAO,EAAE,KAAG,YAAY,GAAG,SAa9H,CAAA"}

package/dist/node/server/routes/address/post/index.d.ts

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

package/dist/node/server/routes/address/post/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/server/routes/address/post/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA"}

package/dist/node/server/routes/address/post/post.d.ts

@@ -0,0 +1,8 @@
+import { type QueryBoundWitness } from '@xyo-network/boundwitness-model';
+import type { ModuleQueryResult } from '@xyo-network/module-model';
+import type { ModuleError, Payload } from '@xyo-network/payload-model';
+import type { AddressPathParams } from '../AddressPathParams.ts';
+type PostAddressRequestBody = [QueryBoundWitness, undefined | Payload[]];
+export declare const postAddress: (req: import("express").Request<AddressPathParams, ModuleError | ModuleQueryResult, PostAddressRequestBody, import("qs").ParsedQs, Record<string, any>>, res: import("express").Response<ModuleError | ModuleQueryResult, Record<string, any>>, next: import("express").NextFunction) => Promise<unknown>;
+export {};
+//# sourceMappingURL=post.d.ts.map

package/dist/node/server/routes/address/post/post.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post.d.ts","sourceRoot":"","sources":["../../../../../../src/server/routes/address/post/post.ts"],"names":[],"mappings":"AAOA,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAE7F,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAItE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAGhE,KAAK,sBAAsB,GAAG,CAAC,iBAAiB,EAAE,SAAS,GAAG,OAAO,EAAE,CAAC,CAAA;AA2DxE,eAAO,MAAM,WAAW,2SAAwB,CAAA"}

package/dist/node/server/routes/dataLake/addDataLakeRoutes.d.ts

@@ -0,0 +1,3 @@
+import type { Express } from 'express';
+export declare const addDataLakeRoutes: (app: Express) => void;
+//# sourceMappingURL=addDataLakeRoutes.d.ts.map

package/dist/node/server/routes/dataLake/addDataLakeRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addDataLakeRoutes.d.ts","sourceRoot":"","sources":["../../../../../src/server/routes/dataLake/addDataLakeRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAItC,eAAO,MAAM,iBAAiB,GAAI,KAAK,OAAO,SAI7C,CAAA"}

package/dist/node/server/routes/dataLake/archivistMiddleware.d.ts

@@ -0,0 +1,10 @@
+import type { ModuleIdentifier } from '@xyo-network/module-model';
+import type { NodeInstance } from '@xyo-network/node-model';
+import type { Router } from 'express';
+type ArchivistMiddlewareOptions = {
+    archivistModuleIdentifier: ModuleIdentifier;
+    node: NodeInstance;
+};
+export declare const archivistMiddleware: (options: ArchivistMiddlewareOptions) => Router;
+export {};
+//# sourceMappingURL=archivistMiddleware.d.ts.map

package/dist/node/server/routes/dataLake/archivistMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archivistMiddleware.d.ts","sourceRoot":"","sources":["../../../../../src/server/routes/dataLake/archivistMiddleware.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAI3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAiBrC,KAAK,0BAA0B,GAAG;IAChC,yBAAyB,EAAE,gBAAgB,CAAA;IAC3C,IAAI,EAAE,YAAY,CAAA;CACnB,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,SAAS,0BAA0B,KAAG,MAkDzE,CAAA"}

package/dist/node/server/routes/dataLake/index.d.ts

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

package/dist/node/server/routes/dataLake/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/server/routes/dataLake/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA"}

package/dist/node/server/routes/healthz/get.d.ts

@@ -0,0 +1,3 @@
+import type { RequestHandler } from 'express';
+export declare const getHealthz: RequestHandler<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>>;
+//# sourceMappingURL=get.d.ts.map

package/dist/node/server/routes/healthz/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../../src/server/routes/healthz/get.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAiB7C,eAAO,MAAM,UAAU,4HAAU,CAAA"}

package/dist/node/server/routes/healthz/index.d.ts

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

package/dist/node/server/routes/healthz/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/server/routes/healthz/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA"}

package/dist/node/server/routes/index.d.ts

@@ -0,0 +1,5 @@
+export * from './address/index.ts';
+export * from './addRoutes.ts';
+export * from './healthz/index.ts';
+export * from './rpc/index.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/server/routes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/routes/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAElC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA"}

package/dist/node/server/routes/rpc/index.d.ts

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

package/dist/node/server/routes/rpc/index.d.ts.map

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

package/dist/node/server/routes/rpc/routes/addRpcRoutes.d.ts

@@ -0,0 +1,3 @@
+import type { Express } from 'express';
+export declare const addRpcRoutes: (app: Express) => void;
+//# sourceMappingURL=addRpcRoutes.d.ts.map

package/dist/node/server/routes/rpc/routes/addRpcRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addRpcRoutes.d.ts","sourceRoot":"","sources":["../../../../../../src/server/routes/rpc/routes/addRpcRoutes.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC,eAAO,MAAM,YAAY,GAAI,KAAK,OAAO,SAaxC,CAAA"}

package/dist/node/server/routes/rpc/routes/index.d.ts

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

package/dist/node/server/routes/rpc/routes/index.d.ts.map

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

package/dist/node/server/server.d.ts

@@ -0,0 +1,11 @@
+import type { Logger } from '@xylabs/logger';
+import type { NodeInstance } from '@xyo-network/node-model';
+import { type Config } from '@xyo-network/xl1-protocol-sdk';
+interface GetServerContext {
+    config: Config;
+    logger?: Logger;
+    node?: NodeInstance;
+}
+export declare const getServer: (context: GetServerContext) => Promise<import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>>;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/node/server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/server/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAI5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3D,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,+BAA+B,CAAA;AA8B3D,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,YAAY,CAAA;CACpB;AAED,eAAO,MAAM,SAAS,GAAU,SAAS,gBAAgB,gHAexD,CAAA"}

package/package.json

@@ -0,0 +1,125 @@
+{
+  "name": "@xyo-network/chain-bridge",
+  "version": "1.15.2",
+  "description": "XYO Layer One Bridge",
+  "homepage": "https://xylabs.com",
+  "bugs": {
+    "url": "git+https://github.com/xylabs/xyo-chain/issues",
+    "email": "support@xylabs.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xylabs/xyo-chain.git"
+  },
+  "license": "LGPL-3.0-only",
+  "author": {
+    "name": "XY Labs Development Team",
+    "email": "support@xylabs.com",
+    "url": "https://xylabs.com"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/node/index.d.ts",
+      "source": "./src/index.ts",
+      "default": "./dist/node/index.mjs"
+    },
+    "./package.json": "./package.json",
+    "./README.md": "./README.md"
+  },
+  "module": "./dist/node/index.mjs",
+  "source": "./src/index.ts",
+  "types": "./dist/node/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build-tests": "tsc --noEmit --lib dom,esnext",
+    "deploy": "echo Deploy not allowed!",
+    "deploy3": "echo Deploy3 not allowed!",
+    "start": "nodemon",
+    "start-esm": "node ./dist/node/index.mjs",
+    "test": "vitest run",
+    "test:ci": "vitest run",
+    "types": "tsc --noEmit -p tsconfig.test.json"
+  },
+  "dependencies": {
+    "@opentelemetry/instrumentation": "~0.205.0",
+    "@opentelemetry/instrumentation-express": "~0.54.0",
+    "@opentelemetry/instrumentation-http": "~0.205.0",
+    "@xylabs/assert": "~5.0.11",
+    "@xylabs/creatable": "~5.0.11",
+    "@xylabs/express": "~5.0.11",
+    "@xylabs/hex": "~5.0.11",
+    "@xylabs/logger": "~5.0.11",
+    "@xylabs/mongo": "~5.0.11",
+    "@xylabs/typeof": "~5.0.11",
+    "@xyo-network/archivist-memory": "~5.1.3",
+    "@xyo-network/archivist-model": "~5.1.3",
+    "@xyo-network/archivist-mongodb": "~5.1.3",
+    "@xyo-network/archivist-view": "~5.1.3",
+    "@xyo-network/bios": "~7.1.0",
+    "@xyo-network/boundwitness-model": "~5.1.3",
+    "@xyo-network/chain-modules": "~1.15.2",
+    "@xyo-network/chain-protocol": "~1.15.2",
+    "@xyo-network/chain-rpc": "~1.15.2",
+    "@xyo-network/chain-telemetry": "~1.15.2",
+    "@xyo-network/manifest-model": "~5.1.3",
+    "@xyo-network/manifest-wrapper": "~5.1.3",
+    "@xyo-network/module-abstract": "~5.1.3",
+    "@xyo-network/module-factory-locator": "~5.1.3",
+    "@xyo-network/module-model": "~5.1.3",
+    "@xyo-network/node-model": "~5.1.3",
+    "@xyo-network/payload-builder": "~5.1.3",
+    "@xyo-network/payload-model": "~5.1.3",
+    "@xyo-network/sentinel-memory": "~5.1.3",
+    "@xyo-network/wallet": "~5.1.3",
+    "@xyo-network/wallet-model": "~5.1.3",
+    "@xyo-network/xl1-protocol-sdk": "~1.15.2",
+    "@xyo-network/xl1-rpc": "~1.15.2",
+    "compression": "~1.8.1",
+    "cors": "~2.8.5",
+    "express": "~5.1.0",
+    "http-status-codes": "~2.3.0",
+    "mongodb": "~6.20.0",
+    "rxjs": "~7.8.2"
+  },
+  "devDependencies": {
+    "@types/compression": "~1.8.1",
+    "@types/cors": "~2.8.19",
+    "@types/express": "5.0.3",
+    "@types/express-serve-static-core": "~5.0.7",
+    "@types/node": "~24.5.2",
+    "@xylabs/base": "~5.0.11",
+    "@xylabs/object": "~5.0.11",
+    "@xylabs/promise": "~5.0.11",
+    "@xylabs/ts-scripts-yarn3": "~7.1.7",
+    "@xylabs/tsconfig": "~7.1.7",
+    "@xyo-network/account": "~5.1.3",
+    "@xyo-network/account-model": "~5.1.3",
+    "@xyo-network/archivist-abstract": "~5.1.3",
+    "@xyo-network/bios-model": "~7.1.0",
+    "@xyo-network/boundwitness-builder": "~5.1.3",
+    "@xyo-network/chain-services": "~1.15.2",
+    "@xyo-network/module-abstract-mongodb": "~5.1.3",
+    "@xyo-network/module-model-mongodb": "~5.1.3",
+    "@xyo-network/node-memory": "~5.1.3",
+    "@xyo-network/xl1-protocol": "~1.12.40",
+    "dotenv": "~17.2.2",
+    "eslint": "^9.36.0",
+    "nodemon": "~3.1.10",
+    "tslib": "~2.8.1",
+    "typescript": "~5.9.2",
+    "vitest": "~3.2.4",
+    "vitest-mock-extended": "~3.1.0"
+  },
+  "engines": {
+    "node": ">=22.3 <23"
+  },
+  "engineStrict": true,
+  "publishConfig": {
+    "access": "restricted"
+  }
+}

package/src/driver/index.ts

@@ -0,0 +1 @@
+export * from './mongo/index.ts'

package/src/driver/indexer/ChainBlockIteration/ChainHashIterationService.ts

@@ -0,0 +1,87 @@
+import { assertEx } from '@xylabs/assert'
+import type { Hash, Hex } from '@xylabs/hex'
+import type { Promisable } from '@xylabs/promise'
+import {
+  isDefined, isNull, isUndefined,
+} from '@xylabs/typeof'
+import type { ArchivistInstance } from '@xyo-network/archivist-model'
+import type { BaseServiceParams } from '@xyo-network/chain-services'
+import { BaseService } from '@xyo-network/chain-services'
+import { PayloadBuilder } from '@xyo-network/payload-builder'
+import type { WithStorageMeta } from '@xyo-network/payload-model'
+import {
+  asBlockBoundWitnessWithStorageMeta, type BlockBoundWitness, type ChainIteratorServiceEventData, type EventingChainHashIteratorService,
+  isBlockBoundWitnessWithStorageMeta,
+} from '@xyo-network/xl1-protocol'
+
+export interface ChainHashIterationServiceParams extends BaseServiceParams {
+  chainArchivist: ArchivistInstance
+  head: BlockBoundWitness
+}
+
+export class ChainHashIterationService extends BaseService<ChainHashIterationServiceParams, ChainIteratorServiceEventData>
+  implements EventingChainHashIteratorService {
+  protected _currentHead: WithStorageMeta<BlockBoundWitness> | undefined
+
+  get chainArchivist(): ArchivistInstance { return assertEx(this.params.chainArchivist) }
+
+  get chainId(): Hex { return assertEx(this._currentHead?.chain ?? this.params?.head?.chain, () => 'Current head is not set') }
+
+  get(id: Hash): Promisable<BlockBoundWitness | undefined> {
+    return this.getHashAsBlockBoundWitnessWithStorageMeta(id)
+  }
+
+  async head(): Promise<WithStorageMeta<BlockBoundWitness>> {
+    if (isDefined(this._currentHead)) return this._currentHead
+    if (isDefined(this.params.head)) {
+      const newHead = await this.getBoundWitnessAsBlockBoundWitnessWithStorageMeta(this.params.head)
+      this._currentHead = newHead
+      return newHead
+    }
+    throw new Error('Head is not set')
+  }
+
+  async next(_id: Hex): Promise<WithStorageMeta<BlockBoundWitness> | undefined> {
+    await Promise.resolve() // to make this function async
+    throw new Error('Next method not implemented for ChainHashIterationService.')
+  }
+
+  async previous(block: Hash | undefined = undefined, count: number = 1): Promise<WithStorageMeta<BlockBoundWitness>[]> {
+    const results: WithStorageMeta<BlockBoundWitness>[] = []
+    let currentBlock: WithStorageMeta<BlockBoundWitness> | undefined = await this.head()
+    if (isDefined(block)) {
+      currentBlock = await this.getHashAsBlockBoundWitnessWithStorageMeta(block)
+    }
+    while (currentBlock && results.length < count) {
+      if (isBlockBoundWitnessWithStorageMeta(currentBlock)) {
+        results.push(currentBlock)
+        const { previous } = currentBlock
+        if (isNull(previous)) break
+        const nextBlock = await this.chainArchivist.get([previous])
+        currentBlock = asBlockBoundWitnessWithStorageMeta(nextBlock[0])
+      } else {
+        const hash = await PayloadBuilder.hash(currentBlock)
+        assertEx(asBlockBoundWitnessWithStorageMeta(currentBlock), () => `Expected hash to be a block bound witness [${hash}]`)
+      }
+    }
+    return results
+  }
+
+  async updateHead(head: BlockBoundWitness): Promise<void> {
+    const newHead = await this.getBoundWitnessAsBlockBoundWitnessWithStorageMeta(head)
+    this._currentHead = newHead
+    void this.emit('headUpdated', { blocks: [newHead] })
+  }
+
+  private async getBoundWitnessAsBlockBoundWitnessWithStorageMeta(head: BlockBoundWitness): Promise<WithStorageMeta<BlockBoundWitness>> {
+    const hash = await PayloadBuilder.hash(head)
+    return this.getHashAsBlockBoundWitnessWithStorageMeta(hash)
+  }
+
+  private async getHashAsBlockBoundWitnessWithStorageMeta(hash: Hash): Promise<WithStorageMeta<BlockBoundWitness>> {
+    const stored = (await this.chainArchivist.get([hash])).at(-1)
+    const bw = asBlockBoundWitnessWithStorageMeta(stored)
+    if (isUndefined(bw)) throw new Error(`Block not found in archivist [${hash}]`)
+    return bw
+  }
+}

package/src/driver/indexer/ChainBlockIteration/index.ts

@@ -0,0 +1 @@
+export * from './ChainHashIterationService.ts'

package/src/driver/indexer/ChainBlocksObservable.ts

@@ -0,0 +1,47 @@
+import { isDefined, isUndefined } from '@xylabs/typeof'
+import type { WithStorageMeta } from '@xyo-network/payload-model'
+import type {
+  BlockBoundWitness, EventingChainBlockNumberIteratorService, HeadEventArgs,
+} from '@xyo-network/xl1-protocol'
+import type { Observable } from 'rxjs'
+import {
+  concatMap, defer, fromEvent, mergeMap,
+} from 'rxjs'
+
+export const chainBlocks$ = (
+  chainIterator: EventingChainBlockNumberIteratorService,
+): Observable<WithStorageMeta<BlockBoundWitness>> => {
+  // Event source: head updated
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const headUpdates$ = fromEvent<HeadEventArgs>(chainIterator as any, 'headUpdated')
+
+  return defer(async () => {
+    // seed with current head (optional)
+    const head = await chainIterator.head()
+    return head
+  }).pipe(
+    // merge initial head + updates into a single stream
+    mergeMap((firstHead) => {
+      let lastSeen: number | undefined = firstHead.block
+
+      return headUpdates$.pipe(
+        concatMap(async (blocks: HeadEventArgs) => {
+          // walk backwards from newHead until we reach lastSeen
+          const history: WithStorageMeta<BlockBoundWitness>[] = []
+          const newHead = blocks.blocks.at(-1)
+          let cursor: number | undefined = newHead?.block
+          while (isDefined(cursor) && (isUndefined(lastSeen) || cursor > lastSeen)) {
+            const blocks = await chainIterator.previous(cursor, 1)
+            if (blocks.length === 0) break
+            history.push(blocks[0])
+            cursor = blocks[0].block - 1
+          }
+          if (isDefined(newHead)) lastSeen = newHead.block
+          // emit in ascending order
+          return history.toReversed()
+        }),
+        mergeMap(blocks => blocks), // flatten
+      )
+    }),
+  )
+}

package/src/driver/indexer/ChainHydratedBlocksObservable.ts

@@ -0,0 +1,23 @@
+import type { ReadArchivist } from '@xyo-network/archivist-model'
+import type { WithStorageMeta } from '@xyo-network/payload-model'
+import type { BlockBoundWitness, HydratedBlock } from '@xyo-network/xl1-protocol'
+import { hydrateBlock } from '@xyo-network/xl1-protocol-sdk'
+import type { Observable } from 'rxjs'
+import { concatMap } from 'rxjs'
+
+import { chainBlocks$ } from './ChainBlocksObservable.ts'
+
+/**
+ * Creates an observable of HydratedBlocks from a chain iterator + archivist.
+ * @param chainIterator - EventingChainBlockNumberIteratorService that emits heads
+ * @param archivist - ReadArchivist used to fetch payloads and hydrate blocks
+ */
+export const hydratedChainBlocks$ = (
+  chainIterator: Parameters<typeof chainBlocks$>[0],
+  archivist: ReadArchivist,
+): Observable<HydratedBlock> => {
+  return chainBlocks$(chainIterator).pipe(
+    concatMap((block: WithStorageMeta<BlockBoundWitness>) =>
+      hydrateBlock(archivist, block._hash)),
+  )
+}

package/src/driver/indexer/index.ts

@@ -0,0 +1 @@
+export * from './ChainBlocksObservable.ts'

package/src/driver/indexer/spec/ChainBlocksObservable.spec.ts

@@ -0,0 +1,58 @@
+import { Account } from '@xyo-network/account'
+import type { AccountInstance } from '@xyo-network/account-model'
+import { MemoryArchivist, MemoryArchivistConfigSchema } from '@xyo-network/archivist-memory'
+import type { ArchivistInstance } from '@xyo-network/archivist-model'
+import { buildRandomChain } from '@xyo-network/chain-protocol'
+import { ChainBlockNumberIterationService } from '@xyo-network/chain-services'
+import type { EventingChainBlockNumberIteratorService, HydratedBlock } from '@xyo-network/xl1-protocol'
+import { flattenHydratedBlocks, getDefaultConfig } from '@xyo-network/xl1-protocol-sdk'
+import {
+  firstValueFrom, take, toArray,
+} from 'rxjs'
+import {
+  beforeAll, beforeEach, describe, expect, it,
+} from 'vitest'
+
+import { chainBlocks$ } from '../ChainBlocksObservable.ts'
+
+describe('chainBlocks$', () => {
+  let chainArchivist: ArchivistInstance
+  let producer: AccountInstance
+  let chain: HydratedBlock[]
+  let chainIterator: EventingChainBlockNumberIteratorService
+  const config = getDefaultConfig()
+
+  beforeAll(async () => {
+    producer = await Account.random()
+  })
+
+  beforeEach(async () => {
+    chain = await buildRandomChain(producer, 10)
+    chainArchivist = await MemoryArchivist.create({ config: { schema: MemoryArchivistConfigSchema } })
+    await chainArchivist.insert(flattenHydratedBlocks(chain))
+    chainIterator = await ChainBlockNumberIterationService.create({ chainArchivist, config })
+  })
+  it('emits blocks in order when head updates', async () => {
+    // Arrange
+    // Setup initial head
+    await chainIterator.updateHead(chain[4][0])
+
+    // Setup observable to collect 3 blocks
+    const resultPromise = firstValueFrom(
+      chainBlocks$(chainIterator).pipe(
+        take(3), // wait for 3 blocks
+        toArray(), // collect into array
+      ),
+    )
+
+    // Act
+    // Simulate head updates
+    await chainIterator.updateHead(chain[6][0])
+    await chainIterator.updateHead(chain[7][0])
+    const blocks = await resultPromise
+
+    // Assert
+    // Assert blocks are in ascending order
+    expect(blocks.map(b => b.block)).toEqual([5, 6, 7])
+  })
+})

package/src/driver/indexer/spec/ChainHydratedBlocksObservable.spec.ts

@@ -0,0 +1,58 @@
+import { Account } from '@xyo-network/account'
+import type { AccountInstance } from '@xyo-network/account-model'
+import { MemoryArchivist, MemoryArchivistConfigSchema } from '@xyo-network/archivist-memory'
+import type { ArchivistInstance } from '@xyo-network/archivist-model'
+import { buildRandomChain } from '@xyo-network/chain-protocol'
+import { ChainBlockNumberIterationService } from '@xyo-network/chain-services'
+import type { EventingChainBlockNumberIteratorService, HydratedBlock } from '@xyo-network/xl1-protocol'
+import { flattenHydratedBlocks, getDefaultConfig } from '@xyo-network/xl1-protocol-sdk'
+import {
+  firstValueFrom, take, toArray,
+} from 'rxjs'
+import {
+  beforeAll, beforeEach, describe, expect, it,
+} from 'vitest'
+
+import { hydratedChainBlocks$ } from '../ChainHydratedBlocksObservable.ts'
+
+describe('hydratedChainBlocks$', () => {
+  let chainArchivist: ArchivistInstance
+  let producer: AccountInstance
+  let chain: HydratedBlock[]
+  let chainIterator: EventingChainBlockNumberIteratorService
+  const config = getDefaultConfig()
+
+  beforeAll(async () => {
+    producer = await Account.random()
+  })
+
+  beforeEach(async () => {
+    chain = await buildRandomChain(producer, 10)
+    chainArchivist = await MemoryArchivist.create({ config: { schema: MemoryArchivistConfigSchema } })
+    await chainArchivist.insert(flattenHydratedBlocks(chain))
+    chainIterator = await ChainBlockNumberIterationService.create({ chainArchivist, config })
+  })
+  it('emits blocks in order when head updates', async () => {
+    // Arrange
+    // Setup initial head
+    await chainIterator.updateHead(chain[4][0])
+
+    // Setup observable to collect 3 blocks
+    const resultPromise = firstValueFrom(
+      hydratedChainBlocks$(chainIterator, chainArchivist).pipe(
+        take(3), // wait for 3 blocks
+        toArray(), // collect into array
+      ),
+    )
+
+    // Act
+    // Simulate head updates
+    await chainIterator.updateHead(chain[6][0])
+    await chainIterator.updateHead(chain[7][0])
+    const blocks = await resultPromise
+
+    // Assert
+    // Assert blocks are in ascending order
+    expect(blocks.map(b => b[0].block)).toEqual([5, 6, 7])
+  })
+})