fluencelabs/tendermint
1
0
Fork 0
mirror of https://github.com/fluencelabs/tendermint synced 2025-04-25 06:42:16 +00:00
Code Issues Projects Releases Wiki Activity

evidence submission

Browse Source
This commit is contained in:
Anton Kaliaev 2019-08-28 16:02:45 +04:00
parent 804023299a
commit 7402276325
No known key found for this signature in database
GPG Key ID: 7B6881D965918214
1 changed files with 18 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
docs/architecture/adr-044-lite-client-with-weak-subjectivity.md
View File

@ -167,8 +167,9 @@ type Verifier struct {
// Source of new FullCommit(s). // Source of new FullCommit(s).
source Provider source Provider
// Backup sources for checking the primary for misbehavior by comparing data // Alternative sources for checking the primary for misbehavior by comparing data.
backup []Provider // If the primary misbehaves, we report the evidence to them.
verifiers []ProviderAndEvidenceReporter
// Where trusted FullCommit(s) are stored. // Where trusted FullCommit(s) are stored.
trusted PersistentProvider trusted PersistentProvider
@ -177,8 +178,8 @@ type Verifier struct {
Since providers themselves don't know when they have received a new header (or Since providers themselves don't know when they have received a new header (or
may choose to do so upon a request), we must add a new function to `Verifier` - may choose to do so upon a request), we must add a new function to `Verifier` -
`Verify(height int64) error`. It will try to fetch a new header & validator set `Verify(height int64) error` (0 - latest). It will try to fetch a new header &
and verify it. validator set and verify it. nop if already verified.
**Sequential vs bisecting verifier** **Sequential vs bisecting verifier**
@ -285,10 +286,20 @@ type FullCommit struct {
When/if evidence is received, client should check it and disconnect from the When/if evidence is received, client should check it and disconnect from the
node if `evidence.Address == TrustOptions.ValidatorAddress`. It's unwise to node if `evidence.Address == TrustOptions.ValidatorAddress`. It's unwise to
think that a node will send an evidence of its misbehavior. That's why we think that a node will send an evidence of its misbehavior. That's why we
should also check `backup` sources in the background. should also check `verifiers` sources in the background.
Submitting an evidence comes down to calling `BroadcastEvidence` on the backup _Evidence handling can be implemented in the second version._
sources.
Submitting an evidence comes down to calling `ReportEvidence(ev types.Evidence)
error` on the `verifiers` sources.
```go
type ProviderAndEvidenceReporter interface {
Provider
ReportEvidence(ev types.Evidence) error
}
```
## Status ## Status