fix(cli-wallet): peek claim stack instead of popping for estimate-gas-only (#22196)

## Summary

When running any CLI wallet command with `--estimate-gas-only` and a
saved fee juice claim (`--payment method=fee_juice,claim=true`), the
wallet would pop the claim off the stack, consuming it. This meant the
claim was no longer available for the actual transaction.

This PR adds a `peekBridgedFeeJuice` method to `WalletDB` that reads the
top of the claim stack without removing it, and uses it when
`estimateOnly` is true.

## Changes

- Added `peekBridgedFeeJuice()` to `WalletDB` — reads top-of-stack
without decrementing the pointer
- Threaded `estimateOnly` flag through to `parsePaymentMethod()` to
select peek vs pop

## Test plan

- Run `deploy-account --estimate-gas-only --payment
method=fee_juice,claim=true` — claim should still be available after
- Run `deploy-account --payment method=fee_juice,claim=true` — claim
should be consumed as before

ClaudeBox log: https://claudebox.work/s/16b824b54402040d?run=1

Author: Thunkar

yarn-project/cli-wallet/src/storage/wallet_db.ts

@@ -70,6 +70,20 @@ export class WalletDB {
     return { amount: BigInt(amountStr), secret: secretStr, leafIndex: BigInt(leafIndexStr) };
   }
 
+  async peekBridgedFeeJuice(recipient: AztecAddress, log: LogFn) {
+    const stackPointer =
+      (await this.#bridgedFeeJuice.getAsync(`${recipient.toString()}:stackPointer`))?.readInt8() || 0;
+    const result = await this.#bridgedFeeJuice.getAsync(`${recipient.toString()}:${stackPointer}`);
+    if (!result) {
+      throw new Error(
+        `No stored fee juice available for recipient ${recipient.toString()}. Please provide claim amount and secret. Stack pointer ${stackPointer}`,
+      );
+    }
+    const [amountStr, secretStr, leafIndexStr] = result.toString().split(':');
+    log(`Peeked ${amountStr} fee juice for recipient ${recipient.toString()}. Stack pointer ${stackPointer}`);
+    return { amount: BigInt(amountStr), secret: secretStr, leafIndex: BigInt(leafIndexStr) };
+  }
+
   async storeAccount(
     address: AztecAddress,
     {

yarn-project/cli-wallet/src/utils/options/fees.ts

@@ -115,6 +115,7 @@ export function parsePaymentMethod(
   payment: string,
   log: LogFn,
   db?: WalletDB,
+  estimateOnly?: boolean,
 ): (wallet: Wallet, from: AztecAddress, gasSettings: GasSettings) => Promise<FeePaymentMethod | undefined> {
   const parsed = payment.split(',').reduce(
     (acc, item) => {
@@ -149,7 +150,7 @@ export function parsePaymentMethod(
               amount: claimAmount,
               secret: claimSecret,
               leafIndex: messageLeafIndex,
-            } = await db.popBridgedFeeJuice(from, log));
+            } = estimateOnly ? await db.peekBridgedFeeJuice(from, log) : await db.popBridgedFeeJuice(from, log));
           } else {
             ({ claimAmount, claimSecret, messageLeafIndex } = parsed);
           }
@@ -266,9 +267,10 @@ export class CLIFeeArgs {
   }
 
   static parse(args: RawCliFeeArgs, log: LogFn, db?: WalletDB): CLIFeeArgs {
+    const estimateOnly = !!args.estimateGasOnly;
     return new CLIFeeArgs(
-      !!args.estimateGasOnly,
-      parsePaymentMethod(args.payment ?? 'method=fee_juice', log, db),
+      estimateOnly,
+      parsePaymentMethod(args.payment ?? 'method=fee_juice', log, db, estimateOnly),
       parseGasSettings(args),
     );
   }