feat: cctp hook type (#8649)

Co-authored-by: claude[bot] <209825114+claude[bot]@users.noreply.github.com>

Author: troykessler

.changeset/mean-papayas-dance.md

@@ -0,0 +1,5 @@
+---
+"@hyperlane-xyz/sdk": minor
+---
+
+Added CCTP hook type

typescript/sdk/src/hook/EvmHookModule.ts

@@ -810,6 +810,14 @@ export class EvmHookModule extends HyperlaneModule<
         return this.deployAmountRoutingHook({ config });
       case HookType.CCIP:
         return this.deployCCIPHook({ config });
+      case HookType.CCTP:
+        // TODO: https://github.com/hyperlane-xyz/hyperlane-monorepo/issues/3773
+        // we can remove the ts-ignore once we have a proper type for address Hooks
+        // @ts-ignore
+        return IPostDispatchHook__factory.connect(
+          config.address,
+          this.multiProvider.getSignerOrProvider(this.args.chain),
+        );
       default:
         throw new Error(`Unsupported hook config: ${config}`);
     }

typescript/sdk/src/hook/EvmHookReader.ts

@@ -179,6 +179,10 @@ export class EvmHookReader extends HyperlaneReader implements HookReader {
           derivedHookConfig = { type: HookType.PREDICATE, address };
           this._cache.set(address, derivedHookConfig);
           break;
+        case OnchainHookType.CCTP:
+          derivedHookConfig = { type: HookType.CCTP, address };
+          this._cache.set(address, derivedHookConfig);
+          break;
         default:
           throw new Error(
             `Unsupported HookType: ${OnchainHookType[onchainHookType]}`,

typescript/sdk/src/hook/types.ts

@@ -52,6 +52,12 @@ export const HookType = {
   ARB_L2_TO_L1: 'arbL2ToL1Hook',
   MAILBOX_DEFAULT: 'defaultHook',
   CCIP: 'ccipHook',
+  /**
+   * References a pre-deployed CCTP hook by address. Excluded from
+   * `DeployableHookType` — not deployed via `HyperlaneHookDeployer`; the
+   * `EvmHookModule.deploy` path just connects to `config.address`.
+   */
+  CCTP: 'cctpHook',
   UNKNOWN: 'unknownHook',
   PREDICATE: 'predicateHook',
 } as const;
@@ -60,7 +66,10 @@ export type HookType = (typeof HookType)[keyof typeof HookType];
 
 export type DeployableHookType = Exclude<
   HookType,
-  typeof HookType.CUSTOM | typeof HookType.PREDICATE | typeof HookType.UNKNOWN
+  | typeof HookType.CUSTOM
+  | typeof HookType.PREDICATE
+  | typeof HookType.UNKNOWN
+  | typeof HookType.CCTP
 >;
 
 export const HookTypeToContractNameMap: Record<DeployableHookType, string> = {
@@ -220,6 +229,12 @@ export const CCIPHookSchema = z.object({
   destinationChain: z.string(),
 });
 
+export const CctpHookSchema = z.object({
+  type: z.literal(HookType.CCTP),
+  address: ZHash,
+});
+export type CctpHookConfig = z.infer<typeof CctpHookSchema>;
+
 export const UnknownHookSchema = z
   .object({
     type: z.literal(HookType.UNKNOWN),
@@ -282,6 +297,7 @@ export const HookConfigSchema = z.union([
   ArbL2ToL1HookSchema,
   MailboxDefaultHookSchema,
   CCIPHookSchema,
+  CctpHookSchema,
   UnknownHookSchema,
   PredicateHookSchema,
 ]);

typescript/sdk/src/test/testUtils.ts

@@ -135,6 +135,7 @@ export const hookTypesToFilter: HookType[] = [
   HookType.CUSTOM,
   HookType.PREDICATE,
   HookType.CCIP,
+  HookType.CCTP,
   HookType.UNKNOWN,
 ];
 export const DEFAULT_TOKEN_DECIMALS = 18;