@layerzerolabs/lz-definitions 3.0.15 → 3.0.17

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @layerzerolabs/lz-definitions
 
+## 3.0.17
+
+### Patch Changes
+
+- 40f2269: islander mainnet
+- 40f2269: testnets
+
+## 3.0.16
+
+### Patch Changes
+
+- 87a4bc9: islander mainnet
+
 ## 3.0.15
 
 ### 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

@@ -188,6 +188,8 @@ var EvmChain = /* @__PURE__ */ ((EvmChain2) => {
   EvmChain2["EDU"] = "edu";
   EvmChain2["CITREA"] = "citrea";
   EvmChain2["ISLANDER"] = "islander";
+  EvmChain2["BL3"] = "bl3";
+  EvmChain2["MP1"] = "mp1";
   return EvmChain2;
 })(EvmChain || {});
 
@@ -500,6 +502,8 @@ var TestnetEndpointId = /* @__PURE__ */ ((TestnetEndpointId2) => {
   TestnetEndpointId2[TestnetEndpointId2["SOPHON_TESTNET"] = 10341] = "SOPHON_TESTNET";
   TestnetEndpointId2[TestnetEndpointId2["MOKSHA_TESTNET"] = 10342] = "MOKSHA_TESTNET";
   TestnetEndpointId2[TestnetEndpointId2["CITREA_TESTNET"] = 10344] = "CITREA_TESTNET";
+  TestnetEndpointId2[TestnetEndpointId2["MP1_TESTNET"] = 10345] = "MP1_TESTNET";
+  TestnetEndpointId2[TestnetEndpointId2["BL3_TESTNET"] = 10346] = "BL3_TESTNET";
   return TestnetEndpointId2;
 })(TestnetEndpointId || {});
 var SandboxEndpointId = /* @__PURE__ */ ((SandboxEndpointId2) => {
@@ -789,6 +793,8 @@ var TestnetV2EndpointId = /* @__PURE__ */ ((TestnetV2EndpointId2) => {
   TestnetV2EndpointId2[TestnetV2EndpointId2["MOKSHA_V2_TESTNET"] = 40342] = "MOKSHA_V2_TESTNET";
   TestnetV2EndpointId2[TestnetV2EndpointId2["TON_V2_TESTNET"] = 40343] = "TON_V2_TESTNET";
   TestnetV2EndpointId2[TestnetV2EndpointId2["CITREA_V2_TESTNET"] = 40344] = "CITREA_V2_TESTNET";
+  TestnetV2EndpointId2[TestnetV2EndpointId2["MP1_V2_TESTNET"] = 40345] = "MP1_V2_TESTNET";
+  TestnetV2EndpointId2[TestnetV2EndpointId2["BL3_V2_TESTNET"] = 40346] = "BL3_V2_TESTNET";
   return TestnetV2EndpointId2;
 })(TestnetV2EndpointId || {});
 var SandboxV2EndpointId = /* @__PURE__ */ ((SandboxV2EndpointId2) => {
@@ -1143,6 +1149,8 @@ var ChainKey = /* @__PURE__ */ ((ChainKey3) => {
   ChainKey3["HEMI"] = "hemi";
   ChainKey3["CITREA_TESTNET"] = "citrea-testnet";
   ChainKey3["ISLANDER"] = "islander";
+  ChainKey3["BL3_TESTNET"] = "bl3-testnet";
+  ChainKey3["MP1_TESTNET"] = "mp1-testnet";
   return ChainKey3;
 })(ChainKey || {});
 
@@ -1532,6 +1540,8 @@ var CHAIN_KEY = {
   [EndpointId.SOPHON_TESTNET]: "sophon-testnet" /* SOPHON_TESTNET */,
   [EndpointId.MOKSHA_TESTNET]: "moksha-testnet" /* MOKSHA_TESTNET */,
   [EndpointId.CITREA_TESTNET]: "citrea-testnet" /* CITREA_TESTNET */,
+  [EndpointId.BL3_TESTNET]: "bl3-testnet" /* BL3_TESTNET */,
+  [EndpointId.MP1_TESTNET]: "mp1-testnet" /* MP1_TESTNET */,
   // v2 testnet
   [EndpointId.ETHEREUM_V2_TESTNET]: "sepolia" /* SEPOLIA */,
   [EndpointId.POLYGON_V2_TESTNET]: "mumbai" /* MUMBAI */,
@@ -1692,6 +1702,8 @@ var CHAIN_KEY = {
   [EndpointId.MOKSHA_V2_TESTNET]: "moksha-testnet" /* MOKSHA_TESTNET */,
   [EndpointId.TON_V2_TESTNET]: "ton-testnet" /* TON_TESTNET */,
   [EndpointId.CITREA_V2_TESTNET]: "citrea-testnet" /* CITREA_TESTNET */,
+  [EndpointId.BL3_V2_TESTNET]: "bl3-testnet" /* BL3_TESTNET */,
+  [EndpointId.MP1_V2_TESTNET]: "mp1-testnet" /* MP1_TESTNET */,
   // sandbox
   [EndpointId.ETHEREUM_SANDBOX]: "ethereum-sandbox" /* ETHEREUM_SANDBOX */,
   [EndpointId.BSC_SANDBOX]: "bsc-sandbox" /* BSC_SANDBOX */,
@@ -2100,6 +2112,8 @@ var ENVIRONMENT = {
   [EndpointId.SOPHON_TESTNET]: "testnet" /* TESTNET */,
   [EndpointId.MOKSHA_TESTNET]: "testnet" /* TESTNET */,
   [EndpointId.CITREA_TESTNET]: "testnet" /* TESTNET */,
+  [EndpointId.BL3_TESTNET]: "testnet" /* TESTNET */,
+  [EndpointId.MP1_TESTNET]: "testnet" /* TESTNET */,
   // v2 testnet
   [EndpointId.ETHEREUM_V2_TESTNET]: "testnet" /* TESTNET */,
   [EndpointId.POLYGON_V2_TESTNET]: "testnet" /* TESTNET */,
@@ -2260,6 +2274,8 @@ var ENVIRONMENT = {
   [EndpointId.MOKSHA_V2_TESTNET]: "testnet" /* TESTNET */,
   [EndpointId.TON_V2_TESTNET]: "testnet" /* TESTNET */,
   [EndpointId.CITREA_V2_TESTNET]: "testnet" /* TESTNET */,
+  [EndpointId.BL3_V2_TESTNET]: "testnet" /* TESTNET */,
+  [EndpointId.MP1_V2_TESTNET]: "testnet" /* TESTNET */,
   // sandbox
   [EndpointId.ETHEREUM_SANDBOX]: "testnet" /* TESTNET */,
   [EndpointId.BSC_SANDBOX]: "testnet" /* TESTNET */,
@@ -2400,7 +2416,7 @@ function networkToChain(network) {
 }
 function networkToChainType(network) {
   const chain = networkToChain(network);
-  return getChainType(chain);
+  return chainToChainType(chain);
 }
 function chainToChainType(chain) {
   switch (chain) {
@@ -2447,7 +2463,7 @@ function endpointIdToStage(endpointId) {
 }
 function endpointIdToChainType(endpointId) {
   const chain = endpointIdToChain(endpointId);
-  return getChainType(chain);
+  return chainToChainType(chain);
 }
 function getNetworksForStage(stage) {
   const networks = [];
@@ -2525,16 +2541,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);
@@ -2565,9 +2581,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`);
@@ -2639,5 +2669,5 @@ exports.networkToChainType = networkToChainType;
 exports.networkToEndpointId = networkToEndpointId;
 exports.networkToEnv = networkToEnv;
 exports.networkToStage = networkToStage;
-//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map