# Archon Cashu

> Cashu ecash operations integrated with Archon DID for P2PK-locked tokens. Send and receive sats using DID-derived pubkeys, backup wallets to vault. Use for Cashu token operations, DID-locked payments, or ecash wallet management.

- Skill: `archetech-agent-skills/archon-cashu` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add archetech-agent-skills/archon-cashu`
- Raw SKILL.md: https://api.skillmd.com/api/skills/archetech-agent-skills/archon-cashu/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: archetech (https://skillmd.com/u/archetech-agent-skills)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/archetech-agent-skills/archon-cashu

---


# Archon Cashu - DID-Integrated Ecash

Cashu ecash operations using your Archon DID for P2PK-locked tokens. Send sats that only the recipient's DID can unlock.

## Prerequisites

- Archon identity configured (`~/.archon.env`)
- Cashu CLI installed (`pip install cashu` or similar)
- Config file at `~/.config/archon/cashu.env` (or `ARCHON_CASHU_CONFIG`)

## Configuration

```bash
./scripts/cashu/config.sh
```

Sets up Cashu wallet and optional LNBITS integration.

## Operations

### Check Balance

```bash
./scripts/cashu/balance.sh
```

### Send Tokens (Unlocked)

```bash
./scripts/cashu/send-unlocked.sh <amount>
```

Returns a Cashu token anyone can redeem.

### Send Tokens (DID-Locked)

```bash
./scripts/cashu/send.sh <amount> <recipient-did>
```

Locks tokens to recipient's DID-derived pubkey (P2PK). Only they can unlock.

### Receive Tokens

```bash
./scripts/cashu/receive.sh <token>
```

### Mint Tokens (Lightning)

```bash
./scripts/cashu/mint.sh <amount>
```

Creates Lightning invoice to mint new tokens.

### Lock/Unlock Tokens

```bash
./scripts/cashu/lock.sh <amount> <did>
```

### Backup Wallet to Vault

```bash
./scripts/cashu/backup.sh [vault-did]
```

### npub.cash Setup

```bash
./scripts/cashu/npub-cash-setup.sh
```

Configure npub.cash integration for Nostr zaps.

## Security Notes

1. **Wallet location**: `~/.cashu` by default (configurable via `CASHU_WALLET_DIR`)

2. **P2PK locking**: DID-locked tokens use your DID's secp256k1 key for cryptographic locking

3. **LNBITS integration**: Optional — for auto-paying invoices during mint operations