@xyo-network/evm-events-witness 2.84.3

package/dist/node/Payload.d.mts

@@ -0,0 +1,19 @@
+import { Payload } from '@xyo-network/payload-model';
+export declare const EvmEventsSchema = "network.xyo.evm.events";
+export type EvmEventsSchema = typeof EvmEventsSchema;
+export type EvmEvents = Payload<{
+    address?: string;
+    eventName?: string;
+    fromBlock?: number;
+    toBlock?: number;
+}, EvmEventsSchema>;
+export declare const EvmEventSchema = "network.xyo.evm.event";
+export type EvmEventSchema = typeof EvmEventSchema;
+export type EvmEvent = Payload<{
+    address: string;
+    args: Record<string, unknown>;
+    block: number;
+    chainId: number;
+    eventName: string;
+}, EvmEventSchema>;
+//# sourceMappingURL=Payload.d.ts.map

package/dist/node/Payload.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Payload.d.ts","sourceRoot":"","sources":["../../src/Payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAEpD,eAAO,MAAM,eAAe,2BAA2B,CAAA;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAA;AAEpD,MAAM,MAAM,SAAS,GAAG,OAAO,CAC7B;IACE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,EACD,eAAe,CAChB,CAAA;AAED,eAAO,MAAM,cAAc,0BAA0B,CAAA;AACrD,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAA;AAElD,MAAM,MAAM,QAAQ,GAAG,OAAO,CAC5B;IACE,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,EACD,cAAc,CACf,CAAA"}

package/dist/node/Payload.d.ts

@@ -0,0 +1,19 @@
+import { Payload } from '@xyo-network/payload-model';
+export declare const EvmEventsSchema = "network.xyo.evm.events";
+export type EvmEventsSchema = typeof EvmEventsSchema;
+export type EvmEvents = Payload<{
+    address?: string;
+    eventName?: string;
+    fromBlock?: number;
+    toBlock?: number;
+}, EvmEventsSchema>;
+export declare const EvmEventSchema = "network.xyo.evm.event";
+export type EvmEventSchema = typeof EvmEventSchema;
+export type EvmEvent = Payload<{
+    address: string;
+    args: Record<string, unknown>;
+    block: number;
+    chainId: number;
+    eventName: string;
+}, EvmEventSchema>;
+//# sourceMappingURL=Payload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Payload.d.ts","sourceRoot":"","sources":["../../src/Payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAEpD,eAAO,MAAM,eAAe,2BAA2B,CAAA;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAA;AAEpD,MAAM,MAAM,SAAS,GAAG,OAAO,CAC7B;IACE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,EACD,eAAe,CAChB,CAAA;AAED,eAAO,MAAM,cAAc,0BAA0B,CAAA;AACrD,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAA;AAElD,MAAM,MAAM,QAAQ,GAAG,OAAO,CAC5B;IACE,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,EACD,cAAc,CACf,CAAA"}

package/dist/node/Witness.d.cts

@@ -0,0 +1,9 @@
+import { AbstractBlockchainWitness } from '@xyo-network/witness-blockchain-abstract';
+import { EvmEventsWitnessParams } from './model';
+import { EvmEvent, EvmEvents } from './Payload';
+export declare class EvmEventsWitness<TParams extends EvmEventsWitnessParams = EvmEventsWitnessParams> extends AbstractBlockchainWitness<TParams, EvmEvents, EvmEvent> {
+    static configSchemas: string[];
+    get abi(): string | readonly (string | import("ethers").JsonFragment)[];
+    protected observeHandler(inPayloads?: EvmEvents[]): Promise<EvmEvent[]>;
+}
+//# sourceMappingURL=Witness.d.ts.map

package/dist/node/Witness.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Witness.d.ts","sourceRoot":"","sources":["../../src/Witness.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAA;AAGpF,OAAO,EAAgC,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAC9E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAmC,MAAM,WAAW,CAAA;AAWhF,qBAAa,gBAAgB,CAAC,OAAO,SAAS,sBAAsB,GAAG,sBAAsB,CAAE,SAAQ,yBAAyB,CAC9H,OAAO,EACP,SAAS,EACT,QAAQ,CACT;IACC,OAAgB,aAAa,WAAiC;IAE9D,IAAI,GAAG,iEAEN;cAEwB,cAAc,CAAC,UAAU,GAAE,SAAS,EAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAsE3F"}

package/dist/node/Witness.d.mts

@@ -0,0 +1,9 @@
+import { AbstractBlockchainWitness } from '@xyo-network/witness-blockchain-abstract';
+import { EvmEventsWitnessParams } from './model';
+import { EvmEvent, EvmEvents } from './Payload';
+export declare class EvmEventsWitness<TParams extends EvmEventsWitnessParams = EvmEventsWitnessParams> extends AbstractBlockchainWitness<TParams, EvmEvents, EvmEvent> {
+    static configSchemas: string[];
+    get abi(): string | readonly (string | import("ethers").JsonFragment)[];
+    protected observeHandler(inPayloads?: EvmEvents[]): Promise<EvmEvent[]>;
+}
+//# sourceMappingURL=Witness.d.ts.map

package/dist/node/Witness.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Witness.d.ts","sourceRoot":"","sources":["../../src/Witness.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAA;AAGpF,OAAO,EAAgC,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAC9E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAmC,MAAM,WAAW,CAAA;AAWhF,qBAAa,gBAAgB,CAAC,OAAO,SAAS,sBAAsB,GAAG,sBAAsB,CAAE,SAAQ,yBAAyB,CAC9H,OAAO,EACP,SAAS,EACT,QAAQ,CACT;IACC,OAAgB,aAAa,WAAiC;IAE9D,IAAI,GAAG,iEAEN;cAEwB,cAAc,CAAC,UAAU,GAAE,SAAS,EAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAsE3F"}

package/dist/node/Witness.d.ts

