% SPLINTER-CIRCUIT-VOTE(1) Cargill, Incorporated | Splinter Commands
NAME
splinter-circuit-vote — Submits a vote to accept or reject a circuit proposal
SYNOPSIS
splinter circuit vote [FLAGS] [OPTIONS] CIRCUIT-ID –accept –reject
DESCRIPTION
Vote on a new circuit proposal by specifying the circuit ID of the circuit the node
is voting on, as well as the flag to --accept
or --reject
. The generated ID of
a proposed circuit can be viewed using the splinter-circuit-proposals
command and
this circuit ID is used to specify the circuit proposal being voted on. A circuit
proposal is viewable, via the splinter-circuit-proposals
or splinter-circuit-show
commands, by all proposed member nodes unless a proposed member node votes to
reject the circuit proposal. A circuit proposal needs to be voted on by all proposed
members that did not propose the circuit in the first place. Circuit proposers have
an assumed ACCEPT
vote, as these nodes requested the creation of the circuit.
FLAGS
--accept
- Accept the circuit proposal specified.
-
-h
,--help
- Prints help information.
-
-q
,--quiet
- Decrease verbosity (the opposite of -v). When specified, only errors or warnings will be output.
--reject
- Reject the circuit proposal specified.
-
-V
,--version
- Prints version information.
-v
- Increases verbosity (the opposite of -q). Specify multiple times for more output.
OPTIONS
-
-k
,--key
PRIVATE-KEY-FILE - Specifies the full path to the private key file.
-
-U
,--url
URL - Specifies the URL for the
splinterd
REST API. The URL is required unless$SPLINTER_REST_API_URL
is set.
ARGUMENTS
CIRCUIT-ID
- Specify the circuit ID of the circuit to be voted on.
EXAMPLES
- The proposed circuit has ID
1234-ABCDE
.
The following command displays a member node voting to accept the circuit proposal:
$ splinter circuit vote \
--key PROPOSED-MEMBER-NODE-PRIVATE-KEY-FILE \
--url URL-of-proposed-member-node-splinterd-REST-API \
1234-ABCDE \
--accept
The following command displays a member node voting to reject the circuit proposal:
$ splinter circuit vote \
--key PROPOSED-MEMBER-NODE-PRIVATE-KEY-FILE \
--url URL-of-proposed-member-node-splinterd-REST-API \
1234-ABCDE \
--reject
ENVIRONMENT VARIABLES
- SPLINTER_REST_API_URL
- URL for the
splinterd
REST API. (See-U
,--url
.)
SEE ALSO
| splinter-circuit-propose(1)
| splinter-circuit-proposals(1)
| splinter-circuit-show(1)
|
| Splinter documentation: https://www.splinter.dev/docs/0.4/