@arbilink/sdk 0.1.0

package/dist/utils.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeCall = encodeCall;
+exports.formatMessageId = formatMessageId;
+exports.statusLabel = statusLabel;
+exports.resolveChainId = resolveChainId;
+exports.estimateDeliveryTime = estimateDeliveryTime;
+exports.parseStatusCode = parseStatusCode;
+exports.formatEth = formatEth;
+const viem_1 = require("viem");
+const constants_1 = require("./constants");
+// ── Encoding helpers ──────────────────────────────────────────────────────────
+/**
+ * Encode a contract function call into hex calldata ready for cross-chain delivery.
+ *
+ * @example
+ * ```typescript
+ * const data = encodeCall({
+ *   abi: parseAbi(['function mint(address to, uint256 amount)']),
+ *   functionName: 'mint',
+ *   args: ['0x742d35Cc...', 1000n],
+ * });
+ * ```
+ */
+function encodeCall(params) {
+    return (0, viem_1.encodeFunctionData)({
+        abi: params.abi,
+        functionName: params.functionName,
+        args: params.args ?? [],
+    });
+}
+// ── Formatting ────────────────────────────────────────────────────────────────
+/**
+ * Format a numeric message ID as a zero-padded string.
+ * @example formatMessageId(42n) → "#000042"
+ */
+function formatMessageId(id) {
+    return `#${id.toString().padStart(6, '0')}`;
+}
+/**
+ * Human-readable label for a message status.
+ */
+function statusLabel(status) {
+    const labels = {
+        pending: 'Pending',
+        relayed: 'Relayed (in challenge window)',
+        confirmed: 'Confirmed',
+        failed: 'Failed',
+    };
+    return labels[status];
+}
+// ── Chain helpers ─────────────────────────────────────────────────────────────
+/**
+ * Resolve a chain name or numeric ID to a numeric chain ID.
+ * Throws `ArbiLinkError` for unknown chains.
+ */
+function resolveChainId(chain) {
+    if (typeof chain === 'number')
+        return chain;
+    const id = constants_1.CHAIN_IDS[chain.toLowerCase()];
+    if (id == null) {
+        throw new Error(`Unknown chain "${chain}". Supported names: ${Object.keys(constants_1.CHAIN_IDS).join(', ')}`);
+    }
+    return id;
+}
+/**
+ * Estimate message delivery time in seconds for a given destination chain.
+ *
+ * This is a rough heuristic based on block times – actual delivery depends on
+ * relayer availability and the 5-minute challenge window.
+ */
+function estimateDeliveryTime(chainId) {
+    const CHALLENGE_WINDOW = 300; // 5 min in seconds
+    const FINALITY_TIMES = {
+        11155111: 15, // Ethereum Sepolia
+        84532: 2, // Base Sepolia
+        80002: 2, // Polygon Amoy
+        11155420: 2, // Optimism Sepolia
+    };
+    return CHALLENGE_WINDOW + (FINALITY_TIMES[chainId] ?? 12);
+}
+// ── Status helpers ────────────────────────────────────────────────────────────
+const STATUS_MAP = ['pending', 'relayed', 'confirmed', 'failed'];
+/**
+ * Convert the on-chain numeric status code to the SDK string representation.
+ */
+function parseStatusCode(code) {
+    return STATUS_MAP[code] ?? 'pending';
+}
+// ── Wei helpers ───────────────────────────────────────────────────────────────
+/**
+ * Format a wei value as a human-readable ETH string.
+ * @example formatEth(1_000_000_000_000_000n) → "0.001 ETH"
+ */
+function formatEth(wei) {
+    const eth = Number(wei) / 1e18;
+    return `${eth.toFixed(6).replace(/\.?0+$/, '')} ETH`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;AAkBA,gCAUC;AAQD,0CAEC;AAKD,kCAQC;AAQD,wCAUC;AAQD,oDAWC;AASD,0CAEC;AAQD,8BAGC;AA9GD,+BAAoD;AAEpD,2CAAwC;AAExC,iFAAiF;AAEjF;;;;;;;;;;;GAWG;AACH,SAAgB,UAAU,CAAC,MAI1B;IACC,OAAO,IAAA,yBAAkB,EAAC;QACxB,GAAG,EAAW,MAAM,CAAC,GAAG;QACxB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,IAAI,EAAU,MAAM,CAAC,IAAI,IAAI,EAAE;KAChC,CAAW,CAAC;AACf,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,SAAgB,eAAe,CAAC,EAAU;IACxC,OAAO,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,MAAqB;IAC/C,MAAM,MAAM,GAAkC;QAC5C,OAAO,EAAI,SAAS;QACpB,OAAO,EAAI,+BAA+B;QAC1C,SAAS,EAAE,WAAW;QACtB,MAAM,EAAK,QAAQ;KACpB,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,SAAgB,cAAc,CAAC,KAAsB;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5C,MAAM,EAAE,GAAG,qBAAS,CAAC,KAAK,CAAC,WAAW,EAA4B,CAAC,CAAC;IACpE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,kBAAkB,KAAK,uBAAuB,MAAM,CAAC,IAAI,CAAC,qBAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,OAAe;IAClD,MAAM,gBAAgB,GAAG,GAAG,CAAC,CAAC,mBAAmB;IAEjD,MAAM,cAAc,GAA2B;QAC7C,QAAQ,EAAE,EAAE,EAAG,mBAAmB;QAClC,KAAK,EAAK,CAAC,EAAI,eAAe;QAC9B,KAAK,EAAK,CAAC,EAAI,eAAe;QAC9B,QAAQ,EAAE,CAAC,EAAI,mBAAmB;KACnC,CAAC;IAEF,OAAO,gBAAgB,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,GAAoB,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;AAElF;;GAEG;AACH,SAAgB,eAAe,CAAC,IAAY;IAC1C,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;AACvC,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,SAAgB,SAAS,CAAC,GAAW;IACnC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAC/B,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC;AACvD,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@arbilink/sdk",
+  "version": "0.1.0",
+  "description": "Cross-chain messaging SDK for Arbitrum — send messages to any chain with one function call",
+  "keywords": [
+    "arbitrum",
+    "cross-chain",
+    "messaging",
+    "bridge",
+    "stylus",
+    "web3"
+  ],
+  "license": "MIT",
+  "author": "ArbiLink",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Martins-O/ArbiLink.git",
+    "directory": "packages/sdk"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "ethers": "^6.9.0",
+    "viem": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "ethers": "^6.9.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "build:watch": "tsc --project tsconfig.json --watch",
+    "clean": "rm -rf dist",
+    "type-check": "tsc --noEmit"
+  }
+}

