---

LayerZero Omnichain Contract Examples

* Formal audit(s) (May 21, 2022) can be found in audit

$3

``shell
yarn install
yarn test
`

* The code in the contracts folder demonstrates LayerZero behaviours.
* NonblockingLzApp is a great contract to extend. Take a look at how OmniCounter overrides _nonblockingLzReceive and _LzReceive to easily handle messaging. There are also example for OFT and ONFT which illustrate erc20 and erc721 cross chain functionality.
* Always audit your own code and test extensively on testnet before going to mainnet 🙏

> The examples below use two chains, however you could substitute any LayerZero supported chain!

OmnichainFungibleToken (OFT)

About OFTV2

`text
NOTE: the OFTV2 uses uint64 to encode value transfer for compatability of Aptos and Solana.

The deployer is expected to set a lower decimal points like 6 or 8.

If the decimal point is 18, then uint64 can only represent approximately 18 tokens (uint64.max ~= 18 * 10^18).
`

Deploy Setup

1. Add a .env file (to the root project directory) with your MNEMONIC="your mnemonic" and fund your wallet in order to deploy!
2. Follow any of the tutorials below

OFTV2Mock.sol - an omnichain ERC20

:warning: You must perform setTrustedRemote() (step 2). This is a mock deployment that auto mints tokens to msg.sender

1. Deploy two contracts:

`shell
npx hardhat --network goerli deploy --tags ExampleOFTV2
npx hardhat --network fuji deploy --tags ExampleOFTV2
`

2. Set the "trusted remotes" (ie: your contracts) so each of them can receive messages from one another, and only one another.

`shell
npx hardhat --network goerli setTrustedRemote --target-network fuji --contract OFTV2Mock
npx hardhat --network fuji setTrustedRemote --target-network goerli --contract OFTV2Mock
`

3. Set the "minDstGas" required on the destination chain.

`shell
npx hardhat --network goerli setMinDstGas --packet-type 0 --target-network fuji --contract OFTV2Mock --min-gas 100000
npx hardhat --network fuji setMinDstGas --packet-type 0 --target-network goerli --contract OFTV2Mock --min-gas 100000
`

:warning: Although 100000 is used for min-gas in this example, you should set this value based on careful gas consumption analysis.

4. Send tokens from goerli to fuji

`shell
npx hardhat --network goerli oftv2Send --target-network fuji --qty 42 --contract OFTV2Mock
`

Pro-tip: Check the ERC20 transactions tab of the destination chain block explorer and await your tokens!

OmnichainNonFungibleToken721 (ONFT721)

This ONFT contract allows minting of nftIds on separate chains. To ensure two chains can not mint the same nftId each contract on each chain is only allowed to mintnftIds in certain ranges.
Check the ONFT_ARGS constant defined in ONFT721 deploy script for the specific test configuration used in this demo.

ONFT721Mock.sol

:warning: You must perform the setTrustedRemote() (step 2).

1. Deploy two contracts:

`shell
npx hardhat --network bsc-testnet deploy --tags ONFT721
npx hardhat --network fuji deploy --tags ONFT721
`

2. Set the "trusted remotes", so each contract can send & receive messages from one another, and only one another.

`shell
npx hardhat --network bsc-testnet setTrustedRemote --target-network fuji --contract ONFT721Mock
npx hardhat --network fuji setTrustedRemote --target-network bsc-testnet --contract ONFT721Mock
`

3. Set the min gas required on the destination

`shell
npx hardhat --network bsc-testnet setMinDstGas --target-network fuji --contract ONFT721Mock --packet-type 1 --min-gas 100000
npx hardhat --network fuji setMinDstGas --target-network bsc-testnet --contract ONFT721Mock --packet-type 1 --min-gas 100000
`

4. Mint an NFT on each chain!

`shell
npx hardhat --network bsc-testnet onftMint --contract ONFT721Mock --to-address