Go to file
Conrado Gouvea 52972f7101
add frost-client {init,login,export,import,contacts} (#308)
* add frost-client {init,login,export,import,contacts}

* update main README.md, add one to frost-client

* address review comments

* remove unneeded code

* add frost-client trusted-dealer

* also write contacts to configs; move URL from Participant to Group; add 'groups'

* some missing stuff
2024-10-02 10:34:55 -03:00
.github Bump reviewdog/action-actionlint from 1.54.0 to 1.55.0 (#310) 2024-09-25 14:13:31 -03:00
coordinator
dkg
frost-client add frost-client {init,login,export,import,contacts} (#308) 2024-10-02 10:34:55 -03:00
participant
server add frost-client {init,login,export,import,contacts} (#308) 2024-10-02 10:34:55 -03:00
tests
trusted-dealer add frost-client {init,login,export,import,contacts} (#308) 2024-10-02 10:34:55 -03:00
zcash-sign
.gitignore
Cargo.lock add frost-client {init,login,export,import,contacts} (#308) 2024-10-02 10:34:55 -03:00
Cargo.toml add frost-client {init,login,export,import,contacts} (#308) 2024-10-02 10:34:55 -03:00
DEVELOPER.md
LICENSE-APACHE
LICENSE-MIT
Makefile.toml
README.md add frost-client {init,login,export,import,contacts} (#308) 2024-10-02 10:34:55 -03:00
codecov.yml
rust-toolchain.toml

README.md

Zcash Foundation FROST Demos

This repository contains a set of command line demos that uses the ZF FROST libraries and reference implementation. Their purpose is to:

  1. identify gaps in our documentation
  2. provide usage examples for developer facing documentation
  3. provide reference implementations for developers wanting to use FROST in a “real world” scenario.

The demos use the Ed25519 ciphersuite by default, but they can also use the RedPallas ciphersuite which is compatible with Zcash.

About FROST (Flexible Round-Optimised Schnorr Threshold signatures)

Unlike signatures in a single-party setting, threshold signatures require cooperation among a threshold number of signers, each holding a share of a common private key. The security of threshold schemes in general assume that an adversary can corrupt strictly fewer than a threshold number of participants.

Two-Round Threshold Schnorr Signatures with FROST presents a variant of a Flexible Round-Optimized Schnorr Threshold (FROST) signature scheme originally defined in FROST20. FROST reduces network overhead during threshold signing operations while employing a novel technique to protect against forgery attacks applicable to prior Schnorr-based threshold signature constructions. This variant of FROST requires two rounds to compute a signature, and implements signing efficiency improvements described by Schnorr21. Single-round signing with FROST is not implemented here.

Projects

This repo contains 4 projects:

  1. Trusted Dealer
  2. DKG
  3. Coordinator
  4. Participant
  5. Server
  6. FROST client
  7. Zcash Signer

The first four are command line tools that generate FROST shares and run the FROST protocol. They offer multiple communication interfaces, from copy & pasting to using the Server; see below.

The Server helps participants and coordinators communicate with each other.

The FROST client is a CLI tool that serves as an example of how to interact with the server.

The Zcash Signer is a standalone tool that allows signing a Zcash transaction with an externally-generated signature (e.g. using FROST, but could be something else).

Status ⚠

Trusted Dealer demo - WIP DKG demo - WIP Coordinator demo - WIP Participant demo - WIP

Usage

NOTE: This is for demo purposes only and should not be used in production.

You will need to have Rust and Cargo installed.

To run:

  1. Clone the repo. Run git clone https://github.com/ZcashFoundation/frost-zcash-demo.git
  2. Run cargo install

and in separate terminals: 3. Run cargo run --bin trusted-dealer or cargo run --bin dkg 4. Run cargo run --bin coordinator 5. Run cargo run --bin participants. Do this in separate terminals for separate participants.

The demos support three communication mechanisms. By using the --cli flag (e.g. cargo run --bin dkg -- --cli), they will print JSON objects to the terminal, and participants will need to copy & paste objects and send them amongst themselves to complete the protocol.

Without the --cli flag, the demos will use socket communications. The coordinator will act as the server and the participants will be clients. With the --http flag, the demos will use socket communications, using a server (in the server crate) to coordinate communications. See examples below.

Socket communication example

Create 3 key shares with threshold 2 using trusted dealer:

cargo run --bin trusted-dealer -- -t 2 -n 3

The key packages will be written to files. Securely send the partipant's key packages to them (or just proceed if you are running everything locally for testing).

Start a signing run as the coordinator:

cargo run --bin coordinator -- -i 0.0.0.0 -p 2744 -n 2 -m message.raw -s sig.raw

This will start a server listening for connections to any IP using port 2744. (These are the default values so feel free to omit them.) The protocol will run with 2 participants, signing the message inside message.raw (replace as appropriate). The signature will be written to sig.raw. The program will keep running while it waits for the participants to connect to it.

Each participant should then run (or run in different terminals if you're testing locally):

cargo run --bin participant -- -i 127.0.0.1 -p 2744 -k key-package-1.json

It will connect to the Coordinator using the given IP and port (replace as needed), using the specified key package (again replace as needed).

Once two participants are running, the Coordinator should complete the protocol and write the signature to specified file.

Socket communication with server example

See the Ywallet demo tutorial.

Curve selection

Currently the demo supports curve Ed25519 and RedPallas. To use RedPallas, pass -C redpallas to all commands (after --). When it's enabled, it will automatically switch to Rerandomized FROST and it can be used to sign Zcash transactions.