Skip to content

Commit 867bc46

Browse files
chainwhisperchainwhisper
authored
Add tss and new tbnbcli binaries (bnb-chain#106)
* add tbnbcli * add tss binary * add binary * add binary * add binary * add binary * add user guide * Update sha256checksum
1 parent ff7942a commit 867bc46

File tree

14 files changed

+85
-1
lines changed

14 files changed

+85
-1
lines changed

‎cli/CHANGELOG.md‎

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,28 @@
11
# Changelog
22

3+
## 0.6.1-TSS
4+
*Aug 27th*
5+
**New Feature**
6+
* Add Threshold Signature Scheme (TSS) support:
7+
1. To add a tss key into bnbcli’s keystore:
8+
Tss keygen command will automatically add generated secret share into default keystore (~/.bnbcli) with name “tss_<moniker>_<vault_name>”
9+
2. User can manually specify tss’s home, vault_name and a customized bnbcli home like:
10+
```
11+
bnbcli keys add --home ~/.customized_cli --tss -t tss --tss-home ~/.test1 --tss-vault “default” my_name
12+
```
13+
14+
## First Release of TSS Binary
15+
16+
This is the first release of Threshold Signature Scheme (TSS) binaries. You can take a look at the [user guide](./testnet/0.6.1-TSS/TSSUserGuide.md) first.
17+
18+
319
## 0.6.1
420
*Aug 5th*
521
**New Feature**
622
* Add `memo-check`function
723
* Add transaction hex generation
824

9-
## 0.6.0
25+
## 0.6.0
1026

1127
*June 26th*
1228

‎cli/testnet/0.6.1-TSS/TSSUserGuide.md‎

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# User Guide
2+
3+
## Play in localhost
4+
5+
Please note, "--password" option should only be used in testing.
6+
Without this option, the cli would ask interactive input and confirm
7+
8+
0. build tss executable binary
9+
```
10+
git clone https://github.com/binance-chain/tss
11+
cd tss
12+
go build
13+
```
14+
15+
1. init 3 parties
16+
```
17+
./tss init --home ~/.test1 --vault_name "default" --moniker "test1" --password "123456789"
18+
./tss init --home ~/.test2 --vault_name "default" --moniker "test2" --password "123456789"
19+
./tss init --home ~/.test3 --vault_name "default" --moniker "test3" --password "123456789"
20+
```
21+
22+
2. generate channel id
23+
replace value of "--channel_id" for following commands with generated one
24+
```
25+
./tss channel --channel_expire 30
26+
```
27+
28+
3. keygen
29+
```
30+
./tss keygen --home ~/.test1 --vault_name "default" --parties 3 --threshold 1 --password "123456789" --channel_password "123456789" --channel_id "2855D42A535"
31+
./tss keygen --home ~/.test2 --vault_name "default" --parties 3 --threshold 1 --password "123456789" --channel_password "123456789" --channel_id "2855D42A535"
32+
./tss keygen --home ~/.test3 --vault_name "default" --parties 3 --threshold 1 --password "123456789" --channel_password "123456789" --channel_id "2855D42A535"
33+
```
34+
35+
4. sign
36+
```
37+
./tss sign --home ~/.test1 --vault_name "default" --password "123456789" --channel_password "123456789" --channel_id "2855D42A535"
38+
./tss sign --home ~/.test2 --vault_name "default" --password "123456789" --channel_password "123456789" --channel_id "2855D42A535"
39+
```
40+
41+
5. regroup - replace existing 3 parties with 3 brand new parties
42+
```
43+
# start 2 old parties (answer Y for isOld and IsNew interactive questions)
44+
./tss regroup --home ~/.test1 --vault_name "default" --password "123456789" --new_parties 3 --new_threshold 1 --channel_password "123456789" --channel_id "1565D44EBE1"
45+
./tss regroup --home ~/.test2 --vault_name "default" --password "123456789" --new_parties 3 --new_threshold 1 --channel_password "123456789" --channel_id "1565D44EBE1"
46+
# start the new parties (answer n for isIold and Y for IsNew interactive questions)
47+
./tss regroup --home ~/.test3 --vault_name "default" --password "123456789" --new_parties 3 --new_threshold 1 --channel_password "123456789" --channel_id "1565D44EBE1"
48+
```

‎cli/testnet/0.6.1-TSS/linux/.gitattributes‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
tbnbcli filter=lfs diff=lfs merge=lfs -text

‎cli/testnet/0.6.1-TSS/linux/sha256checksum‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
65faae696561b985d1a78996b81638fface0598436ee2677bf62163dead4dfef ./tbnbcli
2+
d9a3b66914dd9ec1eca6e2595644ae52f8ea06f74bef1163b3327e441bd4fb83 ./tss
3+

‎cli/testnet/0.6.1-TSS/linux/tbnbcli‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
version https://git-lfs.github.com/spec/v1
2+
oid sha256:65faae696561b985d1a78996b81638fface0598436ee2677bf62163dead4dfef
3+
size 40450898

‎cli/testnet/0.6.1-TSS/linux/tss‎

26.7 MB
Binary file not shown.

‎cli/testnet/0.6.1-TSS/mac/.gitattributes‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
tbnbcli filter=lfs diff=lfs merge=lfs -text

‎cli/testnet/0.6.1-TSS/mac/sha256checksum‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
6fe3afe4bceaf42acb61d2ef53e4e1cc49e76b2b44a070ff4b8dfa4b5f5dc134 ./tbnbcli
2+
b23817c634a2879cd459a7c6750a97a376d5879575acf113a61e1acf2aeb76de ./tss
3+

‎cli/testnet/0.6.1-TSS/mac/tbnbcli‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
version https://git-lfs.github.com/spec/v1
2+
oid sha256:6fe3afe4bceaf42acb61d2ef53e4e1cc49e76b2b44a070ff4b8dfa4b5f5dc134
3+
size 48229452

‎cli/testnet/0.6.1-TSS/mac/tss‎

26.5 MB
Binary file not shown.

0 commit comments

Comments
 (0)