@verified-network/verified-sdk 1.5.6 → 1.5.7

package/.env

@@ -5,4 +5,5 @@ GENERAL_PAYMASTER_URL="https://paymaster.biconomy.io/api/v1"
 80001_PAYMASTER_API_KEY="aoDXoLOsa.b941e672-e98f-4d56-b9f6-733dca59a87e"
 # 5_CASH_TOKEN_ADDRESS="0x07865c6E87B9F70255377e024ace6630C1Eaa37F" //goerli(chainid 5) not workith biconomy
 80001_CASH_TOKEN_ADDRESS="0xda5289fcaaf71d52a80a254da614a192b693e977"
+11155111_PAYMASTER_API_KEY="BuFP2-5w-.5b3daf3a-d044-4dda-819c-4c4d8431df88"
 BICONOMY_REVERT_TOPIC="0x1c4fada7374c0a9ee8841fc38afe82932dc0f8e69012e927f061a8bae611a201"

package/README.md

@@ -1,34 +1,88 @@
 # The Verified SDK
+
 The Verified SDK provides access to the issuing, trading and servicing of tokenized securities on the Verified Network.
 
 # installing using npm
-```npm install @verified-network/verified-sdk```
+
+`npm install @verified-network/verified-sdk`
 
 # creating new wallet
+
 ```
 const {VerifiedWallet} = require('@verified-network/verified-sdk');
 let mnemonics = await VerifiedWallet.generateMnemonics()
 let wallet = await VerifiedWallet.importWallet(menmonics)
 ```
+
 # setProvider
+
+Provider can be set for wallet using 2 options:
+
+# using default providers
+
+Default providers are available for networks like: mainnet/homestead, ropsten, sepolia e.t.c and are mainly used for development(it is also robust enough for use in production)
+
 ```
 const {Provider} = require('@verified-network/verified-sdk');
-const defaultProvider = 'ropsten' // or any other network of your choice.
+const defaultProvider = 'ropsten' // or any other default provider network of your choice.
+Network/chain id(number) can be used in place of network name, for example:
+const defaultProvider = 3 // where number 3 is chain id for ropsten, any other chain id of default provider network can be used.
 let walletWithProvider = wallet.setProvider(
     Provider.defaultProvider(defaultProvider)
 )
 ```
+
+# using custom providers
+
+Verified Sdk supports Infura and Alchemy to provide custom providers for any network.
+
+```
+const {Provider} = require('@verified-network/verified-sdk');
+const network = 'ropsten' // or any other network of your choice.
+Network/chain id(number) can be used in place of network name, for example:
+const network = 3 // where number 3 is chain id for ropsten, any other chain id can be used.
+//For infura; to get api key and enable networks checout: https://www.infura.io/
+const INFURA_API_KEY = 'your infura api key'
+let walletWithProvider = wallet.setProvider(
+    Provider.infuraProvider(network, INFURA_API_KEY)
+)
+//For Alchemy;  to get api key and enable networks checout: https://www.alchemy.com/
+const ALCHEMY_KEY = 'your alchemy api key'
+let walletWithProvider = wallet.setProvider(
+    Provider.alchemyProvider(network, ALCHEMY_KEY)
+)
+```
+
 # interacting with Smart contracts
-```let clientContract = new ClientContract(wallet);```
+
+```
+cosnt {Client} = require('@verified-network/verified-sdk');
+let clientContract = new Client(walletWithProvider);
+```
 
 This will create an instance of Client contract and you can access all the functions within the clientContract using this object.
 
 Now you can call a function in clientContract like:
