> For the complete documentation index, see [llms.txt](https://hub.bsvblockchain.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.bsvblockchain.org/bsv-code-academy/bsv-simple/simple-sdk/quick-start.md).

# Quick Start

Get a BSV wallet connected and send your first payment in under 5 minutes.

## Prerequisites

* Node.js 18+
* A BSV wallet browser extension (such as MetaNet Client)
* A funded BSV wallet (mainnet or testnet)

## 1. Install

```bash
npm install @bsv/simple @bsv/sdk
```

## 2. Connect a Wallet

```typescript
import { createWallet } from '@bsv/simple/browser'

const wallet = await createWallet()
console.log('Connected:', wallet.getIdentityKey())
console.log('Address:', wallet.getAddress())
```

`createWallet()` prompts the user to approve the connection via their browser wallet extension. Once approved, you have a fully functional wallet instance with access to all modules.

## 3. Send a Payment

```typescript
const result = await wallet.pay({
  to: '02abc123...',   // recipient's identity key
  satoshis: 1000,
  memo: 'My first payment'
})

console.log('Transaction ID:', result.txid)
```

## 4. Create a Token

```typescript
const token = await wallet.createToken({
  data: { type: 'reward', points: 100 },
  basket: 'my-tokens'
})

console.log('Token created:', token.txid)
```

## 5. List Your Tokens

```typescript
const tokens = await wallet.listTokenDetails('my-tokens')

for (const t of tokens) {
  console.log(t.outpoint, t.data)
  // "abc123.0" { type: 'reward', points: 100 }
}
```

## 6. Inscribe Data On-Chain

```typescript
const inscription = await wallet.inscribeText('Hello blockchain!')
console.log('Inscribed:', inscription.txid)
```

## What's Next?

| Guide                                                                                               | What you'll learn                                              |
| --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| [Browser Wallet](/bsv-code-academy/bsv-simple/simple-sdk/browser-wallet.md)                         | Full wallet setup, wallet info, key derivation                 |
| [Payments](/bsv-code-academy/bsv-simple/simple-sdk/browser-wallet/payments.md)                      | Simple payments, multi-output sends, BRC-29 payments           |
| [Tokens](/bsv-code-academy/bsv-simple/simple-sdk/browser-wallet/tokens.md)                          | Create, list, send, redeem, and transfer tokens via MessageBox |
| [Server Wallet](/bsv-code-academy/bsv-simple/simple-sdk/browser-wallet/server-wallet.md)            | Run a backend wallet, accept funding from browser wallets      |
| [Next.js Integration](/bsv-code-academy/bsv-simple/simple-sdk/browser-wallet/nextjs-integration.md) | Set up a full-stack BSV app with Next.js                       |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://hub.bsvblockchain.org/bsv-code-academy/bsv-simple/simple-sdk/quick-start.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.