@vultisig/cli 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,115 @@
 # @vultisig/cli
 
+## 0.4.0
+
+### Minor Changes
+
+- [#84](https://github.com/vultisig/vultisig-sdk/pull/84) [`86cf505`](https://github.com/vultisig/vultisig-sdk/commit/86cf50517a528a0ef43c36b70c477adbec245160) Thanks [@bornslippynuxx](https://github.com/bornslippynuxx)! - Add `vultisig delete` command to remove vaults from local storage without manually deleting files from `~/.vultisig/`. Supports deletion by vault name, ID, or ID prefix, with confirmation prompt (skippable via `--yes` flag).
+
+- [#84](https://github.com/vultisig/vultisig-sdk/pull/84) [`86cf505`](https://github.com/vultisig/vultisig-sdk/commit/86cf50517a528a0ef43c36b70c477adbec245160) Thanks [@bornslippynuxx](https://github.com/bornslippynuxx)! - Add discount command to view VULT discount tier for swap fees
+  - New `discount` command shows current tier, fee rate, and next tier requirements
+  - Support `--refresh` flag to force cache invalidation
+  - Swap quotes now display discount tier when affiliate fees are applied
+  - Updated README with discount tier documentation
+
+- [#84](https://github.com/vultisig/vultisig-sdk/pull/84) [`86cf505`](https://github.com/vultisig/vultisig-sdk/commit/86cf50517a528a0ef43c36b70c477adbec245160) Thanks [@bornslippynuxx](https://github.com/bornslippynuxx)! - Add `--add-all` flag to chains command to add all supported chains at once
+
+  New vaults start with only 5 default chains, but the SDK supports 36 chains. Users previously had to run `chains --add <chain>` 31 times to enable all chains. Now they can simply run:
+
+  ```bash
+  vultisig chains --add-all
+  ```
+
+  This works in both CLI mode and interactive shell mode.
+
+- [#84](https://github.com/vultisig/vultisig-sdk/pull/84) [`86cf505`](https://github.com/vultisig/vultisig-sdk/commit/86cf50517a528a0ef43c36b70c477adbec245160) Thanks [@bornslippynuxx](https://github.com/bornslippynuxx)! - feat: add Phantom wallet Solana derivation path support
+
+  When importing a seedphrase, the SDK now detects if the mnemonic was originally created in Phantom wallet by checking both the standard Solana BIP44 path and Phantom's non-standard path (`m/44'/501'/0'/0'`).
+
+  **SDK changes:**
+  - `discoverChainsFromSeedphrase()` now returns `ChainDiscoveryAggregate` with `results` and `usePhantomSolanaPath` flag
+  - Added `usePhantomSolanaPath` option to `createFastVaultFromSeedphrase()`, `createSecureVaultFromSeedphrase()`, and `joinSecureVault()`
+  - Auto-detection during chain discovery: uses Phantom path when it has balance and standard path doesn't
+
+  **CLI changes:**
+  - Added `--use-phantom-solana-path` flag to `create-from-seedphrase fast` and `create-from-seedphrase secure` commands
+
+  **Examples:**
+  - Added Phantom Solana path toggle checkbox in SeedphraseImporter component
+
+### Patch Changes
+
+- [#84](https://github.com/vultisig/vultisig-sdk/pull/84) [`86cf505`](https://github.com/vultisig/vultisig-sdk/commit/86cf50517a528a0ef43c36b70c477adbec245160) Thanks [@bornslippynuxx](https://github.com/bornslippynuxx)! - Fix balance display to show human-readable amounts instead of raw values (wei/satoshis). Add `--raw` flag for programmatic use.
+
+- [#84](https://github.com/vultisig/vultisig-sdk/pull/84) [`86cf505`](https://github.com/vultisig/vultisig-sdk/commit/86cf50517a528a0ef43c36b70c477adbec245160) Thanks [@bornslippynuxx](https://github.com/bornslippynuxx)! - fix: address code review items across SDK and CLI
+
+  **CLI improvements:**
+  - Fix Phantom path detection message to use effective flag value
+  - Add ambiguous vault detection in delete command with descriptive error messages
+  - Refactor `findVaultByIdOrName` to use object parameter and throw on ambiguous matches
+  - Import tier config from SDK instead of hardcoding values in discount command
+
+  **SDK improvements:**
+  - Export VULT discount tier configuration for CLI consumption
+  - Add error handling in SwapService using attempt/withFallback pattern
+
+  **Documentation fixes:**
+  - Add `text` language identifier to code fence in CLI README
+  - Remove redundant "originally" word from Phantom wallet descriptions
+  - Update "affiliate fee discounts" to "swap fee discounts" terminology
+
+- Updated dependencies [[`86cf505`](https://github.com/vultisig/vultisig-sdk/commit/86cf50517a528a0ef43c36b70c477adbec245160), [`86cf505`](https://github.com/vultisig/vultisig-sdk/commit/86cf50517a528a0ef43c36b70c477adbec245160), [`86cf505`](https://github.com/vultisig/vultisig-sdk/commit/86cf50517a528a0ef43c36b70c477adbec245160), [`86cf505`](https://github.com/vultisig/vultisig-sdk/commit/86cf50517a528a0ef43c36b70c477adbec245160), [`86cf505`](https://github.com/vultisig/vultisig-sdk/commit/86cf50517a528a0ef43c36b70c477adbec245160), [`86cf505`](https://github.com/vultisig/vultisig-sdk/commit/86cf50517a528a0ef43c36b70c477adbec245160)]:
+  - @vultisig/sdk@0.4.0
+
+## 0.3.0
+
+### Minor Changes
+
+- [#71](https://github.com/vultisig/vultisig-sdk/pull/71) [`cc4e5fd`](https://github.com/vultisig/vultisig-sdk/commit/cc4e5fd2ff83bcce1723435107af869a43ea069f) Thanks [@bornslippynuxx](https://github.com/bornslippynuxx)! - Update CLI to support SDK vault creation API changes
+
+  **Breaking Changes:**
+  - Renamed `import-seedphrase` command to `create-from-seedphrase` to match SDK naming
+    - `vultisig import-seedphrase fast` → `vultisig create-from-seedphrase fast`
+    - `vultisig import-seedphrase secure` → `vultisig create-from-seedphrase secure`
+
+  **New Features:**
+  - Added `join secure` command to join existing SecureVault creation sessions
+    - Supports QR payload via `--qr`, `--qr-file`, or interactive prompt
+    - Auto-detects if mnemonic is required based on session type
+    - Example: `vultisig join secure --qr "vultisig://..."`
+
+  **Internal Changes:**
+  - Updated SDK API calls to use new method names:
+    - `importSeedphraseAsFastVault` → `createFastVaultFromSeedphrase`
+    - `importSeedphraseAsSecureVault` → `createSecureVaultFromSeedphrase`
+  - Renamed internal functions and types to match SDK naming conventions
+
+### Patch Changes
+
+- [#71](https://github.com/vultisig/vultisig-sdk/pull/71) [`fee3f37`](https://github.com/vultisig/vultisig-sdk/commit/fee3f375f85011d14be814f06ff3d7f6684ea2fe) Thanks [@bornslippynuxx](https://github.com/bornslippynuxx)! - fix: address CodeRabbit PR #71 review suggestions
+
+  **Critical fixes:**
+  - JoinSecureVaultService: require `devices` parameter instead of defaulting to 2
+  - CLI vault-management: validate `devices` parameter before calling SDK
+  - parseKeygenQR: throw error on unknown libType instead of silently defaulting
+
+  **Code quality:**
+  - Replace try-catch with attempt() pattern in JoinSecureVaultService and parseKeygenQR
+  - Add abort signal checks in SecureVaultJoiner callbacks
+
+  **Documentation:**
+  - Add onProgress callback to joinSecureVault README documentation
+  - Fix markdown heading format in SDK-USERS-GUIDE.md
+  - Add language specifier to code block in CLAUDE.md
+
+  **Tests:**
+  - Fix Korean test mnemonic (removed invalid comma)
+  - Add Korean language detection test
+  - Remove sensitive private key logging in test helpers
+
+- Updated dependencies [[`fee3f37`](https://github.com/vultisig/vultisig-sdk/commit/fee3f375f85011d14be814f06ff3d7f6684ea2fe), [`695e664`](https://github.com/vultisig/vultisig-sdk/commit/695e664668082ca55861cf4d8fcc8c323be94c06), [`4edf52d`](https://github.com/vultisig/vultisig-sdk/commit/4edf52d3a2985d2adf772239bf19b8301f360af8), [`d145809`](https://github.com/vultisig/vultisig-sdk/commit/d145809eb68653a3b22921fcb90ebc985de2b16a)]:
+  - @vultisig/sdk@0.3.0
+
 ## 0.2.0
 
 ### Minor Changes

package/README.md

@@ -56,19 +56,16 @@ vultisig completion fish >> ~/.config/fish/completions/vultisig.fish
 ### Create a Fast Vault
 
 ```bash
-vultisig create
+vultisig create fast --name "My Wallet" --password "mypassword" --email user@example.com
 ```
 
 You'll be prompted to:
-1. Enter a vault name
-2. Set a password (min 8 characters)
-3. Provide an email for verification
-4. Enter the verification code sent to your email
+1. Enter the verification code sent to your email
 
 ### Create a Secure Vault (Multi-Device)
 
 ```bash
-vultisig create --secure --name "Team Wallet" --shares 3
+vultisig create secure --name "Team Wallet" --shares 3
 ```
 
 This creates a secure vault with configurable N-of-M threshold:
@@ -78,12 +75,12 @@ This creates a secure vault with configurable N-of-M threshold:
 4. Vault is created and ready to use
 
 **Secure vault options:**
-- `--shares <n>` - Number of participating devices (default: 2)
-- `--threshold <n>` - Signing threshold (default: ceil((shares+1)/2))
+- `--shares <n>` - Number of participating devices (default: 3)
+- `--threshold <n>` - Signing threshold (default: 2)
 
 **Example session:**
 ```bash
-$ vultisig create --secure --name "Team Wallet" --shares 3
+$ vultisig create secure --name "Team Wallet" --shares 3
 
 Creating secure vault: Team Wallet (2-of-3)
 
@@ -111,28 +108,30 @@ Import an existing wallet from a BIP39 recovery phrase (12 or 24 words):
 
 ```bash
 # FastVault import (server-assisted 2-of-2)
-vultisig import-seedphrase fast --name "Imported Wallet" --email user@example.com
+vultisig create-from-seedphrase fast --name "Imported Wallet" --email user@example.com
 
 # SecureVault import (multi-device MPC)
-vultisig import-seedphrase secure --name "Team Wallet" --shares 3
+vultisig create-from-seedphrase secure --name "Team Wallet" --shares 3
 ```
 
 **Import options:**
 - `--mnemonic <words>` - Recovery phrase (space-separated words)
 - `--discover-chains` - Scan chains for existing balances before import
 - `--chains <chains>` - Specific chains to enable (comma-separated)
+- `--use-phantom-solana-path` - Use Phantom wallet derivation path for Solana
 
 When `--mnemonic` is not provided, you'll be prompted to enter it securely (masked input).
 
+> **Note:** Phantom wallet uses a non-standard derivation path for Solana. If your seedphrase was originally created in Phantom and you're importing Solana funds, use `--use-phantom-solana-path`. When using `--discover-chains`, this is auto-detected.
+
 **Example session:**
 ```bash
-$ vultisig import-seedphrase fast --name "My Wallet" --email user@example.com --discover-chains
+$ vultisig create-from-seedphrase fast --name "My Wallet" --email user@example.com --password "mypassword" --discover-chains
 
 Enter your 12 or 24-word recovery phrase.
 Words will be hidden as you type.
 
 Seedphrase: ************************
-Password: ********
 ✓ Valid 12-word seedphrase
 
 Discovering chains with balances...
@@ -216,11 +215,13 @@ vultisig -i
 
 | Command | Description |
 |---------|-------------|
-| `create` | Create a new fast vault (server-assisted) |
-| `create --secure` | Create a secure vault (multi-device MPC) |
+| `create fast` | Create a new fast vault (server-assisted 2-of-2) |
+| `create secure` | Create a secure vault (multi-device MPC) |
 | `import <file>` | Import vault from .vult file |
-| `import-seedphrase fast` | Import seedphrase as FastVault (2-of-2) |
-| `import-seedphrase secure` | Import seedphrase as SecureVault (N-of-M) |
+| `delete [vault]` | Delete a vault from local storage |
+| `create-from-seedphrase fast` | Import seedphrase as FastVault (2-of-2) |
+| `create-from-seedphrase secure` | Import seedphrase as SecureVault (N-of-M) |
+| `join secure` | Join an existing SecureVault creation session |
 | `export [path]` | Export vault to file |
 | `verify <vaultId>` | Verify vault with email code |
 | `vaults` | List all stored vaults |
@@ -228,28 +229,60 @@ vultisig -i
 | `rename <newName>` | Rename the active vault |
 | `info` | Show detailed vault information |
 
-**Create options:**
-- `--secure` - Create a secure vault instead of fast vault
-- `--name <name>` - Vault name
-- `--shares <n>` - Number of devices for secure vault (default: 2)
-- `--threshold <n>` - Signing threshold (default: ceil((shares+1)/2))
+**Create fast options:**
+- `--name <name>` - Vault name (required)
+- `--password <password>` - Vault password (required)
+- `--email <email>` - Email for verification (required)
+
+**Create secure options:**
+- `--name <name>` - Vault name (required)
+- `--password <password>` - Vault password (optional)
+- `--shares <n>` - Number of devices (default: 3)
+- `--threshold <n>` - Signing threshold (default: 2)
+
+**Delete options:**
+- `[vault]` - Vault name or ID to delete (defaults to active vault)
+- `-y, --yes` - Skip confirmation prompt
+
+```bash
+# Delete by vault name
+vultisig delete "My Wallet"
+
+# Delete by vault ID (or prefix)
+vultisig delete abc123
+
+# Delete active vault
+vultisig delete
+
+# Skip confirmation (for scripts)
+vultisig delete "Test Vault" --yes
+```
+
+**Join secure options:**
+- `--qr <payload>` - QR code payload from initiator (vultisig://...)
+- `--qr-file <path>` - Read QR payload from file
+- `--mnemonic <words>` - Seedphrase (required for seedphrase-based sessions)
+- `--password <password>` - Vault password (optional)
+- `--devices <n>` - Total devices in session (default: 2)
 
-**Import seedphrase options (fast):**
+**Create-from-seedphrase fast options:**
 - `--name <name>` - Vault name (required)
 - `--email <email>` - Email for verification (required)
-- `--password <password>` - Vault password (required, prompted if not provided)
+- `--password <password>` - Vault password (required)
 - `--mnemonic <words>` - Recovery phrase (prompted securely if not provided)
 - `--discover-chains` - Auto-enable chains with existing balances
 - `--chains <chains>` - Specific chains to enable (comma-separated)
+- `--use-phantom-solana-path` - Use Phantom wallet derivation path for Solana
 
-**Import seedphrase options (secure):**
+**Create-from-seedphrase secure options:**
 - `--name <name>` - Vault name (required)
-- `--shares <n>` - Number of devices (default: 2)
+- `--shares <n>` - Number of devices (default: 3)
 - `--threshold <n>` - Signing threshold (default: ceil((shares+1)/2))
 - `--password <password>` - Vault password (optional)
 - `--mnemonic <words>` - Recovery phrase (prompted securely if not provided)
 - `--discover-chains` - Auto-enable chains with existing balances
 - `--chains <chains>` - Specific chains to enable (comma-separated)
+- `--use-phantom-solana-path` - Use Phantom wallet derivation path for Solana
 
 **Export options:**
 - `[path]` - Output file or directory (defaults to SDK-generated filename in current directory)
@@ -299,6 +332,9 @@ vultisig export
 | `swap <from> <to> <amount>` | Execute a swap |
 
 ```bash
+# Get a swap quote
+vultisig swap-quote ethereum bitcoin 0.1
+
 # Execute a swap
 vultisig swap ethereum bitcoin 0.1
 
@@ -309,6 +345,8 @@ vultisig swap ethereum bitcoin 0.1 --password mypassword
 vultisig swap ethereum bitcoin 0.1 -y --password mypassword
 ```
 
+Swap quotes and previews show your VULT discount tier when affiliate fees are applied. See `vultisig discount` for tier details.
+
 ### Advanced Operations
 
 | Command | Description |
@@ -513,8 +551,51 @@ vultisig broadcast --chain sui --raw-tx '{"unsignedTx":"<base64-tx-bytes>","sign
 |---------|-------------|
 | `currency [code]` | View or set currency preference |
 | `server` | Check server connectivity |
+| `discount` | Show your VULT discount tier for swap fees |
 | `address-book` | Manage saved addresses |
 
+#### Discount Tiers
+
+View your VULT token holdings discount tier for reduced swap fees:
+
+```bash
+# Show current discount tier
+vultisig discount
+
+# Force refresh from blockchain
+vultisig discount --refresh
+```
+
+**Output:**
+```text
++----------------------------------------+
+|          VULT Discount Tier            |
++----------------------------------------+
+
+  Current Tier:   Gold
+  Swap Fee:       30 bps (0.30%)
+  Discount:       20 bps saved
+
+  Next Tier:
+    Platinum - requires 15,000 VULT
+
+  Tip: Thorguard NFT holders get +1 tier upgrade (up to gold)
+```
+
+**Tier levels:**
+
+| Tier | VULT Required | Swap Fee | Discount |
+|------|---------------|----------|----------|
+| None | 0 | 50 bps | - |
+| Bronze | 1,500 | 45 bps | 5 bps |
+| Silver | 3,000 | 40 bps | 10 bps |
+| Gold | 7,500 | 30 bps | 20 bps |
+| Platinum | 15,000 | 25 bps | 25 bps |
+| Diamond | 100,000 | 15 bps | 35 bps |
+| Ultimate | 1,000,000 | 0 bps | 50 bps |
+
+Thorguard NFT holders receive a free tier upgrade (up to gold tier).
+
 ### CLI Management
 
 | Command | Description |
@@ -528,8 +609,10 @@ vultisig broadcast --chain sui --raw-tx '{"unsignedTx":"<base64-tx-bytes>","sign
 | Command | Description |
 |---------|-------------|
 | `vault <name>` | Switch to a different vault |
-| `create <fast\|secure>` | Create a new vault |
-| `import-seedphrase <fast\|secure>` | Import wallet from recovery phrase |
+| `vaults` | List all vaults |
+| `create` | Create a new vault |
+| `import <file>` | Import vault from file |
+| `delete [name]` | Delete a vault |
 | `lock` | Lock vault (clear cached password) |
 | `unlock` | Unlock vault (cache password) |
 | `status` | Show vault status |
@@ -732,7 +815,7 @@ Configuration is stored in `~/.vultisig/`:
 
 Create or import a vault first:
 ```bash
-vultisig create
+vultisig create fast --name "My Wallet" --password "mypassword" --email user@example.com
 # or
 vultisig import /path/to/vault.vult
 ```