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

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

syntax = "proto3";

import "transaction.proto";
import "block.proto";

package tari.base_node;

// Request message used to initiate a sync
message SyncBlocksRequest {
  // Start sending from this hash (exclusive)
  bytes start_hash = 1;
  // The hash of the last block that should be synced
  bytes end_hash = 2;
}

// Response that contains the full body of a block
message BlockBodyResponse {
  bytes hash = 1;
  tari.types.AggregateBody body = 2;
}

// Request message used to initiate a sync
message SyncHeadersRequest {
  // Start sending from this hash (exclusive)
  bytes start_hash = 1;
  // Number of blocks to send. If this is zero (empty) the peer SHOULD send to
  // their tip height
  uint64 count = 2;
}

// Find at which point the chain splits.
message FindChainSplitRequest {
  // A set of block hashes ordered in height descending order from the chain
  // tip.
  repeated bytes block_hashes = 1;
  // The maximum number of headers to return starting at the first header after
  // the matched height
  uint64 header_count = 2;
}

message FindChainSplitResponse {
  // An ordered list of headers starting from next header after the matching
  // hash, up until `FindChainSplitRequest::count`
  repeated tari.core.BlockHeader headers = 1;
  // The index of the hash that matched from
  // `FindChainSplitRequest::block_hashes`. This value could also be used to
  // know how far back a split occurs.
  uint64 fork_hash_index = 2;
}

message SyncKernelsRequest {
  uint64 start = 1;
  bytes end_header_hash = 2;
}

message SyncUtxosRequest {
  // Start header hash to sync UTXOs from
  bytes start_header_hash = 1;
  // End header hash to sync UTXOs to
  bytes end_header_hash = 2;
}

message SyncUtxosResponse {
  oneof txo {
    // The unspent transaction output
    tari.types.TransactionOutput output = 1;
    // If the TXO is spent, the commitment bytes are returned
    bytes commitment = 2;
  }
  bytes mined_header = 3;
}

message SyncUtxosByBlockRequest {
  bytes start_header_hash = 1;
  bytes end_header_hash = 2;
}

message SyncUtxosByBlockResponse {
  repeated tari.types.TransactionOutput outputs = 1;
  uint64 height = 2;
  bytes header_hash = 3;
  uint64 mined_timestamp = 4;
}

message GetMempoolFeePerGramStatsRequest {
  uint64 count = 1;
}

message GetMempoolFeePerGramStatsResponse {
  repeated MempoolFeePerGramStat stats = 1;
}

message MempoolFeePerGramStat {
  uint64 order = 1;
  uint64 max_fee_per_gram = 2;
  uint64 avg_fee_per_gram = 4;
  uint64 min_fee_per_gram = 5;
}

message GetWalletQueryHttpServiceAddressResponse {
  string http_address = 1;
}