refactor: vanilla (#329)

This pull request introduces a new utility function for waiting on proof
completion in the `ProposerDBClient`, adds a new dependency for
interoperability, and refactors the `ProposerService` test setup to use
a constructor method for improved clarity and maintainability.

**Core functionality improvements:**

* Added a new async method `wait_for_proof_completion` to
`ProposerDBClient` that polls for a proof's completion, handling retries
and error cases such as failure, cancellation, or timeout.

**Dependency updates:**

* Added `agglayer-interop-types` as a workspace dependency in
`crates/proposer-service/Cargo.toml` to improve interoperability with
other ecosystem components.

**Test and codebase refactoring:**

* Updated the `ProposerService` test setup to use the
`ProposerService::new` constructor and the `ProofBackend::Grpc` variant,
replacing direct struct initialization for better encapsulation and
maintainability in `crates/proposer-service/src/tests/mod.rs`.
[[1]](diffhunk://#diff-d9386ae9b1b2b470dad4ccbda209e421925557caa6d602f50a2b46298da7fa9bL142-R155)
[[2]](diffhunk://#diff-d9386ae9b1b2b470dad4ccbda209e421925557caa6d602f50a2b46298da7fa9bL209-R223)
* Added `ProofBackend` to the imports in the test module to support the
new test setup.

Author: Victor Castell

Cargo.lock

@@ -178,4 +178,40 @@ impl ProposerDBClient {
             tokio::time::sleep(tokio::time::Duration::from_millis(poll_interval_ms)).await;
         }
     }
+
+    /// Polls the database until the request reaches Complete status.
+    /// Returns the proof bytes once available.
+    pub async fn wait_for_proof_completion(
+        &self,
+        request_id: i64,
+        poll_interval_ms: u64,
+        max_retries: u32,
+    ) -> Result<Vec<u8>, Error> {
+        let mut retries = 0;
+
+        loop {
+            let request = self.get_request_by_id(request_id).await?;
+
+            match request.status {
+                RequestStatus::Failed => return Err(Error::ProofGenerationFailed(request_id)),
+                RequestStatus::Cancelled => {
+                    return Err(Error::ProofGenerationCancelled(request_id))
+                }
+                RequestStatus::Complete | RequestStatus::Relayed => {
+                    if let Some(proof) = request.proof {
+                        return Ok(proof);
+                    }
+                    return Err(Error::ProofNotFound);
+                }
+                // Still in progress (Unrequested, WitnessGeneration, Execution, Prove)
+                _ => {}
+            }
+
+            if retries >= max_retries {
+                return Err(Error::ProofGenerationTimeout(request_id));
+            }
+            retries += 1;
+            tokio::time::sleep(tokio::time::Duration::from_millis(poll_interval_ms)).await;
+        }
+    }
 }

crates/proposer-db-client/src/client.rs

@@ -52,6 +52,9 @@ mockall = { workspace = true, optional = true }
 
 op-succinct-validity.workspace = true
 
+# Ecosystem dependencies
+agglayer-interop-types.workspace = true
+
 [features]
 testutils = ["mockall"]