@layerzerolabs/lz-definitions 3.0.14 → 3.0.16

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @layerzerolabs/lz-definitions
 
+## 3.0.16
+
+### Patch Changes
+
+- 87a4bc9: islander mainnet
+
+## 3.0.15
+
+### Patch Changes
+
+- 67856bd: endpoints
+
 ## 3.0.14
 
 ### Patch Changes

package/README.md

@@ -0,0 +1,376 @@
+# @layerzerolabs/lz-definitions
+
+The LayerZero Definitions package provides a comprehensive set of type definitions and utilities for interacting with various blockchains. It includes enums, types, and interfaces that facilitate the development and integration of applications with the LayerZero protocol.
+
+## Features
+
+- **Enums**: Provides a set of enums representing various blockchain-related constants.
+- **Types**: Defines various types used across the LayerZero protocol.
+- **Interfaces**: Provides interfaces for different blockchain specifications and configurations.
+- **Utilities**: Includes utility functions for converting and handling blockchain-related data.
+
+## Installation
+
+To install the LayerZero Definitions package, you can use npm or yarn:
+
+```sh
+npm install @layerzerolabs/lz-definitions
+```
+
+or
+
+```sh
+yarn add @layerzerolabs/lz-definitions
+```
+
+## Utilities
+
+### networkToEndpointId
+
+```typescript
+import {
+  networkToEndpointId,
+  EndpointVersion,
+  EndpointId,
+} from "@layerzerolabs/lz-definitions";
+
+// Converts a network name and version to an endpoint ID.
+const endpointId: EndpointId = networkToEndpointId(
+  "ethereum-mainnet",
+  EndpointVersion.V1,
+);
+console.log(endpointId);
+```
+
+### networkToEnv
+
+```typescript
+import {
+  networkToEnv,
+  EndpointVersion,
+  Environment,
+} from "@layerzerolabs/lz-definitions";
+
+// Converts a network name and version to an environment.
+const environment: Environment = networkToEnv(
+  "ethereum-mainnet",
+  EndpointVersion.V1,
+);
+console.log(environment);
+```
+
+### networkToStage
+
+```typescript
+import { networkToStage, Stage } from "@layerzerolabs/lz-definitions";
+
+// Converts a network name to a stage.
+const stage: Stage = networkToStage("ethereum-mainnet");
+console.log(stage);
+```
+
+### endpointIdToNetwork
+
+```typescript
+import {
+  endpointIdToNetwork,
+  Environment,
+  Network,
+  SandboxV2EndpointId,
+} from "@layerzerolabs/lz-definitions";
+
+// Converts an endpoint ID to a network name.
+const network: Network = endpointIdToNetwork(
+  SandboxV2EndpointId.APTOS_V2_SANDBOX,
+  Environment.MAINNET,
+);
+console.log(network);
+```
+
+### endpointIdToVersion
+
+```typescript
+import {
+  endpointIdToVersion,
+  EndpointVersion,
+  SandboxV2EndpointId,
+} from "@layerzerolabs/lz-definitions";
+
+// Converts an endpoint ID to an endpoint version.
+const version: EndpointVersion = endpointIdToVersion(
+  SandboxV2EndpointId.APTOS_V2_SANDBOX,
+);
+console.log(version);
+```
+
+### endpointIdToChainKey
+
+```typescript
+import {
+  endpointIdToChainKey,
+  ChainKey,
+  SandboxV2EndpointId,
+} from "@layerzerolabs/lz-definitions";
+
+// Converts an endpoint ID to a chain key.
+const chainKey: ChainKey = endpointIdToChainKey(
+  SandboxV2EndpointId.APTOS_V2_SANDBOX,
+);
+console.log(chainKey);
+```
+
+### chainAndStageToEndpointId
+
+```typescript
+import {
+  chainAndStageToEndpointId,
+  Chain,
+  Stage,
+  EndpointVersion,
+  EndpointId,
+} from "@layerzerolabs/lz-definitions";
+
+// Converts a chain and stage to an endpoint ID.
+const endpointId: EndpointId = chainAndStageToEndpointId(
+  Chain.ETHEREUM,
+  Stage.MAINNET,
+  EndpointVersion.V1,
+);
+console.log(endpointId);
+```
+
+### chainAndStageToNetwork
+
+```typescript
+import {
+  chainAndStageToNetwork,
+  Chain,
+  Stage,
+  Network,
+} from "@layerzerolabs/lz-definitions";
+
+// Converts a chain and stage to a network name.
+const network: Network = chainAndStageToNetwork(Chain.ETHEREUM, Stage.MAINNET);
+console.log(network);
+```
+
+### endpointSpecToNetwork
+
+```typescript
+import {
+  endpointSpecToNetwork,
+  EndpointSpec,
+  Network,
+} from "@layerzerolabs/lz-definitions";
+
+const spec: EndpointSpec = {
+  chain: Chain.ETHEREUM,
+  stage: Stage.MAINNET,
+  version: EndpointVersion.V1,
+  env: Environment.MAINNET,
+};
+
+// Converts an endpoint specification to a network name.
+const network: Network = endpointSpecToNetwork(spec);
+console.log(network);
+```
+
+### endpointSpecToEnv
+
+```typescript
+import {
+  endpointSpecToEnv,
+  EndpointSpec,
+  Environment,
+} from "@layerzerolabs/lz-definitions";
+
+const spec: EndpointSpec = {
+  chain: Chain.ETHEREUM,
+  stage: Stage.MAINNET,
+  version: EndpointVersion.V1,
+  env: Environment.MAINNET,
+};
+
+// Converts an endpoint specification to an environment.
+const environment: Environment = endpointSpecToEnv(spec);
+console.log(environment);
+```
+
+### endpointSpecToEndpointId
+
+```typescript
+import {
+  endpointSpecToEndpointId,
+  EndpointSpec,
+  EndpointId,
+} from "@layerzerolabs/lz-definitions";
+
+const spec: EndpointSpec = {
+  chain: Chain.ETHEREUM,
+  stage: Stage.MAINNET,
+  version: EndpointVersion.V1,
+  env: Environment.MAINNET,
+};
+
+// Converts an endpoint specification to an endpoint ID.
+const endpointId: EndpointId = endpointSpecToEndpointId(spec);
+console.log(endpointId);
+```
+
+### endpointIdToEndpointSpec
+
+```typescript
+import {
+  endpointIdToEndpointSpec,
+  EndpointId,
+  EndpointSpec,
+  Environment,
+  SandboxV2EndpointId,
+} from "@layerzerolabs/lz-definitions";
+
+// Converts an endpoint ID and environment to an endpoint specification.
+const spec: EndpointSpec = endpointIdToEndpointSpec(
+  SandboxV2EndpointId.APTOS_V2_SANDBOX,
+  Environment.MAINNET,
+);
+console.log(spec);
+```
+
+### networkToChain
+
+```typescript
+import { networkToChain, Chain } from "@layerzerolabs/lz-definitions";
+
+// Converts a network name to a chain.
+const chain: Chain = networkToChain("ethereum-mainnet");
+console.log(chain);
+```
+
+### networkToChainType
+
+```typescript
+import { networkToChainType, ChainType } from "@layerzerolabs/lz-definitions";
+
+// Converts a network name to a chain type.
+const chainType: ChainType = networkToChainType("ethereum-mainnet");
+console.log(chainType);
+```
+
+### chainToChainType
+
+```typescript
+import {
+  chainToChainType,
+  Chain,
+  ChainType,
+} from "@layerzerolabs/lz-definitions";
+
+// Returns the chain type for a given chain.
+const chainType: ChainType = chainToChainType(Chain.ETHEREUM);
+console.log(chainType);
+```
+
+### endpointIdToChain
+
+```typescript
+import {
+  endpointIdToChain,
+  Chain,
+  SandboxV2EndpointId,
+} from "@layerzerolabs/lz-definitions";
+
+// Converts an endpoint ID to a chain.
+const chain: Chain = endpointIdToChain(SandboxV2EndpointId.APTOS_V2_SANDBOX);
+console.log(chain);
+```
+
+### endpointIdToStage
+
+```typescript
+import {
+  endpointIdToStage,
+  Stage,
+  SandboxV2EndpointId,
+} from "@layerzerolabs/lz-definitions";
+
+// Converts an endpoint ID to a stage.
+const stage: Stage = endpointIdToStage(SandboxV2EndpointId.APTOS_V2_SANDBOX);
+console.log(stage);
+```
+
+### endpointIdToChainType
+
+```typescript
+import {
+  endpointIdToChainType,
+  ChainType,
+  SandboxV2EndpointId,
+} from "@layerzerolabs/lz-definitions";
+
+// Converts an endpoint ID to a chain type.
+const chainType: ChainType = endpointIdToChainType(
+  SandboxV2EndpointId.APTOS_V2_SANDBOX,
+);
+console.log(chainType);
+```
+
+### getNetworksForStage
+
+```typescript
+import { getNetworksForStage, Stage } from "@layerzerolabs/lz-definitions";
+
+// Gets the networks for a given stage.
+const networks: string[] = getNetworksForStage(Stage.MAINNET);
+console.log(networks);
+```
+
+### getChainIdForNetwork
+
+```typescript
+import { getChainIdForNetwork } from "@layerzerolabs/lz-definitions";
+
+// Gets the chain ID for a given network.
+const chainId: string = getChainIdForNetwork("ethereum", "mainnet", "1.0.0");
+console.log(chainId);
+```
+
+### getNetworkForChainId
+
+```typescript
+import {
+  getNetworkForChainId,
+  Chain,
+  Stage,
+  SandboxV2EndpointId,
+} from "@layerzerolabs/lz-definitions";
+
+// Gets the network for a given chain ID.
+const networkInfo = getNetworkForChainId(SandboxV2EndpointId.APTOS_V2_SANDBOX);
+console.log(networkInfo.chainName, networkInfo.env, networkInfo.ulnVersion);
+```
+
+### isNetworkEndpointIdSupported
+
+```typescript
+import {
+  isNetworkEndpointIdSupported,
+  EndpointVersion,
+} from "@layerzerolabs/lz-definitions";
+
+// Checks if a network endpoint ID is supported.
+const isSupported: boolean = isNetworkEndpointIdSupported(
+  "ethereum-mainnet",
+  EndpointVersion.V1,
+);
+console.log(isSupported);
+```
+
+### isEvmChain
+
+```typescript
+import { isEvmChain, Chain } from "@layerzerolabs/lz-definitions";
+
+// Determines if a chain is EVM based.
+const isEvm: boolean = isEvmChain(Chain.ETHEREUM);
+console.log(isEvm);
+```

