cosi

command
v0.0.0-...-6588121 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 3, 2018 License: GPL-3.0, LGPL-3.0, AGPL-3.0 Imports: 19 Imported by: 0

README

CoSi

This package provides functionality to request and verify collective signatures as well as run a standalone server for handling collective signing requests.

WARNING: this package is kept here for historical and research purposes. It should not be used in other services as it has been deprecated by the ftcosi package.

Getting Started

To use the code of this package you need to:

  • Install Golang
  • Optional: Set $GOPATH to point to your workspace directory
  • Put $GOPATH/bin in your PATH: export PATH=$PATH:$(go env GOPATH)/bin

To build and install the CoSi application, execute:

go get -u github.com/dedis/cothority/cosi

Functionality Overview

cosi help
NAME:
   CoSi App - Collectively sign or verify a file; run a server for collective signing

USAGE:
   cosi [global options] command [command options] [arguments...]

VERSION:
   0.10

COMMANDS:
     sign, s    Requests a collectively signature for a 'file'; signature is written to STDOUT by default
     verify, v  Verifies a collective signature of a 'file'; signature is read from STDIN by default
     check, c   Checks if the servers in the group definition are up and running
     server     Starts a CoSi server
     help, h    Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --debug value, -d value  debug-level: 1 for terse, 5 for maximal (default: 0)
   --help, -h               show help
   --version, -v            print the version

Using the CoSi Client

Configuration

To tell the CoSi client which existing cothority (public key) it should use for signing requests (signature verification), you need to specify a configuration file. For example, you could use the DEDIS cothority configuration file which is included in this repository. To have a shortcut for later on, set:

export COTHORITY=$(go env GOPATH)/src/github.com/dedis/cothority/dedis-cothority.toml 
Usage

To request a collective (Schnorr) signature file.sig on a file from the DEDIS cothority, use:

cosi sign -g $COTHORITY -o file.sig file

To verify a collective (Schnorr) signature file.sig of the file, use:

cosi verify -g $COTHORITY -s file.sig file

To check the status of a collective signing group, use:

cosi check -g $COTHORITY

This will first contact each server individually and then check a few random collective signing group constellations. If there are connectivity problems, due to firewalls or bad connections, for example, you will see a "Timeout on signing" or similar error message.

Further Information

For more details, e.g., to learn how you can run your own CoSi server or cothority, see the wiki.

Documentation

Overview

CoSi is a scalable protocol for collectively signing messages. CoSi produces compact signatures that clients can verify efficiently, and that convey the precise set of cosigners for transparency.

Directories

Path Synopsis
Package crypto is a temporary copy of gopkg.in/dedis/crypto.v0/cosi.
Package crypto is a temporary copy of gopkg.in/dedis/crypto.v0/cosi.
Package cosi implements a round of a Collective Signing protocol.
Package cosi implements a round of a Collective Signing protocol.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
⌂ 换网址