starktop 0.8.1

A TUI block explorer for the Starknet blockchain
Documentation
use clap::Parser;

#[derive(Parser, Clone)]
#[command(name = "starktop")]
#[command(about = "TUI Starknet block explorer")]
pub struct AppConfig {
    /// Starknet RPC endpoint
    #[arg(long, env = "APP_RPC_URL")]
    pub rpc_url: String,

    /// WebSocket endpoint for new block subscriptions
    #[arg(long, env = "APP_WS_URL")]
    pub ws_url: Option<String>,

    /// Path to pathfinder SQLite database (alternative to RPC)
    #[arg(long, env = "APP_PATHFINDER_DB")]
    pub pathfinder_db: Option<String>,

    /// Path to user labels TOML file
    #[arg(long, env = "APP_USER_LABELS", default_value = "labels.toml")]
    pub user_labels: String,

    /// Path to viewing keys TOML file (privacy-pool decryption keys).
    /// Held separately from labels.toml because the keys are SECRETS.
    #[arg(long, env = "APP_VIEWING_KEYS", default_value = "viewing_keys.toml")]
    pub viewing_keys: String,

    /// Voyager API key
    #[arg(long, env = "VOYAGER_API_KEY")]
    pub voyager_api_key: Option<String>,

    /// Dune API key
    #[arg(long, env = "DUNE_API_KEY")]
    pub dune_api_key: Option<String>,

    /// Mark dynamic Dune queries as private. Default true preserves the
    /// pre-existing behavior; set `DUNE_PRIVATE_QUERIES=false` to create
    /// non-private queries, which can dodge the per-account private-query
    /// quota when it's exhausted (the same archive-on-finish cleanup still
    /// applies, so they stay temporary).
    #[arg(long, env = "DUNE_PRIVATE_QUERIES", default_value_t = true)]
    pub dune_private_queries: bool,

    /// Starkscan API key (enables the address Transfers tab's indexed history)
    #[arg(long, env = "STARKSCAN_API_KEY")]
    pub starkscan_api_key: Option<String>,

    /// Starkscan REST base URL, chain included
    #[arg(
        long,
        env = "STARKSCAN_API_URL",
        default_value = "https://api.starkscan.co/v1/SN_MAIN"
    )]
    pub starkscan_api_url: String,

    /// Pathfinder query service URL (e.g. http://steak:8234)
    #[arg(long, env = "APP_PATHFINDER_SERVICE_URL")]
    pub pathfinder_service_url: Option<String>,

    /// Log level (trace, debug, info, warn, error)
    #[arg(long, env = "APP_LOG_LEVEL", default_value = "info")]
    pub log_level: String,

    /// Directory for log files (default: ~/.config/starktop/logs)
    #[arg(long, env = "APP_LOG_DIR")]
    pub log_dir: Option<String>,
}