forest-filecoin 0.33.7

Rust Filecoin implementation.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

// Copyright 2019-2026 ChainSafe Systems
// SPDX-License-Identifier: Apache-2.0, MIT

pub mod wallet_cmd;

use crate::cli_shared::cli::{CliRpcOpts, HELP_MESSAGE};
use crate::utils::version::FOREST_VERSION_STRING;
use clap::Parser;

/// Command-line options for the `forest-wallet` binary
#[derive(Parser)]
#[command(name = env!("CARGO_PKG_NAME"), bin_name = "forest-wallet", author = env!("CARGO_PKG_AUTHORS"), version = FOREST_VERSION_STRING.as_str(), about = env!("CARGO_PKG_DESCRIPTION")
)]
#[command(help_template(HELP_MESSAGE))]
pub struct Cli {
    #[clap(flatten)]
    pub opts: CliRpcOpts,

    /// Use remote wallet associated with the Filecoin node.
    /// Warning! You should ensure that your connection is encrypted and secure,
    /// as the communication between the wallet and the node is **not** encrypted.
    #[arg(long)]
    pub remote_wallet: bool,

    /// Use encrypted keystore.
    ///
    /// Note: When an encrypted keystore exists, it is used by default if `--encrypt` is omitted.
    #[arg(long)]
    pub encrypt: Option<bool>,

    #[command(subcommand)]
    pub cmd: wallet_cmd::WalletCommands,
}

#[cfg(test)]
mod tests {
    use super::Cli;
    use clap::Parser;
    use clap::error::ErrorKind;
    use rstest::rstest;

    fn try_parse(args: &[&str]) -> Result<Cli, ErrorKind> {
        let argv = std::iter::once("forest-wallet").chain(args.iter().copied());
        Cli::try_parse_from(argv).map_err(|e| e.kind())
    }

    #[rstest]
    #[case::balance(&["balance", "not-an-address"])]
    #[case::export(&["export", "not-an-address"])]
    #[case::has(&["has", "not-an-address"])]
    #[case::set_default(&["set-default", "not-an-address"])]
    #[case::delete(&["delete", "not-an-address"])]
    #[case::sign(&["sign", "-m", "de", "-a", "not-an-address"])]
    #[case::verify(&["verify", "-a", "not-an-address", "-m", "de", "-s", "de"])]
    #[case::send_from(&["send", "--from", "not-an-address", "f01234", "1"])]
    fn migrated_subcommands_reject_malformed_address(#[case] args: &[&str]) {
        assert_eq!(try_parse(args).err(), Some(ErrorKind::ValueValidation));
    }
}