Merge pull request #294 from VenusProtocol/develop

New release

Author: chechu

.env.example

@@ -23,7 +23,6 @@ ARCHIVE_NODE_ethereum=https://eth-mainnet.nodereal.io/v1/<YOUR_KEY_HERE>
 #ARCHIVE_NODE_basemainnet=https://open-platform.nodereal.io/<YOUR_KEY_HERE>/base
 #ARCHIVE_NODE_unichainsepolia=https://unichain-sepolia.g.alchemy.com/v2/<YOUR_KEY_HERE>
 #ARCHIVE_NODE_unichainmainnet=https://unichain-mainnet.g.alchemy.com/v2/<YOUR_KEY_HERE>
-#ARCHIVE_NODE_berachainbepolia=https://berachain-bepolia.g.alchemy.com/v2/<YOUR_KEY_HERE>
 
 ETHERSCAN_API_KEY=
 REPORT_GAS=

.github/workflows/ci.yml

@@ -115,7 +115,7 @@ jobs:
 
       - name: Export deployments
         run: |
-          for NETWORK in bsctestnet bscmainnet ethereum sepolia opbnbtestnet opbnbmainnet arbitrumsepolia arbitrumone opsepolia opmainnet basesepolia basemainnet unichainsepolia unichainmainnet berachainbepolia; do
+          for NETWORK in bsctestnet bscmainnet ethereum sepolia opbnbtestnet opbnbmainnet arbitrumsepolia arbitrumone opsepolia opmainnet basesepolia basemainnet unichainsepolia unichainmainnet; do
             EXPORT=true yarn hardhat export --network ${NETWORK} --export ./deployments/${NETWORK}.json
             jq -M '{name, chainId, addresses: .contracts | map_values(.address)}' ./deployments/${NETWORK}.json > ./deployments/${NETWORK}_addresses.json
           done

CHANGELOG.md