@@ -0,0 +1,9 @@
+import { AbstractBlockchainWitness } from '@xyo-network/witness-blockchain-abstract';
+import { EvmEventsWitnessParams } from './model';
+import { EvmEvent, EvmEvents } from './Payload';
+export declare class EvmEventsWitness<TParams extends EvmEventsWitnessParams = EvmEventsWitnessParams> extends AbstractBlockchainWitness<TParams, EvmEvents, EvmEvent> {
+    static configSchemas: string[];
+    get abi(): string | readonly (string | import("ethers").JsonFragment)[];
+    protected observeHandler(inPayloads?: EvmEvents[]): Promise<EvmEvent[]>;
+}
+//# sourceMappingURL=Witness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Witness.d.ts","sourceRoot":"","sources":["../../src/Witness.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAA;AAGpF,OAAO,EAAgC,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAC9E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAmC,MAAM,WAAW,CAAA;AAWhF,qBAAa,gBAAgB,CAAC,OAAO,SAAS,sBAAsB,GAAG,sBAAsB,CAAE,SAAQ,yBAAyB,CAC9H,OAAO,EACP,SAAS,EACT,QAAQ,CACT;IACC,OAAgB,aAAa,WAAiC;IAE9D,IAAI,GAAG,iEAEN;cAEwB,cAAc,CAAC,UAAU,GAAE,SAAS,EAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAsE3F"}

package/dist/node/index.cjs

