npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@layerzerolabs/ua-utils

v0.0.26

Published

```sh $ npm install @layerzerolabs/ua-utils ``` The plugin depends on [`@nomiclabs/hardhat-ethers`](https://www.npmjs.com/package/@nomiclabs/hardhat-ethers), so you need to import both plugins in your `hardhat.config.js`:

Downloads

127

Readme

Installation

$ npm install @layerzerolabs/ua-utils

The plugin depends on @nomiclabs/hardhat-ethers, so you need to import both plugins in your hardhat.config.js:

require("@nomiclabs/hardhat-ethers");
require("@layerzerolabs/ua-utils");

Or if you are using TypeScript, in your hardhat.config.ts:

import "@nomiclabs/hardhat-ethers";
import "@layerzerolabs/ua-utils";

Make sure that network names in your hardhat.config.js match the following naming convention.

Tasks

The package adds the following tasks:

  • getDefaultConfig returns the default configuration for the specified chains.

    Usage:

    npx hardhat getDefaultConfig --networks ethereum,bsc,polygon,avalanche
  • getConfig returns the configuration of the specified contract.

    Parameters:

    • address - the contract address. An optional parameter. Either contract name or contract address must be specified.
    • name - the contract name. An optional parameter. It must be specified only if the contract was deployed using hardhat-deploy and the deployments information is located in the deployments folder.
    • network - the network the contract is deployed to.
    • remote-networks - a comma separated list of remote networks the contract is configured with.

    Usage:

    npx hardhat getConfig --network ethereum --remote-networks bsc,polygon,avalanche --name OFT
  • setConfig sets the configuration of the specified contract.

    Parameters:

    • config-path - the relative path to a file containing the configuration.
    • address - the address of the deployed contracts. An optional parameter. It should be provided if the contract address is the same on all chains. For contracts with different addresses, specify the address for each chain in the config.
    • name - the name of the deployed contracts. An optional parameter. It should be provided only if the same contract deployed on all chains using hardhat-deploy and the deployment information is located in the deployments folder. For contracts with different names, specify the name for each chain in the config.
    • gnosis-config-path - the relative path to a file containing the gnosis configuration. An optional parameter. If specified, the transactions will be sent to Gnosis.

    Usage:

    npx hardhat setConfig --networks ethereum,bsc,avalanche --name OFT --config-path "./appConfig.json" --gnosis-config-path "./gnosisConfig.json"

    Below is an example of the application configuration

    {
         "ethereum": {
             "address": "",
             "name": "ProxyOFT",
             "sendVersion": 2,
             "receiveVersion": 2,
             "remoteConfigs": [
                 {
                     "remoteChain": "bsc",
                     "inboundProofLibraryVersion": 1,
                     "inboundBlockConfirmations": 20,
                     "relayer": "0x902F09715B6303d4173037652FA7377e5b98089E",
                     "outboundProofType": 1,
                     "outboundBlockConfirmations": 15,
                     "oracle": "0x5a54fe5234E811466D5366846283323c954310B2"
                 },
                 {
                     "remoteChain": "avalanche",
                     "inboundProofLibraryVersion": 1,
                     "inboundBlockConfirmations": 12,
                     "relayer": "0x902F09715B6303d4173037652FA7377e5b98089E",
                     "outboundProofType": 1,
                     "outboundBlockConfirmations": 15,
                     "oracle": "0x5a54fe5234E811466D5366846283323c954310B2"
                 }
             ]
         },
         "bsc": {			
             "address": "0x0702c7B1b18E5EBf022e17182b52F0AC262A8062",
             "name": "",
             "sendVersion": 2,
             "receiveVersion": 2,
             "remoteConfigs": [
                 {
                     "remoteChain": "ethereum",
                     "inboundProofLibraryVersion": 1,
                     "inboundBlockConfirmations": 15,
                     "relayer": "0xA27A2cA24DD28Ce14Fb5f5844b59851F03DCf182",
                     "outboundProofType": 1,
                     "outboundBlockConfirmations": 20,
                     "oracle": "0x5a54fe5234E811466D5366846283323c954310B2"
                 }
             ]
         }
    }

    The top level elements represent chains the contracts are deployed to. The configuration section for each chain has the following fields:

    • address - the contract address. An optional parameter. It should be provided if no address was specified in the task parameters.
    • name - 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.
    • sendVersion - the version of a messaging library contract used to send messages. If it isn't specified, the default version will be used.
    • receiveVersion - the version of a messaging library contract used to receive messages. If it isn't specified, the default version will be used.
    • remoteConfigs - an array of configuration settings for remote chains.

    The configuration section for each chain has the following fields:

    • remoteChain - the remote chain name.
    • inboundProofLibraryVersion - the version of proof library for inbound messages.
    • inboundBlockConfirmations - the number of block confirmations for inbound messages.
    • relayer - the address of Relayer contract.
    • outboundProofType - proof type used for outbound messages.
    • outboundBlockConfirmations - the number of block confirmations for outbound messages.
    • oracle - the address of the Oracle contract.
  • checkWireAllConfig returns the current wired up configurations of the specified contract.

    Parameters:

    • e - the environment ie: mainnet, testnet or sandbox.
    • u - flag to show use custom adapter params.
    • t - flag to show trusted remotes.
    • m - flag to show min destination gas.
    • chains - comma separated list of networks.
    • addresses - comma separated list of contract addresses in same order as chains. An optional parameter, if no deployment folder is available and want to use contract addresses.
    • contract - name of contract. An optional parameter. If all contract names are the same.
    • proxyContract - name of proxy contract. An optional parameter. If one contract name is different.
    • proxyChain - name of proxy chain. An optional parameter. If one chain has different contract name .

    Usage:

    npx hardhat checkWireAllConfig --e testnet --u --t --m --chains ethereum-testnet,arbitrum-testnet --contract ExampleOFTV2
     
    npx hardhat checkWireAllConfig --e testnet --u --t --m --chains ethereum-testnet,arbitrum-testnet,optimism-testnet --contract OFTV2 --proxy-contract ProxyOFTV2 --proxy-chain optimism-testnet
     
    npx hardhat checkWireAllConfig --e testnet --u --t --m --chains ethereum-testnet,arbitrum-testnet,optimism-testnet --addresses "0xD90E022dE858DfDFC3C0f66b0D9ACD12CA6eA3Ec,0x137d4e9C2431A3DCBa6e615E9438F2c558353a17,0x27631753FC88e7b45a46679B9Cd2e06378cB43dC"
  • wireAll sets the wire all configuration of the specified contract.

    Parameters:

    • e - the environment ie: mainnet, testnet or sandbox.
    • noPrompt - no prompt. An optional parameter defaults to false.
    • configPath - config path. An optional parameter. Default: ./constants/wireUpConfig.json.
    • n - send to gnosis. An optional parameter defaults to false.
    • gnosisConfigPath - gnosis config path. An optional parameter. Default: ./constants/gnosisConfig.json.

    Usage:

    npx hardhat --network ethereum-testnet wireAll --e testnet

    Below is an example of the wire all configuration

    {
       "proxyContractConfig": {
           "chain": "avalanche",
           "name": "ProxyOFT"
       },
       "contractConfig": {
           "name": "OFT"
       },
       "chainConfig": {
           "avalanche": {
               "defaultFeeBp": 2,
               "useCustomAdapterParams": true,
               "remoteNetworkConfig": {
                   "ethereum": {
                       "feeBpConfig": {
                           "feeBp": 5,
                           "enabled": true
                       },
                       "minDstGasConfig": {
                           "packetType_0": 100000,
                           "packetType_1": 200000
                       }
                   },
                   "polygon": {
                       "minDstGasConfig": {
                           "packetType_0": 100000,
                           "packetType_1": 160000
                       }
                   }
               }
           }
       }
    }

    The proxyContractConfig is an optional setting, that defines the proxy chain and proxy contract name.

    • chain: An optional string, defines the proxy chain.

    • name: An optional string, defines the proxy contract name.

    • address: A optional string, defines the contract address. Used when deployments folder are not available. Uses standard LzApp/Nonblocking/OFT/ONFT abi calls such as:

      • function setFeeBp(uint16, bool, uint16)
      • function setDefaultFeeBp(uint16)
      • function setMinDstGas(uint16, uint16, uint)
      • function setUseCustomAdapterParams(bool)
      • function setTrustedRemote(uint16, bytes)
    • The contractConfig is a conditionally required setting, that defines the contract name.

      • function setFeeBp(uint16, bool, uint16)
    • The chainConfig: is required and defines the chain settings (default fees, useCustomAdapterParams) and the remote chain configs (minDstGas config based of packetType, and custom feeBP per chain)

      • name: A conditionally required string, defines the contract name. Used when contract names differ per chain.

      • address: A conditionally required string, defines the contract address. Used when deployments folder are not available. Uses standard LzApp/Nonblocking/OFT/ONFT abi calls.

      • defaultFeeBp: An optional number, defines the default fee bp for the chain. (Available in OFTV2 w/ fee.)

      • useCustomAdapterParams: An optional bool that defaults to false. Uses default 200k destination gas on all cross chain messages. When false adapter parameters must be empty. When useCustomAdapterParams is true the minDstGasLookup must be set for each packet type and each chain. This requires whoever calls the send function to provide the adapter params with a destination gas >= amount set for that packet type and that destination chain.

      • remoteNetworkConfig is a conditionally required setting, that defines the contract name.

        • minDstGasConfig: is an optional object that defines the minDstGas required based off packetType. So for example when the UA on Avalanche sends packet type 0 to Ethereum the minDstGas will be 100000. When the UA on Avalanche sends packet type 1 to Polygon the minDstGas will be 160000.
        • The feeBpConfig is an optional setting that defines custom feeBP per chain. (Note: setting custom fee per chain with enabled = TRUE, will triumph over defaultFeeBp.)
          • feeBp: is an optional number, defines custom feeBP per chain.
          • enabled: is an optional bool, defines if custom feeBP per chain is enabled

      More info and examples can be found here in the Wire Up Configuration documentation.

      Below is an example of the Gnosis configuration

      {
       "ethereum": {
         "safeAddress": "0xa36B7e7894aCfaa6c35A8A0EC630B71A6B8A6D22",
         "url": "https://safe-transaction.mainnet.gnosis.io/"
       },
       "bsc": {
         "safeAddress": "0x4755D44c1C196dC524848200B0556A09084D1dFD",
         "url": "https://safe-transaction.bsc.gnosis.io/"
       },
       "avalanche": {
         "safeAddress": "0x4FF2C33FD9042a76eaC920C037383E51659417Ee",
         "url": "https://safe-transaction.avalanche.gnosis.io/"
       }
      }

      For each chain you need to specify your Gnosis safe address and Gnosis Safe API url. You can find the list of supported chains and API urls in Gnosis Safe documentation.