Overview

Lute Connect is a Javascript library to securely sign transactions with Lute, an Algorand web wallet and Chrome extension.

Installation

The package can be installed via your favorite package manager:

npm i lute-connect

yarn add lute-connect

pnpm add lute-connect

API Usage

Quick start

import LuteConnect from "lute-connect";
const lute = new LuteConnect();

Connect to Lute

// Warning: Browser will block pop-up if user doesn't trigger lute.connect() with a button click
async function connect() {
  try {
    const genesis = await algodClient.genesis().do();
    const genesisID = `${genesis.network}-${genesis.id}`;
    const addresses = await lute.connect(genesisID);
    // TODO: handle user address selection and storage
  } catch (err) {
    console.error(`[LuteWallet] Error connecting: ${err.message}`);
    throw err;
  }
}

Sign transactions

// Warning: Browser will block pop-up if user doesn't trigger lute.signTxns() with a button click
async function signTransactions(txns) {
  try {
    const signedTxns = await lute.signTxns(txns);
    // TODO: handle signedTxns (e.g. submit to algodClient)
  } catch (err) {
    console.error(
      "[LuteWallet] Error signing transactions: " +
        (err instanceof SignTxnsError
          ? `${err.message} (code: ${err.code})`
          : err.message)
    );
    throw err;
  }
}

Sign data

// Warning: Browser will block pop-up if user doesn't trigger lute.signData() with a button click
async function authenticate() {
  try {
    const siwaRequest: Siwa = {
      domain: location.host,
      chain_id: "283",
      account_address: activeAccount.value.address,
      type: "ed25519",
      statement:
        "Put your own statement here, for example: I accept the ExampleOrg Terms of Service.",
      uri: location.origin,
      version: "1",
      nonce: Buffer.from(randomBytes(12)).toString("base64"),
      "issued-at": new Date().toISOString(),
    };
    // Import or define your canonify function
    const data = Buffer.from(canonify(siwaRequest)).toString("base64");
    const metadata: SignMetadata = {
      scope: ScopeType.AUTH,
      encoding: "base64",
    };
    const signerResponse = await lute.signData(data, metadata);
    // TODO: verify signerResponse
  } catch (err) {
    console.error(
      "[LuteWallet] Error signing data: " +
        (err instanceof SignDataError
          ? `${err.message} (code: ${err.code})`
          : err.message)
    );
    throw err;
  }
}