# @layerzerolabs/lz-v2-utilities

> LayerZero Utility V2

Latest version **3.0.168** (published 2026-04-15) · BUSL-1.1 license · 0 weekly downloads

## Install

```sh
npm install @layerzerolabs/lz-v2-utilities
pnpm add @layerzerolabs/lz-v2-utilities
yarn add @layerzerolabs/lz-v2-utilities
bun add @layerzerolabs/lz-v2-utilities
```

## Health

**Score 60/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 3.0.168 |
| Published | 2026-04-15 |
| First published | 2024-01-10 |
| Weekly downloads | 0 |
| License | BUSL-1.1 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 8 |
| Unpacked size | 395.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | layerzero-bot |

## Links

- npm: https://www.npmjs.com/package/@layerzerolabs/lz-v2-utilities
- npm.io page: https://npm.io/package/@layerzerolabs/lz-v2-utilities

## Dependencies (8)

- [bs58](https://npm.io/package/bs58.md) ^5.0.0
- [tiny-invariant](https://npm.io/package/tiny-invariant.md) ^1.3.1
- [@ethersproject/abi](https://npm.io/package/@ethersproject/abi.md) ^5.8.0
- [@ethersproject/bytes](https://npm.io/package/@ethersproject/bytes.md) ^5.8.0
- [@ethersproject/address](https://npm.io/package/@ethersproject/address.md) ^5.8.0
- [@ethersproject/solidity](https://npm.io/package/@ethersproject/solidity.md) ^5.8.0
- [@ethersproject/bignumber](https://npm.io/package/@ethersproject/bignumber.md) ^5.8.0
- [@ethersproject/keccak256](https://npm.io/package/@ethersproject/keccak256.md) ^5.8.0

## Recent versions

- 3.0.168 (latest) — 2026-04-15
- 3.0.141-iota.0 (iota) — 2025-10-21
- 3.0.137-sui.0 (sui) — 2025-10-02
- 3.0.125-placeholder.2 (placeholder) — 2025-08-26
- 3.0.122-ton.0 (dev) — 2025-08-06
- 3.0.113-aptos.0 (aptos) — 2025-07-17
- 3.0.105-mpt.0 (mpt) — 2025-06-19
- 3.0.75-test.0 (test) — 2025-03-03
- 3.0.68-ton.0 (ton) — 2025-02-13
- 3.0.21-movement.0 (movement) — 2024-12-02
- 3.0.20-move.0 (move) — 2024-11-29
- 3.0.2-initia.5 (initia) — 2024-10-09
- 2.0.12-tron-rc.3 (tron) — 2024-01-18
- 3.0.167 — 2026-03-20
- 3.0.166 — 2026-03-18
- … 363 more at https://npm.io/package/@layerzerolabs/lz-v2-utilities/versions

## README

# @layerzerolabs/lz-v2-utilities

The LayerZero V2 Utilities package provides a set of essential utilities and modules to facilitate the development and integration of applications with various blockchain networks. It includes functions for packet encoding/decoding, precrime configuration parsing, error parsing, and more.

## Features

- **Packet Encoding/Decoding**: Functions for encoding and decoding packets.
- **Precrime Configuration Parsing**: Functions for parsing precrime configurations.
- **Error Parsing**: Functions for parsing error data.
- **Hex Utilities**: Functions for handling hexadecimal data.
- **Options Management**: Functions for managing options.

## Installation

To install the LayerZero V2 Utilities package, you can use npm or yarn:

```sh
npm install @layerzerolabs/lz-v2-utilities
```

or

```sh
yarn add @layerzerolabs/lz-v2-utilities
```

## Usage

### Packet Encoding/Decoding

#### PacketV1Codec

Encodes and decodes packets using the V1 codec.

```typescript
import { PacketV1Codec } from "@layerzerolabs/lz-v2-utilities";

const packet = {
    version: 1,
    nonce: '1',
    srcEid: 10121,
    sender: '0x7Cff4181f857B06114643D495648A95b3E0B0B81',
    dstEid: 10108,
    receiver: '0x6552e1c444f6a2ce35b22de6a554da8c32c5650db0e0158df2eb0daa51289968',
    guid: '0x6552e1c444f6a2ce35b22de6a554da8c32c5650db0e0158df2eb0daa51289968',
    message: '0xff',
    payload: '',
};

// Encode the packet
const encodedHex = PacketV1Codec.encode(packet);
console.log(`Encoded Packet: ${encodedHex}`);

// Decode the packet
const decodedPacket = PacketV1Codec.from(encodedHex).toPacket();
console.log(`Decoded Packet: ${JSON.stringify(decodedPacket)}`);
```

### Precrime Configuration Parsing

#### parsePrecrimeConfig

Parses the precrime configuration string.

```typescript
import { parsePrecrimeConfig } from "@layerzerolabs/lz-v2-utilities";

const configHex = '0x0002000000000000000500010000000100000000000000000000000000000000000000000000000000000000000111110000000000000000000000000000000000000000000000000000000000011111';

const config = parsePrecrimeConfig(configHex);
console.log(`Parsed Precrime Config: ${JSON.stringify(config)}`);
```

### Error Parsing

#### parseError

Parses the error data.

```typescript
import { parseError } from "@layerzerolabs/lz-v2-utilities";
import { Interface } from "@ethersproject/abi";

const errorData = "0x08c379a0...";
const intf = new Interface(["function myFunction()"]);

const parsedError = parseError(errorData, intf);
console.log(`Parsed Error: ${parsedError}`);
```

### Hex Utilities

#### hexZeroPadTo32

Pads a hexadecimal address to 32 bytes.

```typescript
import { hexZeroPadTo32 } from "@layerzerolabs/lz-v2-utilities";

const address = "0x1234567890abcdef1234567890abcdef12345678";
const paddedAddress = hexZeroPadTo32(address);
console.log(`Padded Address: ${paddedAddress}`);
```

### Options Management

#### optionsType1

Builds OptionsType.TYPE_1.

```typescript
import { optionsType1 } from "@layerzerolabs/lz-v2-utilities";

const extraGas = 200000;
const options = optionsType1(extraGas);
console.log(`Options Type 1: ${options}`);
```

---
_Source: https://npm.io/package/@layerzerolabs/lz-v2-utilities · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
