Skip to main content
The LayerZero Endpoint Metadata provides a comprehensive JSON snapshot of all the key information needed to build and analyze crosschain applications. This metadata includes details such as deployments, tokens, RPC endpoints, chain information, and more for each supported chain.

​
Overview

  • Location:
    The metadata is typically available at:
  • Structure:
    The JSON object is organized by chain keys (for example, "ethereum", "bsc", "polygon", etc.). Each top-level key corresponds to a chain and maps to an object that contains various sub-fields, including:
    • Deployments: Information about bridging contracts for LayerZero V1 (such as endpoint, relayerV2, and ultraLightNodeV2) and for LayerZero V2 (endpointV2, executor, SendUln302, etc.).
    • RPCs: A list of RPC endpoints for interacting with the chain.
    • Chain Details: Core data including chainType, nativeChainId, and details of the native currency.
    • DVNs: A dictionary of Decentralized Verifier Networks, used for ensuring the integrity of crosschain messages.
    • Tokens: A mapping of token addresses deployed using LayerZero to details such as symbol, decimals, and, optionally, pegging information.
    • Address to OApp: A lookup for known DApps by their onchain addresses.
    • Other Fields: Including environment (e.g., "mainnet" or "testnet"), blockExplorers, and chainName.

​
Use Cases

Developers and applications can leverage this metadata to:
  • Dynamically configure applications:
    Automatically set bridging addresses, tokens, and RPC endpoints based on the current network configuration.
  • Display chain information:
    Provide end users with up-to-date details like block explorer links, native currency information, and more.
  • Validate local configurations:
    Ensure that your application’s onchain references match the official metadata.

​
Typical Metadata Fields

Each chain’s metadata object usually includes: This metadata is a vital resource for ensuring your application interacts with the correct chain configurations and remains in sync with official deployments.