feat: add support for ERC-3009

[pali101]

Summary

Adds ERC-3009 deposit flows, event extensions, and tests.

Changes

• Introduce IERC3009.
• Payments
  • Add AuthType enum; extend DepositRecorded(token, from, to, amount, authType, nonce).
  • Generalize self-recipient check: PermitRecipientMustBeMsgSender → SignerMustBeMsgSender; validatePermitRecipient → validateSignerIsRecipient.
  • New methods: depositWithAuthorization(...), depositWithAuthorizationAndApproveOperator(...), depositWithAuthorizationAndIncreaseOperatorApproval(...)
• Tests
  • Comprehensive coverage for happy path, replay, signature errors, time windows, sender mismatch, insufficient balance, domain mismatch.
• Mock
  • MockERC20: implements ERC-3009.

Notes

• authorizationState used for replay protection
• domain separation enforced by signatures.

Closes #205

[Copilot]

Pull Request Overview

This PR adds support for ERC-3009 deposit flows to the Payments contract, enabling meta-transactions and gasless deposits using cryptographic signatures. ERC-3009 provides an alternative to ERC-2612 permits by allowing transfers to be authorized via signatures without requiring on-chain approvals.

• Introduces IERC3009 interface and three new deposit methods leveraging authorization signatures
• Generalizes signature-based validation by renaming permit-specific error and modifier names
• Extends the DepositRecorded event to include authorization type and nonce for better tracking

Reviewed Changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
test/mocks/MockERC20.sol	Implements ERC-3009 functionality with transferWithAuthorization and receiveWithAuthorization methods
test/helpers/PaymentsTestHelpers.sol	Adds helper functions for ERC-3009 signature generation and test scenarios
test/PaymentsEvents.t.sol	Updates event emission tests to include new AuthType and nonce parameters
test/DepositWithAuthorizationAndOperatorApproval.t.sol	Comprehensive test coverage for ERC-3009 deposit flows with operator approval
test/DepositWithAuthorization.t.sol	Test coverage for basic ERC-3009 deposit functionality
src/Payments.sol	Core implementation of ERC-3009 deposit methods and interface definition
src/Errors.sol	Generalizes error naming from permit-specific to signature-based validation

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[codecov]

Codecov Report

❌ Patch coverage is 91.66667% with 2 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/Payments.sol	91.66%	2 Missing ⚠️

@@           Coverage Diff           @@
##             main     #214   +/-   ##
=======================================
  Coverage        ?   81.25%           
=======================================
  Files           ?        2           
  Lines           ?      480           
  Branches        ?      100           
=======================================
  Hits            ?      390           
  Misses          ?       84           
  Partials        ?        6           

Flag	Coverage Δ
foundry	81.25% <91.66%> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
src/Payments.sol	81.87% <91.66%> (ø)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[wjmelements]

IERC3009 token

[wjmelements]

I wonder why your merge looks like this

Normally Github only shows the merge commit, not all of the commits in the other branch. Example How did you merge main in git?

[rjan90]

@pali101 It seems like there is only three small nits that you need to address here, before we can merge this PR 🙏