# Find more TypeScript packages

> For the complete documentation index, see [llms.txt](https://bsvblockchain.com/docs/llms.txt).

Find the @bsv/* package for messaging, authentication, payments, overlays and more, with what each one does and its status, on top of @bsv/sdk.

import BlueTable from '/snippets/BlueTable.jsx';

Pick the `@bsv/*` package that adds messaging, API authentication, payments or an overlay service (A service that indexes an app's transactions. Topic managers decide which outputs it admits, and lookup services answer queries about them) to an app built on `@bsv/sdk`, and see what each one does and its status.

## Before you choose a package

Start with `@bsv/sdk` and add the package your app needs next to it. In your project folder, run, for example:

```bash
npm install @bsv/sdk @bsv/wallet-helper
```

The packages declare Node.js 22 or newer, and this page was written against `@bsv/sdk` 4.0.1. Two other pages can settle the choice first:

- To choose between `@bsv/sdk`, `@bsv/simple` and the other packages, see the [SDKs overview](https://bsvblockchain.com/docs/sdk/).
- To build a wallet instead of an app, see [Build a wallet with wallet-toolbox](https://bsvblockchain.com/docs/wallet-dev/wallet-toolbox/).

## Packages with their own page

Three packages have a page of their own:

**[Send messages with @bsv/message-box-client](https://bsvblockchain.com/docs/sdk/packages/message-box-client/)**

Send and receive messages and payments between identities. Stable.

**[Charge for HTTP requests with @bsv/402-pay](https://bsvblockchain.com/docs/sdk/packages/402-pay/)**

Require a BitcoinSV (BSV) micropayment before a route answers, using the HTTP 402 status code. Beta.

**[Run an overlay with @bsv/overlay-express](https://bsvblockchain.com/docs/sdk/packages/overlay-express/)**

Host an overlay service that admits transactions and answers lookups, on an Express server. Stable.

## Find the other packages by task

The rows link to the package folder in [ts-stack](https://github.com/bsv-blockchain/ts-stack), the repository that holds the TypeScript stack. The status is the maturity that ts-stack and the package README give it. A stable package has a locked API. A beta package can still change its API. An experimental package is in early development. The versions are the latest published on npm on 2 November 2026.

### Authenticate and charge the callers of an API

To know which user calls your Express API, start from the [Authenticate users with their wallet](https://bsvblockchain.com/docs/guides/identity-auth/) guide. To charge for routes, the [Gate an API behind payments](https://bsvblockchain.com/docs/guides/payments/) guide uses [`@bsv/402-pay`](https://bsvblockchain.com/docs/sdk/packages/402-pay/).

<BlueTable>

| Package | Version | Status | What it does |
| --- | --- | --- | --- |
| [`@bsv/auth-express-middleware`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/middleware/auth-express-middleware) | 2.3.0 | Stable | Express middleware for BRC-103 (BSV Request for Comments 103, mutual authentication between two peers) mutual authentication. It handles the handshake, verifies each authenticated request and signs the response. |
| [`@bsv/payment-express-middleware`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/middleware/payment-express-middleware) | 2.1.11 | Stable | Express middleware that answers with an HTTP 402 challenge and checks the payment. It runs after `@bsv/auth-express-middleware` and uses the earlier `x-bsv-payment` flow, a different protocol from the BRC-121 (BSV Request for Comments 121, Simple 402 Payments) flow of `@bsv/402-pay`, so choose one of the two for an API. |
| [`@bsv/auth`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/middleware/auth) | 0.1.8 | Beta | Wallet login that does not depend on a web framework. The wallet signs a short-lived proof that it controls an identity key, and the server verifies it and accepts it once. |

</BlueTable>

### Authenticated sockets and Paymail

Open an authenticated Socket.IO connection between a client and a server, or add Paymail (A handle that resolves to a user's identity key. Its domain lists the Paymail services it supports) support to an Express app, with:

<BlueTable>

| Package | Version | Status | What it does |
| --- | --- | --- | --- |
| [`@bsv/authsocket`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/messaging/authsocket) | 2.1.11 | Stable | Server side of Socket.IO with BRC-103 mutual authentication on every connected client. |
| [`@bsv/authsocket-client`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/messaging/authsocket-client) | 2.1.10 | Stable | Client side of the same Socket.IO connection. It signs outbound messages and verifies inbound ones. |
| [`@bsv/paymail`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/messaging/ts-paymail) | 2.4.12 | Stable | A Paymail client and an Express router for capability discovery, public profiles and transaction delivery. |

</BlueTable>

### Build an overlay

[`@bsv/overlay-express`](https://bsvblockchain.com/docs/sdk/packages/overlay-express/) runs an overlay service and builds on `@bsv/overlay` and `@bsv/overlay-discovery-services`. The packages below are the pieces to use on their own or to add to it. To see how an overlay works, read [How overlays work](https://bsvblockchain.com/docs/concepts/overlays/). To use one in an app, follow [Track transactions with overlays](https://bsvblockchain.com/docs/guides/overlays/).

<BlueTable>

| Package | Version | Status | What it does |
| --- | --- | --- | --- |
| [`@bsv/overlay`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/overlays/overlay) | 2.7.0 | Stable | The engine of an overlay service. It admits transactions through topic managers, keeps the state of the outputs and serves lookup services. |
| [`@bsv/overlay-topics`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/overlays/topics) | 2.0.3 | Experimental | Topic managers and lookup services for protocols such as identity certificates, key and value storage, message boxes and file storage. |
| [`@bsv/overlay-discovery-services`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/overlays/overlay-discovery-services) | 2.2.9 | Stable | The SHIP (Services Host Interconnect Protocol) and SLAP (Services Lookup Availability Protocol) services that let overlay nodes advertise the topics they host and the lookup services they offer. |
| [`@bsv/gasp`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/overlays/gasp-core) | 1.3.10 | Stable | The Graph Aware Sync Protocol. It synchronizes transaction data between two parties. Each side fetches only what it does not have and validates what it receives. |

</BlueTable>

### Build transactions and connect wallets

To build transactions or connect your app to a wallet, pick from:

<BlueTable>

| Package | Version | Status | What it does |
| --- | --- | --- | --- |
| [`@bsv/wallet-helper`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/helpers/bsv-wallet-helper) | 0.1.11 | Beta | Transaction builders and script templates that work through a BRC-100 (BSV Request for Comments 100, the standard wallet-to-application interface) wallet, so the application layer does not handle a private key. |
| [`@bsv/templates`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/helpers/ts-templates) | 2.2.0 | Stable | A collection of script templates for `@bsv/sdk`, such as `OpReturn`. |
| [`@bsv/wallet-relay`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/wallet/ts-wallet-relay) | 0.7.0 | Beta | Lets a web app offer a connection to a mobile wallet. The desktop shows a QR code, and the wallet app signs over an encrypted WebSocket relay. |
| [`@bsv/did`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/helpers/did) | 0.3.2 | Beta | Decentralized identifiers (DIDs) for identity keys, a bridge for existing BRC-52 (BSV Request for Comments 52, identity certificates) certificates and helpers for SD-JWT verifiable credentials. |
| [`@bsv/verifast`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/verifast) | 0.3.9 | Beta | Optional script verification for `@bsv/sdk` in WebAssembly. It runs in Node and in the browser. |

</BlueTable>

### Tools and specialized packages

`create-bsv-app` and `@bsv/fund-wallet` are command line tools that you run from a terminal. The other packages are libraries:

<BlueTable>

| Package | Version | Status | What it does |
| --- | --- | --- | --- |
| [`create-bsv-app`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/helpers/create-bsv-app) | 1.2.0 | Stable | Generates a BSV blockchain app with a React, Express or full-stack starter, copies a complete example or adds wallet support to an existing project. See [Start a project from a template](https://bsvblockchain.com/docs/get-started/project-starter/). |
| [`@bsv/fund-wallet`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/helpers/fund-wallet) | 1.5.5 | Stable | Funds a Metanet wallet with BSV, on testnet or Mainnet, chosen with the `--chain` option. |
| [`@bsv/amountinator`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/helpers/amountinator) | 2.1.9 | Stable | Converts between satoshis, BSV and fiat currencies with live exchange rates, and formats amounts for a wallet interface. |
| [`@bsv/teranode-listener`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/network/ts-p2p) | 1.1.9 | Stable | Subscribes to the peer-to-peer topics of Teranode, the next generation BSV blockchain node, over libp2p, with support for private networks. |
| [`@bsv/air-gap`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/helpers/air-gap) | 0.1.3 | Experimental | Sends bytes between two devices through a sequence of QR codes, in one direction only. It implements BRC-141 (BSV Request for Comments 141, the optical air-gap wire protocol), an experimental protocol. |
| [`@bsv/chirp`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/network/chirp) | 0.1.6 | Experimental | The reference implementation of BRC-167 (BSV Request for Comments 167, the Chunked, Hashed, Interleaved Resolution Protocol), which publishes large files in hashed chunks and downloads them progressively on top of UHRP (Universal Hash Resolution Protocol (BRC-26): file storage where a file is found by the hash of its content). |
| [`@bsv/lch`](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/content/lch) | 0.3.0 | Experimental | Implements BRC-170 (BSV Request for Comments 170, the Licensed Content Header protocol), the Licensed Content Header, for encrypted content that buyers pay to open. |

</BlueTable>

## Related articles

To learn more about the TypeScript packages on the BSV blockchain, review these articles:

- [SDKs overview](https://bsvblockchain.com/docs/sdk/)
- [Use the TypeScript SDK](https://bsvblockchain.com/docs/sdk/typescript/)
- [Build apps with @bsv/simple](https://bsvblockchain.com/docs/sdk/simple/)
- [How the BSV blockchain stack fits together](https://bsvblockchain.com/docs/concepts/architecture/)