Crate grin_util

source ·
Expand description

Logging, as well as various low-level utilities that factor Rust patterns that are frequent within the grin codebase.

Re-exports

pub extern crate secp256k1zkp as secp;
pub use logger::init_logger;
pub use logger::init_test_logger;
pub use secp_static::static_secp_instance;
pub use types::LogLevel;
pub use types::LoggingConfig;

Modules

File util
Logging wrapper to be used throughout all crates in the workspace
Macros to support Rust BIP-32 code (though could conceivably be used for other things)
Custom impls of read_exact and write_all to work around async stream restrictions.
Globally accessible static instance of secp256k1, to avoid initialization overhead
Logging configuration types
Compress and decompress zip bz2 archives

Macros

Structs

Encapsulation of a RwLock<Option> for one-time initialization. This implementation will purposefully fail hard if not used properly, for example if not initialized before being first used (borrowed).
A rate counter tracks the number of transfers, the amount of data exchanged and the rate of transfer (via a few timers) over the last minute. The counter does not try to be accurate and update times proactively, instead it only does so lazily. As a result, produced rates are worst-case estimates.

Functions

Decode a hex string into bytes.
Encode an utf8 string to a base64 string
Encode the provided bytes into a hex string

Type Definitions

A mutual exclusion primitive useful for protecting shared data
A reader-writer lock