Welcome

• A Web3 wallet library with tools to fasten your react-native application development. Uses ethers v6 library.

This wallet module does not expose the private key, and only advocates storing the keystore or the mnemonic with the password authentication locally, and does not activate the wallet except for write operations.

Installation

• npm i multichain-wallet-react-native@latest
• npm install react-native-get-random-values --save
• npm install react-native --save

Features

• Create EVM-compatible wallets (Ethereum, etc.)
• Retrieve wallet addresses from mnemonics
• Export and Import private keys from mnemonics
• exportPrivateKeyFromKeystore
• importMnemonic
• getBalance
• getGasPrice
• getGasLimit
• simulateTransactionCost
• sendTransaction

Usage

• Below are some examples of how to use the library Import

   import { multichainWallet } from 'multichain-wallet-react-native'
   const multichain = new multichainWallet()

Create Wallet

async function generateMnemonic() {
  const passCode = "helloworld"
  const { keystore, privateKey, address, mnemonic } = await multichain.createWalletEVM(passCode);
  console.log(JSON.stringify(keystore), privateKey, address, mnemonic);
}
// Note: Mnemonics with less than 12 words have low entropy and may be guessed by an attacker.
generateMnemonic();

• Response

  {"address":"1f9cc534ff25f2abe1753eb882b20130adcb2748","id":"7378bcf5-c84d-4212-91b2-e2585f169a0f","version":3,"Crypto":{"cipher":"aes-128-ctr","cipherparams":{"iv":"1b12b9f04deb0878ccb7c47e01db3e3e"},"ciphertext":"480f41097b245cad8dfe8a650867d225b27b6ec5da10bd6d91d4bb3578384f26","kdf":"scrypt","kdfparams":{"salt":"a81a1802241699efd215129281534678cf50e75a88db0ab04d9a35b3836ab27f","n":131072,"dklen":32,"p":1,"r":8},"mac":"83334806b2a436746325d8508610afe3c0c3ec51b41a80dbafc7aa8d5617bb2f"},"x-ethers":{"client":"ethers/6.11.1","gethFilename":"UTC--2024-02-15T17-47-15.0Z--1f9cc534ff25f2abe1753eb882b20130adcb2748","path":"m/44'/60'/0'/0/0","locale":"en","mnemonicCounter":"5f9832ed80383d6bd8d70f5c95a53027","mnemonicCiphertext":"f04fb4297e915ac04bffa6d46513544a","version":"0.1"}}
0x502bec5f280a5649b63e20a33dabf2e9009a029a6f23d82255338aac8cd5fce3 
0x1f9cc534FF25f2ABE1753eB882B20130adcb2748
 [
  'execute',  'salt',
  'describe', 'expect',
  'rescue',   'island',
  'script',   'check',
  'fiscal',   'october',
  'breeze',   'venue'
]  
}

Get EVM Wallet Address from Mnemonic

async function getAddress() {
  const mnemonic = [
        'cream',
        'frozen',
        'weather',
        'group',
        'track',
        'parrot',
        'stove',
        'just',
        'license',
        'collect',
        'mandate',
        'arrest',
      ];
  const mnemonicPhrase = mnemonic.join('')
  const { address } = await multichain.getAddressFromMnemonic(mnemonicPhrase);
  console.log(`Address: ${address}`);
}

getAddress();

• Reponse

{
  address: '0xfBE11AC0258cc8288cA24E818691Eb062f7042E9',
}

Export PrivateKey From Mnemonic

 async function getPrivateKey() {
   const mnemonic = [
        'cream',
        'frozen',
        'weather',
        'group',
        'track',
        'parrot',
        'stove',
        'just',
        'license',
        'collect',
        'mandate',
        'arrest',
      ];
  const mnemonicPhrase = mnemonic.join(' ')
  const { privateKey } = await multichain.exportPrivateKeyFromMnemonic(mnemonicPhrase);
  console.log(`Private Key: ${privateKey}`);
}

getPrivateKey();

• Reponse

{
  privateKey: '0xfdf745f45d1942feea79b4c0a3fc1ca67da366899f7e6cebaa06496806ca8127',
}

Export PrivateKey From Keystore

 async function getPrivateKey() {
  const passCode = "helloworld"
  cont keyStore = { } //the keystore object returned when creating a wallet
  const { privateKey } = await multichain.exportPrivateKeyFromKeystore(keyStore, passCode);
  console.log(`Private Key: ${privateKey}`);
}

getPrivateKey();

• Reponse

{
  privateKey: '0xfdf745f45d1942feea79b4c0a3fc1ca67da366899f7e6cebaa06496806ca8127',
}

Import wallet from PrivateKey

 async function importWalletFromKey() {
  const passCode = "helloworld"
  cont privateKey = "0xfdf745f45d1942feea79b4c0a3fc1ca67da366899f7e6cebaa06496806ca8127" //the privateKey to which you want to import the wallet
  const { keyStore } = await multichain.importPrivateKey(privateKey, passCode);
  console.log(`Kestore Key: ${keyStore}`);
}
importWalletFromKey();

• Reponse Returns a keyStore object where, you can access wallet address, privateKey etc

{
  keyStore: { }
}