package/src/ArbiLink.ts

@@ -0,0 +1,301 @@
+import { ethers } from 'ethers';
+import MessageHubABI from './abi/MessageHub.json';
+import { MESSAGE_HUB_ADDRESS } from './constants';
+import { ArbiLinkError, type Message, type MessageStatus, type SendMessageParams, type WatchOptions } from './types';
+import { parseStatusCode, resolveChainId } from './utils';
+
+// ── ArbiLink SDK ──────────────────────────────────────────────────────────────
+
+/**
+ * ArbiLink SDK — send cross-chain messages from Arbitrum to any supported chain.
+ *
+ * @example
+ * ```typescript
+ * // With a signer (full read/write access)
+ * const arbiLink = new ArbiLink(signer);
+ *
+ * // With a provider (read-only: getMessageStatus, calculateFee)
+ * const arbiLink = new ArbiLink(provider);
+ * ```
+ */
+export class ArbiLink {
+  private readonly provider: ethers.Provider;
+  private readonly signer: ethers.Signer | null;
+  private readonly messageHub: ethers.Contract;
+  private readonly iface: ethers.Interface;
+
+  constructor(signerOrProvider: ethers.Signer | ethers.Provider) {
+    // Distinguish signer from provider: signers expose `getAddress()`
+    const isSigner = typeof (signerOrProvider as ethers.Signer).getAddress === 'function';
+
+    if (isSigner) {
+      this.signer = signerOrProvider as ethers.Signer;
+      const p = this.signer.provider;
+      if (!p) throw new ArbiLinkError('Signer has no attached provider. Connect your signer to a network first.');
+      this.provider = p;
+    } else {
+      this.signer   = null;
+      this.provider = signerOrProvider as ethers.Provider;
+    }
+
+    this.iface = new ethers.Interface(MessageHubABI);
+
+    this.messageHub = new ethers.Contract(
+      MESSAGE_HUB_ADDRESS,
+      MessageHubABI,
+      isSigner ? this.signer! : this.provider,
+    );
+  }
+
+  // ── Core: send ─────────────────────────────────────────────────────────────
+
+  /**
+   * Send a cross-chain message from Arbitrum to any supported chain.
+   *
+   * @returns The message ID assigned by the hub.
+   *
+   * @example
+   * ```typescript
+   * const arbiLink = new ArbiLink(signer);
+   *
+   * const messageId = await arbiLink.sendMessage({
+   *   to: 'ethereum',
+   *   target: '0x742d35Cc6634C0532925a3b844BC454e4438f44e',
+   *   data: encodeCall({
+   *     abi: myABI,
+   *     functionName: 'mint',
+   *     args: [recipient, amount],
+   *   }),
+   * });
+   *
+   * console.log('Sent:', formatMessageId(messageId)); // → "#000001"
+   * ```
+   */
+  async sendMessage(params: SendMessageParams): Promise<bigint> {
+    this.requireSigner();
+
+    const chainId = resolveChainId(params.to);
+    const fee     = params.fee ?? await this.calculateFee(chainId);
+
+    let tx: ethers.TransactionResponse;
+    try {
+      tx = await this.messageHub.sendMessage(
+        chainId,
+        params.target,
+        params.data,
+        { value: fee },
+      ) as ethers.TransactionResponse;
+    } catch (err) {
+      throw ArbiLinkError.from(err, `Failed to send message to chain ${chainId}`);
+    }
+
+    const receipt = await tx.wait();
+    if (!receipt) throw new ArbiLinkError('Transaction receipt is null – the tx may have been dropped');
+
+    // Parse MessageSent event to extract the assigned message ID
+    for (const log of receipt.logs) {
+      try {
+        const parsed = this.iface.parseLog({ topics: [...log.topics], data: log.data });
+        if (parsed?.name === 'MessageSent') {
+          return parsed.args.messageId as bigint;
+        }
+      } catch {
+        // Log from a different contract – skip
+      }
+    }
+
+    throw new ArbiLinkError(
+      'MessageSent event not found in receipt. The transaction may have succeeded but used an unexpected hub version.',
+    );
+  }
+
+  // ── Core: status ───────────────────────────────────────────────────────────
+
+  /**
+   * Query the current status and metadata of a message.
+   *
+   * Fetches the status code from the hub and enriches it with data from
+   * `MessageSent` and `MessageConfirmed` event logs.
+   *
+   * @example
+   * ```typescript
+   * const msg = await arbiLink.getMessageStatus(messageId);
+   * console.log(msg.status);           // 'pending' | 'confirmed'
+   * console.log(msg.destinationChain); // 11155111
+   * ```
+   */
+  async getMessageStatus(messageId: bigint): Promise<Message> {
+    try {
+      const statusCode = await this.messageHub.getMessageStatus(messageId) as bigint;
+      const status: MessageStatus = parseStatusCode(Number(statusCode));
+
+      // Enrich from MessageSent event
+      const sentFilter = this.messageHub.filters['MessageSent'](messageId);
+      const sentLogs   = await this.messageHub.queryFilter(sentFilter);
+
+      let sender: string | undefined;
+      let destinationChain: number | undefined;
+      let target: string | undefined;
+      let data: string | undefined;
+      let feePaid: bigint | undefined;
+
+      if (sentLogs.length > 0) {
+        const e = sentLogs[0] as ethers.EventLog;
+        sender           = e.args.sender           as string;
+        destinationChain = Number(e.args.destinationChain);
+        target           = e.args.target           as string;
+        data             = e.args.data             as string;
+        feePaid          = e.args.fee              as bigint;
+      }
+
+      // Enrich from MessageConfirmed event (present only when confirmed)
+      let relayer: string | undefined;
+      if (status === 'confirmed' || status === 'relayed') {
+        const confirmedFilter = this.messageHub.filters['MessageConfirmed'](messageId);
+        const confirmedLogs   = await this.messageHub.queryFilter(confirmedFilter);
+        if (confirmedLogs.length > 0) {
+          relayer = (confirmedLogs[0] as ethers.EventLog).args.relayer as string;
+        }
+      }
+
+      return {
+        id: messageId,
+        status,
+        sender,
+        destinationChain,
+        target,
+        data,
+        feePaid,
+        relayer,
+      };
+    } catch (err) {
+      throw ArbiLinkError.from(err, `Failed to fetch status for message #${messageId}`);
+    }
+  }
+
+  // ── Core: fee ──────────────────────────────────────────────────────────────
+
+  /**
+   * Fetch the base fee (in wei) required to send a message to `chainId`.
+   *
+   * @example
+   * ```typescript
+   * const fee = await arbiLink.calculateFee(11155111);
+   * console.log(formatEth(fee)); // "0.001 ETH"
+   * ```
+   */
+  async calculateFee(chainId: number): Promise<bigint> {
+    try {
+      return await this.messageHub.calculateFee(chainId) as bigint;
+    } catch (err) {
+      throw ArbiLinkError.from(err, `Failed to fetch fee for chain ${chainId}`);
+    }
+  }
+
+  // ── Core: watch ────────────────────────────────────────────────────────────
+
+  /**
+   * Subscribe to confirmation events for a given message.
+   *
+   * The callback fires when a `MessageConfirmed` event is emitted for this
+   * message ID. Call the returned function to unsubscribe.
+   *
+   * @example
+   * ```typescript
+   * const unwatch = arbiLink.watchMessage(messageId, (msg) => {
+   *   console.log('Update:', msg.status);
+   *   if (msg.status === 'confirmed') unwatch();
+   * });
+   * ```
+   */
+  watchMessage(
+    messageId: bigint,
+    callback: (message: Message) => void,
+    _options: WatchOptions = {},
+  ): () => void {
+    const confirmedFilter = this.messageHub.filters['MessageConfirmed'](messageId);
+
+    const listener = async (): Promise<void> => {
+      try {
+        const msg = await this.getMessageStatus(messageId);
+        callback(msg);
+      } catch (err) {
+        // Surface the error through the callback rather than throwing from
+        // an event listener (which would be silently swallowed by ethers)
+        console.error('[ArbiLink] watchMessage error:', err);
+      }
+    };
+
+    this.messageHub.on(confirmedFilter, listener);
+
+    return () => {
+      this.messageHub.off(confirmedFilter, listener);
+    };
+  }
+
+  // ── Relayer helpers ────────────────────────────────────────────────────────
+
+  /**
+   * Check whether `address` is a registered, active relayer.
+   */
+  async isActiveRelayer(address: string): Promise<boolean> {
+    return await this.messageHub.isActiveRelayer(address) as boolean;
+  }
+
+  /**
+   * Register the signer as a relayer by staking the required ETH.
+   * Fetches the minimum stake from the hub automatically.
+   *
+   * @param stakeOverride - Override the minimum stake amount (wei).
+   */
+  async registerRelayer(stakeOverride?: bigint): Promise<void> {
+    this.requireSigner();
+
+    const stake = stakeOverride ?? await this.messageHub.minStake() as bigint;
+
+    const tx = await this.messageHub.registerRelayer({ value: stake }) as ethers.TransactionResponse;
+    await tx.wait();
+  }
+
+  /**
+   * Withdraw the signer's relayer stake and deregister.
+   */
+  async exitRelayer(): Promise<void> {
+    this.requireSigner();
+    const tx = await this.messageHub.exitRelayer() as ethers.TransactionResponse;
+    await tx.wait();
+  }
+
+  // ── Hub info ───────────────────────────────────────────────────────────────
+
+  /**
+   * Total number of messages sent through the hub.
+   */
+  async messageCount(): Promise<bigint> {
+    return await this.messageHub.messageCount() as bigint;
+  }
+
+  /**
+   * The hub owner address.
+   */
+  async owner(): Promise<string> {
+    return await this.messageHub.owner() as string;
+  }
+
+  /**
+   * Minimum stake (wei) required to register as a relayer.
+   */
+  async minStake(): Promise<bigint> {
+    return await this.messageHub.minStake() as bigint;
+  }
+
+  // ── Private helpers ────────────────────────────────────────────────────────
+
+  private requireSigner(): void {
+    if (!this.signer) {
+      throw new ArbiLinkError(
+        'This operation requires a Signer. Initialize ArbiLink with an ethers.Signer instead of a Provider.',
+      );
+    }
+  }
+}

