@unc-wallet-selector/here-wallet

This is the Here Wallet 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/here-wallet

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

Then use it in your dApp:

import { setupWalletSelector } from "@unc-wallet-selector/core";
import { setupHereWallet } from "@unc-wallet-selector/here-wallet";

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

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

Here Wallet JS SDK

The library uses @here-wallet/core, you can read more about the functionality here: https://github.com/here-wallet/js-sdk

Instant Wallet with AppClip

If your goal is to provide the user with a convenient way to log in to your desktop app, you can use Here Instant Wallet, which allows users without a wallet to instantly create one via appclip.

At the moment here wallet is only available for IOS users

You have the option to override how your user is delivered the signing link. This is how you can create a long-lived transaction signature request and render it on your web page:

import { QRCodeStrategy } from "@here-wallet/core/qrcode-strategy";
const isHereWallet = (w: Wallet): w is HereWallet => w.id === "here-wallet";

// Correct typings
if (isHereWallet(wallet)) {
  await here.signIn({
    contractId: "social.near",
    strategy: new QRCodeStrategy({ 
      element: document.getElementById("qr-container"), 
      theme: 'dark'
    }),
  });
}

Options

• iconUrl: (string?): Icon is optional. Default image point to Here Wallet Logo in base64 format.
• deprecated: (boolean?): Deprecated is optional. Default is false.
• defaultStrategy: (() => HereStrategy?): DefaultStrategy is optional. Default is undefined.
• defaultProvider: (HereProvider): HereProvider is optional. Default is undefined.

Assets

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

import { setupHereWallet } from "@unc-wallet-selector/here-wallet";
import HereWalletIconUrl from "@unc-wallet-selector/here-wallet/assets/here-wallet-icon.png";

const hereWallet = setupHereWallet({ 
  iconUrl: HereWalletIconUrl 
});

License

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