Skip to content
This repository has been archived by the owner on Jul 5, 2023. It is now read-only.

Commit

Permalink
Add tss and new tbnbcli binaries (#106)
Browse files Browse the repository at this point in the history
* add tbnbcli

* add tss binary

* add binary

* add binary

* add binary

* add binary

* add user guide

* Update sha256checksum
  • Loading branch information
chainwhisper authored Aug 30, 2019
1 parent ff7942a commit 867bc46
Show file tree
Hide file tree
Showing 14 changed files with 85 additions and 1 deletion.
18 changes: 17 additions & 1 deletion cli/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,28 @@
# Changelog

## 0.6.1-TSS
*Aug 27th*
**New Feature**
* Add Threshold Signature Scheme (TSS) support:
1. To add a tss key into bnbcli’s keystore:
Tss keygen command will automatically add generated secret share into default keystore (~/.bnbcli) with name “tss_<moniker>_<vault_name>”
2. User can manually specify tss’s home, vault_name and a customized bnbcli home like:
```
bnbcli keys add --home ~/.customized_cli --tss -t tss --tss-home ~/.test1 --tss-vault “default” my_name
```

## First Release of TSS Binary

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.


## 0.6.1
*Aug 5th*
**New Feature**
* Add `memo-check`function
* Add transaction hex generation

## 0.6.0
## 0.6.0

*June 26th*

Expand Down
48 changes: 48 additions & 0 deletions cli/testnet/0.6.1-TSS/TSSUserGuide.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
# User Guide

## Play in localhost

Please note, "--password" option should only be used in testing.
Without this option, the cli would ask interactive input and confirm

0. build tss executable binary
```
git clone https://github.com/binance-chain/tss
cd tss
go build
```

1. init 3 parties
```
./tss init --home ~/.test1 --vault_name "default" --moniker "test1" --password "123456789"
./tss init --home ~/.test2 --vault_name "default" --moniker "test2" --password "123456789"
./tss init --home ~/.test3 --vault_name "default" --moniker "test3" --password "123456789"
```

2. generate channel id
replace value of "--channel_id" for following commands with generated one
```
./tss channel --channel_expire 30
```

3. keygen
```
./tss keygen --home ~/.test1 --vault_name "default" --parties 3 --threshold 1 --password "123456789" --channel_password "123456789" --channel_id "2855D42A535"
./tss keygen --home ~/.test2 --vault_name "default" --parties 3 --threshold 1 --password "123456789" --channel_password "123456789" --channel_id "2855D42A535"
./tss keygen --home ~/.test3 --vault_name "default" --parties 3 --threshold 1 --password "123456789" --channel_password "123456789" --channel_id "2855D42A535"
```

4. sign
```
./tss sign --home ~/.test1 --vault_name "default" --password "123456789" --channel_password "123456789" --channel_id "2855D42A535"
./tss sign --home ~/.test2 --vault_name "default" --password "123456789" --channel_password "123456789" --channel_id "2855D42A535"
```

5. regroup - replace existing 3 parties with 3 brand new parties
```
# start 2 old parties (answer Y for isOld and IsNew interactive questions)
./tss regroup --home ~/.test1 --vault_name "default" --password "123456789" --new_parties 3 --new_threshold 1 --channel_password "123456789" --channel_id "1565D44EBE1"
./tss regroup --home ~/.test2 --vault_name "default" --password "123456789" --new_parties 3 --new_threshold 1 --channel_password "123456789" --channel_id "1565D44EBE1"
# start the new parties (answer n for isIold and Y for IsNew interactive questions)
./tss regroup --home ~/.test3 --vault_name "default" --password "123456789" --new_parties 3 --new_threshold 1 --channel_password "123456789" --channel_id "1565D44EBE1"
```
1 change: 1 addition & 0 deletions cli/testnet/0.6.1-TSS/linux/.gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
tbnbcli filter=lfs diff=lfs merge=lfs -text
3 changes: 3 additions & 0 deletions cli/testnet/0.6.1-TSS/linux/sha256checksum
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
65faae696561b985d1a78996b81638fface0598436ee2677bf62163dead4dfef ./tbnbcli
d9a3b66914dd9ec1eca6e2595644ae52f8ea06f74bef1163b3327e441bd4fb83 ./tss

3 changes: 3 additions & 0 deletions cli/testnet/0.6.1-TSS/linux/tbnbcli
Git LFS file not shown
Binary file added cli/testnet/0.6.1-TSS/linux/tss
Binary file not shown.
1 change: 1 addition & 0 deletions cli/testnet/0.6.1-TSS/mac/.gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
tbnbcli filter=lfs diff=lfs merge=lfs -text
3 changes: 3 additions & 0 deletions cli/testnet/0.6.1-TSS/mac/sha256checksum
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
6fe3afe4bceaf42acb61d2ef53e4e1cc49e76b2b44a070ff4b8dfa4b5f5dc134 ./tbnbcli
b23817c634a2879cd459a7c6750a97a376d5879575acf113a61e1acf2aeb76de ./tss

3 changes: 3 additions & 0 deletions cli/testnet/0.6.1-TSS/mac/tbnbcli
Git LFS file not shown
Binary file added cli/testnet/0.6.1-TSS/mac/tss
Binary file not shown.
1 change: 1 addition & 0 deletions cli/testnet/0.6.1-TSS/windows/.gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
tbnbcli.exe filter=lfs diff=lfs merge=lfs -text
2 changes: 2 additions & 0 deletions cli/testnet/0.6.1-TSS/windows/sha256checksum
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
23c034de6b5ffca73476291c865193ae4011a2f4318f37484231e1966130dcc7 tbnbcli.exe
dab89ed0b747ebdcb5fc42e3635ed8d0fa7fd407b1112b8ce3082d3a14e27315 tss.exe
3 changes: 3 additions & 0 deletions cli/testnet/0.6.1-TSS/windows/tbnbcli.exe
Git LFS file not shown
Binary file added cli/testnet/0.6.1-TSS/windows/tss.exe
Binary file not shown.

0 comments on commit 867bc46

Please sign in to comment.