-```clientContract.setAccess("true")``` // to set the access to True/False.
+`clientContract.setAccess("true")` // to set the access to True/False.
+
+Some contracts requires additional parameters to create their instances, for example:
+
+```
+cosnt {SecurityContract, PrimaryIssueManager} = require('@verified-network/verified-sdk');
+// securityContract
+const securityContractAddress = 'security address for any verified security'
+let securityContract = new SecurityContract(walletWithProvider, securityContractAddress);
+
+//primaryIssueManager
+const primaryIssueManagerAddress = 'primary issue manager address'
+const primaryIssueManagerplatform = 'primary issue manager platform' //e.g 'balancer'
+let primaryIssueManagerContract = new PrimaryIssueManager(walletWithProvider, primaryIssueManagerAddress, primaryIssueManagerplatform);
+```
 
 Similarly you can create different Contracts instances available:
+
 ```
-ClientContract,
+Client,
 BondContract,
 CashContract,
 TokenContract,
@@ -46,17 +100,45 @@ DistributionContract
 ```
 
 # VerifiedContract
+
 src/contract/index.ts is the base class for all Contracts created.
 It has the logic to validate the Input, Sanitise the Input and Output, call the contract functions etc.
 All the contracts trigger smart contract calls and go through the callContract function.
 
 Optionally, all the contractCalls take in an additional parameter:
-```options?: { gasPrice: number, gasLimit: number }```
+`options?: { gasPrice: number, gasLimit: number }`
 You can configure the gasPrice and gasLimit using this parameter as the last parameter to the contractCall function.
-Example: ```this.callContract(FUNCTIONS.GETORDERS, originator, options)```
+Example: `this.callContract(FUNCTIONS.GETORDERS, originator, options)`
 Where, options = {gasPrice: XXX, gasLimit: YYY}
 
 # This is how you can integrate with any Dapp.
+
 1. Install and Import the SDK
 2. Create a wallet instance and fund it
-3. Create instances of the Contract that you want to interact with using the above wallet and call their functions.
+3. Create instances of the Contract that you want to interact with using the above wallet and call their functions.
+
+# Verified Sdk also provides ERC 4337-compliant solution and enable account abstraction using Biconomy Smart Accounts.
+
+Verified Sdk follows ERC 4337 standard and implement pseudo-transaction object(userOperation) to enable transaction sponsorship allowing smart contract creators to sponsor some set of transactions on smart contract for users when certain functions are called and allow multiple transaction to be called in batch
+
+With this unique feature of Verified Sdk creators can pay gas fee for users/entity interaction with smart contract in ERC 20 token or Native tokens(Eth, Matic e.t.c) and also enable users/entity interacting with the contract to pay for gas fee using ERC 20 tokens.
+
+# How Verified Sdk Gasless transactions work
+
+For every transactions/interactions with verified smart contracts, various checks are made to determine if the transaction will be gasless(will be sponsored) or not. For gasless transactions, contract creators have pre deposited certain amount of native tokens(Eth, Matic e.t.c) or ERC 20 tokens(USDC, VUSDC e.t.c) on Biconomy paymaster dashboard to cover gas fees for set of functions on smart contract.
+
+# Verified Sdk checks for every transaction:
+
+    # Check 1: is Biconomy Paymaster supported for the network/chain the contract is on?
+    If yes:
+    # Check 2: is the smart contract called part of smart contracts that support gasless or Erc 20 gas payments?
+    If yes:
+    # Check 3: is the function called parts of functions selected to support gasless or ERC 20 payments?
+    If yes:
+    # Check 4: what type of paymaster was set? Gasless or ERC 20
+        If gasless:
+        # Check 5: is the deposited gas enough to pay for transaction?
+        if yes: Transaction is sposored(user does not pay for gas fee)
+        if ERC 20:
+        # User pay for transaction using ERC 20 tokens
+    # If no: User will pay for transaction using native tokens(Eth, Matic e.t.c)

package/dist/contract/index.js

@@ -6,13 +6,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VerifiedContract = exports.DATATYPES = void 0;
 const dotenv_1 = require("dotenv");
+dotenv_1.config({ path: "../../.env" });
 const ethers_1 = require("ethers");
 const web3_1 = __importDefault(require("web3"));
 const account_1 = require("@biconomy/account");
 const modules_1 = require("@biconomy/modules");
 const bundler_1 = require("@biconomy/bundler");
 const paymaster_1 = require("@biconomy/paymaster");
