hak-layerzero-plugin

A Hedera Agent Kit plugin that enables AI agents to send cross-chain messages and query fees between Hedera and 150+ EVM chains via LayerZero V2.

Overview

LayerZero is a battle-tested omnichain interoperability protocol active on 150+ chains, including Hedera mainnet (since October 2024). This plugin fills the cross-chain gap in the Hedera DeFi agent stack — alongside hak-saucerswap-plugin (DEX), hak-stader-plugin (liquid staking), and hak-pyth-plugin (price feeds).

Installation

npm install hak-layerzero-plugin

Quick Start

import HederaAgentKit from "@hashgraph/hedera-agent-kit";
import layerzeroPlugin, { LAYERZERO_TESTNET } from "hak-layerzero-plugin";

const agent = new HederaAgentKit({
  // ... your HAK config
  plugins: [layerzeroPlugin],
  pluginConfig: {
    layerzero: {
      ...LAYERZERO_TESTNET,           // spreads endpointAddress, endpointId, rpcUrl, scanApiUrl
      network: "testnet",
      privateKey: process.env.HEDERA_PRIVATE_KEY,
    },
  },
});

Mainnet:

import { LAYERZERO_MAINNET } from "hak-layerzero-plugin";

pluginConfig: {
  layerzero: {
    ...LAYERZERO_MAINNET,
    network: "mainnet",
    privateKey: process.env.HEDERA_PRIVATE_KEY,
  },
}

Using only environment variables (no inline config):

LAYERZERO_NETWORK=testnet
HEDERA_PRIVATE_KEY=0xYOUR_ECDSA_KEY

Network defaults are applied automatically.

Important: Your Hedera account must use an ECDSA (secp256k1) key. Native ED25519 keys cannot sign EVM transactions. See Hedera docs for details.

Available Tools

Tool	Type	Description
layerzero_get_supported_chains	Query	Lists all EVM chains reachable from Hedera via LayerZero with their EIDs
layerzero_get_message_fee	Query	Estimates the native fee to send a cross-chain message
layerzero_send_message	Transaction	Sends a message from your OApp contract on Hedera to a destination chain
layerzero_get_message_status	Query	Checks delivery status (INFLIGHT / DELIVERED / FAILED) by tx hash or GUID

See docs/TOOLS.md for full parameter reference and example prompts.

Example Agent Prompts

"What chains can I reach from Hedera via LayerZero?"

"How much would it cost to send a message from Hedera to Arbitrum (EID 30110)?"

"Send the message 'Hello Arbitrum' to address 0xABC...123 on Arbitrum One from
 my OApp at 0xDEF...456. Use gas limit 200000."

"Check the status of my LayerZero message with tx hash 0xdeadbeef..."

Network Defaults

	Mainnet	Testnet
Hedera Chain ID	295	296
LayerZero EID	30316	40285
EndpointV2 Address	0x3A73033C0b1407574C76BdBAc67f126f6b4a9AA9	0xbD672D1562Dd32C23B563C989d8140122483631d
JSON-RPC (Hashio)	https://mainnet.hashio.io/api	https://testnet.hashio.io/api

Source: LayerZero address book

Supported Destination Chains (sample)

Chain	Mainnet EID	Testnet EID
Ethereum	30101	40161 (Sepolia)
BNB Chain	30102	40102
Avalanche	30106	40106 (Fuji)
Polygon	30109	40109
Arbitrum One	30110	40231
Optimism	30111	40232
Base	30184	40245
Linea	30183	—
zkSync	30165	40305
Scroll	30214	40170

Full list: use layerzero_get_supported_chains or see LayerZero docs.

OApp Requirement

LayerZero messages must originate from a deployed OApp (Omnichain Application) smart contract. There is no universal relay. Your OApp must:

1. Be deployed on Hedera using the OApp standard
2. Have setPeer() configured pointing to the receiver contract on the destination chain
3. Have DVN and executor options configured

Supply your OApp's EVM address as the oappAddress parameter to layerzero_send_message.

For a quickstart OApp, see the Hedera × LayerZero example.

Configuration

See docs/CONFIGURATION.md for all settings, environment variables, and precedence rules.

License

MIT — Juanma Gomez