feat(tools): da-debug (#2729)

<!--
Please read and fill out this form before submitting your PR.

Please make sure you have reviewed our contributors guide before
submitting your
first PR.

NOTE: PR titles should follow semantic commits:
https://www.conventionalcommits.org/en/v1.0.0/
-->

## Overview

Small tool to verify what heights are included in a namespace on DA.

<!-- 
Please provide an explanation of the PR, including the appropriate
context,
background, goal, and rationale. If there is an issue with this
information,
please provide a tl;dr and link the issue. 

Ex: Closes #<issue number>
-->

Author: julienrbrt

tools/da-debug/README.md

@@ -0,0 +1,84 @@
+# DA Debug Tool
+
+A professional debugging tool for querying and inspecting Data Availability (DA) layer data in ev-node.
+
+## Overview
+
+The `da-debug` tool provides a command-line interface to interact with DA layers for debugging purposes. It offers two main commands: `query` for inspecting specific DA heights and `search` for finding blobs containing specific blockchain heights.
+
+## Commands
+
+### Query Command
+
+Query and decode blobs at a specific DA height and namespace.
+
+```bash
+da-debug query <height> <namespace> [flags]
+```
+
+**Flags:**
+
+- `--filter-height uint`: Filter blobs by specific blockchain height (0 = no filter)
+
+**Examples:**
+
+```bash
+# Basic query
+da-debug query 100 "my-rollup"
+
+# Query with height filter (only show blobs containing height 50)
+da-debug query 100 "my-rollup" --filter-height 50
+
+# Query with hex namespace
+da-debug query 500 "0x000000000000000000000000000000000000000000000000000000746573743031"
+```
+
+### Search Command
+
+Search through multiple DA heights to find blobs containing a specific blockchain height.
+
+```bash
+da-debug search <start-da-height> <namespace> --target-height <height> [flags]
+```
+
+**Flags:**
+
+- `--target-height uint`: Target blockchain height to search for (required)
+- `--range uint`: Number of DA heights to search (default: 10)
+
+**Examples:**
+
+```bash
+# Search for blockchain height 1000 starting from DA height 500
+da-debug search 500 "my-rollup" --target-height 1000
+
+# Search with custom range of 20 DA heights
+da-debug search 500 "my-rollup" --target-height 1000 --range 20
+
+# Search with hex namespace
+da-debug search 100 "0x000000000000000000000000000000000000000000000000000000746573743031" --target-height 50 --range 5
+```
+
+## Global Flags
+
+All commands support these global flags:
+
+- `--da-url string`: DA layer JSON-RPC URL (default: "http://localhost:7980")
+- `--auth-token string`: Authentication token for DA layer
+- `--timeout duration`: Request timeout (default: 30s)
+- `--verbose`: Enable verbose logging
+- `--max-blob-size uint`: Maximum blob size in bytes (default: 1970176)
+- `--gas-price float`: Gas price for DA operations (default: 0.0)
+- `--gas-multiplier float`: Gas multiplier for DA operations (default: 1.0)
+- `--no-color`: Disable colored output
+
+## Namespace Format
+
+Namespaces can be provided in two formats:
+
+1. **Hex String**: A 29-byte hex string (with or without `0x` prefix)
+   - Example: `0x000000000000000000000000000000000000000000000000000000746573743031`
+
+2. **String Identifier**: Any string that gets automatically converted to a valid namespace
+   - Example: `"my-app"` or `"test-namespace"`
+   - The string is hashed and converted to a valid version 0 namespace

tools/da-debug/go.mod

@@ -0,0 +1,54 @@
+module github.com/evstack/ev-node/tools/da-debug
+
+go 1.24.6
+
+require (
+	github.com/evstack/ev-node v1.0.0-beta.6
+	github.com/evstack/ev-node/core v1.0.0-beta.3
+	github.com/evstack/ev-node/da v1.0.0-beta.4
+	github.com/rs/zerolog v1.34.0
+	github.com/spf13/cobra v1.10.1
+	google.golang.org/protobuf v1.36.9
+)
+
+require (
+	github.com/celestiaorg/go-header v0.7.3 // indirect
+	github.com/decred/dcrd/dcrec/secp256k1/v4 v4.4.0 // indirect
+	github.com/filecoin-project/go-jsonrpc v0.8.0 // indirect
+	github.com/gogo/protobuf v1.3.2 // indirect
+	github.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8 // indirect
+	github.com/google/uuid v1.6.0 // indirect
+	github.com/gorilla/websocket v1.5.3 // indirect
+	github.com/hashicorp/golang-lru/v2 v2.0.7 // indirect
+	github.com/inconshreveable/mousetrap v1.1.0 // indirect
+	github.com/ipfs/go-cid v0.5.0 // indirect
+	github.com/ipfs/go-log/v2 v2.8.0 // indirect
+	github.com/klauspost/cpuid/v2 v2.3.0 // indirect
+	github.com/libp2p/go-buffer-pool v0.1.0 // indirect
+	github.com/libp2p/go-libp2p v0.43.0 // indirect
+	github.com/libp2p/go-libp2p-pubsub v0.15.0 // indirect
+	github.com/libp2p/go-msgio v0.3.0 // indirect
+	github.com/mattn/go-colorable v0.1.13 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/minio/sha256-simd v1.0.1 // indirect
+	github.com/mr-tron/base58 v1.2.0 // indirect
+	github.com/multiformats/go-base32 v0.1.0 // indirect
+	github.com/multiformats/go-base36 v0.2.0 // indirect
+	github.com/multiformats/go-multiaddr v0.16.1 // indirect
+	github.com/multiformats/go-multiaddr-fmt v0.1.0 // indirect
+	github.com/multiformats/go-multibase v0.2.0 // indirect
+	github.com/multiformats/go-multicodec v0.9.2 // indirect
+	github.com/multiformats/go-multihash v0.2.3 // indirect
+	github.com/multiformats/go-multistream v0.6.1 // indirect
+	github.com/multiformats/go-varint v0.0.7 // indirect
+	github.com/spaolacci/murmur3 v1.1.0 // indirect
+	github.com/spf13/pflag v1.0.10 // indirect
+	go.opencensus.io v0.24.0 // indirect
+	go.uber.org/multierr v1.11.0 // indirect
+	go.uber.org/zap v1.27.0 // indirect
+	golang.org/x/crypto v0.42.0 // indirect
+	golang.org/x/exp v0.0.0-20250811191247-51f88131bc50 // indirect
+	golang.org/x/sys v0.36.0 // indirect
+	golang.org/x/xerrors v0.0.0-20240903120638-7835f813f4da // indirect
+	lukechampine.com/blake3 v1.4.1 // indirect
+)