@routstr/cocod 0.0.16

package/SKILL.md

@@ -0,0 +1,238 @@
+---
+name: cocod
+description: A Cashu ecash wallet CLI for Bitcoin and Lightning payments. Use when managing Cashu tokens, sending/receiving payments via Lightning (bolt11) or ecash, handling HTTP 402 X-Cashu payment requests, or viewing wallet history.
+compatibility: Requires cocod CLI to be installed. Supports Cashu ecash protocol, Lightning Network payments, and NUT-24 HTTP 402 X-Cashu flows.
+metadata:
+  project: cocod
+  type: cashu-wallet
+  skill_version: 0.0.16
+  requires_cocod_version: 0.0.16
+  networks:
+    - cashu
+    - bitcoin
+    - lightning
+---
+
+# Cocod - Cashu Wallet CLI
+
+Cocod is a Cashu wallet for managing ecash tokens and making Bitcoin/Lightning payments. It uses the Cashu protocol for privacy-preserving ecash transactions.
+
+If a web/API request returns HTTP `402 Payment Required` with an `X-Cashu` header, use this skill to parse and settle the request with cocod.
+
+## Agent Safety Policy (Required)
+
+When acting as an AGENT with this skill:
+
+- Always ask for explicit user permission before running any command/flow that can spend wallet funds, unless the user has already clearly instructed you to execute that spend action.
+- Prefer preview/inspection commands before execution whenever available. For example, run `cocod x-cashu parse <request>` to inspect costs and requirements before `cocod x-cashu handle <request>`.
+- Treat `~/.cocod` as sensitive. Never log, print, or expose its contents (including config, mnemonic material, wallet state, sockets, and pid files) unless the user explicitly requests a specific safe subset.
+- Always surface issues and errors encountered while using the CLI or this skill. Do not hide failures behind partial success messaging.
+- Do not manually work around CLI issues, missing behavior, or unexpected command failures without explicit user permission.
+
+## What is Cashu?
+
+Cashu is a Chaumian ecash protocol that lets you hold and transfer Bitcoin-backed tokens privately. It enables unlinkable transactions using blind signatures.
+
+## Installation
+
+```bash
+# Install cocod CLI
+bun install -g cocod
+```
+
+## Version Compatibility
+
+This skill is version-pinned to an exact `cocod` CLI release.
+
+- `metadata.skill_version` must match the npm package version.
+- `metadata.requires_cocod_version` is pinned to that exact same version.
+
+Check your installed CLI version:
+
+```bash
+cocod --version
+```
+
+If the version does not match the pinned values in this file, update `cocod` before using this skill.
+
+## Quick Start
+
+```bash
+# Initialize your wallet (generates mnemonic automatically)
+cocod init
+
+# Or with a custom mint
+cocod init --mint-url https://mint.example.com
+
+# Check balance
+cocod balance
+```
+
+## Commands
+
+### Core Wallet
+
+```bash
+# Check daemon and wallet status
+cocod status
+
+# Initialize wallet with optional mnemonic
+cocod init [mnemonic] [--passphrase <passphrase>] [--mint-url <url>]
+
+# Unlock encrypted wallet (only required when initialised with passphrase)
+cocod unlock <passphrase>
+
+# Get wallet balance
+cocod balance
+
+# Test daemon connection
+cocod ping
+```
+
+### Receiving Payments
+
+```bash
+# Receive Cashu token
+cocod receive cashu <token>
+
+# Create Lightning invoice to receive
+cocod receive bolt11 <amount> [--mint-url <url>]
+```
+
+### Sending Payments
+
+AGENT rule: commands in this section spend wallet funds. Ask for permission first unless the user already explicitly requested the spend action.
+
+```bash
+# Create Cashu token to send to someone
+cocod send cashu <amount> [--mint-url <url>]
+
+# Pay a Lightning invoice
+cocod send bolt11 <invoice> [--mint-url <url>]
+```
+
+### HTTP 402 Web Payments (NUT-24)
+
+Use these commands when a server responds with HTTP `402` and an `X-Cashu` payment request.
+
+AGENT rule: `cocod x-cashu handle <request>` can spend funds. Prefer `cocod x-cashu parse <request>` first to preview amount/requirements, then ask permission before handling unless already instructed.
+
+```bash
+# Parse an encoded X-Cashu request from a 402 response header
+cocod x-cashu parse <request>
+
+# Settle the request and get an X-Cashu payment header value
+cocod x-cashu handle <request>
+```
+
+Typical flow:
+
+1. Read `X-Cashu` from the `402` response.
+2. Run `cocod x-cashu parse <request>` to inspect amount and mint requirements.
+3. Run `cocod x-cashu handle <request>` to generate payment token header value.
+4. Retry the original web request with returned `X-Cashu: cashuB...` header.
+
+### Mints
+
+```bash
+# Add a mint URL
+cocod mints add <url>
+
+# List configured mints
+cocod mints list
+
+# Get mint information
+cocod mints info <url>
+```
+
+### Lightning Address (NPC)
+
+Lightning Addresses are email-style identifiers (like `name@npubx.cash`) that let others pay you over Lightning. If you have not purchased a username, NPC provides a free address from your Nostr npub; purchasing a username gives you a human-readable handle. Buying a username is a two-step flow so you can review the required sats before confirming payment.
+
+AGENT rule: `cocod npc username <name> --confirm` is a spend action. Ask permission before running `--confirm` unless already instructed.
+
+```bash
+# Get your NPC Lightning Address
+cocod npc address
+
+# Reserve/buy an NPC username (two-step)
+cocod npc username <name>
+cocod npc username <name> --confirm
+```
+
+### History
+
+```bash
+# View wallet history
+cocod history
+
+# With pagination
+cocod history --offset 0 --limit 20
+
+# Watch for real-time updates
+cocod history --watch
+
+# Limit with watch
+cocod history --limit 50 --watch
+```
+
+### Daemon Control
+
+```bash
+# Start the background daemon (started automatically when not running when required)
+cocod daemon
+
+# Stop the daemon
+cocod stop
+```
+
+## Examples
+
+**Initialize with encryption:**
+
+```bash
+cocod init --passphrase "my-secret"
+```
+
+**Receive via Lightning:**
+
+```bash
+cocod receive bolt11 5000
+# Returns: lnbc50u1... (share this invoice to receive)
+```
+
+**Pay a Lightning invoice:**
+
+```bash
+cocod send bolt11 lnbc100u1p3w7j3...
+```
+
+**Send Cashu to a friend:**
+
+```bash
+cocod send cashu 1000
+# Returns: cashuAeyJ0b2tlbiI6...
+# Friend receives with: cocod receive cashu cashuAeyJ0b2tlbiI6...
+```
+
+**Check status and balance:**
+
+```bash
+cocod status
+cocod balance
+```
+
+**View recent history:**
+
+```bash
+cocod history --limit 10
+```
+
+## Concepts
+
+- **Cashu**: Privacy-preserving ecash protocol using blind signatures
+- **Mint**: Server that issues and redeems Cashu tokens
+- **Token**: Transferable Cashu string representing satoshi value
+- **Bolt11**: Lightning Network invoice format
+- **NPC**: Lightning Address service for receiving payments
+- **Mnemonic**: Seed phrase for wallet recovery

