Feat: Wrapped M bridging

[0xIryna]

Motivation

Provide the ability to bridge both official M^0 Wrapped M token and generic M token extensions using M Portal by unwrapping tokens on the source, bridging M and wrapping them back on the destination. The proposed solution allows flexible bridging and wrapping. E.g., from M to Wrapped M, from M Extension to M, etc.

Proposed changes

• add a mapping to store addresses of $M token on the remote chain. It will be used to determine the destination $M address when INttManager.transfer function is called. The mapping can be updated only by the owner.
• add a mapping to store the supported bridging paths between local and remote chains. The mapping can be updated only by the owner.
• add transferMLikeToken function to transfer a generic M like token by specifying source and destination token addresses. Under the hood, if the source token is Wrapped M token, it's unwrapped to M token, M token is bridged and wrapped back on the destination if needed.
• extend Token Transfer additional payload to include the address of destination M token.
• modify _receiveMToken to handle M Token wrapping on the destination. If wrapping fails, M token is transferred to the recipient.

Challenges

Due to the current Wormhole NTT design it's not possible to utilize NTTManager functions for transferring Wrapped tokens. We decided to fork Wormhole's native-transfer-tokens repo and make _transferEntryPoint functions virtual to reduce code duplication and prevent Yul stack too deep issues.

Next Steps:

• consider leaving extra $M token in Portal contracts to prevent rounding issues when $M is transferred between non-earning users and earning Portal

[github-actions]

LCOV of commit f7fef0b during Forge Coverage #176

Summary coverage rate:
  lines......: 84.8% (284 of 335 lines)
  functions..: 78.0% (64 of 82 functions)
  branches...: 73.7% (28 of 38 branches)

Files changed coverage rate:
                                 |Lines       |Functions  |Branches    
  Filename                       |Rate     Num|Rate    Num|Rate     Num
  =====================================================================
  src/HubPortal.sol              |23.1%     39| 0.0%     9|    -      0
  src/Portal.sol                 |22.5%     89| 106%    18|    -      0
  src/SpokePortal.sol            |20.0%     35| 143%     7|    -      0
  src/SpokeVault.sol             |16.7%     24| 0.0%     4|    -      0
  src/governance/Configurator.sol|    -      0|    -     0|    -      0
  src/governance/Migrator.sol    |    -      0|    -     0|    -      0
  src/libs/PayloadEncoder.sol    |21.3%     47| 0.0%    10|    -      0
  src/libs/SafeCall.sol          |33.3%      3| 0.0%     1|    -      0