How do I install the Cashu wallet skill?

Run npx skillmds@latest add cashubtc/cashu-wallet in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Cashu wallet safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Cashu wallet?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Cashu wallet free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Cashu wallet?

cashubtc (@cashubtc) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Cashu wallet by cashubtc — Agent Skill

Name: Cashu wallet
Author: cashubtc

File contents

Cashu Wallet

Cashu Wallet is a lightweight, privacy-focused Bitcoin wallet powered by Cashu ecash. It allows you to send and receive payments instantly using the Lightning Network or by exchanging ecash tokens directly.

🌟 Key Features

Bitcoin over Lightning: Seamlessly send and receive Lightning payments.
Cashu Ecash: Privacy-preserving ecash tokens.
Multi-Mint Support: Connect to multiple mints to diversify risk or support different currencies (sats, usd, eur, etc., depending on the mint).

📦 Installation & Setup

The wallet is a Node.js CLI application located in this directory.

Install Dependencies:
```
cd cli
npm install
```
Create Alias (Optional but Recommended): To make commands easier to run, you can create an alias:
```
alias cashu='node cli/wallet.mjs'
```

🚀 Usage Guide

All commands can be run using node cli/wallet.mjs <command> (or cashu <command> if aliased).

1. Managing Mints

Before you can do anything, you need to trust a Mint. A mint exchanges Bitcoin (Lightning) for ecash tokens.

List Mints: View connected mints and their status.
```
node cli/wallet.mjs mints
```

Add a Mint: connect to a new mint URL.

node cli/wallet.mjs add-mint https://mint.url
# Example (Testnut):
node cli/wallet.mjs add-mint https://testnut.cashu.space

2. Receiving Money (In)

Via Lightning (Deposit): Create a Lightning invoice to swap BTC for ecash.
```
# Usage: invoice <amount> [mint_url]
node cli/wallet.mjs invoice 1000
```
This command will generate an invoice and wait for payment. Once paid, it automatically mints the tokens.

Via Ecash Token: Receive a Cashu token string sent by someone else.

# Usage: receive <token>
node cli/wallet.mjs receive "cashuA..."

3. Sending Money (Out)

Via Lightning (Pay Invoice): Pay a BOLT11 Lightning invoice using your ecash balance.

# Usage: pay-invoice <bolt11_invoice> [mint_url]
node cli/wallet.mjs pay-invoice lnbc10u...

Via Ecash Token: Generate a token to send to someone else off-chain.
```
# Usage: send <amount> [mint_url]
node cli/wallet.mjs send 500
```
Output: A cashuA... token string that you can share.

4. Wallet Management

Check Balance: See your total balance across all mints.
```
node cli/wallet.mjs balance
```
Transaction History: View past deposits, withdrawals, and transfers.
```
node cli/wallet.mjs history
```
Check Pending Invoice: If you created an invoice but closed the CLI before it confirmed, check it manually.
```
# Usage: check-invoice <quote_id> [mint_url]
node cli/wallet.mjs check-invoice "quote_id_here"
```
Restore Wallet: Recover funds from a specific mint using your seed (stored in ~/.cashu-wallet/seed.txt).
```
node cli/wallet.mjs restore https://mint.url
```

🛠️ Troubleshooting

Logs & Data: Data is stored in ~/.cashu-wallet/wallet.db.
Recommended Mint: https://mint.coinos.io

---name: cashu-walletdescription: Manage Bitcoin and Cashu ecash. Send/receive via Lightning, manage multiple mints, and transact privately with ecash tokens.---# Cashu Wallet**Cashu Wallet** is a lightweight, privacy-focused Bitcoin wallet powered by **Cashu ecash**. It allows you to send and receive payments instantly using the **Lightning Network** or by exchanging **ecash tokens** directly.### 🌟 Key Features* **Bitcoin over Lightning:** Seamlessly send and receive Lightning payments.* **Cashu Ecash:** Privacy-preserving ecash tokens.* **Multi-Mint Support:** Connect to multiple mints to diversify risk or support different currencies (sats, usd, eur, etc., depending on the mint).---## 📦 Installation & SetupThe wallet is a Node.js CLI application located in this directory.1. **Install Dependencies:** ```bash cd cli npm install ```2. **Create Alias (Optional but Recommended):** To make commands easier to run, you can create an alias: ```bash alias cashu='node cli/wallet.mjs' ```---## 🚀 Usage GuideAll commands can be run using `node cli/wallet.mjs <command>` (or `cashu <command>` if aliased).### 1. Managing MintsBefore you can do anything, you need to trust a **Mint**. A mint exchanges Bitcoin (Lightning) for ecash tokens.* **List Mints:** View connected mints and their status. ```bash node cli/wallet.mjs mints ```* **Add a Mint:** connect to a new mint URL. ```bash node cli/wallet.mjs add-mint https://mint.url # Example (Testnut): node cli/wallet.mjs add-mint https://testnut.cashu.space ```### 2. Receiving Money (In)* **Via Lightning (Deposit):** Create a Lightning invoice to swap BTC for ecash. ```bash # Usage: invoice <amount> [mint_url] node cli/wallet.mjs invoice 1000 ``` *This command will generate an invoice and wait for payment. Once paid, it automatically mints the tokens.** **Via Ecash Token:** Receive a Cashu token string sent by someone else. ```bash # Usage: receive <token> node cli/wallet.mjs receive "cashuA..." ```### 3. Sending Money (Out)* **Via Lightning (Pay Invoice):** Pay a BOLT11 Lightning invoice using your ecash balance. ```bash # Usage: pay-invoice <bolt11_invoice> [mint_url] node cli/wallet.mjs pay-invoice lnbc10u... ```* **Via Ecash Token:** Generate a token to send to someone else off-chain. ```bash # Usage: send <amount> [mint_url] node cli/wallet.mjs send 500 ``` *Output: A `cashuA...` token string that you can share.*### 4. Wallet Management* **Check Balance:** See your total balance across all mints. ```bash node cli/wallet.mjs balance ```* **Transaction History:** View past deposits, withdrawals, and transfers. ```bash node cli/wallet.mjs history ```* **Check Pending Invoice:** If you created an invoice but closed the CLI before it confirmed, check it manually. ```bash # Usage: check-invoice <quote_id> [mint_url] node cli/wallet.mjs check-invoice "quote_id_here" ```* **Restore Wallet:** Recover funds from a specific mint using your seed (stored in `~/.cashu-wallet/seed.txt`). ```bash node cli/wallet.mjs restore https://mint.url ```---## 🛠️ Troubleshooting* **Logs & Data:** Data is stored in `~/.cashu-wallet/wallet.db`.* **Recommended Mint:** `https://mint.coinos.io`

Frequently asked questions

Cashu wallet