The goal of this package is to support already existing ethers.js code with only minimal changes. This makes it possible to develop decentralized applications as Nomo WebOns.
For example, this package can be used for the following tasks:
- Invoking functions on smart contracts
- Querying data from a blockchain
- Deploying new smart contracts
All of this is backed by a seed phrase of the Nomo App, and the seed phrase remains secure even if the WebOn-code was malicious.
Some features are implemented directly with the nomo-webon-kit, without using ethersjs-nomo-webons.
For examples, the following features work just with the nomo-webon-kit alone:
- Fetching balances (via
nomo.getBalanceWaitUntilSynced) - Sending assets (via
nomo.sendAssets) - Connecting to wallets like MetaMask in the fallback mode (via
nomo.getEvmAddress)
That being said, ethersjs-nomo-webons is still needed for the following features:
- Invoking EVM smart contracts other than tokens
- Constructing EVM transactions based on contract-ABIs
- Connecting to EVM chains that are not natively supported by Nomo
- Querying EVM logs, querying EVM data structures and more
First, install the package via npm:
npm i ethersjs-nomo-webons
Then you can import one of the following objects, depending on your use case:
import { EthersjsNomoSigner } from "ethersjs-nomo-webons"; // this can be used for constructing your own signer-object
import { zscSigner } from "ethersjs-nomo-webons"; // a ready-made signer-object for interacting with the ZENIQ Smartchain
Please consult the Demo-WebOn and the ethers.js-V6 documentation for more details. See the minting example for invoking a smart contract with this package.
Whatever EVM-chain you are using, you can easily create a signer-object with just a few lines of code. For example:
import { EthersjsNomoSigner } from "ethersjs-nomo-webons";
const ethProvider = ethers.getDefaultProvider();
const ethSigner = new EthersjsNomoSigner(ethProvider);
This package only works with ethers.js-V6. If you still need to use ethers.js-V5, then you can use the package ethersjs-nomo-webons-v5