@ubk-labs/ubk-oracle 0.1.7 → 0.1.9

package/contracts/core/UBKOracle.sol

@@ -7,6 +7,7 @@ import "@openzeppelin/contracts/interfaces/IERC4626.sol";
 import "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol";
 
 import "@chainlink/contracts/src/v0.8/interfaces/AggregatorV3Interface.sol";
+import "@ubk-labs/ubk-commons/contracts/abstract/UBKDecimalsBounded.sol";
 
 import "../../interfaces/IUBKOracle.sol";
 import "../errors/UBKOracleErrors.sol";
@@ -39,7 +40,7 @@ import "../constants/UBKOracleConstants.sol";
  *  - UI / Subgraphs can use `isPriceFresh()` and `getPriceAge()` for safety checks.
  *
  */
-contract UBKOracle is IUBKOracle, Ownable {
+contract UBKOracle is IUBKOracle, UBKDecimalsBounded, Ownable {
     // -----------------------------------------------------------------------
     // Storage
     // -----------------------------------------------------------------------
@@ -87,10 +88,7 @@ contract UBKOracle is IUBKOracle, Ownable {
      * @notice Deploys the Oracle contract.
      * @param _owner The address to assign as the owner (governance or deployer).
      */
-    constructor(address _owner) Ownable(_owner) {
-        if (_owner == address(0))
-            revert ZeroAddress("UBKOracle::constructor", "owner");
-    }
+    constructor(address _owner) Ownable(_owner) {}
 
     /// @notice Ensures oracle is not paused.
     modifier whenNotPaused() {
@@ -240,9 +238,7 @@ contract UBKOracle is IUBKOracle, Ownable {
      * @dev Ensures decimals ≤ 18 and feed returns a nonzero updatedAt value.
      */
     function setChainlinkFeed(address token, address feed) external onlyOwner {
-        if (token == address(0) || feed == address(0))
-            revert ZeroAddress("UBKOracle::setChainlinkFeed", "input");
-        if (feed.code.length == 0) revert InvalidFeedContract(feed);
+        _validateChainlinkFeed(token, feed);
 
         AggregatorV3Interface agg = AggregatorV3Interface(feed);
         uint8 decimals = agg.decimals();
@@ -276,11 +272,7 @@ contract UBKOracle is IUBKOracle, Ownable {
         address vault,
         address underlying
     ) external onlyOwner {
-        if (vault == address(0) || underlying == address(0))
-            revert ZeroAddress("UBKOracle::setERC4626Vault", "input");
-        try IERC4626(vault).asset() returns (address) {} catch {
-            revert InvalidERC4626Vault(vault);
-        }
+        _validateERC4626Vault(vault, underlying);
         erc4626Underlying[vault] = underlying;
         _addSupportedToken(vault);
         emit ERC4626Registered(vault, underlying);
@@ -312,6 +304,36 @@ contract UBKOracle is IUBKOracle, Ownable {
         return _fetchAndUpdatePrice(token);
     }
 
+    /**
+     * @notice Batch price fetch & update for multiple tokens.
+     * @param tokens Array of asset token addresses.
+     * @return prices Array of fresh prices in 1e18 precision.
+     *
+     * @dev
+     *  - Runs whenNotPaused modifier.
+     *  - Reverts if any token is zero address.
+     *  - Each iteration calls the same internal `_fetchAndUpdatePrice`.
+     *  - Gas-efficient: msg.sender checked once, calldata parsed once.
+     */
+    function fetchAndUpdatePrice(
+        address[] calldata tokens
+    ) external whenNotPaused returns (uint256[] memory prices) {
+        uint256 len = tokens.length;
+        prices = new uint256[](len);
+
+        for (uint256 i = 0; i < len; ++i) {
+            address token = tokens[i];
+            if (token == address(0)) {
+                revert ZeroAddress(
+                    "UBKOracle::fetchAndUpdatePriceBatch",
+                    "token"
+                );
+            }
+
+            prices[i] = _fetchAndUpdatePrice(token);
+        }
+    }
+
     /**
      * @notice Returns age of last cached price in seconds.
      * @param token Token address.
@@ -415,7 +437,7 @@ contract UBKOracle is IUBKOracle, Ownable {
         return (lv.timestamp != 0 &&
             block.timestamp - lv.timestamp <= stalePeriod[token]);
     }
-    
+
     /**
      * @notice Resolves the fair price of an ERC4626 vault share.
      * @param vault ERC4626 vault token address.
@@ -582,4 +604,52 @@ contract UBKOracle is IUBKOracle, Ownable {
             emit TokenSupportAdded(token);
         }
     }
+
+    /**
+     * @notice Validates assets and their associated Chainlink feeds before mutating system state.
+     * @param token Asset token address.
+     * @param feed Chainlink AggregatorV3 feed address.
+     * @dev Ensures decimals ≤ 18 and feed returns a nonzero updatedAt value.
+     */
+    function _validateChainlinkFeed(address token, address feed) internal view {
+        if (token == address(0))
+            revert ZeroAddress("UBKOracle::setChainlinkFeed", "token");
+        if (feed == address(0))
+            revert ZeroAddress("UBKOracle::setChainlinkFeed", "feed");
+        if (feed.code.length == 0) revert InvalidFeedContract(feed);
+        _validateTokenDecimals(token);
+    }
+
+    /**
+     * @notice Validates input parameters before setting an ERc 4626 vault.
+     * @dev Ensures decimals for vault and underlying assets are equal, and bounded by global invariants.
+     * @param vault ERC-4626 asset.
+     * @param underlying ERC-20 asset.
+     */
+    function _validateERC4626Vault(
+        address vault,
+        address underlying
+    ) internal view {
+        if (vault == address(0))
+            revert ZeroAddress("UBKOracle::_validateERC4626Vault", "vault");
+        if (underlying == address(0)) {
+            revert ZeroAddress(
+                "UBKOracle::_validateERC4626Vault",
+                "underlying"
+            );
+        }
+        try IERC4626(vault).asset() returns (address) {} catch {
+            revert InvalidERC4626Vault(vault);
+        }
+        uint8 vaultDecimals = _validateTokenDecimals(vault); // Must be between [6,18]
+        uint8 underlyingDecimals = _validateTokenDecimals(underlying); // Must be between [6,18]
+
+        if (vaultDecimals != underlyingDecimals) {
+            revert ERC4626DecimalsMismatch(
+                "UBKOracle::_validateERC4626Vault",
+                vault,
+                underlying
+            );
+        }
+    }
 }

package/contracts/errors/UBKOracleErrors.sol

@@ -19,3 +19,4 @@ error NoFallbackPrice(address token);
 error SuspiciousVaultRate(address vault, uint256 rate);
 error RecursiveResolution(address token);
 error OraclePaused(address oracle, uint256 timestamp);
+error ERC4626DecimalsMismatch(string functionName, address vault, address underlying);

package/deployments/mainnet.json

@@ -0,0 +1,5 @@
+{
+    "0.1.7": "0x37814FAA5bd659888380CBa070F098Cc0999A8cA",
+    "0.1.8": "0x5d4747d514B529005F4014f26068E1f4Ec47E06B",
+    "0.1.9": "0x04B21e27e24Ab71472690C9a09BC7A826d658668"
+}

package/interfaces/IUBKOracle.sol

@@ -94,7 +94,9 @@ interface IUBKOracle {
      * @dev Keeper entrypoint. May revert if price resolution fails.
      */
     function fetchAndUpdatePrice(address token) external returns (uint256);
-
+    function fetchAndUpdatePrice(
+        address[] calldata tokens
+    ) external returns (uint256[] memory);
     // -----------------------------------------------------------------------
     // ADMIN / GOVERNANCE CONFIGURATION
     // -----------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubk-labs/ubk-oracle",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Oracle supporting ERC-20 and ERC-4626 assets for use in decentralized financial applications.",
   "scripts": {
     "build": "npx hardhat compile",
@@ -20,6 +20,7 @@
   "files": [
     "contracts",
     "interfaces",
+    "deployments",
     "README.md",
     "LICENSE",
     "package.json"
@@ -37,6 +38,6 @@
   },
   "dependencies": {
     "@chainlink/contracts": "^0.6.1",
-    "@ubk-labs/ubk-commons": "^0.1.5"
+    "@ubk-labs/ubk-commons": "^0.1.7"
   }
 }