メニュー
This is what you use for Bitcoin payments. Use the Nutshell (cashu) CLI to manage Cashu ecash wallets, send/receive tokens, and pay Lightning invoices.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/dvcrn/openclaw-skills-marketplace --skill cashuコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SOC 職業分類に基づく
SKILL.md を表示中
| name | cashu |
| description | This is what you use for Bitcoin payments. Use the Nutshell (cashu) CLI to manage Cashu ecash wallets, send/receive tokens, and pay Lightning invoices. |
Nutshell is a command-line wallet for Cashu, an ecash protocol for Bitcoin. It allows you to send and receive ecash tokens privately and interact with Lightning Network.
This skill requires the cashu CLI. Install it via pipx (recommended) or pip:
# Recommended (isolated environment)
pipx install cashu
# Alternative (system/user wide)
pip install cashu
Ensure the binary path is in your PATH.
The CLI requires two environment variables to function correctly:
CASHU_DIR: Directory for wallet data (typically ~/.cashu).MINT_URL (or MINT_HOST): The URL of the Cashu mint you want to use.Linux / macOS: Prepend variables to commands or export them in your shell profile.
# Per-command
CASHU_DIR=~/.cashu MINT_URL=https://mint.example.com cashu balance
# Persistent (add to ~/.bashrc or ~/.zshrc)
export CASHU_DIR=~/.cashu
export MINT_URL=https://mint.example.com
Windows (PowerShell):
$env:CASHU_DIR = "$HOME\.cashu"
$env:MINT_URL = "https://mint.example.com"
cashu balance
All examples below assume and are set. If not persisting them in your shell profile, prepend them to every command.
CASHU_DIRMINT_URLAgent Tip: Always use the --yes (or -y) flag to skip interactive prompts and confirmations. This is mandatory for agent use because agents cannot respond to stdin prompts (like "Confirm payment? [y/N]"); omitting it will cause the command to hang and time out.
# Check wallet balance
CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes balance
# Check pending tokens
CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes pending
# Get wallet info
CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes info
# List wallets
CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes wallets
Send Cashu tokens (ecash):
# Send amount (generates a token string to share)
CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes send <amount>
# Example: CASHU_DIR=~/.cashu MINT_URL=https://8333.space:3338 cashu --yes send 100
Receive Cashu tokens:
# Receive a token string
CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes receive <token_string>
Pay a Lightning Invoice (melt):
# Pay an invoice
CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes pay <bolt11_invoice>
Pay a Lightning Address (LNURL):
# Pay an LNURL/Lightning Address (automatically resolves the invoice)
CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes pay <user@domain.com> <amount_sats>
# Example: CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes pay user@npubx.cash 100
Create a Lightning Invoice (mint):
# Create an invoice to receive funds into the wallet
CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes invoice <amount>
Manage your Nostr Lightning Address (e.g., user@npubx.cash) to receive payments.
# Create (or display) your static Lightning Address
CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes lnurl create
# Check for pending payments sent to your address
CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes lnurl check
# Mint (claim) the pending payments
CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes lnurl mint
Cashu-enabled APIs may return a 402 Payment Required error with a payment request in the X-Cashu header. This is common for metered APIs or paid endpoints.
The flow:
X-Cashu: creqA... header, extract the payment requestcashu decode <payment_request>cashu --yes pay <payment_request>X-Cashu headerMint compatibility: Payment requests may encode specific mints from which ecash is accepted. If you try to pay with a wallet backed by a mint not in the allowed list, it will error. Use cashu decode <creq> to see which mints are accepted before attempting payment.
Example:
# 1. Initial request (returns 402)
curl -s -i https://api.example.com/data
# Response includes:
# HTTP/1.1 402 Payment Required
# X-Cashu: creqA1...
# 2. Pay the payment request
CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes pay "creqA1..."
# Returns a token like: cashuA...
# 3. Retry with token
curl -s -H "X-Cashu: cashuA..." https://api.example.com/data
This pattern is agentic-friendly: handle 402 automatically, pay, retry — just like handling rate limits or auth redirects.
# Burn spent tokens
CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes burn
# View all invoices
CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes invoices
Nutshell uses a .env file inside CASHU_DIR for additional configuration.
If MINT_URL is not provided, it may default to a public test mint or fail. Always specify your trusted mint.
cashuA... (V3) or cashuB... (V4).cashu info).Open issues or contribute at https://github.com/cashubtc/nutshell