One-stop-shop for developing LayerZero applications with hardhat
\n\n## Installation\n\n```bash\nyarn add @layerzerolabs/toolbox-hardhat\n\npnpm add @layerzerolabs/toolbox-hardhat\n\nnpm install @layerzerolabs/toolbox-hardhat\n```\n\n## Configuration\n\n### 1. Add `@layerzerolabs/toolbox-hardhat` to your config\n\nTo use `@layerzerolabs/toolbox-hardhat` you will need to import it in your `hardhat` config file.\n\n#### TypeScript (hardhat.config.ts)\n\n```typescript\nimport \"@layerzerolabs/toolbox-hardhat\";\n```\n\n#### JavaScript (hardhat.config.js)\n\n```javascript\nrequire(\"@layerzerolabs/toolbox-hardhat\");\n```\n\n### 2. Connect your networks\n\nLayerZero deploys `EndpointV2` contracts on all supported chains. These contracts are identified by their _endpoint ID_ (`eid` for short).\n\nIn order to wire your contracts, `@layerzerolabs/toolbox-hardhat` needs to know the mapping between the networks defined in your `hardhat` config and the endpoint ID.\n\n> Previously we required your network names to exactly match the names we use. In order to be more flexible, we decided to switch this more explicit, albeit more verbose configuration.\n\nHead to your `hardhat` config to set the `eid` ↔︎ `network` mapping.\n\n#### TypeScript (hardhat.config.ts)\n\n```typescript\nimport { HardhatUserConfig } from \"hardhat/types\";\nimport { EndpointId } from \"@layerzerolabs/lz-definitions\";\n\nconst config: HardhatUserConfig = {\n // ...\n networks: {\n fuji: {\n eid: EndpointId.AVALANCHE_V2_TESTNET,\n url: \"https://api.avax-test.network/ext/bc/C/rpc\",\n // ...\n },\n mainnet: {\n eid: EndpointId.ETHEREUM_V2_MAINNET,\n url: \"https://eth.llamarpc.com\",\n },\n },\n};\n\nexport default config;\n```\n\n#### JavaScript (hardhat.config.js)\n\n```javascript\nconst { EndpointId } = require(\"@layerzerolabs/lz-definitions\");\n\nconst config = {\n // ...\n networks: {\n fuji: {\n eid: EndpointId.AVALANCHE_V2_TESTNET,\n url: \"https://api.avax-test.network/ext/bc/C/rpc\",\n // ...\n },\n mainnet: {\n eid: EndpointId.ETHEREUM_V2_MAINNET,\n url: \"https://eth.llamarpc.com\",\n },\n },\n};\n\nmodule.exports = config;\n```\n\n### 3. Configure your LayerZero OApp Config\n\nTo use the `lz:oapp:wire` task you must first fill out your `layerzero.config` file.\n\n#### LayerZero configuration:\n\n- `contracts`: A conditionally required array of LayerZero Contracts.\n\n - `contract`: A LayerZero Contract, defines the `eid` along with either the `contractName` or the `address`.\n - `eid`: A number, defines the [LayerZero Endpoint](https://docs.layerzero.network/contracts/endpoint-addresses) Identifier.\n - `contractName`: The contract name. An _optional_ parameter. It should be provided only if the contract was deployed using hardhat-deploy and the deployment information is located in the deployments folder.\n - `address`: The contract address. An _optional_ parameter. It should be provided if the contracts are not located in the deployments folder.
\n\n- `connections`: A conditionally required array of LayerZero Connections defining the configuration between two LayerZero contracts.\n - `from`: A LayerZero Contract, defines the `from` contract. This sets the peer `from -> to`.\n - `to`: A LayerZero Contract, defines the `to` contract. This sets the peer `from -> to`.\n - _Note: Both `from` and `to` are optional; you are not required to connect all pathways. However, `from` and `to` must be defined to set `config`_.\n - `config`: An _optional_ LayerZero Config, defines a configuration between two contracts.\n - `sendLibrary`: An _optional_ string, defines the Send Library Address.\n - `receiveLibraryConfig`: An _optional_ LayerZero Receive Library Config, defines the receiveLibrary and gracePeriod.\n - `receiveLibrary`: A string, defines the Receive Library Address.\n - `gracePeriod`: A number, defines Grace Period.\n - `receiveLibraryTimeoutConfig`: An _optional_ LayerZero Receive Library Timeout Config, defines the lib and expiry.\n - `lib`: A string, defines the Receive Library Address.\n - `expiry`: A number, defines the block timestamp the Receive Library will expire.\n - `sendConfig`: An _optional_ LayerZero Send Config, defines the executorConfig and ulnConfig.\n - `executorConfig`: A LayerZero Executor Config, defines the maxMessageSize and executor.\n - `maxMessageSize`: A number, defines the maxMessageSize.\n - `executor`: A string, defines the Executor Address.\n - `ulnConfig`: An _optional_ LayerZero ULN Config Object, defines the confirmations, optionalDVNThreshold, requiredDVNs, and optionalDVNs.\n - `confirmations`: A number, defines the Block Confirmations.\n - `optionalDVNThreshold`: A number, defines the Optional DVN Threshold.\n - `requiredDVNs`: An array of strings, defines the Required DVNs.\n - `optionalDVNs`: An array of strings, defines the Optional DVNs.\n - `receiveConfig`: An _optional_ LayerZero Receive Config, defines the ulnConfig.\n - `ulnConfig`: A LayerZero ULN Config Object, defines the confirmations, optionalDVNThreshold, requiredDVNs, and optionalDVNs.\n - `confirmations`: A number, defines the Block Confirmations.\n - `optionalDVNThreshold`: A number, defines the Optional DVN Threshold.\n - `requiredDVNs`: A array of strings, defines the Required DVNs.\n - `optionalDVNs`: A array of strings, defines the Optional DVNs.\n - `enforcedOptions`: An _optional_ array of LayerZero Enforced Options, defines the msgType and optionType.\n - `msgType`: A number, defines a user defined msgType for the OApp\n - `optionType`: A number, defines type of Enforced Option.\n - `LZ_RECEIVE`: Enforced option type 1\n - `gas`: A number, defines gas for Option Type LZ_RECEIVE.\n - `value`: A number, defines value for Option Type LZ_RECEIVE.\n - `NATIVE_DROP`: Enforced option type 2\n - `amount`: A number, defines amount for Option Type NATIVE_DROP.\n - `receiver`: A string, defines the receiver address for Option Type NATIVE_DROP.\n - `COMPOSE`: Enforced option type 3\n - `index`: A number, defines the index of the composable calls for Option Type COMPOSE.\n - `gas`: A number, defines gas for the composable calls for Option Type COMPOSE.\n - `value`: A number, defines value for the composable calls for Option Type COMPOSE.\n - `ORDERED`: Enforced option type 4\n\n#### For example:\n\n#### TypeScript (layerzero.config.ts)\n\n```typescript\nimport {\n OAppOmniGraphHardhat,\n OmniPointHardhat,\n} from \"@layerzerolabs/ua-devtools-evm-hardhat\";\nimport { EndpointId } from \"@layerzerolabs/lz-definitions\";\nimport { ExecutorOptionType } from \"@layerzerolabs/lz-v2-utilities\";\n\nconst sepoliaContract: OmniPointHardhat = {\n eid: EndpointId.SEPOLIA_V2_TESTNET,\n contractName: \"MyOApp\",\n};\n\nconst fujiContract: OmniPointHardhat = {\n eid: EndpointId.AVALANCHE_V2_TESTNET,\n contractName: \"MyOApp\",\n};\n\nconst graph: OAppOmniGraphHardhat = {\n contracts: [\n {\n contract: fujiContract,\n },\n {\n contract: sepoliaContract,\n },\n ],\n connections: [\n {\n // Sets the peer `from -> to`. Optional, you do not have to connect all pathways.\n from: fujiContract,\n to: sepoliaContract,\n // Optional Configuration\n config: {\n // Optional Send Library\n sendLibrary: \"0x0000000000000000000000000000000000000000\",\n // Optional Receive Library Configuration\n receiveLibraryConfig: {\n receiveLibrary: \"0x0000000000000000000000000000000000000000\",\n gracePeriod: BigInt(0),\n },\n // Optional Receive Library Timeout Configuration\n receiveLibraryTimeoutConfig: {\n lib: \"0x0000000000000000000000000000000000000000\",\n expiry: BigInt(0),\n },\n // Optional Send Configuration\n sendConfig: {\n executorConfig: {\n maxMessageSize: 99,\n executor: \"0x0000000000000000000000000000000000000000\",\n },\n ulnConfig: {\n confirmations: BigInt(42),\n requiredDVNs: [],\n optionalDVNs: [\n \"0x0000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000\",\n ],\n optionalDVNThreshold: 2,\n },\n },\n // Optional Receive Configuration\n receiveConfig: {\n ulnConfig: {\n confirmations: BigInt(42),\n requiredDVNs: [],\n optionalDVNs: [\n \"0x0000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000\",\n ],\n optionalDVNThreshold: 2,\n },\n },\n // Optional Enforced Options Configuration\n enforcedOptions: [\n {\n msgType: 1,\n optionType: ExecutorOptionType.LZ_RECEIVE,\n gas: 200000,\n value: 1,\n },\n {\n msgType: 1,\n optionType: ExecutorOptionType.NATIVE_DROP,\n amount: 1,\n receiver: \"0x0000000000000000000000000000000000000000\",\n },\n {\n msgType: 2,\n optionType: ExecutorOptionType.COMPOSE,\n index: 0,\n gas: 200000,\n value: 1,\n },\n {\n msgType: 2,\n optionType: ExecutorOptionType.COMPOSE,\n index: 1,\n gas: 300000,\n value: 1,\n },\n ],\n },\n },\n ],\n};\nexport default graph;\n```\n\n## Usage\n\n### Tasks\n\nThis package comes with several `hardhat` tasks to speed up your workflow. In order to prevent name collisions, these have been prefixed with `lz:`:\n\n- [`lz:oapp:wire`](#tasks-lz-oapp-wire)\n\n#### `lz:oapp:wire` \n\nWires the individual `OApp` contracts together, calling `setPeer`.\n\n```bash\npnpm hardhat lz:oapp:wire\n```\n","readmeFilename":"README.md"}
![\"LayerZero\"](\"https://d3a2dpnnrypp5h.cloudfront.net/bridge-app/lz.png\"/)
\n \n