archon-lightning

Files (13)

• README.md
• SKILL.md
• _meta.json
• add-lightning.sh · scripts/lightning/
• lightning-balance.sh · scripts/lightning/
• lightning-check.sh · scripts/lightning/
• lightning-decode.sh · scripts/lightning/
• lightning-invoice.sh · scripts/lightning/
• lightning-pay.sh · scripts/lightning/
• lightning-payments.sh · scripts/lightning/
• lightning-zap.sh · scripts/lightning/
• publish-lightning.sh · scripts/lightning/
• unpublish-lightning.sh · scripts/lightning/

SKILL.md (first lines)

# Archon Lightning - Lightning Network Payments for DIDs

Lightning Network integration for Archon decentralized identities. Send and receive Bitcoin over Lightning using your DID.

**Related skills:**
- `archon-keymaster` — Core DID identity management
- `archon-vault` — Encrypted backups

## Capabilities

- **Lightning Wallet Management** - Create Lightning wallets for DIDs
- **Invoice Generation** - Create BOLT11 invoices to receive payments
- **Invoice Payment** - Pay BOLT11 invoices
- **Payment Verification** - Verify payments settled (critical security pattern)
- **Lightning Address Zapping** - Send to Lightning Addresses (`user@domain.com`)
- **Payment History** - Track all Lightning transactions
- **Balance Checking** - Query wallet balance
- **DID Integration** - Publish Lightning endpoint to DID document
- **Invoice Decoding** - Inspect BOLT11 invoice details

## Prerequisites

- Node.js installed (for `npx @didcid/keymaster`)
- Archon identity configured (`~/.archon.env` with `ARCHON_WALLET_PATH`, `ARCHON_PASSPHRASE`)
- `jq` recommended for JSON parsing

All created by `archon-keymaster` setup. If you don't have Archon configured yet, see the `archon-keymaster` skill first.

## Security Notes

This skill handles Lightning Network payments:

1. **Non-custodial**: You control your Lightning node and private keys
2. **Payment verification is built-in**: `lightning-pay.sh` automatically verifies payments; if using keymaster directly, you must verify manually with `lightning-check` (see Payment Verification Pattern below)
3. **Environment access**: Scripts source `~/.archon.env` for wallet access
4. **Network connectivity**: Connects to Lightning Network via Archon gatekeeper

## Quick Start

### Create Lightning Wallet

```bash
./scripts/lightning/add-lightning.sh [id]
```

Creates a Lightning wallet for your current DID (or specified DID alias).

Examples:
```bash
./scripts/lightning/add-lightning.sh          # Current DID
./scripts/lightning/add-lightning.sh work     # Specific DID alias
```

### Check Balance

```bash
./scripts/lightning/lightning-balance.sh [id]
```

Returns current balance in satoshis.

Example output:
```
2257 sats
```

## Receiving Payments

### Create Invoice

```bash
./scripts/lightning/lightning-invoice.sh <amount> <memo> [id]
```

Creates a BOLT11 invoice to receive payment.

**Arguments:**
- `amount` - Amount in satoshis (1000 = 0.00001 BTC)
- `memo` - Description/memo for the invoice
- `id` - (optional) DID alias, defaults to current identity

**Example:**
```bash
./scripts/lightning/lightning-invoice.sh 1000 "Coffee payment"
```

**Output:**
```json
{
  "paymentRequest": "lnbc10u1p...",
  "paymentHash": "a3f7b8c9..."
}
```

Share this invoice with the payer. They can:
- Scan as QR code
- Paste into any Lightning wallet
- Pay via Lightning-enabled app

## Sending Payments

### Pay Invoice (Basic)

```bash
./scripts/lightning/lightning-pay.sh <bolt11> [id]
```

Pay a BOLT11 invoice with automatic payment verification.

**Arguments:**
- `bolt11` - BOLT11 invoice string
- `id` - (optional) DID alias to pay from

**Output:** Success or failure message with exit code

**Example:**
```bash
./scripts/lightning/lightning-pay.sh lnbc10u1p...
# ✅ Payment confirmed

From LeoYeAI/openclaw-master-skills, MIT.

More from LeoYeAI/openclaw-master-skills