package/dist/index.cjs

@@ -187,6 +187,7 @@ var EvmChain = /* @__PURE__ */ ((EvmChain2) => {
   EvmChain2["MOKSHA"] = "moksha";
   EvmChain2["EDU"] = "edu";
   EvmChain2["CITREA"] = "citrea";
+  EvmChain2["ISLANDER"] = "islander";
   return EvmChain2;
 })(EvmChain || {});
 
@@ -337,6 +338,7 @@ var MainnetEndpointId = /* @__PURE__ */ ((MainnetEndpointId2) => {
   MainnetEndpointId2[MainnetEndpointId2["SUPERPOSITION_MAINNET"] = 327] = "SUPERPOSITION_MAINNET";
   MainnetEndpointId2[MainnetEndpointId2["EDU_MAINNET"] = 328] = "EDU_MAINNET";
   MainnetEndpointId2[MainnetEndpointId2["HEMI_MAINNET"] = 329] = "HEMI_MAINNET";
+  MainnetEndpointId2[MainnetEndpointId2["ISLANDER_MAINNET"] = 330] = "ISLANDER_MAINNET";
   return MainnetEndpointId2;
 })(MainnetEndpointId || {});
 var TestnetEndpointId = /* @__PURE__ */ ((TestnetEndpointId2) => {
@@ -624,6 +626,7 @@ var MainnetV2EndpointId = /* @__PURE__ */ ((MainnetV2EndpointId2) => {
   MainnetV2EndpointId2[MainnetV2EndpointId2["EDU_V2_MAINNET"] = 30328] = "EDU_V2_MAINNET";
   MainnetV2EndpointId2[MainnetV2EndpointId2["TON_V2_MAINNET"] = 30343] = "TON_V2_MAINNET";
   MainnetV2EndpointId2[MainnetV2EndpointId2["HEMI_V2_MAINNET"] = 30329] = "HEMI_V2_MAINNET";
+  MainnetV2EndpointId2[MainnetV2EndpointId2["ISLANDER_V2_MAINNET"] = 30330] = "ISLANDER_V2_MAINNET";
   return MainnetV2EndpointId2;
 })(MainnetV2EndpointId || {});
 var TestnetV2EndpointId = /* @__PURE__ */ ((TestnetV2EndpointId2) => {
@@ -1139,6 +1142,7 @@ var ChainKey = /* @__PURE__ */ ((ChainKey3) => {
   ChainKey3["HEMI_TESTNET"] = "hemi-testnet";
   ChainKey3["HEMI"] = "hemi";
   ChainKey3["CITREA_TESTNET"] = "citrea-testnet";
+  ChainKey3["ISLANDER"] = "islander";
   return ChainKey3;
 })(ChainKey || {});
 
@@ -1257,6 +1261,7 @@ var CHAIN_KEY = {
   [EndpointId.SUPERPOSITION_MAINNET]: "superposition" /* SUPERPOSITION */,
   [EndpointId.EDU_MAINNET]: "edu" /* EDU */,
   [EndpointId.HEMI_MAINNET]: "hemi" /* HEMI */,
+  [EndpointId.ISLANDER_MAINNET]: "islander" /* ISLANDER */,
   // v2 mainnet
   [EndpointId.ETHEREUM_V2_MAINNET]: "ethereum" /* ETHEREUM */,
   [EndpointId.BSC_V2_MAINNET]: "bsc" /* BSC */,
@@ -1366,6 +1371,7 @@ var CHAIN_KEY = {
   [EndpointId.SUPERPOSITION_V2_MAINNET]: "superposition" /* SUPERPOSITION */,
   [EndpointId.EDU_V2_MAINNET]: "edu" /* EDU */,
   [EndpointId.HEMI_V2_MAINNET]: "hemi" /* HEMI */,
+  [EndpointId.ISLANDER_V2_MAINNET]: "islander" /* ISLANDER */,
   [EndpointId.TON_V2_MAINNET]: "ton" /* TON */,
   // testnet
   [EndpointId.ETHEREUM_TESTNET]: "sepolia" /* SEPOLIA */,
@@ -1823,6 +1829,7 @@ var ENVIRONMENT = {
   [EndpointId.SUPERPOSITION_MAINNET]: "mainnet" /* MAINNET */,
   [EndpointId.EDU_MAINNET]: "mainnet" /* MAINNET */,
   [EndpointId.HEMI_MAINNET]: "mainnet" /* MAINNET */,
+  [EndpointId.ISLANDER_MAINNET]: "mainnet" /* MAINNET */,
   // v2 mainnet
   [EndpointId.ETHEREUM_V2_MAINNET]: "mainnet" /* MAINNET */,
   [EndpointId.BSC_V2_MAINNET]: "mainnet" /* MAINNET */,
@@ -1932,6 +1939,7 @@ var ENVIRONMENT = {
   [EndpointId.SUPERPOSITION_V2_MAINNET]: "mainnet" /* MAINNET */,
   [EndpointId.EDU_V2_MAINNET]: "mainnet" /* MAINNET */,
   [EndpointId.HEMI_V2_MAINNET]: "mainnet" /* MAINNET */,
+  [EndpointId.ISLANDER_V2_MAINNET]: "mainnet" /* MAINNET */,
   [EndpointId.TON_V2_MAINNET]: "mainnet" /* MAINNET */,
   // testnet
   [EndpointId.ETHEREUM_TESTNET]: "testnet" /* TESTNET */,
@@ -2392,7 +2400,7 @@ function networkToChain(network) {
 }
 function networkToChainType(network) {
   const chain = networkToChain(network);
-  return getChainType(chain);
+  return chainToChainType(chain);
 }
 function chainToChainType(chain) {
   switch (chain) {
@@ -2439,7 +2447,7 @@ function endpointIdToStage(endpointId) {
 }
 function endpointIdToChainType(endpointId) {
   const chain = endpointIdToChain(endpointId);
-  return getChainType(chain);
+  return chainToChainType(chain);
 }
 function getNetworksForStage(stage) {
   const networks = [];
@@ -2517,16 +2525,16 @@ function isTronChain(chain) {
   return chain === Chain.TRON || chain === Chain.TRONDEV;
 }
 function isEvmChain(chain) {
-  return getChainType(chain) === "evm" /* EVM */;
+  return chainToChainType(chain) === "evm" /* EVM */;
 }
 function isAptosChain(chain) {
-  return getChainType(chain) === "aptos" /* APTOS */;
+  return chainToChainType(chain) === "aptos" /* APTOS */;
 }
 function isSolanaChain(chain) {
-  return getChainType(chain) === "solana" /* SOLANA */;
+  return chainToChainType(chain) === "solana" /* SOLANA */;
 }
 function isInitiaChain(chain) {
-  return getChainType(chain) === "initia" /* INITIA */;
+  return chainToChainType(chain) === "initia" /* INITIA */;
 }
 function isChain(value) {
   return Object.values(Chain).includes(value);
@@ -2557,9 +2565,23 @@ var chainSpecConfig = {
   }
 };
 var ChainSpecs = class {
+  /**
+   * Gets the address size in bytes for a given chain.
+   *
+   * @param {Chain} chain - The chain.
+   * @returns {number} The address size in bytes.
+   */
   static getAddressSizeInBytes(chain) {
     return this.getChainSpec(getChainType(chain), chain).addressSizeInBytes;
   }
+  /**
+   * Gets the chain specification for a given chain type and chain.
+   *
+   * @param {ChainType} chainType - The type of the chain.
+   * @param {Chain | 'default'} chain - The chain or 'default'.
+   * @returns {ChainSpec} The chain specification.
+   * @throws {Error} If the configuration for the chain type is not found.
+   */
   static getChainSpec(chainType, chain) {
     if (chainSpecConfig[chainType] === void 0) {
       throw new Error(`config for ${chainType} not found in staticConfig`);