package/src/abi/MessageHub.json

@@ -0,0 +1,156 @@
+[
+  {
+    "type": "function",
+    "name": "initialize",
+    "inputs": [
+      { "name": "min_stake",        "type": "uint256" },
+      { "name": "challenge_period", "type": "uint256" }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "sendMessage",
+    "inputs": [
+      { "name": "destination_chain", "type": "uint32"  },
+      { "name": "target",            "type": "address" },
+      { "name": "data",              "type": "bytes"   }
+    ],
+    "outputs": [{ "name": "", "type": "uint256" }],
+    "stateMutability": "payable"
+  },
+  {
+    "type": "function",
+    "name": "confirmDelivery",
+    "inputs": [
+      { "name": "message_id", "type": "uint256" },
+      { "name": "_proof",     "type": "bytes"   }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "registerRelayer",
+    "inputs": [],
+    "outputs": [],
+    "stateMutability": "payable"
+  },
+  {
+    "type": "function",
+    "name": "exitRelayer",
+    "inputs": [],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "addChain",
+    "inputs": [
+      { "name": "chain_id",         "type": "uint32"  },
+      { "name": "receiver_address", "type": "address" },
+      { "name": "base_fee",         "type": "uint256" }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "getMessageStatus",
+    "inputs": [{ "name": "message_id", "type": "uint256" }],
+    "outputs": [{ "name": "", "type": "uint8" }],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "calculateFee",
+    "inputs": [{ "name": "destination_chain", "type": "uint32" }],
+    "outputs": [{ "name": "", "type": "uint256" }],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "isActiveRelayer",
+    "inputs": [{ "name": "relayer", "type": "address" }],
+    "outputs": [{ "name": "", "type": "bool" }],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "messageCount",
+    "inputs": [],
+    "outputs": [{ "name": "", "type": "uint256" }],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "owner",
+    "inputs": [],
+    "outputs": [{ "name": "", "type": "address" }],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "minStake",
+    "inputs": [],
+    "outputs": [{ "name": "", "type": "uint256" }],
+    "stateMutability": "view"
+  },
+  {
+    "type": "event",
+    "name": "MessageSent",
+    "inputs": [
+      { "name": "messageId",        "type": "uint256", "indexed": true  },
+      { "name": "sender",           "type": "address", "indexed": true  },
+      { "name": "destinationChain", "type": "uint32",  "indexed": false },
+      { "name": "target",           "type": "address", "indexed": false },
+      { "name": "data",             "type": "bytes",   "indexed": false },
+      { "name": "fee",              "type": "uint256", "indexed": false }
+    ]
+  },
+  {
+    "type": "event",
+    "name": "MessageConfirmed",
+    "inputs": [
+      { "name": "messageId",  "type": "uint256", "indexed": true  },
+      { "name": "relayer",    "type": "address", "indexed": true  },
+      { "name": "timestamp",  "type": "uint256", "indexed": false }
+    ]
+  },
+  {
+    "type": "event",
+    "name": "RelayerRegistered",
+    "inputs": [
+      { "name": "relayer", "type": "address", "indexed": true  },
+      { "name": "stake",   "type": "uint256", "indexed": false }
+    ]
+  },
+  {
+    "type": "event",
+    "name": "RelayerExited",
+    "inputs": [
+      { "name": "relayer",  "type": "address", "indexed": true  },
+      { "name": "returned", "type": "uint256", "indexed": false }
+    ]
+  },
+  {
+    "type": "event",
+    "name": "ChainAdded",
+    "inputs": [
+      { "name": "chainId",  "type": "uint32",  "indexed": true  },
+      { "name": "receiver", "type": "address", "indexed": false },
+      { "name": "baseFee",  "type": "uint256", "indexed": false }
+    ]
+  },
+  { "type": "error", "name": "ChainNotSupported",  "inputs": [{ "name": "chainId",   "type": "uint32"  }] },
+  { "type": "error", "name": "InsufficientFee",    "inputs": [{ "name": "required",  "type": "uint256" }, { "name": "provided", "type": "uint256" }] },
+  { "type": "error", "name": "MessageNotFound",    "inputs": [{ "name": "messageId", "type": "uint256" }] },
+  { "type": "error", "name": "InsufficientStake",  "inputs": [{ "name": "required",  "type": "uint256" }, { "name": "provided", "type": "uint256" }] },
+  { "type": "error", "name": "Unauthorized",       "inputs": [{ "name": "caller",    "type": "address" }] },
+  { "type": "error", "name": "RelayerNotActive",   "inputs": [{ "name": "relayer",   "type": "address" }] },
+  { "type": "error", "name": "AlreadyRelayed",     "inputs": [{ "name": "messageId", "type": "uint256" }] },
+  { "type": "error", "name": "TransferFailed",     "inputs": [] },
+  { "type": "error", "name": "ZeroAddress",        "inputs": [] },
+  { "type": "error", "name": "AlreadyInitialized", "inputs": [] }
+]