backport: Database manipulation tool to release 0.2.0 (#955)

* strata-dbtool outline with command stubs

* implementation of get-client-state-update with println for output

* implement get-l1-summary and get-l1-manifest commands

* implement get-checkpoints-summary, get-checkpoint and get-epoch-summary

* implement get-l2-summary and get-l2-block

still l2 commands

* move block id parsing and validation to utils

* implement get-chainstate and revert-chainstate

* implement get-syncinfo

* implement get-sync-events-summary and get-sync-event

* output formatting to support json and porcelain

* add README

* add functional tests

Author: krsnapaudel

Cargo.lock

@@ -43,6 +43,7 @@ members = [
   "bin/datatool",
   "bin/alpen-cli",
   "bin/strata-client",
+  "bin/strata-dbtool",
   "bin/alpen-reth",
   "bin/strata-sequencer-client",
   "bin/prover-client",
@@ -58,6 +59,7 @@ default-members = [
   "bin/prover-client",
   "bin/alpen-reth",
   "bin/strata-client",
+  "bin/strata-dbtool",
   "bin/strata-sequencer-client",
   "crates/util/python-utils",
 ]
@@ -73,6 +75,7 @@ alpen-reth-primitives = { path = "crates/reth/primitives" }
 alpen-reth-rpc = { path = "crates/reth/rpc" }
 strata-btcio = { path = "crates/btcio" }
 strata-chaintsn = { path = "crates/chaintsn" }
+strata-cli-common = { path = "crates/strata-cli-common" }
 strata-common = { path = "crates/common" }
 strata-config = { path = "crates/config" }
 strata-consensus-logic = { path = "crates/consensus-logic" }
@@ -195,7 +198,7 @@ borsh = { version = "1.5.0", features = ["derive"] }
 bytes = "1.6.0"
 cfg-if = "1.0.0"
 chrono = "0.4.38"
-clap = "4"
+clap = { version = "4.5.39", default-features = false, features = ["derive"] }
 deadpool = "0.12.1"
 digest = "0.10"
 ethnum = "1.5.0"

Cargo.toml

@@ -8,6 +8,7 @@ name = "alpen"
 path = "src/main.rs"
 
 [dependencies]
+strata-cli-common.workspace = true
 strata-primitives.workspace = true
 
 aes-gcm-siv = "0.11.1"

bin/alpen-cli/Cargo.toml

@@ -1,7 +1,8 @@
 use argh::FromArgs;
 use bip39::Language;
+use strata_cli_common::errors::DisplayedError;
 
-use crate::{errors::DisplayedError, seed::Seed};
+use crate::seed::Seed;
 
 #[derive(FromArgs, PartialEq, Debug)]
 #[argh(subcommand, name = "backup")]

bin/alpen-cli/src/cmd/backup.rs

@@ -4,15 +4,11 @@ use alloy::{
 };
 use argh::FromArgs;
 use bdk_wallet::bitcoin::Amount;
+use strata_cli_common::errors::{DisplayableError, DisplayedError};
 
 use crate::{
-    alpen::AlpenWallet,
-    constants::SATS_TO_WEI,
-    errors::{DisplayableError, DisplayedError},
-    net_type::NetworkType,
-    seed::Seed,
-    settings::Settings,
-    signet::SignetWallet,
+    alpen::AlpenWallet, constants::SATS_TO_WEI, net_type::NetworkType, seed::Seed,
+    settings::Settings, signet::SignetWallet,
 };
 
 /// Prints the wallet's current balance(s)

bin/alpen-cli/src/cmd/balance.rs

@@ -1,10 +1,8 @@
 use argh::FromArgs;
 use rand_core::OsRng;
+use strata_cli_common::errors::{DisplayableError, DisplayedError};
 
-use crate::{
-    errors::{DisplayableError, DisplayedError},
-    seed::{password::Password, EncryptedSeedPersister, Seed},
-};
+use crate::seed::{password::Password, EncryptedSeedPersister, Seed};
 
 /// Changes the seed's encryption password
 #[derive(FromArgs, PartialEq, Debug)]

bin/alpen-cli/src/cmd/change_pwd.rs

@@ -1,11 +1,7 @@
 use argh::FromArgs;
+use strata_cli_common::errors::{DisplayableError, DisplayedError};
 
-use crate::{
-    errors::{DisplayableError, DisplayedError},
-    recovery::DescriptorRecovery,
-    seed::Seed,
-    settings::Settings,
-};
+use crate::{recovery::DescriptorRecovery, seed::Seed, settings::Settings};
 
 /// Various debug utilities
 #[derive(FromArgs, PartialEq, Debug)]

bin/alpen-cli/src/cmd/debug.rs

@@ -15,12 +15,12 @@ use colored::Colorize;
 use indicatif::ProgressBar;
 use rand_core::OsRng;
 use shrex::encode;
+use strata_cli_common::errors::{DisplayableError, DisplayedError};
 use strata_primitives::crypto::even_kp;
 
 use crate::{
     alpen::AlpenWallet,
     constants::SIGNET_BLOCK_TIME,
-    errors::{DisplayableError, DisplayedError},
     link::{OnchainObject, PrettyPrint},
     recovery::DescriptorRecovery,
     seed::Seed,

bin/alpen-cli/src/cmd/deposit.rs

@@ -11,11 +11,11 @@ use bdk_wallet::{
     error::CreateTxError,
 };
 use colored::Colorize;
+use strata_cli_common::errors::{DisplayableError, DisplayedError};
 
 use crate::{
     alpen::AlpenWallet,
     constants::SATS_TO_WEI,
-    errors::{DisplayableError, DisplayedError},
     link::{OnchainObject, PrettyPrint},
     seed::Seed,
     settings::Settings,

bin/alpen-cli/src/cmd/drain.rs

@@ -8,14 +8,10 @@ use reqwest::{StatusCode, Url};
 use serde::{Deserialize, Serialize};
 use sha2::{Digest, Sha256};
 use shrex::{encode, Hex};
+use strata_cli_common::errors::{DisplayableError, DisplayedError};
 
 use crate::{
-    alpen::AlpenWallet,
-    errors::{DisplayableError, DisplayedError},
-    net_type::NetworkType,
-    seed::Seed,
-    settings::Settings,
-    signet::SignetWallet,
+    alpen::AlpenWallet, net_type::NetworkType, seed::Seed, settings::Settings, signet::SignetWallet,
 };
 
 /// Requests BTC from the faucet