@@ -0,0 +1,111 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  EvmEventSchema: () => EvmEventSchema,
+  EvmEventsSchema: () => EvmEventsSchema,
+  EvmEventsWitness: () => EvmEventsWitness,
+  EvmEventsWitnessConfigSchema: () => EvmEventsWitnessConfigSchema
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/model.ts
+var EvmEventsWitnessConfigSchema = "network.xyo.evm.events.witness.config";
+
+// src/Payload.ts
+var EvmEventsSchema = "network.xyo.evm.events";
+var EvmEventSchema = "network.xyo.evm.event";
+
+// src/Witness.ts
+var import_assert = require("@xylabs/assert");
+var import_exists = require("@xylabs/exists");
+var import_hex = require("@xylabs/hex");
+var import_payload_model = require("@xyo-network/payload-model");
+var import_witness_blockchain_abstract = require("@xyo-network/witness-blockchain-abstract");
+var import_ethers = require("ethers");
+var EvmEventsWitness = class extends import_witness_blockchain_abstract.AbstractBlockchainWitness {
+  static configSchemas = [EvmEventsWitnessConfigSchema];
+  get abi() {
+    return (0, import_assert.assertEx)(this.config.abi, "Missing abi");
+  }
+  async observeHandler(inPayloads = []) {
+    await this.started("throw");
+    await this.getProviders();
+    try {
+      const observations = (await Promise.all(
+        inPayloads.filter((0, import_payload_model.isPayloadOfSchemaType)(EvmEventsSchema)).map(async ({ eventName, address, fromBlock: payloadFromBlock, toBlock: payloadToBlock }) => {
+          var _a;
+          const validatedAddress = (0, import_assert.assertEx)(address ?? this.config.address, "Missing address");
+          const validatedEventName = (0, import_assert.assertEx)(eventName ?? this.config.eventName, "Missing eventName");
+          const provider = await this.getProvider(true, true);
+          const network = await provider.getNetwork();
+          const contract = new import_ethers.Contract(validatedAddress, this.abi, provider);
+          const abiArray = (0, import_assert.assertEx)(Array.isArray(this.abi) ? this.abi : void 0, "Abi is not an array");
+          const abiEvent = (0, import_assert.assertEx)(
+            abiArray.find((entry) => entry.type === "event" && entry.name === validatedEventName),
+            "Could not find event"
+          );
+          const fromBlock = this.config.fromBlock ?? payloadFromBlock ?? ((_a = contract.deploymentTransaction()) == null ? void 0 : _a.blockNumber) ?? void 0;
+          const toBlock = this.config.toBlock ?? payloadToBlock ?? await provider.getBlockNumber();
+          const rawEvents = await contract.queryFilter(contract.filters[validatedEventName], fromBlock, toBlock);
+          const observation = rawEvents.map((rawLog) => {
+            const rawEvent = rawLog;
+            if (rawEvent.args) {
+              const argsObject = {};
+              abiEvent.inputs.map((input, index) => {
+                const value = rawEvent.args[index];
+                if (typeof value === "bigint") {
+                  argsObject[input.name] = (0, import_hex.hexFromBigInt)(value);
+                } else {
+                  argsObject[input.name] = value;
+                }
+              });
+              const eventResult = {
+                address: rawEvent.address,
+                args: argsObject,
+                block: rawEvent.blockNumber,
+                chainId: Number(network.chainId),
+                eventName: validatedEventName,
+                schema: EvmEventSchema
+              };
+              return eventResult;
+            }
+          }).filter(import_exists.exists);
+          console.log(`observation: ${JSON.stringify(observation, null, 2)}`);
+          return observation;
+        })
+      )).flat();
+      return observations;
+    } catch (ex) {
+      const error = ex;
+      console.log(`Error [${this.config.name}]: ${error.message}`);
+      throw error;
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EvmEventSchema,
+  EvmEventsSchema,
+  EvmEventsWitness,
+  EvmEventsWitnessConfigSchema
+});
+//# sourceMappingURL=index.cjs.map

package/dist/node/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/index.ts","../../src/model.ts","../../src/Payload.ts","../../src/Witness.ts"],"sourcesContent":["export * from './model'\nexport * from './Payload'\nexport * from './Witness'\n","import { BlockchainWitnessConfig, BlockchainWitnessParams } from '@xyo-network/witness-blockchain-abstract'\nimport { JsonFragment } from 'ethers'\n\nexport type Abi = string | ReadonlyArray<JsonFragment | string>\n\nexport const EvmEventsWitnessConfigSchema = 'network.xyo.evm.events.witness.config'\nexport type EvmEventsWitnessConfigSchema = typeof EvmEventsWitnessConfigSchema\n\nexport type EvmEventsWitnessConfig = BlockchainWitnessConfig<\n  {\n    abi?: Abi\n    address?: string\n    eventName?: string\n    fromBlock?: number\n    toBlock?: number\n  },\n  EvmEventsWitnessConfigSchema\n>\n\nexport type EvmEventsWitnessParams = BlockchainWitnessParams<EvmEventsWitnessConfig>\n","import { Payload } from '@xyo-network/payload-model'\n\nexport const EvmEventsSchema = 'network.xyo.evm.events'\nexport type EvmEventsSchema = typeof EvmEventsSchema\n\nexport type EvmEvents = Payload<\n  {\n    address?: string\n    eventName?: string\n    fromBlock?: number\n    toBlock?: number\n  },\n  EvmEventsSchema\n>\n\nexport const EvmEventSchema = 'network.xyo.evm.event'\nexport type EvmEventSchema = typeof EvmEventSchema\n\nexport type EvmEvent = Payload<\n  {\n    address: string\n    args: Record<string, unknown>\n    block: number\n    chainId: number\n    eventName: string\n  },\n  EvmEventSchema\n>\n","import { assertEx } from '@xylabs/assert'\nimport { exists } from '@xylabs/exists'\nimport { hexFromBigInt } from '@xylabs/hex'\nimport { isPayloadOfSchemaType } from '@xyo-network/payload-model'\nimport { AbstractBlockchainWitness } from '@xyo-network/witness-blockchain-abstract'\nimport { Contract, EventLog } from 'ethers'\n\nimport { EvmEventsWitnessConfigSchema, EvmEventsWitnessParams } from './model'\nimport { EvmEvent, EvmEvents, EvmEventSchema, EvmEventsSchema } from './Payload'\n\nconst bigIntArrayToHexString = (items: unknown[]) => {\n  return items.map((item) => {\n    if (typeof item === 'bigint') {\n      return hexFromBigInt(item)\n    }\n    return item\n  })\n}\n\nexport class EvmEventsWitness<TParams extends EvmEventsWitnessParams = EvmEventsWitnessParams> extends AbstractBlockchainWitness<\n  TParams,\n  EvmEvents,\n  EvmEvent\n> {\n  static override configSchemas = [EvmEventsWitnessConfigSchema]\n\n  get abi() {\n    return assertEx(this.config.abi, 'Missing abi')\n  }\n\n  protected override async observeHandler(inPayloads: EvmEvents[] = []): Promise<EvmEvent[]> {\n    await this.started('throw')\n    //calling it here to make sure we rests the cache\n    await this.getProviders()\n    try {\n      const observations = (\n        await Promise.all(\n          inPayloads\n            .filter(isPayloadOfSchemaType<EvmEvents>(EvmEventsSchema))\n            .map(async ({ eventName, address, fromBlock: payloadFromBlock, toBlock: payloadToBlock }) => {\n              const validatedAddress = assertEx(address ?? this.config.address, 'Missing address')\n              const validatedEventName = assertEx(eventName ?? this.config.eventName, 'Missing eventName')\n\n              const provider = await this.getProvider(true, true)\n              const network = await provider.getNetwork()\n\n              const contract = new Contract(validatedAddress, this.abi, provider)\n\n              const abiArray = assertEx(Array.isArray(this.abi) ? this.abi : undefined, 'Abi is not an array')\n\n              const abiEvent = assertEx(\n                abiArray.find((entry) => entry.type === 'event' && entry.name === validatedEventName),\n                'Could not find event',\n              )\n\n              const fromBlock = this.config.fromBlock ?? payloadFromBlock ?? contract.deploymentTransaction()?.blockNumber ?? undefined\n              const toBlock = this.config.toBlock ?? payloadToBlock ?? (await provider.getBlockNumber())\n\n              const rawEvents = await contract.queryFilter(contract.filters[validatedEventName], fromBlock, toBlock)\n\n              const observation = rawEvents\n                .map((rawLog) => {\n                  const rawEvent = rawLog as EventLog\n                  if (rawEvent.args) {\n                    const argsObject: Record<string, unknown> = {}\n\n                    abiEvent.inputs.map((input: { name: string }, index: number) => {\n                      const value = rawEvent.args[index]\n                      if (typeof value === 'bigint') {\n                        argsObject[input.name] = hexFromBigInt(value)\n                      } else {\n                        argsObject[input.name] = value\n                      }\n                    })\n\n                    const eventResult: EvmEvent = {\n                      address: rawEvent.address,\n                      args: argsObject,\n                      block: rawEvent.blockNumber,\n                      chainId: Number(network.chainId),\n                      eventName: validatedEventName,\n                      schema: EvmEventSchema,\n                    }\n                    return eventResult\n                  }\n                })\n                .filter(exists)\n\n              console.log(`observation: ${JSON.stringify(observation, null, 2)}`)\n              return observation\n            }),\n        )\n      ).flat()\n      return observations\n    } catch (ex) {\n      const error = ex as Error\n      console.log(`Error [${this.config.name}]: ${error.message}`)\n      throw error\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACKO,IAAM,+BAA+B;;;ACHrC,IAAM,kBAAkB;AAaxB,IAAM,iBAAiB;;;ACf9B,oBAAyB;AACzB,oBAAuB;AACvB,iBAA8B;AAC9B,2BAAsC;AACtC,yCAA0C;AAC1C,oBAAmC;AAc5B,IAAM,mBAAN,cAAgG,6DAIrG;AAAA,EACA,OAAgB,gBAAgB,CAAC,4BAA4B;AAAA,EAE7D,IAAI,MAAM;AACR,eAAO,wBAAS,KAAK,OAAO,KAAK,aAAa;AAAA,EAChD;AAAA,EAEA,MAAyB,eAAe,aAA0B,CAAC,GAAwB;AACzF,UAAM,KAAK,QAAQ,OAAO;AAE1B,UAAM,KAAK,aAAa;AACxB,QAAI;AACF,YAAM,gBACJ,MAAM,QAAQ;AAAA,QACZ,WACG,WAAO,4CAAiC,eAAe,CAAC,EACxD,IAAI,OAAO,EAAE,WAAW,SAAS,WAAW,kBAAkB,SAAS,eAAe,MAAM;AAvCzG;AAwCc,gBAAM,uBAAmB,wBAAS,WAAW,KAAK,OAAO,SAAS,iBAAiB;AACnF,gBAAM,yBAAqB,wBAAS,aAAa,KAAK,OAAO,WAAW,mBAAmB;AAE3F,gBAAM,WAAW,MAAM,KAAK,YAAY,MAAM,IAAI;AAClD,gBAAM,UAAU,MAAM,SAAS,WAAW;AAE1C,gBAAM,WAAW,IAAI,uBAAS,kBAAkB,KAAK,KAAK,QAAQ;AAElE,gBAAM,eAAW,wBAAS,MAAM,QAAQ,KAAK,GAAG,IAAI,KAAK,MAAM,QAAW,qBAAqB;AAE/F,gBAAM,eAAW;AAAA,YACf,SAAS,KAAK,CAAC,UAAU,MAAM,SAAS,WAAW,MAAM,SAAS,kBAAkB;AAAA,YACpF;AAAA,UACF;AAEA,gBAAM,YAAY,KAAK,OAAO,aAAa,sBAAoB,cAAS,sBAAsB,MAA/B,mBAAkC,gBAAe;AAChH,gBAAM,UAAU,KAAK,OAAO,WAAW,kBAAmB,MAAM,SAAS,eAAe;AAExF,gBAAM,YAAY,MAAM,SAAS,YAAY,SAAS,QAAQ,kBAAkB,GAAG,WAAW,OAAO;AAErG,gBAAM,cAAc,UACjB,IAAI,CAAC,WAAW;AACf,kBAAM,WAAW;AACjB,gBAAI,SAAS,MAAM;AACjB,oBAAM,aAAsC,CAAC;AAE7C,uBAAS,OAAO,IAAI,CAAC,OAAyB,UAAkB;AAC9D,sBAAM,QAAQ,SAAS,KAAK,KAAK;AACjC,oBAAI,OAAO,UAAU,UAAU;AAC7B,6BAAW,MAAM,IAAI,QAAI,0BAAc,KAAK;AAAA,gBAC9C,OAAO;AACL,6BAAW,MAAM,IAAI,IAAI;AAAA,gBAC3B;AAAA,cACF,CAAC;AAED,oBAAM,cAAwB;AAAA,gBAC5B,SAAS,SAAS;AAAA,gBAClB,MAAM;AAAA,gBACN,OAAO,SAAS;AAAA,gBAChB,SAAS,OAAO,QAAQ,OAAO;AAAA,gBAC/B,WAAW;AAAA,gBACX,QAAQ;AAAA,cACV;AACA,qBAAO;AAAA,YACT;AAAA,UACF,CAAC,EACA,OAAO,oBAAM;AAEhB,kBAAQ,IAAI,gBAAgB,KAAK,UAAU,aAAa,MAAM,CAAC,CAAC,EAAE;AAClE,iBAAO;AAAA,QACT,CAAC;AAAA,MACL,GACA,KAAK;AACP,aAAO;AAAA,IACT,SAAS,IAAI;AACX,YAAM,QAAQ;AACd,cAAQ,IAAI,UAAU,KAAK,OAAO,IAAI,MAAM,MAAM,OAAO,EAAE;AAC3D,YAAM;AAAA,IACR;AAAA,EACF;AACF;","names":[]}

package/dist/node/index.d.cts

@@ -0,0 +1,4 @@
+export * from './model';
+export * from './Payload';
+export * from './Witness';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA"}

package/dist/node/index.d.mts

@@ -0,0 +1,4 @@
+export * from './model';
+export * from './Payload';
+export * from './Witness';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA"}

package/dist/node/index.d.ts

@@ -0,0 +1,4 @@
+export * from './model';
+export * from './Payload';
+export * from './Witness';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA"}

package/dist/node/index.js

@@ -0,0 +1,81 @@
+// src/model.ts
+var EvmEventsWitnessConfigSchema = "network.xyo.evm.events.witness.config";
+
+// src/Payload.ts
+var EvmEventsSchema = "network.xyo.evm.events";
+var EvmEventSchema = "network.xyo.evm.event";
+
+// src/Witness.ts
+import { assertEx } from "@xylabs/assert";
+import { exists } from "@xylabs/exists";
+import { hexFromBigInt } from "@xylabs/hex";
+import { isPayloadOfSchemaType } from "@xyo-network/payload-model";
+import { AbstractBlockchainWitness } from "@xyo-network/witness-blockchain-abstract";
+import { Contract } from "ethers";
+var EvmEventsWitness = class extends AbstractBlockchainWitness {
+  static configSchemas = [EvmEventsWitnessConfigSchema];
+  get abi() {
+    return assertEx(this.config.abi, "Missing abi");
+  }
+  async observeHandler(inPayloads = []) {
+    await this.started("throw");
+    await this.getProviders();
+    try {
+      const observations = (await Promise.all(
+        inPayloads.filter(isPayloadOfSchemaType(EvmEventsSchema)).map(async ({ eventName, address, fromBlock: payloadFromBlock, toBlock: payloadToBlock }) => {
+          var _a;
+          const validatedAddress = assertEx(address ?? this.config.address, "Missing address");
+          const validatedEventName = assertEx(eventName ?? this.config.eventName, "Missing eventName");
+          const provider = await this.getProvider(true, true);
+          const network = await provider.getNetwork();
+          const contract = new Contract(validatedAddress, this.abi, provider);
+          const abiArray = assertEx(Array.isArray(this.abi) ? this.abi : void 0, "Abi is not an array");
+          const abiEvent = assertEx(
+            abiArray.find((entry) => entry.type === "event" && entry.name === validatedEventName),
+            "Could not find event"
+          );
+          const fromBlock = this.config.fromBlock ?? payloadFromBlock ?? ((_a = contract.deploymentTransaction()) == null ? void 0 : _a.blockNumber) ?? void 0;
+          const toBlock = this.config.toBlock ?? payloadToBlock ?? await provider.getBlockNumber();
+          const rawEvents = await contract.queryFilter(contract.filters[validatedEventName], fromBlock, toBlock);
+          const observation = rawEvents.map((rawLog) => {
+            const rawEvent = rawLog;
+            if (rawEvent.args) {
+              const argsObject = {};
+              abiEvent.inputs.map((input, index) => {
+                const value = rawEvent.args[index];
+                if (typeof value === "bigint") {
+                  argsObject[input.name] = hexFromBigInt(value);
+                } else {
+                  argsObject[input.name] = value;
+                }
+              });
+              const eventResult = {
+                address: rawEvent.address,
+                args: argsObject,
+                block: rawEvent.blockNumber,
+                chainId: Number(network.chainId),
+                eventName: validatedEventName,
+                schema: EvmEventSchema
+              };
+              return eventResult;
+            }
+          }).filter(exists);
+          console.log(`observation: ${JSON.stringify(observation, null, 2)}`);
+          return observation;
+        })
+      )).flat();
+      return observations;
+    } catch (ex) {
+      const error = ex;
+      console.log(`Error [${this.config.name}]: ${error.message}`);
+      throw error;
+    }
+  }
+};
+export {
+  EvmEventSchema,
+  EvmEventsSchema,
+  EvmEventsWitness,
+  EvmEventsWitnessConfigSchema
+};
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/model.ts","../../src/Payload.ts","../../src/Witness.ts"],"sourcesContent":["import { BlockchainWitnessConfig, BlockchainWitnessParams } from '@xyo-network/witness-blockchain-abstract'\nimport { JsonFragment } from 'ethers'\n\nexport type Abi = string | ReadonlyArray<JsonFragment | string>\n\nexport const EvmEventsWitnessConfigSchema = 'network.xyo.evm.events.witness.config'\nexport type EvmEventsWitnessConfigSchema = typeof EvmEventsWitnessConfigSchema\n\nexport type EvmEventsWitnessConfig = BlockchainWitnessConfig<\n  {\n    abi?: Abi\n    address?: string\n    eventName?: string\n    fromBlock?: number\n    toBlock?: number\n  },\n  EvmEventsWitnessConfigSchema\n>\n\nexport type EvmEventsWitnessParams = BlockchainWitnessParams<EvmEventsWitnessConfig>\n","import { Payload } from '@xyo-network/payload-model'\n\nexport const EvmEventsSchema = 'network.xyo.evm.events'\nexport type EvmEventsSchema = typeof EvmEventsSchema\n\nexport type EvmEvents = Payload<\n  {\n    address?: string\n    eventName?: string\n    fromBlock?: number\n    toBlock?: number\n  },\n  EvmEventsSchema\n>\n\nexport const EvmEventSchema = 'network.xyo.evm.event'\nexport type EvmEventSchema = typeof EvmEventSchema\n\nexport type EvmEvent = Payload<\n  {\n    address: string\n    args: Record<string, unknown>\n    block: number\n    chainId: number\n    eventName: string\n  },\n  EvmEventSchema\n>\n","import { assertEx } from '@xylabs/assert'\nimport { exists } from '@xylabs/exists'\nimport { hexFromBigInt } from '@xylabs/hex'\nimport { isPayloadOfSchemaType } from '@xyo-network/payload-model'\nimport { AbstractBlockchainWitness } from '@xyo-network/witness-blockchain-abstract'\nimport { Contract, EventLog } from 'ethers'\n\nimport { EvmEventsWitnessConfigSchema, EvmEventsWitnessParams } from './model'\nimport { EvmEvent, EvmEvents, EvmEventSchema, EvmEventsSchema } from './Payload'\n\nconst bigIntArrayToHexString = (items: unknown[]) => {\n  return items.map((item) => {\n    if (typeof item === 'bigint') {\n      return hexFromBigInt(item)\n    }\n    return item\n  })\n}\n\nexport class EvmEventsWitness<TParams extends EvmEventsWitnessParams = EvmEventsWitnessParams> extends AbstractBlockchainWitness<\n  TParams,\n  EvmEvents,\n  EvmEvent\n> {\n  static override configSchemas = [EvmEventsWitnessConfigSchema]\n\n  get abi() {\n    return assertEx(this.config.abi, 'Missing abi')\n  }\n\n  protected override async observeHandler(inPayloads: EvmEvents[] = []): Promise<EvmEvent[]> {\n    await this.started('throw')\n    //calling it here to make sure we rests the cache\n    await this.getProviders()\n    try {\n      const observations = (\n        await Promise.all(\n          inPayloads\n            .filter(isPayloadOfSchemaType<EvmEvents>(EvmEventsSchema))\n            .map(async ({ eventName, address, fromBlock: payloadFromBlock, toBlock: payloadToBlock }) => {\n              const validatedAddress = assertEx(address ?? this.config.address, 'Missing address')\n              const validatedEventName = assertEx(eventName ?? this.config.eventName, 'Missing eventName')\n\n              const provider = await this.getProvider(true, true)\n              const network = await provider.getNetwork()\n\n              const contract = new Contract(validatedAddress, this.abi, provider)\n\n              const abiArray = assertEx(Array.isArray(this.abi) ? this.abi : undefined, 'Abi is not an array')\n\n              const abiEvent = assertEx(\n                abiArray.find((entry) => entry.type === 'event' && entry.name === validatedEventName),\n                'Could not find event',\n              )\n\n              const fromBlock = this.config.fromBlock ?? payloadFromBlock ?? contract.deploymentTransaction()?.blockNumber ?? undefined\n              const toBlock = this.config.toBlock ?? payloadToBlock ?? (await provider.getBlockNumber())\n\n              const rawEvents = await contract.queryFilter(contract.filters[validatedEventName], fromBlock, toBlock)\n\n              const observation = rawEvents\n                .map((rawLog) => {\n                  const rawEvent = rawLog as EventLog\n                  if (rawEvent.args) {\n                    const argsObject: Record<string, unknown> = {}\n\n                    abiEvent.inputs.map((input: { name: string }, index: number) => {\n                      const value = rawEvent.args[index]\n                      if (typeof value === 'bigint') {\n                        argsObject[input.name] = hexFromBigInt(value)\n                      } else {\n                        argsObject[input.name] = value\n                      }\n                    })\n\n                    const eventResult: EvmEvent = {\n                      address: rawEvent.address,\n                      args: argsObject,\n                      block: rawEvent.blockNumber,\n                      chainId: Number(network.chainId),\n                      eventName: validatedEventName,\n                      schema: EvmEventSchema,\n                    }\n                    return eventResult\n                  }\n                })\n                .filter(exists)\n\n              console.log(`observation: ${JSON.stringify(observation, null, 2)}`)\n              return observation\n            }),\n        )\n      ).flat()\n      return observations\n    } catch (ex) {\n      const error = ex as Error\n      console.log(`Error [${this.config.name}]: ${error.message}`)\n      throw error\n    }\n  }\n}\n"],"mappings":";AAKO,IAAM,+BAA+B;;;ACHrC,IAAM,kBAAkB;AAaxB,IAAM,iBAAiB;;;ACf9B,SAAS,gBAAgB;AACzB,SAAS,cAAc;AACvB,SAAS,qBAAqB;AAC9B,SAAS,6BAA6B;AACtC,SAAS,iCAAiC;AAC1C,SAAS,gBAA0B;AAc5B,IAAM,mBAAN,cAAgG,0BAIrG;AAAA,EACA,OAAgB,gBAAgB,CAAC,4BAA4B;AAAA,EAE7D,IAAI,MAAM;AACR,WAAO,SAAS,KAAK,OAAO,KAAK,aAAa;AAAA,EAChD;AAAA,EAEA,MAAyB,eAAe,aAA0B,CAAC,GAAwB;AACzF,UAAM,KAAK,QAAQ,OAAO;AAE1B,UAAM,KAAK,aAAa;AACxB,QAAI;AACF,YAAM,gBACJ,MAAM,QAAQ;AAAA,QACZ,WACG,OAAO,sBAAiC,eAAe,CAAC,EACxD,IAAI,OAAO,EAAE,WAAW,SAAS,WAAW,kBAAkB,SAAS,eAAe,MAAM;AAvCzG;AAwCc,gBAAM,mBAAmB,SAAS,WAAW,KAAK,OAAO,SAAS,iBAAiB;AACnF,gBAAM,qBAAqB,SAAS,aAAa,KAAK,OAAO,WAAW,mBAAmB;AAE3F,gBAAM,WAAW,MAAM,KAAK,YAAY,MAAM,IAAI;AAClD,gBAAM,UAAU,MAAM,SAAS,WAAW;AAE1C,gBAAM,WAAW,IAAI,SAAS,kBAAkB,KAAK,KAAK,QAAQ;AAElE,gBAAM,WAAW,SAAS,MAAM,QAAQ,KAAK,GAAG,IAAI,KAAK,MAAM,QAAW,qBAAqB;AAE/F,gBAAM,WAAW;AAAA,YACf,SAAS,KAAK,CAAC,UAAU,MAAM,SAAS,WAAW,MAAM,SAAS,kBAAkB;AAAA,YACpF;AAAA,UACF;AAEA,gBAAM,YAAY,KAAK,OAAO,aAAa,sBAAoB,cAAS,sBAAsB,MAA/B,mBAAkC,gBAAe;AAChH,gBAAM,UAAU,KAAK,OAAO,WAAW,kBAAmB,MAAM,SAAS,eAAe;AAExF,gBAAM,YAAY,MAAM,SAAS,YAAY,SAAS,QAAQ,kBAAkB,GAAG,WAAW,OAAO;AAErG,gBAAM,cAAc,UACjB,IAAI,CAAC,WAAW;AACf,kBAAM,WAAW;AACjB,gBAAI,SAAS,MAAM;AACjB,oBAAM,aAAsC,CAAC;AAE7C,uBAAS,OAAO,IAAI,CAAC,OAAyB,UAAkB;AAC9D,sBAAM,QAAQ,SAAS,KAAK,KAAK;AACjC,oBAAI,OAAO,UAAU,UAAU;AAC7B,6BAAW,MAAM,IAAI,IAAI,cAAc,KAAK;AAAA,gBAC9C,OAAO;AACL,6BAAW,MAAM,IAAI,IAAI;AAAA,gBAC3B;AAAA,cACF,CAAC;AAED,oBAAM,cAAwB;AAAA,gBAC5B,SAAS,SAAS;AAAA,gBAClB,MAAM;AAAA,gBACN,OAAO,SAAS;AAAA,gBAChB,SAAS,OAAO,QAAQ,OAAO;AAAA,gBAC/B,WAAW;AAAA,gBACX,QAAQ;AAAA,cACV;AACA,qBAAO;AAAA,YACT;AAAA,UACF,CAAC,EACA,OAAO,MAAM;AAEhB,kBAAQ,IAAI,gBAAgB,KAAK,UAAU,aAAa,MAAM,CAAC,CAAC,EAAE;AAClE,iBAAO;AAAA,QACT,CAAC;AAAA,MACL,GACA,KAAK;AACP,aAAO;AAAA,IACT,SAAS,IAAI;AACX,YAAM,QAAQ;AACd,cAAQ,IAAI,UAAU,KAAK,OAAO,IAAI,MAAM,MAAM,OAAO,EAAE;AAC3D,YAAM;AAAA,IACR;AAAA,EACF;AACF;","names":[]}

package/dist/node/model.d.cts

@@ -0,0 +1,14 @@
+import { BlockchainWitnessConfig, BlockchainWitnessParams } from '@xyo-network/witness-blockchain-abstract';
+import { JsonFragment } from 'ethers';
+export type Abi = string | ReadonlyArray<JsonFragment | string>;
+export declare const EvmEventsWitnessConfigSchema = "network.xyo.evm.events.witness.config";
+export type EvmEventsWitnessConfigSchema = typeof EvmEventsWitnessConfigSchema;
+export type EvmEventsWitnessConfig = BlockchainWitnessConfig<{
+    abi?: Abi;
+    address?: string;
+    eventName?: string;
+    fromBlock?: number;
+    toBlock?: number;
+}, EvmEventsWitnessConfigSchema>;
+export type EvmEventsWitnessParams = BlockchainWitnessParams<EvmEventsWitnessConfig>;
+//# sourceMappingURL=model.d.ts.map

package/dist/node/model.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAA;AAC3G,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAErC,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG,aAAa,CAAC,YAAY,GAAG,MAAM,CAAC,CAAA;AAE/D,eAAO,MAAM,4BAA4B,0CAA0C,CAAA;AACnF,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAA;AAE9E,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,CAC1D;IACE,GAAG,CAAC,EAAE,GAAG,CAAA;IACT,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,EACD,4BAA4B,CAC7B,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,CAAC,sBAAsB,CAAC,CAAA"}

package/dist/node/model.d.mts

@@ -0,0 +1,14 @@
+import { BlockchainWitnessConfig, BlockchainWitnessParams } from '@xyo-network/witness-blockchain-abstract';
+import { JsonFragment } from 'ethers';
+export type Abi = string | ReadonlyArray<JsonFragment | string>;
+export declare const EvmEventsWitnessConfigSchema = "network.xyo.evm.events.witness.config";
+export type EvmEventsWitnessConfigSchema = typeof EvmEventsWitnessConfigSchema;
+export type EvmEventsWitnessConfig = BlockchainWitnessConfig<{
+    abi?: Abi;
+    address?: string;
+    eventName?: string;
+    fromBlock?: number;
+    toBlock?: number;
+}, EvmEventsWitnessConfigSchema>;
+export type EvmEventsWitnessParams = BlockchainWitnessParams<EvmEventsWitnessConfig>;
+//# sourceMappingURL=model.d.ts.map

package/dist/node/model.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAA;AAC3G,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAErC,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG,aAAa,CAAC,YAAY,GAAG,MAAM,CAAC,CAAA;AAE/D,eAAO,MAAM,4BAA4B,0CAA0C,CAAA;AACnF,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAA;AAE9E,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,CAC1D;IACE,GAAG,CAAC,EAAE,GAAG,CAAA;IACT,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,EACD,4BAA4B,CAC7B,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,CAAC,sBAAsB,CAAC,CAAA"}

package/dist/node/model.d.ts

@@ -0,0 +1,14 @@
+import { BlockchainWitnessConfig, BlockchainWitnessParams } from '@xyo-network/witness-blockchain-abstract';
+import { JsonFragment } from 'ethers';
+export type Abi = string | ReadonlyArray<JsonFragment | string>;
+export declare const EvmEventsWitnessConfigSchema = "network.xyo.evm.events.witness.config";
+export type EvmEventsWitnessConfigSchema = typeof EvmEventsWitnessConfigSchema;
+export type EvmEventsWitnessConfig = BlockchainWitnessConfig<{
+    abi?: Abi;
+    address?: string;
+    eventName?: string;
+    fromBlock?: number;
+    toBlock?: number;
+}, EvmEventsWitnessConfigSchema>;
+export type EvmEventsWitnessParams = BlockchainWitnessParams<EvmEventsWitnessConfig>;
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAA;AAC3G,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAErC,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG,aAAa,CAAC,YAAY,GAAG,MAAM,CAAC,CAAA;AAE/D,eAAO,MAAM,4BAA4B,0CAA0C,CAAA;AACnF,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAA;AAE9E,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,CAC1D;IACE,GAAG,CAAC,EAAE,GAAG,CAAA;IACT,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,EACD,4BAA4B,CAC7B,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,CAAC,sBAAsB,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@xyo-network/evm-events-witness",
+  "author": {
+    "email": "support@xyo.network",
+    "name": "XYO Development Team",
+    "url": "https://xyo.network"
+  },
+  "bugs": {
+    "email": "support@xyo.network",
+    "url": "https://github.com/XYOracleNetwork/plugins/issues"
+  },
+  "dependencies": {
+    "@xylabs/assert": "^2.13.20",
+    "@xylabs/exists": "^2.13.20",
+    "@xylabs/hex": "^2.13.20",
+    "@xyo-network/payload-model": "^2.84.8",
+    "@xyo-network/witness-blockchain-abstract": "^2.84.8",
+    "ethers": "^6.9.0"
+  },
+  "devDependencies": {
+    "@xylabs/jest-helpers": "^2.13.20",
+    "@xylabs/ts-scripts-yarn3": "^3.2.24",
+    "@xylabs/tsconfig": "^3.2.24",
+    "@xyo-network/open-zeppelin-typechain": "^3.0.5",
+    "jest": "^29.7.0",
+    "typescript": "^5.3.3"
+  },
+  "description": "Typescript/Javascript Plugins for XYO Platform",
+  "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/plugins.git"
+  },
+  "sideEffects": false,
+  "version": "2.84.3",
+  "type": "module"
+}

package/src/Payload.ts

@@ -0,0 +1,28 @@
+import { Payload } from '@xyo-network/payload-model'
+
+export const EvmEventsSchema = 'network.xyo.evm.events'
+export type EvmEventsSchema = typeof EvmEventsSchema
+
+export type EvmEvents = Payload<
+  {
+    address?: string
+    eventName?: string
+    fromBlock?: number
+    toBlock?: number
+  },
+  EvmEventsSchema
+>
+
+export const EvmEventSchema = 'network.xyo.evm.event'
+export type EvmEventSchema = typeof EvmEventSchema
+
+export type EvmEvent = Payload<
+  {
+    address: string
+    args: Record<string, unknown>
+    block: number
+    chainId: number
+    eventName: string
+  },
+  EvmEventSchema
+>

package/src/Witness.ts

@@ -0,0 +1,101 @@
+import { assertEx } from '@xylabs/assert'
+import { exists } from '@xylabs/exists'
+import { hexFromBigInt } from '@xylabs/hex'
+import { isPayloadOfSchemaType } from '@xyo-network/payload-model'
+import { AbstractBlockchainWitness } from '@xyo-network/witness-blockchain-abstract'
+import { Contract, EventLog } from 'ethers'
+
+import { EvmEventsWitnessConfigSchema, EvmEventsWitnessParams } from './model'
+import { EvmEvent, EvmEvents, EvmEventSchema, EvmEventsSchema } from './Payload'
+
+const bigIntArrayToHexString = (items: unknown[]) => {
+  return items.map((item) => {
+    if (typeof item === 'bigint') {
+      return hexFromBigInt(item)
+    }
+    return item
+  })
+}
+
+export class EvmEventsWitness<TParams extends EvmEventsWitnessParams = EvmEventsWitnessParams> extends AbstractBlockchainWitness<
+  TParams,
+  EvmEvents,
+  EvmEvent
+> {
+  static override configSchemas = [EvmEventsWitnessConfigSchema]
+
+  get abi() {
+    return assertEx(this.config.abi, 'Missing abi')
+  }
+
+  protected override async observeHandler(inPayloads: EvmEvents[] = []): Promise<EvmEvent[]> {
+    await this.started('throw')
+    //calling it here to make sure we rests the cache
+    await this.getProviders()
+    try {
+      const observations = (
+        await Promise.all(
+          inPayloads
+            .filter(isPayloadOfSchemaType<EvmEvents>(EvmEventsSchema))
+            .map(async ({ eventName, address, fromBlock: payloadFromBlock, toBlock: payloadToBlock }) => {
+              const validatedAddress = assertEx(address ?? this.config.address, 'Missing address')
+              const validatedEventName = assertEx(eventName ?? this.config.eventName, 'Missing eventName')
+
+              const provider = await this.getProvider(true, true)
+              const network = await provider.getNetwork()
+
+              const contract = new Contract(validatedAddress, this.abi, provider)
+
+              const abiArray = assertEx(Array.isArray(this.abi) ? this.abi : undefined, 'Abi is not an array')
+
+              const abiEvent = assertEx(
+                abiArray.find((entry) => entry.type === 'event' && entry.name === validatedEventName),
+                'Could not find event',
+              )
+
+              const fromBlock = this.config.fromBlock ?? payloadFromBlock ?? contract.deploymentTransaction()?.blockNumber ?? undefined
+              const toBlock = this.config.toBlock ?? payloadToBlock ?? (await provider.getBlockNumber())
+
+              const rawEvents = await contract.queryFilter(contract.filters[validatedEventName], fromBlock, toBlock)
+
+              const observation = rawEvents
+                .map((rawLog) => {
+                  const rawEvent = rawLog as EventLog
+                  if (rawEvent.args) {
+                    const argsObject: Record<string, unknown> = {}
+
+                    abiEvent.inputs.map((input: { name: string }, index: number) => {
+                      const value = rawEvent.args[index]
+                      if (typeof value === 'bigint') {
+                        argsObject[input.name] = hexFromBigInt(value)
+                      } else {
+                        argsObject[input.name] = value
+                      }
+                    })
+
+                    const eventResult: EvmEvent = {
+                      address: rawEvent.address,
+                      args: argsObject,
+                      block: rawEvent.blockNumber,
+                      chainId: Number(network.chainId),
+                      eventName: validatedEventName,
+                      schema: EvmEventSchema,
+                    }
+                    return eventResult
+                  }
+                })
+                .filter(exists)
+
+              console.log(`observation: ${JSON.stringify(observation, null, 2)}`)
+              return observation
+            }),
+        )
+      ).flat()
+      return observations
+    } catch (ex) {
+      const error = ex as Error
+      console.log(`Error [${this.config.name}]: ${error.message}`)
+      throw error
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './model'
+export * from './Payload'
+export * from './Witness'

package/src/model.ts

@@ -0,0 +1,20 @@
+import { BlockchainWitnessConfig, BlockchainWitnessParams } from '@xyo-network/witness-blockchain-abstract'
+import { JsonFragment } from 'ethers'
+
+export type Abi = string | ReadonlyArray<JsonFragment | string>
+
+export const EvmEventsWitnessConfigSchema = 'network.xyo.evm.events.witness.config'
+export type EvmEventsWitnessConfigSchema = typeof EvmEventsWitnessConfigSchema
+
+export type EvmEventsWitnessConfig = BlockchainWitnessConfig<
+  {
+    abi?: Abi
+    address?: string
+    eventName?: string
+    fromBlock?: number
+    toBlock?: number
+  },
+  EvmEventsWitnessConfigSchema
+>
+
+export type EvmEventsWitnessParams = BlockchainWitnessParams<EvmEventsWitnessConfig>