@xyo-network/diviner-payload-pointer-memory 2.110.11

package/dist/node/index.js

@@ -0,0 +1,157 @@
+var __defProp = Object.defineProperty;
+var __getProtoOf = Object.getPrototypeOf;
+var __reflectGet = Reflect.get;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __superGet = (cls, obj, key) => __reflectGet(__getProtoOf(cls), key, obj);
+
+// src/Diviner.ts
+import { assertEx as assertEx2 } from "@xylabs/assert";
+import { AbstractDiviner } from "@xyo-network/diviner-abstract";
+import { asDivinerInstance } from "@xyo-network/diviner-model";
+import { isPointerPayload, PayloadPointerDivinerConfigSchema } from "@xyo-network/diviner-payload-pointer-model";
+
+// src/findPayload.ts
+import { BoundWitnessWrapper } from "@xyo-network/boundwitness-wrapper";
+import { BoundWitnessDivinerQuerySchema } from "@xyo-network/diviner-boundwitness-model";
+import { PayloadDivinerQuerySchema } from "@xyo-network/diviner-payload-model";
+import { isBoundWitnessPointer } from "@xyo-network/diviner-payload-pointer-model";
+import { PayloadWrapper } from "@xyo-network/payload-wrapper";
+
+// src/combineRules.ts
+import { assertEx } from "@xylabs/assert";
+import { exists } from "@xylabs/exists";
+import { isPayloadAddressRule, isPayloadSchemaRule, isPayloadTimestampOrderRule } from "@xyo-network/diviner-payload-pointer-model";
+var combineRules = /* @__PURE__ */ __name((rules) => {
+  var _a, _b;
+  const addresses = rules.flat().filter(isPayloadAddressRule).map((r) => r.address).filter(exists);
+  const schemas = rules.flat().filter(isPayloadSchemaRule).map((r) => r.schema).filter(exists);
+  assertEx(schemas.length, () => "At least one schema must be supplied");
+  const directionTimestamp = rules.flat().filter(isPayloadTimestampOrderRule).filter(exists);
+  assertEx(directionTimestamp.length < 2, () => "Must not supply more than 1 direction/timestamp rule");
+  const order = ((_a = directionTimestamp[0]) == null ? void 0 : _a.order) || "desc";
+  const timestamp = directionTimestamp.length > 0 ? (_b = directionTimestamp[0]) == null ? void 0 : _b.timestamp : Date.now();
+  return {
+    addresses,
+    order,
+    schemas,
+    timestamp
+  };
+}, "combineRules");
+
+// src/findPayload.ts
+var limit = 1;
+var createBoundWitnessFilterFromSearchCriteria = /* @__PURE__ */ __name((searchCriteria) => {
+  const { addresses, order = "desc", schemas, timestamp } = searchCriteria;
+  const query = {
+    addresses,
+    limit,
+    order,
+    payload_schemas: schemas,
+    schema: BoundWitnessDivinerQuerySchema,
+    timestamp
+  };
+  return [
+    query
+  ];
+}, "createBoundWitnessFilterFromSearchCriteria");
+var createPayloadFilterFromSearchCriteria = /* @__PURE__ */ __name((searchCriteria) => {
+  const { order = "desc", schemas, timestamp } = searchCriteria;
+  const query = {
+    limit,
+    order,
+    schema: PayloadDivinerQuerySchema,
+    schemas,
+    timestamp
+  };
+  return [
+    query
+  ];
+}, "createPayloadFilterFromSearchCriteria");
+var findPayload = /* @__PURE__ */ __name(async (archivist, boundWitnessDiviner, payloadDiviner, pointer) => {
+  const searchCriteria = combineRules(pointer.reference);
+  const { addresses } = searchCriteria;
+  const findWitnessedPayload = addresses == null ? void 0 : addresses.length;
+  const returnBoundWitness = isBoundWitnessPointer(pointer);
+  if (returnBoundWitness || findWitnessedPayload) {
+    const filter = createBoundWitnessFilterFromSearchCriteria(searchCriteria);
+    const result = await boundWitnessDiviner.divine(filter);
+    const bw = (result == null ? void 0 : result[0]) ? BoundWitnessWrapper.parse(result[0]) : void 0;
+    if (bw) {
+      if (returnBoundWitness) return bw.payload;
+      const { schemas, order = "desc" } = searchCriteria;
+      let payloadIndex = order === "asc" ? 0 : bw.payloadHashes.length - 1;
+      if (schemas) {
+        const schemaInSearchCriteria = /* @__PURE__ */ __name((schema) => schemas.includes(schema), "schemaInSearchCriteria");
+        payloadIndex = order === "asc" ? bw.payloadSchemas.findIndex(schemaInSearchCriteria) : bw.payloadSchemas.findLastIndex(schemaInSearchCriteria);
+      }
+      const hash = bw.payloadHashes[payloadIndex];
+      const result2 = await archivist.get([
+        hash
+      ]);
+      return (result2 == null ? void 0 : result2[0]) ? PayloadWrapper.wrap(result2 == null ? void 0 : result2[0]).payload : void 0;
+    }
+  } else {
+    const filter = createPayloadFilterFromSearchCriteria(searchCriteria);
+    const result = await payloadDiviner.divine(filter);
+    return (result == null ? void 0 : result[0]) ? PayloadWrapper.wrap(result == null ? void 0 : result[0]).payload : void 0;
+  }
+}, "findPayload");
+
+// src/Diviner.ts
+var _PayloadPointerDiviner = class _PayloadPointerDiviner extends AbstractDiviner {
+  async divineHandler(payloads) {
+    const pointer = payloads == null ? void 0 : payloads.find(isPointerPayload);
+    if (!pointer) return [];
+    const archivist = await this.getConfigArchivist();
+    const boundWitnessDiviner = await this.getBoundWitnessDiviner();
+    const payloadDiviner = await this.getPayloadDiviner();
+    const result = await findPayload(archivist, boundWitnessDiviner, payloadDiviner, pointer);
+    return result ? [
+      result
+    ] : [];
+  }
+  /**
+  * Returns the archivist instance for the given config
+  * @returns The archivist instance corresponding to the config
+  */
+  async getBoundWitnessDiviner() {
+    var _a;
+    const name = assertEx2((_a = this.config) == null ? void 0 : _a.boundWitnessDiviner, () => "Missing archivist in config");
+    const mod = assertEx2(await this.resolve(name), () => `Config.boundWitnessDiviner module value of ${name} not resolved`);
+    const diviner = assertEx2(asDivinerInstance(mod), () => `Module ${name} is not an BoundWitnessDiviner`);
+    return diviner;
+  }
+  /**
+  * Returns the archivist instance for the given config
+  * @returns The archivist instance corresponding to the config
+  */
+  async getConfigArchivist() {
+    var _a;
+    const name = assertEx2((_a = this.config) == null ? void 0 : _a.archivist, () => "Missing archivist in config");
+    return assertEx2(await this.getArchivist(), () => `Config.archivist module value of ${name} not resolved`);
+  }
+  /**
+  * Returns the archivist instance for the given config
+  * @returns The archivist instance corresponding to the config
+  */
+  async getPayloadDiviner() {
+    var _a;
+    const name = assertEx2((_a = this.config) == null ? void 0 : _a.payloadDiviner, () => "Missing payloadDiviner in config");
+    const mod = assertEx2(await this.resolve(name), () => `Config.payloadDiviner module value of ${name} not resolved`);
+    const diviner = assertEx2(asDivinerInstance(mod), () => `Module ${name} is not an PayloadDiviner`);
+    return diviner;
+  }
+};
+__name(_PayloadPointerDiviner, "PayloadPointerDiviner");
+__publicField(_PayloadPointerDiviner, "configSchemas", [
+  ...__superGet(_PayloadPointerDiviner, _PayloadPointerDiviner, "configSchemas"),
+  PayloadPointerDivinerConfigSchema
+]);
+__publicField(_PayloadPointerDiviner, "defaultConfigSchema", PayloadPointerDivinerConfigSchema);
+var PayloadPointerDiviner = _PayloadPointerDiviner;
+export {
+  PayloadPointerDiviner
+};
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/Diviner.ts","../../src/findPayload.ts","../../src/combineRules.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { ArchivistInstance } from '@xyo-network/archivist-model'\nimport { AbstractDiviner } from '@xyo-network/diviner-abstract'\nimport { BoundWitnessDiviner } from '@xyo-network/diviner-boundwitness-abstract'\nimport { asDivinerInstance, DivinerInstance, DivinerModuleEventData } from '@xyo-network/diviner-model'\nimport { PayloadDiviner } from '@xyo-network/diviner-payload-abstract'\nimport {\n  isPointerPayload,\n  PayloadPointerDivinerConfigSchema,\n  PayloadPointerDivinerParams,\n  PointerPayload,\n} from '@xyo-network/diviner-payload-pointer-model'\nimport { Payload, Schema } from '@xyo-network/payload-model'\n\nimport { findPayload } from './findPayload.js'\n\nexport class PayloadPointerDiviner<\n  TParams extends PayloadPointerDivinerParams = PayloadPointerDivinerParams,\n  TIn extends PointerPayload = PointerPayload,\n  TOut extends Payload = Payload,\n  TEventData extends DivinerModuleEventData<DivinerInstance<TParams, TIn, TOut>, TIn, TOut> = DivinerModuleEventData<\n    DivinerInstance<TParams, TIn, TOut>,\n    TIn,\n    TOut\n  >,\n> extends AbstractDiviner<TParams, TIn, TOut, TEventData> {\n  static override readonly configSchemas: Schema[] = [...super.configSchemas, PayloadPointerDivinerConfigSchema]\n  static override readonly defaultConfigSchema: Schema = PayloadPointerDivinerConfigSchema\n\n  protected override async divineHandler(payloads?: TIn[]): Promise<TOut[]> {\n    const pointer = payloads?.find(isPointerPayload)\n    if (!pointer) return []\n    const archivist = await this.getConfigArchivist()\n    const boundWitnessDiviner = await this.getBoundWitnessDiviner()\n    const payloadDiviner = await this.getPayloadDiviner()\n    const result = (await findPayload(archivist, boundWitnessDiviner, payloadDiviner, pointer)) as TOut | undefined\n    return result ? [result] : []\n  }\n\n  /**\n   * Returns the archivist instance for the given config\n   * @returns The archivist instance corresponding to the config\n   */\n  private async getBoundWitnessDiviner(): Promise<BoundWitnessDiviner> {\n    const name = assertEx(this.config?.boundWitnessDiviner, () => 'Missing archivist in config')\n    const mod = assertEx(await this.resolve(name), () => `Config.boundWitnessDiviner module value of ${name} not resolved`)\n    const diviner = assertEx(asDivinerInstance(mod), () => `Module ${name} is not an BoundWitnessDiviner`)\n    return diviner as BoundWitnessDiviner\n  }\n\n  /**\n   * Returns the archivist instance for the given config\n   * @returns The archivist instance corresponding to the config\n   */\n  private async getConfigArchivist(): Promise<ArchivistInstance> {\n    const name = assertEx(this.config?.archivist, () => 'Missing archivist in config')\n    return assertEx(await this.getArchivist(), () => `Config.archivist module value of ${name} not resolved`)\n  }\n\n  /**\n   * Returns the archivist instance for the given config\n   * @returns The archivist instance corresponding to the config\n   */\n  private async getPayloadDiviner(): Promise<PayloadDiviner> {\n    const name = assertEx(this.config?.payloadDiviner, () => 'Missing payloadDiviner in config')\n    const mod = assertEx(await this.resolve(name), () => `Config.payloadDiviner module value of ${name} not resolved`)\n    const diviner = assertEx(asDivinerInstance(mod), () => `Module ${name} is not an PayloadDiviner`)\n    return diviner as PayloadDiviner\n  }\n}\n","import { ArchivistInstance } from '@xyo-network/archivist-model'\nimport { BoundWitnessWrapper } from '@xyo-network/boundwitness-wrapper'\nimport { BoundWitnessDiviner } from '@xyo-network/diviner-boundwitness-abstract'\nimport { BoundWitnessDivinerQueryPayload, BoundWitnessDivinerQuerySchema } from '@xyo-network/diviner-boundwitness-model'\nimport { PayloadDiviner } from '@xyo-network/diviner-payload-abstract'\nimport { PayloadDivinerQueryPayload, PayloadDivinerQuerySchema } from '@xyo-network/diviner-payload-model'\nimport { isBoundWitnessPointer, PayloadSearchCriteria, PointerPayload } from '@xyo-network/diviner-payload-pointer-model'\nimport { Payload, Schema } from '@xyo-network/payload-model'\nimport { PayloadWrapper } from '@xyo-network/payload-wrapper'\n\nimport { combineRules } from './combineRules.js'\n\nconst limit = 1\n\nconst createBoundWitnessFilterFromSearchCriteria = (searchCriteria: PayloadSearchCriteria): BoundWitnessDivinerQueryPayload[] => {\n  const { addresses, order = 'desc', schemas, timestamp } = searchCriteria\n  const query: BoundWitnessDivinerQueryPayload = {\n    addresses,\n    limit,\n    order,\n    payload_schemas: schemas,\n    schema: BoundWitnessDivinerQuerySchema,\n    timestamp,\n  }\n  return [query]\n}\n\nconst createPayloadFilterFromSearchCriteria = (searchCriteria: PayloadSearchCriteria): Payload[] => {\n  const { order = 'desc', schemas, timestamp } = searchCriteria\n  const query: PayloadDivinerQueryPayload = { limit, order, schema: PayloadDivinerQuerySchema, schemas, timestamp }\n  return [query]\n}\n\nexport const findPayload = async (\n  archivist: ArchivistInstance,\n  boundWitnessDiviner: BoundWitnessDiviner,\n  payloadDiviner: PayloadDiviner,\n  pointer: PointerPayload,\n): Promise<Payload | undefined> => {\n  const searchCriteria = combineRules(pointer.reference)\n  const { addresses } = searchCriteria\n  const findWitnessedPayload = addresses?.length\n  const returnBoundWitness = isBoundWitnessPointer(pointer)\n  if (returnBoundWitness || findWitnessedPayload) {\n    const filter = createBoundWitnessFilterFromSearchCriteria(searchCriteria)\n    const result = await boundWitnessDiviner.divine(filter)\n    const bw = result?.[0] ? BoundWitnessWrapper.parse(result[0]) : undefined\n    if (bw) {\n      if (returnBoundWitness) return bw.payload\n      const { schemas, order = 'desc' } = searchCriteria\n      let payloadIndex = order === 'asc' ? 0 : bw.payloadHashes.length - 1\n      if (schemas) {\n        const schemaInSearchCriteria = (schema: Schema) => schemas.includes(schema)\n        payloadIndex = order === 'asc' ? bw.payloadSchemas.findIndex(schemaInSearchCriteria) : bw.payloadSchemas.findLastIndex(schemaInSearchCriteria)\n      }\n      const hash = bw.payloadHashes[payloadIndex]\n      const result = await archivist.get([hash])\n      return result?.[0] ? PayloadWrapper.wrap(result?.[0]).payload : undefined\n    }\n  }\n  // Find payload\n  else {\n    const filter = createPayloadFilterFromSearchCriteria(searchCriteria)\n    const result = await payloadDiviner.divine(filter)\n    return result?.[0] ? PayloadWrapper.wrap(result?.[0]).payload : undefined\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { exists } from '@xylabs/exists'\nimport { Address } from '@xylabs/hex'\nimport { Order } from '@xyo-network/diviner-payload-model'\nimport {\n  isPayloadAddressRule,\n  isPayloadSchemaRule,\n  isPayloadTimestampOrderRule,\n  PayloadRule,\n  PayloadSearchCriteria,\n} from '@xyo-network/diviner-payload-pointer-model'\n\n// TODO: Could make it so that composability is such that we:\n// • AND first dimension of array\n// • OR 2nd dimension of array\nexport const combineRules = (rules: PayloadRule[][]): PayloadSearchCriteria => {\n  const addresses = rules\n    .flat()\n    .filter(isPayloadAddressRule)\n    .map((r) => r.address)\n    .filter(exists) as Address[]\n\n  const schemas = rules\n    .flat()\n    .filter(isPayloadSchemaRule)\n    .map((r) => r.schema)\n    .filter(exists)\n  assertEx(schemas.length, () => 'At least one schema must be supplied')\n\n  const directionTimestamp = rules.flat().filter(isPayloadTimestampOrderRule).filter(exists)\n  assertEx(directionTimestamp.length < 2, () => 'Must not supply more than 1 direction/timestamp rule')\n\n  const order: Order = directionTimestamp[0]?.order || 'desc'\n  const timestamp: number = directionTimestamp.length > 0 ? directionTimestamp[0]?.timestamp : Date.now()\n\n  return {\n    addresses,\n    order,\n    schemas,\n    timestamp,\n  }\n}\n"],"mappings":"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","names":["assertEx","AbstractDiviner","asDivinerInstance","isPointerPayload","PayloadPointerDivinerConfigSchema","BoundWitnessWrapper","BoundWitnessDivinerQuerySchema","PayloadDivinerQuerySchema","isBoundWitnessPointer","PayloadWrapper","assertEx","exists","isPayloadAddressRule","isPayloadSchemaRule","isPayloadTimestampOrderRule","combineRules","rules","addresses","flat","filter","isPayloadAddressRule","map","r","address","exists","schemas","isPayloadSchemaRule","schema","assertEx","length","directionTimestamp","isPayloadTimestampOrderRule","order","timestamp","Date","now","limit","createBoundWitnessFilterFromSearchCriteria","searchCriteria","addresses","order","schemas","timestamp","query","payload_schemas","schema","BoundWitnessDivinerQuerySchema","createPayloadFilterFromSearchCriteria","PayloadDivinerQuerySchema","findPayload","archivist","boundWitnessDiviner","payloadDiviner","pointer","combineRules","reference","findWitnessedPayload","length","returnBoundWitness","isBoundWitnessPointer","filter","result","divine","bw","BoundWitnessWrapper","parse","undefined","payload","payloadIndex","payloadHashes","schemaInSearchCriteria","includes","payloadSchemas","findIndex","findLastIndex","hash","get","PayloadWrapper","wrap","PayloadPointerDiviner","AbstractDiviner","divineHandler","payloads","pointer","find","isPointerPayload","archivist","getConfigArchivist","boundWitnessDiviner","getBoundWitnessDiviner","payloadDiviner","getPayloadDiviner","result","findPayload","name","assertEx","config","mod","resolve","diviner","asDivinerInstance","getArchivist","configSchemas","PayloadPointerDivinerConfigSchema","defaultConfigSchema"]}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@xyo-network/diviner-payload-pointer-memory",
+  "author": {
+    "email": "support@xyo.network",
+    "name": "XYO Development Team",
+    "url": "https://xyo.network"
+  },
+  "bugs": {
+    "email": "support@xyo.network",
+    "url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/issues"
+  },
+  "dependencies": {
+    "@xylabs/assert": "^3.6.5",
+    "@xylabs/exists": "^3.6.5",
+    "@xylabs/hex": "^3.6.5",
+    "@xyo-network/archivist-model": "^2.110.13",
+    "@xyo-network/boundwitness-wrapper": "^2.110.13",
+    "@xyo-network/diviner-abstract": "^2.110.13",
+    "@xyo-network/diviner-boundwitness-abstract": "^2.110.13",
+    "@xyo-network/diviner-boundwitness-model": "^2.110.13",
+    "@xyo-network/diviner-model": "^2.110.13",
+    "@xyo-network/diviner-payload-abstract": "^2.110.13",
+    "@xyo-network/diviner-payload-model": "^2.110.13",
+    "@xyo-network/diviner-payload-pointer-model": "^2.110.11",
+    "@xyo-network/payload-model": "^2.110.13",
+    "@xyo-network/payload-wrapper": "^2.110.13"
+  },
+  "devDependencies": {
+    "@types/uuid": "^10.0.0",
+    "@xylabs/ts-scripts-yarn3": "^3.13.3",
+    "@xylabs/tsconfig": "^3.13.3",
+    "@xyo-network/account": "^2.110.13",
+    "@xyo-network/account-model": "^2.110.13",
+    "@xyo-network/archivist-memory": "^2.110.13",
+    "@xyo-network/boundwitness-builder": "^2.110.13",
+    "@xyo-network/boundwitness-model": "^2.110.13",
+    "@xyo-network/diviner-boundwitness-memory": "^2.110.13",
+    "@xyo-network/diviner-payload-memory": "^2.110.13",
+    "@xyo-network/node-memory": "^2.110.13",
+    "@xyo-network/node-model": "^2.110.13",
+    "@xyo-network/payload-builder": "^2.110.13",
+    "@xyo-network/wallet-model": "^2.110.13",
+    "typescript": "^5.5.4",
+    "uuid": "^10.0.0"
+  },
+  "description": "Primary SDK for using XYO Protocol 2.0",
+  "types": "dist/node/index.d.ts",
+  "exports": {
+    ".": {
+      "browser": {
+        "require": {
+          "types": "./dist/browser/index.d.cts",
+          "default": "./dist/browser/index.cjs"
+        },
+        "import": {
+          "types": "./dist/browser/index.d.mts",
+          "default": "./dist/browser/index.js"
+        }
+      },
+      "node": {
+        "require": {
+          "types": "./dist/node/index.d.cts",
+          "default": "./dist/node/index.cjs"
+        },
+        "import": {
+          "types": "./dist/node/index.d.mts",
+          "default": "./dist/node/index.js"
+        }
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "dist/node/index.cjs",
+  "module": "dist/node/index.js",
+  "homepage": "https://xyo.network",
+  "license": "LGPL-3.0-only",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js.git"
+  },
+  "sideEffects": false,
+  "version": "2.110.11",
+  "type": "module"
+}

package/src/Diviner.ts

@@ -0,0 +1,70 @@
+import { assertEx } from '@xylabs/assert'
+import { ArchivistInstance } from '@xyo-network/archivist-model'
+import { AbstractDiviner } from '@xyo-network/diviner-abstract'
+import { BoundWitnessDiviner } from '@xyo-network/diviner-boundwitness-abstract'
+import { asDivinerInstance, DivinerInstance, DivinerModuleEventData } from '@xyo-network/diviner-model'
+import { PayloadDiviner } from '@xyo-network/diviner-payload-abstract'
+import {
+  isPointerPayload,
+  PayloadPointerDivinerConfigSchema,
+  PayloadPointerDivinerParams,
+  PointerPayload,
+} from '@xyo-network/diviner-payload-pointer-model'
+import { Payload, Schema } from '@xyo-network/payload-model'
+
+import { findPayload } from './findPayload.js'
+
+export class PayloadPointerDiviner<
+  TParams extends PayloadPointerDivinerParams = PayloadPointerDivinerParams,
+  TIn extends PointerPayload = PointerPayload,
+  TOut extends Payload = Payload,
+  TEventData extends DivinerModuleEventData<DivinerInstance<TParams, TIn, TOut>, TIn, TOut> = DivinerModuleEventData<
+    DivinerInstance<TParams, TIn, TOut>,
+    TIn,
+    TOut
+  >,
+> extends AbstractDiviner<TParams, TIn, TOut, TEventData> {
+  static override readonly configSchemas: Schema[] = [...super.configSchemas, PayloadPointerDivinerConfigSchema]
+  static override readonly defaultConfigSchema: Schema = PayloadPointerDivinerConfigSchema
+
+  protected override async divineHandler(payloads?: TIn[]): Promise<TOut[]> {
+    const pointer = payloads?.find(isPointerPayload)
+    if (!pointer) return []
+    const archivist = await this.getConfigArchivist()
+    const boundWitnessDiviner = await this.getBoundWitnessDiviner()
+    const payloadDiviner = await this.getPayloadDiviner()
+    const result = (await findPayload(archivist, boundWitnessDiviner, payloadDiviner, pointer)) as TOut | undefined
+    return result ? [result] : []
+  }
+
+  /**
+   * Returns the archivist instance for the given config
+   * @returns The archivist instance corresponding to the config
+   */
+  private async getBoundWitnessDiviner(): Promise<BoundWitnessDiviner> {
+    const name = assertEx(this.config?.boundWitnessDiviner, () => 'Missing archivist in config')
+    const mod = assertEx(await this.resolve(name), () => `Config.boundWitnessDiviner module value of ${name} not resolved`)
+    const diviner = assertEx(asDivinerInstance(mod), () => `Module ${name} is not an BoundWitnessDiviner`)
+    return diviner as BoundWitnessDiviner
+  }
+
+  /**
+   * Returns the archivist instance for the given config
+   * @returns The archivist instance corresponding to the config
+   */
+  private async getConfigArchivist(): Promise<ArchivistInstance> {
+    const name = assertEx(this.config?.archivist, () => 'Missing archivist in config')
+    return assertEx(await this.getArchivist(), () => `Config.archivist module value of ${name} not resolved`)
+  }
+
+  /**
+   * Returns the archivist instance for the given config
+   * @returns The archivist instance corresponding to the config
+   */
+  private async getPayloadDiviner(): Promise<PayloadDiviner> {
+    const name = assertEx(this.config?.payloadDiviner, () => 'Missing payloadDiviner in config')
+    const mod = assertEx(await this.resolve(name), () => `Config.payloadDiviner module value of ${name} not resolved`)
+    const diviner = assertEx(asDivinerInstance(mod), () => `Module ${name} is not an PayloadDiviner`)
+    return diviner as PayloadDiviner
+  }
+}

package/src/combineRules.ts

@@ -0,0 +1,42 @@
+import { assertEx } from '@xylabs/assert'
+import { exists } from '@xylabs/exists'
+import { Address } from '@xylabs/hex'
+import { Order } from '@xyo-network/diviner-payload-model'
+import {
+  isPayloadAddressRule,
+  isPayloadSchemaRule,
+  isPayloadTimestampOrderRule,
+  PayloadRule,
+  PayloadSearchCriteria,
+} from '@xyo-network/diviner-payload-pointer-model'
+
+// TODO: Could make it so that composability is such that we:
+// • AND first dimension of array
+// • OR 2nd dimension of array
+export const combineRules = (rules: PayloadRule[][]): PayloadSearchCriteria => {
+  const addresses = rules
+    .flat()
+    .filter(isPayloadAddressRule)
+    .map((r) => r.address)
+    .filter(exists) as Address[]
+
+  const schemas = rules
+    .flat()
+    .filter(isPayloadSchemaRule)
+    .map((r) => r.schema)
+    .filter(exists)
+  assertEx(schemas.length, () => 'At least one schema must be supplied')
+
+  const directionTimestamp = rules.flat().filter(isPayloadTimestampOrderRule).filter(exists)
+  assertEx(directionTimestamp.length < 2, () => 'Must not supply more than 1 direction/timestamp rule')
+
+  const order: Order = directionTimestamp[0]?.order || 'desc'
+  const timestamp: number = directionTimestamp.length > 0 ? directionTimestamp[0]?.timestamp : Date.now()
+
+  return {
+    addresses,
+    order,
+    schemas,
+    timestamp,
+  }
+}

package/src/findPayload.ts

@@ -0,0 +1,67 @@
+import { ArchivistInstance } from '@xyo-network/archivist-model'
+import { BoundWitnessWrapper } from '@xyo-network/boundwitness-wrapper'
+import { BoundWitnessDiviner } from '@xyo-network/diviner-boundwitness-abstract'
+import { BoundWitnessDivinerQueryPayload, BoundWitnessDivinerQuerySchema } from '@xyo-network/diviner-boundwitness-model'
+import { PayloadDiviner } from '@xyo-network/diviner-payload-abstract'
+import { PayloadDivinerQueryPayload, PayloadDivinerQuerySchema } from '@xyo-network/diviner-payload-model'
+import { isBoundWitnessPointer, PayloadSearchCriteria, PointerPayload } from '@xyo-network/diviner-payload-pointer-model'
+import { Payload, Schema } from '@xyo-network/payload-model'
+import { PayloadWrapper } from '@xyo-network/payload-wrapper'
+
+import { combineRules } from './combineRules.js'
+
+const limit = 1
+
+const createBoundWitnessFilterFromSearchCriteria = (searchCriteria: PayloadSearchCriteria): BoundWitnessDivinerQueryPayload[] => {
+  const { addresses, order = 'desc', schemas, timestamp } = searchCriteria
+  const query: BoundWitnessDivinerQueryPayload = {
+    addresses,
+    limit,
+    order,
+    payload_schemas: schemas,
+    schema: BoundWitnessDivinerQuerySchema,
+    timestamp,
+  }
+  return [query]
+}
+
+const createPayloadFilterFromSearchCriteria = (searchCriteria: PayloadSearchCriteria): Payload[] => {
+  const { order = 'desc', schemas, timestamp } = searchCriteria
+  const query: PayloadDivinerQueryPayload = { limit, order, schema: PayloadDivinerQuerySchema, schemas, timestamp }
+  return [query]
+}
+
+export const findPayload = async (
+  archivist: ArchivistInstance,
+  boundWitnessDiviner: BoundWitnessDiviner,
+  payloadDiviner: PayloadDiviner,
+  pointer: PointerPayload,
+): Promise<Payload | undefined> => {
+  const searchCriteria = combineRules(pointer.reference)
+  const { addresses } = searchCriteria
+  const findWitnessedPayload = addresses?.length
+  const returnBoundWitness = isBoundWitnessPointer(pointer)
+  if (returnBoundWitness || findWitnessedPayload) {
+    const filter = createBoundWitnessFilterFromSearchCriteria(searchCriteria)
+    const result = await boundWitnessDiviner.divine(filter)
+    const bw = result?.[0] ? BoundWitnessWrapper.parse(result[0]) : undefined
+    if (bw) {
+      if (returnBoundWitness) return bw.payload
+      const { schemas, order = 'desc' } = searchCriteria
+      let payloadIndex = order === 'asc' ? 0 : bw.payloadHashes.length - 1
+      if (schemas) {
+        const schemaInSearchCriteria = (schema: Schema) => schemas.includes(schema)
+        payloadIndex = order === 'asc' ? bw.payloadSchemas.findIndex(schemaInSearchCriteria) : bw.payloadSchemas.findLastIndex(schemaInSearchCriteria)
+      }
+      const hash = bw.payloadHashes[payloadIndex]
+      const result = await archivist.get([hash])
+      return result?.[0] ? PayloadWrapper.wrap(result?.[0]).payload : undefined
+    }
+  }
+  // Find payload
+  else {
+    const filter = createPayloadFilterFromSearchCriteria(searchCriteria)
+    const result = await payloadDiviner.divine(filter)
+    return result?.[0] ? PayloadWrapper.wrap(result?.[0]).payload : undefined
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from './Diviner.js'

package/src/spec/testUtil/Account/index.ts

@@ -0,0 +1,12 @@
+import { Account } from '@xyo-network/account'
+import { AccountInstance } from '@xyo-network/account-model'
+
+let _unitTestSigningAccount: Promise<AccountInstance> | undefined
+let _otherUnitTestSigningAccount: Promise<AccountInstance> | undefined
+
+export const unitTestSigningAccount = () =>
+  (_unitTestSigningAccount =
+    _unitTestSigningAccount ?? Account.create({ phrase: 'draw seven setup planet bitter return old bronze neither nephew panel pelican' }))
+export const otherUnitTestSigningAccount = () =>
+  (_otherUnitTestSigningAccount =
+    _otherUnitTestSigningAccount ?? Account.create({ phrase: 'pitch rich dentist meadow few club place dirt push sustain innocent fix' }))

package/src/spec/testUtil/Archivist/getArchivist.ts

@@ -0,0 +1,9 @@
+import { assertEx } from '@xylabs/assert'
+import { ArchivistInstance, asArchivistInstance } from '@xyo-network/archivist-model'
+import { NodeInstance } from '@xyo-network/node-model'
+
+import { ArchivistName } from '../Node/getTestNode.js'
+
+export const getArchivist = async (node: NodeInstance, name = ArchivistName): Promise<ArchivistInstance> => {
+  return assertEx(asArchivistInstance(await node.resolve(name)), () => `Could not find archivist with name ${name}`)
+}

package/src/spec/testUtil/Archivist/index.ts

@@ -0,0 +1 @@
+export * from './getArchivist.js'

package/src/spec/testUtil/Block/getNewBlock.ts

@@ -0,0 +1,35 @@
+import { BoundWitnessBuilder } from '@xyo-network/boundwitness-builder'
+import { BoundWitness } from '@xyo-network/boundwitness-model'
+import { Payload } from '@xyo-network/payload-model'
+
+import { unitTestSigningAccount } from '../Account/index.js'
+import { getNewPayloads } from '../Payload/index.js'
+
+export const getNewBlock = async (...payloads: Payload[]): Promise<BoundWitness> => {
+  return (await (await new BoundWitnessBuilder().witness(await unitTestSigningAccount()).payloads(payloads)).build())[0]
+}
+
+export const getNewBlockWithPayloads = async (numPayloads = 1) => {
+  return getNewBlock(...(await getNewPayloads(numPayloads)))
+}
+
+export const getNewBlocks = async (numBoundWitnesses = 1): Promise<Array<BoundWitness>> => {
+  const sequence = Array.from({ length: numBoundWitnesses }).fill(0)
+  return await Promise.all(
+    sequence.map(async () => {
+      return (await new BoundWitnessBuilder().witness(await unitTestSigningAccount()).build())[0]
+    }),
+  )
+}
+
+export const getNewBlocksWithPayloads = async (numBoundWitnesses = 1, numPayloads = 1): Promise<Array<BoundWitness>> => {
+  return await Promise.all(
+    Array.from({ length: numBoundWitnesses })
+      .fill(0)
+      .map(async () => {
+        return (
+          await (await new BoundWitnessBuilder().witness(await unitTestSigningAccount()).payloads(await getNewPayloads(numPayloads))).build()
+        )[0]
+      }),
+  )
+}

package/src/spec/testUtil/Block/index.ts

@@ -0,0 +1,2 @@
+export * from './getNewBlock.js'
+export * from './insertBlock.js'

package/src/spec/testUtil/Block/insertBlock.ts

@@ -0,0 +1,11 @@
+import { ArchivistInstance } from '@xyo-network/archivist-model'
+import { BoundWitness } from '@xyo-network/boundwitness-model'
+import { Payload, WithMeta } from '@xyo-network/payload-model'
+
+import { getNewBlock } from './getNewBlock.js'
+
+export const insertBlock = async (archivist: ArchivistInstance, boundWitnesses?: BoundWitness | BoundWitness[]): Promise<WithMeta<Payload>[]> => {
+  boundWitnesses = boundWitnesses ?? (await getNewBlock())
+  const data = Array.isArray(boundWitnesses) ? boundWitnesses : [boundWitnesses]
+  return archivist.insert(data)
+}

package/src/spec/testUtil/BoundWitness/getNewBoundWitness.ts

@@ -0,0 +1,25 @@
+import { AccountInstance } from '@xyo-network/account-model'
+import { BoundWitnessBuilder } from '@xyo-network/boundwitness-builder'
+import { BoundWitness } from '@xyo-network/boundwitness-model'
+import { ModuleError, Payload } from '@xyo-network/payload-model'
+
+import { unitTestSigningAccount } from '../Account/index.js'
+import { getNewPayloads } from '../Payload/index.js'
+
+export const getNewBoundWitness = async (signers?: AccountInstance[], payloads?: Payload[]): Promise<[BoundWitness, Payload[], ModuleError[]]> => {
+  return await (await new BoundWitnessBuilder().payloads(payloads ?? (await getNewPayloads(1))))
+    .witnesses(signers ?? [await unitTestSigningAccount()])
+    .build()
+}
+
+export const getNewBoundWitnesses = async (
+  signers?: AccountInstance[],
+  numBoundWitnesses = 1,
+  numPayloads = 1,
+): Promise<[BoundWitness, Payload[], ModuleError[]][]> => {
+  const response: [BoundWitness, Payload[], ModuleError[]][] = []
+  for (let i = 0; i < numBoundWitnesses; i++) {
+    response.push(await getNewBoundWitness(signers ?? [await unitTestSigningAccount()], await getNewPayloads(numPayloads)))
+  }
+  return response
+}

package/src/spec/testUtil/BoundWitness/index.ts

@@ -0,0 +1 @@
+export * from './getNewBoundWitness.js'

package/src/spec/testUtil/Diviner/getPayloadPointerDiviner.ts

@@ -0,0 +1,10 @@
+import { asDivinerInstance } from '@xyo-network/diviner-model'
+import { NodeInstance } from '@xyo-network/node-model'
+
+import { PayloadPointerDiviner } from '../../../Diviner.js'
+import { getTestNode, PayloadPointerDivinerName } from '../Node/index.js'
+
+export const getPayloadPointerDiviner = async (node?: NodeInstance) => {
+  if (!node) node = await getTestNode()
+  return asDivinerInstance(await node?.resolve(PayloadPointerDivinerName)) as PayloadPointerDiviner
+}

package/src/spec/testUtil/Diviner/index.ts

@@ -0,0 +1 @@
+export * from './getPayloadPointerDiviner.js'

package/src/spec/testUtil/Model/TestWeb3User.ts

@@ -0,0 +1,4 @@
+export interface TestWeb3User {
+  address: string
+  privateKey: string
+}

package/src/spec/testUtil/Model/index.ts

@@ -0,0 +1 @@
+export * from './TestWeb3User.js'

package/src/spec/testUtil/Node/getTestNode.ts

@@ -0,0 +1,43 @@
+import { MemoryArchivist, MemoryArchivistConfigSchema } from '@xyo-network/archivist-memory'
+import { MemoryBoundWitnessDiviner } from '@xyo-network/diviner-boundwitness-memory'
+import { BoundWitnessDivinerConfigSchema } from '@xyo-network/diviner-boundwitness-model'
+import { MemoryPayloadDiviner } from '@xyo-network/diviner-payload-memory'
+import { PayloadDivinerConfigSchema } from '@xyo-network/diviner-payload-model'
+import { PayloadPointerDivinerConfig, PayloadPointerDivinerConfigSchema } from '@xyo-network/diviner-payload-pointer-model'
+import { MemoryNode } from '@xyo-network/node-memory'
+import { NodeInstance } from '@xyo-network/node-model'
+
+import { PayloadPointerDiviner } from '../../../Diviner.js'
+
+export const ArchivistName = 'Archivist'
+export const BoundWitnessDivinerName = 'BoundWitnessDiviner'
+export const PayloadDivinerName = 'PayloadDiviner'
+export const PayloadPointerDivinerName = 'PayloadPointerDiviner'
+
+export const getTestNode = async (): Promise<NodeInstance> => {
+  const node = await MemoryNode.create()
+  const archivist = await MemoryArchivist.create({ account: 'random', config: { schema: MemoryArchivistConfigSchema, name: ArchivistName } })
+  const payloadDiviner = await MemoryPayloadDiviner.create({
+    account: 'random',
+    config: { schema: PayloadDivinerConfigSchema, name: PayloadDivinerName, archivist: ArchivistName },
+  })
+  const boundWitnessDiviner = await MemoryBoundWitnessDiviner.create({
+    account: 'random',
+    config: { schema: BoundWitnessDivinerConfigSchema, name: BoundWitnessDivinerName, archivist: ArchivistName },
+  })
+  const config: PayloadPointerDivinerConfig = {
+    schema: PayloadPointerDivinerConfigSchema,
+    archivist: ArchivistName,
+
+    payloadDiviner: PayloadDivinerName,
+    boundWitnessDiviner: BoundWitnessDivinerName,
+    name: PayloadPointerDivinerName,
+  }
+  const payloadPointerDiviner = await PayloadPointerDiviner.create({ account: 'random', config })
+  const children = [archivist, payloadDiviner, boundWitnessDiviner, payloadPointerDiviner]
+  for (const child of children) {
+    await node.register(child)
+    await node.attach(child.address, true)
+  }
+  return node
+}

package/src/spec/testUtil/Node/index.ts

@@ -0,0 +1 @@
+export * from './getTestNode.js'