nwc-enclaved-utils

Utilities to work with nwc-enclaved Lightning Wallets.

Create wallet

You can create a Lightning Wallet using our helper function createWallet:

import { createWallet } from "nwc-enclaved-utils";

const { nwcString, lnAddress } = await createWallet();

// `nwcString` can be used with NWC sdk to use the wallet
console.log("nwcString", nwcString);
// `lnAddress` can be published in a nostr profile to receive zaps
console.log("lnAddress", lnAddress);

Wallet usage

After you created a wallet, you will receive an nwcString. This connection string can be used with wallets like Alby Go or NWC SDK libraries like Alby SDK. Learn more about NWC here.

import { createWallet } from "nwc-enclaved-utils";
import { nwc } from "@getalby/sdk";

const { nwcString } = await createWallet();

const nwcClient = new nwc.NWCClient({
  nostrWalletConnectUrl: nwcString,
});

// get balance (returns 0 for new wallet)
const balance = await nwcClient.getBalance();
console.log("balance", balance);

// create invoice to topup the wallet,
// NOTE: amount is in millisats
const invoince = await nwcClient.makeInvoice({ amount: 10000 });
console.log("invoice", invoince);

Receiving Zaps

After you created a wallet you can publish a Nostr profile with the returned lnAddress using our helper function createNostrProfile. This Nostr profile will then be able to receive zaps into your new wallet.

import { createWallet, createNostrProfile } from "nwc-enclaved-utils";
import { nwc } from "@getalby/sdk";

const { nwcString, lnAddress } = await createWallet();

// NOTE: use nwcString to access your wallet

// publish Nostr profile to receive Zaps
const { privkey, npub, relays } = await createNostrProfile({
  name: "NewUserName",
  lnAddress,
});

// You can now search this `npub` in some Nostr client
console.log("profile npub", npub);

// NOTE: use `privkey` to sign Nostr events of this new profile,
// use `relays` to publish the signed events.

You can also update an existing Nostr profile by setting the lud16 profile field to your lnAddress.