Add TIP20 Extension to frxUSDOFTUpgradeable by dhruvinparikh · Pull Request #126 · FraxFinance/frax-oft-upgradeable

dhruvinparikh · 2025-12-10T21:07:34Z

This PR extends functionality of frxUSDOFTUpgradeable.

TIP20 is native token standard for stablecoin on tempo

Refer : https://docs.tempo.xyz/protocol/tip20/overview

contracts/modules/tempo/TIP20Module.sol

dhruvinparikh · 2025-12-16T19:37:15Z

UPDATE: As per discussion with Tempo team, the only way to deploy TIP20 compliant frxUSD is via TIP20 factory pre-compile else

token wouldn't be able to be used for gas fees
couldn't be traded on the stablecoin DEX
couldn't use the payment lane, etc

by the way TIP20 is not a standard but a pre-compile as per Tempo. We would still require Adapter similar to FraxOFTMintableAdapterUpgradeable

contracts/modules/tempo/TIP20Module.sol

- Deploy TIP20 token via factory in deployment script - Add FrxUSDPolicyAdminTempo for freeze/thaw management - Swap innerToken to PATH_USD in _lzSend when user pays fees in innerToken - Use tempo-std ITIP403Registry instead of local interface

- add TempoTestHelpers.sol with TIP20 creation and DEX utilities - update adapter to support any TIP20 for gas fees - refactor FraxOFTMintableAdapterUpgradeableTIP20Test - refactor FrxUSDPolicyAdminTempoTest - refactor StablecoinExchangePOCTest

- Add Tempo testnet deployment scripts for frxUSD - Add FraxOFTMintableAdapterUpgradeableTIP20 for TIP20 token bridging - Add FrxUSDPolicyAdminTempo for TIP-403 freeze/thaw management - Add DEX liquidity helper for gas token swaps - Add tempo-specs README documentation - Remove deprecated FrxUSDOFTTIP20Upgradeable (using adapter pattern instead) - Remove TIP20Module and TIP20RolesAuthUpgradeable (using tempo-std) - Update foundry.toml src path

- Override _payNative to handle TIP20 gas tokens on Tempo - Swap user's TIP20 gas token to PATH_USD via StablecoinDEX - Transfer PATH_USD to endpoint (EndpointV2Alt uses ERC20 balance as native) - Add comprehensive tests for swap flow with event/state assertions - Add MockLzEndpoint simulating EndpointV2Alt behavior

- Add recoverERC20 with onlyOwner access control and RecoveredERC20 event - Add IERC20 and SafeERC20 imports - Add tests: recover() callable by anyone, recoverERC20 onlyOwner - Add event assertions for token transfers, burns, and DEX swaps - Optimize _payNative to transfer PATH_USD directly to endpoint

…-chain OFT tests; remove old test, rename new test, ensure all contracts and tests pass

pegahcarter · 2026-01-21T17:52:25Z

contracts/FraxOFTUpgradeableTempo.sol

Should we also add the _userTokenAmount calculation to a view to support gas cost estimations? How do you think we should approach quotes on gas spent before sends?

Overriding quoteSend() can serve as a view for _userTokenAmount calculations

- Add _quote override to FraxOFTUpgradeableTempo and FraxOFTMintableAdapterUpgradeableTIP20 - Query endpoint.nativeToken() dynamically instead of hardcoding PATH_USD - Add IEndpointV2Alt interface with nativeToken() function - Add _endpointNativeToken() helper for caching endpoint native token - Convert fees from endpoint native token to user's TIP20 gas token via DEX quote - Add quoteSend tests for fee conversion scenarios - Update TempoTestHelpers to use ITIP20Factory with salt parameter - Add mock quote() function to LZ test endpoints

- Override send() in FraxOFTMintableAdapterUpgradeableTIP20 and FraxOFTUpgradeableTempo - Revert with OFTAltCore__msg_value_not_zero when msg.value > 0 (security check) - EndpointV2Alt uses ERC20 for gas, not native ETH - Add tests for send() revert on msg.value and success with valid receipts

- Add ILZEndpointDollar interface (wrap, unwrap, isWhitelistedToken, decimals) - Update FraxOFTMintableAdapterUpgradeableTIP20 and FraxOFTUpgradeableTempo: - Change nativeToken from address to ILZEndpointDollar - Add UnsupportedGasToken error - Update _quote and _payNative with whitelist logic: - If userToken is whitelisted -> wrap directly - If PATH_USD is whitelisted -> swap to PATH_USD, then wrap - Otherwise revert - Update test mocks with MockLZEndpointDollar for wrapping - Update test assertions to check LZEndpointDollar balance at endpoint - Delete unused ITIP20Factory interface

…oadcasts

- Add chain IDs 143, 988, 4217 to SendMockFrax destinations - Add Tempo Fraxtal (pathUSD) LZ scan link to README - Include SetupMockFrax and SendMockFrax broadcast artifacts for chain 252

…into feat/frxusd-tip20

- _quote() no longer converts fee to user-token units (was causing double-conversion in _payNative) - fee.nativeFee stays in LZEndpointDollar units throughout the flow - added quoteUserTokenFee() view for UIs to get cost in user's gas token - replaced hardcoded PATH_USD with dynamic _findSwapTarget() across all whitelisted tokens - added getWhitelistedTokens() to ILZEndpointDollar interface - fixed missing approve before wrap in whitelisted path (Tempo OFT) - updated tests and mocks (32/32 pass)

…early return on zero fee - Extract shared ERC20 gas payment logic into TempoAltTokenBase abstract base - Add _resolveUserToken() with PATH_USD fallback (mirrors FeeManager cascading) - Add _findSwapTarget() for dynamic whitelisted token selection - Add quoteUserTokenFee(address, uint256) for off-chain fee estimation - Add _validateQuoteSwapPath() for swap path validation in _quote() - Add early return in _payNativeAltToken when _nativeFee == 0 - Refactor FraxOFTUpgradeableTempo and FraxOFTMintableAdapterUpgradeableTIP20 to use base - Update tests for new signatures and base contract error selectors

- Remove broadcastAs(oftDeployerPK) and broadcastAs(configDeployerPK) modifiers - Add GCS_DEPLOYER constant (0x54F9b12743A7DeeC0ea48721683cbebedC6E17bC) - Replace vm.addr(configDeployerPK) and vm.addr(oftDeployerPK) with msg.sender - Add vm.startBroadcast()/vm.stopBroadcast() in deploy and setup functions - Add require(msg.sender == GCS_DEPLOYER) check after proxyAdmin deploy - Update CREATE2 salt generation to use msg.sender / GCS_DEPLOYER

…imited approveToken

- Remove Mock FPI deploy+pop block from DeployFraxOFTProtocol (historical nonce artifact unnecessary with CREATE2) - Remove deployFraxOFTUpgradeablesAndProxies() override from Tempo script (parent now correct) - Simplify postDeployChecks() override to only skip wallet assertion - Make postDeployChecks() virtual in DeployFraxOFTFraxtalHub

- Add SetupSourceFraxOFTFraxtalHubTempo with broadcastAs override (GCP KMS) and _validateFrxUsdAddr override (OFTAdapter-based frxUSD) - Extract _validateFrxUsdAddr() virtual hook in SetupSourceFraxOFTFraxtalHub - Make broadcastAs modifier virtual in BaseL0Script - Register Tempo chain (4217) in L0Constants with 6 OFT proxy addresses - Update L0Config.json proxyAdmin for Tempo - Include deploy and setup broadcast artifacts (49 setup txs on chain 4217)

- SendFraxOFTFraxtalToTempo: bridge 6 OFTs from Fraxtal to Tempo (eid 30410) - SendFraxOFTTempoToFraxtal: bridge 6 OFTs from Tempo back to Fraxtal with ERC20 gas - Update SendFraxOFTFraxtalHub: add Tempo chain ID + RPC env var resolution - Skip precompile validation for Tempo (Foundry cannot simulate TIP20 precompiles)

…caling - Route through FraxOFTWalletUpgradeableTempo.batchBridgeWithTIP20FeeFromWallet() instead of sending directly from deployer (which had no token balance) - Extract virtual _executeBatchBridge() hook in parent for Tempo override - Extract virtual _getsendParamsForfrxUSD() hook for 18->6 decimal scaling - Fix pass-by-reference bug: return new SendParam struct to avoid mutating the shared _sendParam used by all 6 OFTs - Approve wallet for PATH_USD gas token per OFT and frxUSD TIP20 spending - Add broadcast artifacts from successful dry-run

(chore): init frxusdoft tip20 extension

e60e3e0

dhruvinparikh marked this pull request as draft December 10, 2025 21:40

dhruvinparikh added 3 commits December 11, 2025 14:07

(chore): refactor in same contract

2beea77

(chore): remove ERC20 from TIP20

e0c01f4

(chore): monolithic to modular

b472736

pegahcarter reviewed Dec 16, 2025

View reviewed changes

contracts/modules/tempo/TIP20Module.sol Outdated Show resolved Hide resolved

(chore): init FrxOFTMintableAdapterUpgradeableTIP20

8e02f6a

pegahcarter reviewed Dec 16, 2025

View reviewed changes

contracts/modules/tempo/TIP20Module.sol Outdated Show resolved Hide resolved

pegahcarter reviewed Dec 16, 2025

View reviewed changes

contracts/modules/tempo/TIP20Module.sol Outdated Show resolved Hide resolved

dhruvinparikh added 12 commits December 16, 2025 20:15

(chore): add L0Config for tempo and other testnet

50c74d4

(chore): add testnet dvn addresses

1e43218

(chore): deploy frxUSD on tempo testnet

02ede4a

(chore): add tip20 deploy script

44b4e46

Merge branch 'master' into feat/frxusd-tip20

bb9c06a

test: add FrxUSDPolicyAdminTempo unit tests and documentation

e797d20

refactor: simplify recovery and remove redundant event assertions

94683e0

pegahcarter approved these changes Jan 16, 2026

View reviewed changes

feat: OZ4-compatible LayerZero endpoint test helpers and robust cross…

1006358

…-chain OFT tests; remove old test, rename new test, ensure all contracts and tests pass

dhruvinparikh marked this pull request as ready for review January 20, 2026 20:48

Align Tempo/Sepolia hub setup and docs with 0x8Ee7 adapter

3803ee5

pegahcarter reviewed Jan 21, 2026

View reviewed changes

dhruvinparikh added 3 commits January 27, 2026 20:08

dhruvinparikh added 17 commits February 16, 2026 23:09

chore: update Tempo DVN addresses and multisig safe URL

9ef472c

chore: refactor DVN test scripts and add Tempo MockFrax deployment br…

bdf458f

…oadcasts

chore: add Tempo MockFrax deployment broadcasts and script updates

021d0e2

Setup MockFrax on Tempo mainnet

18cf42f

chore: SendMockFrax to Tempo and update broadcasts

a09d9eb

- Add chain IDs 143, 988, 4217 to SendMockFrax destinations - Add Tempo Fraxtal (pathUSD) LZ scan link to README - Include SetupMockFrax and SendMockFrax broadcast artifacts for chain 252

Add lzReceive test scripts and update README

2d3586e

Send mock FRAX from Fraxtal to Tempo

af9f100

Add setUserToken to TIP20 wallet, decimal-aware send amounts

f3822b3

Merge remote-tracking branch 'refs/remotes/origin/feat/frxusd-tip20' …

fb1fbc8

…into feat/frxusd-tip20

feat: use Nick's CREATE2 for deterministic deployments

a40c7fc

feat: deploy mockfrxUSD TIP20 on tempo (broadcast artifacts)

f8b1cb4

(ref): correct symbol

5f49b17

feat: add SetupMockfrxUSD script for Fraxtal<>Tempo wiring

8ac33df

Set Tempo enforced options 300k/350k, add mock frxUSD scripts

08af8e5

feat: fix TIP20 approval, console.log bytes32, deploy artifacts

181a03a

pegahcarter approved these changes Feb 24, 2026

View reviewed changes

dhruvinparikh added 12 commits February 24, 2026 04:50

Update SendMockfrxUSD broadcast logs

5a5a140

fix: wallet uses caller gas token, remove per-call approvals, use unl…

5c68545

…imited approveToken

Merge branch 'master' into feat/frxusd-tip20

88a9146

Add Tempo destination setup script and Safe batch JSONs

db2c005

chore: add SendFraxOFTFraxtalToTempo broadcast artifacts

98e8de3

feat: successful batch bridge Tempo→Fraxtal with frxUSD TIP20 fee token

de9f494

docs: add Tempo OFT addresses to README

20b6ab4

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add TIP20 Extension to frxUSDOFTUpgradeable#126

Add TIP20 Extension to frxUSDOFTUpgradeable#126
dhruvinparikh wants to merge 61 commits intoFraxFinance:masterfrom
dhruvinparikh:feat/frxusd-tip20

dhruvinparikh commented Dec 10, 2025

Uh oh!

Uh oh!

dhruvinparikh commented Dec 16, 2025

Uh oh!

Uh oh!

Uh oh!

pegahcarter Jan 21, 2026

Uh oh!

dhruvinparikh Jan 23, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

dhruvinparikh commented Dec 10, 2025

Uh oh!

Uh oh!

dhruvinparikh commented Dec 16, 2025

Uh oh!

Uh oh!

Uh oh!

pegahcarter Jan 21, 2026

Choose a reason for hiding this comment

Uh oh!

dhruvinparikh Jan 23, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants