@radarrelay/web3-builder
v0.2.0
Published
A tool to build and manage your own Web3 instance.
Downloads
30
Readme
web3-builder
A tool to build and manage your own Web3 instance.
Introduction
This package simplifies the process to create your own Web3 instance, change the active wallet, and update the connection to the Ethereum network.
This is made possible using building blocks called subproviders. Subproviders are like normal web3 providers, but only handle a subset of RPC methods. They can be used to route, or otherwise handle, RPC calls before returning a result to the caller.
web3-builder uses subproviders to build out the Web3 object like so:
If you'd like more flexibility when creating Web3 Providers consider using web3-provider-engine directly.
Installation
npm
npm install @radarrelay/web3-builder
Yarn
yarn add @radarrelay/web3-builder
Usage
Web3 Creation
import { Web3Builder } from '@radarrelay/web3-builder';
import { InjectedWeb3Subprovider } from '@radarrelay/subproviders';
const walletSubprovider = new InjectedWeb3Subprovider(window.web3.currentProvider);
let web3 = Web3Builder.createWeb3(walletSubprovider, InfuraNetwork.Kovan);
Update Wallet
import { EthLightwalletSubprovider } from '@radarrelay/subproviders';
const newWalletSubprovider = new EthLightwalletSubprovider(signing, keystore, pwDerivedKey);
// Updating the wallet returns a new instance of web3
web3 = Web3Builder.updateWallet(newWalletSubprovider);
Update Network
// Updating the rpc connection returns a new instance of web3
web3 = Web3Builder.updateRpcConnection(InfuraNetwork.Mainnet);
Grab the Provider
Want to use your own version of Web3?
You can grab the Ethereum Provider and instantiate your preferred version of Web3:
import * as Web3 from 'web3';
const anotherWeb3Instance = new Web3(web3.currentProvider);
OR
import * as Web3 from 'web3';
const anotherWeb3Instance = new Web3(web3Builder.provider);
Contributing
Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.
License
This project is licensed under the MIT License - see the LICENSE.md file for details.