@neuraiproject/neurai-depin-terminal 1.0.1 → 2.0.0

package/README.md

@@ -6,7 +6,7 @@ Terminal client for Neurai DePIN messaging with full-screen interface.
 
 ## Features
 
-- ✅ Full-screen terminal interface with blessed
+- ✅ Full-screen terminal interface with charsm
 - ✅ Simple configuration via `config.json`
 - ✅ **Encrypted private key storage** with AES-256-GCM encryption
 - ✅ Automatic broadcast to all token holders
@@ -110,7 +110,7 @@ The application will display a full-screen interface with:
 ```
 ┌────────────────────────────────────────────────────────────┐
 │ Neurai DePIN | RPC: localhost:19001 | ● Connected          │
-│ Token: MYTOKEN | NXXXabc...xyz | Last poll: 10:23:45       │
+│ Token: MYTOKEN | NXXXabc...xyz | Last check: 10:23:45       │
 ├────────────────────────────────────────────────────────────┤
 │                                                            │
 │ [10:20:15] NXXXdef...123: Hello world                      │
@@ -119,7 +119,7 @@ The application will display a full-screen interface with:
 │                                                            │
 │                                                            │
 ├────────────────────────────────────────────────────────────┤
-│ > Type message... (Enter: Send | Ctrl+C: Quit)             │
+│ > Type message... (Enter: Send | Esc: Quit)                │
 └────────────────────────────────────────────────────────────┘
 ```
 
@@ -131,23 +131,41 @@ The application will display a full-screen interface with:
 
 **Components:**
 
-- **Top bar**: Shows RPC connection status, configured token, address and last poll time
+- **Top bar**: Shows RPC connection status, configured token, address and last check time
 - **Message area**: Shows received and sent messages (scrollable with arrow keys)
 - **Input area**: Type your message here
 
 ### Keyboard Shortcuts
 
 - **Enter** or **Ctrl+S**: Send message
-- **Ctrl+C** or **Escape**: Exit application
+- **Escape** or **Ctrl+C**: Exit application
 - **Up/Down arrows**: Scroll in message area
+- **Ctrl+Left / Ctrl+Right**: Switch tabs
+- **Ctrl+W**: Close active private tab
+
+### Private Messages
+
+Send a private message by starting the line with `@` and the destination address:
+
+```
+@NxxxRecipientAddress Hello, this is a private message.
+```
+
+Messages without the `@address` prefix are sent as group/broadcast messages.
+Typing `@` at the start opens a recipient list you can navigate with arrow keys and select with Enter (Esc to close).
+The recipient list is cached and refreshed every 60 seconds to keep selection fast.
+Private conversations appear as tabs named after the sender (e.g. `abc...xyz`). New private messages are marked with an asterisk.
+The Group tab always shows only group messages.
+Sending a private message opens its tab automatically.
 
 ## How It Works
 
 1. **Startup**: Application loads configuration and connects to RPC server
 2. **Polling**: Every 10 seconds (configurable) checks for new messages in the DePIN pool
 3. **Reception**: Messages are automatically decrypted and displayed on screen
-4. **Sending**: When pressing Ctrl+S, the message is sent to **all token holders** (broadcast)
-5. **Privacy**: If the server has a privacy layer configured (`depinpoolpkey`), messages are additionally encrypted
+4. **Sending**: Messages without a prefix are sent to **all token holders with a revealed pubkey** (broadcast). To send a private message, use `@address message`.
+5. **Recipients**: Eligible recipients are fetched via `listdepinaddresses` and cached locally (refreshed every 60 seconds)
+6. **Privacy**: If the server has a privacy layer configured (`depinpoolpkey`), messages are additionally encrypted
 
 ## Architecture
 
@@ -163,7 +181,7 @@ src/
 │   ├── MessagePoller.js        # Automatic polling
 │   └── MessageSender.js        # Broadcast sending
 ├── ui/
-│   └── TerminalUI.js           # Blessed interface
+│   └── CharsmUI.js             # Charsm interface
 └── lib/
     └── depinMsgLoader.js       # IIFE bundle loader
 ```
@@ -187,6 +205,7 @@ Verify that:
 - Your address owns the configured DePIN token
 - Other token holders exist with revealed public keys
 - The RPC server supports DePIN methods (`depinreceivemsg`, `depinsubmitmsg`)
+- The RPC server supports `listdepinaddresses` for recipient discovery
 
 ### Error: "No recipients found with revealed public key"