This skill should be used when the user asks about "Aerodrome integration", "Aerodrome swap", "Aerodrome liquidity", "volatile pool", "stable pool", "Slipstream", "concentrated liquidity on Aerodrome", or needs to interact with Aerodrome DEX on Base using Crane's service libraries.
Crane provides comprehensive Aerodrome v1 and Slipstream integration with services, stubs, and test infrastructure.
| Component | Location | Purpose |
|---|---|---|
AerodromServiceVolatile | services/AerodromServiceVolatile.sol | Volatile pool operations (xy=k) |
AerodromServiceStable | services/AerodromServiceStable.sol | Stable pool operations (x³y+xy³=k) |
AerodromeRouterAwareRepo | aware/AerodromeRouterAwareRepo.sol | Router dependency injection |
AerodromePoolMetadataRepo | aware/AerodromePoolMetadataRepo.sol | Pool metadata storage |
TestBase_Aerodrome | test/bases/TestBase_Aerodrome.sol |
| Full protocol deployment |
TestBase_Aerodrome_Pools | test/bases/TestBase_Aerodrome_Pools.sol | Pool creation helpers |
SlipstreamRewardUtils | slipstream/SlipstreamRewardUtils.sol | CL reward calculations |
Aerodrome has two pool types with different AMM curves:
| Type | Curve | Use Case | Service |
|---|---|---|---|
| Volatile | xy = k | ETH/USDC, volatile pairs | AerodromServiceVolatile |
| Stable | x³y + xy³ = k | USDC/USDT, stablecoin pairs | AerodromServiceStable |
import {AerodromServiceVolatile} from "@crane/contracts/protocols/dexes/aerodrome/v1/services/AerodromServiceVolatile.sol";
import {AerodromeRouterAwareRepo} from "@crane/contracts/protocols/dexes/aerodrome/v1/aware/AerodromeRouterAwareRepo.sol";
contract MyVault {
function swap(IERC20 tokenIn, IERC20 tokenOut, uint256 amount) external {
IRouter router = AerodromeRouterAwareRepo._router();
IPoolFactory factory = router.defaultFactory();
IPool pool = IPool(factory.getPool(address(tokenIn), address(tokenOut), false));
AerodromServiceVolatile._swapVolatile(
AerodromServiceVolatile.SwapVolatileParams({
router: router,
factory: factory,
pool: pool,
tokenIn: tokenIn,
tokenOut: tokenOut,
amountIn: amount,
recipient: address(this),
deadline: block.timestamp
})
);
}
}
// Simple swap
function _swapVolatile(SwapVolatileParams memory params) internal returns (uint256 amountOut);
// Swap and deposit in single transaction
function _swapDepositVolatile(SwapDepositVolatileParams memory params) internal returns (uint256 lpOut);
// Withdraw and swap to single token
function _withdrawSwapVolatile(WithdrawSwapVolatileParams memory params) internal returns (uint256 amountOut);
// Quote optimal swap amount for balanced deposit
function _quoteSwapDepositSaleAmtVolatile(params) internal view returns (uint256 saleAmt);
Same function signatures with Stable suffix:
function _swapStable(SwapStableParams memory params) internal returns (uint256 amountOut);
function _swapDepositStable(SwapDepositStableParams memory params) internal returns (uint256 lpOut);
IRouter.Route memory route = IRouter.Route({
from: address(tokenIn),
to: address(tokenOut),
stable: false, // true for stable pools
factory: address(factory)
});
IRouter.Route[] memory routes = new IRouter.Route[](1);
routes[0] = route;
router.swapExactTokensForTokens(
amountIn,
amountOutMin,
routes,
recipient,
deadline
);
// Initialize during deployment
AerodromeRouterAwareRepo._initialize(router);
// Access in operations
IRouter router = AerodromeRouterAwareRepo._router();
import {TestBase_Aerodrome_Pools} from "@crane/contracts/protocols/dexes/aerodrome/v1/test/bases/TestBase_Aerodrome_Pools.sol";
contract MyTest is TestBase_Aerodrome_Pools {
function setUp() public override {
super.setUp();
// aerodromeRouter, aerodromeFactory, voter, etc. available
}
function test_swap() public {
// Create pool and test
}
}
references/aerodrome-services.md - Detailed service patterns and examples