aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/github.com/tangerine-network/tangerine-consensus/core/types/vote.go
blob: 01506454142bdbda2e8cb043d2e1e9f75cbf21f2 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
// Copyright 2018 The dexon-consensus Authors
// This file is part of the dexon-consensus library.
//
// The dexon-consensus library is free software: you can redistribute it
// and/or modify it under the terms of the GNU Lesser General Public License as
// published by the Free Software Foundation, either version 3 of the License,
// or (at your option) any later version.
//
// The dexon-consensus library is distributed in the hope that it will be
// useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
// General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public License
// along with the dexon-consensus library. If not, see
// <http://www.gnu.org/licenses/>.

package types

import (
    "fmt"

    "github.com/tangerine-network/tangerine-consensus/common"
    "github.com/tangerine-network/tangerine-consensus/core/crypto"
    cryptoDKG "github.com/tangerine-network/tangerine-consensus/core/crypto/dkg"
)

// VoteType is the type of vote.
type VoteType byte

// VoteType enum.
const (
    VoteInit VoteType = iota
    VotePreCom
    VoteCom
    VoteFast
    VoteFastCom
    // Do not add any type below MaxVoteType.
    MaxVoteType
)

// NullBlockHash is the blockHash for ⊥ value.
var NullBlockHash common.Hash

// SkipBlockHash is the blockHash for SKIP value.
var SkipBlockHash common.Hash

func init() {
    for idx := range SkipBlockHash {
        SkipBlockHash[idx] = 0xff
    }
}

// VoteHeader is the header for vote, which can be used as map keys.
type VoteHeader struct {
    ProposerID NodeID      `json:"proposer_id"`
    Type       VoteType    `json:"type"`
    BlockHash  common.Hash `json:"block_hash"`
    Period     uint64      `json:"period"`
    Position   Position    `json:"position"`
}

// Vote is the vote structure defined in Crypto Shuffle Algorithm.
type Vote struct {
    VoteHeader       `json:"header"`
    PartialSignature cryptoDKG.PartialSignature `json:"partial_signature"`
    Signature        crypto.Signature           `json:"signature"`
}

func (v *Vote) String() string {
    return fmt.Sprintf("Vote{VP:%s %s Period:%d Type:%d Hash:%s}",
        v.ProposerID.String()[:6],
        v.Position, v.Period, v.Type, v.BlockHash.String()[:6])
}

// NewVote constructs a Vote instance with header fields.
func NewVote(t VoteType, hash common.Hash, period uint64) *Vote {
    return &Vote{
        VoteHeader: VoteHeader{
            Type:      t,
            BlockHash: hash,
            Period:    period,
        }}
}

// Clone returns a deep copy of a vote.
func (v *Vote) Clone() *Vote {
    return &Vote{
        VoteHeader: VoteHeader{
            ProposerID: v.ProposerID,
            Type:       v.Type,
            BlockHash:  v.BlockHash,
            Period:     v.Period,
            Position:   v.Position,
        },
        PartialSignature: cryptoDKG.PartialSignature(
            crypto.Signature(v.PartialSignature).Clone()),
        Signature: v.Signature.Clone(),
    }
}