A single Web3 / Ethereum provider solution for all Wallets
Web3Connect is an easy-to-use library to help developers add support for multiple providers in their apps with a simple customizable configuration.
By default Web3Connect Library supports injected providers like (Metamask, Dapper, Gnosis Safe, Web3 Browsers, etc) and WalletConnect, You can also easily configure the library to support Fortmatic and Portis.
You can test the library on: https://web3connect.com/
Install Web3Connect NPM package
npm install --save web3connect
# OR
yarn add web3connectThen you can integrate it three different ways:
Add Web3Connect Button to your React App as follows
import Web3Connect from "web3connect";
<Web3Connect.Button
providerOptions={{
portis: {
id: "PORTIS_ID", // required
network: "mainnet" // optional
},
fortmatic: {
key: "FORTMATIC_KEY", // required
network: "mainnet" // optional
}
}}
onConnect={(provider: any) => {
const web3 = new Web3(provider); // add provider to web3
}}
onClose={() => {
console.log("Web3Connect Modal Closed"); // modal has closed
}}
/>;Add Web3Connect Core to your Dapp as follows
import Web3Connect from "web3connect";
const web3Connect = new Web3Connect.Core({
providerOptions: {
portis: {
id: "PORTIS_ID", // required
network: "mainnet" // optional
},
fortmatic: {
key: "FORTMATIC_KEY", // required
network: "mainnet" // optional
}
}
});
// subscibe to connect
web3Connect.on("connect", (provider: any) => {
const web3 = new Web3(provider); // add provider to web3
});
// subscibe to close
web3Connect.on("close", () => {
console.log("Web3Connect Modal Closed"); // modal has closed
});
web3Connect.toggleModal(); // open modal on button clickAdd individual connectors for each provider to your own UI (no modal provided)
import Web3Connect from "web3connect";
// For inject providers in dapp browsers
const provider = await Web3Connect.ConnectToInjected();
// For WalletConnect
const provider = await Web3Connect.ConnectToWalletConnect({
bridge: "https://bridge.walletconnect.org" // optional
});
// For Portis
const provider = await Web3Connect.ConnectToPortis({
id: "PORTIS_ID", // required
network: "mainnet" // optional
});
// For Fortmatic
const provider = await Web3Connect.ConnectToFortmatic({
key: "FORTMATIC_KEY", // required
network: "mainnet" // optional
});function checkInjectedProviders(): IInjectedProvidersMap;
function getInjectedProviderName(): string | null;
function getProviderInfoByName(name: string | null): IProviderInfo;
function getProviderInfo(provider: any): IProviderInfo;
function isMobile(): boolean;
function formatProviderDescription(providerInfo: IProviderInfo);interface IProviderInfo {
name: string;
type: string;
logo: string;
check: string;
styled: {
[prop: string]: any;
};
}
interface IProviderOptions {
[providerName: string]: any;
}
interface IEventCallback {
event: string;
callback: (result: any) => void;
}
interface IInjectedProvidersMap {
injectedAvailable: boolean;
[isProviderName: string]: boolean;
}-
providerOptions (optional): An object mapping arbitrary string that adds the required configuration to multiple web3 providers.
-
WalletConnect:
- bridge: bridge url (optional)
-
Portis:
- id: the app id registered (required)
- network: choose initial network name (optional)
- config: additional configuration, like support of Gas Station Network (optional)
-
Fortmatic:
- key: the secret key (required)
- network: choose initial network name (optional)
-
You can disable the injected provider or WalletConnect by adding the following keys:
- disableInjectedProvider: true (optional)
- disableWalletConnect: true (optional)
If you wish to support a new provider submit a issue to the repo or fork this repo and create a pull request.
You can join to our discord to further discuss https://discordapp.com/invite/YGnSX9y
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent