2015-08-10 20:38:45 -07:00
|
|
|
package types
|
2014-09-03 19:21:19 -07:00
|
|
|
|
|
|
|
import (
|
2014-12-09 18:49:04 -08:00
|
|
|
"bytes"
|
2014-10-18 01:42:33 -07:00
|
|
|
"fmt"
|
2014-09-03 19:21:19 -07:00
|
|
|
|
2015-11-01 11:34:08 -08:00
|
|
|
"github.com/tendermint/go-crypto"
|
2017-04-27 16:01:18 -07:00
|
|
|
cmn "github.com/tendermint/tmlibs/common"
|
2014-09-03 19:21:19 -07:00
|
|
|
)
|
|
|
|
|
2014-12-09 18:49:04 -08:00
|
|
|
// Volatile state for each Validator
|
2017-05-16 12:31:19 -07:00
|
|
|
// NOTE: The Accum is not included in Validator.Hash();
|
|
|
|
// make sure to update that method if changes are made here
|
2014-09-03 19:21:19 -07:00
|
|
|
type Validator struct {
|
2018-01-14 16:05:22 -08:00
|
|
|
Address Address `json:"address"`
|
|
|
|
PubKey crypto.PubKey `json:"pub_key"`
|
|
|
|
VotingPower int64 `json:"voting_power"`
|
2017-05-16 12:31:19 -07:00
|
|
|
|
|
|
|
Accum int64 `json:"accum"`
|
2014-09-03 19:21:19 -07:00
|
|
|
}
|
|
|
|
|
2016-11-19 16:32:35 -08:00
|
|
|
func NewValidator(pubKey crypto.PubKey, votingPower int64) *Validator {
|
|
|
|
return &Validator{
|
|
|
|
Address: pubKey.Address(),
|
|
|
|
PubKey: pubKey,
|
|
|
|
VotingPower: votingPower,
|
|
|
|
Accum: 0,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-09-03 19:21:19 -07:00
|
|
|
// Creates a new copy of the validator so we can mutate accum.
|
2015-07-10 09:55:23 -07:00
|
|
|
// Panics if the validator is nil.
|
2014-09-03 19:21:19 -07:00
|
|
|
func (v *Validator) Copy() *Validator {
|
2014-11-05 03:08:29 -08:00
|
|
|
vCopy := *v
|
|
|
|
return &vCopy
|
2014-09-03 19:21:19 -07:00
|
|
|
}
|
|
|
|
|
2014-10-11 21:27:58 -07:00
|
|
|
// Returns the one with higher Accum.
|
|
|
|
func (v *Validator) CompareAccum(other *Validator) *Validator {
|
|
|
|
if v == nil {
|
|
|
|
return other
|
2014-09-14 15:37:32 -07:00
|
|
|
}
|
2014-10-11 21:27:58 -07:00
|
|
|
if v.Accum > other.Accum {
|
|
|
|
return v
|
|
|
|
} else if v.Accum < other.Accum {
|
|
|
|
return other
|
|
|
|
} else {
|
2014-12-09 18:49:04 -08:00
|
|
|
if bytes.Compare(v.Address, other.Address) < 0 {
|
2014-10-11 21:27:58 -07:00
|
|
|
return v
|
2014-12-09 18:49:04 -08:00
|
|
|
} else if bytes.Compare(v.Address, other.Address) > 0 {
|
2014-10-11 21:27:58 -07:00
|
|
|
return other
|
|
|
|
} else {
|
2017-04-27 16:01:18 -07:00
|
|
|
cmn.PanicSanity("Cannot compare identical validators")
|
2015-07-19 16:42:52 -07:00
|
|
|
return nil
|
2014-09-03 19:21:19 -07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-10-18 01:42:33 -07:00
|
|
|
func (v *Validator) String() string {
|
2015-07-10 09:55:23 -07:00
|
|
|
if v == nil {
|
|
|
|
return "nil-Validator"
|
|
|
|
}
|
2017-05-16 16:08:41 -07:00
|
|
|
return fmt.Sprintf("Validator{%v %v VP:%v A:%v}",
|
2014-12-09 18:49:04 -08:00
|
|
|
v.Address,
|
|
|
|
v.PubKey,
|
2014-11-05 03:08:29 -08:00
|
|
|
v.VotingPower,
|
|
|
|
v.Accum)
|
|
|
|
}
|
|
|
|
|
2017-05-16 12:31:19 -07:00
|
|
|
// Hash computes the unique ID of a validator with a given voting power.
|
2017-09-05 13:52:25 -07:00
|
|
|
// It excludes the Accum value, which changes with every round.
|
2014-11-05 03:08:29 -08:00
|
|
|
func (v *Validator) Hash() []byte {
|
2018-03-30 15:18:43 -07:00
|
|
|
return aminoHash(struct {
|
2018-01-05 22:26:51 -08:00
|
|
|
Address Address
|
2017-05-16 12:31:19 -07:00
|
|
|
PubKey crypto.PubKey
|
|
|
|
VotingPower int64
|
|
|
|
}{
|
|
|
|
v.Address,
|
|
|
|
v.PubKey,
|
|
|
|
v.VotingPower,
|
|
|
|
})
|
2014-10-18 01:42:33 -07:00
|
|
|
}
|
|
|
|
|
2018-03-30 15:18:43 -07:00
|
|
|
//----------------------------------------
|
|
|
|
// RandValidator
|
2015-12-31 15:02:38 -08:00
|
|
|
|
2017-09-22 09:00:37 -07:00
|
|
|
// RandValidator returns a randomized validator, useful for testing.
|
|
|
|
// UNSTABLE
|
2018-03-30 15:18:43 -07:00
|
|
|
func RandValidator(randPower bool, minPower int64) (*Validator, PrivValidator) {
|
|
|
|
privVal := NewMockPV()
|
2015-12-31 15:02:38 -08:00
|
|
|
votePower := minPower
|
|
|
|
if randPower {
|
2017-04-27 16:01:18 -07:00
|
|
|
votePower += int64(cmn.RandUint32())
|
2015-12-31 15:02:38 -08:00
|
|
|
}
|
2017-09-21 13:32:02 -07:00
|
|
|
val := NewValidator(privVal.GetPubKey(), votePower)
|
2015-12-31 15:02:38 -08:00
|
|
|
return val, privVal
|
|
|
|
}
|