v7.0.0

In this release we add support for multiple NWC relays.

A breaking change is in this release to accept relayUrls instead of a single relayUrl.

What's Changed

• feat: support multiple relays by @rolznz in #486
• chore(deps-dev): bump ts-jest from 29.4.1 to 29.4.5 by @dependabot[bot] in #497
• chore(deps-dev): bump @commitlint/cli from 19.8.1 to 20.1.0 by @dependabot[bot] in #498
• chore(deps-dev): bump jest from 30.0.5 to 30.2.0 by @dependabot[bot] in #499
• chore(deps-dev): bump rollup from 4.46.2 to 4.52.5 by @dependabot[bot] in #500
• chore(deps-dev): bump @rollup/plugin-typescript from 12.1.4 to 12.3.0 by @dependabot[bot] in #502

Full Changelog: v6.0.2...v7.0.0

v6.0.2

In this release we fix an issue where subscriptions were no longer working after a relay disconnection (fixed by updating nostr-tools dependency), and an issue with the Alby Wallet API when querying transactions using nested filtering parameters.

What's Changed

Fixes

• fix(query): improve buildQueryString for nested params and update GetInvoicesRequestParams by @Dunsin-cyber in #475

Misc

• chore: Rewrite Examples in examples/oauth in Typescript by @Dunsin-cyber in #471
• chore: introduce helper for auth flow + test in invoices.ts by @Dunsin-cyber in #480
• chore: use Helper Function in OAuth Exmaples by @Dunsin-cyber in #485
• chore: Allow passing additional scopes to getAuthClient in examples helper function by @Dunsin-cyber in #489
• chore: add decrypt error handling in subscribeNotifications by @rolznz in #490
• chore: bump nostr tools (fixes subscription onclose not firing) by @rolznz in #491
• chore(deps): bump @getalby/lightning-tools from 5.2.1 to 6.0.0 by @dependabot[bot] in #455
• chore(deps-dev): bump jest and @types/jest by @dependabot[bot] in #454
• chore(deps-dev): bump lint-staged from 16.1.4 to 16.2.4 by @dependabot[bot] in #487
• chore(deps-dev): bump rollup-plugin-dts from 6.2.1 to 6.2.3 by @dependabot[bot] in #477
• chore(deps-dev): bump typescript from 5.8.3 to 5.9.3 by @dependabot[bot] in #483
• chore(deps-dev): bump @types/node from 24.2.0 to 24.9.1 by @dependabot[bot] in #492
• chore(deps-dev): bump @commitlint/config-conventional from 19.8.1 to 20.0.0 by @dependabot[bot] in #493
• chore(deps-dev): bump @rollup/plugin-node-resolve from 16.0.1 to 16.0.3 by @dependabot[bot] in #494
• chore(deps-dev): bump @rollup/plugin-commonjs from 28.0.6 to 28.0.8 by @dependabot[bot] in #495
• chore: bump version to 6.0.2 by @rolznz in #496

Full Changelog: v6.0.1...v6.0.2

v6.0.1

What's Changed

• chore: add accepted option to transaction state (for hold invoices) by @rolznz in #461
• chore: change umd bundle filename by @im-adithya in #472
• chore(deps): bump nostr-tools from 2.15.0 to 2.16.2 by @dependabot[bot] in #458
• chore: log connection error when failing to reconnect to relay by @rolznz in #476
• Convert the send-multi-payment example to TypeScript by @Dunsin-cyber in #459
• Convert the send-payment example to Typescript by @Dunsin-cyber in #460
• Convert the sign-message example to Typescript by @Dunsin-cyber in #462
• Convert Create Connection to Typescript by @Dunsin-cyber in #463
• Convert get-balance to Typescript by @Dunsin-cyber in #465
• Convert get-budget to Typescript by @Dunsin-cyber in #466
• Convert get-info to Typescript by @Dunsin-cyber in #467
• Convert JS examples to TS in /nwc/client by @Dunsin-cyber in #468

Full Changelog: v6.0.0...v6.0.1

v6.0.0

Migration

⚠️ Breaking Changes

We removed the legacy namespace exports from the main SDK bundle, so importing like this won't work anymore:

- import { nwc } from '@getalby/sdk'
console.log(nwc.NWCWalletService)

Instead you can do it like:

+ import { NWCWalletService } from '@getalby/sdk'
console.log(NWCWalletService)

or you can use subpath imports.

✨ New Subpath Import (Recommended)

For better tree-shaking, you can also import directly from the nwc subpath (and similarly for lnclient, oauth and webln)

+ import { NWCWalletService } from '@getalby/sdk/nwc'
console.log(NWCWalletService)

What's Changed

• feat: add subpath imports and fix bundling issues by @im-adithya in #443
• chore: update dependencies by @im-adithya in #445
• fix: package json and examples fixes by @im-adithya in #452
• chore: upgrade dev dependencies by @im-adithya in #453
• chore: bump version to 6.0.0 by @im-adithya in #446

Full Changelog: v5.1.2...v6.0.0

v5.1.2

What's Changed

• fix: add lud16 to getNostrWalletConnectUrl by @rolznz in #444
• chore: (examples/nwc) rewrite make-invoice in typescript by @Dunsin-cyber in #434
• chore: (examples/nwc) rewrite multi-keysend in typescript by @Dunsin-cyber in #438
• chore: bump lightning tools dependency by @rolznz in #432
• chore: update node id for keysend example by @Dunsin-cyber in #442

Full Changelog: v5.1.1...v5.1.2

v5.1.1

In this change we remove preimage presence validation (preimage can be fully validated using Alby js-lightning-tools).

Also we migrate a number of examples to typescript. Thanks @Dunsin-cyber !

What's Changed

Fixes

• fix: remove preimage presence validation in pay_invoice method by @rolznz in #430

Misc

• feat(example/nwc) : rewrite get-balance in typescript by @Dunsin-cyber in #413
• feat(examples/nwc) ; rewrite get-info in typescript by @Dunsin-cyber in #421
• feat(examples/nwc) ; rewrite keysend in typescript by @Dunsin-cyber in #425
• feat(examples/nwc) : rewrite list-transactions in typescript by @Dunsin-cyber in #427
• feat(examples/nwc): rewrite lookup-invoice in typescript by @Dunsin-cyber in #428
• feat: Rewrite Paywall in Typescript by @Dunsin-cyber in #403
• feat: Rewrite spliiter.js to ts to show split payment example by @Dunsin-cyber in #405
• chore: setup TypeScript support and package config in examples folder by @Dunsin-cyber in #387
• chore(deps): bump @getalby/lightning-tools from 5.1.2 to 5.2.0 by @dependabot in #400
• chore(deps): bump nostr-tools from 2.12.0 to 2.13.2 by @dependabot in #407
• chore(deps): bump nostr-tools from 2.13.2 to 2.15.0 by @dependabot in #415
• chore(deps): bump brace-expansion from 2.0.1 to 2.0.2 in /examples by @dependabot in #416

New Contributors

• @Dunsin-cyber made their first contribution in #387

Full Changelog: v5.1.0...v5.1.1

v5.1.0

What's Changed

• feat: add hold invoice NWC methods and notification type by @rolznz in #382
• chore: add recipient_data to tx metadata by @im-adithya in #393
• chore: add LN paywall esm example by @rolznz in #365
• docs: update esm example by @rolznz in #364
• docs: fix sdk version in esm example by @rolznz in #366
• chore(deps): bump nostr-tools from 2.9.4 to 2.12.0 by @dependabot in #368
• chore(deps-dev): bump prettier from 3.5.1 to 3.5.3 by @dependabot in #333
• chore(deps-dev): bump @commitlint/config-conventional from 19.7.1 to 19.8.0 by @dependabot in #340
• chore(deps-dev): bump @commitlint/cli from 19.7.1 to 19.8.0 by @dependabot in #345
• chore(deps-dev): bump @types/node from 22.13.10 to 22.15.21 by @dependabot in #394
• chore(deps-dev): bump ts-jest from 29.2.6 to 29.3.4 by @dependabot in #391
• chore(deps-dev): bump lint-staged from 15.4.3 to 16.0.0 by @dependabot in #388
• chore(deps-dev): bump eslint-config-prettier from 10.1.2 to 10.1.5 by @dependabot in #385
• chore(deps-dev): bump express from 4.21.2 to 5.1.0 by @dependabot in #372

Full Changelog: v5.0.0...v5.1.0

v5.0.0

In this release, we introduce a new LN class which makes it even easier to get quickly started sending and receiving bitcoin payments. We also add a NWCWalletService class which allows wallet developers to add NWC support without having to implement the low-level NWC code of creating and signing events, relay connection, etc.

Breaking changes: some imports have been slightly changed.

What's Changed

• feat: add NWC Wallet Service by @rolznz in #346
• feat: add simpler LNClient class by @rolznz in #344
• docs: fix typo in oauth README by @rolznz in #360
• docs: fix more typos by @rolznz in #361
• chore: add missing fees_paid and total_count fields to nwc response types by @rolznz in #339
• chore(deps-dev): bump @types/node from 22.13.5 to 22.13.10 by @dependabot in #341
• chore: rename LNClient receive method to requestPayment by @rolznz in #359
• chore(deps-dev): bump eslint-config-prettier from 10.0.1 to 10.1.2 by @dependabot in #358
• chore(deps-dev): bump typescript from 5.7.3 to 5.8.3 by @dependabot in #354
• chore: bump version to 5.0.0 by @rolznz in #363

Full Changelog: v4.1.1...v5.0.0

v4.1.1

What's Changed

• fix: re-subscribe after relay disconnections in NWAClient by @rolznz in #331

Full Changelog: v4.1.0...v4.1.1

v4.1.0

What's Changed

New features

• feat: NWA by @rolznz in #298
• feat: add sign message method to Alby OAuth Client by @pavanjoshi914 in #323

Misc

• fix: nwc auth docs, husky commit by @rolznz in #325
• chore: switch to encryption tag from versioning by @im-adithya in #309
• chore(deps-dev): bump @types/node from 22.13.4 to 22.13.5 by @dependabot in #327
• chore(deps-dev): bump ts-jest from 29.2.5 to 29.2.6 by @dependabot in #328
• chore(deps-dev): bump @commitlint/config-conventional from 19.6.0 to 19.7.1 by @dependabot in #326
• chore(deps-dev): bump @commitlint/cli from 19.4.1 to 19.7.1 by @dependabot in #316
• chore: bump version to 4.1.0 by @rolznz in #330

Full Changelog: v4.0.0...v4.1.0