You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
81 lines
2.2 KiB
81 lines
2.2 KiB
syntax = "proto3"; |
|
package cash.z.wallet.sdk.rpc; |
|
option go_package = "walletrpc"; |
|
|
|
import "compact_formats.proto"; |
|
|
|
// A BlockID message contains identifiers to select a block: a height or a |
|
// hash. If the hash is present it takes precedence. |
|
message BlockID { |
|
uint64 height = 1; |
|
bytes hash = 2; |
|
} |
|
|
|
// BlockRange technically allows ranging from hash to hash etc but this is not |
|
// currently intended for support, though there is no reason you couldn't do |
|
// it. Further permutations are left as an exercise. |
|
message BlockRange { |
|
BlockID start = 1; |
|
BlockID end = 2; |
|
} |
|
|
|
// A TxFilter contains the information needed to identify a particular |
|
// transaction: either a block and an index, or a direct transaction hash. |
|
message TxFilter { |
|
BlockID block = 1; |
|
uint64 index = 2; |
|
bytes hash = 3; |
|
} |
|
|
|
// RawTransaction contains the complete transaction data. It also optionally includes |
|
// the block height in which the transaction was included |
|
message RawTransaction { |
|
bytes data = 1; |
|
uint64 height = 2; |
|
} |
|
|
|
message SendResponse { |
|
int32 errorCode = 1; |
|
string errorMessage = 2; |
|
} |
|
|
|
// Empty placeholder. Someday we may want to specify e.g. a particular chain fork. |
|
message ChainSpec {} |
|
|
|
message Empty {} |
|
|
|
message LightdInfo { |
|
string version = 1; |
|
string vendor = 2; |
|
bool taddrSupport = 3; |
|
string chainName = 4; |
|
uint64 saplingActivationHeight = 5; |
|
string consensusBranchId = 6; // This should really be u32 or []byte, but string for readability |
|
uint64 blockHeight = 7; |
|
} |
|
|
|
message TransparentAddress { |
|
string address = 1; |
|
} |
|
|
|
message TransparentAddressBlockFilter { |
|
string address = 1; |
|
BlockRange range = 2; |
|
} |
|
|
|
service CompactTxStreamer { |
|
// Compact Blocks |
|
rpc GetLatestBlock(ChainSpec) returns (BlockID) {} |
|
rpc GetBlock(BlockID) returns (CompactBlock) {} |
|
rpc GetBlockRange(BlockRange) returns (stream CompactBlock) {} |
|
|
|
// Transactions |
|
rpc GetTransaction(TxFilter) returns (RawTransaction) {} |
|
rpc SendTransaction(RawTransaction) returns (SendResponse) {} |
|
|
|
// t-Address support |
|
rpc GetAddressTxids(TransparentAddressBlockFilter) returns (stream RawTransaction) {} |
|
|
|
// Misc |
|
rpc GetLightdInfo(Empty) returns (LightdInfo) {} |
|
}
|
|
|