starkli 0.0.1

Starkli (/ˈstɑːrklaɪ/), a blazing fast CLI tool for Starknet powered by starknet-rs
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
107
108
109
110
111
112
113
114
115
116
117
118
119
120

use std::str::FromStr;

use anyhow::Result;
use clap::{builder::PossibleValue, Parser, ValueEnum};
use colored::Colorize;
use starknet::{
    core::chain_id,
    providers::{jsonrpc::HttpTransport, AnyProvider, JsonRpcClient, SequencerGatewayProvider},
};
use url::Url;

#[derive(Debug, Clone, Parser)]
pub struct ProviderArgs {
    #[clap(
        long = "rpc",
        env = "STARKNET_RPC",
        help = "Starknet JSON-RPC endpoint"
    )]
    rpc: Option<Url>,
    #[clap(long = "network", env = "STARKNET_NETWORK", help = "Starknet network")]
    network: Option<Network>,
}

#[derive(Debug, Clone)]
pub enum Network {
    Mainnet,
    Goerli1,
    Goerli2,
    Integration,
}

impl ProviderArgs {
    pub fn into_provider(self) -> AnyProvider {
        match (self.rpc, self.network) {
            (Some(rpc), None) => {
                AnyProvider::JsonRpcHttp(JsonRpcClient::new(HttpTransport::new(rpc)))
            }
            (Some(rpc), Some(_)) => {
                eprintln!(
                    "{}",
                    "WARNING: when using JSON-RPC, the --network flag is ignored. \
                    There's no need to use --network as network is automatically detected."
                        .bright_magenta()
                );

                AnyProvider::JsonRpcHttp(JsonRpcClient::new(HttpTransport::new(rpc)))
            }
            (None, Some(network)) => {
                eprintln!(
                    "{}",
                    "WARNING: you're using --network instead of providing a JSON-RPC endpoint. \
                    Falling back to using the sequencer gateway now, \
                    but this is strongly discouraged."
                        .bright_magenta()
                );

                AnyProvider::SequencerGateway(match network {
                    Network::Mainnet => SequencerGatewayProvider::starknet_alpha_mainnet(),
                    Network::Goerli1 => SequencerGatewayProvider::starknet_alpha_goerli(),
                    Network::Goerli2 => SequencerGatewayProvider::starknet_alpha_goerli_2(),
                    Network::Integration => SequencerGatewayProvider::new(
                        Url::parse("https://external.integration.starknet.io/gateway").unwrap(),
                        Url::parse("https://external.integration.starknet.io/feeder_gateway")
                            .unwrap(),
                        // Unfortunately the integration environment has the same chain ID as
                        // goerli-1, which will cause issues whenever we try to identify networks by
                        // chain ID. We ignore this issue since it's not a live network.
                        chain_id::TESTNET,
                    ),
                })
            }
            (None, None) => {
                // If nothing is provided we fall back to using sequencer gateway for goerli-1
                eprintln!(
                    "{}",
                    "WARNING: no valid provider option found. \
                    Falling back to using the sequencer gateway for the goerli-1 network."
                        .bright_magenta()
                );

                AnyProvider::SequencerGateway(SequencerGatewayProvider::starknet_alpha_goerli())
            }
        }
    }
}

impl ValueEnum for Network {
    fn value_variants<'a>() -> &'a [Self] {
        &[
            Self::Mainnet,
            Self::Goerli1,
            Self::Goerli2,
            Self::Integration,
        ]
    }

    fn to_possible_value(&self) -> Option<PossibleValue> {
        match self {
            Network::Mainnet => Some(PossibleValue::new("mainnet")),
            Network::Goerli1 => Some(PossibleValue::new("goerli-1")),
            Network::Goerli2 => Some(PossibleValue::new("goerli-2")),
            Network::Integration => Some(PossibleValue::new("integration")),
        }
    }
}

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

    fn from_str(s: &str) -> Result<Self> {
        match s {
            "mainnet" | "alpha-mainnet" => Ok(Self::Mainnet),
            "goerli" | "goerli1" | "goerli-1" | "alpha-goerli" | "alpha-goerli1"
            | "alpha-goerli-1" => Ok(Self::Goerli1),
            "goerli2" | "goerli-2" | "alpha-goerli2" | "alpha-goerli-2" => Ok(Self::Goerli2),
            "integration" => Ok(Self::Integration),
            _ => Err(anyhow::anyhow!("unknown network: {}", s)),
        }
    }
}