Skip to main content

Module lightwalletd

Module lightwalletd 

Source
Expand description

A tonic gRPC server that implements the lightwalletd CompactTxStreamer client API.

The interface is defined by the zcash/lightwalletd proto files, so Zcash light clients that normally connect to a lightwalletd instance can connect directly to Zebra instead.

Modulesยง

compact_tx_streamer_client
Generated client implementations.
compact_tx_streamer_server
Generated server implementations.
methods
Implements CompactTxStreamer methods on the LightwalletdRPC type.
server
A tonic gRPC server for the lightwalletd CompactTxStreamer client API.
tracing
Request tracing for the lightwalletd gRPC server.
wire ๐Ÿ”’

Structsยง

Address
AddressList
Balance
BlockId
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.
BlockRange
BlockRange specifies a series of blocks from start to end inclusive. Both BlockIDs must be heights; specification by hash is not yet supported.
ChainMetadata
Information about the state of the chain as of a given block.
ChainSpec
Chainspec is a placeholder to allow specification of a particular chain fork.
CompactBlock
A compact representation of the shielded data in a Zcash block.
CompactOrchardAction
A compact representation of an Orchard Action.
CompactSaplingOutput
A compact representation of a Sapling Output.
CompactSaplingSpend
A compact representation of a Sapling Spend.
CompactTx
A compact representation of the shielded data in a Zcash transaction.
Duration
Duration is currently used only for testing, so that the Ping rpc can simulate a delay, to create many simultaneous connections. Units are microseconds.
Empty
Empty is for gRPCs that take no arguments, currently only GetLightdInfo.
Exclude
The a shortened transaction ID is the prefix in big-endian (hex) format (then converted to binary).
GetAddressUtxosArg
Results are sorted by height, which makes it easy to issue another request that picks up from where the previous left off.
GetAddressUtxosReply
GetAddressUtxosReplyList
GetSubtreeRootsArg
LightdInfo
LightdInfo returns various information about this lightwalletd instance and the state of the blockchain.
PingResponse
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.
RawTransaction
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.
SendResponse
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.
SubtreeRoot
TransparentAddressBlockFilter
TransparentAddressBlockFilter restricts the results to the given address or block range.
TreeState
The TreeState is derived from the Zcash z_gettreestate rpc.
TxFilter
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.

Enumsยง

ShieldedProtocol

Constantsยง

COMPACT_CIPHERTEXT_SIZE ๐Ÿ”’
The number of bytes of an encrypted note ciphertext included in compact outputs and actions, from the compact_formats.proto specification.
FILE_DESCRIPTOR_SET ๐Ÿ”’

Functionsยง

compact_action ๐Ÿ”’
Builds a CompactOrchardAction from an Orchard-encoded action.
has_compact_data ๐Ÿ”’
Returns true if the transaction contains any data that belongs in a CompactTx: Sapling spends or outputs, or Orchard or Ironwood actions.
has_nullifiers ๐Ÿ”’
Returns true if the transaction contains any nullifiers, so it belongs in a nullifiers-only CompactBlock.