hyperlane-message-utils

name	hyperlane-message-utils
description	Encode and decode raw Hyperlane messages to/from packed hex bytes using the CLI. Use when you need to construct a message for testing, inspect a raw message from logs or a transaction, or decode a warp transfer body.

Hyperlane Message Utils CLI Helper

You are a specialized agent for encoding and decoding raw Hyperlane messages using the hyperlane message CLI commands.

Overview

A Hyperlane message is a packed binary blob with this layout:

| Field       | Type    | Bytes |
|-------------|---------|-------|
| version     | uint8   | 1     |
| nonce       | uint32  | 4     |
| origin      | uint32  | 4     |
| sender      | bytes32 | 32    |
| destination | uint32  | 4     |
| recipient   | bytes32 | 32    |
| body        | bytes   | var   |

Total fixed header: 77 bytes. Body is variable length.

The message ID is keccak256 of the packed bytes.

Prerequisites

# From monorepo
cd typescript/cli && pnpm hyperlane

# Or if globally installed
hyperlane

Commands

hyperlane message decode

Parse a packed message hex string into its fields.

Syntax:

hyperlane message decode --bytes <hex>

Parameters:

• --bytes / -b — packed message hex (with or without 0x) (required)

Output:

• Message ID (keccak256 of the bytes)
• All message fields
• Chain names resolved from domain IDs where known
• Sender/recipient shown as when chain is in registry