Add OUSD V3 and OETHb migration contracts

[shahthepro]

Summary

OUSD V3 cross-chain strategy pair (Master/Remote) with bridge-agnostic adapter family (CCIP, CCTP V2, Superbridge), plus Sepolia ⇄ Base Sepolia testnet harness. Foundation for OETHb Phase 1 migration and future OUSD V3 L2 deployment rollouts.

Changes

• Master + Remote strategies with separated yield channel (nonce-gated) and bridge channel (nonceless, replay-protected).
• Adapters (CCIPAdapter, CCTPAdapter, SuperbridgeAdapter) on a shared AbstractAdapter base — multi-tenant whitelist, per-lane config, governor-settable maxTransferAmount cap.
• CREATE3 proxies (BridgeAdapterProxy, CrossChainStrategyProxy) so paired chains share addresses (required for the transportSender == address(this) peer-parity check).
• CCTPAdapter.relay() manually parses CCTP V2 burn body (works on V2.0 and V2.1, doesn't depend on V2.1-only auto-callback).
• Sepolia + Base Sepolia network registration end-to-end (hardhat.config.js, helpers, addresses, scripts, fork-test.sh). Testnet deploy scripts with mock vault/token.
• Production OETHb deploys (deploy/base/100-104_*, deploy/mainnet/210-211_*) with CREATE3 adapter proxies.
• FLOWS.md (sequence diagrams)

[codecov]

Codecov Report

❌ Patch coverage is 80.25852% with 168 lines in your changes missing coverage. Please review.
✅ Project coverage is 52.98%. Comparing base (2e58be9) to head (3cf586e).
⚠️ Report is 1 commits behind head on master.

Files with missing lines	Patch %	Lines
...racts/strategies/BridgedWOETHMigrationStrategy.sol	0.00%	48 Missing ⚠️
...egies/crosschainV3/adapters/SuperbridgeAdapter.sol	55.22%	30 Missing ⚠️
...gies/crosschainV3/AbstractCrossChainV3Strategy.sol	76.19%	20 Missing ⚠️
...s/strategies/crosschainV3/adapters/CCIPAdapter.sol	45.45%	18 Missing ⚠️
...rategies/crosschainV3/adapters/AbstractAdapter.sol	83.67%	16 Missing ⚠️
.../strategies/crosschainV3/MasterWOTokenStrategy.sol	95.06%	8 Missing ⚠️
...ategies/crosschainV3/libraries/NativeFeeHelper.sol	0.00%	8 Missing ⚠️
contracts/contracts/utils/BytesHelper.sol	0.00%	8 Missing ⚠️
...s/strategies/crosschainV3/adapters/CCTPAdapter.sol	92.59%	6 Missing ⚠️
...trategies/crosschainV3/AbstractWOTokenStrategy.sol	92.42%	5 Missing ⚠️
... and 1 more

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #2909      +/-   ##
==========================================
+ Coverage   50.83%   52.98%   +2.15%     
==========================================
  Files         110      124      +14     
  Lines        4873     5724     +851     
  Branches     1353     1616     +263     
==========================================
+ Hits         2477     3033     +556     
- Misses       2392     2687     +295     
  Partials        4        4              

☔ View full report in Codecov by Harness.
📢 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.