zeldhash-parser 0.5.1

High-performance Bitcoin blockchain parser implementing the ZeldHash protocol
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

use std::path::PathBuf;

use clap::{Parser, Subcommand, ValueEnum};
use serde::Deserialize;

use super::{ProtoblockOptions, RollblockOptions};

/// Command-line interface definition.
#[derive(Parser, Debug)]
#[command(
    name = "zeldhash-parser",
    author,
    version,
    about = "ZeldHash parser and daemon"
)]
pub struct Cli {
    /// Path to the optional TOML configuration file.
    #[arg(
        long = "config",
        alias = "config-file",
        env = "ZELDHASH_PARSER_CONFIG",
        global = true,
        value_name = "FILE",
        help = "Optional. Path to the TOML configuration file; defaults to the platform-specific user config directory (ProjectDirs) when omitted."
    )]
    pub config: Option<PathBuf>,

    /// Select the target ZELD network for the entire application.
    #[arg(
        long = "network",
        alias = "zeldhash_protocol-network",
        env = "ZELDHASH_PARSER_NETWORK",
        global = true,
        value_enum,
        value_name = "NETWORK",
        help = "Optional. Select the target ZELD network for the application. [default: mainnet]"
    )]
    pub network: Option<ZeldNetworkArg>,

    /// Root directory for all application data.
    #[arg(
        long = "data_dir",
        alias = "data-dir",
        env = "ZELDHASH_PARSER_DATA_DIR",
        global = true,
        value_name = "PATH",
        help = "Optional. Base directory for ZELD server data (Rollblock stores data under <data_dir>/utxodb). Defaults to the platform-specific user data directory (ProjectDirs)."
    )]
    pub data_dir: Option<PathBuf>,

    #[command(flatten)]
    pub protoblock: ProtoblockOptions,

    #[command(flatten)]
    pub rollblock: RollblockOptions,

    /// Run the server in the background without the progress UI.
    #[arg(
        long = "daemon",
        global = true,
        help = "Run the parser as a daemon. Combine with `zeldhash-parser stop` to stop it later."
    )]
    pub daemon: bool,

    /// Internal flag used to mark the detached daemon child.
    #[arg(long = "daemon-child", hide = true, global = true)]
    pub daemon_child: bool,

    /// Optional lifecycle subcommand (e.g. `stop`).
    #[command(subcommand)]
    pub command: Option<Command>,
}

#[derive(ValueEnum, Clone, Debug, Deserialize)]
pub enum ZeldNetworkArg {
    Mainnet,
    Testnet4,
    Signet,
    Regtest,
}

/// High-level commands supported by the CLI.
#[derive(Subcommand, Debug, Clone, Copy, PartialEq, Eq)]
pub enum Command {
    /// Start the parser (default when no subcommand is provided).
    #[command(alias = "start")]
    Run,
    /// Stop the background daemon by reading the PID file and sending a signal.
    Stop,
}