Integration Guide

// Solidity — the router resolves the pool via the factory,
// no pool address needed
function getAmountOut(
    address tokenIn,
    address tokenOut,
    uint256 amountIn
) external view returns (uint256 amountOut);

// Multi-hop quote along a path (all paths route through USDC)
function getAmountsOut(
    uint256 amountIn,
    address[] calldata path
) external view returns (uint256[] memory amounts);

// Example: Get quote for 1000 USDC -> EURC
uint256 amountOut = router.getAmountOut(
    0x3600000000000000000000000000000000000000, // USDC
    0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a, // EURC
    1000 * 1e6 // 1000 USDC (6 decimals)
);

// Solidity — Uniswap-V2-style exact-input swap (recommended)
function swapExactTokensForTokens(
    uint256 amountIn,
    uint256 minAmountOut,
    address[] calldata path,
    address to,
    uint256 deadline
) external returns (uint256[] memory amounts);

// Example: Swap 1000 USDC for EURC with 0.5% slippage
uint256 amountIn = 1000 * 1e6;
IERC20(USDC).approve(router, amountIn);

// Quote first, then derive the slippage floor from the quote
uint256 quoted = router.getAmountOut(USDC, EURC, amountIn);
uint256 minOut = (quoted * 995) / 1000; // 0.5% slippage

address[] memory path = new address[](2);
path[0] = USDC;
path[1] = EURC;

uint256[] memory amounts = router.swapExactTokensForTokens(
    amountIn,
    minOut,
    path,
    msg.sender,           // Recipient
    block.timestamp + 300 // 5 min deadline
);

// One-transaction alternative (no separate approve):
// swapWithPermit(...) — USDC, EURC and USYC all support
// EIP-2612 permit on Arc

// ERC-4626 Standard
function deposit(
    uint256 assets,  // USDC amount
    address receiver // Share recipient
) external returns (uint256 shares);

// Example
IERC20(USDC).approve(vault, 1000 * 1e6);
uint256 shares = IXyloVault(vault).deposit(1000 * 1e6, msg.sender);

// Withdraw by asset amount
function withdraw(
    uint256 assets,
    address receiver,
    address owner
) external returns (uint256 shares);

// Withdraw by share amount
function redeem(
    uint256 shares,
    address receiver,
    address owner
) external returns (uint256 assets);

// Get total assets in vault
uint256 total = vault.totalAssets();

// Convert shares to assets
uint256 assets = vault.convertToAssets(shares);

// Convert assets to shares
uint256 shares = vault.convertToShares(assets);

// Preview deposit/withdraw
uint256 shares = vault.previewDeposit(assets);
uint256 assets = vault.previewWithdraw(shares);