feat: support ratelimit flags on cast run

cli/src/cmd/cast/run.rs

@@ -71,6 +71,21 @@ pub struct RunArgs {
     /// Overrides the version specified in the config.
     #[clap(long, short)]
     evm_version: Option<EvmVersion>,
+    /// Sets the number of assumed available compute units per second for this provider
+    ///
+    /// default value: 330
+    ///
+    /// See also, https://github.com/alchemyplatform/alchemy-docs/blob/master/documentation/compute-units.md#rate-limits-cups
+    #[clap(long, alias = "cups", value_name = "CUPS")]
+    pub compute_units_per_second: Option<u64>,
+
+    /// Disables rate limiting for this node's provider.
+    ///
+    /// default value: false
+    ///
+    /// See also, https://github.com/alchemyplatform/alchemy-docs/blob/master/documentation/compute-units.md#rate-limits-cups
+    #[clap(long, value_name = "NO_RATE_LIMITS", visible_alias = "no-rpc-rate-limit")]
+    pub no_rate_limit: bool,
 }
 
 impl RunArgs {
@@ -84,7 +99,13 @@ impl RunArgs {
             Config::figment_with_root(find_project_root_path(None).unwrap()).merge(self.rpc);
         let mut evm_opts = figment.extract::<EvmOpts>()?;
         let config = Config::from_provider(figment).sanitized();
-        let provider = utils::get_provider(&config)?;
+
+        let compute_units_per_second =
+            if self.no_rate_limit { Some(u64::MAX) } else { self.compute_units_per_second };
+
+        let provider = utils::get_provider_builder(&config)?
+            .compute_units_per_second_opt(compute_units_per_second)
+            .build()?;
 
         let tx_hash = self.tx_hash.parse().wrap_err("invalid tx hash")?;
         let tx = provider

cli/src/utils.rs

@@ -93,9 +93,16 @@ pub fn parse_u256(s: &str) -> Result<U256> {
 ///
 /// Defaults to `http://localhost:8545` and `Mainnet`.
 pub fn get_provider(config: &Config) -> Result<foundry_common::RetryProvider> {
+    get_provider_builder(config)?.build()
+}
+/// Returns a [ProviderBuilder](foundry_common::ProviderBuilder) instantiated using [Config]'s RPC
+/// URL and chain.
+///
+/// Defaults to `http://localhost:8545` and `Mainnet`.
+pub fn get_provider_builder(config: &Config) -> Result<foundry_common::ProviderBuilder> {
     let url = config.get_rpc_url_or_localhost_http()?;
     let chain = config.chain_id.unwrap_or_default();
-    foundry_common::ProviderBuilder::new(url.as_ref()).chain(chain).build()
+    Ok(foundry_common::ProviderBuilder::new(url.as_ref()).chain(chain))
 }
 
 pub async fn get_chain<M>(chain: Option<Chain>, provider: M) -> Result<Chain>

common/src/provider.rs

@@ -124,6 +124,16 @@ impl ProviderBuilder {
         self
     }
 
+    /// Sets the number of assumed available compute units per second
+    ///
+    /// See also, <https://github.com/alchemyplatform/alchemy-docs/blob/master/documentation/compute-units.md#rate-limits-cups>
+    pub fn compute_units_per_second_opt(mut self, compute_units_per_second: Option<u64>) -> Self {
+        if let Some(cups) = compute_units_per_second {
+            self.compute_units_per_second = cups;
+        }
+        self
+    }
+
     /// Sets aggressive `max_retry` and `initial_backoff` values
     ///
     /// This is only recommend for local dev nodes