feat: transaction timeout

[matthewwalsh0]

Explanation

Automatically fail pending transactions if no receipt and hash is not recognised by network after multiple attempts.

Threshold is defined in new feature flag, supporting chain specific and default values.

Ignores transactions with future nonce or if new optional isTimeoutEnabled callback returns false.

References

Related to #23563

Checklist

• I've updated the test suite for new or updated code as appropriate
• I've updated documentation (JSDoc, Markdown, etc.) for new or updated code as appropriate
• I've communicated my changes to consumers by updating changelogs for packages I've changed
• I've introduced breaking changes in this PR and have prepared draft pull requests for clients and consumer packages to resolve them

---

Note

Automatically fails pending transactions with no receipt and not found on-network after a feature-flagged number of attempts, with per-transaction opt-out.

• Pending Transaction Handling:
  • Add timeout logic in helpers/PendingTransactionTracker.ts to fail transactions lacking a receipt and absent from the network (getTransactionByHash) after getTimeoutAttempts threshold.
    • Skips when nonce is in the future; resets counter if transaction later appears; emits failure with Transaction not found on network after timeout.
    • Uses new isTimeoutEnabled hook; tracks attempts per hash; leverages messenger feature flags.
  • Integrate into TransactionController by adding hooks.isTimeoutEnabled and passing it to PendingTransactionTracker.
• Feature Flags:
  • Add getTimeoutAttempts in utils/feature-flags.ts (per-chain and default support).
• Tests:
  • Update PendingTransactionTracker.test.ts to mock specific RPC calls and cover timeout paths, counter reset, and edge cases.
  • Add tests for getTimeoutAttempts in utils/feature-flags.test.ts.
• Docs/Changelog:
  • Update CHANGELOG.md with the new auto-fail behavior and configuration details.

^{Written by Cursor Bugbot for commit 2efcfba. This will update automatically on new commits. Configure here.}