add docs

book/src/SUMMARY.md

@@ -17,6 +17,7 @@
   - [Sync](./running/sync.md)
   - [Serve](./running/serve.md)
   - [Daemon](./running/daemon.md)
+  - [Eval](./running/eval.md)
 - [API](./api/README.md)
   - [gRPC](./api/grpc.md)
   - [Ouroboros](./api/ouroboros.md)

book/src/running/eval.md

@@ -0,0 +1,18 @@
+# `eval` command
+
+The `eval` is an utility for evaluating transactions. It takes tx data from an external source and uses the current ledger state to evaluate phase-1 validation rules.
+
+## Usage
+
+To execute the evaluation, run the following command from your terminal:
+
+```bash
+dolos eval --file <FILE> --era <ERA> --magic <MAGIC> --slot <SLOT>
+```
+
+The args should be interpreted as:
+
+- `--file <FILE>`: the path to the file containing the tx data as hex-encoded cbor.
+- `--era <ERA>`: the id of the era that should be used to interpret the transaction data.
+- `--magic <MAGIC>`: the protocol magic of the network.
+- `--slot <SLOT>`: the slot that should be used for retrieving protocol parameters.

src/bin/dolos/data.rs

@@ -2,11 +2,9 @@ use std::path::Path;
 
 use miette::IntoDiagnostic;
 
-use pallas::{
-    ledger::traverse::{tx, MultiEraBlock},
-    storage::rolldb::chain,
-};
+use pallas::{ledger::traverse::MultiEraBlock, storage::rolldb::chain};
 
+#[allow(dead_code)]
 fn dump_txs(chain: &chain::Store) -> miette::Result<()> {
     for header in chain.crawl() {
         let (slot, hash) = header.into_diagnostic()?;