feat: bridges, PMM, flash workflow, token-aggregation, and deployment docs

- CCIP/trustless bridge contracts, GRU tokens, DEX/PMM tests, reserve vault.
- Token-aggregation service routes, planner, chain config, relay env templates.
- Config snapshots and multi-chain deployment markdown updates.
- gitignore services/btc-intake/dist/ (tsc output); do not track dist.

Run forge build && forge test before deploy (large solc graph).

Made-with: Cursor
This commit is contained in:
defiQUG
2026-04-07 23:40:52 -07:00
parent 0fb7bba07b
commit 76aa419320
289 changed files with 28367 additions and 824 deletions

View File

@@ -1,17 +1,36 @@
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.19;
import {Test, console} from "forge-std/Test.sol";
import {Test} from "forge-std/Test.sol";
import "../../contracts/dex/DODOPMMIntegration.sol";
import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
contract MockERC20 is ERC20 {
constructor(string memory name, string memory symbol) ERC20(name, symbol) {
_mint(msg.sender, 1000000 ether);
_mint(msg.sender, 1_000_000 ether);
}
}
contract MockDodoPool {
contract MockPoolFactory {
address public nextPool;
function setNextPool(address pool) external {
nextPool = pool;
}
function createDVM(
address,
address,
uint256,
uint256,
uint256,
bool
) external view returns (address dvm) {
return nextPool;
}
}
contract MockBasicDodoPool {
address public immutable baseToken;
address public immutable quoteToken;
@@ -27,11 +46,75 @@ contract MockDodoPool {
function _QUOTE_TOKEN_() external view returns (address) {
return quoteToken;
}
function getVaultReserve() external pure returns (uint256, uint256) {
return (1_000_000, 1_000_000);
}
function getMidPrice() external pure returns (uint256) {
return 1e18;
}
function _QUOTE_RESERVE_() external pure returns (uint256) {
return 1_000_000;
}
function _BASE_RESERVE_() external pure returns (uint256) {
return 1_000_000;
}
}
contract MockStandardDodoPool is MockBasicDodoPool {
constructor(address baseToken_, address quoteToken_) MockBasicDodoPool(baseToken_, quoteToken_) {}
function querySellBase(address, uint256 payBaseAmount) external pure returns (uint256, uint256) {
return (payBaseAmount, 0);
}
function querySellQuote(address, uint256 payQuoteAmount) external pure returns (uint256, uint256) {
return (payQuoteAmount, 0);
}
function buyShares(address) external pure returns (uint256, uint256, uint256) {
return (0, 0, 1);
}
function sellBase(address) external pure returns (uint256) {
return 0;
}
function sellQuote(address) external pure returns (uint256) {
return 0;
}
}
contract MockPartialDodoPool is MockBasicDodoPool {
constructor(address baseToken_, address quoteToken_) MockBasicDodoPool(baseToken_, quoteToken_) {}
function querySellBase(address, uint256) external pure returns (uint256, uint256) {
revert("query disabled");
}
function querySellQuote(address, uint256) external pure returns (uint256, uint256) {
revert("query disabled");
}
function buyShares(address) external pure returns (uint256, uint256, uint256) {
return (0, 0, 1);
}
function sellBase(address) external pure returns (uint256) {
return 0;
}
function sellQuote(address) external pure returns (uint256) {
return 0;
}
}
contract DODOPMMIntegrationTest is Test {
DODOPMMIntegration public integration;
address public dvm = address(0xdEaD);
MockPoolFactory public dvm;
address public dodoApprove = address(0xD0D0);
MockERC20 public officialUSDT;
MockERC20 public officialUSDC;
@@ -44,86 +127,67 @@ contract DODOPMMIntegrationTest is Test {
officialUSDC = new MockERC20("USDC", "USDC");
compliantUSDT = new MockERC20("cUSDT", "cUSDT");
compliantUSDC = new MockERC20("cUSDC", "cUSDC");
vm.mockCall(
dvm,
abi.encodeWithSelector(
DODOPMMIntegration.createPool.selector
),
abi.encode(address(0x1001))
);
dvm = new MockPoolFactory();
officialUSDT.transfer(admin, 1_000 ether);
officialUSDC.transfer(admin, 1_000 ether);
compliantUSDT.transfer(admin, 1_000 ether);
compliantUSDC.transfer(admin, 1_000 ether);
integration = new DODOPMMIntegration(
admin,
dvm,
address(dvm),
dodoApprove,
address(officialUSDT),
address(officialUSDC),
address(compliantUSDT),
address(compliantUSDC)
);
// admin already has POOL_MANAGER_ROLE from constructor
}
function testCreatePoolGeneric() public {
address baseToken = address(0xB1);
address quoteToken = address(0xB2);
address mockPoolAddr = address(0xBeef);
vm.mockCall(dvm, bytes(""), abi.encode(mockPoolAddr));
address baseToken = address(compliantUSDT);
address quoteToken = address(officialUSDC);
MockStandardDodoPool poolContract = new MockStandardDodoPool(baseToken, quoteToken);
dvm.setNextPool(address(poolContract));
vm.prank(admin);
address pool = integration.createPool(
baseToken,
quoteToken,
3,
1e18,
0.5e18,
true
);
assertEq(pool, mockPoolAddr);
assertEq(integration.pools(baseToken, quoteToken), mockPoolAddr);
assertEq(integration.pools(quoteToken, baseToken), mockPoolAddr);
assertTrue(integration.isRegisteredPool(mockPoolAddr));
address pool = integration.createPool(baseToken, quoteToken, 3, 1e18, 0.5e18, true);
assertEq(pool, address(poolContract));
assertEq(integration.pools(baseToken, quoteToken), address(poolContract));
assertEq(integration.pools(quoteToken, baseToken), address(poolContract));
assertTrue(integration.isRegisteredPool(address(poolContract)));
assertFalse(integration.hasStandardPoolSurface(address(poolContract)));
}
function testCreatePoolRevertsSameToken() public {
vm.prank(admin);
vm.expectRevert("DODOPMMIntegration: same token");
integration.createPool(
address(officialUSDT),
address(officialUSDT),
3,
1e18,
0.5e18,
true
);
integration.createPool(address(officialUSDT), address(officialUSDT), 3, 1e18, 0.5e18, true);
}
function testCreatePoolRevertsZeroBase() public {
vm.prank(admin);
vm.expectRevert("DODOPMMIntegration: zero base");
integration.createPool(
address(0),
address(officialUSDT),
3,
1e18,
0.5e18,
true
);
integration.createPool(address(0), address(officialUSDT), 3, 1e18, 0.5e18, true);
}
function testCreatePoolRevertsWithoutBasicSurface() public {
dvm.setNextPool(address(0xBEEF));
vm.prank(admin);
vm.expectRevert();
integration.createPool(address(compliantUSDT), address(officialUSDC), 3, 1e18, 0.5e18, false);
}
function testImportExistingPoolRecordsMappings() public {
address baseToken = address(officialUSDT);
address quoteToken = address(compliantUSDC);
MockDodoPool pool = new MockDodoPool(baseToken, quoteToken);
MockStandardDodoPool pool = new MockStandardDodoPool(baseToken, quoteToken);
vm.prank(admin);
integration.importExistingPool(
address(pool),
baseToken,
quoteToken,
3,
1e18,
0.5e18,
false
);
integration.importExistingPool(address(pool), baseToken, quoteToken, 3, 1e18, 0.5e18, false);
assertEq(integration.pools(baseToken, quoteToken), address(pool));
assertEq(integration.pools(quoteToken, baseToken), address(pool));
@@ -137,18 +201,10 @@ contract DODOPMMIntegrationTest is Test {
function testImportExistingPoolAcceptsReverseHintAndNormalizes() public {
address baseToken = address(officialUSDT);
address quoteToken = address(compliantUSDC);
MockDodoPool pool = new MockDodoPool(baseToken, quoteToken);
MockStandardDodoPool pool = new MockStandardDodoPool(baseToken, quoteToken);
vm.prank(admin);
integration.importExistingPool(
address(pool),
quoteToken,
baseToken,
3,
1e18,
0.5e18,
false
);
integration.importExistingPool(address(pool), quoteToken, baseToken, 3, 1e18, 0.5e18, false);
DODOPMMIntegration.PoolConfig memory config = integration.getPoolConfig(address(pool));
assertEq(config.baseToken, baseToken);
@@ -156,18 +212,50 @@ contract DODOPMMIntegrationTest is Test {
}
function testImportExistingPoolRevertsOnMismatch() public {
MockDodoPool pool = new MockDodoPool(address(officialUSDT), address(compliantUSDC));
MockStandardDodoPool pool = new MockStandardDodoPool(address(officialUSDT), address(compliantUSDC));
vm.prank(admin);
vm.expectRevert("DODOPMMIntegration: pool token mismatch");
integration.importExistingPool(
address(pool),
address(officialUSDT),
address(compliantUSDT),
3,
1e18,
0.5e18,
false
);
integration.importExistingPool(address(pool), address(officialUSDT), address(compliantUSDT), 3, 1e18, 0.5e18, false);
}
function testAddLiquidityMarksStandardSurface() public {
MockStandardDodoPool pool = new MockStandardDodoPool(address(compliantUSDT), address(officialUSDC));
dvm.setNextPool(address(pool));
vm.startPrank(admin);
address createdPool = integration.createPool(address(compliantUSDT), address(officialUSDC), 3, 1e18, 0.5e18, false);
compliantUSDT.approve(address(integration), 100);
officialUSDC.approve(address(integration), 100);
integration.addLiquidity(createdPool, 100, 100);
vm.stopPrank();
assertTrue(integration.hasStandardPoolSurface(createdPool));
}
function testAddLiquidityRevertsForPartialSurfacePool() public {
MockPartialDodoPool pool = new MockPartialDodoPool(address(compliantUSDT), address(officialUSDC));
dvm.setNextPool(address(pool));
vm.startPrank(admin);
address createdPool = integration.createPool(address(compliantUSDT), address(officialUSDC), 3, 1e18, 0.5e18, false);
compliantUSDT.approve(address(integration), 100);
officialUSDC.approve(address(integration), 100);
vm.expectRevert("DODOPMMIntegration: pool missing standard DODO surface");
integration.addLiquidity(createdPool, 100, 100);
vm.stopPrank();
}
function testRefreshPoolSurfaceMarksImportedStandardPool() public {
MockStandardDodoPool pool = new MockStandardDodoPool(address(compliantUSDT), address(compliantUSDC));
vm.prank(admin);
integration.importExistingPool(address(pool), address(compliantUSDT), address(compliantUSDC), 3, 1e18, 0.5e18, false);
vm.prank(admin);
bool standardSurface = integration.refreshPoolSurface(address(pool));
assertTrue(standardSurface);
assertTrue(integration.hasStandardPoolSurface(address(pool)));
}
}

View File

@@ -0,0 +1,301 @@
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.19;
import {Test} from "forge-std/Test.sol";
import "../../contracts/dex/DODOPMMIntegration.sol";
import "../../contracts/liquidity/providers/DODOPMMProvider.sol";
import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
contract MockProviderERC20 is ERC20 {
constructor(string memory name, string memory symbol) ERC20(name, symbol) {
_mint(msg.sender, 1_000_000 ether);
}
}
contract MockQuotePool {
address public immutable baseToken;
address public immutable quoteToken;
uint256 public immutable midPrice;
uint256 public immutable baseToQuoteOut;
uint256 public immutable quoteToBaseOut;
constructor(
address baseToken_,
address quoteToken_,
uint256 midPrice_,
uint256 baseToQuoteOut_,
uint256 quoteToBaseOut_
) {
baseToken = baseToken_;
quoteToken = quoteToken_;
midPrice = midPrice_;
baseToQuoteOut = baseToQuoteOut_;
quoteToBaseOut = quoteToBaseOut_;
}
function _BASE_TOKEN_() external view returns (address) {
return baseToken;
}
function _QUOTE_TOKEN_() external view returns (address) {
return quoteToken;
}
function querySellBase(address, uint256) external view returns (uint256, uint256) {
return (baseToQuoteOut, 0);
}
function querySellQuote(address, uint256) external view returns (uint256, uint256) {
return (quoteToBaseOut, 0);
}
function sellBase(address) external pure returns (uint256) {
return 0;
}
function sellQuote(address) external pure returns (uint256) {
return 0;
}
function buyShares(address) external pure returns (uint256, uint256, uint256) {
return (0, 0, 0);
}
function getVaultReserve() external pure returns (uint256, uint256) {
return (1_000_000, 1_000_000);
}
function getMidPrice() external view returns (uint256) {
return midPrice;
}
function _QUOTE_RESERVE_() external pure returns (uint256) {
return 1_000_000;
}
function _BASE_RESERVE_() external pure returns (uint256) {
return 1_000_000;
}
}
contract MockFallbackQuotePool {
address public immutable baseToken;
address public immutable quoteToken;
uint256 public immutable baseReserve;
uint256 public immutable quoteReserve;
constructor(
address baseToken_,
address quoteToken_,
uint256 baseReserve_,
uint256 quoteReserve_
) {
baseToken = baseToken_;
quoteToken = quoteToken_;
baseReserve = baseReserve_;
quoteReserve = quoteReserve_;
}
function _BASE_TOKEN_() external view returns (address) {
return baseToken;
}
function _QUOTE_TOKEN_() external view returns (address) {
return quoteToken;
}
function querySellBase(address, uint256) external pure returns (uint256, uint256) {
revert("base quote disabled");
}
function querySellQuote(address, uint256) external pure returns (uint256, uint256) {
revert("quote quote disabled");
}
function sellBase(address) external pure returns (uint256) {
return 0;
}
function sellQuote(address) external pure returns (uint256) {
return 0;
}
function buyShares(address) external pure returns (uint256, uint256, uint256) {
return (0, 0, 0);
}
function getVaultReserve() external view returns (uint256, uint256) {
return (baseReserve, quoteReserve);
}
function getMidPrice() external pure returns (uint256) {
return 1e18;
}
function _QUOTE_RESERVE_() external view returns (uint256) {
return quoteReserve;
}
function _BASE_RESERVE_() external view returns (uint256) {
return baseReserve;
}
}
contract DODOPMMProviderTest is Test {
DODOPMMIntegration internal integration;
DODOPMMProvider internal provider;
MockProviderERC20 internal officialUSDT;
MockProviderERC20 internal officialUSDC;
MockProviderERC20 internal compliantUSDT;
MockProviderERC20 internal compliantUSDC;
address internal constant ADMIN = address(0xAD);
address internal constant DVM = address(0xD0D0);
address internal constant DODO_APPROVE = address(0xA11CE);
function setUp() public {
officialUSDT = new MockProviderERC20("USDT", "USDT");
officialUSDC = new MockProviderERC20("USDC", "USDC");
compliantUSDT = new MockProviderERC20("cUSDT", "cUSDT");
compliantUSDC = new MockProviderERC20("cUSDC", "cUSDC");
integration = new DODOPMMIntegration(
ADMIN,
DVM,
DODO_APPROVE,
address(officialUSDT),
address(officialUSDC),
address(compliantUSDT),
address(compliantUSDC)
);
provider = new DODOPMMProvider(address(integration), ADMIN);
}
function testGetQuoteUsesPoolQueryForBaseSell() public {
MockQuotePool pool = new MockQuotePool(
address(compliantUSDT),
address(compliantUSDC),
2e18,
990_000,
995_000
);
vm.prank(ADMIN);
integration.importExistingPool(address(pool), address(compliantUSDT), address(compliantUSDC), 3, 1e18, 0.5e18, false);
vm.startPrank(ADMIN);
provider.registerPool(address(compliantUSDT), address(compliantUSDC), address(pool));
provider.registerPool(address(compliantUSDC), address(compliantUSDT), address(pool));
vm.stopPrank();
(uint256 amountOut, uint256 slippageBps) = provider.getQuote(
address(compliantUSDT),
address(compliantUSDC),
1_000_000
);
assertEq(amountOut, 990_000);
assertEq(slippageBps, 30);
}
function testGetQuoteUsesPoolQueryForQuoteSell() public {
MockQuotePool pool = new MockQuotePool(
address(compliantUSDT),
address(compliantUSDC),
2e18,
990_000,
995_000
);
vm.prank(ADMIN);
integration.importExistingPool(address(pool), address(compliantUSDT), address(compliantUSDC), 3, 1e18, 0.5e18, false);
vm.startPrank(ADMIN);
provider.registerPool(address(compliantUSDT), address(compliantUSDC), address(pool));
provider.registerPool(address(compliantUSDC), address(compliantUSDT), address(pool));
vm.stopPrank();
(uint256 amountOut, uint256 slippageBps) = provider.getQuote(
address(compliantUSDC),
address(compliantUSDT),
1_000_000
);
assertEq(amountOut, 995_000);
assertEq(slippageBps, 30);
}
function testGetQuoteReturnsZeroForUnsupportedPair() public view {
(uint256 amountOut, uint256 slippageBps) = provider.getQuote(
address(compliantUSDT),
address(officialUSDC),
1_000_000
);
assertEq(amountOut, 0);
assertEq(slippageBps, 10000);
}
function testGetQuoteFallsBackToReservesForBaseSell() public {
uint256 amountIn = 100_000;
uint256 lpFeeRate = 30;
MockFallbackQuotePool pool = new MockFallbackQuotePool(
address(compliantUSDT),
address(compliantUSDC),
1_000_000,
2_000_000
);
vm.prank(ADMIN);
integration.importExistingPool(address(pool), address(compliantUSDT), address(compliantUSDC), lpFeeRate, 1e18, 0.5e18, false);
vm.startPrank(ADMIN);
provider.registerPool(address(compliantUSDT), address(compliantUSDC), address(pool));
provider.registerPool(address(compliantUSDC), address(compliantUSDT), address(pool));
vm.stopPrank();
uint256 netAmountIn = (amountIn * (10_000 - lpFeeRate)) / 10_000;
uint256 expectedOut = (netAmountIn * 2_000_000) / (1_000_000 + netAmountIn);
(uint256 amountOut, uint256 slippageBps) = provider.getQuote(
address(compliantUSDT),
address(compliantUSDC),
amountIn
);
assertEq(amountOut, expectedOut);
assertEq(slippageBps, 100);
}
function testGetQuoteFallsBackToReservesForQuoteSell() public {
uint256 amountIn = 100_000;
uint256 lpFeeRate = 25;
MockFallbackQuotePool pool = new MockFallbackQuotePool(
address(compliantUSDT),
address(compliantUSDC),
2_500_000,
1_500_000
);
vm.prank(ADMIN);
integration.importExistingPool(address(pool), address(compliantUSDT), address(compliantUSDC), lpFeeRate, 1e18, 0.5e18, false);
vm.startPrank(ADMIN);
provider.registerPool(address(compliantUSDT), address(compliantUSDC), address(pool));
provider.registerPool(address(compliantUSDC), address(compliantUSDT), address(pool));
vm.stopPrank();
uint256 netAmountIn = (amountIn * (10_000 - lpFeeRate)) / 10_000;
uint256 expectedOut = (netAmountIn * 2_500_000) / (1_500_000 + netAmountIn);
(uint256 amountOut, uint256 slippageBps) = provider.getQuote(
address(compliantUSDC),
address(compliantUSDT),
amountIn
);
assertEq(amountOut, expectedOut);
assertEq(slippageBps, 100);
}
}