# Web3 Wallet Kit

### Introduction <a href="#introduction" id="introduction"></a>

This kit will help connect you dApp to different Ethereum wallets, e.g. Metamask. With web3-wallets-kit, you can create Web3WalletsManager and connect your dApp to the wallet of your choice using one of the supported wallet integrations.

### Github repo:&#x20;

{% embed url="<https://github.com/akropolisio/web3-wallets-kit>" %}

### Wallet integrations: <a href="#wallet-integrations" id="wallet-integrations"></a>

| Wallet                                                                                                                   | Integration Package                                                                                                       | Size                                                                                                                                                                                |
| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Inpage (Extensions like [Metamask](https://metamask.io/) or Web3 browsers like [Cipher](https://www.cipherbrowser.com/)) | [`@web3-wallets-kit/inpage-connector`](https://wiki.akropolis.io/web3walletkit/packages/inpage-connector)                 | [![minzip](https://badgen.net/bundlephobia/minzip/@web3-wallets-kit/inpage-connector)](https://bundlephobia.com/result?p=@web3-wallets-kit/inpage-connector@latest)                 |
| [WalletConnect](https://walletconnect.org/)                                                                              | [`@web3-wallets-kit/connect-wallet-connector`](https://wiki.akropolis.io/web3walletkit/packages/connect-wallet-connector) | [![minzip](https://badgen.net/bundlephobia/minzip/@web3-wallets-kit/connect-wallet-connector)](https://bundlephobia.com/result?p=@web3-wallets-kit/connect-wallet-connector@latest) |
| [Bitsky](https://www.bitski.com/)                                                                                        | [`@web3-wallets-kit/bitski-connector`](https://wiki.akropolis.io/web3walletkit/packages/bitski-connector)                 | [![minzip](https://badgen.net/bundlephobia/minzip/@web3-wallets-kit/bitski-connector)](https://bundlephobia.com/result?p=@web3-wallets-kit/bitski-connector@latest)                 |
| [Fortmatic](https://fortmatic.com/)                                                                                      | [`@web3-wallets-kit/fortmatic-connector`](https://wiki.akropolis.io/web3walletkit/packages/fortmatic-connector)           | [![minzip](https://badgen.net/bundlephobia/minzip/@web3-wallets-kit/fortmatic-connector)](https://bundlephobia.com/result?p=@web3-wallets-kit/fortmatic-connector@latest)           |
| [Portis](https://www.portis.io/)                                                                                         | [`@web3-wallets-kit/portis-connector`](https://wiki.akropolis.io/web3walletkit/packages/portis-connector)                 | [![minzip](https://badgen.net/bundlephobia/minzip/@web3-wallets-kit/portis-connector)](https://bundlephobia.com/result?p=@web3-wallets-kit/portis-connector@latest)                 |
| [Squarelink](https://squarelink.com/)                                                                                    | [`@web3-wallets-kit/squarelink-connector`](https://wiki.akropolis.io/web3walletkit/packages/squarelink-connector)         | [![minzip](https://badgen.net/bundlephobia/minzip/@web3-wallets-kit/squarelink-connector)](https://bundlephobia.com/result?p=@web3-wallets-kit/squarelink-connector@latest)         |
| [Torus](https://tor.us/)                                                                                                 | [`@web3-wallets-kit/torus-connector`](https://wiki.akropolis.io/web3walletkit/packages/torus-connector)                   | [![minzip](https://badgen.net/bundlephobia/minzip/@web3-wallets-kit/torus-connector)](https://bundlephobia.com/result?p=@web3-wallets-kit/torus-connector@latest)                   |
| [Ledger](https://www.ledger.com/)                                                                                        | Coming soon                                                                                                               |                                                                                                                                                                                     |

### Installation <a href="#installation" id="installation"></a>

`npm install --save @web3-wallets-kit/core`

`npm install --save @web3-wallets-kit/inpage-connector` or another integration

### Creating and managing wallets <a href="#creating-and-managing-wallets" id="creating-and-managing-wallets"></a>

```
import Web3 from 'web3';
import { Web3WalletsManager } from '@web3-wallets-kit/core';
import { InpageConnector } from '@web3-wallets-kit/inpage-connector';

// Create Web3WalletsManager instance
const web3Manager = new Web3WalletsManager<Web3>({
  defaultProvider: {
    network: 'kovan',
    infuraAccessToken: 'INFURA_API_KEY',
  },
  makeWeb3: provider => new Web3(provider), // you can use web3.js, ethers.js or another suitable library
});

// Create connector
const connector = new InpageConnector();

// Connect to wallet
await web3Manager.connect(connector);

// Get address and Web3 for sending transaction
const myAddress = web3Manager.account.value;
const txWeb3 = web3Manager.txWeb3.value;

// Create contract
const daiContract = txWeb3.eth.Contract(DAI_ABI, '0x5592ec0cfb4dbc12d3ab100b257153436a1f0fea');

// Send transaction
await daiContract.methods
  .transfer('0x0000000000000000000000000000000000000000', '1000000000000000000')
  .send({ from: myAddress });
```

### Web3WalletsManager API <a href="#web3walletsmanager-api" id="web3walletsmanager-api"></a>

```
class Web3WalletsManager<W> {
    /** default Web3 instance for reading. Uses a provider created based on defaultProvider options */
    web3: W;
    /** Web3 instance for sending transactions. An instance is created after connecting to the wallet and uses the wallet provider */
    txWeb3: BehaviorSubject<W | null>;
    /** active account address */
    account: BehaviorSubject<string | null>;
    /** active network ID */
    chainId: BehaviorSubject<number | null>;
    /** status of the connection */
    status: BehaviorSubject<ConnectionStatus>;

    constructor(options: Options<W>);

    /** Connect to wallet; Returns account address and Web3 Instance for sending transactions */
    connect(connector: Connector): Promise<ConnectResult>;
    /** Disconnect wallet, close streams */
    disconnect(): Promise<void>;
}

interface Options<W> {
    defaultProvider: {
        httpRpcUrl?: string;
        wsRpcUrl?: string;
        infuraAccessToken?: string;
        /** default: 'mainnet' */
        network?: InfuraNetwork;
    };
    makeWeb3<W>(provider: Provider): W;
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://akropolis.gitbook.io/akropolis/developer-documentation/open-source-development/web3-wallet-kit.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.