@vultisig/cli 0.2.0-alpha.5 → 0.2.0-alpha.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,32 @@
1
1
  # @vultisig/cli
2
2
 
3
+ ## 0.2.0-alpha.7
4
+
5
+ ### Minor Changes
6
+
7
+ - [#60](https://github.com/vultisig/vultisig-sdk/pull/60) [`b4cf357`](https://github.com/vultisig/vultisig-sdk/commit/b4cf357c98ef493b48c807e5bb45cd40b9893295) Thanks [@bornslippynuxx](https://github.com/bornslippynuxx)! - feat: Add SecureVault support for multi-device MPC vaults
8
+ - Implement SecureVault.create() for multi-device keygen ceremony
9
+ - Add RelaySigningService for coordinated signing via relay server
10
+ - Implement SecureVault.sign() and signBytes() methods
11
+ - Add QR code generation for mobile app pairing (compatible with Vultisig iOS/Android)
12
+ - CLI: Add `vault create --type secure` with terminal QR display
13
+ - CLI: Support secure vault signing with device coordination
14
+ - Add comprehensive unit, integration, and E2E tests
15
+
16
+ ### Patch Changes
17
+
18
+ - Updated dependencies [[`b4cf357`](https://github.com/vultisig/vultisig-sdk/commit/b4cf357c98ef493b48c807e5bb45cd40b9893295)]:
19
+ - @vultisig/sdk@0.2.0-alpha.7
20
+
21
+ ## 0.2.0-alpha.6
22
+
23
+ ### Patch Changes
24
+
25
+ - [#58](https://github.com/vultisig/vultisig-sdk/pull/58) [`c9b7d88`](https://github.com/vultisig/vultisig-sdk/commit/c9b7d888e21e9db1b928ddc929294aa15157e476) Thanks [@bornslippynuxx](https://github.com/bornslippynuxx)! - Fix password prompt being swallowed by spinner during signing
26
+ - Add `--password` option to `send` and `swap` commands for non-interactive use
27
+ - Pre-unlock vault before signing spinner starts to prevent prompt interference
28
+ - Password prompt now appears before spinner when not provided via CLI flag
29
+
3
30
  ## 0.2.0-alpha.5
4
31
 
5
32
  ### Patch Changes
package/README.md CHANGED
@@ -53,7 +53,7 @@ vultisig completion fish >> ~/.config/fish/completions/vultisig.fish
53
53
 
54
54
  ## Quick Start
55
55
 
56
- ### Create a Vault
56
+ ### Create a Fast Vault
57
57
 
58
58
  ```bash
59
59
  vultisig create
@@ -65,6 +65,46 @@ You'll be prompted to:
65
65
  3. Provide an email for verification
66
66
  4. Enter the verification code sent to your email
67
67
 
68
+ ### Create a Secure Vault (Multi-Device)
69
+
70
+ ```bash
71
+ vultisig create --secure --name "Team Wallet" --shares 3
72
+ ```
73
+
74
+ This creates a secure vault with configurable N-of-M threshold:
75
+ 1. A QR code displays in your terminal
76
+ 2. Other participants scan with Vultisig mobile app (iOS/Android)
77
+ 3. Once all devices join, keygen runs automatically
78
+ 4. Vault is created and ready to use
79
+
80
+ **Secure vault options:**
81
+ - `--shares <n>` - Number of participating devices (default: 2)
82
+ - `--threshold <n>` - Signing threshold (default: ceil((shares+1)/2))
83
+
84
+ **Example session:**
85
+ ```bash
86
+ $ vultisig create --secure --name "Team Wallet" --shares 3
87
+
88
+ Creating secure vault: Team Wallet (2-of-3)
89
+
90
+ Scan this QR code with Vultisig mobile app:
91
+ ████████████████████████████
92
+ █ ▄▄▄▄▄ █▀ ▄█▄█▀█ ▄▄▄▄▄ █
93
+ █ █ █ █▀▄▄▄ ▄██ █ █ █
94
+ ...
95
+
96
+ Waiting for devices to join...
97
+ ⠋ Device joined: iPhone-abc123 (2/3)
98
+ ⠋ Device joined: Android-def456 (3/3)
99
+
100
+ All devices joined. Running keygen...
101
+ ✓ ECDSA keygen complete
102
+ ✓ EdDSA keygen complete
103
+
104
+ ✓ Secure vault created: Team Wallet
105
+ Vault ID: vault_abc123def456
106
+ ```
107
+
68
108
  ### Check Balances
69
109
 
70
110
  ```bash
@@ -86,8 +126,34 @@ vultisig send ethereum 0xRecipient... 0.1
86
126
 
87
127
  # Send ERC-20 token
88
128
  vultisig send ethereum 0xRecipient... 100 --token 0xTokenAddress...
129
+
130
+ # Provide password via flag (for scripts/automation)
131
+ vultisig send ethereum 0xRecipient... 0.1 --password mypassword
89
132
  ```
90
133
 
134
+ **Secure vault transactions:**
135
+
136
+ When using a secure vault, a QR code displays for device coordination:
137
+
138
+ ```bash
139
+ $ vultisig send ethereum 0x742d35Cc... 0.1
140
+
141
+ Preparing transaction...
142
+
143
+ Scan this QR code to approve transaction:
144
+ ████████████████████████████
145
+ ...
146
+
147
+ Waiting for devices to join signing session...
148
+ ⠋ Device joined: iPhone-abc123 (2/2)
149
+
150
+ Signing transaction...
151
+ ✓ Transaction signed
152
+ ✓ Broadcast: 0x9f8e7d6c...
153
+ ```
154
+
155
+ You can cancel with Ctrl+C while waiting for devices.
156
+
91
157
  ### Interactive Shell
92
158
 
93
159
  Start an interactive session with tab completion and password caching:
@@ -104,7 +170,8 @@ vultisig -i
104
170
 
105
171
  | Command | Description |
106
172
  |---------|-------------|
107
- | `create` | Create a new vault |
173
+ | `create` | Create a new fast vault (server-assisted) |
174
+ | `create --secure` | Create a secure vault (multi-device MPC) |
108
175
  | `import <file>` | Import vault from .vult file |
109
176
  | `export [path]` | Export vault to file |
110
177
  | `verify <vaultId>` | Verify vault with email code |
@@ -113,6 +180,12 @@ vultisig -i
113
180
  | `rename <newName>` | Rename the active vault |
114
181
  | `info` | Show detailed vault information |
115
182
 
183
+ **Create options:**
184
+ - `--secure` - Create a secure vault instead of fast vault
185
+ - `--name <name>` - Vault name
186
+ - `--shares <n>` - Number of devices for secure vault (default: 2)
187
+ - `--threshold <n>` - Signing threshold (default: ceil((shares+1)/2))
188
+
116
189
  ### Wallet Operations
117
190
 
118
191
  | Command | Description |
@@ -137,6 +210,17 @@ vultisig -i
137
210
  | `swap-quote <from> <to> <amount>` | Get a swap quote |
138
211
  | `swap <from> <to> <amount>` | Execute a swap |
139
212
 
213
+ ```bash
214
+ # Execute a swap
215
+ vultisig swap ethereum bitcoin 0.1
216
+
217
+ # With password for automation
218
+ vultisig swap ethereum bitcoin 0.1 --password mypassword
219
+
220
+ # Skip confirmation prompt
221
+ vultisig swap ethereum bitcoin 0.1 -y --password mypassword
222
+ ```
223
+
140
224
  ### Settings
141
225
 
142
226
  | Command | Description |