feat: implement get events

packages/automated-dispute/src/exceptions/decodeLogDataFailure.ts

@@ -0,0 +1,7 @@
+export class DecodeLogDataFailure extends Error {
+    constructor(err: unknown) {
+        super(`Error decoding log data: ${err}`);
+
+        this.name = "DecodeLogDataFailure";
+    }
+}

packages/automated-dispute/src/exceptions/index.ts

@@ -14,3 +14,5 @@ export * from "./invalidRequestBody.exception.js";
 export * from "./invalidRequester.exception.js";
 export * from "./transactionExecutionError.exception.js";
 export * from "./invalidAccountOnClient.exception.js";
+export * from "./unsupportedEvent.exception.js";
+export * from "./decodeLogDataFailure.js";

packages/automated-dispute/src/exceptions/unsupportedEvent.exception.ts

@@ -0,0 +1,6 @@
+export class UnsupportedEvent extends Error {
+    constructor(message: string) {
+        super(message);
+        this.name = "UnsupportedEvent";
+    }
+}

packages/automated-dispute/src/interfaces/protocolProvider.ts

@@ -1,6 +1,15 @@
+import { Caip2ChainId } from "@ebo-agent/blocknumber";
 import { Address } from "viem";
 
-import type { Dispute, EboEvent, EboEventName, Epoch, Request, Response } from "../types/index.js";
+import type {
+    Dispute,
+    EboEvent,
+    EboEventName,
+    Epoch,
+    Request,
+    RequestId,
+    Response,
+} from "../types/index.js";
 import { ProtocolContractsNames } from "../constants.js";
 
 export type ProtocolContract = (typeof ProtocolContractsNames)[number];
@@ -177,3 +186,89 @@ export interface IProtocolProvider {
      */
     read: IReadProvider;
 }
+
+/**
+ * @interface DecodedLogArgsMap
+ * Represents the mapping of event names to their respective argument structures.
+ */
+export interface DecodedLogArgsMap {
+    /**
+     * Event arguments for the RequestCreated event.
+     * @property {RequestId} requestId - The ID of the request.
+     * @property {bigint} epoch - The epoch time when the request was created.
+     * @property {Caip2ChainId} chainId - The chain ID where the request was created.
+     */
+    RequestCreated: {
+        requestId: RequestId;
+        epoch: bigint;
+        chainId: Caip2ChainId;
+    };
+
+    /**
+     * Event arguments for the ResponseProposed event.
+     * @property {RequestId} requestId - The ID of the request.
+     * @property {string} responseId - The ID of the response.
+     * @property {string} response - The response content.
+     * @property {bigint} blockNumber - The block number when the response was proposed.
+     */
+    ResponseProposed: {
+        requestId: RequestId;
+        responseId: string;
+        response: string;
+        blockNumber: bigint;
+    };
+
+    /**
+     * Event arguments for the ResponseDisputed event.
+     * @property {string} responseId - The ID of the response.
+     * @property {string} disputeId - The ID of the dispute.
+     * @property {string} dispute - The dispute content.
+     * @property {bigint} blockNumber - The block number when the dispute was raised.
+     */
+    ResponseDisputed: {
+        responseId: string;
+        disputeId: string;
+        dispute: string;
+        blockNumber: bigint;
+    };
+
+    /**
+     * Event arguments for the DisputeStatusChanged event.
+     * @property {string} disputeId - The ID of the dispute.
+     * @property {string} dispute - The dispute content.
+     * @property {number} status - The new status of the dispute.
+     * @property {bigint} blockNumber - The block number when the dispute status changed.
+     */
+    DisputeStatusChanged: {
+        disputeId: string;
+        dispute: string;
+        status: number;
+        blockNumber: bigint;
+    };
+
+    /**
+     * Event arguments for the DisputeEscalated event.
+     * @property {string} caller - The address of the caller who escalated the dispute.
+     * @property {string} disputeId - The ID of the dispute.
+     * @property {bigint} blockNumber - The block number when the dispute was escalated.
+     */
+    DisputeEscalated: {
+        caller: string;
+        disputeId: string;
+        blockNumber: bigint;
+    };
+
+    /**
+     * Event arguments for the RequestFinalized event.
+     * @property {RequestId} requestId - The ID of the request.
+     * @property {string} responseId - The ID of the response.
+     * @property {string} caller - The address of the caller who finalized the request.
+     * @property {bigint} blockNumber - The block number when the request was finalized.
+     */
+    RequestFinalized: {
+        requestId: RequestId;
+        responseId: string;
+        caller: string;
+        blockNumber: bigint;
+    };
+}