zcash_client_backend: Add gRPC bindings behind feature flag
The lightwalletd service file is sourced from: Git: https://github.com/zcash/lightwalletd Rev: ad5ecda5fbb5e12799f926b8cd785d54fdd250c8 Closes zcash/librustzcash#585.
This commit is contained in:
parent
379b703e6b
commit
17a4830c70
|
@ -1 +1,2 @@
|
||||||
zcash_client_backend/src/proto/compact_formats.rs linguist-generated=true
|
zcash_client_backend/src/proto/compact_formats.rs linguist-generated=true
|
||||||
|
zcash_client_backend/src/proto/service.rs linguist-generated=true
|
||||||
|
|
|
@ -47,6 +47,8 @@ and this library adheres to Rust's notion of
|
||||||
- `zcash_client_backend::proto`:
|
- `zcash_client_backend::proto`:
|
||||||
- `actions` field on `compact_formats::CompactTx`
|
- `actions` field on `compact_formats::CompactTx`
|
||||||
- `compact_formats::CompactOrchardAction`
|
- `compact_formats::CompactOrchardAction`
|
||||||
|
- gRPC bindings for the `lightwalletd` server, behind a `lightwalletd-tonic`
|
||||||
|
feature flag.
|
||||||
- `zcash_client_backend::zip321::TransactionRequest` methods:
|
- `zcash_client_backend::zip321::TransactionRequest` methods:
|
||||||
- `TransactionRequest::new` for constructing a request from `Vec<Payment>`.
|
- `TransactionRequest::new` for constructing a request from `Vec<Payment>`.
|
||||||
- `TransactionRequest::payments` for accessing the `Payments` that make up a
|
- `TransactionRequest::payments` for accessing the `Payments` that make up a
|
||||||
|
|
|
@ -42,8 +42,9 @@ hdwallet = { version = "0.3.1", optional = true }
|
||||||
memuse = "0.2"
|
memuse = "0.2"
|
||||||
tracing = "0.1"
|
tracing = "0.1"
|
||||||
|
|
||||||
# - Protobuf interfaces
|
# - Protobuf interfaces and gRPC bindings
|
||||||
prost = "0.11"
|
prost = "0.11"
|
||||||
|
tonic = { version = "0.8", optional = true }
|
||||||
|
|
||||||
# - Secret management
|
# - Secret management
|
||||||
secrecy = "0.8"
|
secrecy = "0.8"
|
||||||
|
@ -71,7 +72,7 @@ crossbeam-channel = "0.5"
|
||||||
rayon = "1.5"
|
rayon = "1.5"
|
||||||
|
|
||||||
[build-dependencies]
|
[build-dependencies]
|
||||||
prost-build = "0.11"
|
tonic-build = "0.8"
|
||||||
which = "4"
|
which = "4"
|
||||||
|
|
||||||
[dev-dependencies]
|
[dev-dependencies]
|
||||||
|
@ -86,6 +87,7 @@ zcash_proofs = { version = "0.8", path = "../zcash_proofs" }
|
||||||
zcash_address = { version = "0.2", path = "../components/zcash_address", features = ["test-dependencies"] }
|
zcash_address = { version = "0.2", path = "../components/zcash_address", features = ["test-dependencies"] }
|
||||||
|
|
||||||
[features]
|
[features]
|
||||||
|
lightwalletd-tonic = ["tonic"]
|
||||||
transparent-inputs = ["hdwallet", "zcash_primitives/transparent-inputs"]
|
transparent-inputs = ["hdwallet", "zcash_primitives/transparent-inputs"]
|
||||||
test-dependencies = [
|
test-dependencies = [
|
||||||
"proptest",
|
"proptest",
|
||||||
|
|
|
@ -5,22 +5,22 @@ use std::path::{Path, PathBuf};
|
||||||
|
|
||||||
const COMPACT_FORMATS_PROTO: &str = "proto/compact_formats.proto";
|
const COMPACT_FORMATS_PROTO: &str = "proto/compact_formats.proto";
|
||||||
|
|
||||||
fn main() -> io::Result<()> {
|
#[cfg(feature = "lightwalletd-tonic")]
|
||||||
// We don't include the proto files in releases so that downstreams do not need to
|
const SERVICE_PROTO: &str = "proto/service.proto";
|
||||||
// regenerate the bindings even if protoc is present.
|
|
||||||
if Path::new(COMPACT_FORMATS_PROTO).exists() {
|
|
||||||
println!("cargo:rerun-if-changed={}", COMPACT_FORMATS_PROTO);
|
|
||||||
|
|
||||||
// We check for the existence of protoc in the same way as prost_build, so that people
|
fn main() -> io::Result<()> {
|
||||||
// building from source do not need to have protoc installed. If they make changes to
|
// - We don't include the proto files in releases so that downstreams do not need to
|
||||||
// the proto files, the discrepancy will be caught by CI.
|
// regenerate the bindings even if protoc is present.
|
||||||
if env::var_os("PROTOC")
|
// - We check for the existence of protoc in the same way as prost_build, so that
|
||||||
|
// people building from source do not need to have protoc installed. If they make
|
||||||
|
// changes to the proto files, the discrepancy will be caught by CI.
|
||||||
|
if Path::new(COMPACT_FORMATS_PROTO).exists()
|
||||||
|
&& env::var_os("PROTOC")
|
||||||
.map(PathBuf::from)
|
.map(PathBuf::from)
|
||||||
.or_else(|| which::which("protoc").ok())
|
.or_else(|| which::which("protoc").ok())
|
||||||
.is_some()
|
.is_some()
|
||||||
{
|
{
|
||||||
build()?;
|
build()?;
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
Ok(())
|
Ok(())
|
||||||
|
@ -31,13 +31,47 @@ fn build() -> io::Result<()> {
|
||||||
.expect("Cannot find OUT_DIR environment variable")
|
.expect("Cannot find OUT_DIR environment variable")
|
||||||
.into();
|
.into();
|
||||||
|
|
||||||
prost_build::compile_protos(&[COMPACT_FORMATS_PROTO], &["proto/"])?;
|
// Build the compact format types.
|
||||||
|
tonic_build::compile_protos(COMPACT_FORMATS_PROTO)?;
|
||||||
|
|
||||||
// Copy the generated files into the source tree so changes can be committed.
|
// Copy the generated types into the source tree so changes can be committed.
|
||||||
fs::copy(
|
fs::copy(
|
||||||
out.join("cash.z.wallet.sdk.rpc.rs"),
|
out.join("cash.z.wallet.sdk.rpc.rs"),
|
||||||
"src/proto/compact_formats.rs",
|
"src/proto/compact_formats.rs",
|
||||||
)?;
|
)?;
|
||||||
|
|
||||||
|
#[cfg(feature = "lightwalletd-tonic")]
|
||||||
|
{
|
||||||
|
// Build the gRPC types and client.
|
||||||
|
tonic_build::configure()
|
||||||
|
.build_server(false)
|
||||||
|
.extern_path(
|
||||||
|
".cash.z.wallet.sdk.rpc.CompactBlock",
|
||||||
|
"crate::proto::compact_formats::CompactBlock",
|
||||||
|
)
|
||||||
|
.extern_path(
|
||||||
|
".cash.z.wallet.sdk.rpc.CompactTx",
|
||||||
|
"crate::proto::compact_formats::CompactTx",
|
||||||
|
)
|
||||||
|
.extern_path(
|
||||||
|
".cash.z.wallet.sdk.rpc.CompactSaplingSpend",
|
||||||
|
"crate::proto::compact_formats::CompactSaplingSpend",
|
||||||
|
)
|
||||||
|
.extern_path(
|
||||||
|
".cash.z.wallet.sdk.rpc.CompactSaplingOutput",
|
||||||
|
"crate::proto::compact_formats::CompactSaplingOutput",
|
||||||
|
)
|
||||||
|
.extern_path(
|
||||||
|
".cash.z.wallet.sdk.rpc.CompactOrchardAction",
|
||||||
|
"crate::proto::compact_formats::CompactOrchardAction",
|
||||||
|
)
|
||||||
|
.compile(&[SERVICE_PROTO], &["proto/"])?;
|
||||||
|
|
||||||
|
// Copy the generated types into the source tree so changes can be committed. The
|
||||||
|
// file has the same name as for the compact format types because they have the
|
||||||
|
// same package, but we've set things up so this only contains the service types.
|
||||||
|
fs::copy(out.join("cash.z.wallet.sdk.rpc.rs"), "src/proto/service.rs")?;
|
||||||
|
}
|
||||||
|
|
||||||
Ok(())
|
Ok(())
|
||||||
}
|
}
|
||||||
|
|
|
@ -0,0 +1,187 @@
|
||||||
|
// Copyright (c) 2019-2020 The Zcash developers
|
||||||
|
// Distributed under the MIT software license, see the accompanying
|
||||||
|
// file COPYING or https://www.opensource.org/licenses/mit-license.php .
|
||||||
|
|
||||||
|
syntax = "proto3";
|
||||||
|
package cash.z.wallet.sdk.rpc;
|
||||||
|
option go_package = "lightwalletd/walletrpc";
|
||||||
|
option swift_prefix = "";
|
||||||
|
import "compact_formats.proto";
|
||||||
|
|
||||||
|
// A BlockID message contains identifiers to select a block: a height or a
|
||||||
|
// hash. Specification by hash is not implemented, but may be in the future.
|
||||||
|
message BlockID {
|
||||||
|
uint64 height = 1;
|
||||||
|
bytes hash = 2;
|
||||||
|
}
|
||||||
|
|
||||||
|
// BlockRange specifies a series of blocks from start to end inclusive.
|
||||||
|
// Both BlockIDs must be heights; specification by hash is not yet supported.
|
||||||
|
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.
|
||||||
|
// Currently, only specification by hash is supported.
|
||||||
|
message TxFilter {
|
||||||
|
BlockID block = 1; // block identifier, height or hash
|
||||||
|
uint64 index = 2; // index within the block
|
||||||
|
bytes hash = 3; // transaction ID (hash, txid)
|
||||||
|
}
|
||||||
|
|
||||||
|
// RawTransaction contains the complete transaction data. It also optionally includes
|
||||||
|
// the block height in which the transaction was included, or, when returned
|
||||||
|
// by GetMempoolStream(), the latest block height.
|
||||||
|
message RawTransaction {
|
||||||
|
bytes data = 1; // exact data returned by Zcash 'getrawtransaction'
|
||||||
|
uint64 height = 2; // height that the transaction was mined (or -1)
|
||||||
|
}
|
||||||
|
|
||||||
|
// A SendResponse encodes an error code and a string. It is currently used
|
||||||
|
// only by SendTransaction(). If error code is zero, the operation was
|
||||||
|
// successful; if non-zero, it and the message specify the failure.
|
||||||
|
message SendResponse {
|
||||||
|
int32 errorCode = 1;
|
||||||
|
string errorMessage = 2;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Chainspec is a placeholder to allow specification of a particular chain fork.
|
||||||
|
message ChainSpec {}
|
||||||
|
|
||||||
|
// Empty is for gRPCs that take no arguments, currently only GetLightdInfo.
|
||||||
|
message Empty {}
|
||||||
|
|
||||||
|
// LightdInfo returns various information about this lightwalletd instance
|
||||||
|
// and the state of the blockchain.
|
||||||
|
message LightdInfo {
|
||||||
|
string version = 1;
|
||||||
|
string vendor = 2;
|
||||||
|
bool taddrSupport = 3; // true
|
||||||
|
string chainName = 4; // either "main" or "test"
|
||||||
|
uint64 saplingActivationHeight = 5; // depends on mainnet or testnet
|
||||||
|
string consensusBranchId = 6; // protocol identifier, see consensus/upgrades.cpp
|
||||||
|
uint64 blockHeight = 7; // latest block on the best chain
|
||||||
|
string gitCommit = 8;
|
||||||
|
string branch = 9;
|
||||||
|
string buildDate = 10;
|
||||||
|
string buildUser = 11;
|
||||||
|
uint64 estimatedHeight = 12; // less than tip height if zcashd is syncing
|
||||||
|
string zcashdBuild = 13; // example: "v4.1.1-877212414"
|
||||||
|
string zcashdSubversion = 14; // example: "/MagicBean:4.1.1/"
|
||||||
|
}
|
||||||
|
|
||||||
|
// TransparentAddressBlockFilter restricts the results to the given address
|
||||||
|
// or block range.
|
||||||
|
message TransparentAddressBlockFilter {
|
||||||
|
string address = 1; // t-address
|
||||||
|
BlockRange range = 2; // start, end heights
|
||||||
|
}
|
||||||
|
|
||||||
|
// Duration is currently used only for testing, so that the Ping rpc
|
||||||
|
// can simulate a delay, to create many simultaneous connections. Units
|
||||||
|
// are microseconds.
|
||||||
|
message Duration {
|
||||||
|
int64 intervalUs = 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
// PingResponse is used to indicate concurrency, how many Ping rpcs
|
||||||
|
// are executing upon entry and upon exit (after the delay).
|
||||||
|
// This rpc is used for testing only.
|
||||||
|
message PingResponse {
|
||||||
|
int64 entry = 1;
|
||||||
|
int64 exit = 2;
|
||||||
|
}
|
||||||
|
|
||||||
|
message Address {
|
||||||
|
string address = 1;
|
||||||
|
}
|
||||||
|
message AddressList {
|
||||||
|
repeated string addresses = 1;
|
||||||
|
}
|
||||||
|
message Balance {
|
||||||
|
int64 valueZat = 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
message Exclude {
|
||||||
|
repeated bytes txid = 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
// The TreeState is derived from the Zcash z_gettreestate rpc.
|
||||||
|
message TreeState {
|
||||||
|
string network = 1; // "main" or "test"
|
||||||
|
uint64 height = 2; // block height
|
||||||
|
string hash = 3; // block id
|
||||||
|
uint32 time = 4; // Unix epoch time when the block was mined
|
||||||
|
string saplingTree = 5; // sapling commitment tree state
|
||||||
|
string orchardTree = 6; // orchard commitment tree state
|
||||||
|
}
|
||||||
|
|
||||||
|
// Results are sorted by height, which makes it easy to issue another
|
||||||
|
// request that picks up from where the previous left off.
|
||||||
|
message GetAddressUtxosArg {
|
||||||
|
repeated string addresses = 1;
|
||||||
|
uint64 startHeight = 2;
|
||||||
|
uint32 maxEntries = 3; // zero means unlimited
|
||||||
|
}
|
||||||
|
message GetAddressUtxosReply {
|
||||||
|
string address = 6;
|
||||||
|
bytes txid = 1;
|
||||||
|
int32 index = 2;
|
||||||
|
bytes script = 3;
|
||||||
|
int64 valueZat = 4;
|
||||||
|
uint64 height = 5;
|
||||||
|
}
|
||||||
|
message GetAddressUtxosReplyList {
|
||||||
|
repeated GetAddressUtxosReply addressUtxos = 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
service CompactTxStreamer {
|
||||||
|
// Return the height of the tip of the best chain
|
||||||
|
rpc GetLatestBlock(ChainSpec) returns (BlockID) {}
|
||||||
|
// Return the compact block corresponding to the given block identifier
|
||||||
|
rpc GetBlock(BlockID) returns (CompactBlock) {}
|
||||||
|
// Return a list of consecutive compact blocks
|
||||||
|
rpc GetBlockRange(BlockRange) returns (stream CompactBlock) {}
|
||||||
|
|
||||||
|
// Return the requested full (not compact) transaction (as from zcashd)
|
||||||
|
rpc GetTransaction(TxFilter) returns (RawTransaction) {}
|
||||||
|
// Submit the given transaction to the Zcash network
|
||||||
|
rpc SendTransaction(RawTransaction) returns (SendResponse) {}
|
||||||
|
|
||||||
|
// Return the txids corresponding to the given t-address within the given block range
|
||||||
|
rpc GetTaddressTxids(TransparentAddressBlockFilter) returns (stream RawTransaction) {}
|
||||||
|
rpc GetTaddressBalance(AddressList) returns (Balance) {}
|
||||||
|
rpc GetTaddressBalanceStream(stream Address) returns (Balance) {}
|
||||||
|
|
||||||
|
// Return the compact transactions currently in the mempool; the results
|
||||||
|
// can be a few seconds out of date. If the Exclude list is empty, return
|
||||||
|
// all transactions; otherwise return all *except* those in the Exclude list
|
||||||
|
// (if any); this allows the client to avoid receiving transactions that it
|
||||||
|
// already has (from an earlier call to this rpc). The transaction IDs in the
|
||||||
|
// Exclude list can be shortened to any number of bytes to make the request
|
||||||
|
// more bandwidth-efficient; if two or more transactions in the mempool
|
||||||
|
// match a shortened txid, they are all sent (none is excluded). Transactions
|
||||||
|
// in the exclude list that don't exist in the mempool are ignored.
|
||||||
|
rpc GetMempoolTx(Exclude) returns (stream CompactTx) {}
|
||||||
|
|
||||||
|
// Return a stream of current Mempool transactions. This will keep the output stream open while
|
||||||
|
// there are mempool transactions. It will close the returned stream when a new block is mined.
|
||||||
|
rpc GetMempoolStream(Empty) returns (stream RawTransaction) {}
|
||||||
|
|
||||||
|
// GetTreeState returns the note commitment tree state corresponding to the given block.
|
||||||
|
// See section 3.7 of the Zcash protocol specification. It returns several other useful
|
||||||
|
// values also (even though they can be obtained using GetBlock).
|
||||||
|
// The block can be specified by either height or hash.
|
||||||
|
rpc GetTreeState(BlockID) returns (TreeState) {}
|
||||||
|
rpc GetLatestTreeState(Empty) returns (TreeState) {}
|
||||||
|
|
||||||
|
rpc GetAddressUtxos(GetAddressUtxosArg) returns (GetAddressUtxosReplyList) {}
|
||||||
|
rpc GetAddressUtxosStream(GetAddressUtxosArg) returns (stream GetAddressUtxosReply) {}
|
||||||
|
|
||||||
|
// Return information about this lightwalletd instance and the blockchain
|
||||||
|
rpc GetLightdInfo(Empty) returns (LightdInfo) {}
|
||||||
|
// Testing-only, requires lightwalletd --ping-very-insecure (do not enable in production)
|
||||||
|
rpc Ping(Duration) returns (PingResponse) {}
|
||||||
|
}
|
|
@ -14,6 +14,10 @@ use zcash_note_encryption::{EphemeralKeyBytes, COMPACT_NOTE_SIZE};
|
||||||
#[rustfmt::skip]
|
#[rustfmt::skip]
|
||||||
pub mod compact_formats;
|
pub mod compact_formats;
|
||||||
|
|
||||||
|
#[cfg(feature = "lightwalletd-tonic")]
|
||||||
|
#[rustfmt::skip]
|
||||||
|
pub mod service;
|
||||||
|
|
||||||
impl compact_formats::CompactBlock {
|
impl compact_formats::CompactBlock {
|
||||||
/// Returns the [`BlockHash`] for this block.
|
/// Returns the [`BlockHash`] for this block.
|
||||||
///
|
///
|
||||||
|
|
|
@ -0,0 +1,629 @@
|
||||||
|
/// A BlockID message contains identifiers to select a block: a height or a
|
||||||
|
/// hash. Specification by hash is not implemented, but may be in the future.
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct BlockId {
|
||||||
|
#[prost(uint64, tag="1")]
|
||||||
|
pub height: u64,
|
||||||
|
#[prost(bytes="vec", tag="2")]
|
||||||
|
pub hash: ::prost::alloc::vec::Vec<u8>,
|
||||||
|
}
|
||||||
|
/// BlockRange specifies a series of blocks from start to end inclusive.
|
||||||
|
/// Both BlockIDs must be heights; specification by hash is not yet supported.
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct BlockRange {
|
||||||
|
#[prost(message, optional, tag="1")]
|
||||||
|
pub start: ::core::option::Option<BlockId>,
|
||||||
|
#[prost(message, optional, tag="2")]
|
||||||
|
pub end: ::core::option::Option<BlockId>,
|
||||||
|
}
|
||||||
|
/// A TxFilter contains the information needed to identify a particular
|
||||||
|
/// transaction: either a block and an index, or a direct transaction hash.
|
||||||
|
/// Currently, only specification by hash is supported.
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct TxFilter {
|
||||||
|
/// block identifier, height or hash
|
||||||
|
#[prost(message, optional, tag="1")]
|
||||||
|
pub block: ::core::option::Option<BlockId>,
|
||||||
|
/// index within the block
|
||||||
|
#[prost(uint64, tag="2")]
|
||||||
|
pub index: u64,
|
||||||
|
/// transaction ID (hash, txid)
|
||||||
|
#[prost(bytes="vec", tag="3")]
|
||||||
|
pub hash: ::prost::alloc::vec::Vec<u8>,
|
||||||
|
}
|
||||||
|
/// RawTransaction contains the complete transaction data. It also optionally includes
|
||||||
|
/// the block height in which the transaction was included, or, when returned
|
||||||
|
/// by GetMempoolStream(), the latest block height.
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct RawTransaction {
|
||||||
|
/// exact data returned by Zcash 'getrawtransaction'
|
||||||
|
#[prost(bytes="vec", tag="1")]
|
||||||
|
pub data: ::prost::alloc::vec::Vec<u8>,
|
||||||
|
/// height that the transaction was mined (or -1)
|
||||||
|
#[prost(uint64, tag="2")]
|
||||||
|
pub height: u64,
|
||||||
|
}
|
||||||
|
/// A SendResponse encodes an error code and a string. It is currently used
|
||||||
|
/// only by SendTransaction(). If error code is zero, the operation was
|
||||||
|
/// successful; if non-zero, it and the message specify the failure.
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct SendResponse {
|
||||||
|
#[prost(int32, tag="1")]
|
||||||
|
pub error_code: i32,
|
||||||
|
#[prost(string, tag="2")]
|
||||||
|
pub error_message: ::prost::alloc::string::String,
|
||||||
|
}
|
||||||
|
/// Chainspec is a placeholder to allow specification of a particular chain fork.
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct ChainSpec {
|
||||||
|
}
|
||||||
|
/// Empty is for gRPCs that take no arguments, currently only GetLightdInfo.
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct Empty {
|
||||||
|
}
|
||||||
|
/// LightdInfo returns various information about this lightwalletd instance
|
||||||
|
/// and the state of the blockchain.
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct LightdInfo {
|
||||||
|
#[prost(string, tag="1")]
|
||||||
|
pub version: ::prost::alloc::string::String,
|
||||||
|
#[prost(string, tag="2")]
|
||||||
|
pub vendor: ::prost::alloc::string::String,
|
||||||
|
/// true
|
||||||
|
#[prost(bool, tag="3")]
|
||||||
|
pub taddr_support: bool,
|
||||||
|
/// either "main" or "test"
|
||||||
|
#[prost(string, tag="4")]
|
||||||
|
pub chain_name: ::prost::alloc::string::String,
|
||||||
|
/// depends on mainnet or testnet
|
||||||
|
#[prost(uint64, tag="5")]
|
||||||
|
pub sapling_activation_height: u64,
|
||||||
|
/// protocol identifier, see consensus/upgrades.cpp
|
||||||
|
#[prost(string, tag="6")]
|
||||||
|
pub consensus_branch_id: ::prost::alloc::string::String,
|
||||||
|
/// latest block on the best chain
|
||||||
|
#[prost(uint64, tag="7")]
|
||||||
|
pub block_height: u64,
|
||||||
|
#[prost(string, tag="8")]
|
||||||
|
pub git_commit: ::prost::alloc::string::String,
|
||||||
|
#[prost(string, tag="9")]
|
||||||
|
pub branch: ::prost::alloc::string::String,
|
||||||
|
#[prost(string, tag="10")]
|
||||||
|
pub build_date: ::prost::alloc::string::String,
|
||||||
|
#[prost(string, tag="11")]
|
||||||
|
pub build_user: ::prost::alloc::string::String,
|
||||||
|
/// less than tip height if zcashd is syncing
|
||||||
|
#[prost(uint64, tag="12")]
|
||||||
|
pub estimated_height: u64,
|
||||||
|
/// example: "v4.1.1-877212414"
|
||||||
|
#[prost(string, tag="13")]
|
||||||
|
pub zcashd_build: ::prost::alloc::string::String,
|
||||||
|
/// example: "/MagicBean:4.1.1/"
|
||||||
|
#[prost(string, tag="14")]
|
||||||
|
pub zcashd_subversion: ::prost::alloc::string::String,
|
||||||
|
}
|
||||||
|
/// TransparentAddressBlockFilter restricts the results to the given address
|
||||||
|
/// or block range.
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct TransparentAddressBlockFilter {
|
||||||
|
/// t-address
|
||||||
|
#[prost(string, tag="1")]
|
||||||
|
pub address: ::prost::alloc::string::String,
|
||||||
|
/// start, end heights
|
||||||
|
#[prost(message, optional, tag="2")]
|
||||||
|
pub range: ::core::option::Option<BlockRange>,
|
||||||
|
}
|
||||||
|
/// Duration is currently used only for testing, so that the Ping rpc
|
||||||
|
/// can simulate a delay, to create many simultaneous connections. Units
|
||||||
|
/// are microseconds.
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct Duration {
|
||||||
|
#[prost(int64, tag="1")]
|
||||||
|
pub interval_us: i64,
|
||||||
|
}
|
||||||
|
/// PingResponse is used to indicate concurrency, how many Ping rpcs
|
||||||
|
/// are executing upon entry and upon exit (after the delay).
|
||||||
|
/// This rpc is used for testing only.
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct PingResponse {
|
||||||
|
#[prost(int64, tag="1")]
|
||||||
|
pub entry: i64,
|
||||||
|
#[prost(int64, tag="2")]
|
||||||
|
pub exit: i64,
|
||||||
|
}
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct Address {
|
||||||
|
#[prost(string, tag="1")]
|
||||||
|
pub address: ::prost::alloc::string::String,
|
||||||
|
}
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct AddressList {
|
||||||
|
#[prost(string, repeated, tag="1")]
|
||||||
|
pub addresses: ::prost::alloc::vec::Vec<::prost::alloc::string::String>,
|
||||||
|
}
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct Balance {
|
||||||
|
#[prost(int64, tag="1")]
|
||||||
|
pub value_zat: i64,
|
||||||
|
}
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct Exclude {
|
||||||
|
#[prost(bytes="vec", repeated, tag="1")]
|
||||||
|
pub txid: ::prost::alloc::vec::Vec<::prost::alloc::vec::Vec<u8>>,
|
||||||
|
}
|
||||||
|
/// The TreeState is derived from the Zcash z_gettreestate rpc.
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct TreeState {
|
||||||
|
/// "main" or "test"
|
||||||
|
#[prost(string, tag="1")]
|
||||||
|
pub network: ::prost::alloc::string::String,
|
||||||
|
/// block height
|
||||||
|
#[prost(uint64, tag="2")]
|
||||||
|
pub height: u64,
|
||||||
|
/// block id
|
||||||
|
#[prost(string, tag="3")]
|
||||||
|
pub hash: ::prost::alloc::string::String,
|
||||||
|
/// Unix epoch time when the block was mined
|
||||||
|
#[prost(uint32, tag="4")]
|
||||||
|
pub time: u32,
|
||||||
|
/// sapling commitment tree state
|
||||||
|
#[prost(string, tag="5")]
|
||||||
|
pub sapling_tree: ::prost::alloc::string::String,
|
||||||
|
/// orchard commitment tree state
|
||||||
|
#[prost(string, tag="6")]
|
||||||
|
pub orchard_tree: ::prost::alloc::string::String,
|
||||||
|
}
|
||||||
|
/// Results are sorted by height, which makes it easy to issue another
|
||||||
|
/// request that picks up from where the previous left off.
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct GetAddressUtxosArg {
|
||||||
|
#[prost(string, repeated, tag="1")]
|
||||||
|
pub addresses: ::prost::alloc::vec::Vec<::prost::alloc::string::String>,
|
||||||
|
#[prost(uint64, tag="2")]
|
||||||
|
pub start_height: u64,
|
||||||
|
/// zero means unlimited
|
||||||
|
#[prost(uint32, tag="3")]
|
||||||
|
pub max_entries: u32,
|
||||||
|
}
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct GetAddressUtxosReply {
|
||||||
|
#[prost(string, tag="6")]
|
||||||
|
pub address: ::prost::alloc::string::String,
|
||||||
|
#[prost(bytes="vec", tag="1")]
|
||||||
|
pub txid: ::prost::alloc::vec::Vec<u8>,
|
||||||
|
#[prost(int32, tag="2")]
|
||||||
|
pub index: i32,
|
||||||
|
#[prost(bytes="vec", tag="3")]
|
||||||
|
pub script: ::prost::alloc::vec::Vec<u8>,
|
||||||
|
#[prost(int64, tag="4")]
|
||||||
|
pub value_zat: i64,
|
||||||
|
#[prost(uint64, tag="5")]
|
||||||
|
pub height: u64,
|
||||||
|
}
|
||||||
|
#[derive(Clone, PartialEq, ::prost::Message)]
|
||||||
|
pub struct GetAddressUtxosReplyList {
|
||||||
|
#[prost(message, repeated, tag="1")]
|
||||||
|
pub address_utxos: ::prost::alloc::vec::Vec<GetAddressUtxosReply>,
|
||||||
|
}
|
||||||
|
/// Generated client implementations.
|
||||||
|
pub mod compact_tx_streamer_client {
|
||||||
|
#![allow(unused_variables, dead_code, missing_docs, clippy::let_unit_value)]
|
||||||
|
use tonic::codegen::*;
|
||||||
|
use tonic::codegen::http::Uri;
|
||||||
|
#[derive(Debug, Clone)]
|
||||||
|
pub struct CompactTxStreamerClient<T> {
|
||||||
|
inner: tonic::client::Grpc<T>,
|
||||||
|
}
|
||||||
|
impl CompactTxStreamerClient<tonic::transport::Channel> {
|
||||||
|
/// Attempt to create a new client by connecting to a given endpoint.
|
||||||
|
pub async fn connect<D>(dst: D) -> Result<Self, tonic::transport::Error>
|
||||||
|
where
|
||||||
|
D: std::convert::TryInto<tonic::transport::Endpoint>,
|
||||||
|
D::Error: Into<StdError>,
|
||||||
|
{
|
||||||
|
let conn = tonic::transport::Endpoint::new(dst)?.connect().await?;
|
||||||
|
Ok(Self::new(conn))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
impl<T> CompactTxStreamerClient<T>
|
||||||
|
where
|
||||||
|
T: tonic::client::GrpcService<tonic::body::BoxBody>,
|
||||||
|
T::Error: Into<StdError>,
|
||||||
|
T::ResponseBody: Body<Data = Bytes> + Send + 'static,
|
||||||
|
<T::ResponseBody as Body>::Error: Into<StdError> + Send,
|
||||||
|
{
|
||||||
|
pub fn new(inner: T) -> Self {
|
||||||
|
let inner = tonic::client::Grpc::new(inner);
|
||||||
|
Self { inner }
|
||||||
|
}
|
||||||
|
pub fn with_origin(inner: T, origin: Uri) -> Self {
|
||||||
|
let inner = tonic::client::Grpc::with_origin(inner, origin);
|
||||||
|
Self { inner }
|
||||||
|
}
|
||||||
|
pub fn with_interceptor<F>(
|
||||||
|
inner: T,
|
||||||
|
interceptor: F,
|
||||||
|
) -> CompactTxStreamerClient<InterceptedService<T, F>>
|
||||||
|
where
|
||||||
|
F: tonic::service::Interceptor,
|
||||||
|
T::ResponseBody: Default,
|
||||||
|
T: tonic::codegen::Service<
|
||||||
|
http::Request<tonic::body::BoxBody>,
|
||||||
|
Response = http::Response<
|
||||||
|
<T as tonic::client::GrpcService<tonic::body::BoxBody>>::ResponseBody,
|
||||||
|
>,
|
||||||
|
>,
|
||||||
|
<T as tonic::codegen::Service<
|
||||||
|
http::Request<tonic::body::BoxBody>,
|
||||||
|
>>::Error: Into<StdError> + Send + Sync,
|
||||||
|
{
|
||||||
|
CompactTxStreamerClient::new(InterceptedService::new(inner, interceptor))
|
||||||
|
}
|
||||||
|
/// Compress requests with the given encoding.
|
||||||
|
///
|
||||||
|
/// This requires the server to support it otherwise it might respond with an
|
||||||
|
/// error.
|
||||||
|
#[must_use]
|
||||||
|
pub fn send_compressed(mut self, encoding: CompressionEncoding) -> Self {
|
||||||
|
self.inner = self.inner.send_compressed(encoding);
|
||||||
|
self
|
||||||
|
}
|
||||||
|
/// Enable decompressing responses.
|
||||||
|
#[must_use]
|
||||||
|
pub fn accept_compressed(mut self, encoding: CompressionEncoding) -> Self {
|
||||||
|
self.inner = self.inner.accept_compressed(encoding);
|
||||||
|
self
|
||||||
|
}
|
||||||
|
/// Return the height of the tip of the best chain
|
||||||
|
pub async fn get_latest_block(
|
||||||
|
&mut self,
|
||||||
|
request: impl tonic::IntoRequest<super::ChainSpec>,
|
||||||
|
) -> Result<tonic::Response<super::BlockId>, tonic::Status> {
|
||||||
|
self.inner
|
||||||
|
.ready()
|
||||||
|
.await
|
||||||
|
.map_err(|e| {
|
||||||
|
tonic::Status::new(
|
||||||
|
tonic::Code::Unknown,
|
||||||
|
format!("Service was not ready: {}", e.into()),
|
||||||
|
)
|
||||||
|
})?;
|
||||||
|
let codec = tonic::codec::ProstCodec::default();
|
||||||
|
let path = http::uri::PathAndQuery::from_static(
|
||||||
|
"/cash.z.wallet.sdk.rpc.CompactTxStreamer/GetLatestBlock",
|
||||||
|
);
|
||||||
|
self.inner.unary(request.into_request(), path, codec).await
|
||||||
|
}
|
||||||
|
/// Return the compact block corresponding to the given block identifier
|
||||||
|
pub async fn get_block(
|
||||||
|
&mut self,
|
||||||
|
request: impl tonic::IntoRequest<super::BlockId>,
|
||||||
|
) -> Result<
|
||||||
|
tonic::Response<crate::proto::compact_formats::CompactBlock>,
|
||||||
|
tonic::Status,
|
||||||
|
> {
|
||||||
|
self.inner
|
||||||
|
.ready()
|
||||||
|
.await
|
||||||
|
.map_err(|e| {
|
||||||
|
tonic::Status::new(
|
||||||
|
tonic::Code::Unknown,
|
||||||
|
format!("Service was not ready: {}", e.into()),
|
||||||
|
)
|
||||||
|
})?;
|
||||||
|
let codec = tonic::codec::ProstCodec::default();
|
||||||
|
let path = http::uri::PathAndQuery::from_static(
|
||||||
|
"/cash.z.wallet.sdk.rpc.CompactTxStreamer/GetBlock",
|
||||||
|
);
|
||||||
|
self.inner.unary(request.into_request(), path, codec).await
|
||||||
|
}
|
||||||
|
/// Return a list of consecutive compact blocks
|
||||||
|
pub async fn get_block_range(
|
||||||
|
&mut self,
|
||||||
|
request: impl tonic::IntoRequest<super::BlockRange>,
|
||||||
|
) -> Result<
|
||||||
|
tonic::Response<
|
||||||
|
tonic::codec::Streaming<crate::proto::compact_formats::CompactBlock>,
|
||||||
|
>,
|
||||||
|
tonic::Status,
|
||||||
|
> {
|
||||||
|
self.inner
|
||||||
|
.ready()
|
||||||
|
.await
|
||||||
|
.map_err(|e| {
|
||||||
|
tonic::Status::new(
|
||||||
|
tonic::Code::Unknown,
|
||||||
|
format!("Service was not ready: {}", e.into()),
|
||||||
|
)
|
||||||
|
})?;
|
||||||
|
let codec = tonic::codec::ProstCodec::default();
|
||||||
|
let path = http::uri::PathAndQuery::from_static(
|
||||||
|
"/cash.z.wallet.sdk.rpc.CompactTxStreamer/GetBlockRange",
|
||||||
|
);
|
||||||
|
self.inner.server_streaming(request.into_request(), path, codec).await
|
||||||
|
}
|
||||||
|
/// Return the requested full (not compact) transaction (as from zcashd)
|
||||||
|
pub async fn get_transaction(
|
||||||
|
&mut self,
|
||||||
|
request: impl tonic::IntoRequest<super::TxFilter>,
|
||||||
|
) -> Result<tonic::Response<super::RawTransaction>, tonic::Status> {
|
||||||
|
self.inner
|
||||||
|
.ready()
|
||||||
|
.await
|
||||||
|
.map_err(|e| {
|
||||||
|
tonic::Status::new(
|
||||||
|
tonic::Code::Unknown,
|
||||||
|
format!("Service was not ready: {}", e.into()),
|
||||||
|
)
|
||||||
|
})?;
|
||||||
|
let codec = tonic::codec::ProstCodec::default();
|
||||||
|
let path = http::uri::PathAndQuery::from_static(
|
||||||
|
"/cash.z.wallet.sdk.rpc.CompactTxStreamer/GetTransaction",
|
||||||
|
);
|
||||||
|
self.inner.unary(request.into_request(), path, codec).await
|
||||||
|
}
|
||||||
|
/// Submit the given transaction to the Zcash network
|
||||||
|
pub async fn send_transaction(
|
||||||
|
&mut self,
|
||||||
|
request: impl tonic::IntoRequest<super::RawTransaction>,
|
||||||
|
) -> Result<tonic::Response<super::SendResponse>, tonic::Status> {
|
||||||
|
self.inner
|
||||||
|
.ready()
|
||||||
|
.await
|
||||||
|
.map_err(|e| {
|
||||||
|
tonic::Status::new(
|
||||||
|
tonic::Code::Unknown,
|
||||||
|
format!("Service was not ready: {}", e.into()),
|
||||||
|
)
|
||||||
|
})?;
|
||||||
|
let codec = tonic::codec::ProstCodec::default();
|
||||||
|
let path = http::uri::PathAndQuery::from_static(
|
||||||
|
"/cash.z.wallet.sdk.rpc.CompactTxStreamer/SendTransaction",
|
||||||
|
);
|
||||||
|
self.inner.unary(request.into_request(), path, codec).await
|
||||||
|
}
|
||||||
|
/// Return the txids corresponding to the given t-address within the given block range
|
||||||
|
pub async fn get_taddress_txids(
|
||||||
|
&mut self,
|
||||||
|
request: impl tonic::IntoRequest<super::TransparentAddressBlockFilter>,
|
||||||
|
) -> Result<
|
||||||
|
tonic::Response<tonic::codec::Streaming<super::RawTransaction>>,
|
||||||
|
tonic::Status,
|
||||||
|
> {
|
||||||
|
self.inner
|
||||||
|
.ready()
|
||||||
|
.await
|
||||||
|
.map_err(|e| {
|
||||||
|
tonic::Status::new(
|
||||||
|
tonic::Code::Unknown,
|
||||||
|
format!("Service was not ready: {}", e.into()),
|
||||||
|
)
|
||||||
|
})?;
|
||||||
|
let codec = tonic::codec::ProstCodec::default();
|
||||||
|
let path = http::uri::PathAndQuery::from_static(
|
||||||
|
"/cash.z.wallet.sdk.rpc.CompactTxStreamer/GetTaddressTxids",
|
||||||
|
);
|
||||||
|
self.inner.server_streaming(request.into_request(), path, codec).await
|
||||||
|
}
|
||||||
|
pub async fn get_taddress_balance(
|
||||||
|
&mut self,
|
||||||
|
request: impl tonic::IntoRequest<super::AddressList>,
|
||||||
|
) -> Result<tonic::Response<super::Balance>, tonic::Status> {
|
||||||
|
self.inner
|
||||||
|
.ready()
|
||||||
|
.await
|
||||||
|
.map_err(|e| {
|
||||||
|
tonic::Status::new(
|
||||||
|
tonic::Code::Unknown,
|
||||||
|
format!("Service was not ready: {}", e.into()),
|
||||||
|
)
|
||||||
|
})?;
|
||||||
|
let codec = tonic::codec::ProstCodec::default();
|
||||||
|
let path = http::uri::PathAndQuery::from_static(
|
||||||
|
"/cash.z.wallet.sdk.rpc.CompactTxStreamer/GetTaddressBalance",
|
||||||
|
);
|
||||||
|
self.inner.unary(request.into_request(), path, codec).await
|
||||||
|
}
|
||||||
|
pub async fn get_taddress_balance_stream(
|
||||||
|
&mut self,
|
||||||
|
request: impl tonic::IntoStreamingRequest<Message = super::Address>,
|
||||||
|
) -> Result<tonic::Response<super::Balance>, tonic::Status> {
|
||||||
|
self.inner
|
||||||
|
.ready()
|
||||||
|
.await
|
||||||
|
.map_err(|e| {
|
||||||
|
tonic::Status::new(
|
||||||
|
tonic::Code::Unknown,
|
||||||
|
format!("Service was not ready: {}", e.into()),
|
||||||
|
)
|
||||||
|
})?;
|
||||||
|
let codec = tonic::codec::ProstCodec::default();
|
||||||
|
let path = http::uri::PathAndQuery::from_static(
|
||||||
|
"/cash.z.wallet.sdk.rpc.CompactTxStreamer/GetTaddressBalanceStream",
|
||||||
|
);
|
||||||
|
self.inner
|
||||||
|
.client_streaming(request.into_streaming_request(), path, codec)
|
||||||
|
.await
|
||||||
|
}
|
||||||
|
/// Return the compact transactions currently in the mempool; the results
|
||||||
|
/// can be a few seconds out of date. If the Exclude list is empty, return
|
||||||
|
/// all transactions; otherwise return all *except* those in the Exclude list
|
||||||
|
/// (if any); this allows the client to avoid receiving transactions that it
|
||||||
|
/// already has (from an earlier call to this rpc). The transaction IDs in the
|
||||||
|
/// Exclude list can be shortened to any number of bytes to make the request
|
||||||
|
/// more bandwidth-efficient; if two or more transactions in the mempool
|
||||||
|
/// match a shortened txid, they are all sent (none is excluded). Transactions
|
||||||
|
/// in the exclude list that don't exist in the mempool are ignored.
|
||||||
|
pub async fn get_mempool_tx(
|
||||||
|
&mut self,
|
||||||
|
request: impl tonic::IntoRequest<super::Exclude>,
|
||||||
|
) -> Result<
|
||||||
|
tonic::Response<
|
||||||
|
tonic::codec::Streaming<crate::proto::compact_formats::CompactTx>,
|
||||||
|
>,
|
||||||
|
tonic::Status,
|
||||||
|
> {
|
||||||
|
self.inner
|
||||||
|
.ready()
|
||||||
|
.await
|
||||||
|
.map_err(|e| {
|
||||||
|
tonic::Status::new(
|
||||||
|
tonic::Code::Unknown,
|
||||||
|
format!("Service was not ready: {}", e.into()),
|
||||||
|
)
|
||||||
|
})?;
|
||||||
|
let codec = tonic::codec::ProstCodec::default();
|
||||||
|
let path = http::uri::PathAndQuery::from_static(
|
||||||
|
"/cash.z.wallet.sdk.rpc.CompactTxStreamer/GetMempoolTx",
|
||||||
|
);
|
||||||
|
self.inner.server_streaming(request.into_request(), path, codec).await
|
||||||
|
}
|
||||||
|
/// Return a stream of current Mempool transactions. This will keep the output stream open while
|
||||||
|
/// there are mempool transactions. It will close the returned stream when a new block is mined.
|
||||||
|
pub async fn get_mempool_stream(
|
||||||
|
&mut self,
|
||||||
|
request: impl tonic::IntoRequest<super::Empty>,
|
||||||
|
) -> Result<
|
||||||
|
tonic::Response<tonic::codec::Streaming<super::RawTransaction>>,
|
||||||
|
tonic::Status,
|
||||||
|
> {
|
||||||
|
self.inner
|
||||||
|
.ready()
|
||||||
|
.await
|
||||||
|
.map_err(|e| {
|
||||||
|
tonic::Status::new(
|
||||||
|
tonic::Code::Unknown,
|
||||||
|
format!("Service was not ready: {}", e.into()),
|
||||||
|
)
|
||||||
|
})?;
|
||||||
|
let codec = tonic::codec::ProstCodec::default();
|
||||||
|
let path = http::uri::PathAndQuery::from_static(
|
||||||
|
"/cash.z.wallet.sdk.rpc.CompactTxStreamer/GetMempoolStream",
|
||||||
|
);
|
||||||
|
self.inner.server_streaming(request.into_request(), path, codec).await
|
||||||
|
}
|
||||||
|
/// GetTreeState returns the note commitment tree state corresponding to the given block.
|
||||||
|
/// See section 3.7 of the Zcash protocol specification. It returns several other useful
|
||||||
|
/// values also (even though they can be obtained using GetBlock).
|
||||||
|
/// The block can be specified by either height or hash.
|
||||||
|
pub async fn get_tree_state(
|
||||||
|
&mut self,
|
||||||
|
request: impl tonic::IntoRequest<super::BlockId>,
|
||||||
|
) -> Result<tonic::Response<super::TreeState>, tonic::Status> {
|
||||||
|
self.inner
|
||||||
|
.ready()
|
||||||
|
.await
|
||||||
|
.map_err(|e| {
|
||||||
|
tonic::Status::new(
|
||||||
|
tonic::Code::Unknown,
|
||||||
|
format!("Service was not ready: {}", e.into()),
|
||||||
|
)
|
||||||
|
})?;
|
||||||
|
let codec = tonic::codec::ProstCodec::default();
|
||||||
|
let path = http::uri::PathAndQuery::from_static(
|
||||||
|
"/cash.z.wallet.sdk.rpc.CompactTxStreamer/GetTreeState",
|
||||||
|
);
|
||||||
|
self.inner.unary(request.into_request(), path, codec).await
|
||||||
|
}
|
||||||
|
pub async fn get_latest_tree_state(
|
||||||
|
&mut self,
|
||||||
|
request: impl tonic::IntoRequest<super::Empty>,
|
||||||
|
) -> Result<tonic::Response<super::TreeState>, tonic::Status> {
|
||||||
|
self.inner
|
||||||
|
.ready()
|
||||||
|
.await
|
||||||
|
.map_err(|e| {
|
||||||
|
tonic::Status::new(
|
||||||
|
tonic::Code::Unknown,
|
||||||
|
format!("Service was not ready: {}", e.into()),
|
||||||
|
)
|
||||||
|
})?;
|
||||||
|
let codec = tonic::codec::ProstCodec::default();
|
||||||
|
let path = http::uri::PathAndQuery::from_static(
|
||||||
|
"/cash.z.wallet.sdk.rpc.CompactTxStreamer/GetLatestTreeState",
|
||||||
|
);
|
||||||
|
self.inner.unary(request.into_request(), path, codec).await
|
||||||
|
}
|
||||||
|
pub async fn get_address_utxos(
|
||||||
|
&mut self,
|
||||||
|
request: impl tonic::IntoRequest<super::GetAddressUtxosArg>,
|
||||||
|
) -> Result<tonic::Response<super::GetAddressUtxosReplyList>, tonic::Status> {
|
||||||
|
self.inner
|
||||||
|
.ready()
|
||||||
|
.await
|
||||||
|
.map_err(|e| {
|
||||||
|
tonic::Status::new(
|
||||||
|
tonic::Code::Unknown,
|
||||||
|
format!("Service was not ready: {}", e.into()),
|
||||||
|
)
|
||||||
|
})?;
|
||||||
|
let codec = tonic::codec::ProstCodec::default();
|
||||||
|
let path = http::uri::PathAndQuery::from_static(
|
||||||
|
"/cash.z.wallet.sdk.rpc.CompactTxStreamer/GetAddressUtxos",
|
||||||
|
);
|
||||||
|
self.inner.unary(request.into_request(), path, codec).await
|
||||||
|
}
|
||||||
|
pub async fn get_address_utxos_stream(
|
||||||
|
&mut self,
|
||||||
|
request: impl tonic::IntoRequest<super::GetAddressUtxosArg>,
|
||||||
|
) -> Result<
|
||||||
|
tonic::Response<tonic::codec::Streaming<super::GetAddressUtxosReply>>,
|
||||||
|
tonic::Status,
|
||||||
|
> {
|
||||||
|
self.inner
|
||||||
|
.ready()
|
||||||
|
.await
|
||||||
|
.map_err(|e| {
|
||||||
|
tonic::Status::new(
|
||||||
|
tonic::Code::Unknown,
|
||||||
|
format!("Service was not ready: {}", e.into()),
|
||||||
|
)
|
||||||
|
})?;
|
||||||
|
let codec = tonic::codec::ProstCodec::default();
|
||||||
|
let path = http::uri::PathAndQuery::from_static(
|
||||||
|
"/cash.z.wallet.sdk.rpc.CompactTxStreamer/GetAddressUtxosStream",
|
||||||
|
);
|
||||||
|
self.inner.server_streaming(request.into_request(), path, codec).await
|
||||||
|
}
|
||||||
|
/// Return information about this lightwalletd instance and the blockchain
|
||||||
|
pub async fn get_lightd_info(
|
||||||
|
&mut self,
|
||||||
|
request: impl tonic::IntoRequest<super::Empty>,
|
||||||
|
) -> Result<tonic::Response<super::LightdInfo>, tonic::Status> {
|
||||||
|
self.inner
|
||||||
|
.ready()
|
||||||
|
.await
|
||||||
|
.map_err(|e| {
|
||||||
|
tonic::Status::new(
|
||||||
|
tonic::Code::Unknown,
|
||||||
|
format!("Service was not ready: {}", e.into()),
|
||||||
|
)
|
||||||
|
})?;
|
||||||
|
let codec = tonic::codec::ProstCodec::default();
|
||||||
|
let path = http::uri::PathAndQuery::from_static(
|
||||||
|
"/cash.z.wallet.sdk.rpc.CompactTxStreamer/GetLightdInfo",
|
||||||
|
);
|
||||||
|
self.inner.unary(request.into_request(), path, codec).await
|
||||||
|
}
|
||||||
|
/// Testing-only, requires lightwalletd --ping-very-insecure (do not enable in production)
|
||||||
|
pub async fn ping(
|
||||||
|
&mut self,
|
||||||
|
request: impl tonic::IntoRequest<super::Duration>,
|
||||||
|
) -> Result<tonic::Response<super::PingResponse>, tonic::Status> {
|
||||||
|
self.inner
|
||||||
|
.ready()
|
||||||
|
.await
|
||||||
|
.map_err(|e| {
|
||||||
|
tonic::Status::new(
|
||||||
|
tonic::Code::Unknown,
|
||||||
|
format!("Service was not ready: {}", e.into()),
|
||||||
|
)
|
||||||
|
})?;
|
||||||
|
let codec = tonic::codec::ProstCodec::default();
|
||||||
|
let path = http::uri::PathAndQuery::from_static(
|
||||||
|
"/cash.z.wallet.sdk.rpc.CompactTxStreamer/Ping",
|
||||||
|
);
|
||||||
|
self.inner.unary(request.into_request(), path, codec).await
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
Loading…
Reference in New Issue