Add vmResourceUsage method to TransactionBuilder

[mainnet-pat]

Resolves #343

The call outputs an array of AuthenticationProgramStateResourceLimits['metrics'] objects for contracts and undefined for other input types.

If called with verbose set, it will also output a summary table to the console:

┌─────────┬─────────────────────────────────────────────────┬─────┬──────────────┬───────────┬────────┐
│ (index) │ Contract - Function                             │ Ops │ OpCost       │ SigChecks │ Hashes │
├─────────┼─────────────────────────────────────────────────┼─────┼──────────────┼───────────┼────────┤
│ 0       │ 'SingleFunction - test_require_single_function' │ 7   │ '1155/36000' │ '0/1'     │ '2/22' │
│ 1       │ 'ZeroHandling - test_zero_handling'             │ 13  │ '1760/40800' │ '0/1'     │ '2/25' │
│ 2       │ 'P2PKH'                                         │ 0   │ ''           │ ''        │ ''     │
└─────────┴─────────────────────────────────────────────────┴─────┴──────────────┴───────────┴────────┘

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
cashscript	Ready	Preview	Comment	Sep 23, 2025 9:56am

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.43%. Comparing base (fa26642) to head (57cc439).

Additional details and impacted files

@@           Coverage Diff            @@
##           master     #354    +/-   ##
========================================
  Coverage   97.42%   97.43%            
========================================
  Files          78       78            
  Lines       17962    18004    +42     
  Branches      891     1313   +422     
========================================
+ Hits        17500    17542    +42     
+ Misses        462      460     -2     
- Partials        0        2     +2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[rkalis]

Thanks for the contribution. We made a few small changes, and we'll merge the PR now! 🫡