-dotenv_1.config();
+const constants_1 = require("../utils/constants");
 var STATUS;
 (function (STATUS) {
     STATUS[STATUS["SUCCESS"] = 0] = "SUCCESS";
@@ -143,17 +144,25 @@ class VerifiedContract {
     tempOutput(data) {
         const response = { hash: '', result: [] };
         data.forEach(async (element) => {
-            if (element.hash !== undefined || element.transactionHash)
+            if (element.hash !== undefined || element.transactionHash) {
                 return response.hash = element.hash || element.transactionHash;
-            if (element._isBigNumber)
+            }
+            else if (element._isBigNumber) {
                 return response.result.push(element.toString());
-            if (ethers_1.utils.isAddress(element))
+            }
+            else if (ethers_1.utils.isAddress(element)) {
                 return response.result.push(element);
+            }
             //if (utils.isBytesLike(element)) return response.result.push(this.sanitiseOutput(DATATYPES.BYTE32, element))
-            if (ethers_1.utils.isBytesLike(element))
+            else if (ethers_1.utils.isBytesLike(element)) {
                 return response.result.push(element);
-            if (typeof element === 'boolean' || (await this.validateInput(DATATYPES.ADDRESS, element)))
+            }
+            else if (typeof element === 'boolean') {
+                return response.result.push(element);
+            }
+            else {
                 return response.result.push(element);
+            }
         });
         return response;
     }
@@ -167,7 +176,7 @@ class VerifiedContract {
     /** Checks if a contract support gasless transaction */
     supportsGasless(chainId) {
         let isSupported = false;
-        const contractPaymasterUrl = process.env[`${chainId}_PAYMASTER_API_KEY`];
+        const contractPaymasterUrl = constants_1.PaymasterConstants[`${chainId}_PAYMASTER_API_KEY`];
         if (contractPaymasterUrl && contractPaymasterUrl.length > 0)
             isSupported = true;
         return isSupported;
@@ -176,16 +185,14 @@ class VerifiedContract {
     async createSmartAccount(chainId) {
         //create bundler instance
         const bundler = new bundler_1.Bundler({
-            bundlerUrl: `${process.env.BUNDLER_URL_FIRST_SECTION}/${chainId}/${process.env.BUNDLER_URL_SECTION_SECTION}`,
+            bundlerUrl: `${constants_1.PaymasterConstants.BUNDLER_URL_FIRST_SECTION}/${chainId}/${constants_1.PaymasterConstants.BUNDLER_URL_SECTION_SECTION}`,
             chainId: chainId,
             entryPointAddress: account_1.DEFAULT_ENTRYPOINT_ADDRESS,
         });
-        // console.log("bd: ", bundler);
         //create paymaster instance
         const paymaster = new paymaster_1.BiconomyPaymaster({
-            paymasterUrl: `${process.env.GENERAL_PAYMASTER_URL}/${chainId}/${process.env[`${chainId}_PAYMASTER_API_KEY`]}`,
+            paymasterUrl: `${constants_1.PaymasterConstants.GENERAL_PAYMASTER_URL}/${chainId}/${constants_1.PaymasterConstants[`${chainId}_PAYMASTER_API_KEY`]}`,
         });
-        // console.log("pm: ", paymaster);
         const module = await modules_1.ECDSAOwnershipValidationModule.create({
             signer: this.signer,
             moduleAddress: modules_1.DEFAULT_ECDSA_OWNERSHIP_MODULE,
@@ -200,7 +207,6 @@ class VerifiedContract {
             activeValidationModule: module,
         });
         // console.log("address", await biconomyAccount.getAccountAddress());
-        //return smart account
         return biconomyAccount;
     }
     /** Constructs and call function with ethers.js */
@@ -221,10 +227,7 @@ class VerifiedContract {
              */
             let fn = this.contract[functionName];
             let _res = await fn(...args, ...options);
-            //console.log('_res', _res)
-            //console.log('_res.value.toString()',_res.value.toString())
             let _resp = _res.wait !== undefined ? await _res.wait(_res) : _res;
-            //console.log('_resp', _resp)
             res.response = this.tempOutput(this.convertToArray(ethers_1.utils.deepCopy(_resp)));
             res.status = STATUS.SUCCESS;
             res.message = "";
@@ -250,7 +253,7 @@ class VerifiedContract {
                 res.response = {
                     hash: transactionDetails.receipt.transactionHash,
                     result: [],
-                }; //TODO: update response
+                }; //TODO: update result on response
                 res.status = STATUS.SUCCESS;
                 res.message = "";
                 return res;
@@ -260,7 +263,7 @@ class VerifiedContract {
                 let reason = "";
                 const provider = this.contract.provider;
                 logs.map((log) => {
-                    if (log.topics.includes(process.env.BICONOMY_REVERT_TOPIC)) {
+                    if (log.topics.includes(constants_1.PaymasterConstants.BICONOMY_REVERT_TOPIC)) {
                         const web3 = new web3_1.default(provider);
                         reason = web3.utils.hexToAscii(log.data);
                     }
@@ -310,7 +313,15 @@ class VerifiedContract {
                 data: _res.data,
             };
             //build userop transaction
-            let partialUserOp = await smartAccount.buildUserOp([tx1]);
+            let partialUserOp;
+            try {
+                partialUserOp = await smartAccount.buildUserOp([tx1]);
+            }
+            catch (err) {
+                console.log("error while buiding gassless transaction: ", err);
+                console.log("will use ethers....");
+                return await this.callFunctionWithEthers(functionName, ...args);
+            }
             //query paymaster for sponsored mode to get neccesary params and update userop
             const biconomyPaymaster = smartAccount.paymaster;
             try {
@@ -341,7 +352,7 @@ class VerifiedContract {
                     //get fee quote for network cash token
                     const feeQuotesResponse = await biconomyPaymaster.getPaymasterFeeQuotesOrData(partialUserOp, {
                         mode: paymaster_1.PaymasterMode.ERC20,
-                        tokenList: [process.env[`${chainId}_CASH_TOKEN_ADDRESS`]],
+                        tokenList: [constants_1.PaymasterConstants[`${chainId}_CASH_TOKEN_ADDRESS`]],
                     });
                     // console.log("fq: ", feeQuotesResponse);
                     const feeQuotes = feeQuotesResponse.feeQuotes;

package/dist/utils/constants.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymasterConstants = void 0;
+//Todo: add more network paymaster details for gasless
+exports.PaymasterConstants = {
+    BUNDLER_URL_FIRST_SECTION: "https://bundler.biconomy.io/api/v2",
+    BUNDLER_URL_SECTION_SECTION: "nJPK7B3ru.dd7f7861-190d-41bd-af80-6877f74b8f44",
+    GENERAL_PAYMASTER_URL: "https://paymaster.biconomy.io/api/v1",
+    BICONOMY_REVERT_TOPIC: "0x1c4fada7374c0a9ee8841fc38afe82932dc0f8e69012e927f061a8bae611a201",
+    "11155111_PAYMASTER_API_KEY": "BuFP2-5w-.5b3daf3a-d044-4dda-819c-4c4d8431df88",
+    "137_PAYMASTER_API_KEY": "lDHvYk50N.30a2522e-0a9d-444b-b949-19194c1f237a",
+    "80001_PAYMASTER_API_KEY": "3B83DXSwj.3b20bc68-6e09-4bf2-bff5-5a0d11989389"
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@verified-network/verified-sdk",
-  "version": "1.5.6",
+  "version": "1.5.7",
   "description": "An SDK to develop applications on the Verified Network",
   "repository": {
     "type": "git",