@ubk-labs/ubk-oracle 0.1.2

package/contracts/mocks/MockERC4626.sol

@@ -0,0 +1,74 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.20;
+
+import "./MockERC20.sol";
+import "./MockIERC4626.sol";
+
+contract Mock4626 is MockERC20, MockIERC4626 {
+    uint256 public exchangeRate = 1e18; // 1:1 default
+    address private _asset; // underlying ERC20 asset
+    uint8 private immutable _assetDecimals;
+
+    constructor(
+        string memory name_,
+        string memory symbol_,
+        uint8 decimals_, // vault decimals (e.g. 18)
+        uint256 initialSupply,
+        address asset_
+    )
+        MockERC20(name_, symbol_, decimals_, initialSupply)
+    {
+        _asset = asset_;
+        _assetDecimals = MockERC20(asset_).decimals();
+    }
+
+    /// @notice sets a mock exchange rate for testing
+    function setExchangeRate(uint256 newRate) external {
+        exchangeRate = newRate;
+    }
+
+    /// @notice mock conversion (shares → assets)
+    function convertToAssets(uint256 shares) external view override returns (uint256) {
+        uint8 vaultDecimals = decimals();
+
+        // Normalize shares → assets
+        // assets = shares * 10^(assetDecimals) / 10^(vaultDecimals) * exchangeRate / 1e18
+        uint256 assets = (shares * (10 ** _assetDecimals)) / (10 ** vaultDecimals);
+        return (assets * exchangeRate) / 1e18;
+    }
+
+    /// @notice ERC-4626 required function
+    function asset() external view override returns (address) {
+        return _asset;
+    }
+
+    /// @notice Deposit assets and mint shares to `receiver`
+    /// @notice Deposit assets and mint shares to `receiver`
+    function deposit(uint256 assets, address receiver) external override returns (uint256 shares) {
+        require(assets > 0, "Zero deposit");
+
+        // Compute shares using convertToShares()
+        shares = this.convertToShares(assets);
+
+        // Pull underlying from sender
+        IERC20(_asset).transferFrom(msg.sender, address(this), assets);
+
+        // Mint vault shares (this ERC20) to receiver
+        _mint(receiver, shares);
+    }
+
+    /// @notice mock conversion (assets → shares)
+    function convertToShares(uint256 assets) external view returns (uint256) {
+        uint8 vaultDecimals = decimals();
+
+        // Normalize: assets → shares
+        uint256 normalized = (assets * (10 ** vaultDecimals)) / (10 ** _assetDecimals);
+
+        return (normalized * 1e18) / exchangeRate;
+    }
+
+    /// @notice get exchange rates 
+    function getExchangeRate() external view returns (uint256) {
+        return exchangeRate;
+    }
+}

package/contracts/mocks/MockIERC4626.sol

@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.20;
+
+//Mocked interface for IERC-4626 behavior.
+//This is far more minimal and easy to work with for testing purposes.
+//Will be used to impart 4626 functionality to sDAI in tests.
+interface MockIERC4626 {
+    function setExchangeRate(uint256 newRate) external;
+    function convertToAssets(uint256 shares) external view returns (uint256);
+    function convertToShares(uint256 assets) external view returns (uint256);
+    function asset() external view returns (address);
+    function deposit(uint256 assets, address receiver) external returns (uint256 shares);
+}

package/interfaces/IUBKOracle.sol

@@ -0,0 +1,54 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.20;
+
+interface IUBKOracle {
+    /// @notice Operational state of the oracle.
+    enum OracleMode {
+        NORMAL,
+        PAUSED
+    }
+
+    /// @notice Cached last valid price and timestamp.
+    struct LastValidPrice {
+        uint256 price;
+        uint256 timestamp;
+    }
+
+    /// @notice Custom vault rate bounds (min/max multiplier per vault).
+    struct VaultRateBounds {
+        uint256 minRate;
+        uint256 maxRate;
+    }
+
+    /// @notice Oracle specific events for subgraph indexing.
+    event ChainlinkFeedSet(address indexed token, address indexed feed);
+    event ERC4626Registered(address indexed vault, address indexed underlying);
+    event TokenSupportAdded(address indexed token);
+    event ManualPriceSet(address indexed token, uint256 price);
+    event ManualModeEnabled(address indexed token, bool enabled);
+    event StalePeriodUpdated(uint256 newPeriod);
+    event OracleModeChanged(OracleMode oldMode, OracleMode newMode);
+    event FallbackStalePeriodUpdated(uint256 newPeriod);
+    event VaultRateBoundsSet(
+        address indexed vault,
+        uint256 minRate,
+        uint256 maxRate
+    );
+    event LastValidPriceUpdated(
+        address indexed token,
+        uint256 price,
+        uint256 timestamp
+    );
+    event OracleFallbackUsed(
+        address indexed token,
+        uint256 lastValid,
+        uint256 at,
+        string reason
+    );
+
+    // View Functions
+    function getPrice(address token) external view returns (uint256);
+
+    // Mutators
+    function fetchAndUpdatePrice(address token) external returns (uint256);
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@ubk-labs/ubk-oracle",
+  "version": "0.1.2",
+  "description": "Oracle supporting ERC-20 and ERC-4626 assets for use in decentralized financial applications.",
+  "scripts": {
+    "build": "npx hardhat compile",
+    "test": "npx hardhat test",
+    "coverage": "hardhat coverage",
+    "lint": "prettier --check .",
+    "format": "prettier --write ."
+  },
+  "keywords": [
+    "DeFi",
+    "Oracle",
+    "Solidity",
+    "Hardhat"
+  ],
+  "author": "UBK Finance Team",
+  "license": "MIT",
+  "files": [
+    "contracts",
+    "artifacts",
+    "interfaces",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@graphprotocol/hardhat-graph": "^0.1.0-alpha.2",
+    "@nomicfoundation/hardhat-toolbox": "^3.0.0",
+    "@openzeppelin/contracts": "^5.0.1",
+    "dotenv": "^16.1.4",
+    "ethers": "^6.7.0",
+    "hardhat": "^2.26.3",
+    "hardhat-tracer": "^3.4.0",
+    "prettier": "^3.2.5",
+    "solidity-coverage": "^0.8.16"
+  },
+  "dependencies": {
+    "@chainlink/contracts": "^0.6.1"
+  }
+}