Migrate balancer v2 sources to alloy (#4023)

# Description

Migrates Balancer V2 sources module from `ethcontract` to `alloy`
primitives, continuing the project-wide modernization
effort. This simplifies the codebase and improves type safety across
pool fetching, pool implementations, and swap math
calculations.

# Changes

- [x] Replace `ethcontract` contract bindings with `alloy` types in pool
fetching
- [x] Add alloy block support to `recent_block_cache.rs`
- [x] Migrate all pool types (Weighted, Stable, Composable Stable, LBP)
to alloy
- [x] Convert swap math modules to use alloy primitives
- [x] Update pool storage, registry, and boundary liquidity handlers
- [x] Remove ethcontract-specific workarounds from `sources/mod.rs`

## How to test
Existing tests

---------

Co-authored-by: Marcin Szymczak <[email protected]>

Author: jmg-duarte

crates/driver/src/boundary/liquidity/balancer/v2/mod.rs

@@ -16,10 +16,7 @@ use {
         BalancerV2WeightedPoolFactory,
         BalancerV2WeightedPoolFactoryV3,
     },
-    ethrpc::{
-        alloy::conversions::IntoLegacy,
-        block_stream::{BlockRetrieving, CurrentBlockWatcher},
-    },
+    ethrpc::block_stream::{BlockRetrieving, CurrentBlockWatcher},
     shared::{
         http_solver::model::TokenAmount,
         sources::balancer_v2::{
@@ -181,12 +178,7 @@ async fn init_liquidity(
             boundary::liquidity::http_client(),
             web3.clone(),
             &contracts,
-            config
-                .pool_deny_list
-                .iter()
-                .copied()
-                .map(IntoLegacy::into_legacy)
-                .collect(),
+            config.pool_deny_list.to_vec(),
         )
         .await
         .context("failed to create balancer pool fetcher")?,

crates/shared/Cargo.toml

@@ -9,7 +9,7 @@ license = "MIT OR Apache-2.0"
 doctest = false
 
 [dependencies]
-alloy = { workspace = true, features = ["sol-types", "signer-local"] }
+alloy = { workspace = true, features = ["sol-types", "signer-local", "rand"] }
 anyhow = { workspace = true }
 app-data = { workspace = true }
 bytes-hex = { workspace = true }

crates/shared/src/arguments.rs

@@ -4,11 +4,7 @@
 use {
     crate::{
         gas_price_estimation::GasEstimatorType,
-        sources::{
-            BaselineSource,
-            balancer_v2::BalancerFactoryKind,
-            uniswap_v2::UniV2BaselineSourceParameters,
-        },
+        sources::{BaselineSource, uniswap_v2::UniV2BaselineSourceParameters},
         tenderly_api,
     },
     alloy::primitives::Address,
@@ -218,12 +214,6 @@ pub struct Arguments {
     #[clap(long, env, action = clap::ArgAction::Set, default_value = "false")]
     pub use_internal_buffers: bool,
 
-    /// The Balancer V2 factories to consider for indexing liquidity. Allows
-    /// specific pool kinds to be disabled via configuration. Will use all
-    /// supported Balancer V2 factory kinds if not specified.
-    #[clap(long, env, value_enum, ignore_case = true, use_value_delimiter = true)]
-    pub balancer_factories: Option<Vec<BalancerFactoryKind>>,
-
     /// Value of the authorization header for the solver competition post api.
     #[clap(long, env)]
     pub solver_competition_auth: Option<String>,
@@ -396,7 +386,6 @@ impl Display for Arguments {
             pool_cache_maximum_retries,
             pool_cache_delay_between_retries,
             use_internal_buffers,
-            balancer_factories,
             solver_competition_auth,
             network_block_interval,
             settlement_contract_address,
@@ -439,7 +428,6 @@ impl Display for Arguments {
             "pool_cache_delay_between_retries: {pool_cache_delay_between_retries:?}"
         )?;
         writeln!(f, "use_internal_buffers: {use_internal_buffers}")?;
-        writeln!(f, "balancer_factories: {balancer_factories:?}")?;
         display_secret_option(
             f,
             "solver_competition_auth",

crates/shared/src/recent_block_cache.rs

@@ -26,6 +26,7 @@
 
 use {
     crate::request_sharing::BoxRequestSharing,
+    alloy::eips::BlockId,
     anyhow::{Context, Result},
     cached::{Cached, SizedCache},
     ethcontract::BlockNumber,
@@ -84,6 +85,16 @@ impl From<Block> for BlockNumber {
     }
 }
 
+impl From<Block> for BlockId {
+    fn from(value: Block) -> Self {
+        match value {
+            Block::Recent => BlockId::latest(),
+            Block::Number(n) => BlockId::number(n),
+            Block::Finalized => BlockId::finalized(),
+        }
+    }
+}
+
 /// Recent block cache for arbitrary key-value pairs.
 ///
 /// Caches on-chain data for a specific number of blocks and automatically

crates/shared/src/sources/balancer_v2/graph_api.rs

@@ -11,9 +11,8 @@
 use {
     super::swap::fixed_point::Bfp,
     crate::{event_handling::MAX_REORG_BLOCK_COUNT, subgraph::SubgraphClient},
-    alloy::primitives::Address,
+    alloy::primitives::{Address, B256},
     anyhow::Result,
-    ethcontract::H256,
     reqwest::{Client, Url},
     serde::Deserialize,
     serde_json::json,
@@ -50,7 +49,7 @@ impl BalancerSubgraphClient {
         let block_number = self.get_safe_block().await?;
 
         let mut pools = Vec::new();
-        let mut last_id = H256::default();
+        let mut last_id = B256::default();
 
         // We do paging by last ID instead of using `skip`. This is the
         // suggested approach to paging best performance:
@@ -148,7 +147,7 @@ impl RegisteredPools {
 #[serde(rename_all = "camelCase")]
 pub struct PoolData {
     pub pool_type: PoolType,
-    pub id: H256,
+    pub id: B256,
     pub address: Address,
     pub factory: Address,
     pub swap_enabled: bool,
@@ -246,7 +245,6 @@ mod tests {
         super::*,
         crate::sources::balancer_v2::swap::fixed_point::Bfp,
         alloy::primitives::U256,
-        ethcontract::H256,
         maplit::hashmap,
     };
 
@@ -336,7 +334,7 @@ mod tests {
                 pools: vec![
                     PoolData {
                         pool_type: PoolType::Weighted,
-                        id: H256([0x11; 32]),
+                        id: B256::repeat_byte(0x11),
                         address: Address::repeat_byte(0x22),
                         factory: Address::repeat_byte(0x55),
                         swap_enabled: true,
@@ -359,7 +357,7 @@ mod tests {
                     },
                     PoolData {
                         pool_type: PoolType::Stable,
-                        id: H256([0x11; 32]),
+                        id: B256::repeat_byte(0x11),
                         address: Address::repeat_byte(0x22),
                         factory: Address::repeat_byte(0x55),
                         swap_enabled: true,
@@ -378,7 +376,7 @@ mod tests {
                     },
                     PoolData {
                         pool_type: PoolType::LiquidityBootstrapping,
-                        id: H256([0x11; 32]),
+                        id: B256::repeat_byte(0x11),
                         address: Address::repeat_byte(0x22),
                         factory: Address::repeat_byte(0x55),
                         swap_enabled: true,
@@ -401,7 +399,7 @@ mod tests {
                     },
                     PoolData {
                         pool_type: PoolType::ComposableStable,
-                        id: H256([0x11; 32]),
+                        id: B256::repeat_byte(0x11),
                         address: Address::repeat_byte(0x22),
                         factory: Address::repeat_byte(0x55),
                         swap_enabled: true,
@@ -447,7 +445,7 @@ mod tests {
     #[test]
     fn groups_pools_by_factory() {
         let pool = |factory: Address, id: u8| PoolData {
-            id: H256([id; 32]),
+            id: B256::repeat_byte(id),
             factory,
             pool_type: PoolType::Weighted,
             address: Default::default(),

crates/shared/src/sources/balancer_v2/mod.rs

@@ -44,6 +44,6 @@ pub mod pools;
 pub mod swap;
 
 pub use self::{
-    pool_fetching::{BalancerFactoryKind, BalancerPoolFetcher, BalancerPoolFetching},
+    pool_fetching::{BalancerPoolFetcher, BalancerPoolFetching},
     pools::{Pool, PoolKind},
 };

crates/shared/src/sources/balancer_v2/pool_fetching/aggregate.rs

@@ -4,8 +4,8 @@
 use {
     super::internal::InternalPoolFetching,
     crate::{recent_block_cache::Block, sources::balancer_v2::pools::Pool},
+    alloy::primitives::B256,
     anyhow::Result,
-    ethcontract::H256,
     futures::future,
     model::TokenPair,
     std::collections::HashSet,
@@ -25,7 +25,7 @@ impl Aggregate {
 
 #[async_trait::async_trait]
 impl InternalPoolFetching for Aggregate {
-    async fn pool_ids_for_token_pairs(&self, token_pairs: HashSet<TokenPair>) -> HashSet<H256> {
+    async fn pool_ids_for_token_pairs(&self, token_pairs: HashSet<TokenPair>) -> HashSet<B256> {
         future::join_all(
             self.fetchers
                 .iter()
@@ -37,7 +37,7 @@ impl InternalPoolFetching for Aggregate {
         .collect()
     }
 
-    async fn pools_by_id(&self, pool_ids: HashSet<H256>, block: Block) -> Result<Vec<Pool>> {
+    async fn pools_by_id(&self, pool_ids: HashSet<B256>, block: Block) -> Result<Vec<Pool>> {
         Ok(future::try_join_all(
             self.fetchers
                 .iter()

crates/shared/src/sources/balancer_v2/pool_fetching/cache.rs

@@ -9,14 +9,14 @@ use {
         recent_block_cache::{Block, CacheConfig, CacheFetching, CacheKey, RecentBlockCache},
         sources::balancer_v2::pools::Pool,
     },
+    alloy::primitives::B256,
     anyhow::Result,
-    ethcontract::H256,
     ethrpc::block_stream::CurrentBlockWatcher,
     std::{collections::HashSet, sync::Arc},
 };
 
 /// Internal type alias used for inner recent block cache.
-type PoolCache<Inner> = RecentBlockCache<H256, Pool, CacheFetcher<Inner>>;
+type PoolCache<Inner> = RecentBlockCache<B256, Pool, CacheFetcher<Inner>>;
 
 /// A cached pool fetcher that wraps an inner `InternalPoolFetching`
 /// implementation.
@@ -52,18 +52,18 @@ where
     async fn pool_ids_for_token_pairs(
         &self,
         token_pairs: HashSet<model::TokenPair>,
-    ) -> HashSet<H256> {
+    ) -> HashSet<B256> {
         self.inner.pool_ids_for_token_pairs(token_pairs).await
     }
 
-    async fn pools_by_id(&self, pool_ids: HashSet<H256>, block: Block) -> Result<Vec<Pool>> {
+    async fn pools_by_id(&self, pool_ids: HashSet<B256>, block: Block) -> Result<Vec<Pool>> {
         self.cache.fetch(pool_ids, block).await
     }
 }
 
-impl CacheKey<Pool> for H256 {
+impl CacheKey<Pool> for B256 {
     fn first_ord() -> Self {
-        H256::zero()
+        B256::ZERO
     }
 
     fn for_value(pool: &Pool) -> Self {
@@ -79,11 +79,11 @@ impl CacheKey<Pool> for H256 {
 struct CacheFetcher<Inner>(Arc<Inner>);
 
 #[async_trait::async_trait]
-impl<Inner> CacheFetching<H256, Pool> for CacheFetcher<Inner>
+impl<Inner> CacheFetching<B256, Pool> for CacheFetcher<Inner>
 where
     Inner: InternalPoolFetching,
 {
-    async fn fetch_values(&self, pool_ids: HashSet<H256>, at_block: Block) -> Result<Vec<Pool>> {
+    async fn fetch_values(&self, pool_ids: HashSet<B256>, at_block: Block) -> Result<Vec<Pool>> {
         self.0.pools_by_id(pool_ids, at_block).await
     }
 }

crates/shared/src/sources/balancer_v2/pool_fetching/internal.rs

@@ -3,8 +3,8 @@
 
 use {
     crate::{recent_block_cache::Block, sources::balancer_v2::pools::Pool},
+    alloy::primitives::B256,
     anyhow::Result,
-    ethcontract::H256,
     model::TokenPair,
     std::collections::HashSet,
 };
@@ -16,8 +16,8 @@ use {
 #[async_trait::async_trait]
 pub trait InternalPoolFetching: Send + Sync + 'static {
     /// Retrives all pool IDs that trade the specified pairs.
-    async fn pool_ids_for_token_pairs(&self, token_pairs: HashSet<TokenPair>) -> HashSet<H256>;
+    async fn pool_ids_for_token_pairs(&self, token_pairs: HashSet<TokenPair>) -> HashSet<B256>;
 
     /// Fetches current pool states for the specified IDs and block.
-    async fn pools_by_id(&self, pool_ids: HashSet<H256>, block: Block) -> Result<Vec<Pool>>;
+    async fn pools_by_id(&self, pool_ids: HashSet<B256>, block: Block) -> Result<Vec<Pool>>;
 }