Smart Contracts

TL;DR: Complete reference for all XCCY smart contracts — addresses, interfaces, and key functions.

Deployed Contracts (Polygon)

Contract	Address	Purpose
VAMMManager	0xe8FE9b71355B1701036671AD3c8F6dF585eb7eBd	Trading engine
CollateralEngine	0x23E2DD3bB6e35162eB48d473d540764d5902BAe5	Margin & positions
OracleHub	0x7a5084DEc5Fd89Ee1079005cE9cEa094c2A66E8E	Price feeds
AprOracle	0xA192144F89edC9fBB3D225856FaF284d9287EDb8	Yield rates

Tokens

Token	Address	Decimals
USDC	0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359	6
aUSDC (Aave)	0xA4D94019934D8333Ef880ABFFbF2FDd611C762BD	6

---

VAMMManager

The core trading engine for all XCCY pools.

Interface

interface IVAMMManager {
    // Pool Management
    function createPool(
        PoolKey memory key,
        IAprOracle aprOracle,
        uint160 sqrtPriceX96
    ) external returns (int24 tick, bytes32 poolId);
    
    function poolExists(PoolKey memory key) external view returns (bool exists);
    
    // Trading
    function swap(
        PoolKey memory key,
        SwapParams calldata params
    ) external returns (
        int256 fixedTokenDelta,
        int256 variableTokenDelta,
        uint256 cumulativeFeeIncurred,
        int256 fixedTokenDeltaUnbalanced,
        uint256 positionMarginRequirement
    );
    
    // Liquidity
    function mint(
        PoolKey memory key,
        AccountId calldata account,
        int24 tickLower,
        int24 tickUpper,
        uint128 amount
    ) external returns (uint256 positionMarginRequirement);
    
    function burn(
        PoolKey memory key,
        AccountId calldata account,
        int24 tickLower,
        int24 tickUpper,
        uint128 amount
    ) external returns (uint256 positionMarginRequirement);
    
    // View Functions
    function getVAMMState(bytes32 poolId) 
        external view returns (int24 tick, uint160 sqrtPriceX96);
    
    function computeGrowthInside(
        bytes32 poolId,
        int24 tickLower,
        int24 tickUpper
    ) external view returns (
        int256 fixedTokenGrowthInsideX128,
        int256 variableTokenGrowthInsideX128,
        uint256 feeGrowthInsideX128
    );
}

Data Structures

struct PoolKey {
    address underlyingAsset;
    address compoundToken;
    uint256 termStartTimestampWad;
    uint256 termEndTimestampWad;
    uint256 feeWad;
    int24 tickSpacing;
}

struct SwapParams {
    AccountId account;
    int256 amountSpecified;      // Negative = Lock FY, Positive = Trade VY
    uint160 sqrtPriceLimitX96;
    int24 tickLower;
    int24 tickUpper;
}

struct AccountId {
    address owner;
    uint96 id;
    address isolatedMarginToken;
}

Events

event PoolInitialized(
    bytes32 indexed poolId,
    address indexed underlyingAsset,
    uint256 termStartTimestampWad,
    uint256 termEndTimestampWad,
    uint256 feeWad,
    int24 tickSpacing,
    int24 tick,
    uint160 sqrtPriceX96
);

event Swap(
    bytes32 indexed poolId,
    address indexed owner,
    uint96 id,
    address isolatedMarginToken,
    int24 tickLower,
    int24 tickUpper,
    uint256 cumulativeFeeIncurred,
    int256 fixedTokenDelta,
    int256 variableTokenDelta,
    int24 tick,
    uint160 sqrtPriceX96
);

event Mint(
    bytes32 indexed poolId,
    address indexed owner,
    uint96 id,
    address isolatedMarginToken,
    int24 tickLower,
    int24 tickUpper,
    uint128 amount
);

event Burn(
    bytes32 indexed poolId,
    address indexed owner,
    uint96 id,
    address isolatedMarginToken,
    int24 tickLower,
    int24 tickUpper,
    uint128 amount
);

---

CollateralEngine

Manages all margin, positions, and settlements.

Interface

interface ICollateralEngine {
    // Margin Management
    function updateAccountMargin(
        AccountId calldata account,
        address token,
        int256 marginDelta
    ) external;
    
    // Position Updates (called by VAMMManager)
    function updatePositionPostVAMMAction(
        UpdatePositionParams calldata params
    ) external;
    
    // Margin Checks
    function checkMarginRequirement(AccountId calldata account) 
        external returns (uint256 positionMarginRequirement);
    
    // Settlement
    function settlePosition(
        AccountId calldata account,
        PoolKey calldata poolKey
    ) external;
    
    // Liquidation
    function liquidateAccount(
        AccountId calldata account,
        AccountId calldata liquidatorAccount
    ) external;
    
