feat(cast): support base + offset for storage slot calc (#11566)

Closes #11531

Author: 0xferrous

crates/cast/src/cmd/storage.rs

@@ -49,7 +49,11 @@ pub struct StorageArgs {
 
     /// The storage slot number. If not provided, it gets the full storage layout.
     #[arg(value_parser = parse_slot)]
-    slot: Option<B256>,
+    base_slot: Option<B256>,
+
+    /// The storage offset from the base slot. If not provided, it is assumed to be zero.
+    #[arg(value_parser = str::parse::<U256>, default_value_t = U256::ZERO)]
+    offset: U256,
 
     /// The known proxy address. If provided, the storage layout is retrieved from this address.
     #[arg(long,value_parser = NameOrAddress::from_str)]
@@ -91,14 +95,22 @@ impl StorageArgs {
     pub async fn run(self) -> Result<()> {
         let config = self.load_config()?;
 
-        let Self { address, slot, block, build, .. } = self;
+        let Self { address, base_slot, offset, block, build, .. } = self;
         let provider = utils::get_provider(&config)?;
         let address = address.resolve(&provider).await?;
 
         // Slot was provided, perform a simple RPC call
-        if let Some(slot) = slot {
+        if let Some(slot) = base_slot {
             let cast = Cast::new(provider);
-            sh_println!("{}", cast.storage(address, slot, block).await?)?;
+            sh_println!(
+                "{}",
+                cast.storage(
+                    address,
+                    (Into::<U256>::into(slot).saturating_add(offset)).into(),
+                    block
+                )
+                .await?
+            )?;
             return Ok(());
         }
 

crates/cast/tests/cli/main.rs

@@ -1906,6 +1906,40 @@ casttest!(storage, |_prj, cmd| {
         .stdout_eq(str![[r#"
 0x000000000000000000000000000000000000000000000000000000174876e800
 
+"#]]);
+
+    let decimal_slot_offset_from_total_supply_slot = "0x08";
+    let decimal_slot_offset_from_total_supply_slot_uint = "8";
+    let rpc = next_http_archive_rpc_url();
+    cmd.cast_fuse()
+        .args([
+            "storage",
+            usdt,
+            total_supply_slot,
+            decimal_slot_offset_from_total_supply_slot,
+            "--rpc-url",
+            &rpc,
+        ])
+        .assert_success()
+        .stdout_eq(str![[r#"
+0x0000000000000000000000000000000000000000000000000000000000000006
+
+"#]]);
+
+    let rpc = next_http_archive_rpc_url();
+    cmd.cast_fuse()
+        .args([
+            "storage",
+            usdt,
+            total_supply_slot,
+            decimal_slot_offset_from_total_supply_slot_uint,
+            "--rpc-url",
+            &rpc,
+        ])
+        .assert_success()
+        .stdout_eq(str![[r#"
+0x0000000000000000000000000000000000000000000000000000000000000006
+
 "#]]);
 });