package/bun.lock

@@ -0,0 +1,69 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "cocod",
+      "dependencies": {
+        "@scure/bip39": "^2.0.1",
+        "coco-cashu-core": "1.1.2-rc.50",
+        "coco-cashu-plugin-npc": "2.4.1",
+        "coco-cashu-sqlite-bun": "1.1.2-rc.50",
+        "commander": "^14.0.2",
+        "nostr-tools": "^2.22.1",
+      },
+      "devDependencies": {
+        "@types/bun": "latest",
+        "prettier": "^3.8.1",
+      },
+      "peerDependencies": {
+        "typescript": "^5",
+      },
+    },
+  },
+  "packages": {
+    "@cashu/cashu-ts": ["@cashu/cashu-ts@3.6.1", "", { "dependencies": { "@noble/curves": "^2.0.1", "@noble/hashes": "^2.0.1", "@scure/base": "^2.0.0", "@scure/bip32": "^2.0.1" } }, "sha512-ynncvX5vv/m2Dzp28m1ApxNsmrsw1p6laOdOnvlHVOPK3x4Nz3K/ScV7UjnbuwubTVeIcKP1FXEdycedhhlJbQ=="],
+
+    "@noble/ciphers": ["@noble/ciphers@2.1.1", "", {}, "sha512-bysYuiVfhxNJuldNXlFEitTVdNnYUc+XNJZd7Qm2a5j1vZHgY+fazadNFWFaMK/2vye0JVlxV3gHmC0WDfAOQw=="],
+
+    "@noble/curves": ["@noble/curves@2.0.1", "", { "dependencies": { "@noble/hashes": "2.0.1" } }, "sha512-vs1Az2OOTBiP4q0pwjW5aF0xp9n4MxVrmkFBxc6EKZc6ddYx5gaZiAsZoq0uRRXWbi3AT/sBqn05eRPtn1JCPw=="],
+
+    "@noble/hashes": ["@noble/hashes@2.0.1", "", {}, "sha512-XlOlEbQcE9fmuXxrVTXCTlG2nlRXa9Rj3rr5Ue/+tX+nmkgbX720YHh0VR3hBF9xDvwnb8D2shVGOwNx+ulArw=="],
+
+    "@scure/base": ["@scure/base@2.0.0", "", {}, "sha512-3E1kpuZginKkek01ovG8krQ0Z44E3DHPjc5S2rjJw9lZn3KSQOs8S7wqikF/AH7iRanHypj85uGyxk0XAyC37w=="],
+
+    "@scure/bip32": ["@scure/bip32@2.0.1", "", { "dependencies": { "@noble/curves": "2.0.1", "@noble/hashes": "2.0.1", "@scure/base": "2.0.0" } }, "sha512-4Md1NI5BzoVP+bhyJaY3K6yMesEFzNS1sE/cP+9nuvE7p/b0kx9XbpDHHFl8dHtufcbdHRUUQdRqLIPHN/s7yA=="],
+
+    "@scure/bip39": ["@scure/bip39@2.0.1", "", { "dependencies": { "@noble/hashes": "2.0.1", "@scure/base": "2.0.0" } }, "sha512-PsxdFj/d2AcJcZDX1FXN3dDgitDDTmwf78rKZq1a6c1P1Nan1X/Sxc7667zU3U+AN60g7SxxP0YCVw2H/hBycg=="],
+
+    "@types/bun": ["@types/bun@1.3.8", "", { "dependencies": { "bun-types": "1.3.8" } }, "sha512-3LvWJ2q5GerAXYxO2mffLTqOzEu5qnhEAlh48Vnu8WQfnmSwbgagjGZV6BoHKJztENYEDn6QmVd949W4uESRJA=="],
+
+    "@types/node": ["@types/node@25.1.0", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-t7frlewr6+cbx+9Ohpl0NOTKXZNV9xHRmNOvql47BFJKcEG1CxtxlPEEe+gR9uhVWM4DwhnvTF110mIL4yP9RA=="],
+
+    "bun-types": ["bun-types@1.3.8", "", { "dependencies": { "@types/node": "*" } }, "sha512-fL99nxdOWvV4LqjmC+8Q9kW3M4QTtTR1eePs94v5ctGqU8OeceWrSUaRw3JYb7tU3FkMIAjkueehrHPPPGKi5Q=="],
+
+    "coco-cashu-core": ["coco-cashu-core@1.1.2-rc.50", "", { "dependencies": { "@cashu/cashu-ts": "^3.5.0", "@noble/curves": "^2.0.1", "@noble/hashes": "^2.0.1", "@scure/bip32": "^2.0.1" }, "peerDependencies": { "typescript": "^5" } }, "sha512-eK5YuwvCWpeCwF/GEkMo90FCyek2mS+smQ51wKjkjTKzpkVVlNln52l2h1Wwce4VMnW6GSeL2IgT8IksM8Umuw=="],
+
+    "coco-cashu-plugin-npc": ["coco-cashu-plugin-npc@2.4.1", "", { "dependencies": { "npubcash-sdk": "^0.3.2" }, "peerDependencies": { "coco-cashu-core": "^1.1.2-rc.50", "typescript": "^5.0.0" } }, "sha512-0OhqXXRLBq/2VkeuyqHrTINCEQYEk9+dCD9Vq7+M94CDf7kLKQZmoDL6leTuHJ45pIVnALcOFnjIcRoJwV7iiA=="],
+
+    "coco-cashu-sqlite-bun": ["coco-cashu-sqlite-bun@1.1.2-rc.50", "", { "peerDependencies": { "coco-cashu-core": "1.1.2-rc.50", "typescript": "^5" } }, "sha512-wYAZjGmk3Xd75rq7y6AGLji4z5/3v5rWj6xgQoa3Qq+37zKnuCeLqVt+A3x/3EcNRLmNoW/u7vQJTJP4APHhIw=="],
+
+    "commander": ["commander@14.0.2", "", {}, "sha512-TywoWNNRbhoD0BXs1P3ZEScW8W5iKrnbithIl0YH+uCmBd0QpPOA8yc82DS3BIE5Ma6FnBVUsJ7wVUDz4dvOWQ=="],
+
+    "nostr-tools": ["nostr-tools@2.22.1", "", { "dependencies": { "@noble/ciphers": "2.1.1", "@noble/curves": "2.0.1", "@noble/hashes": "2.0.1", "@scure/base": "2.0.0", "@scure/bip32": "2.0.1", "@scure/bip39": "2.0.1", "nostr-wasm": "0.1.0" }, "peerDependencies": { "typescript": ">=5.0.0" }, "optionalPeers": ["typescript"] }, "sha512-LJKy4lU6thO6Z6CVWkfqHGDt9m/M5IfRlmEI2hBXYLw4xa3jpfIHKJxXQhx/8C3TcN0YPkMRJlhGmu/g0VH80g=="],
+
+    "nostr-wasm": ["nostr-wasm@0.1.0", "", {}, "sha512-78BTryCLcLYv96ONU8Ws3Q1JzjlAt+43pWQhIl86xZmWeegYCNLPml7yQ+gG3vR6V5h4XGj+TxO+SS5dsThQIA=="],
+
+    "npubcash-sdk": ["npubcash-sdk@0.3.2", "", { "dependencies": { "@cashu/cashu-ts": "^3.2.2", "nostr-tools": "^2.19.4", "npubcash-types": "^0.1.1" } }, "sha512-mJwvWW6rAq04b/AHbd76T4gTeUqP2uprc01Y0ToU9ZK5co3n1PmBKWLBLbPN+VgpHhE0LubzjLq/qm70YWUugA=="],
+
+    "npubcash-types": ["npubcash-types@0.1.1", "", {}, "sha512-/HGfes2cvQpkrWOuUrdemJJhJUQu+xiXl4x+AxQtKUMGCB8uEhfrXJfAQ0n+DgtkIX1YVLOh0a/e6E5LX+fUew=="],
+
+    "prettier": ["prettier@3.8.1", "", { "bin": { "prettier": "bin/prettier.cjs" } }, "sha512-UOnG6LftzbdaHZcKoPFtOcCKztrQ57WkHDeRD9t/PTQtmT0NHSeWWepj6pS0z/N7+08BHFDQVUrfmfMRcZwbMg=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+
+    "npubcash-sdk/@cashu/cashu-ts": ["@cashu/cashu-ts@3.3.0", "", { "dependencies": { "@noble/curves": "^2.0.1", "@noble/hashes": "^2.0.1", "@scure/base": "^2.0.0", "@scure/bip32": "^2.0.1" } }, "sha512-hHUOhjPLK77axDdj/4qO5mJ14rkh+rZGe1Gz2RbkW2j+SIglNbc2NsKSvjvoQcshupm02FudKi9Y3s3M8ZSYzg=="],
+  }
+}

package/docs/API.md

@@ -0,0 +1,92 @@
+# API and Command Reference
+
+This document contains the detailed reference moved out of `README.md`.
+
+## CLI commands
+
+All commands are available under `cocod`.
+
+### Wallet
+
+- `status` - Check daemon and wallet status
+- `init [mnemonic]` - Initialize wallet; generates mnemonic if omitted
+  - `--passphrase <str>` encrypt wallet at creation time
+  - `--mint-url <url>` set default mint URL
+- `unlock <passphrase>` - Unlock encrypted wallet
+- `balance` - Get wallet balances
+- `history` - List history entries
+  - `--offset <number>` default `0`
+  - `--limit <number>` default `20`, max `100`
+  - `--watch` stream real-time updates after initial fetch
+
+### Receive
+
+- `receive cashu <token>` - Receive a Cashu token
+- `receive bolt11 <amount>` - Create a Lightning invoice
+  - `--mint-url <url>` override default mint for this request
+
+### Send
+
+- `send cashu <amount>` - Create a Cashu token to send
+  - `--mint-url <url>` override default mint
+- `send bolt11 <invoice>` - Pay a Lightning invoice
+  - `--mint-url <url>` override default mint
+
+### Mints
+
+- `mints add <url>` - Add mint URL
+- `mints list` - List configured mints
+- `mints info <url>` - Fetch mint metadata
+
+### NPC
+
+- `npc address` - Get your NPC Lightning address
+- `npc username <name>` - Begin username purchase flow
+  - `--confirm` confirm payment and complete purchase
+
+### X-Cashu / NUT-24
+
+- `x-cashu parse <request>` - Parse an encoded payment request
+- `x-cashu handle <request>` - Settle request and return `X-Cashu: cashuB...` header value
+
+### Daemon control
+
+- `ping` - Check daemon connectivity
+- `daemon` - Start daemon in foreground
+- `stop` - Stop daemon
+
+## Daemon HTTP endpoints
+
+The CLI talks to the daemon over HTTP on a UNIX socket.
+
+- Socket path env var: `COCOD_SOCKET`
+- Default socket: `~/.cocod/cocod.sock`
+
+### Response shape
+
+- Success: `{ "output": <value> }`
+- Error: `{ "error": "message" }`
+
+### Endpoint list
+
+- `GET /ping`
+- `GET /status`
+- `POST /init`
+- `POST /unlock`
+- `GET /balance`
+- `POST /receive/cashu`
+- `POST /receive/bolt11`
+- `POST /send/cashu`
+- `POST /send/bolt11`
+- `POST /x-cashu/parse`
+- `POST /x-cashu/handle`
+- `POST /mints/add`
+- `GET /mints/list`
+- `POST /mints/info`
+- `GET /history`
+- `GET /events` (SSE stream)
+- `GET /npc/address`
+- `POST /npc/username`
+- `POST /stop`
+
+For full request/response and status details, see `docs/daemon-api.json`.

package/docs/daemon-api.json

@@ -0,0 +1,245 @@
+{
+  "name": "cocod-daemon-api",
+  "version": "0.0.12",
+  "transport": {
+    "protocol": "http",
+    "unixSocketEnv": "COCOD_SOCKET",
+    "defaultUnixSocket": "~/.cocod/cocod.sock"
+  },
+  "responseContract": {
+    "success": {
+      "shape": {
+        "output": "unknown"
+      }
+    },
+    "error": {
+      "shape": {
+        "error": "string"
+      }
+    }
+  },
+  "endpoints": [
+    {
+      "path": "/ping",
+      "method": "GET",
+      "state": "any",
+      "responses": {
+        "200": "{ output: \"pong\" }"
+      }
+    },
+    {
+      "path": "/status",
+      "method": "GET",
+      "state": "any",
+      "responses": {
+        "200": "{ output: \"UNINITIALIZED\" | \"LOCKED\" | \"UNLOCKED\" | \"ERROR\" }"
+      }
+    },
+    {
+      "path": "/init",
+      "method": "POST",
+      "state": "UNINITIALIZED",
+      "body": {
+        "mnemonic": "string (optional)",
+        "passphrase": "string (optional)",
+        "mintUrl": "string (optional)"
+      },
+      "responses": {
+        "200": "{ output: string }",
+        "400": "{ error: \"Invalid mnemonic\" }",
+        "409": "{ error: string }",
+        "500": "{ error: string }"
+      }
+    },
+    {
+      "path": "/unlock",
+      "method": "POST",
+      "state": "LOCKED",
+      "body": {
+        "passphrase": "string"
+      },
+      "responses": {
+        "200": "{ output: \"Unlocked\" }",
+        "400": "{ error: string }",
+        "401": "{ error: string }",
+        "409": "{ error: string }",
+        "503": "{ error: string }"
+      }
+    },
+    {
+      "path": "/balance",
+      "method": "GET",
+      "state": "UNLOCKED",
+      "responses": {
+        "200": "{ output: Record<string, { sats: number }> }",
+        "403": "{ error: string }",
+        "503": "{ error: string }",
+        "500": "{ error: string }"
+      }
+    },
+    {
+      "path": "/receive/cashu",
+      "method": "POST",
+      "state": "UNLOCKED",
+      "body": {
+        "token": "string"
+      },
+      "responses": {
+        "200": "{ output: string }",
+        "500": "{ error: string }"
+      }
+    },
+    {
+      "path": "/receive/bolt11",
+      "method": "POST",
+      "state": "UNLOCKED",
+      "body": {
+        "amount": "number",
+        "mintUrl": "string (optional)"
+      },
+      "responses": {
+        "200": "{ output: string }",
+        "500": "{ error: string }"
+      }
+    },
+    {
+      "path": "/send/cashu",
+      "method": "POST",
+      "state": "UNLOCKED",
+      "body": {
+        "amount": "number",
+        "mintUrl": "string (optional)"
+      },
+      "responses": {
+        "200": "{ output: string }",
+        "500": "{ error: string }"
+      }
+    },
+    {
+      "path": "/send/bolt11",
+      "method": "POST",
+      "state": "UNLOCKED",
+      "body": {
+        "invoice": "string",
+        "mintUrl": "string (optional)"
+      },
+      "responses": {
+        "200": "{ output: string }",
+        "500": "{ error: string }"
+      }
+    },
+    {
+      "path": "/x-cashu/parse",
+      "method": "POST",
+      "state": "UNLOCKED",
+      "body": {
+        "request": "string"
+      },
+      "responses": {
+        "200": "{ output: string }",
+        "400": "{ error: string }",
+        "500": "{ error: string }"
+      }
+    },
+    {
+      "path": "/x-cashu/handle",
+      "method": "POST",
+      "state": "UNLOCKED",
+      "body": {
+        "request": "string",
+        "mintUrl": "string (optional)"
+      },
+      "responses": {
+        "200": "{ output: string }",
+        "400": "{ error: string }",
+        "500": "{ error: string }"
+      }
+    },
+    {
+      "path": "/mints/add",
+      "method": "POST",
+      "state": "UNLOCKED",
+      "body": {
+        "url": "string"
+      },
+      "responses": {
+        "200": "{ output: string }",
+        "500": "{ error: string }"
+      }
+    },
+    {
+      "path": "/mints/list",
+      "method": "GET",
+      "state": "UNLOCKED",
+      "responses": {
+        "200": "{ output: string }",
+        "500": "{ error: string }"
+      }
+    },
+    {
+      "path": "/mints/info",
+      "method": "POST",
+      "state": "UNLOCKED",
+      "body": {
+        "url": "string"
+      },
+      "responses": {
+        "200": "{ output: unknown }",
+        "500": "{ error: string }"
+      }
+    },
+    {
+      "path": "/history",
+      "method": "GET",
+      "state": "UNLOCKED",
+      "query": {
+        "offset": "number (optional, default 0)",
+        "limit": "number (optional, default 20, max 100)"
+      },
+      "responses": {
+        "200": "{ output: unknown[] }",
+        "400": "{ error: string }"
+      }
+    },
+    {
+      "path": "/events",
+      "method": "GET",
+      "state": "UNLOCKED",
+      "responses": {
+        "200": "text/event-stream"
+      }
+    },
+    {
+      "path": "/npc/address",
+      "method": "GET",
+      "state": "UNLOCKED",
+      "responses": {
+        "200": "{ output: string }",
+        "500": "{ error: string }"
+      }
+    },
+    {
+      "path": "/npc/username",
+      "method": "POST",
+      "state": "UNLOCKED",
+      "body": {
+        "username": "string",
+        "confirm": "boolean (optional)"
+      },
+      "responses": {
+        "200": "{ output: unknown }",
+        "400": "{ error: string }",
+        "402": "{ error: string }",
+        "500": "{ error: string }"
+      }
+    },
+    {
+      "path": "/stop",
+      "method": "POST",
+      "state": "any",
+      "responses": {
+        "200": "{ output: \"Daemon stopping\" }"
+      }
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@routstr/cocod",
+  "version": "0.0.16",
+  "module": "src/index.ts",
+  "type": "module",
+  "private": false,
+  "bin": {
+    "cocod": "./src/index.ts"
+  },
+  "scripts": {
+    "start": "bun src/index.ts",
+    "daemon": "bun src/index.ts daemon",
+    "lint": "tsc --noEmit",
+    "test": "bun test",
+    "format": "prettier --write ."
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "prettier": "^3.8.1"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@scure/bip39": "^2.0.1",
+    "coco-cashu-core": "1.1.2-rc.50",
+    "coco-cashu-plugin-npc": "2.4.1",
+    "coco-cashu-sqlite-bun": "1.1.2-rc.50",
+    "commander": "^14.0.2",
+    "nostr-tools": "^2.22.1"
+  }
+}