    // View Functions
    function oracleHub() external view returns (IOracleHub);
    function aprOracle() external view returns (IAprOracle);
    function vammManager() external view returns (IVAMMManager);
    
    // Admin
    function setMarginTokenWhitelist(
        address token,
        bool whitelisted,
        uint256 discountFactorWad
    ) external;
    
    function setWorstCaseVariableFactor(
        bytes32 poolId,
        uint256 worstCaseVariableFactorPositiveWad,
        uint256 worstCaseVariableFactorNegativeWad
    ) external;
}

Data Structures

struct UpdatePositionParams {
    PoolKey poolKey;
    AccountId account;
    int24 tickLower;
    int24 tickUpper;
    int128 liquidityDelta;
    int256 fixedTokenDelta;
    int256 variableTokenDelta;
    uint256 cumulativeFeeIncurred;
    int256 fixedTokenGrowthInsideX128;
    int256 variableTokenGrowthInsideX128;
    uint256 feeGrowthInsideX128;
}

Events

event PositionUpdate(
    address indexed owner,
    uint96 id,
    address isolatedMarginToken,
    bytes32 indexed poolId,
    int24 tickLower,
    int24 tickUpper,
    uint128 liquidity,
    int256 fixedTokenBalance,
    int256 variableTokenBalance,
    uint256 accumulatedFees
);

event PositionSettlement(
    address indexed owner,
    uint96 id,
    address isolatedMarginToken,
    bytes32 indexed poolId,
    int256 settlementCashflow
);

event AccountLiquidated(
    address indexed owner,
    uint96 id,
    address isolatedMarginToken,
    address indexed liquidatorOwner,
    uint96 liquidatorId,
    address liquidatorIsolatedMarginToken
);

event MarginTokenWhitelistUpdate(
    address indexed token,
    bool whitelisted,
    uint256 discountFactorWad
);

---

OracleHub

Provides USD price feeds for all supported assets.

Interface

interface IOracleHub {
    function getPriceUsdWad(address asset) 
        external view 
        returns (
            uint256 priceWad,
            uint256 timestamp,
            bool valid
        );
    
    function setSource(address asset, IPriceSource source) external;
}

---

AprOracle

Tracks Variable Yield rates for yield-bearing tokens.

Interface

interface IAprOracle {
    function getRateFromTo(
        address compoundToken,
        uint48 from,
        uint48 to
    ) external view returns (uint256 rateWad, bool valid);
    
    function getOnAprRay(address compoundToken) 
        external view returns (uint256 aprRay);
    
    function setAdapter(address compoundToken, IAprAdapter adapter) external;
}

---

ABIs

Minimal ABIs for Integration

export const VAMM_MANAGER_ABI = [
  "function swap((address,address,uint256,uint256,uint256,int24) key, (tuple(address,uint96,address) account, int256 amountSpecified, uint160 sqrtPriceLimitX96, int24 tickLower, int24 tickUpper) params) external returns (int256, int256, uint256, int256, uint256)",
  "function mint((address,address,uint256,uint256,uint256,int24) key, tuple(address,uint96,address) account, int24 tickLower, int24 tickUpper, uint128 amount) external returns (uint256)",
  "function burn((address,address,uint256,uint256,uint256,int24) key, tuple(address,uint96,address) account, int24 tickLower, int24 tickUpper, uint128 amount) external returns (uint256)",
  "function getVAMMState(bytes32 poolId) view returns (int24 tick, uint160 sqrtPriceX96)",
  "function poolExists((address,address,uint256,uint256,uint256,int24) key) view returns (bool)"
];

export const COLLATERAL_ENGINE_ABI = [
  "function updateAccountMargin(tuple(address,uint96,address) account, address token, int256 marginDelta) external",
  "function checkMarginRequirement(tuple(address,uint96,address) account) external returns (uint256)",
  "function settlePosition(tuple(address,uint96,address) account, tuple(address,address,uint256,uint256,uint256,int24) poolKey) external",
  "function liquidateAccount(tuple(address,uint96,address) account, tuple(address,uint96,address) liquidatorAccount) external"
];

export const APR_ORACLE_ABI = [
  "function getRateFromTo(address compoundToken, uint48 from, uint48 to) view returns (uint256 rateWad, bool valid)",
  "function getOnAprRay(address compoundToken) view returns (uint256 aprRay)"
];

export const ERC20_ABI = [
  "function approve(address spender, uint256 amount) external returns (bool)",
  "function allowance(address owner, address spender) view returns (uint256)",
  "function balanceOf(address account) view returns (uint256)"
];

Source Code

All contracts are open source:

• VAMMManager: src/VAMMManager.sol

• CollateralEngine: src/CollateralEngine.sol

• OracleHub: src/OracleHub.sol

• AprOracle: src/oracles/AprOracle.sol

Next Steps

• API Reference — Detailed function documentation

• Examples — Code examples

• Integration Overview — Getting started guide