A high-level TypeScript library that makes BSV blockchain development simple. Build wallets, send payments, create tokens, issue credentials, and more — in just a few lines of code.
@bsv/simple wraps the low-level @bsv/sdk into a clean, modular API. Instead of manually constructing locking scripts, managing key derivation, and handling transaction internalization, you call methods like wallet.pay(), wallet.createToken(), and wallet.inscribeText().
| Feature | Description |
|---|---|
| Payments | Send BSV to any identity key with optional memos and change recovery |
| Multi-Output Transactions | Combine P2PKH payments, OP_RETURN data, and PushDrop tokens in a single transaction |
| Encrypted Tokens | Create, transfer, and redeem PushDrop tokens with encrypted payloads |
| Inscriptions | Write text, JSON, or file hashes permanently to the blockchain |
| MessageBox P2P | Send and receive payments and tokens peer-to-peer via MessageBox |
| Certification | Issue and manage BSV certificates with a standalone Certifier |
| Verifiable Credentials | W3C-compatible VCs backed by BSV certificates, with on-chain revocation |
| DIDs | Generate and resolve did:bsv: Decentralized Identifiers |
| Overlay Networks | Broadcast to and query SHIP/SLAP overlay services |
| Server Wallet | Run a backend wallet for automated operations and funding flows |
The library has two entry points:
@bsv/simple/browser— UsesWalletClientfrom@bsv/sdkto connect to the user's browser wallet extension (MetaNet Client). No private keys in the browser.@bsv/simple/server— Uses@bsv/wallet-toolboxto run a wallet from a private key on the server. Used for automated operations, payment processing, and funding flows.
Both entry points provide the same API surface — the only difference is how they connect to the underlying wallet.
import { createWallet } from '@bsv/simple/browser'
// Connect to the user's wallet
const wallet = await createWallet()
// Send a payment
await wallet.pay({ to: recipientKey, satoshis: 1000, memo: 'Coffee' })
// Create an encrypted token
await wallet.createToken({ data: { type: 'loyalty', points: 50 }, basket: 'rewards' })
// Inscribe text on-chain
await wallet.inscribeText('Hello BSV!')
// Get your DID
const did = wallet.getDID()
// { id: 'did:bsv:02abc...', ... }- Quick Start — Get running in 5 minutes
- Installation — Detailed setup instructions
- Architecture — How the library is built