fix(prepare-transactions): add throwOnSpendTokenAmountExceedsBalance option

[jeanregisser]

Description

I realized a bit too late that the changes in #4432 broke the swap flow where we want to prepare transactions when the spend amount is greater than the balance.
This is because we want users to be able to try any amount to see the quote (and associated fee).

Test plan

• Updated tests

Related issues

• N/A

Backwards compatibility

Yes

[codecov]

Codecov Report

Merging #4442 (b2f2471) into main (b31dfd0) will increase coverage by 0.00%.
The diff coverage is 100.00%.

@@           Coverage Diff           @@
##             main    #4442   +/-   ##
=======================================
  Coverage   85.08%   85.08%           
=======================================
  Files         711      711           
  Lines       26386    26389    +3     
  Branches     3574     3577    +3     
=======================================
+ Hits        22450    22453    +3     
  Misses       3873     3873           
  Partials       63       63           

Files	Coverage Δ
src/swap/useSwapQuote.ts	92.40% <ø> (ø)
src/viem/prepareTransactions.ts	100.00% <100.00%> (ø)

---

Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update b31dfd0...b2f2471. Read the comment docs.

[cajubelt]

to avoid the code smell of a boolean parameter, another way of doing this would be to throw a specific error type and swallow that error type in useSwapQuote

[jeanregisser]

to avoid the code smell of a boolean parameter, another way of doing this would be to throw a specific error type and swallow that error type in useSwapQuote

Yes, here at least I could go with a named option, not the worst, though in general yes I agree we should avoid them.
I thought about exposing another function like prepareTransactionsWithoutCheckingSpendBalance or something. But preferred the option for now. Can revisit later of course.