Import Wallet from Mnemonic

 async function importWalletMnemonic() {
  const passCode = "helloworld"
  const mnemonic = [
        'cream',
        'frozen',
        'weather',
        'group',
        'track',
        'parrot',
        'stove',
        'just',
        'license',
        'collect',
        'mandate',
        'arrest',
      ];  //the mnemonic to which you want to import the wallet
  const mnemonicPhrase = mnemonic.join(' ')
  const { keyStore } = await multichain.importPrivateKey(mnemonicPhrase, passCode);
  console.log(`Kestore Key: ${keyStore}`);
}
importWalletMnemonic();

• Reponse Returns a keyStore object where, you can access wallet address, privateKey etc

{
  keyStore: { }
}

verifyMnemonic

async function verifyMnemonic() {
 passCode = "helloworld"
 const mnemonic = [
       'cream',
       'frozen',
       'weather',
       'group',
       'track',
       'parrot',
       'stove',
       'just',
       'license',
       'collect',
       'mandate',
       'arrest',
     ];  //the mnemonic to which you want to verify
 const mnemonicPhrase = mnemonic.join(' ')
 const { verify } = await multichan.verifyMnemonic(mnemonicPhrase, passCode);
 console.log(` verification  ${verify}`);
}
verifyMnemonic();

• Reponse Returns a boolen: true or false

{
  verify: true
}

getNativeBalance

const getBalanceNative = async()=>{
   const userAddress = "0x86bc300654DE52620bB871E8B0922e52d4a06E43";  
  const networkDetail = { rpcUrl: "https://go.getblock.io/31788de76faf4a1bb4f3e02d53ab32fc",  chainId:"56" }; 
   const { balance}=  await multichan.getBalanceNative(userAddress, networkDetail);

  console.log({balance})
}
getBalanceNative()

• Reponse Returns the native wallet balance formatted

{
  balance: "0.0004"
}

getBalanceERC20

const getBalanceERC20 = async()=>{
  const walletAddress = "0x86bc300654DE52620bB871E8B0922e52d4a06E43";
  const networkDetail = { rpcUrl: "https://bsc-mainnet.nodereal.io/v1/2bdae634f9e947bd90b08c63b3e21c0c",  chainId:"56" }; 
  const tokenAddress = "0xEF0146906fA7d0cD5Ba997d1F340B714e275317d"
  const { balance } = await multichan.getBalanceERC20(walletAddress, networkDetail, tokenAddress);

   console.log(balance)
}
getBalanceERC20()

• Reponse Returns the erc20 wallet balance formatted

{ balance: '161268.403340769349615978' }

getGasPrice

const getGasPrice = async()=>{
  const networkDetail = { rpcUrl: "https://bsc-mainnet.nodereal.io/v1/2bdae634f9e947bd90b08c63b3e21c0c",  chainId:"56" }; 
  const { gasPrice }= await multichan.getGasPrice(networkDetail);
   console.log(gasPrice)
}
getGasPrice()

• Reponse Returns the network gasPrice in Gwei formatted

{
 gasPrice: '3.0'
}

getGasLimit

const getWalletGasLimit = async()=>{
    const networkDetail = { rpcUrl: "https://bsc-mainnet.nodereal.io/v1/2bdae634f9e947bd90b08c63b3e21c0c",  chainId:"56" }; 
    const tokenAddress = "0xEF0146906fA7d0cD5Ba997d1F340B714e275317d"
    const fromAddress = "0x86bc300654DE52620bB871E8B0922e52d4a06E43" 
  
    const toAddress = "0x68601FCb114F5480D20c0338a63411aaDfe7c9ce"; 
    const amount = "0.00001"; 
    const data = "0x"; 
  const {gasLimit}  = await multichan.getGasLimit(fromAddress, toAddress, amount, data , networkDetail);

   console.log({gasLimit})
}
getWalletGasLimit()

• Reponse Returns the gasLimit of wallet address formatted

{
  gasLimit: "210000"
}

simulateTransactionCost

const  simulateTransactionCost = async()=>{
     const networkDetail = { rpcUrl: "https://bsc-mainnet.nodereal.io/v1/2bdae634f9e947bd90b08c63b3e21c0c",  chainId:"56" }; 
    const fromAddress = "0x86bc300654DE52620bB871E8B0922e52d4a06E43" 
    const toAddress = "0x68601FCb114F5480D20c0338a63411aaDfe7c9ce"; 
    const amount = "0.00001"; 
    const data = "0x"; 
  const { totalCost}  = await multichan.simulateTransactionCost(fromAddress, toAddress, amount, data , networkDetail);

   console.log({totalCost})
}
simulateTransactionCost()

• Reponse Returns the totalCost of the transaction after simulation formatted.

{
  totalCost: "0.002"
}

sendTransaction

const  sendTransaction = async()=>{
const signer ="6c7a59f2f019ed9ae8eef9e5bae9e83a837a2f67197011257bd4c0ef6611a300";

  const networkDetail = {
    rpcUrl:
      "https://bsc-mainnet.nodereal.io/v1/2bdae634f9e947bd90b08c63b3e21c0c",
    chainId: "56",
  };
  const toAddress = "0x68601FCb114F5480D20c0338a63411aaDfe7c9ce";
  const amount = "0.00001";
  const { transactionHash } = await multichan.sendTransaction(
    signer,
    toAddress,
    amount,
    networkDetail
  );

  console.log({ transactionHash });
}
sendTransaction()

• Reponse Returns the transaction hash of the transaction after the transaction broadcasted.

{
  transactionHash: "0x03854356645396097a8e528e3c27f97107ecc98f2ac9296427d8e3782b91a2c5"
}

Contributing

• Contributions are welcome! Please feel free to submit a pull request or open an issue.