feat(relayer): extract HyperlaneRelayer into standalone @hyperlane-xyz/relayer package

Author: paulbalaji

.changeset/separate-relayer-package.md

@@ -0,0 +1,20 @@
+---
+"@hyperlane-xyz/relayer": minor
+"@hyperlane-xyz/cli": minor
+"@hyperlane-xyz/sdk": minor
+"@hyperlane-xyz/infra": patch
+---
+
+Extracted relayer into dedicated `@hyperlane-xyz/relayer` package
+
+- Moved `HyperlaneRelayer` class from SDK to new package
+- Moved ISM metadata builders from SDK to relayer package
+- New package supports both manual CLI execution and continuous daemon mode for K8s deployments
+- Added Prometheus metrics support with `/metrics` endpoint (enabled by default on port 9090)
+- CLI and infra now import from new package
+- **Breaking**: The following exports were removed from `@hyperlane-xyz/sdk` and are now available from `@hyperlane-xyz/relayer`:
+  - `HyperlaneRelayer`, `RelayerCacheSchema`, `messageMatchesWhitelist`
+  - `BaseMetadataBuilder`, `decodeIsmMetadata`
+  - All metadata builder classes (`AggregationMetadataBuilder`, `MultisigMetadataBuilder`, etc.)
+- `offchainLookupRequestMessageHash` remains exported from SDK for ccip-server compatibility
+- Added `randomDeployableIsmConfig` test utility to SDK for generating deployable ISM configs with custom validators

.github/actions/docker-image-comment/action.yml

@@ -51,6 +51,7 @@ runs:
             ["rebalancer"]="♻️"
             ["warp-monitor"]="🕵️"
             ["key-funder"]="🔑"
+            ["ts-relayer"]="🚀"
             ["offchain-lookup-server"]="🔍"
             ["monorepo"]="📦"
           )

.github/workflows/node-services-docker.yml

@@ -11,6 +11,7 @@ on:
       - 'typescript/warp-monitor/**'
       - 'typescript/ccip-server/**'
       - 'typescript/keyfunder/**'
+      - 'typescript/relayer/**'
       - 'typescript/Dockerfile.node-service'
       - 'pnpm-lock.yaml'
       - '.github/workflows/node-services-docker.yml'
@@ -127,6 +128,7 @@ jobs:
           ${REGISTRY}/hyperlane-rebalancer:${TAG_SHA_DATE}
           ${REGISTRY}/hyperlane-warp-monitor:${TAG_SHA_DATE}
           ${REGISTRY}/hyperlane-key-funder:${TAG_SHA_DATE}
+          ${REGISTRY}/hyperlane-ts-relayer:${TAG_SHA_DATE}
           ${REGISTRY}/hyperlane-offchain-lookup-server:${TAG_SHA_DATE}
           EOF
           )
@@ -143,6 +145,7 @@ jobs:
           | ♻️ rebalancer | \`${TAG_SHA_DATE}\` |
           | 🕵️ warp-monitor | \`${TAG_SHA_DATE}\` |
           | 🔑 key-funder | \`${TAG_SHA_DATE}\` |
+          | 🚀 ts-relayer | \`${TAG_SHA_DATE}\` |
           | 🔍 offchain-lookup-server | \`${TAG_SHA_DATE}\` |
 
           **Full image paths:**

Dockerfile

@@ -39,6 +39,7 @@ COPY typescript/keyfunder/package.json ./typescript/keyfunder/
 COPY typescript/provider-sdk/package.json ./typescript/provider-sdk/
 COPY typescript/radix-sdk/package.json ./typescript/radix-sdk/
 COPY typescript/rebalancer/package.json ./typescript/rebalancer/
+COPY typescript/relayer/package.json ./typescript/relayer/
 COPY typescript/sdk/package.json ./typescript/sdk/
 COPY typescript/tsconfig/package.json ./typescript/tsconfig/
 COPY typescript/utils/package.json ./typescript/utils/

pnpm-lock.yaml

@@ -19,6 +19,7 @@
     "@hyperlane-xyz/provider-sdk": "workspace:*",
     "@hyperlane-xyz/radix-sdk": "workspace:*",
     "@hyperlane-xyz/rebalancer": "workspace:*",
+    "@hyperlane-xyz/relayer": "workspace:*",
     "@hyperlane-xyz/registry": "catalog:",
     "@hyperlane-xyz/sdk": "workspace:*",
     "@hyperlane-xyz/tsconfig": "workspace:^",

typescript/cli/package.json

@@ -1,9 +1,5 @@
-import {
-  type ChainMap,
-  HyperlaneCore,
-  HyperlaneRelayer,
-  RelayerCacheSchema,
-} from '@hyperlane-xyz/sdk';
+import { HyperlaneRelayer, RelayerCacheSchema } from '@hyperlane-xyz/relayer';
+import { type ChainMap, HyperlaneCore } from '@hyperlane-xyz/sdk';
 import { type Address } from '@hyperlane-xyz/utils';
 
 import { type CommandModuleWithContext } from '../context/types.js';

typescript/cli/src/commands/relayer.ts

@@ -1,11 +1,8 @@
 import { stringify as yamlStringify } from 'yaml';
 
 import { GasAction } from '@hyperlane-xyz/provider-sdk';
-import {
-  type ChainName,
-  HyperlaneCore,
-  HyperlaneRelayer,
-} from '@hyperlane-xyz/sdk';
+import { HyperlaneRelayer } from '@hyperlane-xyz/relayer';
+import { type ChainName, HyperlaneCore } from '@hyperlane-xyz/sdk';
 import { ProtocolType, addressToBytes32, timeout } from '@hyperlane-xyz/utils';
 
 import { EXPLORER_URL } from '../consts.js';

typescript/cli/src/send/message.ts

@@ -1,11 +1,11 @@
 import type { TransactionReceipt } from '@ethersproject/providers';
 import { input } from '@inquirer/prompts';
 
+import { HyperlaneRelayer } from '@hyperlane-xyz/relayer';
 import {
   type ChainName,
   type DispatchedMessage,
   HyperlaneCore,
-  HyperlaneRelayer,
 } from '@hyperlane-xyz/sdk';
 
 import {

typescript/cli/src/status/message.ts

@@ -1,11 +1,11 @@
 import { type TransactionReceipt } from '@ethersproject/providers';
 
 import { type IRegistry } from '@hyperlane-xyz/registry';
+import { HyperlaneRelayer } from '@hyperlane-xyz/relayer';
 import {
   type DispatchedMessage,
   HookType,
   HyperlaneCore,
-  HyperlaneRelayer,
   type MultiProvider,
   type TxSubmitterBuilder,
   TxSubmitterType,