@@ -1,3 +1,41 @@
+## [2.14.0-dev.2](https://github.com/VenusProtocol/oracle/compare/v2.14.0-dev.1...v2.14.0-dev.2) (2025-09-29)
+
+
+### Features
+
+* add PT-USDe oracle deployemnts ([de0e156](https://github.com/VenusProtocol/oracle/commit/de0e15690cad6b713069ea9200a7a4b2d359bfef))
+* add PT-USDe oracle deployemnts on bscmainnet ([0428227](https://github.com/VenusProtocol/oracle/commit/042822727a1c95ef94978e32ea91333c6b6d7c0d))
+* updating deployment files ([f688009](https://github.com/VenusProtocol/oracle/commit/f688009a686c6d56c5b9748e23b0826cabe64d52))
+* updating deployment files ([7f6990a](https://github.com/VenusProtocol/oracle/commit/7f6990afe8886a559bc4a7efd8ec4794a5928e9a))
+* updating deployment files ([7a3baa3](https://github.com/VenusProtocol/oracle/commit/7a3baa3c98561e02b8cfeb0ca3301f91882e3ab3))
+* updating deployment files ([9464757](https://github.com/VenusProtocol/oracle/commit/946475775ff74d8d3fa502edb5759ad695c03f5d))
+
+
+### Bug Fixes
+
+* market naming case ([b443a93](https://github.com/VenusProtocol/oracle/commit/b443a930c4d50b80012689416c3db77ae5cd2231))
+* update PT-USDe oracle deployemnt ([6dc42ad](https://github.com/VenusProtocol/oracle/commit/6dc42ad74f1edd9338371efdcfc81db5069e7ba8))
+* yarn-lock updates ([9179568](https://github.com/VenusProtocol/oracle/commit/9179568a8c423e4207e8531406a09fb42389baf8))
+
+## [2.14.0-dev.1](https://github.com/VenusProtocol/oracle/compare/v2.13.0...v2.14.0-dev.1) (2025-08-11)
+
+
+### Features
+
+* could use different contracts to get the wstETH ratio ([bd60eb8](https://github.com/VenusProtocol/oracle/commit/bd60eb88975228113195c0d4a1df3dabc61afb4d))
+* updating deployment files ([2541103](https://github.com/VenusProtocol/oracle/commit/25411038a1c2afb632d5377874349f62b98e03eb))
+
+
+### Bug Fixes
+
+* added caps ([43179a0](https://github.com/VenusProtocol/oracle/commit/43179a0ddaaacb52ca3130efcbae9cd36246bb45))
+* deployed oracle ([0d41742](https://github.com/VenusProtocol/oracle/commit/0d4174201e5570a60c612bd831acf2ffc57bc4a9))
+* fixed deploy script ([e4f1e16](https://github.com/VenusProtocol/oracle/commit/e4f1e166b9edf8451caaac96e2abc12f04a1074c))
+* fixed ut ([6809779](https://github.com/VenusProtocol/oracle/commit/6809779b51cd4a4db0ba6c8a6620738165129966))
+* fixed yarn lock ([e165afc](https://github.com/VenusProtocol/oracle/commit/e165afcccf3dd5745dfff2942595aa3d72ae81a6))
+* removed berachain deployment ([cf0ff73](https://github.com/VenusProtocol/oracle/commit/cf0ff73bc19f1f17e48366b8aebda1ca9130f4df))
+* removed proxy ([549f763](https://github.com/VenusProtocol/oracle/commit/549f763fa34f4b0e708f9be6aa8649dcaae8a8cc))
+
 ## [2.13.0](https://github.com/VenusProtocol/oracle/compare/v2.12.0...v2.13.0) (2025-07-01)
 
 

audits/137_wstETHOracleV2_certik_20250623.pdf

@@ -4,17 +4,24 @@ pragma solidity 0.8.25;
 import { IStETH } from "../interfaces/IStETH.sol";
 import { CorrelatedTokenOracle } from "./common/CorrelatedTokenOracle.sol";
 import { EXP_SCALE } from "@venusprotocol/solidity-utilities/contracts/constants.sol";
+import { ensureNonzeroAddress } from "@venusprotocol/solidity-utilities/contracts/validators.sol";
 
 /**
  * @title WstETHOracleV2
  * @author Venus
  * @notice This oracle fetches the price of wstETH
  */
 contract WstETHOracleV2 is CorrelatedTokenOracle {
+    /// @notice Address of stETH
+    IStETH public immutable STETH;
+
     /// @notice Constructor for the implementation contract.
+    /// @dev The underlyingToken must be correlated so that 1 underlyingToken is equal to 1 stETH, because
+    /// getUnderlyingAmount() implicitly assumes that
     constructor(
-        address wstETH,
         address stETH,
+        address wstETH,
+        address underlyingToken,
         address resilientOracle,
         uint256 annualGrowthRate,
         uint256 _snapshotInterval,
@@ -25,7 +32,7 @@ contract WstETHOracleV2 is CorrelatedTokenOracle {
     )
         CorrelatedTokenOracle(
             wstETH,
-            stETH,
+            underlyingToken,
             resilientOracle,
             annualGrowthRate,
             _snapshotInterval,
@@ -34,13 +41,16 @@ contract WstETHOracleV2 is CorrelatedTokenOracle {
             accessControlManager,
             _snapshotGap
         )
-    {}
+    {
+        ensureNonzeroAddress(stETH);
+        STETH = IStETH(stETH);
+    }
 
     /**
-     * @notice Gets the stETH for 1 wstETH
-     * @return amount Amount of stETH
+     * @notice Gets the amount of underlyingToken for 1 wstETH, assuming that 1 underlyingToken is equivalent to 1 stETH
+     * @return amount Amount of underlyingToken
      */
     function getUnderlyingAmount() public view override returns (uint256) {
-        return IStETH(UNDERLYING_TOKEN).getPooledEthByShares(EXP_SCALE);
+        return STETH.getPooledEthByShares(EXP_SCALE);
     }
 }

contracts/oracles/WstETHOracleV2.sol

@@ -0,0 +1,82 @@
+import { ethers } from "hardhat";
+import { DeployFunction } from "hardhat-deploy/dist/types";
+import { HardhatRuntimeEnvironment } from "hardhat/types";
+
+import { ADDRESSES } from "../helpers/deploymentConfig";
+import { isMainnet } from "../helpers/deploymentUtils";
+
+enum PendleRateKind {
+  PT_TO_ASSET = 0,
+  PT_TO_SY = 1,
+}
+
+const func: DeployFunction = async ({ getNamedAccounts, deployments, network }: HardhatRuntimeEnvironment) => {
+  const { deploy } = deployments;
+  const { deployer } = await getNamedAccounts();
+
+  const resilientOracle = await ethers.getContract("ResilientOracle");
+  const addresses = ADDRESSES[network.name];
+  const ptOracleAddress = addresses.PTOracle || (await ethers.getContract("MockPendlePtOracle")).address;
+
+  const commonParams = {
+    from: deployer,
+    log: true,
+    deterministicDeployment: false,
+    skipIfAlreadyDeployed: true,
+    waitConfirmations: 1,
+  };
+
+  await deploy("PendleOracle-PT-USDe-30OCT2025", {
+    contract: "PendleOracle",
+    args: [
+      {
+        market: addresses["PT-USDe-30OCT2025_Market"] || "0x0000000000000000000000000000000000000004",
+        ptOracle: ptOracleAddress,
+        rateKind: PendleRateKind.PT_TO_SY,
+        ptToken: addresses["PT-USDe-30OCT2025"],
+        underlyingToken: addresses.USDe,
+        resilientOracle: resilientOracle.address,
+        twapDuration: 1800,
+        annualGrowthRate: 0,
+        snapshotInterval: 0,
+        initialSnapshotMaxExchangeRate: 0,
+        initialSnapshotTimestamp: 0,
+        accessControlManager: addresses.acm,
+        snapshotGap: 0,
+      },
+    ],
+    ...commonParams,
+  });
+
+  if (isMainnet(network)) {
+    await deploy("PendleOracle-PT-USDe-30OCT2025_Reference_PtToAsset", {
+      contract: "PendleOracle",
+      from: deployer,
+      log: true,
+      deterministicDeployment: false,
+      args: [
+        {
+          market: addresses["PT-USDe-30OCT2025_Market"] || "0x0000000000000000000000000000000000000004",
+          ptOracle: ptOracleAddress,
+          rateKind: PendleRateKind.PT_TO_ASSET,
+          ptToken: addresses["PT-USDe-30OCT2025"],
+          underlyingToken: addresses.USDe,
+          resilientOracle: resilientOracle.address,
+          twapDuration: 1800,
+          annualGrowthRate: 0,
+          snapshotInterval: 0,
+          initialSnapshotMaxExchangeRate: 0,
+          initialSnapshotTimestamp: 0,
+          accessControlManager: addresses.acm,
+          snapshotGap: 0,
+        },
+      ],
+      skipIfAlreadyDeployed: true,
+    });
+  }
+};
+
+export default func;
+func.tags = ["PT-USDe"];
+func.skip = async (hre: HardhatRuntimeEnvironment) =>
+  hre.network.name !== "bsctestnet" && hre.network.name !== "bscmainnet";

deploy/24-deploy-USDe-pendle-oracles.ts

@@ -1,67 +1,96 @@
+import { BigNumber } from "ethers";
+import { parseUnits } from "ethers/lib/utils";
 import { ethers } from "hardhat";
 import { DeployFunction } from "hardhat-deploy/dist/types";
 import { HardhatRuntimeEnvironment } from "hardhat/types";
 
-import { ADDRESSES, addr0000, assets } from "../helpers/deploymentConfig";
+import {
+  ADDRESSES,
+  DAYS_30,
+  addr0000,
+  assets,
+  getSnapshotGap,
+  increaseExchangeRateByPercentage,
+} from "../helpers/deploymentConfig";
 
-const func: DeployFunction = async ({
-  getNamedAccounts,
-  deployments,
-  network,
-  artifacts,
-}: HardhatRuntimeEnvironment) => {
+const func: DeployFunction = async ({ getNamedAccounts, deployments, network }: HardhatRuntimeEnvironment) => {
   const { deploy } = deployments;
   const { deployer } = await getNamedAccounts();
 
-  console.log(`Deployer ${deployer}`);
-
-  const proxyOwnerAddress = network.live ? ADDRESSES[network.name].timelock : deployer;
-
-  const { stETHAddress, wstETHAddress } = ADDRESSES[network.name];
+  const { stETHAddress, wstETHAddress, acm } = ADDRESSES[network.name];
   const WETHAsset = assets[network.name].find(asset => asset.token === "WETH");
   const WETHAddress = WETHAsset?.address ?? addr0000;
 
-  const defaultProxyAdmin = await artifacts.readArtifact(
-    "hardhat-deploy/solc_0.8/openzeppelin/proxy/transparent/ProxyAdmin.sol:ProxyAdmin",
-  );
-
   const oracle = await ethers.getContract("ResilientOracle");
 
   // Equivalence and NonEquivalence is related to if the oracle will
   // assume 1/1 price ration between stETH/ETH or
   // will get stETH/USD price from secondary market
 
-  await deploy("WstETHOracle_Equivalence", {
-    contract: "WstETHOracle",
-    from: deployer,
-    log: true,
-    deterministicDeployment: false,
-    args: [wstETHAddress, WETHAddress, stETHAddress, oracle.address, true],
-    proxy: {
-      owner: proxyOwnerAddress,
-      proxyContract: "OptimizedTransparentUpgradeableProxy",
-      viaAdminContract: {
-        name: "DefaultProxyAdmin",
-        artifact: defaultProxyAdmin,
-      },
-    },
-  });
+  const wstETH_ANNUAL_GROWTH_RATE = ethers.utils.parseUnits("0.067", 18); // 6.7%
+  const block = await ethers.provider.getBlock("latest");
+  const stETHContract = await ethers.getContractAt("IStETH", stETHAddress);
+  const exchangeRate = await stETHContract.getPooledEthByShares(parseUnits("1", 18));
+  const snapshotGap = BigNumber.from("55"); // 0.55%
+
+  if (network.name === "ethereum") {
+    await deploy("WstETHOracle_Equivalence", {
+      contract: "WstETHOracleV2",
+      from: deployer,
+      log: true,
+      deterministicDeployment: false,
+      args: [
+        stETHAddress,
+        wstETHAddress,
+        WETHAddress,
+        oracle.address,
+        wstETH_ANNUAL_GROWTH_RATE,
+        DAYS_30,
+        increaseExchangeRateByPercentage(exchangeRate, snapshotGap),
+        block.timestamp,
+        acm,
+        getSnapshotGap(exchangeRate, snapshotGap.toNumber()),
+      ],
+    });
 
-  await deploy("WstETHOracle_NonEquivalence", {
-    contract: "WstETHOracle",
-    from: deployer,
-    log: true,
-    deterministicDeployment: false,
-    args: [wstETHAddress, WETHAddress, stETHAddress, oracle.address, false],
-    proxy: {
-      owner: proxyOwnerAddress,
-      proxyContract: "OptimizedTransparentUpgradeableProxy",
-      viaAdminContract: {
-        name: "DefaultProxyAdmin",
-        artifact: defaultProxyAdmin,
-      },
-    },
-  });
+    await deploy("WstETHOracle_NonEquivalence", {
+      contract: "WstETHOracleV2",
+      from: deployer,
+      log: true,
+      deterministicDeployment: false,
+      args: [
+        stETHAddress,
+        wstETHAddress,
+        stETHAddress,
+        oracle.address,
+        wstETH_ANNUAL_GROWTH_RATE,
+        DAYS_30,
+        increaseExchangeRateByPercentage(exchangeRate, snapshotGap),
+        block.timestamp,
+        acm,
+        getSnapshotGap(exchangeRate, snapshotGap.toNumber()),
+      ],
+    });
+  } else {
+    await deploy("WstETHOracle", {
+      contract: "WstETHOracleV2",
+      from: deployer,
+      log: true,
+      deterministicDeployment: false,
+      args: [
+        stETHAddress,
+        wstETHAddress,
+        WETHAddress,
+        oracle.address,
+        wstETH_ANNUAL_GROWTH_RATE,
+        DAYS_30,
+        increaseExchangeRateByPercentage(exchangeRate, snapshotGap),
+        block.timestamp,
+        acm,
+        getSnapshotGap(exchangeRate, snapshotGap.toNumber()),
+      ],
+    });
+  }
 };
 
 export default func;