tari_core 5.3.1

Core Tari protocol components
Documentation 
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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160

// Copyright 2022 The Tari Project
// SPDX-License-Identifier: BSD-3-Clause

syntax = "proto3";

import "types.proto";

package tari.types;

message SideChainFeature {
  oneof side_chain_feature {
    ValidatorNodeRegistration validator_node_registration = 1;
    TemplateRegistration template_registration = 2;
    ConfidentialOutputData confidential_output = 3;
    EvictionProof eviction_proof = 4;
    ValidatorNodeExit validator_node_exit = 5;
  }
  SidechainId sidechain_id = 6;
}

message SidechainId {
  bytes public_key = 1;
  Signature knowledge_proof = 2;
}

message ValidatorNodeRegistration {
  bytes public_key = 1;
  Signature signature = 2;
  bytes claim_public_key = 3;
  uint64 max_epoch = 4;
}

message ValidatorNodeExit {
  bytes public_key = 1;
  Signature signature = 2;
  uint64 max_epoch = 3;
}

message TemplateRegistration {
  bytes author_public_key = 1;
  Signature author_signature = 2;
  string template_name = 3;
  uint32 template_version = 4;
  TemplateType template_type = 5;
  BuildInfo build_info = 6;
  bytes binary_sha = 7;
  string binary_url = 8;
}

message ConfidentialOutputData {
  bytes claim_public_key = 1;
}

message TemplateType {
  oneof template_type {
    WasmInfo wasm = 1;
    FlowInfo flow = 2;
    ManifestInfo manifest = 3;
  }
}
message WasmInfo {
  uint32 abi_version = 1;
}

message FlowInfo {

}

message ManifestInfo {

}

message BuildInfo {
  string repo_url = 1;
  bytes commit_hash = 2;
}

message EvictionProof {
  CommitProof proof = 1;
}

message CommitProof {
  oneof version {
    CommitProofV1 v1 = 1;
  }
}

message CommitProofV1 {
  bytes command = 1;
  SidechainBlockCommitProof commit_proof = 2;
  bytes encoded_inclusion_proof = 3;
}

message SidechainBlockCommitProof {
  SidechainBlockHeader header = 1;
  repeated CommitProofElement proof_elements = 2;
}

message CommitProofElement {
  oneof proof_element {
    QuorumCertificate quorum_certificate = 1;
    DummyChain dummy_chain = 2;
  }
}

message DummyChain {
  repeated ChainLink chain_links = 1;
}

message ChainLink {
  bytes header_hash = 1;
  bytes parent_id = 2;
}

message SidechainBlockHeader {
  uint32 network = 1;
  bytes parent_id = 2;
  bytes justify_id = 3;
  uint64 height = 4;
  uint64 epoch = 5;
  ShardGroup shard_group = 6;
  bytes proposed_by = 7;
  bytes state_merkle_root = 8;
  bytes command_merkle_root = 9;
  Signature signature = 10;
  bytes metadata_hash = 11;
  ShardGroupAccumulatedData accumulated_data = 12;
  bytes epoch_hash = 13;
}

message EvictAtom {
  bytes public_key = 1;
}

message QuorumCertificate {
  bytes header_hash = 1;
  bytes parent_id = 2;
  repeated ValidatorSignature signatures = 3;
  QuorumDecision decision = 4;
}

enum QuorumDecision {
  Accept = 0;
  Reject = 1;
}

message ValidatorSignature {
  bytes public_key = 1;
  Signature signature = 2;
}

message ShardGroup {
  uint32 start = 1;
  uint32 end_inclusive = 2;
}

message ShardGroupAccumulatedData {
  uint64 total_exhaust_burn_msb = 1;
  uint64 total_exhaust_burn_lsb = 2;
}