cocod 0.0.3 → 0.0.4

package/README.md

@@ -18,7 +18,17 @@ A Cashu wallet CLI and daemon built with Bun and TypeScript.
 
 ## Installation
 
+### From npm (recommended)
+
 ```bash
+bun install --global cocod
+```
+
+### From source
+
+```bash
+git clone <repository-url>
+cd cocod
 bun install
 ```
 
@@ -28,19 +38,19 @@ bun install
 
 ```bash
 # Check daemon status
-bun src/index.ts status
+cocod status
 
 # Initialize wallet (generates mnemonic automatically)
-bun src/index.ts init
+cocod init
 
 # Or initialize with your own mnemonic
-bun src/index.ts init "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"
+cocod init "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"
 
 # Unlock encrypted wallet (if passphrase was set)
-bun src/index.ts unlock "your-passphrase"
+cocod unlock "your-passphrase"
 
 # Check balance
-bun src/index.ts balance
+cocod balance
 ```
 
 ### Available Commands
@@ -53,16 +63,21 @@ bun src/index.ts balance
 | `init [mnemonic]`     | Initialize wallet (generates mnemonic if not provided)          |
 | `unlock <passphrase>` | Unlock encrypted wallet                                         |
 | `balance`             | Get wallet balance across all mints                             |
-| `receive <token>`     | Receive a Cashu token                                           |
 | `history`             | View wallet history (supports `--offset`, `--limit`, `--watch`) |
 
+#### Receive Operations
+
+| Command                   | Description                                |
+| ------------------------- | ------------------------------------------ |
+| `receive cashu <token>`   | Receive a Cashu token                      |
+| `receive bolt11 <amount>` | Create Lightning invoice to receive tokens |
+
 #### Mint Management
 
-| Command                | Description                             |
-| ---------------------- | --------------------------------------- |
-| `mint add <url>`       | Add a new mint URL                      |
-| `mint list`            | List configured mints                   |
-| `mint bolt11 <amount>` | Create Lightning invoice to mint tokens |
+| Command          | Description           |
+| ---------------- | --------------------- |
+| `mint add <url>` | Add a new mint URL    |
+| `mint list`      | List configured mints |
 
 #### NPC (npub.cash)
 
@@ -82,19 +97,19 @@ bun src/index.ts balance
 
 ```bash
 # Add a mint
-bun src/index.ts mint add https://mint.example.com
+cocod mint add https://mint.example.com
 
 # Create a Lightning invoice for 1000 sats
-bun src/index.ts mint bolt11 1000
+cocod receive bolt11 1000
 
 # Receive a Cashu token
-bun src/index.ts receive "cashuAeyJ0b2tlbiI6W3sicHJvb2ZzIjpbeyJ..."
+cocod receive cashu "cashuAeyJ0b2tlbiI6W3sicHJvb2ZzIjpbeyJ..."
 
 # View last 10 history entries
-bun src/index.ts history --limit 10
+cocod history --limit 10
 
 # Watch history in real-time
-bun src/index.ts history --watch
+cocod history --watch
 ```
 
 ## Architecture
@@ -133,7 +148,7 @@ Communication happens over a Unix domain socket:
 ### Commands
 
 ```bash
-# Run CLI
+# Run CLI from source
 bun src/index.ts --help
 
 # Run with npm-style script

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cocod",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "module": "src/index.ts",
   "type": "module",
   "private": false,

package/src/cli.ts

@@ -45,17 +45,29 @@ program
     await handleDaemonCommand("/balance");
   });
 
-// Receive - POST command with argument
-program
-  .command("receive <token>")
+// Receive - nested subcommands
+const receiveCmd = program.command("receive").description("Receive operations");
+
+receiveCmd
+  .command("cashu <token>")
   .description("Receive Cashu token")
   .action(async (token: string) => {
-    await handleDaemonCommand("/receive", {
+    await handleDaemonCommand("/receive/cashu", {
       method: "POST",
       body: { token },
     });
   });
 
+receiveCmd
+  .command("bolt11 <amount>")
+  .description("Create Lightning invoice to receive tokens")
+  .action(async (amount: string) => {
+    await handleDaemonCommand("/receive/bolt11", {
+      method: "POST",
+      body: { amount: parseInt(amount) },
+    });
+  });
+
 // Ping
 program
   .command("ping")
@@ -102,16 +114,6 @@ mintsCmd
     });
   });
 
-mintsCmd
-  .command("bolt11 <amount>")
-  .description("Create Lightning invoice to mint tokens")
-  .action(async (amount: string) => {
-    await handleDaemonCommand("/mints/bolt11", {
-      method: "POST",
-      body: { amount: parseInt(amount) },
-    });
-  });
-
 // NPC - nested subcommands
 const npcCmd = program.command("npc").description("NPC operations");
 

package/src/routes.ts

@@ -147,7 +147,7 @@ export function createRouteHandlers(
         return Response.json({ output: augmentedBalance });
       }),
     },
-    "/receive": {
+    "/receive/cashu": {
       POST: stateManager.requireUnlocked(async (req, state: UnlockedState) => {
         try {
           const body = (await req.json()) as { token: string };
@@ -164,6 +164,13 @@ export function createRouteHandlers(
         }
       }),
     },
+    "/receive/bolt11": {
+      POST: stateManager.requireUnlocked(async (req, state: UnlockedState) => {
+        const body = (await req.json()) as { amount: number };
+        const quote = await state.manager.quotes.createMintQuote(state.mintUrl, body.amount);
+        return Response.json({ output: quote.request });
+      }),
+    },
     "/mints/add": {
       POST: stateManager.requireUnlocked(async (req, state: UnlockedState) => {
         const body = (await req.json()) as { url: string };
@@ -188,13 +195,6 @@ export function createRouteHandlers(
       }),
     },
 
-    "/mints/bolt11": {
-      POST: stateManager.requireUnlocked(async (req, state: UnlockedState) => {
-        const body = (await req.json()) as { amount: number };
-        const quote = await state.manager.quotes.createMintQuote(state.mintUrl, body.amount);
-        return Response.json({ output: quote.request });
-      }),
-    },
     "/history": {
       GET: stateManager.requireUnlocked(async (req, state: UnlockedState) => {
         const url = new URL(req.url);