Quickstart
This guide will help you get set up and ready to use the WalletD Rust Library. We'll cover how to install Rust, add WalletD to an existing Rust project, and get started with using its features.
⚠️ This project is under heavy development. Expect bugs & breaking changes prior to v1.0.0's release.
Installing Rust
Rust can be installed by following the instructions on rust-lang.org, rustup.rs or your choice of package manager.
Refer to the Rust book
for more guidance on the installation.
You can set up a new Rust project to try out WalletD or incorporate the walletd
crate into your existing Rust project.
Install the WalletD Rust Library
It is recommended that the walletd
crate be installed from the command-line in order to ensure you download the latest version of it.
Installing via the CLI (recommended)
cargo add walletd
Installing via the Cargo.toml file
Add the following line to your Cargo.toml file. Make sure you put it under the dependencies heading, then rebuild your project.
walletd = "0.1.0"
What's next?
Great, you're now set up with installing the WalletD Rust library. You are now ready to try it out and incorporate it.
Here are links to guides with code examples that will introduce you to different aspects of WalletD:
- Guide to working with typical basic features of cryptocurrencies
- Guide to using mnemonics in WalletD
- Guide for Bitcoin Wallet with WalletD
- Guide for Ethereum Wallet with WalletD
- Guide for Hierarchical Deterministic Wallet with WalletD
Notes on following the guides
In the Rust code in the guides, we use ?
to handle errors.
Most of the example code we provide can be put inside a main function that returns a Result that uses the walletd::Error
type.
Example
use walletd;
fn main -> Result<(), walletd::Error> {
println!("Main function returning Result for WalletD guide examples");
Ok(())
}
Another way to handle errors returned by WalletD in Rust is to use unwrap()
.
Instances of ?
in the examples can be replaced by .unwrap()
.
However, it's usually better to limit the use of unwrap()
(which leads to an immediate panic if an error occurs) and instead use ?
.
You may want to handle the different errors returned by WalletD in different ways in your implementation, and ?
enables this.