> 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.