aboutsummaryrefslogtreecommitdiff
path: root/types/types.go
blob: 483dac018f47030ebb50975cbedc4255ec0d0cf1 (plain)
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
package types

import (
	"crypto/ed25519"
	"crypto/sha256"
)

const (
	HashSize      = sha256.Size
	SignatureSize = ed25519.SignatureSize
)

// Leaf is the log's Merkle tree leaf.
//
// Ref: https://github.com/system-transparency/stfe/blob/design/doc/api.md#merkle-tree-leaf
type Leaf struct {
	Message
	SigIdent
}

// Message is composed of a shard hint and a checksum.  The submitter selects
// these values to fit the log's shard interval and the opaque data in question.
type Message struct {
	ShardHint uint64
	Checksum  [HashSize]byte
}

// SigIdent is composed of a signature-signer pair.  The signature is computed
// over the Trunnel-serialized leaf message.  KeyHash identifies the signer.
type SigIdent struct {
	Signature [SignatureSize]byte
	KeyHash   [HashSize]byte
}

// SignedTreeHead is composed of a tree head and a list of signature-signer
// pairs.  Each signature is computed over the Trunnel-serialized tree head.
//
// Ref: https://github.com/system-transparency/stfe/blob/design/doc/api.md#get-tree-head-cosigned
// Ref: https://github.com/system-transparency/stfe/blob/design/doc/api.md#get-tree-head-to-sign
// Ref: https://github.com/system-transparency/stfe/blob/design/doc/api.md#get-tree-head-latest
type SignedTreeHead struct {
	TreeHead
	SigIdent []SigIdent
}

// TreeHead is the log's tree head.
//
// Ref: https://github.com/system-transparency/stfe/blob/design/doc/api.md#merkle-tree-head
type TreeHead struct {
	Timestamp uint64
	TreeSize  uint64
	RootHash  [HashSize]byte
}

// ConsistencyProof is a consistency proof that proves the log's append-only
// property.
//
// Ref: https://github.com/system-transparency/stfe/blob/design/doc/api.md#get-consistency-proof
type ConsistencyProof struct {
	NewSize uint64
	OldSize uint64
	Path    [][HashSize]byte
}

// InclusionProof is an inclusion proof that proves a leaf is included in the
// log.
//
// Ref: https://github.com/system-transparency/stfe/blob/design/doc/api.md#get-proof-by-hash
type InclusionProof struct {
	TreeSize  uint64
	LeafIndex uint64
	Path      [][HashSize]byte
}