Contract Interfaces

// Minting (whitelisted only)
function mint(address recipient, uint256 amount) external;
function burn(uint256 amount) external;
function burnFrom(address account, uint256 amount) external;

// Whitelist management (ADMIN_ROLE)
function setWhitelist(address minter, bool state) external;
function removeWhitelist(address minter) external;
function setPaused(address minter, bool state) external;

// Flash loans (ERC-3156)
function maxFlashLoan(address token) external view returns (uint256);
function flashFee(address token, uint256 amount) external view returns (uint256);
function flashLoan(
    IERC3156FlashBorrower receiver,
    address token,
    uint256 amount,
    bytes calldata data
) external returns (bool);

// Configuration (ADMIN_ROLE)
function setFlashFee(uint256 newFee) external;
function setMaxFlashLoan(uint256 amount) external;
function setFeeRecipient(address recipient) external;

// User actions
function deposit(uint256 amount) external returns (uint256 shares);
function withdraw(uint256 shares) external returns (uint256 amount);

// Fee reception (authorized distributors only)
function receiveFees(uint256 amount, bytes32 feeType) external;
function depositValidatorRewards(uint256 amount) external;

// Views
function totalAssets() external view returns (uint256);
function convertToShares(uint256 assets) external view returns (uint256);
function convertToAssets(uint256 shares) external view returns (uint256);
function exchangeRate() external view returns (uint256);
function reconcile() external view returns (
    uint256 expectedBalance, uint256 actualBalance, int256 discrepancy
);
function getFeeBreakdown() external view returns (
    uint256 dex, uint256 bridge, uint256 lending, uint256 perps,
    uint256 liquid, uint256 nft, uint256 validator, uint256 other
);

// Governance (GOVERNANCE_ROLE / Timelock)
function setTreasury(address treasury) external;
function setPerfFeeBps(uint256 bps) external;
function applySlashing(uint256 amount) external;

interface IYieldAdapter {
    function deposit(uint256 amount) external returns (uint256 shares);
    function withdraw(uint256 shares) external returns (uint256 amount);
    function totalAssets() external view returns (uint256);
    function isShariahCompliant() external view returns (bool);
}