Crate grin_wallet_libwallet
source · [−]Expand description
Higher level wallet functions which can be used by callers to operate on the wallet, as well as helpers to invoke and instantiate wallets and listeners
Re-exports
pub use crate::slate_versions::v4::sig_is_blank;
pub use crate::slate_versions::SlateVersion;
pub use crate::slate_versions::VersionedBinSlate;
pub use crate::slate_versions::VersionedCoinbase;
pub use crate::slate_versions::VersionedSlate;
pub use crate::slate_versions::CURRENT_SLATE_VERSION;
pub use crate::slate_versions::GRIN_BLOCK_HEADER_VERSION;
pub use api_impl::owner_updater::StatusMessage;
pub use api_impl::types::Amount;
pub use api_impl::types::BlockFees;
pub use api_impl::types::BuiltOutput;
pub use api_impl::types::InitTxArgs;
pub use api_impl::types::InitTxSendArgs;
pub use api_impl::types::IssueInvoiceTxArgs;
pub use api_impl::types::NodeHeightResult;
pub use api_impl::types::OutputCommitMapping;
pub use api_impl::types::PaymentProof;
pub use api_impl::types::VersionInfo;
pub use slate_versions::ser as dalek_ser;
Modules
Functions defining wallet ‘addresses’, i.e. ed2559 keys based on a derivation path
lower-level wallet functions which build upon core::libtx to perform wallet operations
This module contains old slate versions and conversions to the newest slate version Used for serialization and deserialization of slates in a backwards compatible way. Versions earlier than V3 are removed for the 4.0.0 release, but versioning code remains for future needs
Functions and types for handling Slatepack transactions
Macros
Helper for taking a lock on the wallet instance
Structs
Map of named accounts to BIP32 paths
Block Identifier
Wrapper for reward output and kernel used when building a coinbase for a mining node. Note: Not serializable, must be converted to necesssary “versioned” representation before serializing to json to ensure compatibility with mining node.
Holds the context for a single aggsig transaction
Error definition
Node version info
Information about an output that’s being tracked by the wallet. Must be enough to reconstruct the commitment associated with the ouput when the root private key is known.
Public data for each participant in the slate
Store details of the last scanned block
A ‘Slate’ is passed around to all parties to build up all of the public transaction data needed to create a finalized transaction. Callers can pass the slate around by whatever means they choose, (but we can provide some binary or JSON serialization helpers here).
Basic Slatepack definition
Definition of a Slatepack address
Wrapper for associated functions
Wrapper for outputting slate as binary
Helper struct to pack and unpack slatepacks
Arguments, mostly for encrypting decrypting a slatepack
Payment proof information. Differs from what is sent via the slate
Optional transaction information, recorded when an event happens to add or remove funds from a wallet. One Transaction log entry maps to one or many outputs
Dummy wrapper for the hex-encoded serialized transaction.
Utility struct for return values from below
a contained wallet info struct, so automated tests can parse wallet info can add more fields here over time as needed
Enums
Wallet errors, mostly wrappers around underlying crypto or I/O errors.
Status of an output that’s being tracked by the wallet. Can either be unconfirmed, spent, unspent, or locked (when it’s been used to generate a transaction but we don’t have confirmation that the transaction was broadcasted or mined).
Slate state definition
Types of transactions that can be contained within a TXLog entry
Enum to determine what amount of scanning is required for a new wallet
Traits
Encapsulate all wallet-node communication functions. No functions within libwallet should care about communication details
TODO: Wallets should implement this backend for their storage. All functions here expect that the wallet instance has instantiated itself or stored whatever credentials it needs
Combined trait to allow dynamic wallet dispatch
Trait for a provider of wallet lifecycle methods
Batch trait to update the output data backend atomically. Trying to use a batch after commit MAY result in a panic. Due to this being a trait, the commit method can’t take ownership. TODO: Should these be split into separate batch objects, for outputs, tx_log entries and meta/details?
Functions
Check / repair wallet contents by scanning against chain assume wallet contents have been freshly updated with contents of latest block