forc-client 0.71.3

A `forc` plugin for interacting with a Fuel node.
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

use crate::constants::{
    DEVNET_ENDPOINT_URL, DEVNET_FAUCET_URL, MAINNET_ENDPOINT_URL, MAINNET_EXPLORER_URL, NODE_URL,
    TESTNET_ENDPOINT_URL, TESTNET_EXPLORER_URL, TESTNET_FAUCET_URL,
};
use anyhow::{bail, Result};
use serde::{Deserialize, Serialize};
use std::str::FromStr;

#[derive(Debug, Clone, PartialEq, Eq, Deserialize, Serialize)]
/// Possible target values that forc-client can interact with.
#[derive(Default)]
pub enum Target {
    Mainnet,
    Testnet,
    Devnet,
    #[default]
    Local,
}

impl Target {
    pub fn target_url(&self) -> String {
        let url = match self {
            Target::Mainnet => MAINNET_ENDPOINT_URL,
            Target::Testnet => TESTNET_ENDPOINT_URL,
            Target::Devnet => DEVNET_ENDPOINT_URL,
            Target::Local => NODE_URL,
        };
        url.to_string()
    }

    pub fn from_target_url(target_url: &str) -> Option<Self> {
        match target_url {
            TESTNET_ENDPOINT_URL => Some(Target::Testnet),
            MAINNET_ENDPOINT_URL => Some(Target::Mainnet),
            DEVNET_ENDPOINT_URL => Some(Target::Devnet),
            NODE_URL => Some(Target::Local),
            _ => None,
        }
    }

    pub fn local() -> Self {
        Target::Local
    }

    pub fn devnet() -> Self {
        Target::Devnet
    }

    pub fn testnet() -> Self {
        Target::Testnet
    }

    pub fn mainnet() -> Self {
        Target::Mainnet
    }

    pub fn faucet_url(&self) -> Option<String> {
        match self {
            Target::Mainnet => None,
            Target::Testnet => Some(TESTNET_FAUCET_URL.to_string()),
            Target::Devnet => Some(DEVNET_FAUCET_URL.to_string()),
            Target::Local => Some("http://localhost:3000".to_string()),
        }
    }

    pub fn explorer_url(&self) -> Option<String> {
        match self {
            Target::Mainnet => Some(MAINNET_EXPLORER_URL.to_string()),
            Target::Testnet => Some(TESTNET_EXPLORER_URL.to_string()),
            Target::Devnet => None,
            _ => None,
        }
    }
}

impl FromStr for Target {
    type Err = anyhow::Error;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        match s {
            "Fuel Sepolia Testnet" => Ok(Target::Testnet),
            "Ignition" => Ok(Target::Mainnet),
            "local" => Ok(Target::Local),
            "Devnet" | "devnet" => Ok(Target::Devnet),
            _ => bail!(
                "'{s}' is not a valid target name. Possible values: '{}', '{}', '{}', '{}'",
                Target::Testnet,
                Target::Mainnet,
                Target::Local,
                Target::Devnet,
            ),
        }
    }
}

impl std::fmt::Display for Target {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        let s = match self {
            Target::Mainnet => "Ignition",
            Target::Testnet => "Fuel Sepolia Testnet",
            Target::Devnet => "Devnet",
            Target::Local => "local",
        };
        write!(f, "{s}")
    }
}