@rsksmart/rlogin-dcent-provider NPM

A D'Cent provider connection for rLogin. Still in beta and tested manually for now.

Features

Allow users to connect to your dapp using a D'cent device. Currently works with USB and returns an EIP1193 provider.

Implementation

The implementation is a bit different for D'cent because it is not a Web3Modal supported provider.

Add the dependecy to your project

yarn add @rsksmart/rlogin-dcent-provider --save

In your dapp, your rLogin implementation should be similar to this:

import RLogin from '@rsksmart/rlogin'
import { dcentProviderOptions } from '@rsksmart/rlogin-dcent-provider'

// ...

const rLogin = new RLogin({
  cacheProvider: false,
  providerOptions: {
    // ... other providers, i.e. WalletConnect or Portis, etc
      'custom-dcent': {
      ...dcentProviderOptions,
      options: {
        rpcUrl: 'https://public-node.testnet.rsk.co',
        chainId: 31,
        debug: true
      }
  },
  supportedChains: [30, 31]
})

Security advice

Protect your cold wallet with your finger print/pin. Do the same for your app.

Setup

After you secure your wallet, you need to create an account to do transactions. You can do this from your cold wallet or from your App.

Firmware update

We strongly recommend update your cold wallet firmware to the latest version.

App or software walllet

Android and Iphone supported. D'cent have an app for manage accounts and networks: https://dcentwallet.com/MobileApp For testnet you need to go to "Setting" and enable testnet support. After that go to "Discovery" and find the "Network" option to change the network.

Pair your wallet

App needed. Remember turn on the "Bluetooth" from your cellphone for pair the D'cent wallet. Now you can press the "Bluetooth red icon" in the "Account" option for list your cold wallets in range and be paired. You will see a blue led dot in the right corner of your cold wallet if you succeed.

Docs

You can check the official documentation here: https://userguide.dcentwallet.com/

Implementation notes

Similar to the Portis connector, you can only specify a single chainId to connect to.
The custom- needs to be connection data and provider configuration. The ...dcentProviderOptions contains the D'cent text and image and connects rLogin to the provider.
pass debug: true for console logs that may help you debug.

Run for development

Install dependencies:

yarn i

Run unit tests

yarn test

Coverage report with:

yarn run test:coverage

Run linter

yarn run lint

Auto-fix:

yarn run lint:fix

Build for production

yarn run build

Disclaimer

@rsksmart/rlogin-dcent-provider depends on @rsksmart/dcent-provider that is a fork from dcent-provider, modified just to allow using RSK standard derivation path. The latest has dependencies with known vulnerabilities not yet fixed, and a -beta tag on its name. This being said, Any problem caused by this is under the responsibility of whoever installs this package. We are going to keep our -beta tag until this is fixed.