Add tx decode/encode subcommands (#1785)

Author: leighmcculloch

FULL_HELP_DOCS.md

@@ -1608,6 +1608,8 @@ Sign, Simulate, and Send transactions
 * `sign` — Sign a transaction envelope appending the signature to the envelope
 * `simulate` — Simulate a transaction envelope from stdin
 * `fetch` — Fetch a transaction from the network by hash If no subcommand is passed in, the transaction envelope will be returned
+* `decode` — Decode a transaction envelope from XDR to JSON
+* `encode` — Encode a transaction envelope from JSON to XDR
 
 
 
@@ -3023,6 +3025,60 @@ Fetch the transaction fee information
 
 
 
+## `stellar tx decode`
+
+Decode a transaction envelope from XDR to JSON
+
+**Usage:** `stellar tx decode [OPTIONS] [INPUT]...`
+
+###### **Arguments:**
+
+* `<INPUT>` — XDR or files containing XDR to decode, or stdin if empty
+
+###### **Options:**
+
+* `--input <INPUT_FORMAT>`
+
+  Default value: `single-base64`
+
+  Possible values: `single-base64`, `single`
+
+* `--output <OUTPUT_FORMAT>`
+
+  Default value: `json`
+
+  Possible values: `json`, `json-formatted`
+
+
+
+
+## `stellar tx encode`
+
+Encode a transaction envelope from JSON to XDR
+
+**Usage:** `stellar tx encode [OPTIONS] [INPUT]...`
+
+###### **Arguments:**
+
+* `<INPUT>` — XDR or files containing XDR to decode, or stdin if empty
+
+###### **Options:**
+
+* `--input <INPUT_FORMAT>`
+
+  Default value: `json`
+
+  Possible values: `json`
+
+* `--output <OUTPUT_FORMAT>`
+
+  Default value: `single-base64`
+
+  Possible values: `single-base64`, `single`
+
+
+
+
 ## `stellar xdr`
 
 Decode and encode XDR

cmd/soroban-cli/src/commands/tx/decode.rs

@@ -0,0 +1,68 @@
+use clap::ValueEnum;
+use std::ffi::OsString;
+use stellar_xdr::{cli::Channel, curr::TypeVariant};
+
+#[derive(thiserror::Error, Debug)]
+pub enum Error {
+    #[error(transparent)]
+    Cli(#[from] stellar_xdr::cli::decode::Error),
+}
+
+/// Decode a transaction envelope from XDR to JSON
+#[derive(Debug, clap::Parser, Clone, Default)]
+pub struct Cmd {
+    /// XDR or files containing XDR to decode, or stdin if empty
+    #[arg()]
+    pub input: Vec<OsString>,
+    // Input format
+    #[arg(long = "input", value_enum, default_value_t)]
+    pub input_format: InputFormat,
+    // Output format
+    #[arg(long = "output", value_enum, default_value_t)]
+    pub output_format: OutputFormat,
+}
+
+#[derive(Default, Clone, Copy, Debug, Eq, Hash, PartialEq, ValueEnum)]
+pub enum InputFormat {
+    #[default]
+    SingleBase64,
+    Single,
+}
+
+impl From<InputFormat> for stellar_xdr::cli::decode::InputFormat {
+    fn from(v: InputFormat) -> Self {
+        match v {
+            InputFormat::SingleBase64 => Self::SingleBase64,
+            InputFormat::Single => Self::Single,
+        }
+    }
+}
+
+#[derive(Default, Clone, Copy, Debug, Eq, Hash, PartialEq, ValueEnum)]
+pub enum OutputFormat {
+    #[default]
+    Json,
+    JsonFormatted,
+}
+
+impl From<OutputFormat> for stellar_xdr::cli::decode::OutputFormat {
+    fn from(v: OutputFormat) -> Self {
+        match v {
+            OutputFormat::Json => Self::Json,
+            OutputFormat::JsonFormatted => Self::JsonFormatted,
+        }
+    }
+}
+
+impl Cmd {
+    pub fn run(&self) -> Result<(), Error> {
+        let cmd = stellar_xdr::cli::decode::Cmd {
+            input: self.input.clone(),
+            r#type: TypeVariant::TransactionEnvelope.name().to_string(),
+            input_format: self.input_format.into(),
+            output_format: self.output_format.into(),
+        };
+        cmd.run(&Channel::Curr)?;
+        Ok(())
+    }
+}

cmd/soroban-cli/src/commands/tx/encode.rs

@@ -0,0 +1,66 @@
+use clap::ValueEnum;
+use std::ffi::OsString;
+use stellar_xdr::{cli::Channel, curr::TypeVariant};
+
+#[derive(thiserror::Error, Debug)]
+pub enum Error {
+    #[error(transparent)]
+    Cli(#[from] stellar_xdr::cli::encode::Error),
+}
+
+/// Encode a transaction envelope from JSON to XDR
+#[derive(Debug, clap::Parser, Clone, Default)]
+pub struct Cmd {
+    /// XDR or files containing XDR to decode, or stdin if empty
+    #[arg()]
+    pub input: Vec<OsString>,
+    // Input format
+    #[arg(long = "input", value_enum, default_value_t)]
+    pub input_format: InputFormat,
+    // Output format
+    #[arg(long = "output", value_enum, default_value_t)]
+    pub output_format: OutputFormat,
+}
+
+#[derive(Default, Clone, Copy, Debug, Eq, Hash, PartialEq, ValueEnum)]
+pub enum InputFormat {
+    #[default]
+    Json,
+}
+
+impl From<InputFormat> for stellar_xdr::cli::encode::InputFormat {
+    fn from(v: InputFormat) -> Self {
+        match v {
+            InputFormat::Json => Self::Json,
+        }
+    }
+}
+
+#[derive(Default, Clone, Copy, Debug, Eq, Hash, PartialEq, ValueEnum)]
+pub enum OutputFormat {
+    #[default]
+    SingleBase64,
+    Single,
+}
+
+impl From<OutputFormat> for stellar_xdr::cli::encode::OutputFormat {
+    fn from(v: OutputFormat) -> Self {
+        match v {
+            OutputFormat::SingleBase64 => Self::SingleBase64,
+            OutputFormat::Single => Self::Single,
+        }
+    }
+}
+
+impl Cmd {
+    pub fn run(&self) -> Result<(), Error> {
+        let cmd = stellar_xdr::cli::encode::Cmd {
+            input: self.input.clone(),
+            r#type: TypeVariant::TransactionEnvelope.name().to_string(),
+            input_format: self.input_format.into(),
+            output_format: self.output_format.into(),
+        };
+        cmd.run(&Channel::Curr)?;
+        Ok(())
+    }
+}

cmd/soroban-cli/src/commands/tx/mod.rs

@@ -1,7 +1,10 @@
 use super::global;
 
 pub mod args;
+
+pub mod decode;
 pub mod edit;
+pub mod encode;
 pub mod fetch;
 pub mod hash;
 pub mod help;
@@ -49,6 +52,8 @@ pub enum Cmd {
     /// Fetch a transaction from the network by hash
     /// If no subcommand is passed in, the transaction envelope will be returned
     Fetch(fetch::Cmd),
+    Decode(decode::Cmd),
+    Encode(encode::Cmd),
 }
 
 #[derive(thiserror::Error, Debug)]
@@ -73,6 +78,10 @@ pub enum Error {
     Update(#[from] update::Error),
     #[error(transparent)]
     Fetch(#[from] fetch::Error),
+    #[error(transparent)]
+    Decode(#[from] decode::Error),
+    #[error(transparent)]
+    Encode(#[from] encode::Error),
 }
 
 impl Cmd {
@@ -87,6 +96,8 @@ impl Cmd {
             Cmd::Simulate(cmd) => cmd.run(global_args).await?,
             Cmd::Update(cmd) => cmd.run(global_args).await?,
             Cmd::Fetch(cmd) => cmd.run(global_args).await?,
+            Cmd::Decode(cmd) => cmd.run()?,
+            Cmd::Encode(cmd) => cmd.run()?,
         }
         Ok(())
     }