Package Exports

@unc-wallet-selector/ledger
@unc-wallet-selector/ledger/index.cjs
@unc-wallet-selector/ledger/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@unc-wallet-selector/ledger) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@unc-wallet-selector/ledger

This is the Ledger package for NEAR Wallet Selector.

Installation and Usage

The easiest way to use this package is to install it from the NPM registry, this package requires near-api-js v1.0.0 or above:

# Using Yarn
yarn add near-api-js

# Using NPM.
npm install near-api-js

# Using Yarn
yarn add @unc-wallet-selector/ledger

# Using NPM.
npm install @unc-wallet-selector/ledger

Then use it in your dApp:

import { setupWalletSelector } from "@unc-wallet-selector/core";
import { setupLedger } from "@unc-wallet-selector/ledger";

// Ledger for Wallet Selector can be setup without any params or it can take few optional params, see options below.
const ledger = setupLedger({
  iconUrl: "https://<Wallet Icon URL Here>" // optional
});

const selector = await setupWalletSelector({
  network: "testnet",
  modules: [ledger],
});

Options

iconUrl: (string?): Image URL for the icon shown in the modal. This can also be a relative path or base64 encoded image. Defaults to ./assets/ledger-icon.png.
deprecated: (boolean?): Deprecated is optional. Default is false.

Assets

Assets such as icons can be found in the /assets directory of the package. Below is an example using Webpack:

import { setupLedger } from "@unc-wallet-selector/ledger";
import ledgerIconUrl from "@unc-wallet-selector/ledger/assets/ledger-icon.png";

const ledger = setupLedger({
  iconUrl: ledgerIconUrl
});

Known issues

Existing dApps with Ledger support integrated may encounter this error Device is already open, it means your current integration and this package are conflicting and two ledger instances are being created. Avoid this scenario by supporting only this package.

License

This repository is distributed under the terms of both the MIT license and the Apache License (Version 2.0).