Skip to main content

fogo_paymaster/
cli.rs

1use crate::db::config::NetworkEnvironment as DbNetworkEnvironment;
2use clap::{Args, Parser, Subcommand, ValueEnum};
3use solana_pubkey::Pubkey;
4use std::{
5    collections::HashMap,
6    fmt::{self, Display},
7    str::FromStr,
8};
9#[derive(Debug, Parser)]
10#[command(version, about)]
11pub struct Cli {
12    #[command(subcommand)]
13    pub command: Command,
14}
15
16#[allow(clippy::large_enum_variant)]
17#[derive(Debug, Subcommand)]
18pub enum Command {
19    /// Run the paymaster service (uses DB + env vars, no TOML)
20    Run(RunOptions),
21
22    /// Run DB migrations and exit (requires only DATABASE_URL)
23    Migrate(MigrateOptions),
24}
25
26#[derive(Debug, Clone, Copy, ValueEnum)]
27#[clap()]
28pub enum NetworkEnvironment {
29    Mainnet,
30    Testnet,
31    Localnet,
32}
33
34impl Display for NetworkEnvironment {
35    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
36        match self {
37            NetworkEnvironment::Mainnet => write!(f, "mainnet"),
38            NetworkEnvironment::Testnet => write!(f, "testnet"),
39            NetworkEnvironment::Localnet => write!(f, "localnet"),
40        }
41    }
42}
43
44impl From<NetworkEnvironment> for DbNetworkEnvironment {
45    fn from(val: NetworkEnvironment) -> Self {
46        match val {
47            NetworkEnvironment::Mainnet => DbNetworkEnvironment::Mainnet,
48            NetworkEnvironment::Testnet => DbNetworkEnvironment::Testnet,
49            NetworkEnvironment::Localnet => DbNetworkEnvironment::Localnet,
50        }
51    }
52}
53
54fn parse_fee_coefficients(s: &str) -> Result<HashMap<Pubkey, u64>, String> {
55    let string_map = serde_json::from_str::<HashMap<String, u64>>(s)
56        .map_err(|e| format!("Invalid JSON for fee coefficients: {e}"))?;
57
58    let mut result = HashMap::new();
59    for (key, value) in string_map {
60        let pubkey =
61            Pubkey::from_str(&key).map_err(|e| format!("Invalid Pubkey '{}': {}", key, e))?;
62        result.insert(pubkey, value);
63    }
64
65    Ok(result)
66}
67
68#[derive(Args, Debug, Clone)]
69pub struct RunOptions {
70    /// Postgres connection string (required via flag or env)
71    #[arg(short = 'd', long = "db-url", env = "DATABASE_URL")]
72    pub db_url: String,
73
74    /// Network environment to run the paymaster for
75    #[arg(long, env = "NETWORK_ENVIRONMENT")]
76    pub network_environment: NetworkEnvironment,
77
78    /// Path to mnemonic file (env/flag; optional)
79    #[arg(long, env = "MNEMONIC_FILE", default_value = "./tilt/secrets/mnemonic")]
80    pub mnemonic_file: String,
81
82    #[arg(long, env = "RPC_URL_HTTP", default_value = "http://localhost:8899")]
83    pub rpc_url_http: String,
84
85    #[arg(long, env = "RPC_URL_WS")]
86    pub rpc_url_ws: Option<String>,
87
88    #[arg(long, env = "FTL_URL")]
89    pub ftl_url: Option<String>,
90
91    #[arg(long, env = "LISTEN_ADDRESS", default_value = "0.0.0.0:4000")]
92    pub listen_address: String,
93
94    #[arg(
95        long,
96        env = "OTEL_EXPORTER_OTLP_ENDPOINT",
97        default_value = "http://localhost:4317"
98    )]
99    pub otlp_endpoint: String,
100
101    #[arg(long, env = "DB_REFRESH_INTERVAL_SECONDS", default_value = "10")]
102    pub db_refresh_interval_seconds: u64,
103
104    #[arg(long, env = "VALIANT_API_KEY")]
105    pub valiant_api_key: Option<String>,
106
107    #[arg(long, env = "VALIANT_OVERRIDE_URL")]
108    pub valiant_override_url: Option<String>,
109
110    #[arg(long, env = "FEE_COEFFICIENTS", value_parser = parse_fee_coefficients, default_value = "{}")]
111    pub fee_coefficients: HashMap<Pubkey, u64>,
112}
113
114#[derive(Args, Debug, Clone)]
115pub struct MigrateOptions {
116    /// Postgres connection string (required via flag or env)
117    #[arg(short = 'd', long = "db-url", env = "DATABASE_URL")]
118    pub db_url: String,
119}