feat: add foundation of error handling logic (#51)

apps/agent/src/config/schemas.ts

@@ -1,5 +1,4 @@
-import { Caip2Utils } from "@ebo-agent/blocknumber";
-import { Caip2ChainId } from "@ebo-agent/blocknumber/dist/types.js";
+import { Caip2ChainId, Caip2Utils } from "@ebo-agent/blocknumber/src/index.js";
 import { isAddress, isHex } from "viem";
 import { z } from "zod";
 

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

@@ -0,0 +1,67 @@
+import {
+    EboEvent,
+    EboEventName,
+    ErrorContext,
+    ErrorHandlingStrategy,
+    ErrorName,
+} from "../types/index.js";
+
+export class CustomContractError extends Error {
+    public override name: ErrorName;
+    public strategy: ErrorHandlingStrategy;
+    public context!: ErrorContext;
+    private customActions: Map<ErrorName, (context: ErrorContext) => Promise<void> | void> =
+        new Map();
+
+    constructor(name: ErrorName, strategy: ErrorHandlingStrategy) {
+        super(`Contract reverted: ${name}`);
+        this.name = name;
+        this.strategy = strategy;
+    }
+
+    public setContext(context: ErrorContext): this {
+        this.context = context;
+        return this;
+    }
+
+    public getContext(): ErrorContext {
+        return this.context;
+    }
+
+    /**
+     * Sets the context specific to processEvents.
+     * This method replaces addContext for processEvents-related context updates.
+     *
+     * @param event The event being processed.
+     * @param reenqueueEvent Callback to reenqueue the event.
+     * @param terminateActor Callback to terminate the actor.
+     * @returns The error instance.
+     */
+    public setProcessEventsContext(
+        event: EboEvent<EboEventName>,
+        reenqueueEvent: () => void,
+        terminateActor: () => void,
+    ): this {
+        this.context = {
+            ...this.context,
+            event,
+            reenqueueEvent,
+            terminateActor,
+        };
+        return this;
+    }
+
+    public on(errorName: string, action: (context: ErrorContext) => Promise<void> | void): this {
+        if (this.name === errorName) {
+            this.customActions.set(errorName, action);
+        }
+        return this;
+    }
+
+    public async executeCustomAction(): Promise<void> {
+        const action = this.customActions.get(this.name) || this.strategy.customAction;
+        if (action) {
+            await action(this.context);
+        }
+    }
+}