@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 +27 -0
- package/README.md +86 -2
- package/dist/index.js +1592 -219
- package/package.json +4 -4
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 |
|