@funded-labs/plug-controller/README.md

Internet Computer Plug wallet's controller

![](https://storageapi.fleek.co/fleek-team-bucket/plug-banner.png)

# Plug Controller - Controller functions for the Plug Extension

## Introduction

The Plug Controller is a package that provides utility & logic to the Plug browser wallet extension, as well as the account creation and management. It handles the interactions between the extension and the Internet Computer as users interact with accounts, balances, canisters, and the network.

## Installation

```
npm install @funded-labs/plug-controller
```

## Plug KeyRing

A Plug Keyring is a class that manages the user's accounts and allow you to create/import a mnemonic and its keypair.

```
import PlugController from '@funded-labs/plug-controller';

const keyRing = new PlugController.PlugKeyRing();

// Initialize keyring and load state from extension storage
await keyRing.init();
```

### Keyring Creation

```
// Creates the keyring and returns the default wallet
const wallet: PlugWallet = await keyRing.create(password);
```

### Mnemonic Import

```
// Creates the keyring using the provided mnemonic and returns the default wallet
const wallet: PlugWallet = await keyRing.importFromMnemonic(mnemonic, password);
```

## Documentation

Interface and Type definitions documents for the **@funded-labs/plug-controller** implementation is provided in the following [location](https://twilight-dream-0902.on.fleek.co/).

These are based in the `main release branch` and provide a good overview of the whole package (modules, IDL's, utils, etc).