From fc52a39b0033916df264551d5364ed43f1ca79da Mon Sep 17 00:00:00 2001 From: Narayan Prusty Date: Wed, 8 May 2024 16:47:01 +0530 Subject: [PATCH 01/26] fix: use sfrxEthFraxOracle oracle --- contracts/interfaces/ISfrxEthFraxOracle.sol | 6 ++++ contracts/oracles/SFrxETHOracle.sol | 32 +++++++++++++++++---- 2 files changed, 32 insertions(+), 6 deletions(-) create mode 100644 contracts/interfaces/ISfrxEthFraxOracle.sol diff --git a/contracts/interfaces/ISfrxEthFraxOracle.sol b/contracts/interfaces/ISfrxEthFraxOracle.sol new file mode 100644 index 00000000..8d16c435 --- /dev/null +++ b/contracts/interfaces/ISfrxEthFraxOracle.sol @@ -0,0 +1,6 @@ +// SPDX-License-Identifier: BSD-3-Clause +pragma solidity 0.8.25; + +interface ISfrxEthFraxOracle { + function getPrices() external view returns (bool _isbadData, uint256 _priceLow, uint256 _priceHigh); +} diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index e100f4c8..6f188dc7 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -1,8 +1,9 @@ // SPDX-License-Identifier: BSD-3-Clause pragma solidity 0.8.25; -import { ISfrxETH } from "../interfaces/ISfrxETH.sol"; import { CorrelatedTokenOracle } from "./common/CorrelatedTokenOracle.sol"; +import { ISfrxEthFraxOracle } from "../interfaces/ISfrxEthFraxOracle.sol"; +import { ensureNonzeroAddress } from "@venusprotocol/solidity-utilities/contracts/validators.sol"; import { EXP_SCALE } from "@venusprotocol/solidity-utilities/contracts/constants.sol"; /** @@ -11,19 +12,38 @@ import { EXP_SCALE } from "@venusprotocol/solidity-utilities/contracts/constants * @notice This oracle fetches the price of sfrxETH */ contract SFrxETHOracle is CorrelatedTokenOracle { + /// @notice Address of SfrxEthFraxOracle + /// @custom:oz-upgrades-unsafe-allow state-variable-immutable + ISfrxEthFraxOracle public immutable SFRXETH_FRAX_ORACLE; + + /// @notice Thrown if the price data is invalid + error BadPriceData(); + /// @notice Constructor for the implementation contract. /// @custom:oz-upgrades-unsafe-allow constructor constructor( + address sfrxEthFraxOracle, address sfrxETH, - address frxETH, + address frax, address resilientOracle - ) CorrelatedTokenOracle(sfrxETH, frxETH, resilientOracle) {} + ) CorrelatedTokenOracle(sfrxETH, frax, resilientOracle) { + ensureNonzeroAddress(sfrxEthFraxOracle); + SFRXETH_FRAX_ORACLE = ISfrxEthFraxOracle(sfrxEthFraxOracle); + } /** - * @notice Gets the frxETH for 1 sfrxETH - * @return amount Amount of frxETH + * @notice Gets the FRAX for 1 sfrxETH + * @return amount Amount of FRAX */ function _getUnderlyingAmount() internal view override returns (uint256) { - return ISfrxETH(CORRELATED_TOKEN).convertToAssets(EXP_SCALE); + (bool isBadData, uint256 priceLow, uint256 priceHigh) = SFRXETH_FRAX_ORACLE.getPrices(); + + if (isBadData) revert BadPriceData(); + + // calculate average price + uint256 averagePrice = (priceLow + priceHigh) / 2; + + // return (1 / averagePrice) as the average price is in sfraxETH + return EXP_SCALE * 2 / averagePrice; } } From 6f47ec2c70152c580bf13023c96e2b34a8f12e52 Mon Sep 17 00:00:00 2001 From: Narayan Prusty Date: Wed, 8 May 2024 16:48:37 +0530 Subject: [PATCH 02/26] fix: removed ISfrxETH --- contracts/interfaces/ISfrxETH.sol | 7 ------- 1 file changed, 7 deletions(-) delete mode 100644 contracts/interfaces/ISfrxETH.sol diff --git a/contracts/interfaces/ISfrxETH.sol b/contracts/interfaces/ISfrxETH.sol deleted file mode 100644 index 02b6c4ad..00000000 --- a/contracts/interfaces/ISfrxETH.sol +++ /dev/null @@ -1,7 +0,0 @@ -// SPDX-License-Identifier: BSD-3-Clause -pragma solidity 0.8.25; - -interface ISfrxETH { - function convertToAssets(uint256 shares) external view returns (uint256); - function decimals() external view returns (uint8); -} From 02062182753393f1d982448e043f601226122aef Mon Sep 17 00:00:00 2001 From: Narayan Prusty Date: Wed, 8 May 2024 17:08:23 +0530 Subject: [PATCH 03/26] fix: fixed tests --- contracts/oracles/SFrxETHOracle.sol | 2 +- .../oracles/mocks/MockSFrxEthFraxOracle.sol | 23 +++++++++++ helpers/deploymentConfig.ts | 1 + test/SFrxETHOracle.ts | 40 ++++++++++++------- 4 files changed, 51 insertions(+), 15 deletions(-) create mode 100644 contracts/oracles/mocks/MockSFrxEthFraxOracle.sol diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index 6f188dc7..f05bd0ff 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -44,6 +44,6 @@ contract SFrxETHOracle is CorrelatedTokenOracle { uint256 averagePrice = (priceLow + priceHigh) / 2; // return (1 / averagePrice) as the average price is in sfraxETH - return EXP_SCALE * 2 / averagePrice; + return (EXP_SCALE ** 2) / averagePrice; } } diff --git a/contracts/oracles/mocks/MockSFrxEthFraxOracle.sol b/contracts/oracles/mocks/MockSFrxEthFraxOracle.sol new file mode 100644 index 00000000..8b23ff48 --- /dev/null +++ b/contracts/oracles/mocks/MockSFrxEthFraxOracle.sol @@ -0,0 +1,23 @@ +// SPDX-License-Identifier: BSD-3-Clause +pragma solidity 0.8.25; + +import "../../interfaces/ISfrxEthFraxOracle.sol"; +import "@openzeppelin/contracts/access/Ownable.sol"; + +contract MockSfrxEthFraxOracle is ISfrxEthFraxOracle, Ownable { + bool public isBadData; + uint256 public priceLow; + uint256 public priceHigh; + + constructor() Ownable() {} + + function setPrices(bool _isBadData, uint256 _priceLow, uint256 _priceHigh) external onlyOwner { + isBadData = _isBadData; + priceLow = _priceLow; + priceHigh = _priceHigh; + } + + function getPrices() external view override returns (bool, uint256, uint256) { + return (isBadData, priceLow, priceHigh); + } +} diff --git a/helpers/deploymentConfig.ts b/helpers/deploymentConfig.ts index a194003b..a5167e1f 100644 --- a/helpers/deploymentConfig.ts +++ b/helpers/deploymentConfig.ts @@ -129,6 +129,7 @@ export const ADDRESSES: PreconfiguredAddresses = { PTOracle: "0xbbd487268A295531d299c125F3e5f749884A3e30", EtherFiLiquidityPool: "0x308861A430be4cce5502d0A12724771Fc6DaF216", WETH: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", + SfrxEthFraxOracle: "0x3d3D868522b5a4035ADcb67BF0846D61597A6a6F" }, opbnbtestnet: { vBNBAddress: ethers.constants.AddressZero, diff --git a/test/SFrxETHOracle.ts b/test/SFrxETHOracle.ts index 3111ca3e..b94448cb 100644 --- a/test/SFrxETHOracle.ts +++ b/test/SFrxETHOracle.ts @@ -4,13 +4,13 @@ import { parseUnits } from "ethers/lib/utils"; import { ethers } from "hardhat"; import { ADDRESSES } from "../helpers/deploymentConfig"; -import { BEP20Harness, ISfrxETH, ResilientOracleInterface } from "../typechain-types"; +import { BEP20Harness, ISfrxEthFraxOracle, ResilientOracleInterface } from "../typechain-types"; import { addr0000 } from "./utils/data"; const { expect } = chai; chai.use(smock.matchers); -const { sfrxETH, frxETH } = ADDRESSES.ethereum; +const { sfrxETH, FRAX } = ADDRESSES.ethereum; const ETH_USD_PRICE = parseUnits("3100", 18); // 3100 USD for 1 ETH describe("SFrxETHOracle unit tests", () => { @@ -18,35 +18,47 @@ describe("SFrxETHOracle unit tests", () => { let sfrxETHMock; let SFrxETHOracleFactory; let SFrxETHOracle; - let frxETHMock; + let fraxMock; + let sfrxEthFraxOracleMock; before(async () => { // To initialize the provider we need to hit the node with any request await ethers.getSigners(); resilientOracleMock = await smock.fake("ResilientOracleInterface"); - sfrxETHMock = await smock.fake("ISfrxETH", { address: sfrxETH }); - sfrxETHMock.convertToAssets.returns(parseUnits("1.076546447254363344", 18)); - sfrxETHMock.decimals.returns(18); + // deploy MockSfrxEthFraxOracle + const sfrxEthFraxOracleMockFactory = await ethers.getContractFactory("MockSfrxEthFraxOracle"); + sfrxEthFraxOracleMock = await sfrxEthFraxOracleMockFactory.deploy(); + await sfrxEthFraxOracleMock.deployed(); + await sfrxEthFraxOracleMock.setPrices(false, parseUnits("0.000306430391670677", 18), parseUnits("0.000309520800596522", 18)); + + fraxMock = await smock.fake("BEP20Harness", { address: FRAX }); + fraxMock.decimals.returns(18); - frxETHMock = await smock.fake("BEP20Harness", { address: frxETH }); - frxETHMock.decimals.returns(18); + sfrxETHMock = await smock.fake("BEP20Harness", { address: sfrxETH }); + sfrxETHMock.decimals.returns(18); SFrxETHOracleFactory = await ethers.getContractFactory("SFrxETHOracle"); }); describe("deployment", () => { - it("revert if frxETH address is 0", async () => { - await expect(SFrxETHOracleFactory.deploy(sfrxETHMock.address, addr0000, resilientOracleMock.address)).to.be + it("revert if frax address is 0", async () => { + await expect(SFrxETHOracleFactory.deploy(sfrxEthFraxOracleMock.address, sfrxETHMock.address, addr0000, resilientOracleMock.address)).to.be .reverted; }); it("revert if sfrxETH address is 0", async () => { - await expect(SFrxETHOracleFactory.deploy(addr0000, frxETHMock.address, resilientOracleMock.address)).to.be + await expect(SFrxETHOracleFactory.deploy(sfrxEthFraxOracleMock.address, addr0000, fraxMock.address, resilientOracleMock.address)).to.be + .reverted; + }); + + it("revert if sfrxEthFraxOracle address is 0", async () => { + await expect(SFrxETHOracleFactory.deploy(addr0000, sfrxETHMock.address, fraxMock.address, resilientOracleMock.address)).to.be .reverted; }); it("should deploy contract", async () => { SFrxETHOracle = await SFrxETHOracleFactory.deploy( + sfrxEthFraxOracleMock.address, sfrxETHMock.address, - frxETHMock.address, + fraxMock.address, resilientOracleMock.address, ); }); @@ -61,9 +73,9 @@ describe("SFrxETHOracle unit tests", () => { }); it("should get correct price of sfrxETH", async () => { - resilientOracleMock.getPrice.returns(ETH_USD_PRICE); + resilientOracleMock.getPrice.returns(parseUnits("0.99838881", 18)); const price = await SFrxETHOracle.getPrice(sfrxETHMock.address); - expect(price).to.equal(parseUnits("3337.2939864885263664", 18)); + expect(price).to.equal(parseUnits("3241.778967340326445028", 18)); }); }); }); From 2a109374d3c40aef882bfc8b067548dd9b9aa937 Mon Sep 17 00:00:00 2001 From: Narayan Prusty Date: Wed, 8 May 2024 17:19:24 +0530 Subject: [PATCH 04/26] fix: added acm --- contracts/oracles/SFrxETHOracle.sol | 17 ++++++++++++++++- test/SFrxETHOracle.ts | 8 +++++++- 2 files changed, 23 insertions(+), 2 deletions(-) diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index f05bd0ff..e037bf7e 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -5,20 +5,27 @@ import { CorrelatedTokenOracle } from "./common/CorrelatedTokenOracle.sol"; import { ISfrxEthFraxOracle } from "../interfaces/ISfrxEthFraxOracle.sol"; import { ensureNonzeroAddress } from "@venusprotocol/solidity-utilities/contracts/validators.sol"; import { EXP_SCALE } from "@venusprotocol/solidity-utilities/contracts/constants.sol"; +import {AccessControlledV8} from "@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol"; /** * @title SFrxETHOracle * @author Venus * @notice This oracle fetches the price of sfrxETH */ -contract SFrxETHOracle is CorrelatedTokenOracle { +contract SFrxETHOracle is CorrelatedTokenOracle, AccessControlledV8 { /// @notice Address of SfrxEthFraxOracle /// @custom:oz-upgrades-unsafe-allow state-variable-immutable ISfrxEthFraxOracle public immutable SFRXETH_FRAX_ORACLE; + /// @notice Maximum allowed price difference + uint256 public maxAllowedPriceDifference; + /// @notice Thrown if the price data is invalid error BadPriceData(); + /// @notice Thrown if the price difference exceeds the allowed limit + error PriceDifferenceExceeded(); + /// @notice Constructor for the implementation contract. /// @custom:oz-upgrades-unsafe-allow constructor constructor( @@ -31,6 +38,14 @@ contract SFrxETHOracle is CorrelatedTokenOracle { SFRXETH_FRAX_ORACLE = ISfrxEthFraxOracle(sfrxEthFraxOracle); } + /** + * @notice Sets the contracts required to fetch prices + * @param _accessControlManager Address of the access control manager contract + */ + function initialize(address _accessControlManager) external initializer { + __AccessControlled_init(_accessControlManager); + } + /** * @notice Gets the FRAX for 1 sfrxETH * @return amount Amount of FRAX diff --git a/test/SFrxETHOracle.ts b/test/SFrxETHOracle.ts index b94448cb..93ba9057 100644 --- a/test/SFrxETHOracle.ts +++ b/test/SFrxETHOracle.ts @@ -4,7 +4,7 @@ import { parseUnits } from "ethers/lib/utils"; import { ethers } from "hardhat"; import { ADDRESSES } from "../helpers/deploymentConfig"; -import { BEP20Harness, ISfrxEthFraxOracle, ResilientOracleInterface } from "../typechain-types"; +import { AccessControlManager, BEP20Harness, ISfrxEthFraxOracle, ResilientOracleInterface } from "../typechain-types"; import { addr0000 } from "./utils/data"; const { expect } = chai; @@ -20,6 +20,7 @@ describe("SFrxETHOracle unit tests", () => { let SFrxETHOracle; let fraxMock; let sfrxEthFraxOracleMock; + let fakeAccessControlManager; before(async () => { // To initialize the provider we need to hit the node with any request await ethers.getSigners(); @@ -38,6 +39,9 @@ describe("SFrxETHOracle unit tests", () => { sfrxETHMock.decimals.returns(18); SFrxETHOracleFactory = await ethers.getContractFactory("SFrxETHOracle"); + + fakeAccessControlManager = await smock.fake("AccessControlManagerScenario"); + fakeAccessControlManager.isAllowedToCall.returns(true); }); describe("deployment", () => { @@ -61,6 +65,8 @@ describe("SFrxETHOracle unit tests", () => { fraxMock.address, resilientOracleMock.address, ); + + await SFrxETHOracle.initialize(fakeAccessControlManager.address); }); }); From 526eacfaa0f193e13e1e5fa66c1b638106f4753e Mon Sep 17 00:00:00 2001 From: Narayan Prusty Date: Wed, 8 May 2024 17:37:45 +0530 Subject: [PATCH 05/26] fix: added price difference check --- contracts/oracles/SFrxETHOracle.sol | 25 ++++++++++++---- helpers/deploymentConfig.ts | 2 +- test/SFrxETHOracle.ts | 46 ++++++++++++++++++++++------- 3 files changed, 56 insertions(+), 17 deletions(-) diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index e037bf7e..c5f85386 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -5,7 +5,7 @@ import { CorrelatedTokenOracle } from "./common/CorrelatedTokenOracle.sol"; import { ISfrxEthFraxOracle } from "../interfaces/ISfrxEthFraxOracle.sol"; import { ensureNonzeroAddress } from "@venusprotocol/solidity-utilities/contracts/validators.sol"; import { EXP_SCALE } from "@venusprotocol/solidity-utilities/contracts/constants.sol"; -import {AccessControlledV8} from "@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol"; +import { AccessControlledV8 } from "@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol"; /** * @title SFrxETHOracle @@ -20,6 +20,9 @@ contract SFrxETHOracle is CorrelatedTokenOracle, AccessControlledV8 { /// @notice Maximum allowed price difference uint256 public maxAllowedPriceDifference; + /// @notice Emits when the maximum allowed price difference is updated + event MaxAllowedPriceDifferenceUpdated(uint256 oldMaxAllowedPriceDifference, uint256 newMaxAllowedPriceDifference); + /// @notice Thrown if the price data is invalid error BadPriceData(); @@ -46,6 +49,12 @@ contract SFrxETHOracle is CorrelatedTokenOracle, AccessControlledV8 { __AccessControlled_init(_accessControlManager); } + function setMaxAllowedPriceDifference(uint256 _maxAllowedPriceDifference) external { + _checkAccessAllowed("setMaxAllowedPriceDifference(uint256)"); + emit MaxAllowedPriceDifferenceUpdated(maxAllowedPriceDifference, _maxAllowedPriceDifference); + maxAllowedPriceDifference = _maxAllowedPriceDifference; + } + /** * @notice Gets the FRAX for 1 sfrxETH * @return amount Amount of FRAX @@ -54,11 +63,15 @@ contract SFrxETHOracle is CorrelatedTokenOracle, AccessControlledV8 { (bool isBadData, uint256 priceLow, uint256 priceHigh) = SFRXETH_FRAX_ORACLE.getPrices(); if (isBadData) revert BadPriceData(); - - // calculate average price - uint256 averagePrice = (priceLow + priceHigh) / 2; - // return (1 / averagePrice) as the average price is in sfraxETH - return (EXP_SCALE ** 2) / averagePrice; + // calculate price in FRAX + uint256 priceLowInFrax = (EXP_SCALE ** 2) / priceLow; + uint256 priceHighInFrax = (EXP_SCALE ** 2) / priceHigh; + + // validate price difference + if (priceLowInFrax - priceHighInFrax > maxAllowedPriceDifference) revert PriceDifferenceExceeded(); + + // calculate and return average price + return (priceLowInFrax + priceHighInFrax) / 2; } } diff --git a/helpers/deploymentConfig.ts b/helpers/deploymentConfig.ts index a5167e1f..187984ee 100644 --- a/helpers/deploymentConfig.ts +++ b/helpers/deploymentConfig.ts @@ -129,7 +129,7 @@ export const ADDRESSES: PreconfiguredAddresses = { PTOracle: "0xbbd487268A295531d299c125F3e5f749884A3e30", EtherFiLiquidityPool: "0x308861A430be4cce5502d0A12724771Fc6DaF216", WETH: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", - SfrxEthFraxOracle: "0x3d3D868522b5a4035ADcb67BF0846D61597A6a6F" + SfrxEthFraxOracle: "0x3d3D868522b5a4035ADcb67BF0846D61597A6a6F", }, opbnbtestnet: { vBNBAddress: ethers.constants.AddressZero, diff --git a/test/SFrxETHOracle.ts b/test/SFrxETHOracle.ts index 93ba9057..a107793a 100644 --- a/test/SFrxETHOracle.ts +++ b/test/SFrxETHOracle.ts @@ -4,14 +4,13 @@ import { parseUnits } from "ethers/lib/utils"; import { ethers } from "hardhat"; import { ADDRESSES } from "../helpers/deploymentConfig"; -import { AccessControlManager, BEP20Harness, ISfrxEthFraxOracle, ResilientOracleInterface } from "../typechain-types"; +import { AccessControlManager, BEP20Harness, ResilientOracleInterface } from "../typechain-types"; import { addr0000 } from "./utils/data"; const { expect } = chai; chai.use(smock.matchers); const { sfrxETH, FRAX } = ADDRESSES.ethereum; -const ETH_USD_PRICE = parseUnits("3100", 18); // 3100 USD for 1 ETH describe("SFrxETHOracle unit tests", () => { let resilientOracleMock; @@ -30,7 +29,11 @@ describe("SFrxETHOracle unit tests", () => { const sfrxEthFraxOracleMockFactory = await ethers.getContractFactory("MockSfrxEthFraxOracle"); sfrxEthFraxOracleMock = await sfrxEthFraxOracleMockFactory.deploy(); await sfrxEthFraxOracleMock.deployed(); - await sfrxEthFraxOracleMock.setPrices(false, parseUnits("0.000306430391670677", 18), parseUnits("0.000309520800596522", 18)); + await sfrxEthFraxOracleMock.setPrices( + false, + parseUnits("0.000306430391670677", 18), + parseUnits("0.000309520800596522", 18), + ); fraxMock = await smock.fake("BEP20Harness", { address: FRAX }); fraxMock.decimals.returns(18); @@ -46,17 +49,30 @@ describe("SFrxETHOracle unit tests", () => { describe("deployment", () => { it("revert if frax address is 0", async () => { - await expect(SFrxETHOracleFactory.deploy(sfrxEthFraxOracleMock.address, sfrxETHMock.address, addr0000, resilientOracleMock.address)).to.be - .reverted; + await expect( + SFrxETHOracleFactory.deploy( + sfrxEthFraxOracleMock.address, + sfrxETHMock.address, + addr0000, + resilientOracleMock.address, + ), + ).to.be.reverted; }); it("revert if sfrxETH address is 0", async () => { - await expect(SFrxETHOracleFactory.deploy(sfrxEthFraxOracleMock.address, addr0000, fraxMock.address, resilientOracleMock.address)).to.be - .reverted; + await expect( + SFrxETHOracleFactory.deploy( + sfrxEthFraxOracleMock.address, + addr0000, + fraxMock.address, + resilientOracleMock.address, + ), + ).to.be.reverted; }); it("revert if sfrxEthFraxOracle address is 0", async () => { - await expect(SFrxETHOracleFactory.deploy(addr0000, sfrxETHMock.address, fraxMock.address, resilientOracleMock.address)).to.be - .reverted; + await expect( + SFrxETHOracleFactory.deploy(addr0000, sfrxETHMock.address, fraxMock.address, resilientOracleMock.address), + ).to.be.reverted; }); it("should deploy contract", async () => { SFrxETHOracle = await SFrxETHOracleFactory.deploy( @@ -78,10 +94,20 @@ describe("SFrxETHOracle unit tests", () => { ); }); + it("revert if price difference is more than allowed", async () => { + resilientOracleMock.getPrice.returns(parseUnits("0.99838881", 18)); + await SFrxETHOracle.setMaxAllowedPriceDifference(parseUnits("1", 18)); + await expect(SFrxETHOracle.getPrice(sfrxETHMock.address)).to.be.revertedWithCustomError( + SFrxETHOracle, + "PriceDifferenceExceeded", + ); + }); + it("should get correct price of sfrxETH", async () => { resilientOracleMock.getPrice.returns(parseUnits("0.99838881", 18)); + await SFrxETHOracle.setMaxAllowedPriceDifference(parseUnits("300", 18)); const price = await SFrxETHOracle.getPrice(sfrxETHMock.address); - expect(price).to.equal(parseUnits("3241.778967340326445028", 18)); + expect(price).to.equal(parseUnits("3241.860575508872480501", 18)); }); }); }); From f475e6b5c3de15ecf705b9b7a9fef805acc32622 Mon Sep 17 00:00:00 2001 From: Narayan Prusty Date: Wed, 8 May 2024 22:44:22 +0530 Subject: [PATCH 06/26] fix: remove correlated token oracle --- contracts/oracles/SFrxETHOracle.sol | 31 +++++++++++-------- test/SFrxETHOracle.ts | 47 +++++------------------------ 2 files changed, 25 insertions(+), 53 deletions(-) diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index c5f85386..5af0253f 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -1,7 +1,6 @@ // SPDX-License-Identifier: BSD-3-Clause pragma solidity 0.8.25; -import { CorrelatedTokenOracle } from "./common/CorrelatedTokenOracle.sol"; import { ISfrxEthFraxOracle } from "../interfaces/ISfrxEthFraxOracle.sol"; import { ensureNonzeroAddress } from "@venusprotocol/solidity-utilities/contracts/validators.sol"; import { EXP_SCALE } from "@venusprotocol/solidity-utilities/contracts/constants.sol"; @@ -12,7 +11,7 @@ import { AccessControlledV8 } from "@venusprotocol/governance-contracts/contract * @author Venus * @notice This oracle fetches the price of sfrxETH */ -contract SFrxETHOracle is CorrelatedTokenOracle, AccessControlledV8 { +contract SFrxETHOracle is AccessControlledV8 { /// @notice Address of SfrxEthFraxOracle /// @custom:oz-upgrades-unsafe-allow state-variable-immutable ISfrxEthFraxOracle public immutable SFRXETH_FRAX_ORACLE; @@ -20,6 +19,9 @@ contract SFrxETHOracle is CorrelatedTokenOracle, AccessControlledV8 { /// @notice Maximum allowed price difference uint256 public maxAllowedPriceDifference; + /// @notice Address of sfrxETH + address public sfrxETH; + /// @notice Emits when the maximum allowed price difference is updated event MaxAllowedPriceDifferenceUpdated(uint256 oldMaxAllowedPriceDifference, uint256 newMaxAllowedPriceDifference); @@ -29,16 +31,16 @@ contract SFrxETHOracle is CorrelatedTokenOracle, AccessControlledV8 { /// @notice Thrown if the price difference exceeds the allowed limit error PriceDifferenceExceeded(); + /// @notice Thrown if the token address is invalid + error InvalidTokenAddress(); + /// @notice Constructor for the implementation contract. /// @custom:oz-upgrades-unsafe-allow constructor - constructor( - address sfrxEthFraxOracle, - address sfrxETH, - address frax, - address resilientOracle - ) CorrelatedTokenOracle(sfrxETH, frax, resilientOracle) { - ensureNonzeroAddress(sfrxEthFraxOracle); - SFRXETH_FRAX_ORACLE = ISfrxEthFraxOracle(sfrxEthFraxOracle); + constructor(address _sfrxEthFraxOracle, address _sfrxETH) { + ensureNonzeroAddress(_sfrxEthFraxOracle); + ensureNonzeroAddress(_sfrxETH); + SFRXETH_FRAX_ORACLE = ISfrxEthFraxOracle(_sfrxEthFraxOracle); + sfrxETH = _sfrxETH; } /** @@ -56,10 +58,13 @@ contract SFrxETHOracle is CorrelatedTokenOracle, AccessControlledV8 { } /** - * @notice Gets the FRAX for 1 sfrxETH - * @return amount Amount of FRAX + * @notice Fetches the price of sfrxETH + * @param asset Address of the sfrxETH token + * @return price The price scaled by 1e18 */ - function _getUnderlyingAmount() internal view override returns (uint256) { + function getPrice(address asset) external view returns (uint256) { + if (asset != sfrxETH) revert InvalidTokenAddress(); + (bool isBadData, uint256 priceLow, uint256 priceHigh) = SFRXETH_FRAX_ORACLE.getPrices(); if (isBadData) revert BadPriceData(); diff --git a/test/SFrxETHOracle.ts b/test/SFrxETHOracle.ts index a107793a..1e5917f8 100644 --- a/test/SFrxETHOracle.ts +++ b/test/SFrxETHOracle.ts @@ -4,26 +4,23 @@ import { parseUnits } from "ethers/lib/utils"; import { ethers } from "hardhat"; import { ADDRESSES } from "../helpers/deploymentConfig"; -import { AccessControlManager, BEP20Harness, ResilientOracleInterface } from "../typechain-types"; +import { AccessControlManager, BEP20Harness } from "../typechain-types"; import { addr0000 } from "./utils/data"; const { expect } = chai; chai.use(smock.matchers); -const { sfrxETH, FRAX } = ADDRESSES.ethereum; +const { sfrxETH } = ADDRESSES.ethereum; describe("SFrxETHOracle unit tests", () => { - let resilientOracleMock; let sfrxETHMock; let SFrxETHOracleFactory; let SFrxETHOracle; - let fraxMock; let sfrxEthFraxOracleMock; let fakeAccessControlManager; before(async () => { // To initialize the provider we need to hit the node with any request await ethers.getSigners(); - resilientOracleMock = await smock.fake("ResilientOracleInterface"); // deploy MockSfrxEthFraxOracle const sfrxEthFraxOracleMockFactory = await ethers.getContractFactory("MockSfrxEthFraxOracle"); @@ -35,9 +32,6 @@ describe("SFrxETHOracle unit tests", () => { parseUnits("0.000309520800596522", 18), ); - fraxMock = await smock.fake("BEP20Harness", { address: FRAX }); - fraxMock.decimals.returns(18); - sfrxETHMock = await smock.fake("BEP20Harness", { address: sfrxETH }); sfrxETHMock.decimals.returns(18); @@ -48,39 +42,14 @@ describe("SFrxETHOracle unit tests", () => { }); describe("deployment", () => { - it("revert if frax address is 0", async () => { - await expect( - SFrxETHOracleFactory.deploy( - sfrxEthFraxOracleMock.address, - sfrxETHMock.address, - addr0000, - resilientOracleMock.address, - ), - ).to.be.reverted; + it("revert if SfrxEthFraxOracle address is 0", async () => { + await expect(SFrxETHOracleFactory.deploy(addr0000, sfrxETHMock.address)).to.be.reverted; }); it("revert if sfrxETH address is 0", async () => { - await expect( - SFrxETHOracleFactory.deploy( - sfrxEthFraxOracleMock.address, - addr0000, - fraxMock.address, - resilientOracleMock.address, - ), - ).to.be.reverted; - }); - - it("revert if sfrxEthFraxOracle address is 0", async () => { - await expect( - SFrxETHOracleFactory.deploy(addr0000, sfrxETHMock.address, fraxMock.address, resilientOracleMock.address), - ).to.be.reverted; + await expect(SFrxETHOracleFactory.deploy(sfrxEthFraxOracleMock.address, addr0000)).to.be.reverted; }); it("should deploy contract", async () => { - SFrxETHOracle = await SFrxETHOracleFactory.deploy( - sfrxEthFraxOracleMock.address, - sfrxETHMock.address, - fraxMock.address, - resilientOracleMock.address, - ); + SFrxETHOracle = await SFrxETHOracleFactory.deploy(sfrxEthFraxOracleMock.address, sfrxETHMock.address); await SFrxETHOracle.initialize(fakeAccessControlManager.address); }); @@ -95,7 +64,6 @@ describe("SFrxETHOracle unit tests", () => { }); it("revert if price difference is more than allowed", async () => { - resilientOracleMock.getPrice.returns(parseUnits("0.99838881", 18)); await SFrxETHOracle.setMaxAllowedPriceDifference(parseUnits("1", 18)); await expect(SFrxETHOracle.getPrice(sfrxETHMock.address)).to.be.revertedWithCustomError( SFrxETHOracle, @@ -104,10 +72,9 @@ describe("SFrxETHOracle unit tests", () => { }); it("should get correct price of sfrxETH", async () => { - resilientOracleMock.getPrice.returns(parseUnits("0.99838881", 18)); await SFrxETHOracle.setMaxAllowedPriceDifference(parseUnits("300", 18)); const price = await SFrxETHOracle.getPrice(sfrxETHMock.address); - expect(price).to.equal(parseUnits("3241.860575508872480501", 18)); + expect(price).to.equal(parseUnits("3247.092258084175122617", 18)); }); }); }); From 95e049416e75cda023c323d7faaa3fddee115682 Mon Sep 17 00:00:00 2001 From: Narayan Prusty Date: Wed, 8 May 2024 22:45:28 +0530 Subject: [PATCH 07/26] fix: make sfrxETH immutable --- contracts/oracles/SFrxETHOracle.sol | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index 5af0253f..b3f3493b 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -20,7 +20,7 @@ contract SFrxETHOracle is AccessControlledV8 { uint256 public maxAllowedPriceDifference; /// @notice Address of sfrxETH - address public sfrxETH; + address public immutable SFRXETH; /// @notice Emits when the maximum allowed price difference is updated event MaxAllowedPriceDifferenceUpdated(uint256 oldMaxAllowedPriceDifference, uint256 newMaxAllowedPriceDifference); @@ -40,7 +40,7 @@ contract SFrxETHOracle is AccessControlledV8 { ensureNonzeroAddress(_sfrxEthFraxOracle); ensureNonzeroAddress(_sfrxETH); SFRXETH_FRAX_ORACLE = ISfrxEthFraxOracle(_sfrxEthFraxOracle); - sfrxETH = _sfrxETH; + SFRXETH = _sfrxETH; } /** @@ -63,7 +63,7 @@ contract SFrxETHOracle is AccessControlledV8 { * @return price The price scaled by 1e18 */ function getPrice(address asset) external view returns (uint256) { - if (asset != sfrxETH) revert InvalidTokenAddress(); + if (asset != SFRXETH) revert InvalidTokenAddress(); (bool isBadData, uint256 priceLow, uint256 priceHigh) = SFRXETH_FRAX_ORACLE.getPrices(); From a46c67d8b95648dc7ba3bb38fb808cb1dd4dc6dc Mon Sep 17 00:00:00 2001 From: Narayan Prusty Date: Wed, 8 May 2024 22:46:13 +0530 Subject: [PATCH 08/26] fix: changed order --- contracts/oracles/SFrxETHOracle.sol | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index b3f3493b..14227c2a 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -16,12 +16,12 @@ contract SFrxETHOracle is AccessControlledV8 { /// @custom:oz-upgrades-unsafe-allow state-variable-immutable ISfrxEthFraxOracle public immutable SFRXETH_FRAX_ORACLE; - /// @notice Maximum allowed price difference - uint256 public maxAllowedPriceDifference; - /// @notice Address of sfrxETH address public immutable SFRXETH; + /// @notice Maximum allowed price difference + uint256 public maxAllowedPriceDifference; + /// @notice Emits when the maximum allowed price difference is updated event MaxAllowedPriceDifferenceUpdated(uint256 oldMaxAllowedPriceDifference, uint256 newMaxAllowedPriceDifference); From 3058ef1a794a73a43c43a792af0309fc33ccf852 Mon Sep 17 00:00:00 2001 From: Narayan Prusty <7037606+narayanprusty@users.noreply.github.com> Date: Thu, 9 May 2024 16:10:02 +0530 Subject: [PATCH 09/26] fix: fix comment Co-authored-by: Jesus Lanchas Signed-off-by: Narayan Prusty <7037606+narayanprusty@users.noreply.github.com> --- contracts/oracles/SFrxETHOracle.sol | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index 14227c2a..0275ba57 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -58,7 +58,7 @@ contract SFrxETHOracle is AccessControlledV8 { } /** - * @notice Fetches the price of sfrxETH + * @notice Fetches the USD price of sfrxETH * @param asset Address of the sfrxETH token * @return price The price scaled by 1e18 */ From fc62a15d090b7d8e7577a5dbcf07a6a39cbb57f0 Mon Sep 17 00:00:00 2001 From: Narayan Prusty <7037606+narayanprusty@users.noreply.github.com> Date: Thu, 9 May 2024 16:10:12 +0530 Subject: [PATCH 10/26] fix: fix comment Co-authored-by: Jesus Lanchas Signed-off-by: Narayan Prusty <7037606+narayanprusty@users.noreply.github.com> --- contracts/oracles/SFrxETHOracle.sol | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index 0275ba57..04b6adf7 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -69,7 +69,7 @@ contract SFrxETHOracle is AccessControlledV8 { if (isBadData) revert BadPriceData(); - // calculate price in FRAX + // calculate price in USD uint256 priceLowInFrax = (EXP_SCALE ** 2) / priceLow; uint256 priceHighInFrax = (EXP_SCALE ** 2) / priceHigh; From ae84726383d1e858b811453ddc40ab94b6c30593 Mon Sep 17 00:00:00 2001 From: Narayan Prusty <7037606+narayanprusty@users.noreply.github.com> Date: Thu, 9 May 2024 16:10:25 +0530 Subject: [PATCH 11/26] fix: update var name Co-authored-by: Jesus Lanchas Signed-off-by: Narayan Prusty <7037606+narayanprusty@users.noreply.github.com> --- contracts/oracles/SFrxETHOracle.sol | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index 04b6adf7..fcb7ab50 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -70,8 +70,8 @@ contract SFrxETHOracle is AccessControlledV8 { if (isBadData) revert BadPriceData(); // calculate price in USD - uint256 priceLowInFrax = (EXP_SCALE ** 2) / priceLow; - uint256 priceHighInFrax = (EXP_SCALE ** 2) / priceHigh; + uint256 priceLowInUSD = (EXP_SCALE ** 2) / priceLow; + uint256 priceHighInUSD = (EXP_SCALE ** 2) / priceHigh; // validate price difference if (priceLowInFrax - priceHighInFrax > maxAllowedPriceDifference) revert PriceDifferenceExceeded(); From 5512927a65f7b2fb8fe422de69374780d90da0ea Mon Sep 17 00:00:00 2001 From: Narayan Prusty Date: Thu, 9 May 2024 16:12:46 +0530 Subject: [PATCH 12/26] fix: fixed vars --- contracts/oracles/SFrxETHOracle.sol | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index fcb7ab50..ab2ada5b 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -17,6 +17,7 @@ contract SFrxETHOracle is AccessControlledV8 { ISfrxEthFraxOracle public immutable SFRXETH_FRAX_ORACLE; /// @notice Address of sfrxETH + /// @custom:oz-upgrades-unsafe-allow state-variable-immutable address public immutable SFRXETH; /// @notice Maximum allowed price difference @@ -70,13 +71,13 @@ contract SFrxETHOracle is AccessControlledV8 { if (isBadData) revert BadPriceData(); // calculate price in USD - uint256 priceLowInUSD = (EXP_SCALE ** 2) / priceLow; - uint256 priceHighInUSD = (EXP_SCALE ** 2) / priceHigh; + uint256 priceHighInUSD = (EXP_SCALE ** 2) / priceLow; + uint256 priceLowInUSD = (EXP_SCALE ** 2) / priceHigh; // validate price difference - if (priceLowInFrax - priceHighInFrax > maxAllowedPriceDifference) revert PriceDifferenceExceeded(); + if (priceHighInUSD - priceLowInUSD > maxAllowedPriceDifference) revert PriceDifferenceExceeded(); // calculate and return average price - return (priceLowInFrax + priceHighInFrax) / 2; + return (priceHighInUSD + priceLowInUSD) / 2; } } From 54462b89a393d478f90d1154134d6c75d27753f5 Mon Sep 17 00:00:00 2001 From: Narayan Prusty Date: Thu, 9 May 2024 18:13:10 +0530 Subject: [PATCH 13/26] fix: added netspec --- contracts/oracles/SFrxETHOracle.sol | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index ab2ada5b..cd5f9ab5 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -52,6 +52,10 @@ contract SFrxETHOracle is AccessControlledV8 { __AccessControlled_init(_accessControlManager); } + /** + * @notice Sets the maximum allowed price difference + * @param _maxAllowedPriceDifference Maximum allowed price difference + */ function setMaxAllowedPriceDifference(uint256 _maxAllowedPriceDifference) external { _checkAccessAllowed("setMaxAllowedPriceDifference(uint256)"); emit MaxAllowedPriceDifferenceUpdated(maxAllowedPriceDifference, _maxAllowedPriceDifference); From 6130942986f3e75725ea295b1e634c73df1601da Mon Sep 17 00:00:00 2001 From: Narayan Prusty Date: Thu, 16 May 2024 13:40:46 +0530 Subject: [PATCH 14/26] fix: sfe-05 --- contracts/oracles/SFrxETHOracle.sol | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index cd5f9ab5..6ce80359 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -2,7 +2,7 @@ pragma solidity 0.8.25; import { ISfrxEthFraxOracle } from "../interfaces/ISfrxEthFraxOracle.sol"; -import { ensureNonzeroAddress } from "@venusprotocol/solidity-utilities/contracts/validators.sol"; +import { ensureNonzeroAddress, ensureNonzeroValue } from "@venusprotocol/solidity-utilities/contracts/validators.sol"; import { EXP_SCALE } from "@venusprotocol/solidity-utilities/contracts/constants.sol"; import { AccessControlledV8 } from "@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol"; @@ -78,6 +78,9 @@ contract SFrxETHOracle is AccessControlledV8 { uint256 priceHighInUSD = (EXP_SCALE ** 2) / priceLow; uint256 priceLowInUSD = (EXP_SCALE ** 2) / priceHigh; + ensureNonzeroValue(priceHighInUSD); + ensureNonzeroValue(priceLowInUSD); + // validate price difference if (priceHighInUSD - priceLowInUSD > maxAllowedPriceDifference) revert PriceDifferenceExceeded(); From b24ef729a7f1b13d1c2b572e4717612275659dd1 Mon Sep 17 00:00:00 2001 From: Narayan Prusty Date: Thu, 16 May 2024 16:36:02 +0530 Subject: [PATCH 15/26] fix: sfe-03 --- contracts/oracles/SFrxETHOracle.sol | 2 ++ test/SFrxETHOracle.ts | 42 ++++++++++++++++++----------- 2 files changed, 29 insertions(+), 15 deletions(-) diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index 6ce80359..40e5877d 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -42,6 +42,8 @@ contract SFrxETHOracle is AccessControlledV8 { ensureNonzeroAddress(_sfrxETH); SFRXETH_FRAX_ORACLE = ISfrxEthFraxOracle(_sfrxEthFraxOracle); SFRXETH = _sfrxETH; + + _disableInitializers(); } /** diff --git a/test/SFrxETHOracle.ts b/test/SFrxETHOracle.ts index 1e5917f8..b5c0fafc 100644 --- a/test/SFrxETHOracle.ts +++ b/test/SFrxETHOracle.ts @@ -1,10 +1,10 @@ import { smock } from "@defi-wonderland/smock"; import chai from "chai"; import { parseUnits } from "ethers/lib/utils"; -import { ethers } from "hardhat"; +import { ethers, upgrades } from "hardhat"; import { ADDRESSES } from "../helpers/deploymentConfig"; -import { AccessControlManager, BEP20Harness } from "../typechain-types"; +import { AccessControlManager, BEP20Harness, SFrxETHOracle } from "../typechain-types"; import { addr0000 } from "./utils/data"; const { expect } = chai; @@ -15,7 +15,7 @@ const { sfrxETH } = ADDRESSES.ethereum; describe("SFrxETHOracle unit tests", () => { let sfrxETHMock; let SFrxETHOracleFactory; - let SFrxETHOracle; + let SFrxETHOracleContract; let sfrxEthFraxOracleMock; let fakeAccessControlManager; before(async () => { @@ -43,37 +43,49 @@ describe("SFrxETHOracle unit tests", () => { describe("deployment", () => { it("revert if SfrxEthFraxOracle address is 0", async () => { - await expect(SFrxETHOracleFactory.deploy(addr0000, sfrxETHMock.address)).to.be.reverted; + await expect( + upgrades.deployProxy(SFrxETHOracleFactory, [fakeAccessControlManager.address], { + constructorArgs: [addr0000, sfrxETHMock.address], + }), + ).to.be.reverted; }); it("revert if sfrxETH address is 0", async () => { - await expect(SFrxETHOracleFactory.deploy(sfrxEthFraxOracleMock.address, addr0000)).to.be.reverted; + await expect( + upgrades.deployProxy(SFrxETHOracleFactory, [fakeAccessControlManager.address], { + constructorArgs: [sfrxEthFraxOracleMock.address, addr0000], + }), + ).to.be.reverted; }); it("should deploy contract", async () => { - SFrxETHOracle = await SFrxETHOracleFactory.deploy(sfrxEthFraxOracleMock.address, sfrxETHMock.address); - - await SFrxETHOracle.initialize(fakeAccessControlManager.address); + SFrxETHOracleContract = await upgrades.deployProxy( + SFrxETHOracleFactory, + [fakeAccessControlManager.address], + { + constructorArgs: [sfrxEthFraxOracleMock.address, sfrxETHMock.address], + }, + ); }); }); describe("getPrice", () => { it("revert if address is not valid sfrxETH address", async () => { - await expect(SFrxETHOracle.getPrice(addr0000)).to.be.revertedWithCustomError( - SFrxETHOracle, + await expect(SFrxETHOracleContract.getPrice(addr0000)).to.be.revertedWithCustomError( + SFrxETHOracleContract, "InvalidTokenAddress", ); }); it("revert if price difference is more than allowed", async () => { - await SFrxETHOracle.setMaxAllowedPriceDifference(parseUnits("1", 18)); - await expect(SFrxETHOracle.getPrice(sfrxETHMock.address)).to.be.revertedWithCustomError( - SFrxETHOracle, + await SFrxETHOracleContract.setMaxAllowedPriceDifference(parseUnits("1", 18)); + await expect(SFrxETHOracleContract.getPrice(sfrxETHMock.address)).to.be.revertedWithCustomError( + SFrxETHOracleContract, "PriceDifferenceExceeded", ); }); it("should get correct price of sfrxETH", async () => { - await SFrxETHOracle.setMaxAllowedPriceDifference(parseUnits("300", 18)); - const price = await SFrxETHOracle.getPrice(sfrxETHMock.address); + await SFrxETHOracleContract.setMaxAllowedPriceDifference(parseUnits("300", 18)); + const price = await SFrxETHOracleContract.getPrice(sfrxETHMock.address); expect(price).to.equal(parseUnits("3247.092258084175122617", 18)); }); }); From 0cd68b2148a20733c3d74fa8f74016ee9156c9e2 Mon Sep 17 00:00:00 2001 From: Narayan Prusty Date: Fri, 24 May 2024 12:44:27 +0530 Subject: [PATCH 16/26] fix: ven-1 --- contracts/oracles/SFrxETHOracle.sol | 4 +++- test/SFrxETHOracle.ts | 16 ++++++++++++---- 2 files changed, 15 insertions(+), 5 deletions(-) diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index 40e5877d..8f4a1c14 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -37,11 +37,13 @@ contract SFrxETHOracle is AccessControlledV8 { /// @notice Constructor for the implementation contract. /// @custom:oz-upgrades-unsafe-allow constructor - constructor(address _sfrxEthFraxOracle, address _sfrxETH) { + constructor(address _sfrxEthFraxOracle, address _sfrxETH, uint256 _maxAllowedPriceDifference) { ensureNonzeroAddress(_sfrxEthFraxOracle); ensureNonzeroAddress(_sfrxETH); + ensureNonzeroValue(_maxAllowedPriceDifference); SFRXETH_FRAX_ORACLE = ISfrxEthFraxOracle(_sfrxEthFraxOracle); SFRXETH = _sfrxETH; + maxAllowedPriceDifference = _maxAllowedPriceDifference; _disableInitializers(); } diff --git a/test/SFrxETHOracle.ts b/test/SFrxETHOracle.ts index b5c0fafc..72de9215 100644 --- a/test/SFrxETHOracle.ts +++ b/test/SFrxETHOracle.ts @@ -18,6 +18,7 @@ describe("SFrxETHOracle unit tests", () => { let SFrxETHOracleContract; let sfrxEthFraxOracleMock; let fakeAccessControlManager; + const priceDifference = parseUnits("300", 18); before(async () => { // To initialize the provider we need to hit the node with any request await ethers.getSigners(); @@ -45,14 +46,21 @@ describe("SFrxETHOracle unit tests", () => { it("revert if SfrxEthFraxOracle address is 0", async () => { await expect( upgrades.deployProxy(SFrxETHOracleFactory, [fakeAccessControlManager.address], { - constructorArgs: [addr0000, sfrxETHMock.address], + constructorArgs: [addr0000, sfrxETHMock.address, priceDifference], }), ).to.be.reverted; }); it("revert if sfrxETH address is 0", async () => { await expect( upgrades.deployProxy(SFrxETHOracleFactory, [fakeAccessControlManager.address], { - constructorArgs: [sfrxEthFraxOracleMock.address, addr0000], + constructorArgs: [sfrxEthFraxOracleMock.address, addr0000, priceDifference], + }), + ).to.be.reverted; + }); + it("revert if price different is 0", async () => { + await expect( + upgrades.deployProxy(SFrxETHOracleFactory, [fakeAccessControlManager.address], { + constructorArgs: [sfrxEthFraxOracleMock.address, sfrxETHMock.address, 0], }), ).to.be.reverted; }); @@ -61,7 +69,7 @@ describe("SFrxETHOracle unit tests", () => { SFrxETHOracleFactory, [fakeAccessControlManager.address], { - constructorArgs: [sfrxEthFraxOracleMock.address, sfrxETHMock.address], + constructorArgs: [sfrxEthFraxOracleMock.address, sfrxETHMock.address, priceDifference], }, ); }); @@ -84,7 +92,7 @@ describe("SFrxETHOracle unit tests", () => { }); it("should get correct price of sfrxETH", async () => { - await SFrxETHOracleContract.setMaxAllowedPriceDifference(parseUnits("300", 18)); + await SFrxETHOracleContract.setMaxAllowedPriceDifference(priceDifference); const price = await SFrxETHOracleContract.getPrice(sfrxETHMock.address); expect(price).to.equal(parseUnits("3247.092258084175122617", 18)); }); From 6374a844a89c874887da7349a094b5f982daba95 Mon Sep 17 00:00:00 2001 From: Narayan Prusty Date: Fri, 24 May 2024 12:46:07 +0530 Subject: [PATCH 17/26] fix: ven-2 --- contracts/oracles/SFrxETHOracle.sol | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index 8f4a1c14..845f31f4 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -5,13 +5,14 @@ import { ISfrxEthFraxOracle } from "../interfaces/ISfrxEthFraxOracle.sol"; import { ensureNonzeroAddress, ensureNonzeroValue } from "@venusprotocol/solidity-utilities/contracts/validators.sol"; import { EXP_SCALE } from "@venusprotocol/solidity-utilities/contracts/constants.sol"; import { AccessControlledV8 } from "@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol"; +import { OracleInterface } from "../interfaces/OracleInterface.sol"; /** * @title SFrxETHOracle * @author Venus * @notice This oracle fetches the price of sfrxETH */ -contract SFrxETHOracle is AccessControlledV8 { +contract SFrxETHOracle is AccessControlledV8, OracleInterface { /// @notice Address of SfrxEthFraxOracle /// @custom:oz-upgrades-unsafe-allow state-variable-immutable ISfrxEthFraxOracle public immutable SFRXETH_FRAX_ORACLE; From f76cf1e0e5e29051ad7e9aace4a576321edeb8e6 Mon Sep 17 00:00:00 2001 From: Narayan Prusty Date: Tue, 28 May 2024 16:56:06 +0400 Subject: [PATCH 18/26] feat: use ratio for price difference --- contracts/oracles/SFrxETHOracle.sol | 16 +++++++++++----- test/SFrxETHOracle.ts | 16 ++++++++-------- 2 files changed, 19 insertions(+), 13 deletions(-) diff --git a/contracts/oracles/SFrxETHOracle.sol b/contracts/oracles/SFrxETHOracle.sol index 845f31f4..5be8bb18 100644 --- a/contracts/oracles/SFrxETHOracle.sol +++ b/contracts/oracles/SFrxETHOracle.sol @@ -38,13 +38,12 @@ contract SFrxETHOracle is AccessControlledV8, OracleInterface { /// @notice Constructor for the implementation contract. /// @custom:oz-upgrades-unsafe-allow constructor - constructor(address _sfrxEthFraxOracle, address _sfrxETH, uint256 _maxAllowedPriceDifference) { + constructor(address _sfrxEthFraxOracle, address _sfrxETH) { ensureNonzeroAddress(_sfrxEthFraxOracle); ensureNonzeroAddress(_sfrxETH); - ensureNonzeroValue(_maxAllowedPriceDifference); + SFRXETH_FRAX_ORACLE = ISfrxEthFraxOracle(_sfrxEthFraxOracle); SFRXETH = _sfrxETH; - maxAllowedPriceDifference = _maxAllowedPriceDifference; _disableInitializers(); } @@ -52,9 +51,13 @@ contract SFrxETHOracle is AccessControlledV8, OracleInterface { /** * @notice Sets the contracts required to fetch prices * @param _accessControlManager Address of the access control manager contract + * @param _maxAllowedPriceDifference Maximum allowed price difference */ - function initialize(address _accessControlManager) external initializer { + function initialize(address _accessControlManager, uint256 _maxAllowedPriceDifference) external initializer { + ensureNonzeroValue(_maxAllowedPriceDifference); + __AccessControlled_init(_accessControlManager); + maxAllowedPriceDifference = _maxAllowedPriceDifference; } /** @@ -63,6 +66,8 @@ contract SFrxETHOracle is AccessControlledV8, OracleInterface { */ function setMaxAllowedPriceDifference(uint256 _maxAllowedPriceDifference) external { _checkAccessAllowed("setMaxAllowedPriceDifference(uint256)"); + ensureNonzeroValue(_maxAllowedPriceDifference); + emit MaxAllowedPriceDifferenceUpdated(maxAllowedPriceDifference, _maxAllowedPriceDifference); maxAllowedPriceDifference = _maxAllowedPriceDifference; } @@ -87,7 +92,8 @@ contract SFrxETHOracle is AccessControlledV8, OracleInterface { ensureNonzeroValue(priceLowInUSD); // validate price difference - if (priceHighInUSD - priceLowInUSD > maxAllowedPriceDifference) revert PriceDifferenceExceeded(); + uint256 difference = (priceHighInUSD * EXP_SCALE) / priceLowInUSD; + if (difference > maxAllowedPriceDifference) revert PriceDifferenceExceeded(); // calculate and return average price return (priceHighInUSD + priceLowInUSD) / 2; diff --git a/test/SFrxETHOracle.ts b/test/SFrxETHOracle.ts index 72de9215..ee775859 100644 --- a/test/SFrxETHOracle.ts +++ b/test/SFrxETHOracle.ts @@ -18,7 +18,7 @@ describe("SFrxETHOracle unit tests", () => { let SFrxETHOracleContract; let sfrxEthFraxOracleMock; let fakeAccessControlManager; - const priceDifference = parseUnits("300", 18); + const priceDifference = parseUnits("1.011", 18); // 1.1% difference before(async () => { // To initialize the provider we need to hit the node with any request await ethers.getSigners(); @@ -46,30 +46,30 @@ describe("SFrxETHOracle unit tests", () => { it("revert if SfrxEthFraxOracle address is 0", async () => { await expect( upgrades.deployProxy(SFrxETHOracleFactory, [fakeAccessControlManager.address], { - constructorArgs: [addr0000, sfrxETHMock.address, priceDifference], + constructorArgs: [addr0000, sfrxETHMock.address], }), ).to.be.reverted; }); it("revert if sfrxETH address is 0", async () => { await expect( upgrades.deployProxy(SFrxETHOracleFactory, [fakeAccessControlManager.address], { - constructorArgs: [sfrxEthFraxOracleMock.address, addr0000, priceDifference], + constructorArgs: [sfrxEthFraxOracleMock.address, addr0000], }), ).to.be.reverted; }); it("revert if price different is 0", async () => { await expect( - upgrades.deployProxy(SFrxETHOracleFactory, [fakeAccessControlManager.address], { - constructorArgs: [sfrxEthFraxOracleMock.address, sfrxETHMock.address, 0], + upgrades.deployProxy(SFrxETHOracleFactory, [fakeAccessControlManager.address, 0], { + constructorArgs: [sfrxEthFraxOracleMock.address, sfrxETHMock.address], }), ).to.be.reverted; }); it("should deploy contract", async () => { SFrxETHOracleContract = await upgrades.deployProxy( SFrxETHOracleFactory, - [fakeAccessControlManager.address], + [fakeAccessControlManager.address, priceDifference], { - constructorArgs: [sfrxEthFraxOracleMock.address, sfrxETHMock.address, priceDifference], + constructorArgs: [sfrxEthFraxOracleMock.address, sfrxETHMock.address], }, ); }); @@ -84,7 +84,7 @@ describe("SFrxETHOracle unit tests", () => { }); it("revert if price difference is more than allowed", async () => { - await SFrxETHOracleContract.setMaxAllowedPriceDifference(parseUnits("1", 18)); + await SFrxETHOracleContract.setMaxAllowedPriceDifference(parseUnits("1.0001", 18)); await expect(SFrxETHOracleContract.getPrice(sfrxETHMock.address)).to.be.revertedWithCustomError( SFrxETHOracleContract, "PriceDifferenceExceeded", From c5ae0fae3dca410c5abbc2546b15c2df4398f060 Mon Sep 17 00:00:00 2001 From: Narayan Prusty Date: Mon, 10 Jun 2024 12:29:30 +0530 Subject: [PATCH 19/26] fix: deployed oracle --- deploy/8-deploy-sfrxeth-oracle.ts | 50 ++ deployments/ethereum/SFrxETHOracle.json | 517 +++++++++++++++ .../SFrxETHOracle_Implementation.json | 620 ++++++++++++++++++ deployments/ethereum/SFrxETHOracle_Proxy.json | 213 ++++++ .../04e4e9272baf051bc64349e36ce2636f.json | 271 ++++++++ .../sepolia/MockSfrxEthFraxOracle.json | 257 ++++++++ deployments/sepolia/SFrxETHOracle.json | 517 +++++++++++++++ .../sepolia/SFrxETHOracle_Implementation.json | 620 ++++++++++++++++++ deployments/sepolia/SFrxETHOracle_Proxy.json | 213 ++++++ .../04e4e9272baf051bc64349e36ce2636f.json | 271 ++++++++ helpers/deploymentConfig.ts | 1 + 11 files changed, 3550 insertions(+) create mode 100644 deploy/8-deploy-sfrxeth-oracle.ts create mode 100644 deployments/ethereum/SFrxETHOracle.json create mode 100644 deployments/ethereum/SFrxETHOracle_Implementation.json create mode 100644 deployments/ethereum/SFrxETHOracle_Proxy.json create mode 100644 deployments/ethereum/solcInputs/04e4e9272baf051bc64349e36ce2636f.json create mode 100644 deployments/sepolia/MockSfrxEthFraxOracle.json create mode 100644 deployments/sepolia/SFrxETHOracle.json create mode 100644 deployments/sepolia/SFrxETHOracle_Implementation.json create mode 100644 deployments/sepolia/SFrxETHOracle_Proxy.json create mode 100644 deployments/sepolia/solcInputs/04e4e9272baf051bc64349e36ce2636f.json diff --git a/deploy/8-deploy-sfrxeth-oracle.ts b/deploy/8-deploy-sfrxeth-oracle.ts new file mode 100644 index 00000000..ae00e3d4 --- /dev/null +++ b/deploy/8-deploy-sfrxeth-oracle.ts @@ -0,0 +1,50 @@ +import { ethers } from "hardhat"; +import { DeployFunction } from "hardhat-deploy/dist/types"; +import { HardhatRuntimeEnvironment } from "hardhat/types"; + +import { ADDRESSES } from "../helpers/deploymentConfig"; + +const func: DeployFunction = async ({ getNamedAccounts, deployments, network }: HardhatRuntimeEnvironment) => { + const { deploy } = deployments; + const { deployer } = await getNamedAccounts(); + + const proxyOwnerAddress = network.live ? ADDRESSES[network.name].timelock : deployer; + + const { sfrxETH, SfrxEthFraxOracle } = ADDRESSES[network.name]; + + let SfrxEthFraxOracleAddress = SfrxEthFraxOracle; + if (!SfrxEthFraxOracle) { + await deploy("MockSfrxEthFraxOracle", { + contract: "MockSfrxEthFraxOracle", + from: deployer, + log: true, + autoMine: true, + skipIfAlreadyDeployed: true, + args: [], + }); + + const mockSfrxEthFraxOracle = await ethers.getContract("MockSfrxEthFraxOracle"); + SfrxEthFraxOracleAddress = mockSfrxEthFraxOracle.address; + + if ((await mockSfrxEthFraxOracle.owner()) === deployer) { + await mockSfrxEthFraxOracle.transferOwnership(proxyOwnerAddress); + } + } + + await deploy("SFrxETHOracle", { + contract: "SFrxETHOracle", + from: deployer, + log: true, + deterministicDeployment: false, + args: [SfrxEthFraxOracleAddress, sfrxETH], + proxy: { + owner: proxyOwnerAddress, + proxyContract: "OptimizedTransparentProxy", + }, + skipIfAlreadyDeployed: true, + }); +}; + +export default func; +func.tags = ["sFraxETHOracle"]; +func.skip = async (hre: HardhatRuntimeEnvironment) => hre.network.name !== "ethereum" && hre.network.name !== "sepolia"; diff --git a/deployments/ethereum/SFrxETHOracle.json b/deployments/ethereum/SFrxETHOracle.json new file mode 100644 index 00000000..fcdcee2c --- /dev/null +++ b/deployments/ethereum/SFrxETHOracle.json @@ -0,0 +1,517 @@ +{ + "address": "0x987010fD82FDCe099174aC605B88E1cc35019ef4", + "abi": [ + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "previousAdmin", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "AdminChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "beacon", + "type": "address" + } + ], + "name": "BeaconUpgraded", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "implementation", + "type": "address" + } + ], + "name": "Upgraded", + "type": "event" + }, + { + "stateMutability": "payable", + "type": "fallback" + }, + { + "inputs": [], + "name": "admin", + "outputs": [ + { + "internalType": "address", + "name": "admin_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "implementation", + "outputs": [ + { + "internalType": "address", + "name": "implementation_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + } + ], + "name": "upgradeTo", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + }, + { + "internalType": "bytes", + "name": "data", + "type": "bytes" + } + ], + "name": "upgradeToAndCall", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "stateMutability": "payable", + "type": "receive" + }, + { + "inputs": [], + "name": "BadPriceData", + "type": "error" + }, + { + "inputs": [], + "name": "InvalidTokenAddress", + "type": "error" + }, + { + "inputs": [], + "name": "PriceDifferenceExceeded", + "type": "error" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "sender", + "type": "address" + }, + { + "internalType": "address", + "name": "calledContract", + "type": "address" + }, + { + "internalType": "string", + "name": "methodSignature", + "type": "string" + } + ], + "name": "Unauthorized", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroAddressNotAllowed", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroValueNotAllowed", + "type": "error" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint8", + "name": "version", + "type": "uint8" + } + ], + "name": "Initialized", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint256", + "name": "oldMaxAllowedPriceDifference", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newMaxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "MaxAllowedPriceDifferenceUpdated", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "oldAccessControlManager", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAccessControlManager", + "type": "address" + } + ], + "name": "NewAccessControlManager", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferStarted", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "inputs": [], + "name": "SFRXETH", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "SFRXETH_FRAX_ORACLE", + "outputs": [ + { + "internalType": "contract ISfrxEthFraxOracle", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "acceptOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "accessControlManager", + "outputs": [ + { + "internalType": "contract IAccessControlManagerV8", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "asset", + "type": "address" + } + ], + "name": "getPrice", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_accessControlManager", + "type": "address" + }, + { + "internalType": "uint256", + "name": "_maxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "initialize", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "maxAllowedPriceDifference", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "pendingOwner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "name": "setAccessControlManager", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint256", + "name": "_maxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "setMaxAllowedPriceDifference", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_logic", + "type": "address" + }, + { + "internalType": "address", + "name": "admin_", + "type": "address" + }, + { + "internalType": "bytes", + "name": "_data", + "type": "bytes" + } + ], + "stateMutability": "payable", + "type": "constructor" + } + ], + "transactionHash": "0xdd5727086f268d56d7c6944b9da7fcd7167cc56418832086548c9ef1509e3794", + "receipt": { + "to": null, + "from": "0x63c72cf38D2C35278e2F18A4FE79225A66dFA942", + "contractAddress": "0x987010fD82FDCe099174aC605B88E1cc35019ef4", + "transactionIndex": 24, + "gasUsed": "622245", + "logsBloom": "0x00000000010000000400000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000800000000000000010000000000000000000000000000000400000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000000000400000000000000000", + "blockHash": "0x85da7944bc163eec667e798fd41c32a5867096174d7e139ef6acc37d85f72769", + "transactionHash": "0xdd5727086f268d56d7c6944b9da7fcd7167cc56418832086548c9ef1509e3794", + "logs": [ + { + "transactionIndex": 24, + "blockNumber": 20059781, + "transactionHash": "0xdd5727086f268d56d7c6944b9da7fcd7167cc56418832086548c9ef1509e3794", + "address": "0x987010fD82FDCe099174aC605B88E1cc35019ef4", + "topics": [ + "0xbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b", + "0x0000000000000000000000003a6f2c02ec48dbee4ca406d701dca2cc9d919ead" + ], + "data": "0x", + "logIndex": 104, + "blockHash": "0x85da7944bc163eec667e798fd41c32a5867096174d7e139ef6acc37d85f72769" + }, + { + "transactionIndex": 24, + "blockNumber": 20059781, + "transactionHash": "0xdd5727086f268d56d7c6944b9da7fcd7167cc56418832086548c9ef1509e3794", + "address": "0x987010fD82FDCe099174aC605B88E1cc35019ef4", + "topics": ["0x7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f"], + "data": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000567e4cc5e085d09f66f836fa8279f38b4e5866b9", + "logIndex": 105, + "blockHash": "0x85da7944bc163eec667e798fd41c32a5867096174d7e139ef6acc37d85f72769" + } + ], + "blockNumber": 20059781, + "cumulativeGasUsed": "4066424", + "status": 1, + "byzantium": true + }, + "args": ["0x3a6f2c02ec48dbEE4Ca406d701DCA2CC9d919EaD", "0x567e4cc5e085d09f66f836fa8279f38b4e5866b9", "0x"], + "numDeployments": 1, + "solcInputHash": "0e89febeebc7444140de8e67c9067d2c", + "metadata": "{\"compiler\":{\"version\":\"0.8.10+commit.fc410830\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_logic\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"admin_\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"_data\",\"type\":\"bytes\"}],\"stateMutability\":\"payable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"previousAdmin\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"AdminChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"beacon\",\"type\":\"address\"}],\"name\":\"BeaconUpgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"implementation\",\"type\":\"address\"}],\"name\":\"Upgraded\",\"type\":\"event\"},{\"stateMutability\":\"payable\",\"type\":\"fallback\"},{\"inputs\":[],\"name\":\"admin\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"admin_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"implementation\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"implementation_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"}],\"name\":\"upgradeTo\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"upgradeToAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"stateMutability\":\"payable\",\"type\":\"receive\"}],\"devdoc\":{\"details\":\"This contract implements a proxy that is upgradeable by an admin. To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector clashing], which can potentially be used in an attack, this contract uses the https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two things that go hand in hand: 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if that call matches one of the admin functions exposed by the proxy itself. 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the implementation. If the admin tries to call a function on the implementation it will fail with an error that says \\\"admin cannot fallback to proxy target\\\". These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due to sudden errors when trying to call a function from the proxy implementation. Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way, you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.\",\"kind\":\"dev\",\"methods\":{\"admin()\":{\"details\":\"Returns the current admin. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`\"},\"constructor\":{\"details\":\"Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.\"},\"implementation()\":{\"details\":\"Returns the current implementation. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`\"},\"upgradeTo(address)\":{\"details\":\"Upgrade the implementation of the proxy. NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.\"},\"upgradeToAndCall(address,bytes)\":{\"details\":\"Upgrade the implementation of the proxy, and then call a function from the new implementation as specified by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the proxied contract. NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.\"}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{},\"version\":1}},\"settings\":{\"compilationTarget\":{\"solc_0.8/proxy/OptimizedTransparentUpgradeableProxy.sol\":\"OptimizedTransparentUpgradeableProxy\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":999999},\"remappings\":[]},\"sources\":{\"solc_0.8/openzeppelin/interfaces/draft-IERC1822.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (interfaces/draft-IERC1822.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified\\n * proxy whose upgrades are fully controlled by the current implementation.\\n */\\ninterface IERC1822Proxiable {\\n /**\\n * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation\\n * address.\\n *\\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\\n * function revert if invoked through a proxy.\\n */\\n function proxiableUUID() external view returns (bytes32);\\n}\\n\",\"keccak256\":\"0x93b4e21c931252739a1ec13ea31d3d35a5c068be3163ccab83e4d70c40355f03\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/ERC1967/ERC1967Proxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/ERC1967/ERC1967Proxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../Proxy.sol\\\";\\nimport \\\"./ERC1967Upgrade.sol\\\";\\n\\n/**\\n * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an\\n * implementation address that can be changed. This address is stored in storage in the location specified by\\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the\\n * implementation behind the proxy.\\n */\\ncontract ERC1967Proxy is Proxy, ERC1967Upgrade {\\n /**\\n * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.\\n *\\n * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded\\n * function call, and allows initializating the storage of the proxy like a Solidity constructor.\\n */\\n constructor(address _logic, bytes memory _data) payable {\\n assert(_IMPLEMENTATION_SLOT == bytes32(uint256(keccak256(\\\"eip1967.proxy.implementation\\\")) - 1));\\n _upgradeToAndCall(_logic, _data, false);\\n }\\n\\n /**\\n * @dev Returns the current implementation address.\\n */\\n function _implementation() internal view virtual override returns (address impl) {\\n return ERC1967Upgrade._getImplementation();\\n }\\n}\\n\",\"keccak256\":\"0x6309f9f39dc6f4f45a24f296543867aa358e32946cd6b2874627a996d606b3a0\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/ERC1967/ERC1967Upgrade.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/ERC1967/ERC1967Upgrade.sol)\\n\\npragma solidity ^0.8.2;\\n\\nimport \\\"../beacon/IBeacon.sol\\\";\\nimport \\\"../../interfaces/draft-IERC1822.sol\\\";\\nimport \\\"../../utils/Address.sol\\\";\\nimport \\\"../../utils/StorageSlot.sol\\\";\\n\\n/**\\n * @dev This abstract contract provides getters and event emitting update functions for\\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.\\n *\\n * _Available since v4.1._\\n *\\n * @custom:oz-upgrades-unsafe-allow delegatecall\\n */\\nabstract contract ERC1967Upgrade {\\n // This is the keccak-256 hash of \\\"eip1967.proxy.rollback\\\" subtracted by 1\\n bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;\\n\\n /**\\n * @dev Storage slot with the address of the current implementation.\\n * This is the keccak-256 hash of \\\"eip1967.proxy.implementation\\\" subtracted by 1, and is\\n * validated in the constructor.\\n */\\n bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n\\n /**\\n * @dev Emitted when the implementation is upgraded.\\n */\\n event Upgraded(address indexed implementation);\\n\\n /**\\n * @dev Returns the current implementation address.\\n */\\n function _getImplementation() internal view returns (address) {\\n return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new address in the EIP1967 implementation slot.\\n */\\n function _setImplementation(address newImplementation) private {\\n require(Address.isContract(newImplementation), \\\"ERC1967: new implementation is not a contract\\\");\\n StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\\n }\\n\\n /**\\n * @dev Perform implementation upgrade\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeTo(address newImplementation) internal {\\n _setImplementation(newImplementation);\\n emit Upgraded(newImplementation);\\n }\\n\\n /**\\n * @dev Perform implementation upgrade with additional setup call.\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeToAndCall(\\n address newImplementation,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n _upgradeTo(newImplementation);\\n if (data.length > 0 || forceCall) {\\n Address.functionDelegateCall(newImplementation, data);\\n }\\n }\\n\\n /**\\n * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeToAndCallUUPS(\\n address newImplementation,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n // Upgrades from old implementations will perform a rollback test. This test requires the new\\n // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing\\n // this special case will break upgrade paths from old UUPS implementation to new ones.\\n if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) {\\n _setImplementation(newImplementation);\\n } else {\\n try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {\\n require(slot == _IMPLEMENTATION_SLOT, \\\"ERC1967Upgrade: unsupported proxiableUUID\\\");\\n } catch {\\n revert(\\\"ERC1967Upgrade: new implementation is not UUPS\\\");\\n }\\n _upgradeToAndCall(newImplementation, data, forceCall);\\n }\\n }\\n\\n /**\\n * @dev Storage slot with the admin of the contract.\\n * This is the keccak-256 hash of \\\"eip1967.proxy.admin\\\" subtracted by 1, and is\\n * validated in the constructor.\\n */\\n bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;\\n\\n /**\\n * @dev Emitted when the admin account has changed.\\n */\\n event AdminChanged(address previousAdmin, address newAdmin);\\n\\n /**\\n * @dev Returns the current admin.\\n */\\n function _getAdmin() internal view virtual returns (address) {\\n return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new address in the EIP1967 admin slot.\\n */\\n function _setAdmin(address newAdmin) private {\\n require(newAdmin != address(0), \\\"ERC1967: new admin is the zero address\\\");\\n StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;\\n }\\n\\n /**\\n * @dev Changes the admin of the proxy.\\n *\\n * Emits an {AdminChanged} event.\\n */\\n function _changeAdmin(address newAdmin) internal {\\n emit AdminChanged(_getAdmin(), newAdmin);\\n _setAdmin(newAdmin);\\n }\\n\\n /**\\n * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.\\n * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.\\n */\\n bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;\\n\\n /**\\n * @dev Emitted when the beacon is upgraded.\\n */\\n event BeaconUpgraded(address indexed beacon);\\n\\n /**\\n * @dev Returns the current beacon.\\n */\\n function _getBeacon() internal view returns (address) {\\n return StorageSlot.getAddressSlot(_BEACON_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new beacon in the EIP1967 beacon slot.\\n */\\n function _setBeacon(address newBeacon) private {\\n require(Address.isContract(newBeacon), \\\"ERC1967: new beacon is not a contract\\\");\\n require(Address.isContract(IBeacon(newBeacon).implementation()), \\\"ERC1967: beacon implementation is not a contract\\\");\\n StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;\\n }\\n\\n /**\\n * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does\\n * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).\\n *\\n * Emits a {BeaconUpgraded} event.\\n */\\n function _upgradeBeaconToAndCall(\\n address newBeacon,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n _setBeacon(newBeacon);\\n emit BeaconUpgraded(newBeacon);\\n if (data.length > 0 || forceCall) {\\n Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x17668652127feebed0ce8d9431ef95ccc8c4292f03e3b8cf06c6ca16af396633\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/Proxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/Proxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM\\n * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to\\n * be specified by overriding the virtual {_implementation} function.\\n *\\n * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a\\n * different contract through the {_delegate} function.\\n *\\n * The success and return data of the delegated call will be returned back to the caller of the proxy.\\n */\\nabstract contract Proxy {\\n /**\\n * @dev Delegates the current call to `implementation`.\\n *\\n * This function does not return to its internal call site, it will return directly to the external caller.\\n */\\n function _delegate(address implementation) internal virtual {\\n assembly {\\n // Copy msg.data. We take full control of memory in this inline assembly\\n // block because it will not return to Solidity code. We overwrite the\\n // Solidity scratch pad at memory position 0.\\n calldatacopy(0, 0, calldatasize())\\n\\n // Call the implementation.\\n // out and outsize are 0 because we don't know the size yet.\\n let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)\\n\\n // Copy the returned data.\\n returndatacopy(0, 0, returndatasize())\\n\\n switch result\\n // delegatecall returns 0 on error.\\n case 0 {\\n revert(0, returndatasize())\\n }\\n default {\\n return(0, returndatasize())\\n }\\n }\\n }\\n\\n /**\\n * @dev This is a virtual function that should be overriden so it returns the address to which the fallback function\\n * and {_fallback} should delegate.\\n */\\n function _implementation() internal view virtual returns (address);\\n\\n /**\\n * @dev Delegates the current call to the address returned by `_implementation()`.\\n *\\n * This function does not return to its internall call site, it will return directly to the external caller.\\n */\\n function _fallback() internal virtual {\\n _beforeFallback();\\n _delegate(_implementation());\\n }\\n\\n /**\\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other\\n * function in the contract matches the call data.\\n */\\n fallback() external payable virtual {\\n _fallback();\\n }\\n\\n /**\\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data\\n * is empty.\\n */\\n receive() external payable virtual {\\n _fallback();\\n }\\n\\n /**\\n * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`\\n * call, or as part of the Solidity `fallback` or `receive` functions.\\n *\\n * If overriden should call `super._beforeFallback()`.\\n */\\n function _beforeFallback() internal virtual {}\\n}\\n\",\"keccak256\":\"0xd5d1fd16e9faff7fcb3a52e02a8d49156f42a38a03f07b5f1810c21c2149a8ab\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/beacon/IBeacon.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev This is the interface that {BeaconProxy} expects of its beacon.\\n */\\ninterface IBeacon {\\n /**\\n * @dev Must return an address that can be used as a delegate call target.\\n *\\n * {BeaconProxy} will check that this address is a contract.\\n */\\n function implementation() external view returns (address);\\n}\\n\",\"keccak256\":\"0xd50a3421ac379ccb1be435fa646d66a65c986b4924f0849839f08692f39dde61\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCall(target, data, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n require(isContract(target), \\\"Address: static call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(isContract(target), \\\"Address: delegate call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n }\\n}\\n\",\"keccak256\":\"0x3777e696b62134e6177440dbe6e6601c0c156a443f57167194b67e75527439de\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/utils/StorageSlot.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/StorageSlot.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Library for reading and writing primitive types to specific storage slots.\\n *\\n * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.\\n * This library helps with reading and writing to such slots without the need for inline assembly.\\n *\\n * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.\\n *\\n * Example usage to set ERC1967 implementation slot:\\n * ```\\n * contract ERC1967 {\\n * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n *\\n * function _getImplementation() internal view returns (address) {\\n * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\\n * }\\n *\\n * function _setImplementation(address newImplementation) internal {\\n * require(Address.isContract(newImplementation), \\\"ERC1967: new implementation is not a contract\\\");\\n * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\\n * }\\n * }\\n * ```\\n *\\n * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._\\n */\\nlibrary StorageSlot {\\n struct AddressSlot {\\n address value;\\n }\\n\\n struct BooleanSlot {\\n bool value;\\n }\\n\\n struct Bytes32Slot {\\n bytes32 value;\\n }\\n\\n struct Uint256Slot {\\n uint256 value;\\n }\\n\\n /**\\n * @dev Returns an `AddressSlot` with member `value` located at `slot`.\\n */\\n function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `BooleanSlot` with member `value` located at `slot`.\\n */\\n function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.\\n */\\n function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `Uint256Slot` with member `value` located at `slot`.\\n */\\n function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n}\\n\",\"keccak256\":\"0xfe1b7a9aa2a530a9e705b220e26cd584e2fbdc9602a3a1066032b12816b46aca\",\"license\":\"MIT\"},\"solc_0.8/proxy/OptimizedTransparentUpgradeableProxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/transparent/TransparentUpgradeableProxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../openzeppelin/proxy/ERC1967/ERC1967Proxy.sol\\\";\\n\\n/**\\n * @dev This contract implements a proxy that is upgradeable by an admin.\\n *\\n * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector\\n * clashing], which can potentially be used in an attack, this contract uses the\\n * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two\\n * things that go hand in hand:\\n *\\n * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if\\n * that call matches one of the admin functions exposed by the proxy itself.\\n * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the\\n * implementation. If the admin tries to call a function on the implementation it will fail with an error that says\\n * \\\"admin cannot fallback to proxy target\\\".\\n *\\n * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing\\n * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due\\n * to sudden errors when trying to call a function from the proxy implementation.\\n *\\n * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,\\n * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.\\n */\\ncontract OptimizedTransparentUpgradeableProxy is ERC1967Proxy {\\n address internal immutable _ADMIN;\\n\\n /**\\n * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and\\n * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.\\n */\\n constructor(\\n address _logic,\\n address admin_,\\n bytes memory _data\\n ) payable ERC1967Proxy(_logic, _data) {\\n assert(_ADMIN_SLOT == bytes32(uint256(keccak256(\\\"eip1967.proxy.admin\\\")) - 1));\\n _ADMIN = admin_;\\n\\n // still store it to work with EIP-1967\\n bytes32 slot = _ADMIN_SLOT;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(slot, admin_)\\n }\\n emit AdminChanged(address(0), admin_);\\n }\\n\\n /**\\n * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.\\n */\\n modifier ifAdmin() {\\n if (msg.sender == _getAdmin()) {\\n _;\\n } else {\\n _fallback();\\n }\\n }\\n\\n /**\\n * @dev Returns the current admin.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.\\n *\\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\\n * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`\\n */\\n function admin() external ifAdmin returns (address admin_) {\\n admin_ = _getAdmin();\\n }\\n\\n /**\\n * @dev Returns the current implementation.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.\\n *\\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\\n * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`\\n */\\n function implementation() external ifAdmin returns (address implementation_) {\\n implementation_ = _implementation();\\n }\\n\\n /**\\n * @dev Upgrade the implementation of the proxy.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.\\n */\\n function upgradeTo(address newImplementation) external ifAdmin {\\n _upgradeToAndCall(newImplementation, bytes(\\\"\\\"), false);\\n }\\n\\n /**\\n * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified\\n * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the\\n * proxied contract.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.\\n */\\n function upgradeToAndCall(address newImplementation, bytes calldata data) external payable ifAdmin {\\n _upgradeToAndCall(newImplementation, data, true);\\n }\\n\\n /**\\n * @dev Returns the current admin.\\n */\\n function _admin() internal view virtual returns (address) {\\n return _getAdmin();\\n }\\n\\n /**\\n * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.\\n */\\n function _beforeFallback() internal virtual override {\\n require(msg.sender != _getAdmin(), \\\"TransparentUpgradeableProxy: admin cannot fallback to proxy target\\\");\\n super._beforeFallback();\\n }\\n\\n function _getAdmin() internal view virtual override returns (address) {\\n return _ADMIN;\\n }\\n}\\n\",\"keccak256\":\"0xa30117644e27fa5b49e162aae2f62b36c1aca02f801b8c594d46e2024963a534\",\"license\":\"MIT\"}},\"version\":1}", + "bytecode": "0x60a060405260405162000f5f38038062000f5f83398101604081905262000026916200044a565b82816200005560017f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbd6200052a565b60008051602062000f188339815191521462000075576200007562000550565b62000083828260006200013c565b50620000b3905060017fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61046200052a565b60008051602062000ef883398151915214620000d357620000d362000550565b6001600160a01b038216608081905260008051602062000ef88339815191528381556040805160008152602081019390935290917f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f910160405180910390a150505050620005b9565b620001478362000179565b600082511180620001555750805b156200017457620001728383620001bb60201b620002a91760201c565b505b505050565b6200018481620001ea565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b6060620001e3838360405180606001604052806027815260200162000f3860279139620002b2565b9392505050565b62000200816200039860201b620002d51760201c565b620002685760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b60648201526084015b60405180910390fd5b806200029160008051602062000f1883398151915260001b620003a760201b620002411760201c565b80546001600160a01b0319166001600160a01b039290921691909117905550565b60606001600160a01b0384163b6200031c5760405162461bcd60e51b815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f6044820152651b9d1c9858dd60d21b60648201526084016200025f565b600080856001600160a01b03168560405162000339919062000566565b600060405180830381855af49150503d806000811462000376576040519150601f19603f3d011682016040523d82523d6000602084013e6200037b565b606091505b5090925090506200038e828286620003aa565b9695505050505050565b6001600160a01b03163b151590565b90565b60608315620003bb575081620001e3565b825115620003cc5782518084602001fd5b8160405162461bcd60e51b81526004016200025f919062000584565b80516001600160a01b03811681146200040057600080fd5b919050565b634e487b7160e01b600052604160045260246000fd5b60005b83811015620004385781810151838201526020016200041e565b83811115620001725750506000910152565b6000806000606084860312156200046057600080fd5b6200046b84620003e8565b92506200047b60208501620003e8565b60408501519092506001600160401b03808211156200049957600080fd5b818601915086601f830112620004ae57600080fd5b815181811115620004c357620004c362000405565b604051601f8201601f19908116603f01168101908382118183101715620004ee57620004ee62000405565b816040528281528960208487010111156200050857600080fd5b6200051b8360208301602088016200041b565b80955050505050509250925092565b6000828210156200054b57634e487b7160e01b600052601160045260246000fd5b500390565b634e487b7160e01b600052600160045260246000fd5b600082516200057a8184602087016200041b565b9190910192915050565b6020815260008251806020840152620005a58160408501602087016200041b565b601f01601f19169190910160400192915050565b608051610900620005f86000396000818161011201528181610176015281816102060152818161025e01528181610287015261030901526109006000f3fe6080604052600436106100435760003560e01c80633659cfe61461005a5780634f1ef2861461007a5780635c60da1b1461008d578063f851a440146100cb57610052565b36610052576100506100e0565b005b6100506100e0565b34801561006657600080fd5b5061005061007536600461076c565b6100fa565b610050610088366004610787565b61015e565b34801561009957600080fd5b506100a26101ec565b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390f35b3480156100d757600080fd5b506100a2610244565b6100e86102f1565b6100f86100f36103e2565b610422565b565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156101565761015381604051806020016040528060008152506000610446565b50565b6101536100e0565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156101e4576101df8383838080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525060019250610446915050565b505050565b6101df6100e0565b60003373ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000161415610239576102346103e2565b905090565b6102416100e0565b90565b60003373ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016141561023957507f000000000000000000000000000000000000000000000000000000000000000090565b60606102ce83836040518060600160405280602781526020016108a460279139610471565b9392505050565b73ffffffffffffffffffffffffffffffffffffffff163b151590565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156100f8576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f7879207461726760648201527f6574000000000000000000000000000000000000000000000000000000000000608482015260a4015b60405180910390fd5b60006102347f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc5473ffffffffffffffffffffffffffffffffffffffff1690565b3660008037600080366000845af43d6000803e808015610441573d6000f35b3d6000fd5b61044f83610599565b60008251118061045c5750805b156101df5761046b83836102a9565b50505050565b606073ffffffffffffffffffffffffffffffffffffffff84163b610517576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f60448201527f6e7472616374000000000000000000000000000000000000000000000000000060648201526084016103d9565b6000808573ffffffffffffffffffffffffffffffffffffffff168560405161053f9190610836565b600060405180830381855af49150503d806000811461057a576040519150601f19603f3d011682016040523d82523d6000602084013e61057f565b606091505b509150915061058f8282866105e6565b9695505050505050565b6105a281610639565b60405173ffffffffffffffffffffffffffffffffffffffff8216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b606083156105f55750816102ce565b8251156106055782518084602001fd5b816040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016103d99190610852565b73ffffffffffffffffffffffffffffffffffffffff81163b6106dd576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201527f6f74206120636f6e74726163740000000000000000000000000000000000000060648201526084016103d9565b7f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc80547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff92909216919091179055565b803573ffffffffffffffffffffffffffffffffffffffff8116811461076757600080fd5b919050565b60006020828403121561077e57600080fd5b6102ce82610743565b60008060006040848603121561079c57600080fd5b6107a584610743565b9250602084013567ffffffffffffffff808211156107c257600080fd5b818601915086601f8301126107d657600080fd5b8135818111156107e557600080fd5b8760208285010111156107f757600080fd5b6020830194508093505050509250925092565b60005b8381101561082557818101518382015260200161080d565b8381111561046b5750506000910152565b6000825161084881846020870161080a565b9190910192915050565b602081526000825180602084015261087181604085016020870161080a565b601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016919091016040019291505056fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a26469706673582212206f70214c51cdd41c05ba0ffeb72b309ca3c8be178fd6e73c12162330799984f364736f6c634300080a0033b53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564", + "deployedBytecode": "0x6080604052600436106100435760003560e01c80633659cfe61461005a5780634f1ef2861461007a5780635c60da1b1461008d578063f851a440146100cb57610052565b36610052576100506100e0565b005b6100506100e0565b34801561006657600080fd5b5061005061007536600461076c565b6100fa565b610050610088366004610787565b61015e565b34801561009957600080fd5b506100a26101ec565b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390f35b3480156100d757600080fd5b506100a2610244565b6100e86102f1565b6100f86100f36103e2565b610422565b565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156101565761015381604051806020016040528060008152506000610446565b50565b6101536100e0565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156101e4576101df8383838080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525060019250610446915050565b505050565b6101df6100e0565b60003373ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000161415610239576102346103e2565b905090565b6102416100e0565b90565b60003373ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016141561023957507f000000000000000000000000000000000000000000000000000000000000000090565b60606102ce83836040518060600160405280602781526020016108a460279139610471565b9392505050565b73ffffffffffffffffffffffffffffffffffffffff163b151590565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156100f8576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f7879207461726760648201527f6574000000000000000000000000000000000000000000000000000000000000608482015260a4015b60405180910390fd5b60006102347f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc5473ffffffffffffffffffffffffffffffffffffffff1690565b3660008037600080366000845af43d6000803e808015610441573d6000f35b3d6000fd5b61044f83610599565b60008251118061045c5750805b156101df5761046b83836102a9565b50505050565b606073ffffffffffffffffffffffffffffffffffffffff84163b610517576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f60448201527f6e7472616374000000000000000000000000000000000000000000000000000060648201526084016103d9565b6000808573ffffffffffffffffffffffffffffffffffffffff168560405161053f9190610836565b600060405180830381855af49150503d806000811461057a576040519150601f19603f3d011682016040523d82523d6000602084013e61057f565b606091505b509150915061058f8282866105e6565b9695505050505050565b6105a281610639565b60405173ffffffffffffffffffffffffffffffffffffffff8216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b606083156105f55750816102ce565b8251156106055782518084602001fd5b816040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016103d99190610852565b73ffffffffffffffffffffffffffffffffffffffff81163b6106dd576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201527f6f74206120636f6e74726163740000000000000000000000000000000000000060648201526084016103d9565b7f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc80547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff92909216919091179055565b803573ffffffffffffffffffffffffffffffffffffffff8116811461076757600080fd5b919050565b60006020828403121561077e57600080fd5b6102ce82610743565b60008060006040848603121561079c57600080fd5b6107a584610743565b9250602084013567ffffffffffffffff808211156107c257600080fd5b818601915086601f8301126107d657600080fd5b8135818111156107e557600080fd5b8760208285010111156107f757600080fd5b6020830194508093505050509250925092565b60005b8381101561082557818101518382015260200161080d565b8381111561046b5750506000910152565b6000825161084881846020870161080a565b9190910192915050565b602081526000825180602084015261087181604085016020870161080a565b601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016919091016040019291505056fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a26469706673582212206f70214c51cdd41c05ba0ffeb72b309ca3c8be178fd6e73c12162330799984f364736f6c634300080a0033", + "implementation": "0x3a6f2c02ec48dbEE4Ca406d701DCA2CC9d919EaD", + "devdoc": { + "details": "This contract implements a proxy that is upgradeable by an admin. To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector clashing], which can potentially be used in an attack, this contract uses the https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two things that go hand in hand: 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if that call matches one of the admin functions exposed by the proxy itself. 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the implementation. If the admin tries to call a function on the implementation it will fail with an error that says \"admin cannot fallback to proxy target\". These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due to sudden errors when trying to call a function from the proxy implementation. Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way, you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.", + "kind": "dev", + "methods": { + "admin()": { + "details": "Returns the current admin. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`" + }, + "constructor": { + "details": "Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}." + }, + "implementation()": { + "details": "Returns the current implementation. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`" + }, + "upgradeTo(address)": { + "details": "Upgrade the implementation of the proxy. NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}." + }, + "upgradeToAndCall(address,bytes)": { + "details": "Upgrade the implementation of the proxy, and then call a function from the new implementation as specified by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the proxied contract. NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}." + } + }, + "version": 1 + }, + "userdoc": { + "kind": "user", + "methods": {}, + "version": 1 + }, + "storageLayout": { + "storage": [], + "types": null + } +} diff --git a/deployments/ethereum/SFrxETHOracle_Implementation.json b/deployments/ethereum/SFrxETHOracle_Implementation.json new file mode 100644 index 00000000..d3143a30 --- /dev/null +++ b/deployments/ethereum/SFrxETHOracle_Implementation.json @@ -0,0 +1,620 @@ +{ + "address": "0x3a6f2c02ec48dbEE4Ca406d701DCA2CC9d919EaD", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "_sfrxEthFraxOracle", + "type": "address" + }, + { + "internalType": "address", + "name": "_sfrxETH", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "constructor" + }, + { + "inputs": [], + "name": "BadPriceData", + "type": "error" + }, + { + "inputs": [], + "name": "InvalidTokenAddress", + "type": "error" + }, + { + "inputs": [], + "name": "PriceDifferenceExceeded", + "type": "error" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "sender", + "type": "address" + }, + { + "internalType": "address", + "name": "calledContract", + "type": "address" + }, + { + "internalType": "string", + "name": "methodSignature", + "type": "string" + } + ], + "name": "Unauthorized", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroAddressNotAllowed", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroValueNotAllowed", + "type": "error" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint8", + "name": "version", + "type": "uint8" + } + ], + "name": "Initialized", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint256", + "name": "oldMaxAllowedPriceDifference", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newMaxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "MaxAllowedPriceDifferenceUpdated", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "oldAccessControlManager", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAccessControlManager", + "type": "address" + } + ], + "name": "NewAccessControlManager", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferStarted", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "inputs": [], + "name": "SFRXETH", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "SFRXETH_FRAX_ORACLE", + "outputs": [ + { + "internalType": "contract ISfrxEthFraxOracle", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "acceptOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "accessControlManager", + "outputs": [ + { + "internalType": "contract IAccessControlManagerV8", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "asset", + "type": "address" + } + ], + "name": "getPrice", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_accessControlManager", + "type": "address" + }, + { + "internalType": "uint256", + "name": "_maxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "initialize", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "maxAllowedPriceDifference", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "pendingOwner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "name": "setAccessControlManager", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint256", + "name": "_maxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "setMaxAllowedPriceDifference", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + } + ], + "transactionHash": "0xca739008849df5c9e0f11f994373aa0463c3a54faccc20875cd5baea495af75d", + "receipt": { + "to": null, + "from": "0x63c72cf38D2C35278e2F18A4FE79225A66dFA942", + "contractAddress": "0x3a6f2c02ec48dbEE4Ca406d701DCA2CC9d919EaD", + "transactionIndex": 88, + "gasUsed": "796005", + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000080000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000040000000000000080000000000000000000000000008000000000000000000000000000000000000000000000000000000000", + "blockHash": "0x497aa6a47f47b9e0526c56ea4de96705024b0c2d20a9c7536692472842c08333", + "transactionHash": "0xca739008849df5c9e0f11f994373aa0463c3a54faccc20875cd5baea495af75d", + "logs": [ + { + "transactionIndex": 88, + "blockNumber": 20059780, + "transactionHash": "0xca739008849df5c9e0f11f994373aa0463c3a54faccc20875cd5baea495af75d", + "address": "0x3a6f2c02ec48dbEE4Ca406d701DCA2CC9d919EaD", + "topics": ["0x7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498"], + "data": "0x00000000000000000000000000000000000000000000000000000000000000ff", + "logIndex": 200, + "blockHash": "0x497aa6a47f47b9e0526c56ea4de96705024b0c2d20a9c7536692472842c08333" + } + ], + "blockNumber": 20059780, + "cumulativeGasUsed": "10381904", + "status": 1, + "byzantium": true + }, + "args": ["0x3d3D868522b5a4035ADcb67BF0846D61597A6a6F", "0xac3e018457b222d93114458476f3e3416abbe38f"], + "numDeployments": 1, + "solcInputHash": "04e4e9272baf051bc64349e36ce2636f", + "metadata": "{\"compiler\":{\"version\":\"0.8.25+commit.b61c2a91\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_sfrxEthFraxOracle\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_sfrxETH\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[],\"name\":\"BadPriceData\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidTokenAddress\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"PriceDifferenceExceeded\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"sender\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"calledContract\",\"type\":\"address\"},{\"internalType\":\"string\",\"name\":\"methodSignature\",\"type\":\"string\"}],\"name\":\"Unauthorized\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddressNotAllowed\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroValueNotAllowed\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint8\",\"name\":\"version\",\"type\":\"uint8\"}],\"name\":\"Initialized\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"oldMaxAllowedPriceDifference\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newMaxAllowedPriceDifference\",\"type\":\"uint256\"}],\"name\":\"MaxAllowedPriceDifferenceUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"oldAccessControlManager\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAccessControlManager\",\"type\":\"address\"}],\"name\":\"NewAccessControlManager\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferStarted\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferred\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"SFRXETH\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"SFRXETH_FRAX_ORACLE\",\"outputs\":[{\"internalType\":\"contract ISfrxEthFraxOracle\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"acceptOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"accessControlManager\",\"outputs\":[{\"internalType\":\"contract IAccessControlManagerV8\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"asset\",\"type\":\"address\"}],\"name\":\"getPrice\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_accessControlManager\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_maxAllowedPriceDifference\",\"type\":\"uint256\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"maxAllowedPriceDifference\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pendingOwner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"renounceOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"accessControlManager_\",\"type\":\"address\"}],\"name\":\"setAccessControlManager\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"_maxAllowedPriceDifference\",\"type\":\"uint256\"}],\"name\":\"setMaxAllowedPriceDifference\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"transferOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Venus\",\"events\":{\"Initialized(uint8)\":{\"details\":\"Triggered when the contract has been initialized or reinitialized.\"}},\"kind\":\"dev\",\"methods\":{\"acceptOwnership()\":{\"details\":\"The new owner accepts the ownership transfer.\"},\"constructor\":{\"custom:oz-upgrades-unsafe-allow\":\"constructor\"},\"getPrice(address)\":{\"params\":{\"asset\":\"Address of the sfrxETH token\"},\"returns\":{\"_0\":\"price The price scaled by 1e18\"}},\"initialize(address,uint256)\":{\"params\":{\"_accessControlManager\":\"Address of the access control manager contract\",\"_maxAllowedPriceDifference\":\"Maximum allowed price difference\"}},\"owner()\":{\"details\":\"Returns the address of the current owner.\"},\"pendingOwner()\":{\"details\":\"Returns the address of the pending owner.\"},\"renounceOwnership()\":{\"details\":\"Leaves the contract without owner. It will not be possible to call `onlyOwner` functions. Can only be called by the current owner. NOTE: Renouncing ownership will leave the contract without an owner, thereby disabling any functionality that is only available to the owner.\"},\"setAccessControlManager(address)\":{\"custom:access\":\"Only Governance\",\"custom:event\":\"Emits NewAccessControlManager event\",\"details\":\"Admin function to set address of AccessControlManager\",\"params\":{\"accessControlManager_\":\"The new address of the AccessControlManager\"}},\"setMaxAllowedPriceDifference(uint256)\":{\"params\":{\"_maxAllowedPriceDifference\":\"Maximum allowed price difference\"}},\"transferOwnership(address)\":{\"details\":\"Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one. Can only be called by the current owner.\"}},\"stateVariables\":{\"SFRXETH\":{\"custom:oz-upgrades-unsafe-allow\":\"state-variable-immutable\"},\"SFRXETH_FRAX_ORACLE\":{\"custom:oz-upgrades-unsafe-allow\":\"state-variable-immutable\"}},\"title\":\"SFrxETHOracle\",\"version\":1},\"userdoc\":{\"errors\":{\"BadPriceData()\":[{\"notice\":\"Thrown if the price data is invalid\"}],\"InvalidTokenAddress()\":[{\"notice\":\"Thrown if the token address is invalid\"}],\"PriceDifferenceExceeded()\":[{\"notice\":\"Thrown if the price difference exceeds the allowed limit\"}],\"Unauthorized(address,address,string)\":[{\"notice\":\"Thrown when the action is prohibited by AccessControlManager\"}],\"ZeroAddressNotAllowed()\":[{\"notice\":\"Thrown if the supplied address is a zero address where it is not allowed\"}],\"ZeroValueNotAllowed()\":[{\"notice\":\"Thrown if the supplied value is 0 where it is not allowed\"}]},\"events\":{\"MaxAllowedPriceDifferenceUpdated(uint256,uint256)\":{\"notice\":\"Emits when the maximum allowed price difference is updated\"},\"NewAccessControlManager(address,address)\":{\"notice\":\"Emitted when access control manager contract address is changed\"}},\"kind\":\"user\",\"methods\":{\"SFRXETH()\":{\"notice\":\"Address of sfrxETH\"},\"SFRXETH_FRAX_ORACLE()\":{\"notice\":\"Address of SfrxEthFraxOracle\"},\"accessControlManager()\":{\"notice\":\"Returns the address of the access control manager contract\"},\"constructor\":{\"notice\":\"Constructor for the implementation contract.\"},\"getPrice(address)\":{\"notice\":\"Fetches the USD price of sfrxETH\"},\"initialize(address,uint256)\":{\"notice\":\"Sets the contracts required to fetch prices\"},\"maxAllowedPriceDifference()\":{\"notice\":\"Maximum allowed price difference\"},\"setAccessControlManager(address)\":{\"notice\":\"Sets the address of AccessControlManager\"},\"setMaxAllowedPriceDifference(uint256)\":{\"notice\":\"Sets the maximum allowed price difference\"}},\"notice\":\"This oracle fetches the price of sfrxETH\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/oracles/SFrxETHOracle.sol\":\"SFrxETHOracle\"},\"evmVersion\":\"paris\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable2Step.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./OwnableUpgradeable.sol\\\";\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Contract module which provides access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership} and {acceptOwnership}.\\n *\\n * This module is used through inheritance. It will make available all functions\\n * from parent (Ownable).\\n */\\nabstract contract Ownable2StepUpgradeable is Initializable, OwnableUpgradeable {\\n function __Ownable2Step_init() internal onlyInitializing {\\n __Ownable_init_unchained();\\n }\\n\\n function __Ownable2Step_init_unchained() internal onlyInitializing {\\n }\\n address private _pendingOwner;\\n\\n event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Returns the address of the pending owner.\\n */\\n function pendingOwner() public view virtual returns (address) {\\n return _pendingOwner;\\n }\\n\\n /**\\n * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual override onlyOwner {\\n _pendingOwner = newOwner;\\n emit OwnershipTransferStarted(owner(), newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual override {\\n delete _pendingOwner;\\n super._transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev The new owner accepts the ownership transfer.\\n */\\n function acceptOwnership() public virtual {\\n address sender = _msgSender();\\n require(pendingOwner() == sender, \\\"Ownable2Step: caller is not the new owner\\\");\\n _transferOwnership(sender);\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n}\\n\",\"keccak256\":\"0x84efb8889801b0ac817324aff6acc691d07bbee816b671817132911d287a8c63\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/ContextUpgradeable.sol\\\";\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Contract module which provides a basic access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership}.\\n *\\n * This module is used through inheritance. It will make available the modifier\\n * `onlyOwner`, which can be applied to your functions to restrict their use to\\n * the owner.\\n */\\nabstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {\\n address private _owner;\\n\\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial owner.\\n */\\n function __Ownable_init() internal onlyInitializing {\\n __Ownable_init_unchained();\\n }\\n\\n function __Ownable_init_unchained() internal onlyInitializing {\\n _transferOwnership(_msgSender());\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the owner.\\n */\\n modifier onlyOwner() {\\n _checkOwner();\\n _;\\n }\\n\\n /**\\n * @dev Returns the address of the current owner.\\n */\\n function owner() public view virtual returns (address) {\\n return _owner;\\n }\\n\\n /**\\n * @dev Throws if the sender is not the owner.\\n */\\n function _checkOwner() internal view virtual {\\n require(owner() == _msgSender(), \\\"Ownable: caller is not the owner\\\");\\n }\\n\\n /**\\n * @dev Leaves the contract without owner. It will not be possible to call\\n * `onlyOwner` functions. Can only be called by the current owner.\\n *\\n * NOTE: Renouncing ownership will leave the contract without an owner,\\n * thereby disabling any functionality that is only available to the owner.\\n */\\n function renounceOwnership() public virtual onlyOwner {\\n _transferOwnership(address(0));\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual onlyOwner {\\n require(newOwner != address(0), \\\"Ownable: new owner is the zero address\\\");\\n _transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual {\\n address oldOwner = _owner;\\n _owner = newOwner;\\n emit OwnershipTransferred(oldOwner, newOwner);\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n}\\n\",\"keccak256\":\"0x4075622496acc77fd6d4de4cc30a8577a744d5c75afad33fdeacf1704d6eda98\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\\n\\npragma solidity ^0.8.2;\\n\\nimport \\\"../../utils/AddressUpgradeable.sol\\\";\\n\\n/**\\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\\n *\\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\\n * reused. This mechanism prevents re-execution of each \\\"step\\\" but allows the creation of new initialization steps in\\n * case an upgrade adds a module that needs to be initialized.\\n *\\n * For example:\\n *\\n * [.hljs-theme-light.nopadding]\\n * ```solidity\\n * contract MyToken is ERC20Upgradeable {\\n * function initialize() initializer public {\\n * __ERC20_init(\\\"MyToken\\\", \\\"MTK\\\");\\n * }\\n * }\\n *\\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\\n * function initializeV2() reinitializer(2) public {\\n * __ERC20Permit_init(\\\"MyToken\\\");\\n * }\\n * }\\n * ```\\n *\\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\\n *\\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\\n *\\n * [CAUTION]\\n * ====\\n * Avoid leaving a contract uninitialized.\\n *\\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\\n *\\n * [.hljs-theme-light.nopadding]\\n * ```\\n * /// @custom:oz-upgrades-unsafe-allow constructor\\n * constructor() {\\n * _disableInitializers();\\n * }\\n * ```\\n * ====\\n */\\nabstract contract Initializable {\\n /**\\n * @dev Indicates that the contract has been initialized.\\n * @custom:oz-retyped-from bool\\n */\\n uint8 private _initialized;\\n\\n /**\\n * @dev Indicates that the contract is in the process of being initialized.\\n */\\n bool private _initializing;\\n\\n /**\\n * @dev Triggered when the contract has been initialized or reinitialized.\\n */\\n event Initialized(uint8 version);\\n\\n /**\\n * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\\n * `onlyInitializing` functions can be used to initialize parent contracts.\\n *\\n * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\\n * constructor.\\n *\\n * Emits an {Initialized} event.\\n */\\n modifier initializer() {\\n bool isTopLevelCall = !_initializing;\\n require(\\n (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\\n \\\"Initializable: contract is already initialized\\\"\\n );\\n _initialized = 1;\\n if (isTopLevelCall) {\\n _initializing = true;\\n }\\n _;\\n if (isTopLevelCall) {\\n _initializing = false;\\n emit Initialized(1);\\n }\\n }\\n\\n /**\\n * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\\n * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\\n * used to initialize parent contracts.\\n *\\n * A reinitializer may be used after the original initialization step. This is essential to configure modules that\\n * are added through upgrades and that require initialization.\\n *\\n * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\\n * cannot be nested. If one is invoked in the context of another, execution will revert.\\n *\\n * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\\n * a contract, executing them in the right order is up to the developer or operator.\\n *\\n * WARNING: setting the version to 255 will prevent any future reinitialization.\\n *\\n * Emits an {Initialized} event.\\n */\\n modifier reinitializer(uint8 version) {\\n require(!_initializing && _initialized < version, \\\"Initializable: contract is already initialized\\\");\\n _initialized = version;\\n _initializing = true;\\n _;\\n _initializing = false;\\n emit Initialized(version);\\n }\\n\\n /**\\n * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\\n * {initializer} and {reinitializer} modifiers, directly or indirectly.\\n */\\n modifier onlyInitializing() {\\n require(_initializing, \\\"Initializable: contract is not initializing\\\");\\n _;\\n }\\n\\n /**\\n * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\\n * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\\n * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\\n * through proxies.\\n *\\n * Emits an {Initialized} event the first time it is successfully executed.\\n */\\n function _disableInitializers() internal virtual {\\n require(!_initializing, \\\"Initializable: contract is initializing\\\");\\n if (_initialized != type(uint8).max) {\\n _initialized = type(uint8).max;\\n emit Initialized(type(uint8).max);\\n }\\n }\\n\\n /**\\n * @dev Returns the highest version that has been initialized. See {reinitializer}.\\n */\\n function _getInitializedVersion() internal view returns (uint8) {\\n return _initialized;\\n }\\n\\n /**\\n * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\\n */\\n function _isInitializing() internal view returns (bool) {\\n return _initializing;\\n }\\n}\\n\",\"keccak256\":\"0x89be10e757d242e9b18d5a32c9fbe2019f6d63052bbe46397a430a1d60d7f794\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary AddressUpgradeable {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n *\\n * Furthermore, `isContract` will also return true if the target contract within\\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\\n * which only has an effect at the end of a transaction.\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\\n *\\n * _Available since v4.8._\\n */\\n function verifyCallResultFromTarget(\\n address target,\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n if (success) {\\n if (returndata.length == 0) {\\n // only check isContract if the call was successful and the return data is empty\\n // otherwise we already know that it was a contract\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n }\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason or using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n /// @solidity memory-safe-assembly\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x9c80f545915582e63fe206c6ce27cbe85a86fc10b9cd2a0e8c9488fb7c2ee422\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract ContextUpgradeable is Initializable {\\n function __Context_init() internal onlyInitializing {\\n }\\n\\n function __Context_init_unchained() internal onlyInitializing {\\n }\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[50] private __gap;\\n}\\n\",\"keccak256\":\"0x963ea7f0b48b032eef72fe3a7582edf78408d6f834115b9feadd673a4d5bd149\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/IAccessControl.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev External interface of AccessControl declared to support ERC165 detection.\\n */\\ninterface IAccessControl {\\n /**\\n * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`\\n *\\n * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite\\n * {RoleAdminChanged} not being emitted signaling this.\\n *\\n * _Available since v3.1._\\n */\\n event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);\\n\\n /**\\n * @dev Emitted when `account` is granted `role`.\\n *\\n * `sender` is the account that originated the contract call, an admin role\\n * bearer except when using {AccessControl-_setupRole}.\\n */\\n event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Emitted when `account` is revoked `role`.\\n *\\n * `sender` is the account that originated the contract call:\\n * - if using `revokeRole`, it is the admin role bearer\\n * - if using `renounceRole`, it is the role bearer (i.e. `account`)\\n */\\n event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Returns `true` if `account` has been granted `role`.\\n */\\n function hasRole(bytes32 role, address account) external view returns (bool);\\n\\n /**\\n * @dev Returns the admin role that controls `role`. See {grantRole} and\\n * {revokeRole}.\\n *\\n * To change a role's admin, use {AccessControl-_setRoleAdmin}.\\n */\\n function getRoleAdmin(bytes32 role) external view returns (bytes32);\\n\\n /**\\n * @dev Grants `role` to `account`.\\n *\\n * If `account` had not been already granted `role`, emits a {RoleGranted}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function grantRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from `account`.\\n *\\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function revokeRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from the calling account.\\n *\\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\\n * purpose is to provide a mechanism for accounts to lose their privileges\\n * if they are compromised (such as when a trusted device is misplaced).\\n *\\n * If the calling account had been granted `role`, emits a {RoleRevoked}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must be `account`.\\n */\\n function renounceRole(bytes32 role, address account) external;\\n}\\n\",\"keccak256\":\"0x59ce320a585d7e1f163cd70390a0ef2ff9cec832e2aa544293a00692465a7a57\",\"license\":\"MIT\"},\"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\nimport \\\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\\\";\\nimport \\\"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\\\";\\n\\nimport \\\"./IAccessControlManagerV8.sol\\\";\\n\\n/**\\n * @title AccessControlledV8\\n * @author Venus\\n * @notice This contract is helper between access control manager and actual contract. This contract further inherited by other contract (using solidity 0.8.13)\\n * to integrate access controlled mechanism. It provides initialise methods and verifying access methods.\\n */\\nabstract contract AccessControlledV8 is Initializable, Ownable2StepUpgradeable {\\n /// @notice Access control manager contract\\n IAccessControlManagerV8 private _accessControlManager;\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n\\n /// @notice Emitted when access control manager contract address is changed\\n event NewAccessControlManager(address oldAccessControlManager, address newAccessControlManager);\\n\\n /// @notice Thrown when the action is prohibited by AccessControlManager\\n error Unauthorized(address sender, address calledContract, string methodSignature);\\n\\n function __AccessControlled_init(address accessControlManager_) internal onlyInitializing {\\n __Ownable2Step_init();\\n __AccessControlled_init_unchained(accessControlManager_);\\n }\\n\\n function __AccessControlled_init_unchained(address accessControlManager_) internal onlyInitializing {\\n _setAccessControlManager(accessControlManager_);\\n }\\n\\n /**\\n * @notice Sets the address of AccessControlManager\\n * @dev Admin function to set address of AccessControlManager\\n * @param accessControlManager_ The new address of the AccessControlManager\\n * @custom:event Emits NewAccessControlManager event\\n * @custom:access Only Governance\\n */\\n function setAccessControlManager(address accessControlManager_) external onlyOwner {\\n _setAccessControlManager(accessControlManager_);\\n }\\n\\n /**\\n * @notice Returns the address of the access control manager contract\\n */\\n function accessControlManager() external view returns (IAccessControlManagerV8) {\\n return _accessControlManager;\\n }\\n\\n /**\\n * @dev Internal function to set address of AccessControlManager\\n * @param accessControlManager_ The new address of the AccessControlManager\\n */\\n function _setAccessControlManager(address accessControlManager_) internal {\\n require(address(accessControlManager_) != address(0), \\\"invalid acess control manager address\\\");\\n address oldAccessControlManager = address(_accessControlManager);\\n _accessControlManager = IAccessControlManagerV8(accessControlManager_);\\n emit NewAccessControlManager(oldAccessControlManager, accessControlManager_);\\n }\\n\\n /**\\n * @notice Reverts if the call is not allowed by AccessControlManager\\n * @param signature Method signature\\n */\\n function _checkAccessAllowed(string memory signature) internal view {\\n bool isAllowedToCall = _accessControlManager.isAllowedToCall(msg.sender, signature);\\n\\n if (!isAllowedToCall) {\\n revert Unauthorized(msg.sender, address(this), signature);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x0dcf283925f4dddc23ca0ee71d2cb96a9dd6e4cf08061b69fde1697ea39dc514\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity ^0.8.25;\\n\\nimport \\\"@openzeppelin/contracts/access/IAccessControl.sol\\\";\\n\\n/**\\n * @title IAccessControlManagerV8\\n * @author Venus\\n * @notice Interface implemented by the `AccessControlManagerV8` contract.\\n */\\ninterface IAccessControlManagerV8 is IAccessControl {\\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) external;\\n\\n function revokeCallPermission(\\n address contractAddress,\\n string calldata functionSig,\\n address accountToRevoke\\n ) external;\\n\\n function isAllowedToCall(address account, string calldata functionSig) external view returns (bool);\\n\\n function hasPermission(\\n address account,\\n address contractAddress,\\n string calldata functionSig\\n ) external view returns (bool);\\n}\\n\",\"keccak256\":\"0xaa29b098440d0b3a131c5ecdf25ce548790c1b5ac7bf9b5c0264b6af6f7a1e0b\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/constants.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity ^0.8.25;\\n\\n/// @dev Base unit for computations, usually used in scaling (multiplications, divisions)\\nuint256 constant EXP_SCALE = 1e18;\\n\\n/// @dev A unit (literal one) in EXP_SCALE, usually used in additions/subtractions\\nuint256 constant MANTISSA_ONE = EXP_SCALE;\\n\\n/// @dev The approximate number of seconds per year\\nuint256 constant SECONDS_PER_YEAR = 31_536_000;\\n\",\"keccak256\":\"0x14de93ead464da249af31bea0e3bcfb62ec693bea3475fb4d90f055ac81dc5eb\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/validators.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\\nerror ZeroAddressNotAllowed();\\n\\n/// @notice Thrown if the supplied value is 0 where it is not allowed\\nerror ZeroValueNotAllowed();\\n\\n/// @notice Checks if the provided address is nonzero, reverts otherwise\\n/// @param address_ Address to check\\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\\nfunction ensureNonzeroAddress(address address_) pure {\\n if (address_ == address(0)) {\\n revert ZeroAddressNotAllowed();\\n }\\n}\\n\\n/// @notice Checks if the provided value is nonzero, reverts otherwise\\n/// @param value_ Value to check\\n/// @custom:error ZeroValueNotAllowed is thrown if the provided value is 0\\nfunction ensureNonzeroValue(uint256 value_) pure {\\n if (value_ == 0) {\\n revert ZeroValueNotAllowed();\\n }\\n}\\n\",\"keccak256\":\"0xdb88e14d50dd21889ca3329d755673d022c47e8da005b6a545c7f69c2c4b7b86\",\"license\":\"BSD-3-Clause\"},\"contracts/interfaces/ISfrxEthFraxOracle.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\ninterface ISfrxEthFraxOracle {\\n function getPrices() external view returns (bool _isbadData, uint256 _priceLow, uint256 _priceHigh);\\n}\\n\",\"keccak256\":\"0x1444fbcfe658b985041e7ca5da6cce92fd143ca46d9793316ab2ef542fbde87a\",\"license\":\"BSD-3-Clause\"},\"contracts/interfaces/OracleInterface.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity ^0.8.25;\\n\\ninterface OracleInterface {\\n function getPrice(address asset) external view returns (uint256);\\n}\\n\\ninterface ResilientOracleInterface is OracleInterface {\\n function updatePrice(address vToken) external;\\n\\n function updateAssetPrice(address asset) external;\\n\\n function getUnderlyingPrice(address vToken) external view returns (uint256);\\n}\\n\\ninterface TwapInterface is OracleInterface {\\n function updateTwap(address asset) external returns (uint256);\\n}\\n\\ninterface BoundValidatorInterface {\\n function validatePriceWithAnchorPrice(\\n address asset,\\n uint256 reporterPrice,\\n uint256 anchorPrice\\n ) external view returns (bool);\\n}\\n\",\"keccak256\":\"0x2432799b0d824fc701beb4c30146e912b9aeecf77b5c1635dde6c5fbe6bfc3a7\",\"license\":\"BSD-3-Clause\"},\"contracts/oracles/SFrxETHOracle.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\nimport { ISfrxEthFraxOracle } from \\\"../interfaces/ISfrxEthFraxOracle.sol\\\";\\nimport { ensureNonzeroAddress, ensureNonzeroValue } from \\\"@venusprotocol/solidity-utilities/contracts/validators.sol\\\";\\nimport { EXP_SCALE } from \\\"@venusprotocol/solidity-utilities/contracts/constants.sol\\\";\\nimport { AccessControlledV8 } from \\\"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\\\";\\nimport { OracleInterface } from \\\"../interfaces/OracleInterface.sol\\\";\\n\\n/**\\n * @title SFrxETHOracle\\n * @author Venus\\n * @notice This oracle fetches the price of sfrxETH\\n */\\ncontract SFrxETHOracle is AccessControlledV8, OracleInterface {\\n /// @notice Address of SfrxEthFraxOracle\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n ISfrxEthFraxOracle public immutable SFRXETH_FRAX_ORACLE;\\n\\n /// @notice Address of sfrxETH\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n address public immutable SFRXETH;\\n\\n /// @notice Maximum allowed price difference\\n uint256 public maxAllowedPriceDifference;\\n\\n /// @notice Emits when the maximum allowed price difference is updated\\n event MaxAllowedPriceDifferenceUpdated(uint256 oldMaxAllowedPriceDifference, uint256 newMaxAllowedPriceDifference);\\n\\n /// @notice Thrown if the price data is invalid\\n error BadPriceData();\\n\\n /// @notice Thrown if the price difference exceeds the allowed limit\\n error PriceDifferenceExceeded();\\n\\n /// @notice Thrown if the token address is invalid\\n error InvalidTokenAddress();\\n\\n /// @notice Constructor for the implementation contract.\\n /// @custom:oz-upgrades-unsafe-allow constructor\\n constructor(address _sfrxEthFraxOracle, address _sfrxETH) {\\n ensureNonzeroAddress(_sfrxEthFraxOracle);\\n ensureNonzeroAddress(_sfrxETH);\\n\\n SFRXETH_FRAX_ORACLE = ISfrxEthFraxOracle(_sfrxEthFraxOracle);\\n SFRXETH = _sfrxETH;\\n\\n _disableInitializers();\\n }\\n\\n /**\\n * @notice Sets the contracts required to fetch prices\\n * @param _accessControlManager Address of the access control manager contract\\n * @param _maxAllowedPriceDifference Maximum allowed price difference\\n */\\n function initialize(address _accessControlManager, uint256 _maxAllowedPriceDifference) external initializer {\\n ensureNonzeroValue(_maxAllowedPriceDifference);\\n\\n __AccessControlled_init(_accessControlManager);\\n maxAllowedPriceDifference = _maxAllowedPriceDifference;\\n }\\n\\n /**\\n * @notice Sets the maximum allowed price difference\\n * @param _maxAllowedPriceDifference Maximum allowed price difference\\n */\\n function setMaxAllowedPriceDifference(uint256 _maxAllowedPriceDifference) external {\\n _checkAccessAllowed(\\\"setMaxAllowedPriceDifference(uint256)\\\");\\n ensureNonzeroValue(_maxAllowedPriceDifference);\\n\\n emit MaxAllowedPriceDifferenceUpdated(maxAllowedPriceDifference, _maxAllowedPriceDifference);\\n maxAllowedPriceDifference = _maxAllowedPriceDifference;\\n }\\n\\n /**\\n * @notice Fetches the USD price of sfrxETH\\n * @param asset Address of the sfrxETH token\\n * @return price The price scaled by 1e18\\n */\\n function getPrice(address asset) external view returns (uint256) {\\n if (asset != SFRXETH) revert InvalidTokenAddress();\\n\\n (bool isBadData, uint256 priceLow, uint256 priceHigh) = SFRXETH_FRAX_ORACLE.getPrices();\\n\\n if (isBadData) revert BadPriceData();\\n\\n // calculate price in USD\\n uint256 priceHighInUSD = (EXP_SCALE ** 2) / priceLow;\\n uint256 priceLowInUSD = (EXP_SCALE ** 2) / priceHigh;\\n\\n ensureNonzeroValue(priceHighInUSD);\\n ensureNonzeroValue(priceLowInUSD);\\n\\n // validate price difference\\n uint256 difference = (priceHighInUSD * EXP_SCALE) / priceLowInUSD;\\n if (difference > maxAllowedPriceDifference) revert PriceDifferenceExceeded();\\n\\n // calculate and return average price\\n return (priceHighInUSD + priceLowInUSD) / 2;\\n }\\n}\\n\",\"keccak256\":\"0xc70f573c15e65fee8f8524b2d189ea39866d30c3f83afab74a7d588480acd824\",\"license\":\"BSD-3-Clause\"}},\"version\":1}", + "bytecode": "0x60c060405234801561001057600080fd5b50604051610eb1380380610eb183398101604081905261002f91610168565b61003882610063565b61004181610063565b6001600160a01b03808316608052811660a05261005c61008d565b505061019b565b6001600160a01b03811661008a576040516342bcdf7f60e11b815260040160405180910390fd5b50565b600054610100900460ff16156100f95760405162461bcd60e51b815260206004820152602760248201527f496e697469616c697a61626c653a20636f6e747261637420697320696e697469604482015266616c697a696e6760c81b606482015260840160405180910390fd5b60005460ff9081161461014a576000805460ff191660ff9081179091556040519081527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b565b80516001600160a01b038116811461016357600080fd5b919050565b6000806040838503121561017b57600080fd5b6101848361014c565b91506101926020840161014c565b90509250929050565b60805160a051610ce46101cd60003960008181610132015261021201526000818160ee01526102690152610ce46000f3fe608060405234801561001057600080fd5b50600436106100cf5760003560e01c80638da5cb5b1161008c578063cd6dc68711610066578063cd6dc687146101b0578063d5445950146101c3578063e30c3978146101d6578063f2fde38b146101e757600080fd5b80638da5cb5b146101855780639fd1944f14610196578063b4a0bdf31461019f57600080fd5b80630e32cb86146100d4578063127cac45146100e957806335da603d1461012d57806341976e0914610154578063715018a61461017557806379ba50971461017d575b600080fd5b6100e76100e236600461097b565b6101fa565b005b6101107f000000000000000000000000000000000000000000000000000000000000000081565b6040516001600160a01b0390911681526020015b60405180910390f35b6101107f000000000000000000000000000000000000000000000000000000000000000081565b61016761016236600461097b565b61020e565b604051908152602001610124565b6100e76103ca565b6100e76103de565b6033546001600160a01b0316610110565b61016760c95481565b6097546001600160a01b0316610110565b6100e76101be36600461099d565b61045a565b6100e76101d13660046109c7565b61057c565b6065546001600160a01b0316610110565b6100e76101f536600461097b565b6105e7565b610202610658565b61020b816106b2565b50565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316826001600160a01b03161461026257604051630f58058360e11b815260040160405180910390fd5b60008060007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663bd9a548b6040518163ffffffff1660e01b8152600401606060405180830381865afa1580156102c5573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906102e991906109f0565b925092509250821561030e5760405163a40e329160e01b815260040160405180910390fd5b6000826103246002670de0b6b3a7640000610b21565b61032e9190610b30565b90506000826103466002670de0b6b3a7640000610b21565b6103509190610b30565b905061035b82610777565b61036481610777565b600081610379670de0b6b3a764000085610b52565b6103839190610b30565b905060c9548111156103a85760405163280cb9ed60e11b815260040160405180910390fd5b60026103b48385610b69565b6103be9190610b30565b98975050505050505050565b6103d2610658565b6103dc6000610798565b565b60655433906001600160a01b031681146104515760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084015b60405180910390fd5b61020b81610798565b600054610100900460ff161580801561047a5750600054600160ff909116105b806104945750303b158015610494575060005460ff166001145b6104f75760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610448565b6000805460ff19166001179055801561051a576000805461ff0019166101001790555b61052382610777565b61052c836107b1565b60c98290558015610577576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050565b61059d604051806060016040528060258152602001610c8a602591396107e9565b6105a681610777565b60c95460408051918252602082018390527f8d4d923222e4a17f030a7f3fe695e9e6c13b437df4b3b48c2332f584395aba90910160405180910390a160c955565b6105ef610658565b606580546001600160a01b0383166001600160a01b031990911681179091556106206033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b6033546001600160a01b031633146103dc5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610448565b6001600160a01b0381166107165760405162461bcd60e51b815260206004820152602560248201527f696e76616c696420616365737320636f6e74726f6c206d616e61676572206164604482015264647265737360d81b6064820152608401610448565b609780546001600160a01b038381166001600160a01b031983168117909355604080519190921680825260208201939093527f66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa0910160405180910390a15050565b8060000361020b5760405163273e150360e21b815260040160405180910390fd5b606580546001600160a01b031916905561020b81610887565b600054610100900460ff166107d85760405162461bcd60e51b815260040161044890610b7c565b6107e06108d9565b61020b81610908565b6097546040516318c5e8ab60e01b81526000916001600160a01b0316906318c5e8ab9061081c9033908690600401610c0d565b602060405180830381865afa158015610839573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061085d9190610c39565b90508061088357333083604051634a3fa29360e01b815260040161044893929190610c54565b5050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600054610100900460ff166109005760405162461bcd60e51b815260040161044890610b7c565b6103dc61092f565b600054610100900460ff166102025760405162461bcd60e51b815260040161044890610b7c565b600054610100900460ff166109565760405162461bcd60e51b815260040161044890610b7c565b6103dc33610798565b80356001600160a01b038116811461097657600080fd5b919050565b60006020828403121561098d57600080fd5b6109968261095f565b9392505050565b600080604083850312156109b057600080fd5b6109b98361095f565b946020939093013593505050565b6000602082840312156109d957600080fd5b5035919050565b8051801515811461097657600080fd5b600080600060608486031215610a0557600080fd5b610a0e846109e0565b925060208401519150604084015190509250925092565b634e487b7160e01b600052601160045260246000fd5b600181815b80851115610a76578160001904821115610a5c57610a5c610a25565b80851615610a6957918102915b93841c9390800290610a40565b509250929050565b600082610a8d57506001610b1b565b81610a9a57506000610b1b565b8160018114610ab05760028114610aba57610ad6565b6001915050610b1b565b60ff841115610acb57610acb610a25565b50506001821b610b1b565b5060208310610133831016604e8410600b8410161715610af9575081810a610b1b565b610b038383610a3b565b8060001904821115610b1757610b17610a25565b0290505b92915050565b600061099660ff841683610a7e565b600082610b4d57634e487b7160e01b600052601260045260246000fd5b500490565b8082028115828204841417610b1b57610b1b610a25565b80820180821115610b1b57610b1b610a25565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b6000815180845260005b81811015610bed57602081850181015186830182015201610bd1565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b0383168152604060208201819052600090610c3190830184610bc7565b949350505050565b600060208284031215610c4b57600080fd5b610996826109e0565b6001600160a01b03848116825283166020820152606060408201819052600090610c8090830184610bc7565b9594505050505056fe7365744d6178416c6c6f7765645072696365446966666572656e63652875696e7432353629a2646970667358221220635a5b40e1f18a7d04d511870430fba9ca8b71100b7a203df7f26ef36b0e369664736f6c63430008190033", + "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100cf5760003560e01c80638da5cb5b1161008c578063cd6dc68711610066578063cd6dc687146101b0578063d5445950146101c3578063e30c3978146101d6578063f2fde38b146101e757600080fd5b80638da5cb5b146101855780639fd1944f14610196578063b4a0bdf31461019f57600080fd5b80630e32cb86146100d4578063127cac45146100e957806335da603d1461012d57806341976e0914610154578063715018a61461017557806379ba50971461017d575b600080fd5b6100e76100e236600461097b565b6101fa565b005b6101107f000000000000000000000000000000000000000000000000000000000000000081565b6040516001600160a01b0390911681526020015b60405180910390f35b6101107f000000000000000000000000000000000000000000000000000000000000000081565b61016761016236600461097b565b61020e565b604051908152602001610124565b6100e76103ca565b6100e76103de565b6033546001600160a01b0316610110565b61016760c95481565b6097546001600160a01b0316610110565b6100e76101be36600461099d565b61045a565b6100e76101d13660046109c7565b61057c565b6065546001600160a01b0316610110565b6100e76101f536600461097b565b6105e7565b610202610658565b61020b816106b2565b50565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316826001600160a01b03161461026257604051630f58058360e11b815260040160405180910390fd5b60008060007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663bd9a548b6040518163ffffffff1660e01b8152600401606060405180830381865afa1580156102c5573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906102e991906109f0565b925092509250821561030e5760405163a40e329160e01b815260040160405180910390fd5b6000826103246002670de0b6b3a7640000610b21565b61032e9190610b30565b90506000826103466002670de0b6b3a7640000610b21565b6103509190610b30565b905061035b82610777565b61036481610777565b600081610379670de0b6b3a764000085610b52565b6103839190610b30565b905060c9548111156103a85760405163280cb9ed60e11b815260040160405180910390fd5b60026103b48385610b69565b6103be9190610b30565b98975050505050505050565b6103d2610658565b6103dc6000610798565b565b60655433906001600160a01b031681146104515760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084015b60405180910390fd5b61020b81610798565b600054610100900460ff161580801561047a5750600054600160ff909116105b806104945750303b158015610494575060005460ff166001145b6104f75760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610448565b6000805460ff19166001179055801561051a576000805461ff0019166101001790555b61052382610777565b61052c836107b1565b60c98290558015610577576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050565b61059d604051806060016040528060258152602001610c8a602591396107e9565b6105a681610777565b60c95460408051918252602082018390527f8d4d923222e4a17f030a7f3fe695e9e6c13b437df4b3b48c2332f584395aba90910160405180910390a160c955565b6105ef610658565b606580546001600160a01b0383166001600160a01b031990911681179091556106206033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b6033546001600160a01b031633146103dc5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610448565b6001600160a01b0381166107165760405162461bcd60e51b815260206004820152602560248201527f696e76616c696420616365737320636f6e74726f6c206d616e61676572206164604482015264647265737360d81b6064820152608401610448565b609780546001600160a01b038381166001600160a01b031983168117909355604080519190921680825260208201939093527f66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa0910160405180910390a15050565b8060000361020b5760405163273e150360e21b815260040160405180910390fd5b606580546001600160a01b031916905561020b81610887565b600054610100900460ff166107d85760405162461bcd60e51b815260040161044890610b7c565b6107e06108d9565b61020b81610908565b6097546040516318c5e8ab60e01b81526000916001600160a01b0316906318c5e8ab9061081c9033908690600401610c0d565b602060405180830381865afa158015610839573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061085d9190610c39565b90508061088357333083604051634a3fa29360e01b815260040161044893929190610c54565b5050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600054610100900460ff166109005760405162461bcd60e51b815260040161044890610b7c565b6103dc61092f565b600054610100900460ff166102025760405162461bcd60e51b815260040161044890610b7c565b600054610100900460ff166109565760405162461bcd60e51b815260040161044890610b7c565b6103dc33610798565b80356001600160a01b038116811461097657600080fd5b919050565b60006020828403121561098d57600080fd5b6109968261095f565b9392505050565b600080604083850312156109b057600080fd5b6109b98361095f565b946020939093013593505050565b6000602082840312156109d957600080fd5b5035919050565b8051801515811461097657600080fd5b600080600060608486031215610a0557600080fd5b610a0e846109e0565b925060208401519150604084015190509250925092565b634e487b7160e01b600052601160045260246000fd5b600181815b80851115610a76578160001904821115610a5c57610a5c610a25565b80851615610a6957918102915b93841c9390800290610a40565b509250929050565b600082610a8d57506001610b1b565b81610a9a57506000610b1b565b8160018114610ab05760028114610aba57610ad6565b6001915050610b1b565b60ff841115610acb57610acb610a25565b50506001821b610b1b565b5060208310610133831016604e8410600b8410161715610af9575081810a610b1b565b610b038383610a3b565b8060001904821115610b1757610b17610a25565b0290505b92915050565b600061099660ff841683610a7e565b600082610b4d57634e487b7160e01b600052601260045260246000fd5b500490565b8082028115828204841417610b1b57610b1b610a25565b80820180821115610b1b57610b1b610a25565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b6000815180845260005b81811015610bed57602081850181015186830182015201610bd1565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b0383168152604060208201819052600090610c3190830184610bc7565b949350505050565b600060208284031215610c4b57600080fd5b610996826109e0565b6001600160a01b03848116825283166020820152606060408201819052600090610c8090830184610bc7565b9594505050505056fe7365744d6178416c6c6f7765645072696365446966666572656e63652875696e7432353629a2646970667358221220635a5b40e1f18a7d04d511870430fba9ca8b71100b7a203df7f26ef36b0e369664736f6c63430008190033", + "devdoc": { + "author": "Venus", + "events": { + "Initialized(uint8)": { + "details": "Triggered when the contract has been initialized or reinitialized." + } + }, + "kind": "dev", + "methods": { + "acceptOwnership()": { + "details": "The new owner accepts the ownership transfer." + }, + "constructor": { + "custom:oz-upgrades-unsafe-allow": "constructor" + }, + "getPrice(address)": { + "params": { + "asset": "Address of the sfrxETH token" + }, + "returns": { + "_0": "price The price scaled by 1e18" + } + }, + "initialize(address,uint256)": { + "params": { + "_accessControlManager": "Address of the access control manager contract", + "_maxAllowedPriceDifference": "Maximum allowed price difference" + } + }, + "owner()": { + "details": "Returns the address of the current owner." + }, + "pendingOwner()": { + "details": "Returns the address of the pending owner." + }, + "renounceOwnership()": { + "details": "Leaves the contract without owner. It will not be possible to call `onlyOwner` functions. Can only be called by the current owner. NOTE: Renouncing ownership will leave the contract without an owner, thereby disabling any functionality that is only available to the owner." + }, + "setAccessControlManager(address)": { + "custom:access": "Only Governance", + "custom:event": "Emits NewAccessControlManager event", + "details": "Admin function to set address of AccessControlManager", + "params": { + "accessControlManager_": "The new address of the AccessControlManager" + } + }, + "setMaxAllowedPriceDifference(uint256)": { + "params": { + "_maxAllowedPriceDifference": "Maximum allowed price difference" + } + }, + "transferOwnership(address)": { + "details": "Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one. Can only be called by the current owner." + } + }, + "stateVariables": { + "SFRXETH": { + "custom:oz-upgrades-unsafe-allow": "state-variable-immutable" + }, + "SFRXETH_FRAX_ORACLE": { + "custom:oz-upgrades-unsafe-allow": "state-variable-immutable" + } + }, + "title": "SFrxETHOracle", + "version": 1 + }, + "userdoc": { + "errors": { + "BadPriceData()": [ + { + "notice": "Thrown if the price data is invalid" + } + ], + "InvalidTokenAddress()": [ + { + "notice": "Thrown if the token address is invalid" + } + ], + "PriceDifferenceExceeded()": [ + { + "notice": "Thrown if the price difference exceeds the allowed limit" + } + ], + "Unauthorized(address,address,string)": [ + { + "notice": "Thrown when the action is prohibited by AccessControlManager" + } + ], + "ZeroAddressNotAllowed()": [ + { + "notice": "Thrown if the supplied address is a zero address where it is not allowed" + } + ], + "ZeroValueNotAllowed()": [ + { + "notice": "Thrown if the supplied value is 0 where it is not allowed" + } + ] + }, + "events": { + "MaxAllowedPriceDifferenceUpdated(uint256,uint256)": { + "notice": "Emits when the maximum allowed price difference is updated" + }, + "NewAccessControlManager(address,address)": { + "notice": "Emitted when access control manager contract address is changed" + } + }, + "kind": "user", + "methods": { + "SFRXETH()": { + "notice": "Address of sfrxETH" + }, + "SFRXETH_FRAX_ORACLE()": { + "notice": "Address of SfrxEthFraxOracle" + }, + "accessControlManager()": { + "notice": "Returns the address of the access control manager contract" + }, + "constructor": { + "notice": "Constructor for the implementation contract." + }, + "getPrice(address)": { + "notice": "Fetches the USD price of sfrxETH" + }, + "initialize(address,uint256)": { + "notice": "Sets the contracts required to fetch prices" + }, + "maxAllowedPriceDifference()": { + "notice": "Maximum allowed price difference" + }, + "setAccessControlManager(address)": { + "notice": "Sets the address of AccessControlManager" + }, + "setMaxAllowedPriceDifference(uint256)": { + "notice": "Sets the maximum allowed price difference" + } + }, + "notice": "This oracle fetches the price of sfrxETH", + "version": 1 + }, + "storageLayout": { + "storage": [ + { + "astId": 347, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "_initialized", + "offset": 0, + "slot": "0", + "type": "t_uint8" + }, + { + "astId": 350, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "_initializing", + "offset": 1, + "slot": "0", + "type": "t_bool" + }, + { + "astId": 1007, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "__gap", + "offset": 0, + "slot": "1", + "type": "t_array(t_uint256)50_storage" + }, + { + "astId": 219, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "_owner", + "offset": 0, + "slot": "51", + "type": "t_address" + }, + { + "astId": 339, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "__gap", + "offset": 0, + "slot": "52", + "type": "t_array(t_uint256)49_storage" + }, + { + "astId": 128, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "_pendingOwner", + "offset": 0, + "slot": "101", + "type": "t_address" + }, + { + "astId": 207, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "__gap", + "offset": 0, + "slot": "102", + "type": "t_array(t_uint256)49_storage" + }, + { + "astId": 5192, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "_accessControlManager", + "offset": 0, + "slot": "151", + "type": "t_contract(IAccessControlManagerV8)5377" + }, + { + "astId": 5197, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "__gap", + "offset": 0, + "slot": "152", + "type": "t_array(t_uint256)49_storage" + }, + { + "astId": 8862, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "maxAllowedPriceDifference", + "offset": 0, + "slot": "201", + "type": "t_uint256" + } + ], + "types": { + "t_address": { + "encoding": "inplace", + "label": "address", + "numberOfBytes": "20" + }, + "t_array(t_uint256)49_storage": { + "base": "t_uint256", + "encoding": "inplace", + "label": "uint256[49]", + "numberOfBytes": "1568" + }, + "t_array(t_uint256)50_storage": { + "base": "t_uint256", + "encoding": "inplace", + "label": "uint256[50]", + "numberOfBytes": "1600" + }, + "t_bool": { + "encoding": "inplace", + "label": "bool", + "numberOfBytes": "1" + }, + "t_contract(IAccessControlManagerV8)5377": { + "encoding": "inplace", + "label": "contract IAccessControlManagerV8", + "numberOfBytes": "20" + }, + "t_uint256": { + "encoding": "inplace", + "label": "uint256", + "numberOfBytes": "32" + }, + "t_uint8": { + "encoding": "inplace", + "label": "uint8", + "numberOfBytes": "1" + } + } + } +} diff --git a/deployments/ethereum/SFrxETHOracle_Proxy.json b/deployments/ethereum/SFrxETHOracle_Proxy.json new file mode 100644 index 00000000..1db05a13 --- /dev/null +++ b/deployments/ethereum/SFrxETHOracle_Proxy.json @@ -0,0 +1,213 @@ +{ + "address": "0x987010fD82FDCe099174aC605B88E1cc35019ef4", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "_logic", + "type": "address" + }, + { + "internalType": "address", + "name": "admin_", + "type": "address" + }, + { + "internalType": "bytes", + "name": "_data", + "type": "bytes" + } + ], + "stateMutability": "payable", + "type": "constructor" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "previousAdmin", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "AdminChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "beacon", + "type": "address" + } + ], + "name": "BeaconUpgraded", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "implementation", + "type": "address" + } + ], + "name": "Upgraded", + "type": "event" + }, + { + "stateMutability": "payable", + "type": "fallback" + }, + { + "inputs": [], + "name": "admin", + "outputs": [ + { + "internalType": "address", + "name": "admin_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "implementation", + "outputs": [ + { + "internalType": "address", + "name": "implementation_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + } + ], + "name": "upgradeTo", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + }, + { + "internalType": "bytes", + "name": "data", + "type": "bytes" + } + ], + "name": "upgradeToAndCall", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "stateMutability": "payable", + "type": "receive" + } + ], + "transactionHash": "0xdd5727086f268d56d7c6944b9da7fcd7167cc56418832086548c9ef1509e3794", + "receipt": { + "to": null, + "from": "0x63c72cf38D2C35278e2F18A4FE79225A66dFA942", + "contractAddress": "0x987010fD82FDCe099174aC605B88E1cc35019ef4", + "transactionIndex": 24, + "gasUsed": "622245", + "logsBloom": "0x00000000010000000400000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000800000000000000010000000000000000000000000000000400000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000000000400000000000000000", + "blockHash": "0x85da7944bc163eec667e798fd41c32a5867096174d7e139ef6acc37d85f72769", + "transactionHash": "0xdd5727086f268d56d7c6944b9da7fcd7167cc56418832086548c9ef1509e3794", + "logs": [ + { + "transactionIndex": 24, + "blockNumber": 20059781, + "transactionHash": "0xdd5727086f268d56d7c6944b9da7fcd7167cc56418832086548c9ef1509e3794", + "address": "0x987010fD82FDCe099174aC605B88E1cc35019ef4", + "topics": [ + "0xbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b", + "0x0000000000000000000000003a6f2c02ec48dbee4ca406d701dca2cc9d919ead" + ], + "data": "0x", + "logIndex": 104, + "blockHash": "0x85da7944bc163eec667e798fd41c32a5867096174d7e139ef6acc37d85f72769" + }, + { + "transactionIndex": 24, + "blockNumber": 20059781, + "transactionHash": "0xdd5727086f268d56d7c6944b9da7fcd7167cc56418832086548c9ef1509e3794", + "address": "0x987010fD82FDCe099174aC605B88E1cc35019ef4", + "topics": ["0x7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f"], + "data": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000567e4cc5e085d09f66f836fa8279f38b4e5866b9", + "logIndex": 105, + "blockHash": "0x85da7944bc163eec667e798fd41c32a5867096174d7e139ef6acc37d85f72769" + } + ], + "blockNumber": 20059781, + "cumulativeGasUsed": "4066424", + "status": 1, + "byzantium": true + }, + "args": ["0x3a6f2c02ec48dbEE4Ca406d701DCA2CC9d919EaD", "0x567e4cc5e085d09f66f836fa8279f38b4e5866b9", "0x"], + "numDeployments": 1, + "solcInputHash": "0e89febeebc7444140de8e67c9067d2c", + "metadata": "{\"compiler\":{\"version\":\"0.8.10+commit.fc410830\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_logic\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"admin_\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"_data\",\"type\":\"bytes\"}],\"stateMutability\":\"payable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"previousAdmin\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"AdminChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"beacon\",\"type\":\"address\"}],\"name\":\"BeaconUpgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"implementation\",\"type\":\"address\"}],\"name\":\"Upgraded\",\"type\":\"event\"},{\"stateMutability\":\"payable\",\"type\":\"fallback\"},{\"inputs\":[],\"name\":\"admin\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"admin_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"implementation\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"implementation_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"}],\"name\":\"upgradeTo\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"upgradeToAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"stateMutability\":\"payable\",\"type\":\"receive\"}],\"devdoc\":{\"details\":\"This contract implements a proxy that is upgradeable by an admin. To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector clashing], which can potentially be used in an attack, this contract uses the https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two things that go hand in hand: 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if that call matches one of the admin functions exposed by the proxy itself. 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the implementation. If the admin tries to call a function on the implementation it will fail with an error that says \\\"admin cannot fallback to proxy target\\\". These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due to sudden errors when trying to call a function from the proxy implementation. Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way, you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.\",\"kind\":\"dev\",\"methods\":{\"admin()\":{\"details\":\"Returns the current admin. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`\"},\"constructor\":{\"details\":\"Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.\"},\"implementation()\":{\"details\":\"Returns the current implementation. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`\"},\"upgradeTo(address)\":{\"details\":\"Upgrade the implementation of the proxy. NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.\"},\"upgradeToAndCall(address,bytes)\":{\"details\":\"Upgrade the implementation of the proxy, and then call a function from the new implementation as specified by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the proxied contract. NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.\"}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{},\"version\":1}},\"settings\":{\"compilationTarget\":{\"solc_0.8/proxy/OptimizedTransparentUpgradeableProxy.sol\":\"OptimizedTransparentUpgradeableProxy\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":999999},\"remappings\":[]},\"sources\":{\"solc_0.8/openzeppelin/interfaces/draft-IERC1822.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (interfaces/draft-IERC1822.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified\\n * proxy whose upgrades are fully controlled by the current implementation.\\n */\\ninterface IERC1822Proxiable {\\n /**\\n * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation\\n * address.\\n *\\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\\n * function revert if invoked through a proxy.\\n */\\n function proxiableUUID() external view returns (bytes32);\\n}\\n\",\"keccak256\":\"0x93b4e21c931252739a1ec13ea31d3d35a5c068be3163ccab83e4d70c40355f03\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/ERC1967/ERC1967Proxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/ERC1967/ERC1967Proxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../Proxy.sol\\\";\\nimport \\\"./ERC1967Upgrade.sol\\\";\\n\\n/**\\n * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an\\n * implementation address that can be changed. This address is stored in storage in the location specified by\\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the\\n * implementation behind the proxy.\\n */\\ncontract ERC1967Proxy is Proxy, ERC1967Upgrade {\\n /**\\n * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.\\n *\\n * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded\\n * function call, and allows initializating the storage of the proxy like a Solidity constructor.\\n */\\n constructor(address _logic, bytes memory _data) payable {\\n assert(_IMPLEMENTATION_SLOT == bytes32(uint256(keccak256(\\\"eip1967.proxy.implementation\\\")) - 1));\\n _upgradeToAndCall(_logic, _data, false);\\n }\\n\\n /**\\n * @dev Returns the current implementation address.\\n */\\n function _implementation() internal view virtual override returns (address impl) {\\n return ERC1967Upgrade._getImplementation();\\n }\\n}\\n\",\"keccak256\":\"0x6309f9f39dc6f4f45a24f296543867aa358e32946cd6b2874627a996d606b3a0\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/ERC1967/ERC1967Upgrade.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/ERC1967/ERC1967Upgrade.sol)\\n\\npragma solidity ^0.8.2;\\n\\nimport \\\"../beacon/IBeacon.sol\\\";\\nimport \\\"../../interfaces/draft-IERC1822.sol\\\";\\nimport \\\"../../utils/Address.sol\\\";\\nimport \\\"../../utils/StorageSlot.sol\\\";\\n\\n/**\\n * @dev This abstract contract provides getters and event emitting update functions for\\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.\\n *\\n * _Available since v4.1._\\n *\\n * @custom:oz-upgrades-unsafe-allow delegatecall\\n */\\nabstract contract ERC1967Upgrade {\\n // This is the keccak-256 hash of \\\"eip1967.proxy.rollback\\\" subtracted by 1\\n bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;\\n\\n /**\\n * @dev Storage slot with the address of the current implementation.\\n * This is the keccak-256 hash of \\\"eip1967.proxy.implementation\\\" subtracted by 1, and is\\n * validated in the constructor.\\n */\\n bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n\\n /**\\n * @dev Emitted when the implementation is upgraded.\\n */\\n event Upgraded(address indexed implementation);\\n\\n /**\\n * @dev Returns the current implementation address.\\n */\\n function _getImplementation() internal view returns (address) {\\n return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new address in the EIP1967 implementation slot.\\n */\\n function _setImplementation(address newImplementation) private {\\n require(Address.isContract(newImplementation), \\\"ERC1967: new implementation is not a contract\\\");\\n StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\\n }\\n\\n /**\\n * @dev Perform implementation upgrade\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeTo(address newImplementation) internal {\\n _setImplementation(newImplementation);\\n emit Upgraded(newImplementation);\\n }\\n\\n /**\\n * @dev Perform implementation upgrade with additional setup call.\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeToAndCall(\\n address newImplementation,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n _upgradeTo(newImplementation);\\n if (data.length > 0 || forceCall) {\\n Address.functionDelegateCall(newImplementation, data);\\n }\\n }\\n\\n /**\\n * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeToAndCallUUPS(\\n address newImplementation,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n // Upgrades from old implementations will perform a rollback test. This test requires the new\\n // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing\\n // this special case will break upgrade paths from old UUPS implementation to new ones.\\n if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) {\\n _setImplementation(newImplementation);\\n } else {\\n try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {\\n require(slot == _IMPLEMENTATION_SLOT, \\\"ERC1967Upgrade: unsupported proxiableUUID\\\");\\n } catch {\\n revert(\\\"ERC1967Upgrade: new implementation is not UUPS\\\");\\n }\\n _upgradeToAndCall(newImplementation, data, forceCall);\\n }\\n }\\n\\n /**\\n * @dev Storage slot with the admin of the contract.\\n * This is the keccak-256 hash of \\\"eip1967.proxy.admin\\\" subtracted by 1, and is\\n * validated in the constructor.\\n */\\n bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;\\n\\n /**\\n * @dev Emitted when the admin account has changed.\\n */\\n event AdminChanged(address previousAdmin, address newAdmin);\\n\\n /**\\n * @dev Returns the current admin.\\n */\\n function _getAdmin() internal view virtual returns (address) {\\n return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new address in the EIP1967 admin slot.\\n */\\n function _setAdmin(address newAdmin) private {\\n require(newAdmin != address(0), \\\"ERC1967: new admin is the zero address\\\");\\n StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;\\n }\\n\\n /**\\n * @dev Changes the admin of the proxy.\\n *\\n * Emits an {AdminChanged} event.\\n */\\n function _changeAdmin(address newAdmin) internal {\\n emit AdminChanged(_getAdmin(), newAdmin);\\n _setAdmin(newAdmin);\\n }\\n\\n /**\\n * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.\\n * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.\\n */\\n bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;\\n\\n /**\\n * @dev Emitted when the beacon is upgraded.\\n */\\n event BeaconUpgraded(address indexed beacon);\\n\\n /**\\n * @dev Returns the current beacon.\\n */\\n function _getBeacon() internal view returns (address) {\\n return StorageSlot.getAddressSlot(_BEACON_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new beacon in the EIP1967 beacon slot.\\n */\\n function _setBeacon(address newBeacon) private {\\n require(Address.isContract(newBeacon), \\\"ERC1967: new beacon is not a contract\\\");\\n require(Address.isContract(IBeacon(newBeacon).implementation()), \\\"ERC1967: beacon implementation is not a contract\\\");\\n StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;\\n }\\n\\n /**\\n * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does\\n * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).\\n *\\n * Emits a {BeaconUpgraded} event.\\n */\\n function _upgradeBeaconToAndCall(\\n address newBeacon,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n _setBeacon(newBeacon);\\n emit BeaconUpgraded(newBeacon);\\n if (data.length > 0 || forceCall) {\\n Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x17668652127feebed0ce8d9431ef95ccc8c4292f03e3b8cf06c6ca16af396633\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/Proxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/Proxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM\\n * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to\\n * be specified by overriding the virtual {_implementation} function.\\n *\\n * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a\\n * different contract through the {_delegate} function.\\n *\\n * The success and return data of the delegated call will be returned back to the caller of the proxy.\\n */\\nabstract contract Proxy {\\n /**\\n * @dev Delegates the current call to `implementation`.\\n *\\n * This function does not return to its internal call site, it will return directly to the external caller.\\n */\\n function _delegate(address implementation) internal virtual {\\n assembly {\\n // Copy msg.data. We take full control of memory in this inline assembly\\n // block because it will not return to Solidity code. We overwrite the\\n // Solidity scratch pad at memory position 0.\\n calldatacopy(0, 0, calldatasize())\\n\\n // Call the implementation.\\n // out and outsize are 0 because we don't know the size yet.\\n let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)\\n\\n // Copy the returned data.\\n returndatacopy(0, 0, returndatasize())\\n\\n switch result\\n // delegatecall returns 0 on error.\\n case 0 {\\n revert(0, returndatasize())\\n }\\n default {\\n return(0, returndatasize())\\n }\\n }\\n }\\n\\n /**\\n * @dev This is a virtual function that should be overriden so it returns the address to which the fallback function\\n * and {_fallback} should delegate.\\n */\\n function _implementation() internal view virtual returns (address);\\n\\n /**\\n * @dev Delegates the current call to the address returned by `_implementation()`.\\n *\\n * This function does not return to its internall call site, it will return directly to the external caller.\\n */\\n function _fallback() internal virtual {\\n _beforeFallback();\\n _delegate(_implementation());\\n }\\n\\n /**\\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other\\n * function in the contract matches the call data.\\n */\\n fallback() external payable virtual {\\n _fallback();\\n }\\n\\n /**\\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data\\n * is empty.\\n */\\n receive() external payable virtual {\\n _fallback();\\n }\\n\\n /**\\n * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`\\n * call, or as part of the Solidity `fallback` or `receive` functions.\\n *\\n * If overriden should call `super._beforeFallback()`.\\n */\\n function _beforeFallback() internal virtual {}\\n}\\n\",\"keccak256\":\"0xd5d1fd16e9faff7fcb3a52e02a8d49156f42a38a03f07b5f1810c21c2149a8ab\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/beacon/IBeacon.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev This is the interface that {BeaconProxy} expects of its beacon.\\n */\\ninterface IBeacon {\\n /**\\n * @dev Must return an address that can be used as a delegate call target.\\n *\\n * {BeaconProxy} will check that this address is a contract.\\n */\\n function implementation() external view returns (address);\\n}\\n\",\"keccak256\":\"0xd50a3421ac379ccb1be435fa646d66a65c986b4924f0849839f08692f39dde61\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCall(target, data, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n require(isContract(target), \\\"Address: static call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(isContract(target), \\\"Address: delegate call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n }\\n}\\n\",\"keccak256\":\"0x3777e696b62134e6177440dbe6e6601c0c156a443f57167194b67e75527439de\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/utils/StorageSlot.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/StorageSlot.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Library for reading and writing primitive types to specific storage slots.\\n *\\n * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.\\n * This library helps with reading and writing to such slots without the need for inline assembly.\\n *\\n * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.\\n *\\n * Example usage to set ERC1967 implementation slot:\\n * ```\\n * contract ERC1967 {\\n * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n *\\n * function _getImplementation() internal view returns (address) {\\n * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\\n * }\\n *\\n * function _setImplementation(address newImplementation) internal {\\n * require(Address.isContract(newImplementation), \\\"ERC1967: new implementation is not a contract\\\");\\n * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\\n * }\\n * }\\n * ```\\n *\\n * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._\\n */\\nlibrary StorageSlot {\\n struct AddressSlot {\\n address value;\\n }\\n\\n struct BooleanSlot {\\n bool value;\\n }\\n\\n struct Bytes32Slot {\\n bytes32 value;\\n }\\n\\n struct Uint256Slot {\\n uint256 value;\\n }\\n\\n /**\\n * @dev Returns an `AddressSlot` with member `value` located at `slot`.\\n */\\n function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `BooleanSlot` with member `value` located at `slot`.\\n */\\n function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.\\n */\\n function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `Uint256Slot` with member `value` located at `slot`.\\n */\\n function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n}\\n\",\"keccak256\":\"0xfe1b7a9aa2a530a9e705b220e26cd584e2fbdc9602a3a1066032b12816b46aca\",\"license\":\"MIT\"},\"solc_0.8/proxy/OptimizedTransparentUpgradeableProxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/transparent/TransparentUpgradeableProxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../openzeppelin/proxy/ERC1967/ERC1967Proxy.sol\\\";\\n\\n/**\\n * @dev This contract implements a proxy that is upgradeable by an admin.\\n *\\n * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector\\n * clashing], which can potentially be used in an attack, this contract uses the\\n * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two\\n * things that go hand in hand:\\n *\\n * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if\\n * that call matches one of the admin functions exposed by the proxy itself.\\n * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the\\n * implementation. If the admin tries to call a function on the implementation it will fail with an error that says\\n * \\\"admin cannot fallback to proxy target\\\".\\n *\\n * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing\\n * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due\\n * to sudden errors when trying to call a function from the proxy implementation.\\n *\\n * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,\\n * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.\\n */\\ncontract OptimizedTransparentUpgradeableProxy is ERC1967Proxy {\\n address internal immutable _ADMIN;\\n\\n /**\\n * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and\\n * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.\\n */\\n constructor(\\n address _logic,\\n address admin_,\\n bytes memory _data\\n ) payable ERC1967Proxy(_logic, _data) {\\n assert(_ADMIN_SLOT == bytes32(uint256(keccak256(\\\"eip1967.proxy.admin\\\")) - 1));\\n _ADMIN = admin_;\\n\\n // still store it to work with EIP-1967\\n bytes32 slot = _ADMIN_SLOT;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(slot, admin_)\\n }\\n emit AdminChanged(address(0), admin_);\\n }\\n\\n /**\\n * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.\\n */\\n modifier ifAdmin() {\\n if (msg.sender == _getAdmin()) {\\n _;\\n } else {\\n _fallback();\\n }\\n }\\n\\n /**\\n * @dev Returns the current admin.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.\\n *\\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\\n * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`\\n */\\n function admin() external ifAdmin returns (address admin_) {\\n admin_ = _getAdmin();\\n }\\n\\n /**\\n * @dev Returns the current implementation.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.\\n *\\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\\n * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`\\n */\\n function implementation() external ifAdmin returns (address implementation_) {\\n implementation_ = _implementation();\\n }\\n\\n /**\\n * @dev Upgrade the implementation of the proxy.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.\\n */\\n function upgradeTo(address newImplementation) external ifAdmin {\\n _upgradeToAndCall(newImplementation, bytes(\\\"\\\"), false);\\n }\\n\\n /**\\n * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified\\n * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the\\n * proxied contract.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.\\n */\\n function upgradeToAndCall(address newImplementation, bytes calldata data) external payable ifAdmin {\\n _upgradeToAndCall(newImplementation, data, true);\\n }\\n\\n /**\\n * @dev Returns the current admin.\\n */\\n function _admin() internal view virtual returns (address) {\\n return _getAdmin();\\n }\\n\\n /**\\n * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.\\n */\\n function _beforeFallback() internal virtual override {\\n require(msg.sender != _getAdmin(), \\\"TransparentUpgradeableProxy: admin cannot fallback to proxy target\\\");\\n super._beforeFallback();\\n }\\n\\n function _getAdmin() internal view virtual override returns (address) {\\n return _ADMIN;\\n }\\n}\\n\",\"keccak256\":\"0xa30117644e27fa5b49e162aae2f62b36c1aca02f801b8c594d46e2024963a534\",\"license\":\"MIT\"}},\"version\":1}", + "bytecode": "0x60a060405260405162000f5f38038062000f5f83398101604081905262000026916200044a565b82816200005560017f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbd6200052a565b60008051602062000f188339815191521462000075576200007562000550565b62000083828260006200013c565b50620000b3905060017fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61046200052a565b60008051602062000ef883398151915214620000d357620000d362000550565b6001600160a01b038216608081905260008051602062000ef88339815191528381556040805160008152602081019390935290917f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f910160405180910390a150505050620005b9565b620001478362000179565b600082511180620001555750805b156200017457620001728383620001bb60201b620002a91760201c565b505b505050565b6200018481620001ea565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b6060620001e3838360405180606001604052806027815260200162000f3860279139620002b2565b9392505050565b62000200816200039860201b620002d51760201c565b620002685760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b60648201526084015b60405180910390fd5b806200029160008051602062000f1883398151915260001b620003a760201b620002411760201c565b80546001600160a01b0319166001600160a01b039290921691909117905550565b60606001600160a01b0384163b6200031c5760405162461bcd60e51b815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f6044820152651b9d1c9858dd60d21b60648201526084016200025f565b600080856001600160a01b03168560405162000339919062000566565b600060405180830381855af49150503d806000811462000376576040519150601f19603f3d011682016040523d82523d6000602084013e6200037b565b606091505b5090925090506200038e828286620003aa565b9695505050505050565b6001600160a01b03163b151590565b90565b60608315620003bb575081620001e3565b825115620003cc5782518084602001fd5b8160405162461bcd60e51b81526004016200025f919062000584565b80516001600160a01b03811681146200040057600080fd5b919050565b634e487b7160e01b600052604160045260246000fd5b60005b83811015620004385781810151838201526020016200041e565b83811115620001725750506000910152565b6000806000606084860312156200046057600080fd5b6200046b84620003e8565b92506200047b60208501620003e8565b60408501519092506001600160401b03808211156200049957600080fd5b818601915086601f830112620004ae57600080fd5b815181811115620004c357620004c362000405565b604051601f8201601f19908116603f01168101908382118183101715620004ee57620004ee62000405565b816040528281528960208487010111156200050857600080fd5b6200051b8360208301602088016200041b565b80955050505050509250925092565b6000828210156200054b57634e487b7160e01b600052601160045260246000fd5b500390565b634e487b7160e01b600052600160045260246000fd5b600082516200057a8184602087016200041b565b9190910192915050565b6020815260008251806020840152620005a58160408501602087016200041b565b601f01601f19169190910160400192915050565b608051610900620005f86000396000818161011201528181610176015281816102060152818161025e01528181610287015261030901526109006000f3fe6080604052600436106100435760003560e01c80633659cfe61461005a5780634f1ef2861461007a5780635c60da1b1461008d578063f851a440146100cb57610052565b36610052576100506100e0565b005b6100506100e0565b34801561006657600080fd5b5061005061007536600461076c565b6100fa565b610050610088366004610787565b61015e565b34801561009957600080fd5b506100a26101ec565b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390f35b3480156100d757600080fd5b506100a2610244565b6100e86102f1565b6100f86100f36103e2565b610422565b565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156101565761015381604051806020016040528060008152506000610446565b50565b6101536100e0565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156101e4576101df8383838080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525060019250610446915050565b505050565b6101df6100e0565b60003373ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000161415610239576102346103e2565b905090565b6102416100e0565b90565b60003373ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016141561023957507f000000000000000000000000000000000000000000000000000000000000000090565b60606102ce83836040518060600160405280602781526020016108a460279139610471565b9392505050565b73ffffffffffffffffffffffffffffffffffffffff163b151590565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156100f8576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f7879207461726760648201527f6574000000000000000000000000000000000000000000000000000000000000608482015260a4015b60405180910390fd5b60006102347f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc5473ffffffffffffffffffffffffffffffffffffffff1690565b3660008037600080366000845af43d6000803e808015610441573d6000f35b3d6000fd5b61044f83610599565b60008251118061045c5750805b156101df5761046b83836102a9565b50505050565b606073ffffffffffffffffffffffffffffffffffffffff84163b610517576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f60448201527f6e7472616374000000000000000000000000000000000000000000000000000060648201526084016103d9565b6000808573ffffffffffffffffffffffffffffffffffffffff168560405161053f9190610836565b600060405180830381855af49150503d806000811461057a576040519150601f19603f3d011682016040523d82523d6000602084013e61057f565b606091505b509150915061058f8282866105e6565b9695505050505050565b6105a281610639565b60405173ffffffffffffffffffffffffffffffffffffffff8216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b606083156105f55750816102ce565b8251156106055782518084602001fd5b816040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016103d99190610852565b73ffffffffffffffffffffffffffffffffffffffff81163b6106dd576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201527f6f74206120636f6e74726163740000000000000000000000000000000000000060648201526084016103d9565b7f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc80547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff92909216919091179055565b803573ffffffffffffffffffffffffffffffffffffffff8116811461076757600080fd5b919050565b60006020828403121561077e57600080fd5b6102ce82610743565b60008060006040848603121561079c57600080fd5b6107a584610743565b9250602084013567ffffffffffffffff808211156107c257600080fd5b818601915086601f8301126107d657600080fd5b8135818111156107e557600080fd5b8760208285010111156107f757600080fd5b6020830194508093505050509250925092565b60005b8381101561082557818101518382015260200161080d565b8381111561046b5750506000910152565b6000825161084881846020870161080a565b9190910192915050565b602081526000825180602084015261087181604085016020870161080a565b601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016919091016040019291505056fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a26469706673582212206f70214c51cdd41c05ba0ffeb72b309ca3c8be178fd6e73c12162330799984f364736f6c634300080a0033b53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564", + "deployedBytecode": "0x6080604052600436106100435760003560e01c80633659cfe61461005a5780634f1ef2861461007a5780635c60da1b1461008d578063f851a440146100cb57610052565b36610052576100506100e0565b005b6100506100e0565b34801561006657600080fd5b5061005061007536600461076c565b6100fa565b610050610088366004610787565b61015e565b34801561009957600080fd5b506100a26101ec565b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390f35b3480156100d757600080fd5b506100a2610244565b6100e86102f1565b6100f86100f36103e2565b610422565b565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156101565761015381604051806020016040528060008152506000610446565b50565b6101536100e0565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156101e4576101df8383838080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525060019250610446915050565b505050565b6101df6100e0565b60003373ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000161415610239576102346103e2565b905090565b6102416100e0565b90565b60003373ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016141561023957507f000000000000000000000000000000000000000000000000000000000000000090565b60606102ce83836040518060600160405280602781526020016108a460279139610471565b9392505050565b73ffffffffffffffffffffffffffffffffffffffff163b151590565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156100f8576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f7879207461726760648201527f6574000000000000000000000000000000000000000000000000000000000000608482015260a4015b60405180910390fd5b60006102347f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc5473ffffffffffffffffffffffffffffffffffffffff1690565b3660008037600080366000845af43d6000803e808015610441573d6000f35b3d6000fd5b61044f83610599565b60008251118061045c5750805b156101df5761046b83836102a9565b50505050565b606073ffffffffffffffffffffffffffffffffffffffff84163b610517576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f60448201527f6e7472616374000000000000000000000000000000000000000000000000000060648201526084016103d9565b6000808573ffffffffffffffffffffffffffffffffffffffff168560405161053f9190610836565b600060405180830381855af49150503d806000811461057a576040519150601f19603f3d011682016040523d82523d6000602084013e61057f565b606091505b509150915061058f8282866105e6565b9695505050505050565b6105a281610639565b60405173ffffffffffffffffffffffffffffffffffffffff8216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b606083156105f55750816102ce565b8251156106055782518084602001fd5b816040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016103d99190610852565b73ffffffffffffffffffffffffffffffffffffffff81163b6106dd576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201527f6f74206120636f6e74726163740000000000000000000000000000000000000060648201526084016103d9565b7f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc80547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff92909216919091179055565b803573ffffffffffffffffffffffffffffffffffffffff8116811461076757600080fd5b919050565b60006020828403121561077e57600080fd5b6102ce82610743565b60008060006040848603121561079c57600080fd5b6107a584610743565b9250602084013567ffffffffffffffff808211156107c257600080fd5b818601915086601f8301126107d657600080fd5b8135818111156107e557600080fd5b8760208285010111156107f757600080fd5b6020830194508093505050509250925092565b60005b8381101561082557818101518382015260200161080d565b8381111561046b5750506000910152565b6000825161084881846020870161080a565b9190910192915050565b602081526000825180602084015261087181604085016020870161080a565b601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016919091016040019291505056fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a26469706673582212206f70214c51cdd41c05ba0ffeb72b309ca3c8be178fd6e73c12162330799984f364736f6c634300080a0033", + "devdoc": { + "details": "This contract implements a proxy that is upgradeable by an admin. To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector clashing], which can potentially be used in an attack, this contract uses the https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two things that go hand in hand: 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if that call matches one of the admin functions exposed by the proxy itself. 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the implementation. If the admin tries to call a function on the implementation it will fail with an error that says \"admin cannot fallback to proxy target\". These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due to sudden errors when trying to call a function from the proxy implementation. Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way, you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.", + "kind": "dev", + "methods": { + "admin()": { + "details": "Returns the current admin. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`" + }, + "constructor": { + "details": "Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}." + }, + "implementation()": { + "details": "Returns the current implementation. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`" + }, + "upgradeTo(address)": { + "details": "Upgrade the implementation of the proxy. NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}." + }, + "upgradeToAndCall(address,bytes)": { + "details": "Upgrade the implementation of the proxy, and then call a function from the new implementation as specified by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the proxied contract. NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}." + } + }, + "version": 1 + }, + "userdoc": { + "kind": "user", + "methods": {}, + "version": 1 + }, + "storageLayout": { + "storage": [], + "types": null + } +} diff --git a/deployments/ethereum/solcInputs/04e4e9272baf051bc64349e36ce2636f.json b/deployments/ethereum/solcInputs/04e4e9272baf051bc64349e36ce2636f.json new file mode 100644 index 00000000..399f4998 --- /dev/null +++ b/deployments/ethereum/solcInputs/04e4e9272baf051bc64349e36ce2636f.json @@ -0,0 +1,271 @@ +{ + "language": "Solidity", + "sources": { + "@chainlink/contracts/src/v0.8/interfaces/AggregatorInterface.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface AggregatorInterface {\n function latestAnswer() external view returns (int256);\n\n function latestTimestamp() external view returns (uint256);\n\n function latestRound() external view returns (uint256);\n\n function getAnswer(uint256 roundId) external view returns (int256);\n\n function getTimestamp(uint256 roundId) external view returns (uint256);\n\n event AnswerUpdated(int256 indexed current, uint256 indexed roundId, uint256 updatedAt);\n\n event NewRound(uint256 indexed roundId, address indexed startedBy, uint256 startedAt);\n}\n" + }, + "@chainlink/contracts/src/v0.8/interfaces/AggregatorV2V3Interface.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./AggregatorInterface.sol\";\nimport \"./AggregatorV3Interface.sol\";\n\ninterface AggregatorV2V3Interface is AggregatorInterface, AggregatorV3Interface {}\n" + }, + "@chainlink/contracts/src/v0.8/interfaces/AggregatorV3Interface.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface AggregatorV3Interface {\n function decimals() external view returns (uint8);\n\n function description() external view returns (string memory);\n\n function version() external view returns (uint256);\n\n function getRoundData(uint80 _roundId)\n external\n view\n returns (\n uint80 roundId,\n int256 answer,\n uint256 startedAt,\n uint256 updatedAt,\n uint80 answeredInRound\n );\n\n function latestRoundData()\n external\n view\n returns (\n uint80 roundId,\n int256 answer,\n uint256 startedAt,\n uint256 updatedAt,\n uint80 answeredInRound\n );\n}\n" + }, + "@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable2Step.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./OwnableUpgradeable.sol\";\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module which provides access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership} and {acceptOwnership}.\n *\n * This module is used through inheritance. It will make available all functions\n * from parent (Ownable).\n */\nabstract contract Ownable2StepUpgradeable is Initializable, OwnableUpgradeable {\n function __Ownable2Step_init() internal onlyInitializing {\n __Ownable_init_unchained();\n }\n\n function __Ownable2Step_init_unchained() internal onlyInitializing {\n }\n address private _pendingOwner;\n\n event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner);\n\n /**\n * @dev Returns the address of the pending owner.\n */\n function pendingOwner() public view virtual returns (address) {\n return _pendingOwner;\n }\n\n /**\n * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.\n * Can only be called by the current owner.\n */\n function transferOwnership(address newOwner) public virtual override onlyOwner {\n _pendingOwner = newOwner;\n emit OwnershipTransferStarted(owner(), newOwner);\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.\n * Internal function without access restriction.\n */\n function _transferOwnership(address newOwner) internal virtual override {\n delete _pendingOwner;\n super._transferOwnership(newOwner);\n }\n\n /**\n * @dev The new owner accepts the ownership transfer.\n */\n function acceptOwnership() public virtual {\n address sender = _msgSender();\n require(pendingOwner() == sender, \"Ownable2Step: caller is not the new owner\");\n _transferOwnership(sender);\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n}\n" + }, + "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/ContextUpgradeable.sol\";\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module which provides a basic access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership}.\n *\n * This module is used through inheritance. It will make available the modifier\n * `onlyOwner`, which can be applied to your functions to restrict their use to\n * the owner.\n */\nabstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {\n address private _owner;\n\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\n\n /**\n * @dev Initializes the contract setting the deployer as the initial owner.\n */\n function __Ownable_init() internal onlyInitializing {\n __Ownable_init_unchained();\n }\n\n function __Ownable_init_unchained() internal onlyInitializing {\n _transferOwnership(_msgSender());\n }\n\n /**\n * @dev Throws if called by any account other than the owner.\n */\n modifier onlyOwner() {\n _checkOwner();\n _;\n }\n\n /**\n * @dev Returns the address of the current owner.\n */\n function owner() public view virtual returns (address) {\n return _owner;\n }\n\n /**\n * @dev Throws if the sender is not the owner.\n */\n function _checkOwner() internal view virtual {\n require(owner() == _msgSender(), \"Ownable: caller is not the owner\");\n }\n\n /**\n * @dev Leaves the contract without owner. It will not be possible to call\n * `onlyOwner` functions. Can only be called by the current owner.\n *\n * NOTE: Renouncing ownership will leave the contract without an owner,\n * thereby disabling any functionality that is only available to the owner.\n */\n function renounceOwnership() public virtual onlyOwner {\n _transferOwnership(address(0));\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Can only be called by the current owner.\n */\n function transferOwnership(address newOwner) public virtual onlyOwner {\n require(newOwner != address(0), \"Ownable: new owner is the zero address\");\n _transferOwnership(newOwner);\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Internal function without access restriction.\n */\n function _transferOwnership(address newOwner) internal virtual {\n address oldOwner = _owner;\n _owner = newOwner;\n emit OwnershipTransferred(oldOwner, newOwner);\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n}\n" + }, + "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../../utils/AddressUpgradeable.sol\";\n\n/**\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\n *\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\n * reused. This mechanism prevents re-execution of each \"step\" but allows the creation of new initialization steps in\n * case an upgrade adds a module that needs to be initialized.\n *\n * For example:\n *\n * [.hljs-theme-light.nopadding]\n * ```solidity\n * contract MyToken is ERC20Upgradeable {\n * function initialize() initializer public {\n * __ERC20_init(\"MyToken\", \"MTK\");\n * }\n * }\n *\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\n * function initializeV2() reinitializer(2) public {\n * __ERC20Permit_init(\"MyToken\");\n * }\n * }\n * ```\n *\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\n *\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\n *\n * [CAUTION]\n * ====\n * Avoid leaving a contract uninitialized.\n *\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\n *\n * [.hljs-theme-light.nopadding]\n * ```\n * /// @custom:oz-upgrades-unsafe-allow constructor\n * constructor() {\n * _disableInitializers();\n * }\n * ```\n * ====\n */\nabstract contract Initializable {\n /**\n * @dev Indicates that the contract has been initialized.\n * @custom:oz-retyped-from bool\n */\n uint8 private _initialized;\n\n /**\n * @dev Indicates that the contract is in the process of being initialized.\n */\n bool private _initializing;\n\n /**\n * @dev Triggered when the contract has been initialized or reinitialized.\n */\n event Initialized(uint8 version);\n\n /**\n * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\n * `onlyInitializing` functions can be used to initialize parent contracts.\n *\n * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\n * constructor.\n *\n * Emits an {Initialized} event.\n */\n modifier initializer() {\n bool isTopLevelCall = !_initializing;\n require(\n (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\n \"Initializable: contract is already initialized\"\n );\n _initialized = 1;\n if (isTopLevelCall) {\n _initializing = true;\n }\n _;\n if (isTopLevelCall) {\n _initializing = false;\n emit Initialized(1);\n }\n }\n\n /**\n * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\n * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\n * used to initialize parent contracts.\n *\n * A reinitializer may be used after the original initialization step. This is essential to configure modules that\n * are added through upgrades and that require initialization.\n *\n * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\n * cannot be nested. If one is invoked in the context of another, execution will revert.\n *\n * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\n * a contract, executing them in the right order is up to the developer or operator.\n *\n * WARNING: setting the version to 255 will prevent any future reinitialization.\n *\n * Emits an {Initialized} event.\n */\n modifier reinitializer(uint8 version) {\n require(!_initializing && _initialized < version, \"Initializable: contract is already initialized\");\n _initialized = version;\n _initializing = true;\n _;\n _initializing = false;\n emit Initialized(version);\n }\n\n /**\n * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\n * {initializer} and {reinitializer} modifiers, directly or indirectly.\n */\n modifier onlyInitializing() {\n require(_initializing, \"Initializable: contract is not initializing\");\n _;\n }\n\n /**\n * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\n * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\n * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\n * through proxies.\n *\n * Emits an {Initialized} event the first time it is successfully executed.\n */\n function _disableInitializers() internal virtual {\n require(!_initializing, \"Initializable: contract is initializing\");\n if (_initialized != type(uint8).max) {\n _initialized = type(uint8).max;\n emit Initialized(type(uint8).max);\n }\n }\n\n /**\n * @dev Returns the highest version that has been initialized. See {reinitializer}.\n */\n function _getInitializedVersion() internal view returns (uint8) {\n return _initialized;\n }\n\n /**\n * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\n */\n function _isInitializing() internal view returns (bool) {\n return _initializing;\n }\n}\n" + }, + "@openzeppelin/contracts-upgradeable/security/PausableUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/ContextUpgradeable.sol\";\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module which allows children to implement an emergency stop\n * mechanism that can be triggered by an authorized account.\n *\n * This module is used through inheritance. It will make available the\n * modifiers `whenNotPaused` and `whenPaused`, which can be applied to\n * the functions of your contract. Note that they will not be pausable by\n * simply including this module, only once the modifiers are put in place.\n */\nabstract contract PausableUpgradeable is Initializable, ContextUpgradeable {\n /**\n * @dev Emitted when the pause is triggered by `account`.\n */\n event Paused(address account);\n\n /**\n * @dev Emitted when the pause is lifted by `account`.\n */\n event Unpaused(address account);\n\n bool private _paused;\n\n /**\n * @dev Initializes the contract in unpaused state.\n */\n function __Pausable_init() internal onlyInitializing {\n __Pausable_init_unchained();\n }\n\n function __Pausable_init_unchained() internal onlyInitializing {\n _paused = false;\n }\n\n /**\n * @dev Modifier to make a function callable only when the contract is not paused.\n *\n * Requirements:\n *\n * - The contract must not be paused.\n */\n modifier whenNotPaused() {\n _requireNotPaused();\n _;\n }\n\n /**\n * @dev Modifier to make a function callable only when the contract is paused.\n *\n * Requirements:\n *\n * - The contract must be paused.\n */\n modifier whenPaused() {\n _requirePaused();\n _;\n }\n\n /**\n * @dev Returns true if the contract is paused, and false otherwise.\n */\n function paused() public view virtual returns (bool) {\n return _paused;\n }\n\n /**\n * @dev Throws if the contract is paused.\n */\n function _requireNotPaused() internal view virtual {\n require(!paused(), \"Pausable: paused\");\n }\n\n /**\n * @dev Throws if the contract is not paused.\n */\n function _requirePaused() internal view virtual {\n require(paused(), \"Pausable: not paused\");\n }\n\n /**\n * @dev Triggers stopped state.\n *\n * Requirements:\n *\n * - The contract must not be paused.\n */\n function _pause() internal virtual whenNotPaused {\n _paused = true;\n emit Paused(_msgSender());\n }\n\n /**\n * @dev Returns to normal state.\n *\n * Requirements:\n *\n * - The contract must be paused.\n */\n function _unpause() internal virtual whenPaused {\n _paused = false;\n emit Unpaused(_msgSender());\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n}\n" + }, + "@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary AddressUpgradeable {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n" + }, + "@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\n\npragma solidity ^0.8.0;\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Provides information about the current execution context, including the\n * sender of the transaction and its data. While these are generally available\n * via msg.sender and msg.data, they should not be accessed in such a direct\n * manner, since when dealing with meta-transactions the account sending and\n * paying for execution may not be the actual sender (as far as an application\n * is concerned).\n *\n * This contract is only required for intermediate, library-like contracts.\n */\nabstract contract ContextUpgradeable is Initializable {\n function __Context_init() internal onlyInitializing {\n }\n\n function __Context_init_unchained() internal onlyInitializing {\n }\n function _msgSender() internal view virtual returns (address) {\n return msg.sender;\n }\n\n function _msgData() internal view virtual returns (bytes calldata) {\n return msg.data;\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[50] private __gap;\n}\n" + }, + "@openzeppelin/contracts/access/AccessControl.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/AccessControl.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IAccessControl.sol\";\nimport \"../utils/Context.sol\";\nimport \"../utils/Strings.sol\";\nimport \"../utils/introspection/ERC165.sol\";\n\n/**\n * @dev Contract module that allows children to implement role-based access\n * control mechanisms. This is a lightweight version that doesn't allow enumerating role\n * members except through off-chain means by accessing the contract event logs. Some\n * applications may benefit from on-chain enumerability, for those cases see\n * {AccessControlEnumerable}.\n *\n * Roles are referred to by their `bytes32` identifier. These should be exposed\n * in the external API and be unique. The best way to achieve this is by\n * using `public constant` hash digests:\n *\n * ```solidity\n * bytes32 public constant MY_ROLE = keccak256(\"MY_ROLE\");\n * ```\n *\n * Roles can be used to represent a set of permissions. To restrict access to a\n * function call, use {hasRole}:\n *\n * ```solidity\n * function foo() public {\n * require(hasRole(MY_ROLE, msg.sender));\n * ...\n * }\n * ```\n *\n * Roles can be granted and revoked dynamically via the {grantRole} and\n * {revokeRole} functions. Each role has an associated admin role, and only\n * accounts that have a role's admin role can call {grantRole} and {revokeRole}.\n *\n * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means\n * that only accounts with this role will be able to grant or revoke other\n * roles. More complex role relationships can be created by using\n * {_setRoleAdmin}.\n *\n * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to\n * grant and revoke this role. Extra precautions should be taken to secure\n * accounts that have been granted it. We recommend using {AccessControlDefaultAdminRules}\n * to enforce additional security measures for this role.\n */\nabstract contract AccessControl is Context, IAccessControl, ERC165 {\n struct RoleData {\n mapping(address => bool) members;\n bytes32 adminRole;\n }\n\n mapping(bytes32 => RoleData) private _roles;\n\n bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;\n\n /**\n * @dev Modifier that checks that an account has a specific role. Reverts\n * with a standardized message including the required role.\n *\n * The format of the revert reason is given by the following regular expression:\n *\n * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/\n *\n * _Available since v4.1._\n */\n modifier onlyRole(bytes32 role) {\n _checkRole(role);\n _;\n }\n\n /**\n * @dev See {IERC165-supportsInterface}.\n */\n function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId);\n }\n\n /**\n * @dev Returns `true` if `account` has been granted `role`.\n */\n function hasRole(bytes32 role, address account) public view virtual override returns (bool) {\n return _roles[role].members[account];\n }\n\n /**\n * @dev Revert with a standard message if `_msgSender()` is missing `role`.\n * Overriding this function changes the behavior of the {onlyRole} modifier.\n *\n * Format of the revert message is described in {_checkRole}.\n *\n * _Available since v4.6._\n */\n function _checkRole(bytes32 role) internal view virtual {\n _checkRole(role, _msgSender());\n }\n\n /**\n * @dev Revert with a standard message if `account` is missing `role`.\n *\n * The format of the revert reason is given by the following regular expression:\n *\n * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/\n */\n function _checkRole(bytes32 role, address account) internal view virtual {\n if (!hasRole(role, account)) {\n revert(\n string(\n abi.encodePacked(\n \"AccessControl: account \",\n Strings.toHexString(account),\n \" is missing role \",\n Strings.toHexString(uint256(role), 32)\n )\n )\n );\n }\n }\n\n /**\n * @dev Returns the admin role that controls `role`. See {grantRole} and\n * {revokeRole}.\n *\n * To change a role's admin, use {_setRoleAdmin}.\n */\n function getRoleAdmin(bytes32 role) public view virtual override returns (bytes32) {\n return _roles[role].adminRole;\n }\n\n /**\n * @dev Grants `role` to `account`.\n *\n * If `account` had not been already granted `role`, emits a {RoleGranted}\n * event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n *\n * May emit a {RoleGranted} event.\n */\n function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {\n _grantRole(role, account);\n }\n\n /**\n * @dev Revokes `role` from `account`.\n *\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n *\n * May emit a {RoleRevoked} event.\n */\n function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {\n _revokeRole(role, account);\n }\n\n /**\n * @dev Revokes `role` from the calling account.\n *\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\n * purpose is to provide a mechanism for accounts to lose their privileges\n * if they are compromised (such as when a trusted device is misplaced).\n *\n * If the calling account had been revoked `role`, emits a {RoleRevoked}\n * event.\n *\n * Requirements:\n *\n * - the caller must be `account`.\n *\n * May emit a {RoleRevoked} event.\n */\n function renounceRole(bytes32 role, address account) public virtual override {\n require(account == _msgSender(), \"AccessControl: can only renounce roles for self\");\n\n _revokeRole(role, account);\n }\n\n /**\n * @dev Grants `role` to `account`.\n *\n * If `account` had not been already granted `role`, emits a {RoleGranted}\n * event. Note that unlike {grantRole}, this function doesn't perform any\n * checks on the calling account.\n *\n * May emit a {RoleGranted} event.\n *\n * [WARNING]\n * ====\n * This function should only be called from the constructor when setting\n * up the initial roles for the system.\n *\n * Using this function in any other way is effectively circumventing the admin\n * system imposed by {AccessControl}.\n * ====\n *\n * NOTE: This function is deprecated in favor of {_grantRole}.\n */\n function _setupRole(bytes32 role, address account) internal virtual {\n _grantRole(role, account);\n }\n\n /**\n * @dev Sets `adminRole` as ``role``'s admin role.\n *\n * Emits a {RoleAdminChanged} event.\n */\n function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {\n bytes32 previousAdminRole = getRoleAdmin(role);\n _roles[role].adminRole = adminRole;\n emit RoleAdminChanged(role, previousAdminRole, adminRole);\n }\n\n /**\n * @dev Grants `role` to `account`.\n *\n * Internal function without access restriction.\n *\n * May emit a {RoleGranted} event.\n */\n function _grantRole(bytes32 role, address account) internal virtual {\n if (!hasRole(role, account)) {\n _roles[role].members[account] = true;\n emit RoleGranted(role, account, _msgSender());\n }\n }\n\n /**\n * @dev Revokes `role` from `account`.\n *\n * Internal function without access restriction.\n *\n * May emit a {RoleRevoked} event.\n */\n function _revokeRole(bytes32 role, address account) internal virtual {\n if (hasRole(role, account)) {\n _roles[role].members[account] = false;\n emit RoleRevoked(role, account, _msgSender());\n }\n }\n}\n" + }, + "@openzeppelin/contracts/access/IAccessControl.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev External interface of AccessControl declared to support ERC165 detection.\n */\ninterface IAccessControl {\n /**\n * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`\n *\n * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite\n * {RoleAdminChanged} not being emitted signaling this.\n *\n * _Available since v3.1._\n */\n event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);\n\n /**\n * @dev Emitted when `account` is granted `role`.\n *\n * `sender` is the account that originated the contract call, an admin role\n * bearer except when using {AccessControl-_setupRole}.\n */\n event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);\n\n /**\n * @dev Emitted when `account` is revoked `role`.\n *\n * `sender` is the account that originated the contract call:\n * - if using `revokeRole`, it is the admin role bearer\n * - if using `renounceRole`, it is the role bearer (i.e. `account`)\n */\n event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);\n\n /**\n * @dev Returns `true` if `account` has been granted `role`.\n */\n function hasRole(bytes32 role, address account) external view returns (bool);\n\n /**\n * @dev Returns the admin role that controls `role`. See {grantRole} and\n * {revokeRole}.\n *\n * To change a role's admin, use {AccessControl-_setRoleAdmin}.\n */\n function getRoleAdmin(bytes32 role) external view returns (bytes32);\n\n /**\n * @dev Grants `role` to `account`.\n *\n * If `account` had not been already granted `role`, emits a {RoleGranted}\n * event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n */\n function grantRole(bytes32 role, address account) external;\n\n /**\n * @dev Revokes `role` from `account`.\n *\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n */\n function revokeRole(bytes32 role, address account) external;\n\n /**\n * @dev Revokes `role` from the calling account.\n *\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\n * purpose is to provide a mechanism for accounts to lose their privileges\n * if they are compromised (such as when a trusted device is misplaced).\n *\n * If the calling account had been granted `role`, emits a {RoleRevoked}\n * event.\n *\n * Requirements:\n *\n * - the caller must be `account`.\n */\n function renounceRole(bytes32 role, address account) external;\n}\n" + }, + "@openzeppelin/contracts/access/Ownable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/Context.sol\";\n\n/**\n * @dev Contract module which provides a basic access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership}.\n *\n * This module is used through inheritance. It will make available the modifier\n * `onlyOwner`, which can be applied to your functions to restrict their use to\n * the owner.\n */\nabstract contract Ownable is Context {\n address private _owner;\n\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\n\n /**\n * @dev Initializes the contract setting the deployer as the initial owner.\n */\n constructor() {\n _transferOwnership(_msgSender());\n }\n\n /**\n * @dev Throws if called by any account other than the owner.\n */\n modifier onlyOwner() {\n _checkOwner();\n _;\n }\n\n /**\n * @dev Returns the address of the current owner.\n */\n function owner() public view virtual returns (address) {\n return _owner;\n }\n\n /**\n * @dev Throws if the sender is not the owner.\n */\n function _checkOwner() internal view virtual {\n require(owner() == _msgSender(), \"Ownable: caller is not the owner\");\n }\n\n /**\n * @dev Leaves the contract without owner. It will not be possible to call\n * `onlyOwner` functions. Can only be called by the current owner.\n *\n * NOTE: Renouncing ownership will leave the contract without an owner,\n * thereby disabling any functionality that is only available to the owner.\n */\n function renounceOwnership() public virtual onlyOwner {\n _transferOwnership(address(0));\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Can only be called by the current owner.\n */\n function transferOwnership(address newOwner) public virtual onlyOwner {\n require(newOwner != address(0), \"Ownable: new owner is the zero address\");\n _transferOwnership(newOwner);\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Internal function without access restriction.\n */\n function _transferOwnership(address newOwner) internal virtual {\n address oldOwner = _owner;\n _owner = newOwner;\n emit OwnershipTransferred(oldOwner, newOwner);\n }\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/ERC20.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/ERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IERC20.sol\";\nimport \"./extensions/IERC20Metadata.sol\";\nimport \"../../utils/Context.sol\";\n\n/**\n * @dev Implementation of the {IERC20} interface.\n *\n * This implementation is agnostic to the way tokens are created. This means\n * that a supply mechanism has to be added in a derived contract using {_mint}.\n * For a generic mechanism see {ERC20PresetMinterPauser}.\n *\n * TIP: For a detailed writeup see our guide\n * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How\n * to implement supply mechanisms].\n *\n * The default value of {decimals} is 18. To change this, you should override\n * this function so it returns a different value.\n *\n * We have followed general OpenZeppelin Contracts guidelines: functions revert\n * instead returning `false` on failure. This behavior is nonetheless\n * conventional and does not conflict with the expectations of ERC20\n * applications.\n *\n * Additionally, an {Approval} event is emitted on calls to {transferFrom}.\n * This allows applications to reconstruct the allowance for all accounts just\n * by listening to said events. Other implementations of the EIP may not emit\n * these events, as it isn't required by the specification.\n *\n * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}\n * functions have been added to mitigate the well-known issues around setting\n * allowances. See {IERC20-approve}.\n */\ncontract ERC20 is Context, IERC20, IERC20Metadata {\n mapping(address => uint256) private _balances;\n\n mapping(address => mapping(address => uint256)) private _allowances;\n\n uint256 private _totalSupply;\n\n string private _name;\n string private _symbol;\n\n /**\n * @dev Sets the values for {name} and {symbol}.\n *\n * All two of these values are immutable: they can only be set once during\n * construction.\n */\n constructor(string memory name_, string memory symbol_) {\n _name = name_;\n _symbol = symbol_;\n }\n\n /**\n * @dev Returns the name of the token.\n */\n function name() public view virtual override returns (string memory) {\n return _name;\n }\n\n /**\n * @dev Returns the symbol of the token, usually a shorter version of the\n * name.\n */\n function symbol() public view virtual override returns (string memory) {\n return _symbol;\n }\n\n /**\n * @dev Returns the number of decimals used to get its user representation.\n * For example, if `decimals` equals `2`, a balance of `505` tokens should\n * be displayed to a user as `5.05` (`505 / 10 ** 2`).\n *\n * Tokens usually opt for a value of 18, imitating the relationship between\n * Ether and Wei. This is the default value returned by this function, unless\n * it's overridden.\n *\n * NOTE: This information is only used for _display_ purposes: it in\n * no way affects any of the arithmetic of the contract, including\n * {IERC20-balanceOf} and {IERC20-transfer}.\n */\n function decimals() public view virtual override returns (uint8) {\n return 18;\n }\n\n /**\n * @dev See {IERC20-totalSupply}.\n */\n function totalSupply() public view virtual override returns (uint256) {\n return _totalSupply;\n }\n\n /**\n * @dev See {IERC20-balanceOf}.\n */\n function balanceOf(address account) public view virtual override returns (uint256) {\n return _balances[account];\n }\n\n /**\n * @dev See {IERC20-transfer}.\n *\n * Requirements:\n *\n * - `to` cannot be the zero address.\n * - the caller must have a balance of at least `amount`.\n */\n function transfer(address to, uint256 amount) public virtual override returns (bool) {\n address owner = _msgSender();\n _transfer(owner, to, amount);\n return true;\n }\n\n /**\n * @dev See {IERC20-allowance}.\n */\n function allowance(address owner, address spender) public view virtual override returns (uint256) {\n return _allowances[owner][spender];\n }\n\n /**\n * @dev See {IERC20-approve}.\n *\n * NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on\n * `transferFrom`. This is semantically equivalent to an infinite approval.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n */\n function approve(address spender, uint256 amount) public virtual override returns (bool) {\n address owner = _msgSender();\n _approve(owner, spender, amount);\n return true;\n }\n\n /**\n * @dev See {IERC20-transferFrom}.\n *\n * Emits an {Approval} event indicating the updated allowance. This is not\n * required by the EIP. See the note at the beginning of {ERC20}.\n *\n * NOTE: Does not update the allowance if the current allowance\n * is the maximum `uint256`.\n *\n * Requirements:\n *\n * - `from` and `to` cannot be the zero address.\n * - `from` must have a balance of at least `amount`.\n * - the caller must have allowance for ``from``'s tokens of at least\n * `amount`.\n */\n function transferFrom(address from, address to, uint256 amount) public virtual override returns (bool) {\n address spender = _msgSender();\n _spendAllowance(from, spender, amount);\n _transfer(from, to, amount);\n return true;\n }\n\n /**\n * @dev Atomically increases the allowance granted to `spender` by the caller.\n *\n * This is an alternative to {approve} that can be used as a mitigation for\n * problems described in {IERC20-approve}.\n *\n * Emits an {Approval} event indicating the updated allowance.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n */\n function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {\n address owner = _msgSender();\n _approve(owner, spender, allowance(owner, spender) + addedValue);\n return true;\n }\n\n /**\n * @dev Atomically decreases the allowance granted to `spender` by the caller.\n *\n * This is an alternative to {approve} that can be used as a mitigation for\n * problems described in {IERC20-approve}.\n *\n * Emits an {Approval} event indicating the updated allowance.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n * - `spender` must have allowance for the caller of at least\n * `subtractedValue`.\n */\n function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {\n address owner = _msgSender();\n uint256 currentAllowance = allowance(owner, spender);\n require(currentAllowance >= subtractedValue, \"ERC20: decreased allowance below zero\");\n unchecked {\n _approve(owner, spender, currentAllowance - subtractedValue);\n }\n\n return true;\n }\n\n /**\n * @dev Moves `amount` of tokens from `from` to `to`.\n *\n * This internal function is equivalent to {transfer}, and can be used to\n * e.g. implement automatic token fees, slashing mechanisms, etc.\n *\n * Emits a {Transfer} event.\n *\n * Requirements:\n *\n * - `from` cannot be the zero address.\n * - `to` cannot be the zero address.\n * - `from` must have a balance of at least `amount`.\n */\n function _transfer(address from, address to, uint256 amount) internal virtual {\n require(from != address(0), \"ERC20: transfer from the zero address\");\n require(to != address(0), \"ERC20: transfer to the zero address\");\n\n _beforeTokenTransfer(from, to, amount);\n\n uint256 fromBalance = _balances[from];\n require(fromBalance >= amount, \"ERC20: transfer amount exceeds balance\");\n unchecked {\n _balances[from] = fromBalance - amount;\n // Overflow not possible: the sum of all balances is capped by totalSupply, and the sum is preserved by\n // decrementing then incrementing.\n _balances[to] += amount;\n }\n\n emit Transfer(from, to, amount);\n\n _afterTokenTransfer(from, to, amount);\n }\n\n /** @dev Creates `amount` tokens and assigns them to `account`, increasing\n * the total supply.\n *\n * Emits a {Transfer} event with `from` set to the zero address.\n *\n * Requirements:\n *\n * - `account` cannot be the zero address.\n */\n function _mint(address account, uint256 amount) internal virtual {\n require(account != address(0), \"ERC20: mint to the zero address\");\n\n _beforeTokenTransfer(address(0), account, amount);\n\n _totalSupply += amount;\n unchecked {\n // Overflow not possible: balance + amount is at most totalSupply + amount, which is checked above.\n _balances[account] += amount;\n }\n emit Transfer(address(0), account, amount);\n\n _afterTokenTransfer(address(0), account, amount);\n }\n\n /**\n * @dev Destroys `amount` tokens from `account`, reducing the\n * total supply.\n *\n * Emits a {Transfer} event with `to` set to the zero address.\n *\n * Requirements:\n *\n * - `account` cannot be the zero address.\n * - `account` must have at least `amount` tokens.\n */\n function _burn(address account, uint256 amount) internal virtual {\n require(account != address(0), \"ERC20: burn from the zero address\");\n\n _beforeTokenTransfer(account, address(0), amount);\n\n uint256 accountBalance = _balances[account];\n require(accountBalance >= amount, \"ERC20: burn amount exceeds balance\");\n unchecked {\n _balances[account] = accountBalance - amount;\n // Overflow not possible: amount <= accountBalance <= totalSupply.\n _totalSupply -= amount;\n }\n\n emit Transfer(account, address(0), amount);\n\n _afterTokenTransfer(account, address(0), amount);\n }\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.\n *\n * This internal function is equivalent to `approve`, and can be used to\n * e.g. set automatic allowances for certain subsystems, etc.\n *\n * Emits an {Approval} event.\n *\n * Requirements:\n *\n * - `owner` cannot be the zero address.\n * - `spender` cannot be the zero address.\n */\n function _approve(address owner, address spender, uint256 amount) internal virtual {\n require(owner != address(0), \"ERC20: approve from the zero address\");\n require(spender != address(0), \"ERC20: approve to the zero address\");\n\n _allowances[owner][spender] = amount;\n emit Approval(owner, spender, amount);\n }\n\n /**\n * @dev Updates `owner` s allowance for `spender` based on spent `amount`.\n *\n * Does not update the allowance amount in case of infinite allowance.\n * Revert if not enough allowance is available.\n *\n * Might emit an {Approval} event.\n */\n function _spendAllowance(address owner, address spender, uint256 amount) internal virtual {\n uint256 currentAllowance = allowance(owner, spender);\n if (currentAllowance != type(uint256).max) {\n require(currentAllowance >= amount, \"ERC20: insufficient allowance\");\n unchecked {\n _approve(owner, spender, currentAllowance - amount);\n }\n }\n }\n\n /**\n * @dev Hook that is called before any transfer of tokens. This includes\n * minting and burning.\n *\n * Calling conditions:\n *\n * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens\n * will be transferred to `to`.\n * - when `from` is zero, `amount` tokens will be minted for `to`.\n * - when `to` is zero, `amount` of ``from``'s tokens will be burned.\n * - `from` and `to` are never both zero.\n *\n * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].\n */\n function _beforeTokenTransfer(address from, address to, uint256 amount) internal virtual {}\n\n /**\n * @dev Hook that is called after any transfer of tokens. This includes\n * minting and burning.\n *\n * Calling conditions:\n *\n * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens\n * has been transferred to `to`.\n * - when `from` is zero, `amount` tokens have been minted for `to`.\n * - when `to` is zero, `amount` of ``from``'s tokens have been burned.\n * - `from` and `to` are never both zero.\n *\n * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].\n */\n function _afterTokenTransfer(address from, address to, uint256 amount) internal virtual {}\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20.sol\";\n\n/**\n * @dev Interface for the optional metadata functions from the ERC20 standard.\n *\n * _Available since v4.1._\n */\ninterface IERC20Metadata is IERC20 {\n /**\n * @dev Returns the name of the token.\n */\n function name() external view returns (string memory);\n\n /**\n * @dev Returns the symbol of the token.\n */\n function symbol() external view returns (string memory);\n\n /**\n * @dev Returns the decimals places of the token.\n */\n function decimals() external view returns (uint8);\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/IERC20.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 standard as defined in the EIP.\n */\ninterface IERC20 {\n /**\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\n * another (`to`).\n *\n * Note that `value` may be zero.\n */\n event Transfer(address indexed from, address indexed to, uint256 value);\n\n /**\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\n * a call to {approve}. `value` is the new allowance.\n */\n event Approval(address indexed owner, address indexed spender, uint256 value);\n\n /**\n * @dev Returns the amount of tokens in existence.\n */\n function totalSupply() external view returns (uint256);\n\n /**\n * @dev Returns the amount of tokens owned by `account`.\n */\n function balanceOf(address account) external view returns (uint256);\n\n /**\n * @dev Moves `amount` tokens from the caller's account to `to`.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transfer(address to, uint256 amount) external returns (bool);\n\n /**\n * @dev Returns the remaining number of tokens that `spender` will be\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\n * zero by default.\n *\n * This value changes when {approve} or {transferFrom} are called.\n */\n function allowance(address owner, address spender) external view returns (uint256);\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\n * that someone may use both the old and the new allowance by unfortunate\n * transaction ordering. One possible solution to mitigate this race\n * condition is to first reduce the spender's allowance to 0 and set the\n * desired value afterwards:\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n *\n * Emits an {Approval} event.\n */\n function approve(address spender, uint256 amount) external returns (bool);\n\n /**\n * @dev Moves `amount` tokens from `from` to `to` using the\n * allowance mechanism. `amount` is then deducted from the caller's\n * allowance.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\n}\n" + }, + "@openzeppelin/contracts/utils/Context.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Provides information about the current execution context, including the\n * sender of the transaction and its data. While these are generally available\n * via msg.sender and msg.data, they should not be accessed in such a direct\n * manner, since when dealing with meta-transactions the account sending and\n * paying for execution may not be the actual sender (as far as an application\n * is concerned).\n *\n * This contract is only required for intermediate, library-like contracts.\n */\nabstract contract Context {\n function _msgSender() internal view virtual returns (address) {\n return msg.sender;\n }\n\n function _msgData() internal view virtual returns (bytes calldata) {\n return msg.data;\n }\n}\n" + }, + "@openzeppelin/contracts/utils/introspection/ERC165.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IERC165.sol\";\n\n/**\n * @dev Implementation of the {IERC165} interface.\n *\n * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check\n * for the additional interface id that will be supported. For example:\n *\n * ```solidity\n * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n * return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);\n * }\n * ```\n *\n * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.\n */\nabstract contract ERC165 is IERC165 {\n /**\n * @dev See {IERC165-supportsInterface}.\n */\n function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n return interfaceId == type(IERC165).interfaceId;\n }\n}\n" + }, + "@openzeppelin/contracts/utils/introspection/IERC165.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC165 standard, as defined in the\n * https://eips.ethereum.org/EIPS/eip-165[EIP].\n *\n * Implementers can declare support of contract interfaces, which can then be\n * queried by others ({ERC165Checker}).\n *\n * For an implementation, see {ERC165}.\n */\ninterface IERC165 {\n /**\n * @dev Returns true if this contract implements the interface defined by\n * `interfaceId`. See the corresponding\n * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]\n * to learn more about how these ids are created.\n *\n * This function call must use less than 30 000 gas.\n */\n function supportsInterface(bytes4 interfaceId) external view returns (bool);\n}\n" + }, + "@openzeppelin/contracts/utils/math/Math.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard math utilities missing in the Solidity language.\n */\nlibrary Math {\n enum Rounding {\n Down, // Toward negative infinity\n Up, // Toward infinity\n Zero // Toward zero\n }\n\n /**\n * @dev Returns the largest of two numbers.\n */\n function max(uint256 a, uint256 b) internal pure returns (uint256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two numbers.\n */\n function min(uint256 a, uint256 b) internal pure returns (uint256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two numbers. The result is rounded towards\n * zero.\n */\n function average(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b) / 2 can overflow.\n return (a & b) + (a ^ b) / 2;\n }\n\n /**\n * @dev Returns the ceiling of the division of two numbers.\n *\n * This differs from standard division with `/` in that it rounds up instead\n * of rounding down.\n */\n function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b - 1) / b can overflow on addition, so we distribute.\n return a == 0 ? 0 : (a - 1) / b + 1;\n }\n\n /**\n * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0\n * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)\n * with further edits by Uniswap Labs also under MIT license.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {\n unchecked {\n // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use\n // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\n // variables such that product = prod1 * 2^256 + prod0.\n uint256 prod0; // Least significant 256 bits of the product\n uint256 prod1; // Most significant 256 bits of the product\n assembly {\n let mm := mulmod(x, y, not(0))\n prod0 := mul(x, y)\n prod1 := sub(sub(mm, prod0), lt(mm, prod0))\n }\n\n // Handle non-overflow cases, 256 by 256 division.\n if (prod1 == 0) {\n // Solidity will revert if denominator == 0, unlike the div opcode on its own.\n // The surrounding unchecked block does not change this fact.\n // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.\n return prod0 / denominator;\n }\n\n // Make sure the result is less than 2^256. Also prevents denominator == 0.\n require(denominator > prod1, \"Math: mulDiv overflow\");\n\n ///////////////////////////////////////////////\n // 512 by 256 division.\n ///////////////////////////////////////////////\n\n // Make division exact by subtracting the remainder from [prod1 prod0].\n uint256 remainder;\n assembly {\n // Compute remainder using mulmod.\n remainder := mulmod(x, y, denominator)\n\n // Subtract 256 bit number from 512 bit number.\n prod1 := sub(prod1, gt(remainder, prod0))\n prod0 := sub(prod0, remainder)\n }\n\n // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.\n // See https://cs.stackexchange.com/q/138556/92363.\n\n // Does not overflow because the denominator cannot be zero at this stage in the function.\n uint256 twos = denominator & (~denominator + 1);\n assembly {\n // Divide denominator by twos.\n denominator := div(denominator, twos)\n\n // Divide [prod1 prod0] by twos.\n prod0 := div(prod0, twos)\n\n // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.\n twos := add(div(sub(0, twos), twos), 1)\n }\n\n // Shift in bits from prod1 into prod0.\n prod0 |= prod1 * twos;\n\n // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such\n // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for\n // four bits. That is, denominator * inv = 1 mod 2^4.\n uint256 inverse = (3 * denominator) ^ 2;\n\n // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works\n // in modular arithmetic, doubling the correct bits in each step.\n inverse *= 2 - denominator * inverse; // inverse mod 2^8\n inverse *= 2 - denominator * inverse; // inverse mod 2^16\n inverse *= 2 - denominator * inverse; // inverse mod 2^32\n inverse *= 2 - denominator * inverse; // inverse mod 2^64\n inverse *= 2 - denominator * inverse; // inverse mod 2^128\n inverse *= 2 - denominator * inverse; // inverse mod 2^256\n\n // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.\n // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is\n // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1\n // is no longer required.\n result = prod0 * inverse;\n return result;\n }\n }\n\n /**\n * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {\n uint256 result = mulDiv(x, y, denominator);\n if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {\n result += 1;\n }\n return result;\n }\n\n /**\n * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.\n *\n * Inspired by Henry S. Warren, Jr.'s \"Hacker's Delight\" (Chapter 11).\n */\n function sqrt(uint256 a) internal pure returns (uint256) {\n if (a == 0) {\n return 0;\n }\n\n // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.\n //\n // We know that the \"msb\" (most significant bit) of our target number `a` is a power of 2 such that we have\n // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.\n //\n // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`\n // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`\n // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`\n //\n // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.\n uint256 result = 1 << (log2(a) >> 1);\n\n // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,\n // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at\n // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision\n // into the expected uint128 result.\n unchecked {\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n return min(result, a / result);\n }\n }\n\n /**\n * @notice Calculates sqrt(a), following the selected rounding direction.\n */\n function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = sqrt(a);\n return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 2, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 128;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 64;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 32;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 16;\n }\n if (value >> 8 > 0) {\n value >>= 8;\n result += 8;\n }\n if (value >> 4 > 0) {\n value >>= 4;\n result += 4;\n }\n if (value >> 2 > 0) {\n value >>= 2;\n result += 2;\n }\n if (value >> 1 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 2, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log2(value);\n return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 10, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >= 10 ** 64) {\n value /= 10 ** 64;\n result += 64;\n }\n if (value >= 10 ** 32) {\n value /= 10 ** 32;\n result += 32;\n }\n if (value >= 10 ** 16) {\n value /= 10 ** 16;\n result += 16;\n }\n if (value >= 10 ** 8) {\n value /= 10 ** 8;\n result += 8;\n }\n if (value >= 10 ** 4) {\n value /= 10 ** 4;\n result += 4;\n }\n if (value >= 10 ** 2) {\n value /= 10 ** 2;\n result += 2;\n }\n if (value >= 10 ** 1) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 10, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log10(value);\n return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 256, rounded down, of a positive value.\n * Returns 0 if given 0.\n *\n * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.\n */\n function log256(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 16;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 8;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 4;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 2;\n }\n if (value >> 8 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 256, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log256(value);\n return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);\n }\n }\n}\n" + }, + "@openzeppelin/contracts/utils/math/SafeCast.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SafeCast.sol)\n// This file was procedurally generated from scripts/generate/templates/SafeCast.js.\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Wrappers over Solidity's uintXX/intXX casting operators with added overflow\n * checks.\n *\n * Downcasting from uint256/int256 in Solidity does not revert on overflow. This can\n * easily result in undesired exploitation or bugs, since developers usually\n * assume that overflows raise errors. `SafeCast` restores this intuition by\n * reverting the transaction when such an operation overflows.\n *\n * Using this library instead of the unchecked operations eliminates an entire\n * class of bugs, so it's recommended to use it always.\n *\n * Can be combined with {SafeMath} and {SignedSafeMath} to extend it to smaller types, by performing\n * all math on `uint256` and `int256` and then downcasting.\n */\nlibrary SafeCast {\n /**\n * @dev Returns the downcasted uint248 from uint256, reverting on\n * overflow (when the input is greater than largest uint248).\n *\n * Counterpart to Solidity's `uint248` operator.\n *\n * Requirements:\n *\n * - input must fit into 248 bits\n *\n * _Available since v4.7._\n */\n function toUint248(uint256 value) internal pure returns (uint248) {\n require(value <= type(uint248).max, \"SafeCast: value doesn't fit in 248 bits\");\n return uint248(value);\n }\n\n /**\n * @dev Returns the downcasted uint240 from uint256, reverting on\n * overflow (when the input is greater than largest uint240).\n *\n * Counterpart to Solidity's `uint240` operator.\n *\n * Requirements:\n *\n * - input must fit into 240 bits\n *\n * _Available since v4.7._\n */\n function toUint240(uint256 value) internal pure returns (uint240) {\n require(value <= type(uint240).max, \"SafeCast: value doesn't fit in 240 bits\");\n return uint240(value);\n }\n\n /**\n * @dev Returns the downcasted uint232 from uint256, reverting on\n * overflow (when the input is greater than largest uint232).\n *\n * Counterpart to Solidity's `uint232` operator.\n *\n * Requirements:\n *\n * - input must fit into 232 bits\n *\n * _Available since v4.7._\n */\n function toUint232(uint256 value) internal pure returns (uint232) {\n require(value <= type(uint232).max, \"SafeCast: value doesn't fit in 232 bits\");\n return uint232(value);\n }\n\n /**\n * @dev Returns the downcasted uint224 from uint256, reverting on\n * overflow (when the input is greater than largest uint224).\n *\n * Counterpart to Solidity's `uint224` operator.\n *\n * Requirements:\n *\n * - input must fit into 224 bits\n *\n * _Available since v4.2._\n */\n function toUint224(uint256 value) internal pure returns (uint224) {\n require(value <= type(uint224).max, \"SafeCast: value doesn't fit in 224 bits\");\n return uint224(value);\n }\n\n /**\n * @dev Returns the downcasted uint216 from uint256, reverting on\n * overflow (when the input is greater than largest uint216).\n *\n * Counterpart to Solidity's `uint216` operator.\n *\n * Requirements:\n *\n * - input must fit into 216 bits\n *\n * _Available since v4.7._\n */\n function toUint216(uint256 value) internal pure returns (uint216) {\n require(value <= type(uint216).max, \"SafeCast: value doesn't fit in 216 bits\");\n return uint216(value);\n }\n\n /**\n * @dev Returns the downcasted uint208 from uint256, reverting on\n * overflow (when the input is greater than largest uint208).\n *\n * Counterpart to Solidity's `uint208` operator.\n *\n * Requirements:\n *\n * - input must fit into 208 bits\n *\n * _Available since v4.7._\n */\n function toUint208(uint256 value) internal pure returns (uint208) {\n require(value <= type(uint208).max, \"SafeCast: value doesn't fit in 208 bits\");\n return uint208(value);\n }\n\n /**\n * @dev Returns the downcasted uint200 from uint256, reverting on\n * overflow (when the input is greater than largest uint200).\n *\n * Counterpart to Solidity's `uint200` operator.\n *\n * Requirements:\n *\n * - input must fit into 200 bits\n *\n * _Available since v4.7._\n */\n function toUint200(uint256 value) internal pure returns (uint200) {\n require(value <= type(uint200).max, \"SafeCast: value doesn't fit in 200 bits\");\n return uint200(value);\n }\n\n /**\n * @dev Returns the downcasted uint192 from uint256, reverting on\n * overflow (when the input is greater than largest uint192).\n *\n * Counterpart to Solidity's `uint192` operator.\n *\n * Requirements:\n *\n * - input must fit into 192 bits\n *\n * _Available since v4.7._\n */\n function toUint192(uint256 value) internal pure returns (uint192) {\n require(value <= type(uint192).max, \"SafeCast: value doesn't fit in 192 bits\");\n return uint192(value);\n }\n\n /**\n * @dev Returns the downcasted uint184 from uint256, reverting on\n * overflow (when the input is greater than largest uint184).\n *\n * Counterpart to Solidity's `uint184` operator.\n *\n * Requirements:\n *\n * - input must fit into 184 bits\n *\n * _Available since v4.7._\n */\n function toUint184(uint256 value) internal pure returns (uint184) {\n require(value <= type(uint184).max, \"SafeCast: value doesn't fit in 184 bits\");\n return uint184(value);\n }\n\n /**\n * @dev Returns the downcasted uint176 from uint256, reverting on\n * overflow (when the input is greater than largest uint176).\n *\n * Counterpart to Solidity's `uint176` operator.\n *\n * Requirements:\n *\n * - input must fit into 176 bits\n *\n * _Available since v4.7._\n */\n function toUint176(uint256 value) internal pure returns (uint176) {\n require(value <= type(uint176).max, \"SafeCast: value doesn't fit in 176 bits\");\n return uint176(value);\n }\n\n /**\n * @dev Returns the downcasted uint168 from uint256, reverting on\n * overflow (when the input is greater than largest uint168).\n *\n * Counterpart to Solidity's `uint168` operator.\n *\n * Requirements:\n *\n * - input must fit into 168 bits\n *\n * _Available since v4.7._\n */\n function toUint168(uint256 value) internal pure returns (uint168) {\n require(value <= type(uint168).max, \"SafeCast: value doesn't fit in 168 bits\");\n return uint168(value);\n }\n\n /**\n * @dev Returns the downcasted uint160 from uint256, reverting on\n * overflow (when the input is greater than largest uint160).\n *\n * Counterpart to Solidity's `uint160` operator.\n *\n * Requirements:\n *\n * - input must fit into 160 bits\n *\n * _Available since v4.7._\n */\n function toUint160(uint256 value) internal pure returns (uint160) {\n require(value <= type(uint160).max, \"SafeCast: value doesn't fit in 160 bits\");\n return uint160(value);\n }\n\n /**\n * @dev Returns the downcasted uint152 from uint256, reverting on\n * overflow (when the input is greater than largest uint152).\n *\n * Counterpart to Solidity's `uint152` operator.\n *\n * Requirements:\n *\n * - input must fit into 152 bits\n *\n * _Available since v4.7._\n */\n function toUint152(uint256 value) internal pure returns (uint152) {\n require(value <= type(uint152).max, \"SafeCast: value doesn't fit in 152 bits\");\n return uint152(value);\n }\n\n /**\n * @dev Returns the downcasted uint144 from uint256, reverting on\n * overflow (when the input is greater than largest uint144).\n *\n * Counterpart to Solidity's `uint144` operator.\n *\n * Requirements:\n *\n * - input must fit into 144 bits\n *\n * _Available since v4.7._\n */\n function toUint144(uint256 value) internal pure returns (uint144) {\n require(value <= type(uint144).max, \"SafeCast: value doesn't fit in 144 bits\");\n return uint144(value);\n }\n\n /**\n * @dev Returns the downcasted uint136 from uint256, reverting on\n * overflow (when the input is greater than largest uint136).\n *\n * Counterpart to Solidity's `uint136` operator.\n *\n * Requirements:\n *\n * - input must fit into 136 bits\n *\n * _Available since v4.7._\n */\n function toUint136(uint256 value) internal pure returns (uint136) {\n require(value <= type(uint136).max, \"SafeCast: value doesn't fit in 136 bits\");\n return uint136(value);\n }\n\n /**\n * @dev Returns the downcasted uint128 from uint256, reverting on\n * overflow (when the input is greater than largest uint128).\n *\n * Counterpart to Solidity's `uint128` operator.\n *\n * Requirements:\n *\n * - input must fit into 128 bits\n *\n * _Available since v2.5._\n */\n function toUint128(uint256 value) internal pure returns (uint128) {\n require(value <= type(uint128).max, \"SafeCast: value doesn't fit in 128 bits\");\n return uint128(value);\n }\n\n /**\n * @dev Returns the downcasted uint120 from uint256, reverting on\n * overflow (when the input is greater than largest uint120).\n *\n * Counterpart to Solidity's `uint120` operator.\n *\n * Requirements:\n *\n * - input must fit into 120 bits\n *\n * _Available since v4.7._\n */\n function toUint120(uint256 value) internal pure returns (uint120) {\n require(value <= type(uint120).max, \"SafeCast: value doesn't fit in 120 bits\");\n return uint120(value);\n }\n\n /**\n * @dev Returns the downcasted uint112 from uint256, reverting on\n * overflow (when the input is greater than largest uint112).\n *\n * Counterpart to Solidity's `uint112` operator.\n *\n * Requirements:\n *\n * - input must fit into 112 bits\n *\n * _Available since v4.7._\n */\n function toUint112(uint256 value) internal pure returns (uint112) {\n require(value <= type(uint112).max, \"SafeCast: value doesn't fit in 112 bits\");\n return uint112(value);\n }\n\n /**\n * @dev Returns the downcasted uint104 from uint256, reverting on\n * overflow (when the input is greater than largest uint104).\n *\n * Counterpart to Solidity's `uint104` operator.\n *\n * Requirements:\n *\n * - input must fit into 104 bits\n *\n * _Available since v4.7._\n */\n function toUint104(uint256 value) internal pure returns (uint104) {\n require(value <= type(uint104).max, \"SafeCast: value doesn't fit in 104 bits\");\n return uint104(value);\n }\n\n /**\n * @dev Returns the downcasted uint96 from uint256, reverting on\n * overflow (when the input is greater than largest uint96).\n *\n * Counterpart to Solidity's `uint96` operator.\n *\n * Requirements:\n *\n * - input must fit into 96 bits\n *\n * _Available since v4.2._\n */\n function toUint96(uint256 value) internal pure returns (uint96) {\n require(value <= type(uint96).max, \"SafeCast: value doesn't fit in 96 bits\");\n return uint96(value);\n }\n\n /**\n * @dev Returns the downcasted uint88 from uint256, reverting on\n * overflow (when the input is greater than largest uint88).\n *\n * Counterpart to Solidity's `uint88` operator.\n *\n * Requirements:\n *\n * - input must fit into 88 bits\n *\n * _Available since v4.7._\n */\n function toUint88(uint256 value) internal pure returns (uint88) {\n require(value <= type(uint88).max, \"SafeCast: value doesn't fit in 88 bits\");\n return uint88(value);\n }\n\n /**\n * @dev Returns the downcasted uint80 from uint256, reverting on\n * overflow (when the input is greater than largest uint80).\n *\n * Counterpart to Solidity's `uint80` operator.\n *\n * Requirements:\n *\n * - input must fit into 80 bits\n *\n * _Available since v4.7._\n */\n function toUint80(uint256 value) internal pure returns (uint80) {\n require(value <= type(uint80).max, \"SafeCast: value doesn't fit in 80 bits\");\n return uint80(value);\n }\n\n /**\n * @dev Returns the downcasted uint72 from uint256, reverting on\n * overflow (when the input is greater than largest uint72).\n *\n * Counterpart to Solidity's `uint72` operator.\n *\n * Requirements:\n *\n * - input must fit into 72 bits\n *\n * _Available since v4.7._\n */\n function toUint72(uint256 value) internal pure returns (uint72) {\n require(value <= type(uint72).max, \"SafeCast: value doesn't fit in 72 bits\");\n return uint72(value);\n }\n\n /**\n * @dev Returns the downcasted uint64 from uint256, reverting on\n * overflow (when the input is greater than largest uint64).\n *\n * Counterpart to Solidity's `uint64` operator.\n *\n * Requirements:\n *\n * - input must fit into 64 bits\n *\n * _Available since v2.5._\n */\n function toUint64(uint256 value) internal pure returns (uint64) {\n require(value <= type(uint64).max, \"SafeCast: value doesn't fit in 64 bits\");\n return uint64(value);\n }\n\n /**\n * @dev Returns the downcasted uint56 from uint256, reverting on\n * overflow (when the input is greater than largest uint56).\n *\n * Counterpart to Solidity's `uint56` operator.\n *\n * Requirements:\n *\n * - input must fit into 56 bits\n *\n * _Available since v4.7._\n */\n function toUint56(uint256 value) internal pure returns (uint56) {\n require(value <= type(uint56).max, \"SafeCast: value doesn't fit in 56 bits\");\n return uint56(value);\n }\n\n /**\n * @dev Returns the downcasted uint48 from uint256, reverting on\n * overflow (when the input is greater than largest uint48).\n *\n * Counterpart to Solidity's `uint48` operator.\n *\n * Requirements:\n *\n * - input must fit into 48 bits\n *\n * _Available since v4.7._\n */\n function toUint48(uint256 value) internal pure returns (uint48) {\n require(value <= type(uint48).max, \"SafeCast: value doesn't fit in 48 bits\");\n return uint48(value);\n }\n\n /**\n * @dev Returns the downcasted uint40 from uint256, reverting on\n * overflow (when the input is greater than largest uint40).\n *\n * Counterpart to Solidity's `uint40` operator.\n *\n * Requirements:\n *\n * - input must fit into 40 bits\n *\n * _Available since v4.7._\n */\n function toUint40(uint256 value) internal pure returns (uint40) {\n require(value <= type(uint40).max, \"SafeCast: value doesn't fit in 40 bits\");\n return uint40(value);\n }\n\n /**\n * @dev Returns the downcasted uint32 from uint256, reverting on\n * overflow (when the input is greater than largest uint32).\n *\n * Counterpart to Solidity's `uint32` operator.\n *\n * Requirements:\n *\n * - input must fit into 32 bits\n *\n * _Available since v2.5._\n */\n function toUint32(uint256 value) internal pure returns (uint32) {\n require(value <= type(uint32).max, \"SafeCast: value doesn't fit in 32 bits\");\n return uint32(value);\n }\n\n /**\n * @dev Returns the downcasted uint24 from uint256, reverting on\n * overflow (when the input is greater than largest uint24).\n *\n * Counterpart to Solidity's `uint24` operator.\n *\n * Requirements:\n *\n * - input must fit into 24 bits\n *\n * _Available since v4.7._\n */\n function toUint24(uint256 value) internal pure returns (uint24) {\n require(value <= type(uint24).max, \"SafeCast: value doesn't fit in 24 bits\");\n return uint24(value);\n }\n\n /**\n * @dev Returns the downcasted uint16 from uint256, reverting on\n * overflow (when the input is greater than largest uint16).\n *\n * Counterpart to Solidity's `uint16` operator.\n *\n * Requirements:\n *\n * - input must fit into 16 bits\n *\n * _Available since v2.5._\n */\n function toUint16(uint256 value) internal pure returns (uint16) {\n require(value <= type(uint16).max, \"SafeCast: value doesn't fit in 16 bits\");\n return uint16(value);\n }\n\n /**\n * @dev Returns the downcasted uint8 from uint256, reverting on\n * overflow (when the input is greater than largest uint8).\n *\n * Counterpart to Solidity's `uint8` operator.\n *\n * Requirements:\n *\n * - input must fit into 8 bits\n *\n * _Available since v2.5._\n */\n function toUint8(uint256 value) internal pure returns (uint8) {\n require(value <= type(uint8).max, \"SafeCast: value doesn't fit in 8 bits\");\n return uint8(value);\n }\n\n /**\n * @dev Converts a signed int256 into an unsigned uint256.\n *\n * Requirements:\n *\n * - input must be greater than or equal to 0.\n *\n * _Available since v3.0._\n */\n function toUint256(int256 value) internal pure returns (uint256) {\n require(value >= 0, \"SafeCast: value must be positive\");\n return uint256(value);\n }\n\n /**\n * @dev Returns the downcasted int248 from int256, reverting on\n * overflow (when the input is less than smallest int248 or\n * greater than largest int248).\n *\n * Counterpart to Solidity's `int248` operator.\n *\n * Requirements:\n *\n * - input must fit into 248 bits\n *\n * _Available since v4.7._\n */\n function toInt248(int256 value) internal pure returns (int248 downcasted) {\n downcasted = int248(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 248 bits\");\n }\n\n /**\n * @dev Returns the downcasted int240 from int256, reverting on\n * overflow (when the input is less than smallest int240 or\n * greater than largest int240).\n *\n * Counterpart to Solidity's `int240` operator.\n *\n * Requirements:\n *\n * - input must fit into 240 bits\n *\n * _Available since v4.7._\n */\n function toInt240(int256 value) internal pure returns (int240 downcasted) {\n downcasted = int240(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 240 bits\");\n }\n\n /**\n * @dev Returns the downcasted int232 from int256, reverting on\n * overflow (when the input is less than smallest int232 or\n * greater than largest int232).\n *\n * Counterpart to Solidity's `int232` operator.\n *\n * Requirements:\n *\n * - input must fit into 232 bits\n *\n * _Available since v4.7._\n */\n function toInt232(int256 value) internal pure returns (int232 downcasted) {\n downcasted = int232(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 232 bits\");\n }\n\n /**\n * @dev Returns the downcasted int224 from int256, reverting on\n * overflow (when the input is less than smallest int224 or\n * greater than largest int224).\n *\n * Counterpart to Solidity's `int224` operator.\n *\n * Requirements:\n *\n * - input must fit into 224 bits\n *\n * _Available since v4.7._\n */\n function toInt224(int256 value) internal pure returns (int224 downcasted) {\n downcasted = int224(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 224 bits\");\n }\n\n /**\n * @dev Returns the downcasted int216 from int256, reverting on\n * overflow (when the input is less than smallest int216 or\n * greater than largest int216).\n *\n * Counterpart to Solidity's `int216` operator.\n *\n * Requirements:\n *\n * - input must fit into 216 bits\n *\n * _Available since v4.7._\n */\n function toInt216(int256 value) internal pure returns (int216 downcasted) {\n downcasted = int216(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 216 bits\");\n }\n\n /**\n * @dev Returns the downcasted int208 from int256, reverting on\n * overflow (when the input is less than smallest int208 or\n * greater than largest int208).\n *\n * Counterpart to Solidity's `int208` operator.\n *\n * Requirements:\n *\n * - input must fit into 208 bits\n *\n * _Available since v4.7._\n */\n function toInt208(int256 value) internal pure returns (int208 downcasted) {\n downcasted = int208(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 208 bits\");\n }\n\n /**\n * @dev Returns the downcasted int200 from int256, reverting on\n * overflow (when the input is less than smallest int200 or\n * greater than largest int200).\n *\n * Counterpart to Solidity's `int200` operator.\n *\n * Requirements:\n *\n * - input must fit into 200 bits\n *\n * _Available since v4.7._\n */\n function toInt200(int256 value) internal pure returns (int200 downcasted) {\n downcasted = int200(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 200 bits\");\n }\n\n /**\n * @dev Returns the downcasted int192 from int256, reverting on\n * overflow (when the input is less than smallest int192 or\n * greater than largest int192).\n *\n * Counterpart to Solidity's `int192` operator.\n *\n * Requirements:\n *\n * - input must fit into 192 bits\n *\n * _Available since v4.7._\n */\n function toInt192(int256 value) internal pure returns (int192 downcasted) {\n downcasted = int192(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 192 bits\");\n }\n\n /**\n * @dev Returns the downcasted int184 from int256, reverting on\n * overflow (when the input is less than smallest int184 or\n * greater than largest int184).\n *\n * Counterpart to Solidity's `int184` operator.\n *\n * Requirements:\n *\n * - input must fit into 184 bits\n *\n * _Available since v4.7._\n */\n function toInt184(int256 value) internal pure returns (int184 downcasted) {\n downcasted = int184(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 184 bits\");\n }\n\n /**\n * @dev Returns the downcasted int176 from int256, reverting on\n * overflow (when the input is less than smallest int176 or\n * greater than largest int176).\n *\n * Counterpart to Solidity's `int176` operator.\n *\n * Requirements:\n *\n * - input must fit into 176 bits\n *\n * _Available since v4.7._\n */\n function toInt176(int256 value) internal pure returns (int176 downcasted) {\n downcasted = int176(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 176 bits\");\n }\n\n /**\n * @dev Returns the downcasted int168 from int256, reverting on\n * overflow (when the input is less than smallest int168 or\n * greater than largest int168).\n *\n * Counterpart to Solidity's `int168` operator.\n *\n * Requirements:\n *\n * - input must fit into 168 bits\n *\n * _Available since v4.7._\n */\n function toInt168(int256 value) internal pure returns (int168 downcasted) {\n downcasted = int168(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 168 bits\");\n }\n\n /**\n * @dev Returns the downcasted int160 from int256, reverting on\n * overflow (when the input is less than smallest int160 or\n * greater than largest int160).\n *\n * Counterpart to Solidity's `int160` operator.\n *\n * Requirements:\n *\n * - input must fit into 160 bits\n *\n * _Available since v4.7._\n */\n function toInt160(int256 value) internal pure returns (int160 downcasted) {\n downcasted = int160(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 160 bits\");\n }\n\n /**\n * @dev Returns the downcasted int152 from int256, reverting on\n * overflow (when the input is less than smallest int152 or\n * greater than largest int152).\n *\n * Counterpart to Solidity's `int152` operator.\n *\n * Requirements:\n *\n * - input must fit into 152 bits\n *\n * _Available since v4.7._\n */\n function toInt152(int256 value) internal pure returns (int152 downcasted) {\n downcasted = int152(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 152 bits\");\n }\n\n /**\n * @dev Returns the downcasted int144 from int256, reverting on\n * overflow (when the input is less than smallest int144 or\n * greater than largest int144).\n *\n * Counterpart to Solidity's `int144` operator.\n *\n * Requirements:\n *\n * - input must fit into 144 bits\n *\n * _Available since v4.7._\n */\n function toInt144(int256 value) internal pure returns (int144 downcasted) {\n downcasted = int144(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 144 bits\");\n }\n\n /**\n * @dev Returns the downcasted int136 from int256, reverting on\n * overflow (when the input is less than smallest int136 or\n * greater than largest int136).\n *\n * Counterpart to Solidity's `int136` operator.\n *\n * Requirements:\n *\n * - input must fit into 136 bits\n *\n * _Available since v4.7._\n */\n function toInt136(int256 value) internal pure returns (int136 downcasted) {\n downcasted = int136(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 136 bits\");\n }\n\n /**\n * @dev Returns the downcasted int128 from int256, reverting on\n * overflow (when the input is less than smallest int128 or\n * greater than largest int128).\n *\n * Counterpart to Solidity's `int128` operator.\n *\n * Requirements:\n *\n * - input must fit into 128 bits\n *\n * _Available since v3.1._\n */\n function toInt128(int256 value) internal pure returns (int128 downcasted) {\n downcasted = int128(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 128 bits\");\n }\n\n /**\n * @dev Returns the downcasted int120 from int256, reverting on\n * overflow (when the input is less than smallest int120 or\n * greater than largest int120).\n *\n * Counterpart to Solidity's `int120` operator.\n *\n * Requirements:\n *\n * - input must fit into 120 bits\n *\n * _Available since v4.7._\n */\n function toInt120(int256 value) internal pure returns (int120 downcasted) {\n downcasted = int120(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 120 bits\");\n }\n\n /**\n * @dev Returns the downcasted int112 from int256, reverting on\n * overflow (when the input is less than smallest int112 or\n * greater than largest int112).\n *\n * Counterpart to Solidity's `int112` operator.\n *\n * Requirements:\n *\n * - input must fit into 112 bits\n *\n * _Available since v4.7._\n */\n function toInt112(int256 value) internal pure returns (int112 downcasted) {\n downcasted = int112(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 112 bits\");\n }\n\n /**\n * @dev Returns the downcasted int104 from int256, reverting on\n * overflow (when the input is less than smallest int104 or\n * greater than largest int104).\n *\n * Counterpart to Solidity's `int104` operator.\n *\n * Requirements:\n *\n * - input must fit into 104 bits\n *\n * _Available since v4.7._\n */\n function toInt104(int256 value) internal pure returns (int104 downcasted) {\n downcasted = int104(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 104 bits\");\n }\n\n /**\n * @dev Returns the downcasted int96 from int256, reverting on\n * overflow (when the input is less than smallest int96 or\n * greater than largest int96).\n *\n * Counterpart to Solidity's `int96` operator.\n *\n * Requirements:\n *\n * - input must fit into 96 bits\n *\n * _Available since v4.7._\n */\n function toInt96(int256 value) internal pure returns (int96 downcasted) {\n downcasted = int96(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 96 bits\");\n }\n\n /**\n * @dev Returns the downcasted int88 from int256, reverting on\n * overflow (when the input is less than smallest int88 or\n * greater than largest int88).\n *\n * Counterpart to Solidity's `int88` operator.\n *\n * Requirements:\n *\n * - input must fit into 88 bits\n *\n * _Available since v4.7._\n */\n function toInt88(int256 value) internal pure returns (int88 downcasted) {\n downcasted = int88(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 88 bits\");\n }\n\n /**\n * @dev Returns the downcasted int80 from int256, reverting on\n * overflow (when the input is less than smallest int80 or\n * greater than largest int80).\n *\n * Counterpart to Solidity's `int80` operator.\n *\n * Requirements:\n *\n * - input must fit into 80 bits\n *\n * _Available since v4.7._\n */\n function toInt80(int256 value) internal pure returns (int80 downcasted) {\n downcasted = int80(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 80 bits\");\n }\n\n /**\n * @dev Returns the downcasted int72 from int256, reverting on\n * overflow (when the input is less than smallest int72 or\n * greater than largest int72).\n *\n * Counterpart to Solidity's `int72` operator.\n *\n * Requirements:\n *\n * - input must fit into 72 bits\n *\n * _Available since v4.7._\n */\n function toInt72(int256 value) internal pure returns (int72 downcasted) {\n downcasted = int72(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 72 bits\");\n }\n\n /**\n * @dev Returns the downcasted int64 from int256, reverting on\n * overflow (when the input is less than smallest int64 or\n * greater than largest int64).\n *\n * Counterpart to Solidity's `int64` operator.\n *\n * Requirements:\n *\n * - input must fit into 64 bits\n *\n * _Available since v3.1._\n */\n function toInt64(int256 value) internal pure returns (int64 downcasted) {\n downcasted = int64(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 64 bits\");\n }\n\n /**\n * @dev Returns the downcasted int56 from int256, reverting on\n * overflow (when the input is less than smallest int56 or\n * greater than largest int56).\n *\n * Counterpart to Solidity's `int56` operator.\n *\n * Requirements:\n *\n * - input must fit into 56 bits\n *\n * _Available since v4.7._\n */\n function toInt56(int256 value) internal pure returns (int56 downcasted) {\n downcasted = int56(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 56 bits\");\n }\n\n /**\n * @dev Returns the downcasted int48 from int256, reverting on\n * overflow (when the input is less than smallest int48 or\n * greater than largest int48).\n *\n * Counterpart to Solidity's `int48` operator.\n *\n * Requirements:\n *\n * - input must fit into 48 bits\n *\n * _Available since v4.7._\n */\n function toInt48(int256 value) internal pure returns (int48 downcasted) {\n downcasted = int48(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 48 bits\");\n }\n\n /**\n * @dev Returns the downcasted int40 from int256, reverting on\n * overflow (when the input is less than smallest int40 or\n * greater than largest int40).\n *\n * Counterpart to Solidity's `int40` operator.\n *\n * Requirements:\n *\n * - input must fit into 40 bits\n *\n * _Available since v4.7._\n */\n function toInt40(int256 value) internal pure returns (int40 downcasted) {\n downcasted = int40(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 40 bits\");\n }\n\n /**\n * @dev Returns the downcasted int32 from int256, reverting on\n * overflow (when the input is less than smallest int32 or\n * greater than largest int32).\n *\n * Counterpart to Solidity's `int32` operator.\n *\n * Requirements:\n *\n * - input must fit into 32 bits\n *\n * _Available since v3.1._\n */\n function toInt32(int256 value) internal pure returns (int32 downcasted) {\n downcasted = int32(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 32 bits\");\n }\n\n /**\n * @dev Returns the downcasted int24 from int256, reverting on\n * overflow (when the input is less than smallest int24 or\n * greater than largest int24).\n *\n * Counterpart to Solidity's `int24` operator.\n *\n * Requirements:\n *\n * - input must fit into 24 bits\n *\n * _Available since v4.7._\n */\n function toInt24(int256 value) internal pure returns (int24 downcasted) {\n downcasted = int24(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 24 bits\");\n }\n\n /**\n * @dev Returns the downcasted int16 from int256, reverting on\n * overflow (when the input is less than smallest int16 or\n * greater than largest int16).\n *\n * Counterpart to Solidity's `int16` operator.\n *\n * Requirements:\n *\n * - input must fit into 16 bits\n *\n * _Available since v3.1._\n */\n function toInt16(int256 value) internal pure returns (int16 downcasted) {\n downcasted = int16(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 16 bits\");\n }\n\n /**\n * @dev Returns the downcasted int8 from int256, reverting on\n * overflow (when the input is less than smallest int8 or\n * greater than largest int8).\n *\n * Counterpart to Solidity's `int8` operator.\n *\n * Requirements:\n *\n * - input must fit into 8 bits\n *\n * _Available since v3.1._\n */\n function toInt8(int256 value) internal pure returns (int8 downcasted) {\n downcasted = int8(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 8 bits\");\n }\n\n /**\n * @dev Converts an unsigned uint256 into a signed int256.\n *\n * Requirements:\n *\n * - input must be less than or equal to maxInt256.\n *\n * _Available since v3.0._\n */\n function toInt256(uint256 value) internal pure returns (int256) {\n // Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive\n require(value <= uint256(type(int256).max), \"SafeCast: value doesn't fit in an int256\");\n return int256(value);\n }\n}\n" + }, + "@openzeppelin/contracts/utils/math/SignedMath.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard signed math utilities missing in the Solidity language.\n */\nlibrary SignedMath {\n /**\n * @dev Returns the largest of two signed numbers.\n */\n function max(int256 a, int256 b) internal pure returns (int256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two signed numbers.\n */\n function min(int256 a, int256 b) internal pure returns (int256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two signed numbers without overflow.\n * The result is rounded towards zero.\n */\n function average(int256 a, int256 b) internal pure returns (int256) {\n // Formula from the book \"Hacker's Delight\"\n int256 x = (a & b) + ((a ^ b) >> 1);\n return x + (int256(uint256(x) >> 255) & (a ^ b));\n }\n\n /**\n * @dev Returns the absolute unsigned value of a signed value.\n */\n function abs(int256 n) internal pure returns (uint256) {\n unchecked {\n // must be unchecked in order to support `n = type(int256).min`\n return uint256(n >= 0 ? n : -n);\n }\n }\n}\n" + }, + "@openzeppelin/contracts/utils/Strings.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./math/Math.sol\";\nimport \"./math/SignedMath.sol\";\n\n/**\n * @dev String operations.\n */\nlibrary Strings {\n bytes16 private constant _SYMBOLS = \"0123456789abcdef\";\n uint8 private constant _ADDRESS_LENGTH = 20;\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` decimal representation.\n */\n function toString(uint256 value) internal pure returns (string memory) {\n unchecked {\n uint256 length = Math.log10(value) + 1;\n string memory buffer = new string(length);\n uint256 ptr;\n /// @solidity memory-safe-assembly\n assembly {\n ptr := add(buffer, add(32, length))\n }\n while (true) {\n ptr--;\n /// @solidity memory-safe-assembly\n assembly {\n mstore8(ptr, byte(mod(value, 10), _SYMBOLS))\n }\n value /= 10;\n if (value == 0) break;\n }\n return buffer;\n }\n }\n\n /**\n * @dev Converts a `int256` to its ASCII `string` decimal representation.\n */\n function toString(int256 value) internal pure returns (string memory) {\n return string(abi.encodePacked(value < 0 ? \"-\" : \"\", toString(SignedMath.abs(value))));\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.\n */\n function toHexString(uint256 value) internal pure returns (string memory) {\n unchecked {\n return toHexString(value, Math.log256(value) + 1);\n }\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.\n */\n function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {\n bytes memory buffer = new bytes(2 * length + 2);\n buffer[0] = \"0\";\n buffer[1] = \"x\";\n for (uint256 i = 2 * length + 1; i > 1; --i) {\n buffer[i] = _SYMBOLS[value & 0xf];\n value >>= 4;\n }\n require(value == 0, \"Strings: hex length insufficient\");\n return string(buffer);\n }\n\n /**\n * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.\n */\n function toHexString(address addr) internal pure returns (string memory) {\n return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);\n }\n\n /**\n * @dev Returns true if the two strings are equal.\n */\n function equal(string memory a, string memory b) internal pure returns (bool) {\n return keccak256(bytes(a)) == keccak256(bytes(b));\n }\n}\n" + }, + "@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\";\n\nimport \"./IAccessControlManagerV8.sol\";\n\n/**\n * @title AccessControlledV8\n * @author Venus\n * @notice This contract is helper between access control manager and actual contract. This contract further inherited by other contract (using solidity 0.8.13)\n * to integrate access controlled mechanism. It provides initialise methods and verifying access methods.\n */\nabstract contract AccessControlledV8 is Initializable, Ownable2StepUpgradeable {\n /// @notice Access control manager contract\n IAccessControlManagerV8 private _accessControlManager;\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n\n /// @notice Emitted when access control manager contract address is changed\n event NewAccessControlManager(address oldAccessControlManager, address newAccessControlManager);\n\n /// @notice Thrown when the action is prohibited by AccessControlManager\n error Unauthorized(address sender, address calledContract, string methodSignature);\n\n function __AccessControlled_init(address accessControlManager_) internal onlyInitializing {\n __Ownable2Step_init();\n __AccessControlled_init_unchained(accessControlManager_);\n }\n\n function __AccessControlled_init_unchained(address accessControlManager_) internal onlyInitializing {\n _setAccessControlManager(accessControlManager_);\n }\n\n /**\n * @notice Sets the address of AccessControlManager\n * @dev Admin function to set address of AccessControlManager\n * @param accessControlManager_ The new address of the AccessControlManager\n * @custom:event Emits NewAccessControlManager event\n * @custom:access Only Governance\n */\n function setAccessControlManager(address accessControlManager_) external onlyOwner {\n _setAccessControlManager(accessControlManager_);\n }\n\n /**\n * @notice Returns the address of the access control manager contract\n */\n function accessControlManager() external view returns (IAccessControlManagerV8) {\n return _accessControlManager;\n }\n\n /**\n * @dev Internal function to set address of AccessControlManager\n * @param accessControlManager_ The new address of the AccessControlManager\n */\n function _setAccessControlManager(address accessControlManager_) internal {\n require(address(accessControlManager_) != address(0), \"invalid acess control manager address\");\n address oldAccessControlManager = address(_accessControlManager);\n _accessControlManager = IAccessControlManagerV8(accessControlManager_);\n emit NewAccessControlManager(oldAccessControlManager, accessControlManager_);\n }\n\n /**\n * @notice Reverts if the call is not allowed by AccessControlManager\n * @param signature Method signature\n */\n function _checkAccessAllowed(string memory signature) internal view {\n bool isAllowedToCall = _accessControlManager.isAllowedToCall(msg.sender, signature);\n\n if (!isAllowedToCall) {\n revert Unauthorized(msg.sender, address(this), signature);\n }\n }\n}\n" + }, + "@venusprotocol/governance-contracts/contracts/Governance/AccessControlManager.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\nimport \"@openzeppelin/contracts/access/AccessControl.sol\";\nimport \"./IAccessControlManagerV8.sol\";\n\n/**\n * @title AccessControlManager\n * @author Venus\n * @dev This contract is a wrapper of OpenZeppelin AccessControl extending it in a way to standartize access control within Venus Smart Contract Ecosystem.\n * @notice Access control plays a crucial role in the Venus governance model. It is used to restrict functions so that they can only be called from one\n * account or list of accounts (EOA or Contract Accounts).\n *\n * The implementation of `AccessControlManager`(https://github.com/VenusProtocol/governance-contracts/blob/main/contracts/Governance/AccessControlManager.sol)\n * inherits the [Open Zeppelin AccessControl](https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/access/AccessControl.sol)\n * contract as a base for role management logic. There are two role types: admin and granular permissions.\n * \n * ## Granular Roles\n * \n * Granular roles are built by hashing the contract address and its function signature. For example, given contract `Foo` with function `Foo.bar()` which\n * is guarded by ACM, calling `giveRolePermission` for account B do the following:\n * \n * 1. Compute `keccak256(contractFooAddress,functionSignatureBar)`\n * 1. Add the computed role to the roles of account B\n * 1. Account B now can call `ContractFoo.bar()`\n * \n * ## Admin Roles\n * \n * Admin roles allow for an address to call a function signature on any contract guarded by the `AccessControlManager`. This is particularly useful for\n * contracts created by factories.\n * \n * For Admin roles a null address is hashed in place of the contract address (`keccak256(0x0000000000000000000000000000000000000000,functionSignatureBar)`.\n * \n * In the previous example, giving account B the admin role, account B will have permissions to call the `bar()` function on any contract that is guarded by\n * ACM, not only contract A.\n * \n * ## Protocol Integration\n * \n * All restricted functions in Venus Protocol use a hook to ACM in order to check if the caller has the right permission to call the guarded function.\n * `AccessControlledV5` and `AccessControlledV8` abstract contract makes this integration easier. They call ACM's external method\n * `isAllowedToCall(address caller, string functionSig)`. Here is an example of how `setCollateralFactor` function in `Comptroller` is integrated with ACM:\n\n```\n contract Comptroller is [...] AccessControlledV8 {\n [...]\n function setCollateralFactor(VToken vToken, uint256 newCollateralFactorMantissa, uint256 newLiquidationThresholdMantissa) external {\n _checkAccessAllowed(\"setCollateralFactor(address,uint256,uint256)\");\n [...]\n }\n }\n```\n */\ncontract AccessControlManager is AccessControl, IAccessControlManagerV8 {\n /// @notice Emitted when an account is given a permission to a certain contract function\n /// @dev If contract address is 0x000..0 this means that the account is a default admin of this function and\n /// can call any contract function with this signature\n event PermissionGranted(address account, address contractAddress, string functionSig);\n\n /// @notice Emitted when an account is revoked a permission to a certain contract function\n event PermissionRevoked(address account, address contractAddress, string functionSig);\n\n constructor() {\n // Grant the contract deployer the default admin role: it will be able\n // to grant and revoke any roles\n _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);\n }\n\n /**\n * @notice Gives a function call permission to one single account\n * @dev this function can be called only from Role Admin or DEFAULT_ADMIN_ROLE\n * @param contractAddress address of contract for which call permissions will be granted\n * @dev if contractAddress is zero address, the account can access the specified function\n * on **any** contract managed by this ACL\n * @param functionSig signature e.g. \"functionName(uint256,bool)\"\n * @param accountToPermit account that will be given access to the contract function\n * @custom:event Emits a {RoleGranted} and {PermissionGranted} events.\n */\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) public {\n bytes32 role = keccak256(abi.encodePacked(contractAddress, functionSig));\n grantRole(role, accountToPermit);\n emit PermissionGranted(accountToPermit, contractAddress, functionSig);\n }\n\n /**\n * @notice Revokes an account's permission to a particular function call\n * @dev this function can be called only from Role Admin or DEFAULT_ADMIN_ROLE\n * \t\tMay emit a {RoleRevoked} event.\n * @param contractAddress address of contract for which call permissions will be revoked\n * @param functionSig signature e.g. \"functionName(uint256,bool)\"\n * @custom:event Emits {RoleRevoked} and {PermissionRevoked} events.\n */\n function revokeCallPermission(\n address contractAddress,\n string calldata functionSig,\n address accountToRevoke\n ) public {\n bytes32 role = keccak256(abi.encodePacked(contractAddress, functionSig));\n revokeRole(role, accountToRevoke);\n emit PermissionRevoked(accountToRevoke, contractAddress, functionSig);\n }\n\n /**\n * @notice Verifies if the given account can call a contract's guarded function\n * @dev Since restricted contracts using this function as a permission hook, we can get contracts address with msg.sender\n * @param account for which call permissions will be checked\n * @param functionSig restricted function signature e.g. \"functionName(uint256,bool)\"\n * @return false if the user account cannot call the particular contract function\n *\n */\n function isAllowedToCall(address account, string calldata functionSig) public view returns (bool) {\n bytes32 role = keccak256(abi.encodePacked(msg.sender, functionSig));\n\n if (hasRole(role, account)) {\n return true;\n } else {\n role = keccak256(abi.encodePacked(address(0), functionSig));\n return hasRole(role, account);\n }\n }\n\n /**\n * @notice Verifies if the given account can call a contract's guarded function\n * @dev This function is used as a view function to check permissions rather than contract hook for access restriction check.\n * @param account for which call permissions will be checked against\n * @param contractAddress address of the restricted contract\n * @param functionSig signature of the restricted function e.g. \"functionName(uint256,bool)\"\n * @return false if the user account cannot call the particular contract function\n */\n function hasPermission(\n address account,\n address contractAddress,\n string calldata functionSig\n ) public view returns (bool) {\n bytes32 role = keccak256(abi.encodePacked(contractAddress, functionSig));\n return hasRole(role, account);\n }\n}\n" + }, + "@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\nimport \"@openzeppelin/contracts/access/IAccessControl.sol\";\n\n/**\n * @title IAccessControlManagerV8\n * @author Venus\n * @notice Interface implemented by the `AccessControlManagerV8` contract.\n */\ninterface IAccessControlManagerV8 is IAccessControl {\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) external;\n\n function revokeCallPermission(\n address contractAddress,\n string calldata functionSig,\n address accountToRevoke\n ) external;\n\n function isAllowedToCall(address account, string calldata functionSig) external view returns (bool);\n\n function hasPermission(\n address account,\n address contractAddress,\n string calldata functionSig\n ) external view returns (bool);\n}\n" + }, + "@venusprotocol/solidity-utilities/contracts/constants.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\n/// @dev Base unit for computations, usually used in scaling (multiplications, divisions)\nuint256 constant EXP_SCALE = 1e18;\n\n/// @dev A unit (literal one) in EXP_SCALE, usually used in additions/subtractions\nuint256 constant MANTISSA_ONE = EXP_SCALE;\n\n/// @dev The approximate number of seconds per year\nuint256 constant SECONDS_PER_YEAR = 31_536_000;\n" + }, + "@venusprotocol/solidity-utilities/contracts/validators.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\nerror ZeroAddressNotAllowed();\n\n/// @notice Thrown if the supplied value is 0 where it is not allowed\nerror ZeroValueNotAllowed();\n\n/// @notice Checks if the provided address is nonzero, reverts otherwise\n/// @param address_ Address to check\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\nfunction ensureNonzeroAddress(address address_) pure {\n if (address_ == address(0)) {\n revert ZeroAddressNotAllowed();\n }\n}\n\n/// @notice Checks if the provided value is nonzero, reverts otherwise\n/// @param value_ Value to check\n/// @custom:error ZeroValueNotAllowed is thrown if the provided value is 0\nfunction ensureNonzeroValue(uint256 value_) pure {\n if (value_ == 0) {\n revert ZeroValueNotAllowed();\n }\n}\n" + }, + "contracts/interfaces/FeedRegistryInterface.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\ninterface FeedRegistryInterface {\n function latestRoundDataByName(\n string memory base,\n string memory quote\n )\n external\n view\n returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound);\n\n function decimalsByName(string memory base, string memory quote) external view returns (uint8);\n}\n" + }, + "contracts/interfaces/IAnkrBNB.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface IAnkrBNB {\n function sharesToBonds(uint256 amount) external view returns (uint256);\n function decimals() external view returns (uint8);\n}\n" + }, + "contracts/interfaces/IEtherFiLiquidityPool.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface IEtherFiLiquidityPool {\n function amountForShare(uint256 _share) external view returns (uint256);\n}\n" + }, + "contracts/interfaces/IPendlePtOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface IPendlePtOracle {\n function getPtToAssetRate(address market, uint32 duration) external view returns (uint256);\n function getOracleState(\n address market,\n uint32 duration\n )\n external\n view\n returns (bool increaseCardinalityRequired, uint16 cardinalityRequired, bool oldestObservationSatisfied);\n}\n" + }, + "contracts/interfaces/IPStakePool.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface IPStakePool {\n struct Data {\n uint256 totalWei;\n uint256 poolTokenSupply;\n }\n\n /**\n * @dev The current exchange rate for converting stkBNB to BNB.\n */\n function exchangeRate() external view returns (Data memory);\n}\n" + }, + "contracts/interfaces/ISFrax.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface ISFrax {\n function convertToAssets(uint256 shares) external view returns (uint256);\n function decimals() external view returns (uint8);\n}\n" + }, + "contracts/interfaces/ISfrxEthFraxOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface ISfrxEthFraxOracle {\n function getPrices() external view returns (bool _isbadData, uint256 _priceLow, uint256 _priceHigh);\n}\n" + }, + "contracts/interfaces/IStaderStakeManager.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface IStaderStakeManager {\n function convertBnbXToBnb(uint256 _amount) external view returns (uint256);\n}\n" + }, + "contracts/interfaces/IStETH.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\ninterface IStETH {\n function getPooledEthByShares(uint256 _sharesAmount) external view returns (uint256);\n function decimals() external view returns (uint8);\n}\n" + }, + "contracts/interfaces/ISynclubStakeManager.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface ISynclubStakeManager {\n function convertSnBnbToBnb(uint256 _amount) external view returns (uint256);\n}\n" + }, + "contracts/interfaces/IWBETH.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface IWBETH {\n function exchangeRate() external view returns (uint256);\n function decimals() external view returns (uint8);\n}\n" + }, + "contracts/interfaces/OracleInterface.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\ninterface OracleInterface {\n function getPrice(address asset) external view returns (uint256);\n}\n\ninterface ResilientOracleInterface is OracleInterface {\n function updatePrice(address vToken) external;\n\n function updateAssetPrice(address asset) external;\n\n function getUnderlyingPrice(address vToken) external view returns (uint256);\n}\n\ninterface TwapInterface is OracleInterface {\n function updateTwap(address asset) external returns (uint256);\n}\n\ninterface BoundValidatorInterface {\n function validatePriceWithAnchorPrice(\n address asset,\n uint256 reporterPrice,\n uint256 anchorPrice\n ) external view returns (bool);\n}\n" + }, + "contracts/interfaces/PublicResolverInterface.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\n// SPDX-FileCopyrightText: 2022 Venus\npragma solidity ^0.8.25;\n\ninterface PublicResolverInterface {\n function addr(bytes32 node) external view returns (address payable);\n}\n" + }, + "contracts/interfaces/PythInterface.sol": { + "content": "// SPDX-License-Identifier: Apache-2.0\n// SPDX-FileCopyrightText: 2021 Pyth Data Foundation\npragma solidity ^0.8.25;\n\ncontract PythStructs {\n // A price with a degree of uncertainty, represented as a price +- a confidence interval.\n //\n // The confidence interval roughly corresponds to the standard error of a normal distribution.\n // Both the price and confidence are stored in a fixed-point numeric representation,\n // `x * (10^expo)`, where `expo` is the exponent.\n //\n // Please refer to the documentation at https://docs.pyth.network/consumers/best-practices for how\n // to how this price safely.\n struct Price {\n // Price\n int64 price;\n // Confidence interval around the price\n uint64 conf;\n // Price exponent\n int32 expo;\n // Unix timestamp describing when the price was published\n uint256 publishTime;\n }\n\n // PriceFeed represents a current aggregate price from pyth publisher feeds.\n struct PriceFeed {\n // The price ID.\n bytes32 id;\n // Latest available price\n Price price;\n // Latest available exponentially-weighted moving average price\n Price emaPrice;\n }\n}\n\n/// @title Consume prices from the Pyth Network (https://pyth.network/).\n/// @dev Please refer to the guidance at https://docs.pyth.network/consumers/best-practices\n/// for how to consume prices safely.\n/// @author Pyth Data Association\ninterface IPyth {\n /// @dev Emitted when an update for price feed with `id` is processed successfully.\n /// @param id The Pyth Price Feed ID.\n /// @param fresh True if the price update is more recent and stored.\n /// @param chainId ID of the source chain that the batch price update containing this price.\n /// This value comes from Wormhole, and you can find the corresponding chains\n /// at https://docs.wormholenetwork.com/wormhole/contracts.\n /// @param sequenceNumber Sequence number of the batch price update containing this price.\n /// @param lastPublishTime Publish time of the previously stored price.\n /// @param publishTime Publish time of the given price update.\n /// @param price Price of the given price update.\n /// @param conf Confidence interval of the given price update.\n event PriceFeedUpdate(\n bytes32 indexed id,\n bool indexed fresh,\n uint16 chainId,\n uint64 sequenceNumber,\n uint256 lastPublishTime,\n uint256 publishTime,\n int64 price,\n uint64 conf\n );\n\n /// @dev Emitted when a batch price update is processed successfully.\n /// @param chainId ID of the source chain that the batch price update comes from.\n /// @param sequenceNumber Sequence number of the batch price update.\n /// @param batchSize Number of prices within the batch price update.\n /// @param freshPricesInBatch Number of prices that were more recent and were stored.\n event BatchPriceFeedUpdate(uint16 chainId, uint64 sequenceNumber, uint256 batchSize, uint256 freshPricesInBatch);\n\n /// @dev Emitted when a call to `updatePriceFeeds` is processed successfully.\n /// @param sender Sender of the call (`msg.sender`).\n /// @param batchCount Number of batches that this function processed.\n /// @param fee Amount of paid fee for updating the prices.\n event UpdatePriceFeeds(address indexed sender, uint256 batchCount, uint256 fee);\n\n /// @notice Returns the period (in seconds) that a price feed is considered valid since its publish time\n function getValidTimePeriod() external view returns (uint256 validTimePeriod);\n\n /// @notice Returns the price and confidence interval.\n /// @dev Reverts if the price has not been updated within the last `getValidTimePeriod()` seconds.\n /// @param id The Pyth Price Feed ID of which to fetch the price and confidence interval.\n /// @return price - please read the documentation of PythStructs.Price to understand how to use this safely.\n function getPrice(bytes32 id) external view returns (PythStructs.Price memory price);\n\n /// @notice Returns the exponentially-weighted moving average price and confidence interval.\n /// @dev Reverts if the EMA price is not available.\n /// @param id The Pyth Price Feed ID of which to fetch the EMA price and confidence interval.\n /// @return price - please read the documentation of PythStructs.Price to understand how to use this safely.\n function getEmaPrice(bytes32 id) external view returns (PythStructs.Price memory price);\n\n /// @notice Returns the price of a price feed without any sanity checks.\n /// @dev This function returns the most recent price update in this contract without any recency checks.\n /// This function is unsafe as the returned price update may be arbitrarily far in the past.\n ///\n /// Users of this function should check the `publishTime` in the price to ensure that the returned price is\n /// sufficiently recent for their application. If you are considering using this function, it may be\n /// safer / easier to use either `getPrice` or `getPriceNoOlderThan`.\n /// @return price - please read the documentation of PythStructs.Price to understand how to use this safely.\n function getPriceUnsafe(bytes32 id) external view returns (PythStructs.Price memory price);\n\n /// @notice Returns the price that is no older than `age` seconds of the current time.\n /// @dev This function is a sanity-checked version of `getPriceUnsafe` which is useful in\n /// applications that require a sufficiently-recent price. Reverts if the price wasn't updated sufficiently\n /// recently.\n /// @return price - please read the documentation of PythStructs.Price to understand how to use this safely.\n function getPriceNoOlderThan(bytes32 id, uint256 age) external view returns (PythStructs.Price memory price);\n\n /// @notice Returns the exponentially-weighted moving average price of a price feed without any sanity checks.\n /// @dev This function returns the same price as `getEmaPrice` in the case where the price is available.\n /// However, if the price is not recent this function returns the latest available price.\n ///\n /// The returned price can be from arbitrarily far in the past; this function makes no guarantees that\n /// the returned price is recent or useful for any particular application.\n ///\n /// Users of this function should check the `publishTime` in the price to ensure that the returned price is\n /// sufficiently recent for their application. If you are considering using this function, it may be\n /// safer / easier to use either `getEmaPrice` or `getEmaPriceNoOlderThan`.\n /// @return price - please read the documentation of PythStructs.Price to understand how to use this safely.\n function getEmaPriceUnsafe(bytes32 id) external view returns (PythStructs.Price memory price);\n\n /// @notice Returns the exponentially-weighted moving average price that is no older than `age` seconds\n /// of the current time.\n /// @dev This function is a sanity-checked version of `getEmaPriceUnsafe` which is useful in\n /// applications that require a sufficiently-recent price. Reverts if the price wasn't updated sufficiently\n /// recently.\n /// @return price - please read the documentation of PythStructs.Price to understand how to use this safely.\n function getEmaPriceNoOlderThan(bytes32 id, uint256 age) external view returns (PythStructs.Price memory price);\n\n /// @notice Update price feeds with given update messages.\n /// This method requires the caller to pay a fee in wei; the required fee can be computed by calling\n /// `getUpdateFee` with the length of the `updateData` array.\n /// Prices will be updated if they are more recent than the current stored prices.\n /// The call will succeed even if the update is not the most recent.\n /// @dev Reverts if the transferred fee is not sufficient or the updateData is invalid.\n /// @param updateData Array of price update data.\n function updatePriceFeeds(bytes[] calldata updateData) external payable;\n\n /// @notice Wrapper around updatePriceFeeds that rejects fast if a price update is not necessary. A price update is\n /// necessary if the current on-chain publishTime is older than the given publishTime. It relies solely on the\n /// given `publishTimes` for the price feeds and does not read the actual price\n /// update publish time within `updateData`.\n ///\n /// This method requires the caller to pay a fee in wei; the required fee can be computed by calling\n /// `getUpdateFee` with the length of the `updateData` array.\n ///\n /// `priceIds` and `publishTimes` are two arrays with the same size that correspond to senders known publishTime\n /// of each priceId when calling this method. If all of price feeds within `priceIds` have updated and have\n /// a newer or equal publish time than the given publish time, it will reject the transaction to save gas.\n /// Otherwise, it calls updatePriceFeeds method to update the prices.\n ///\n /// @dev Reverts if update is not needed or the transferred fee is not sufficient or the updateData is invalid.\n /// @param updateData Array of price update data.\n /// @param priceIds Array of price ids.\n /// @param publishTimes Array of publishTimes. `publishTimes[i]` corresponds to known `publishTime` of `priceIds[i]`\n function updatePriceFeedsIfNecessary(\n bytes[] calldata updateData,\n bytes32[] calldata priceIds,\n uint64[] calldata publishTimes\n ) external payable;\n\n /// @notice Returns the required fee to update an array of price updates.\n /// @param updateDataSize Number of price updates.\n /// @return feeAmount The required fee in Wei.\n function getUpdateFee(uint256 updateDataSize) external view returns (uint256 feeAmount);\n}\n\nabstract contract AbstractPyth is IPyth {\n /// @notice Returns the price feed with given id.\n /// @dev Reverts if the price does not exist.\n /// @param id The Pyth Price Feed ID of which to fetch the PriceFeed.\n function queryPriceFeed(bytes32 id) public view virtual returns (PythStructs.PriceFeed memory priceFeed);\n\n /// @notice Returns true if a price feed with the given id exists.\n /// @param id The Pyth Price Feed ID of which to check its existence.\n function priceFeedExists(bytes32 id) public view virtual returns (bool exists);\n\n function getValidTimePeriod() public view virtual override returns (uint256 validTimePeriod);\n\n function getPrice(bytes32 id) external view override returns (PythStructs.Price memory price) {\n return getPriceNoOlderThan(id, getValidTimePeriod());\n }\n\n function getEmaPrice(bytes32 id) external view override returns (PythStructs.Price memory price) {\n return getEmaPriceNoOlderThan(id, getValidTimePeriod());\n }\n\n function getPriceUnsafe(bytes32 id) public view override returns (PythStructs.Price memory price) {\n PythStructs.PriceFeed memory priceFeed = queryPriceFeed(id);\n return priceFeed.price;\n }\n\n function getPriceNoOlderThan(\n bytes32 id,\n uint256 age\n ) public view override returns (PythStructs.Price memory price) {\n price = getPriceUnsafe(id);\n\n require(diff(block.timestamp, price.publishTime) <= age, \"no price available which is recent enough\");\n\n return price;\n }\n\n function getEmaPriceUnsafe(bytes32 id) public view override returns (PythStructs.Price memory price) {\n PythStructs.PriceFeed memory priceFeed = queryPriceFeed(id);\n return priceFeed.emaPrice;\n }\n\n function getEmaPriceNoOlderThan(\n bytes32 id,\n uint256 age\n ) public view override returns (PythStructs.Price memory price) {\n price = getEmaPriceUnsafe(id);\n\n require(diff(block.timestamp, price.publishTime) <= age, \"no ema price available which is recent enough\");\n\n return price;\n }\n\n function diff(uint256 x, uint256 y) internal pure returns (uint256) {\n if (x > y) {\n return x - y;\n } else {\n return y - x;\n }\n }\n\n // Access modifier is overridden to public to be able to call it locally.\n function updatePriceFeeds(bytes[] calldata updateData) public payable virtual override;\n\n function updatePriceFeedsIfNecessary(\n bytes[] calldata updateData,\n bytes32[] calldata priceIds,\n uint64[] calldata publishTimes\n ) external payable override {\n require(priceIds.length == publishTimes.length, \"priceIds and publishTimes arrays should have same length\");\n\n bool updateNeeded = false;\n for (uint256 i = 0; i < priceIds.length; ) {\n if (!priceFeedExists(priceIds[i]) || queryPriceFeed(priceIds[i]).price.publishTime < publishTimes[i]) {\n updateNeeded = true;\n break;\n }\n unchecked {\n i++;\n }\n }\n\n require(updateNeeded, \"no prices in the submitted batch have fresh prices, so this update will have no effect\");\n\n updatePriceFeeds(updateData);\n }\n}\n" + }, + "contracts/interfaces/SIDRegistryInterface.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\n// SPDX-FileCopyrightText: 2022 Venus\npragma solidity ^0.8.25;\n\ninterface SIDRegistryInterface {\n function resolver(bytes32 node) external view returns (address);\n}\n" + }, + "contracts/interfaces/VBep20Interface.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\nimport \"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\";\n\ninterface VBep20Interface is IERC20Metadata {\n /**\n * @notice Underlying asset for this VToken\n */\n function underlying() external view returns (address);\n}\n" + }, + "contracts/oracles/AnkrBNBOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { IAnkrBNB } from \"../interfaces/IAnkrBNB.sol\";\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\n\n/**\n * @title AnkrBNBOracle\n * @author Venus\n * @notice This oracle fetches the price of ankrBNB asset\n */\ncontract AnkrBNBOracle is CorrelatedTokenOracle {\n /// @notice This is used as token address of BNB on BSC\n address public constant NATIVE_TOKEN_ADDR = 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB;\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address ankrBNB,\n address resilientOracle\n ) CorrelatedTokenOracle(ankrBNB, NATIVE_TOKEN_ADDR, resilientOracle) {}\n\n /**\n * @notice Fetches the amount of BNB for 1 ankrBNB\n * @return amount The amount of BNB for ankrBNB\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n return IAnkrBNB(CORRELATED_TOKEN).sharesToBonds(EXP_SCALE);\n }\n}\n" + }, + "contracts/oracles/BinanceOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\";\nimport \"../interfaces/VBep20Interface.sol\";\nimport \"../interfaces/SIDRegistryInterface.sol\";\nimport \"../interfaces/FeedRegistryInterface.sol\";\nimport \"../interfaces/PublicResolverInterface.sol\";\nimport \"../interfaces/OracleInterface.sol\";\nimport \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\";\nimport \"../interfaces/OracleInterface.sol\";\n\n/**\n * @title BinanceOracle\n * @author Venus\n * @notice This oracle fetches price of assets from Binance.\n */\ncontract BinanceOracle is AccessControlledV8, OracleInterface {\n /// @notice Used to fetch feed registry address.\n address public sidRegistryAddress;\n\n /// @notice Set this as asset address for BNB. This is the underlying address for vBNB\n address public constant BNB_ADDR = 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB;\n\n /// @notice Max stale period configuration for assets\n mapping(string => uint256) public maxStalePeriod;\n\n /// @notice Override symbols to be compatible with Binance feed registry\n mapping(string => string) public symbols;\n\n /// @notice Used to fetch price of assets used directly when space ID is not supported by current chain.\n address public feedRegistryAddress;\n\n /// @notice Emits when asset stale period is updated.\n event MaxStalePeriodAdded(string indexed asset, uint256 maxStalePeriod);\n\n /// @notice Emits when symbol of the asset is updated.\n event SymbolOverridden(string indexed symbol, string overriddenSymbol);\n\n /// @notice Emits when address of feed registry is updated.\n event FeedRegistryUpdated(address indexed oldFeedRegistry, address indexed newFeedRegistry);\n\n /**\n * @notice Checks whether an address is null or not\n */\n modifier notNullAddress(address someone) {\n if (someone == address(0)) revert(\"can't be zero address\");\n _;\n }\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor() {\n _disableInitializers();\n }\n\n /**\n * @notice Sets the contracts required to fetch prices\n * @param _sidRegistryAddress Address of SID registry\n * @param _accessControlManager Address of the access control manager contract\n */\n function initialize(address _sidRegistryAddress, address _accessControlManager) external initializer {\n sidRegistryAddress = _sidRegistryAddress;\n __AccessControlled_init(_accessControlManager);\n }\n\n /**\n * @notice Used to set the max stale period of an asset\n * @param symbol The symbol of the asset\n * @param _maxStalePeriod The max stake period\n */\n function setMaxStalePeriod(string memory symbol, uint256 _maxStalePeriod) external {\n _checkAccessAllowed(\"setMaxStalePeriod(string,uint256)\");\n if (_maxStalePeriod == 0) revert(\"stale period can't be zero\");\n if (bytes(symbol).length == 0) revert(\"symbol cannot be empty\");\n\n maxStalePeriod[symbol] = _maxStalePeriod;\n emit MaxStalePeriodAdded(symbol, _maxStalePeriod);\n }\n\n /**\n * @notice Used to override a symbol when fetching price\n * @param symbol The symbol to override\n * @param overrideSymbol The symbol after override\n */\n function setSymbolOverride(string calldata symbol, string calldata overrideSymbol) external {\n _checkAccessAllowed(\"setSymbolOverride(string,string)\");\n if (bytes(symbol).length == 0) revert(\"symbol cannot be empty\");\n\n symbols[symbol] = overrideSymbol;\n emit SymbolOverridden(symbol, overrideSymbol);\n }\n\n /**\n * @notice Used to set feed registry address when current chain does not support space ID.\n * @param newfeedRegistryAddress Address of new feed registry.\n */\n function setFeedRegistryAddress(\n address newfeedRegistryAddress\n ) external notNullAddress(newfeedRegistryAddress) onlyOwner {\n if (sidRegistryAddress != address(0)) revert(\"sidRegistryAddress must be zero\");\n emit FeedRegistryUpdated(feedRegistryAddress, newfeedRegistryAddress);\n feedRegistryAddress = newfeedRegistryAddress;\n }\n\n /**\n * @notice Uses Space ID to fetch the feed registry address\n * @return feedRegistryAddress Address of binance oracle feed registry.\n */\n function getFeedRegistryAddress() public view returns (address) {\n bytes32 nodeHash = 0x94fe3821e0768eb35012484db4df61890f9a6ca5bfa984ef8ff717e73139faff;\n\n SIDRegistryInterface sidRegistry = SIDRegistryInterface(sidRegistryAddress);\n address publicResolverAddress = sidRegistry.resolver(nodeHash);\n PublicResolverInterface publicResolver = PublicResolverInterface(publicResolverAddress);\n\n return publicResolver.addr(nodeHash);\n }\n\n /**\n * @notice Gets the price of a asset from the binance oracle\n * @param asset Address of the asset\n * @return Price in USD\n */\n function getPrice(address asset) public view returns (uint256) {\n string memory symbol;\n uint256 decimals;\n\n if (asset == BNB_ADDR) {\n symbol = \"BNB\";\n decimals = 18;\n } else {\n IERC20Metadata token = IERC20Metadata(asset);\n symbol = token.symbol();\n decimals = token.decimals();\n }\n\n string memory overrideSymbol = symbols[symbol];\n\n if (bytes(overrideSymbol).length != 0) {\n symbol = overrideSymbol;\n }\n\n return _getPrice(symbol, decimals);\n }\n\n function _getPrice(string memory symbol, uint256 decimals) internal view returns (uint256) {\n FeedRegistryInterface feedRegistry;\n\n if (sidRegistryAddress != address(0)) {\n // If sidRegistryAddress is available, fetch feedRegistryAddress from sidRegistry\n feedRegistry = FeedRegistryInterface(getFeedRegistryAddress());\n } else {\n // Use feedRegistry directly if sidRegistryAddress is not available\n feedRegistry = FeedRegistryInterface(feedRegistryAddress);\n }\n\n (, int256 answer, , uint256 updatedAt, ) = feedRegistry.latestRoundDataByName(symbol, \"USD\");\n if (answer <= 0) revert(\"invalid binance oracle price\");\n if (block.timestamp < updatedAt) revert(\"updatedAt exceeds block time\");\n\n uint256 deltaTime;\n unchecked {\n deltaTime = block.timestamp - updatedAt;\n }\n if (deltaTime > maxStalePeriod[symbol]) revert(\"binance oracle price expired\");\n\n uint256 decimalDelta = feedRegistry.decimalsByName(symbol, \"USD\");\n return (uint256(answer) * (10 ** (18 - decimalDelta))) * (10 ** (18 - decimals));\n }\n}\n" + }, + "contracts/oracles/BNBxOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { IStaderStakeManager } from \"../interfaces/IStaderStakeManager.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\n\n/**\n * @title BNBxOracle\n * @author Venus\n * @notice This oracle fetches the price of BNBx asset\n */\ncontract BNBxOracle is CorrelatedTokenOracle {\n /// @notice This is used as token address of BNB on BSC\n address public constant NATIVE_TOKEN_ADDR = 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB;\n\n /// @notice Address of StakeManager\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IStaderStakeManager public immutable STAKE_MANAGER;\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address stakeManager,\n address bnbx,\n address resilientOracle\n ) CorrelatedTokenOracle(bnbx, NATIVE_TOKEN_ADDR, resilientOracle) {\n ensureNonzeroAddress(stakeManager);\n STAKE_MANAGER = IStaderStakeManager(stakeManager);\n }\n\n /**\n * @notice Fetches the amount of BNB for 1 BNBx\n * @return price The amount of BNB for BNBx\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n return STAKE_MANAGER.convertBnbXToBnb(EXP_SCALE);\n }\n}\n" + }, + "contracts/oracles/BoundValidator.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"../interfaces/VBep20Interface.sol\";\nimport \"../interfaces/OracleInterface.sol\";\nimport \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\";\n\n/**\n * @title BoundValidator\n * @author Venus\n * @notice The BoundValidator contract is used to validate prices fetched from two different sources.\n * Each asset has an upper and lower bound ratio set in the config. In order for a price to be valid\n * it must fall within this range of the validator price.\n */\ncontract BoundValidator is AccessControlledV8, BoundValidatorInterface {\n struct ValidateConfig {\n /// @notice asset address\n address asset;\n /// @notice Upper bound of deviation between reported price and anchor price,\n /// beyond which the reported price will be invalidated\n uint256 upperBoundRatio;\n /// @notice Lower bound of deviation between reported price and anchor price,\n /// below which the reported price will be invalidated\n uint256 lowerBoundRatio;\n }\n\n /// @notice validation configs by asset\n mapping(address => ValidateConfig) public validateConfigs;\n\n /// @notice Emit this event when new validation configs are added\n event ValidateConfigAdded(address indexed asset, uint256 indexed upperBound, uint256 indexed lowerBound);\n\n /// @notice Constructor for the implementation contract. Sets immutable variables.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor() {\n _disableInitializers();\n }\n\n /**\n * @notice Initializes the owner of the contract\n * @param accessControlManager_ Address of the access control manager contract\n */\n function initialize(address accessControlManager_) external initializer {\n __AccessControlled_init(accessControlManager_);\n }\n\n /**\n * @notice Add multiple validation configs at the same time\n * @param configs Array of validation configs\n * @custom:access Only Governance\n * @custom:error Zero length error is thrown if length of the config array is 0\n * @custom:event Emits ValidateConfigAdded for each validation config that is successfully set\n */\n function setValidateConfigs(ValidateConfig[] memory configs) external {\n uint256 length = configs.length;\n if (length == 0) revert(\"invalid validate config length\");\n for (uint256 i; i < length; ) {\n setValidateConfig(configs[i]);\n unchecked {\n ++i;\n }\n }\n }\n\n /**\n * @notice Add a single validation config\n * @param config Validation config struct\n * @custom:access Only Governance\n * @custom:error Null address error is thrown if asset address is null\n * @custom:error Range error thrown if bound ratio is not positive\n * @custom:error Range error thrown if lower bound is greater than or equal to upper bound\n * @custom:event Emits ValidateConfigAdded when a validation config is successfully set\n */\n function setValidateConfig(ValidateConfig memory config) public {\n _checkAccessAllowed(\"setValidateConfig(ValidateConfig)\");\n\n if (config.asset == address(0)) revert(\"asset can't be zero address\");\n if (config.upperBoundRatio == 0 || config.lowerBoundRatio == 0) revert(\"bound must be positive\");\n if (config.upperBoundRatio <= config.lowerBoundRatio) revert(\"upper bound must be higher than lowner bound\");\n validateConfigs[config.asset] = config;\n emit ValidateConfigAdded(config.asset, config.upperBoundRatio, config.lowerBoundRatio);\n }\n\n /**\n * @notice Test reported asset price against anchor price\n * @param asset asset address\n * @param reportedPrice The price to be tested\n * @custom:error Missing error thrown if asset config is not set\n * @custom:error Price error thrown if anchor price is not valid\n */\n function validatePriceWithAnchorPrice(\n address asset,\n uint256 reportedPrice,\n uint256 anchorPrice\n ) public view virtual override returns (bool) {\n if (validateConfigs[asset].upperBoundRatio == 0) revert(\"validation config not exist\");\n if (anchorPrice == 0) revert(\"anchor price is not valid\");\n return _isWithinAnchor(asset, reportedPrice, anchorPrice);\n }\n\n /**\n * @notice Test whether the reported price is within the valid bounds\n * @param asset Asset address\n * @param reportedPrice The price to be tested\n * @param anchorPrice The reported price must be within the the valid bounds of this price\n */\n function _isWithinAnchor(address asset, uint256 reportedPrice, uint256 anchorPrice) private view returns (bool) {\n if (reportedPrice != 0) {\n // we need to multiply anchorPrice by 1e18 to make the ratio 18 decimals\n uint256 anchorRatio = (anchorPrice * 1e18) / reportedPrice;\n uint256 upperBoundAnchorRatio = validateConfigs[asset].upperBoundRatio;\n uint256 lowerBoundAnchorRatio = validateConfigs[asset].lowerBoundRatio;\n return anchorRatio <= upperBoundAnchorRatio && anchorRatio >= lowerBoundAnchorRatio;\n }\n return false;\n }\n\n // BoundValidator is to get inherited, so it's a good practice to add some storage gaps like\n // OpenZepplin proposed in their contracts: https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n // solhint-disable-next-line\n uint256[49] private __gap;\n}\n" + }, + "contracts/oracles/ChainlinkOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"../interfaces/VBep20Interface.sol\";\nimport \"../interfaces/OracleInterface.sol\";\nimport \"@chainlink/contracts/src/v0.8/interfaces/AggregatorV3Interface.sol\";\nimport \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\";\n\n/**\n * @title ChainlinkOracle\n * @author Venus\n * @notice This oracle fetches prices of assets from the Chainlink oracle.\n */\ncontract ChainlinkOracle is AccessControlledV8, OracleInterface {\n struct TokenConfig {\n /// @notice Underlying token address, which can't be a null address\n /// @notice Used to check if a token is supported\n /// @notice 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB address for native tokens\n /// (e.g BNB for BNB chain, ETH for Ethereum network)\n address asset;\n /// @notice Chainlink feed address\n address feed;\n /// @notice Price expiration period of this asset\n uint256 maxStalePeriod;\n }\n\n /// @notice Set this as asset address for native token on each chain.\n /// This is the underlying address for vBNB on BNB chain or an underlying asset for a native market on any chain.\n address public constant NATIVE_TOKEN_ADDR = 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB;\n\n /// @notice Manually set an override price, useful under extenuating conditions such as price feed failure\n mapping(address => uint256) public prices;\n\n /// @notice Token config by assets\n mapping(address => TokenConfig) public tokenConfigs;\n\n /// @notice Emit when a price is manually set\n event PricePosted(address indexed asset, uint256 previousPriceMantissa, uint256 newPriceMantissa);\n\n /// @notice Emit when a token config is added\n event TokenConfigAdded(address indexed asset, address feed, uint256 maxStalePeriod);\n\n modifier notNullAddress(address someone) {\n if (someone == address(0)) revert(\"can't be zero address\");\n _;\n }\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor() {\n _disableInitializers();\n }\n\n /**\n * @notice Initializes the owner of the contract\n * @param accessControlManager_ Address of the access control manager contract\n */\n function initialize(address accessControlManager_) external initializer {\n __AccessControlled_init(accessControlManager_);\n }\n\n /**\n * @notice Manually set the price of a given asset\n * @param asset Asset address\n * @param price Asset price in 18 decimals\n * @custom:access Only Governance\n * @custom:event Emits PricePosted event on succesfully setup of asset price\n */\n function setDirectPrice(address asset, uint256 price) external notNullAddress(asset) {\n _checkAccessAllowed(\"setDirectPrice(address,uint256)\");\n\n uint256 previousPriceMantissa = prices[asset];\n prices[asset] = price;\n emit PricePosted(asset, previousPriceMantissa, price);\n }\n\n /**\n * @notice Add multiple token configs at the same time\n * @param tokenConfigs_ config array\n * @custom:access Only Governance\n * @custom:error Zero length error thrown, if length of the array in parameter is 0\n */\n function setTokenConfigs(TokenConfig[] memory tokenConfigs_) external {\n if (tokenConfigs_.length == 0) revert(\"length can't be 0\");\n uint256 numTokenConfigs = tokenConfigs_.length;\n for (uint256 i; i < numTokenConfigs; ) {\n setTokenConfig(tokenConfigs_[i]);\n unchecked {\n ++i;\n }\n }\n }\n\n /**\n * @notice Add single token config. asset & feed cannot be null addresses and maxStalePeriod must be positive\n * @param tokenConfig Token config struct\n * @custom:access Only Governance\n * @custom:error NotNullAddress error is thrown if asset address is null\n * @custom:error NotNullAddress error is thrown if token feed address is null\n * @custom:error Range error is thrown if maxStale period of token is not greater than zero\n * @custom:event Emits TokenConfigAdded event on succesfully setting of the token config\n */\n function setTokenConfig(\n TokenConfig memory tokenConfig\n ) public notNullAddress(tokenConfig.asset) notNullAddress(tokenConfig.feed) {\n _checkAccessAllowed(\"setTokenConfig(TokenConfig)\");\n\n if (tokenConfig.maxStalePeriod == 0) revert(\"stale period can't be zero\");\n tokenConfigs[tokenConfig.asset] = tokenConfig;\n emit TokenConfigAdded(tokenConfig.asset, tokenConfig.feed, tokenConfig.maxStalePeriod);\n }\n\n /**\n * @notice Gets the price of a asset from the chainlink oracle\n * @param asset Address of the asset\n * @return Price in USD from Chainlink or a manually set price for the asset\n */\n function getPrice(address asset) public view virtual returns (uint256) {\n uint256 decimals;\n\n if (asset == NATIVE_TOKEN_ADDR) {\n decimals = 18;\n } else {\n IERC20Metadata token = IERC20Metadata(asset);\n decimals = token.decimals();\n }\n\n return _getPriceInternal(asset, decimals);\n }\n\n /**\n * @notice Gets the Chainlink price for a given asset\n * @param asset address of the asset\n * @param decimals decimals of the asset\n * @return price Asset price in USD or a manually set price of the asset\n */\n function _getPriceInternal(address asset, uint256 decimals) internal view returns (uint256 price) {\n uint256 tokenPrice = prices[asset];\n if (tokenPrice != 0) {\n price = tokenPrice;\n } else {\n price = _getChainlinkPrice(asset);\n }\n\n uint256 decimalDelta = 18 - decimals;\n return price * (10 ** decimalDelta);\n }\n\n /**\n * @notice Get the Chainlink price for an asset, revert if token config doesn't exist\n * @dev The precision of the price feed is used to ensure the returned price has 18 decimals of precision\n * @param asset Address of the asset\n * @return price Price in USD, with 18 decimals of precision\n * @custom:error NotNullAddress error is thrown if the asset address is null\n * @custom:error Price error is thrown if the Chainlink price of asset is not greater than zero\n * @custom:error Timing error is thrown if current timestamp is less than the last updatedAt timestamp\n * @custom:error Timing error is thrown if time difference between current time and last updated time\n * is greater than maxStalePeriod\n */\n function _getChainlinkPrice(\n address asset\n ) private view notNullAddress(tokenConfigs[asset].asset) returns (uint256) {\n TokenConfig memory tokenConfig = tokenConfigs[asset];\n AggregatorV3Interface feed = AggregatorV3Interface(tokenConfig.feed);\n\n // note: maxStalePeriod cannot be 0\n uint256 maxStalePeriod = tokenConfig.maxStalePeriod;\n\n // Chainlink USD-denominated feeds store answers at 8 decimals, mostly\n uint256 decimalDelta = 18 - feed.decimals();\n\n (, int256 answer, , uint256 updatedAt, ) = feed.latestRoundData();\n if (answer <= 0) revert(\"chainlink price must be positive\");\n if (block.timestamp < updatedAt) revert(\"updatedAt exceeds block time\");\n\n uint256 deltaTime;\n unchecked {\n deltaTime = block.timestamp - updatedAt;\n }\n\n if (deltaTime > maxStalePeriod) revert(\"chainlink price expired\");\n\n return uint256(answer) * (10 ** decimalDelta);\n }\n}\n" + }, + "contracts/oracles/common/CorrelatedTokenOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { OracleInterface } from \"../../interfaces/OracleInterface.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { IERC20Metadata } from \"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\";\n\n/**\n * @title CorrelatedTokenOracle\n * @notice This oracle fetches the price of a token that is correlated to another token.\n */\nabstract contract CorrelatedTokenOracle is OracleInterface {\n /// @notice Address of the correlated token\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n address public immutable CORRELATED_TOKEN;\n\n /// @notice Address of the underlying token\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n address public immutable UNDERLYING_TOKEN;\n\n /// @notice Address of Resilient Oracle\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n OracleInterface public immutable RESILIENT_ORACLE;\n\n /// @notice Thrown if the token address is invalid\n error InvalidTokenAddress();\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(address correlatedToken, address underlyingToken, address resilientOracle) {\n ensureNonzeroAddress(correlatedToken);\n ensureNonzeroAddress(underlyingToken);\n ensureNonzeroAddress(resilientOracle);\n CORRELATED_TOKEN = correlatedToken;\n UNDERLYING_TOKEN = underlyingToken;\n RESILIENT_ORACLE = OracleInterface(resilientOracle);\n }\n\n /**\n * @notice Fetches the price of the correlated token\n * @param asset Address of the correlated token\n * @return price The price of the correlated token in scaled decimal places\n */\n function getPrice(address asset) external view override returns (uint256) {\n if (asset != CORRELATED_TOKEN) revert InvalidTokenAddress();\n\n // get underlying token amount for 1 correlated token scaled by underlying token decimals\n uint256 underlyingAmount = _getUnderlyingAmount();\n\n // oracle returns (36 - asset decimal) scaled price\n uint256 underlyingUSDPrice = RESILIENT_ORACLE.getPrice(UNDERLYING_TOKEN);\n\n IERC20Metadata token = IERC20Metadata(CORRELATED_TOKEN);\n uint256 decimals = token.decimals();\n\n // underlyingAmount (for 1 correlated token) * underlyingUSDPrice / decimals(correlated token)\n return (underlyingAmount * underlyingUSDPrice) / (10 ** decimals);\n }\n\n /**\n * @notice Gets the underlying amount for correlated token\n * @return underlyingAmount Amount of underlying token\n */\n function _getUnderlyingAmount() internal view virtual returns (uint256);\n}\n" + }, + "contracts/oracles/mocks/MockBinanceFeedRegistry.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"../../interfaces/FeedRegistryInterface.sol\";\n\ncontract MockBinanceFeedRegistry is FeedRegistryInterface {\n mapping(string => uint256) public assetPrices;\n\n function setAssetPrice(string memory base, uint256 price) external {\n assetPrices[base] = price;\n }\n\n function latestRoundDataByName(\n string memory base,\n string memory quote\n )\n external\n view\n override\n returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)\n {\n quote;\n return (0, int256(assetPrices[base]), 0, block.timestamp - 10, 0);\n }\n\n function decimalsByName(string memory base, string memory quote) external view override returns (uint8) {\n return 8;\n }\n}\n" + }, + "contracts/oracles/mocks/MockBinanceOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { OwnableUpgradeable } from \"@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol\";\nimport { OracleInterface } from \"../../interfaces/OracleInterface.sol\";\n\ncontract MockBinanceOracle is OwnableUpgradeable, OracleInterface {\n mapping(address => uint256) public assetPrices;\n\n constructor() {}\n\n function initialize() public initializer {}\n\n function setPrice(address asset, uint256 price) external {\n assetPrices[asset] = price;\n }\n\n function getPrice(address token) public view returns (uint256) {\n return assetPrices[token];\n }\n}\n" + }, + "contracts/oracles/mocks/MockChainlinkOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { OwnableUpgradeable } from \"@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol\";\nimport { OracleInterface } from \"../../interfaces/OracleInterface.sol\";\n\ncontract MockChainlinkOracle is OwnableUpgradeable, OracleInterface {\n mapping(address => uint256) public assetPrices;\n\n //set price in 6 decimal precision\n constructor() {}\n\n function initialize() public initializer {\n __Ownable_init();\n }\n\n function setPrice(address asset, uint256 price) external {\n assetPrices[asset] = price;\n }\n\n //https://compound.finance/docs/prices\n function getPrice(address token) public view returns (uint256) {\n return assetPrices[token];\n }\n}\n" + }, + "contracts/oracles/mocks/MockPendlePtOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"../../interfaces/IPendlePtOracle.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\n\ncontract MockPendlePtOracle is IPendlePtOracle, Ownable {\n mapping(address => mapping(uint32 => uint256)) public ptToAssetRate;\n\n constructor() Ownable() {}\n\n function setPtToAssetRate(address market, uint32 duration, uint256 rate) external onlyOwner {\n ptToAssetRate[market][duration] = rate;\n }\n\n function getPtToAssetRate(address market, uint32 duration) external view returns (uint256) {\n return ptToAssetRate[market][duration];\n }\n\n function getOracleState(\n address market,\n uint32 duration\n )\n external\n view\n returns (bool increaseCardinalityRequired, uint16 cardinalityRequired, bool oldestObservationSatisfied)\n {\n return (false, 0, true);\n }\n}\n" + }, + "contracts/oracles/mocks/MockPythOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { OwnableUpgradeable } from \"@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol\";\nimport { IPyth } from \"../PythOracle.sol\";\nimport { OracleInterface } from \"../../interfaces/OracleInterface.sol\";\n\ncontract MockPythOracle is OwnableUpgradeable {\n mapping(address => uint256) public assetPrices;\n\n /// @notice the actual pyth oracle address fetch & store the prices\n IPyth public underlyingPythOracle;\n\n //set price in 6 decimal precision\n constructor() {}\n\n function initialize(address underlyingPythOracle_) public initializer {\n __Ownable_init();\n if (underlyingPythOracle_ == address(0)) revert(\"pyth oracle cannot be zero address\");\n underlyingPythOracle = IPyth(underlyingPythOracle_);\n }\n\n function setPrice(address asset, uint256 price) external {\n assetPrices[asset] = price;\n }\n\n //https://compound.finance/docs/prices\n function getPrice(address token) public view returns (uint256) {\n return assetPrices[token];\n }\n}\n" + }, + "contracts/oracles/mocks/MockSFrxEthFraxOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"../../interfaces/ISfrxEthFraxOracle.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\n\ncontract MockSfrxEthFraxOracle is ISfrxEthFraxOracle, Ownable {\n bool public isBadData;\n uint256 public priceLow;\n uint256 public priceHigh;\n\n constructor() Ownable() {}\n\n function setPrices(bool _isBadData, uint256 _priceLow, uint256 _priceHigh) external onlyOwner {\n isBadData = _isBadData;\n priceLow = _priceLow;\n priceHigh = _priceHigh;\n }\n\n function getPrices() external view override returns (bool, uint256, uint256) {\n return (isBadData, priceLow, priceHigh);\n }\n}\n" + }, + "contracts/oracles/OneJumpOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { OracleInterface } from \"../interfaces/OracleInterface.sol\";\nimport { IERC20Metadata } from \"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\";\n\n/**\n * @title OneJumpOracle\n * @author Venus\n * @notice This oracle fetches the price of an asset in through an intermediate asset\n */\ncontract OneJumpOracle is CorrelatedTokenOracle {\n /// @notice Address of the intermediate oracle\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n OracleInterface public immutable INTERMEDIATE_ORACLE;\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address correlatedToken,\n address underlyingToken,\n address resilientOracle,\n address intermediateOracle\n ) CorrelatedTokenOracle(correlatedToken, underlyingToken, resilientOracle) {\n ensureNonzeroAddress(intermediateOracle);\n INTERMEDIATE_ORACLE = OracleInterface(intermediateOracle);\n }\n\n /**\n * @notice Fetches the amount of the underlying token for 1 correlated token, using the intermediate oracle\n * @return amount The amount of the underlying token for 1 correlated token scaled by the underlying token decimals\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n uint256 underlyingDecimals = IERC20Metadata(UNDERLYING_TOKEN).decimals();\n uint256 correlatedDecimals = IERC20Metadata(CORRELATED_TOKEN).decimals();\n\n uint256 underlyingAmount = INTERMEDIATE_ORACLE.getPrice(CORRELATED_TOKEN);\n\n return (underlyingAmount * (10 ** correlatedDecimals)) / (10 ** (36 - underlyingDecimals));\n }\n}\n" + }, + "contracts/oracles/PendleOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { IPendlePtOracle } from \"../interfaces/IPendlePtOracle.sol\";\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\nimport { ensureNonzeroAddress, ensureNonzeroValue } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\n\n/**\n * @title PendleOracle\n * @author Venus\n * @notice This oracle fetches the price of a pendle token\n */\ncontract PendleOracle is CorrelatedTokenOracle {\n /// @notice Address of the PT oracle\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IPendlePtOracle public immutable PT_ORACLE;\n\n /// @notice Address of the market\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n address public immutable MARKET;\n\n /// @notice Twap duration for the oracle\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n uint32 public immutable TWAP_DURATION;\n\n /// @notice Thrown if the duration is invalid\n error InvalidDuration();\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address market,\n address ptOracle,\n address ptToken,\n address underlyingToken,\n address resilientOracle,\n uint32 twapDuration\n ) CorrelatedTokenOracle(ptToken, underlyingToken, resilientOracle) {\n ensureNonzeroAddress(market);\n ensureNonzeroAddress(ptOracle);\n ensureNonzeroValue(twapDuration);\n\n MARKET = market;\n PT_ORACLE = IPendlePtOracle(ptOracle);\n TWAP_DURATION = twapDuration;\n\n (bool increaseCardinalityRequired, , bool oldestObservationSatisfied) = PT_ORACLE.getOracleState(\n MARKET,\n TWAP_DURATION\n );\n if (increaseCardinalityRequired || !oldestObservationSatisfied) {\n revert InvalidDuration();\n }\n }\n\n /**\n * @notice Fetches the amount of underlying token for 1 pendle token\n * @return amount The amount of underlying token for pendle token\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n return PT_ORACLE.getPtToAssetRate(MARKET, TWAP_DURATION);\n }\n}\n" + }, + "contracts/oracles/PythOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"@openzeppelin/contracts/utils/math/SafeCast.sol\";\nimport \"@openzeppelin/contracts/utils/math/SignedMath.sol\";\nimport \"../interfaces/PythInterface.sol\";\nimport \"../interfaces/OracleInterface.sol\";\nimport \"../interfaces/VBep20Interface.sol\";\nimport \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\";\n\n/**\n * @title PythOracle\n * @author Venus\n * @notice PythOracle contract reads prices from actual Pyth oracle contract which accepts, verifies and stores\n * the updated prices from external sources\n */\ncontract PythOracle is AccessControlledV8, OracleInterface {\n // To calculate 10 ** n(which is a signed type)\n using SignedMath for int256;\n\n // To cast int64/int8 types from Pyth to unsigned types\n using SafeCast for int256;\n\n struct TokenConfig {\n bytes32 pythId;\n address asset;\n uint64 maxStalePeriod;\n }\n\n /// @notice Exponent scale (decimal precision) of prices\n uint256 public constant EXP_SCALE = 1e18;\n\n /// @notice Set this as asset address for BNB. This is the underlying for vBNB\n address public constant BNB_ADDR = 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB;\n\n /// @notice The actual pyth oracle address fetch & store the prices\n IPyth public underlyingPythOracle;\n\n /// @notice Token configs by asset address\n mapping(address => TokenConfig) public tokenConfigs;\n\n /// @notice Emit when setting a new pyth oracle address\n event PythOracleSet(address indexed oldPythOracle, address indexed newPythOracle);\n\n /// @notice Emit when a token config is added\n event TokenConfigAdded(address indexed asset, bytes32 indexed pythId, uint64 indexed maxStalePeriod);\n\n modifier notNullAddress(address someone) {\n if (someone == address(0)) revert(\"can't be zero address\");\n _;\n }\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor() {\n _disableInitializers();\n }\n\n /**\n * @notice Initializes the owner of the contract and sets required contracts\n * @param underlyingPythOracle_ Address of the Pyth oracle\n * @param accessControlManager_ Address of the access control manager contract\n */\n function initialize(\n address underlyingPythOracle_,\n address accessControlManager_\n ) external initializer notNullAddress(underlyingPythOracle_) {\n __AccessControlled_init(accessControlManager_);\n\n underlyingPythOracle = IPyth(underlyingPythOracle_);\n emit PythOracleSet(address(0), underlyingPythOracle_);\n }\n\n /**\n * @notice Batch set token configs\n * @param tokenConfigs_ Token config array\n * @custom:access Only Governance\n * @custom:error Zero length error is thrown if length of the array in parameter is 0\n */\n function setTokenConfigs(TokenConfig[] memory tokenConfigs_) external {\n if (tokenConfigs_.length == 0) revert(\"length can't be 0\");\n uint256 numTokenConfigs = tokenConfigs_.length;\n for (uint256 i; i < numTokenConfigs; ) {\n setTokenConfig(tokenConfigs_[i]);\n unchecked {\n ++i;\n }\n }\n }\n\n /**\n * @notice Set the underlying Pyth oracle contract address\n * @param underlyingPythOracle_ Pyth oracle contract address\n * @custom:access Only Governance\n * @custom:error NotNullAddress error thrown if underlyingPythOracle_ address is zero\n * @custom:event Emits PythOracleSet event with address of Pyth oracle.\n */\n function setUnderlyingPythOracle(\n IPyth underlyingPythOracle_\n ) external notNullAddress(address(underlyingPythOracle_)) {\n _checkAccessAllowed(\"setUnderlyingPythOracle(address)\");\n IPyth oldUnderlyingPythOracle = underlyingPythOracle;\n underlyingPythOracle = underlyingPythOracle_;\n emit PythOracleSet(address(oldUnderlyingPythOracle), address(underlyingPythOracle_));\n }\n\n /**\n * @notice Set single token config. `maxStalePeriod` cannot be 0 and `asset` cannot be a null address\n * @param tokenConfig Token config struct\n * @custom:access Only Governance\n * @custom:error Range error is thrown if max stale period is zero\n * @custom:error NotNullAddress error is thrown if asset address is null\n */\n function setTokenConfig(TokenConfig memory tokenConfig) public notNullAddress(tokenConfig.asset) {\n _checkAccessAllowed(\"setTokenConfig(TokenConfig)\");\n if (tokenConfig.maxStalePeriod == 0) revert(\"max stale period cannot be 0\");\n tokenConfigs[tokenConfig.asset] = tokenConfig;\n emit TokenConfigAdded(tokenConfig.asset, tokenConfig.pythId, tokenConfig.maxStalePeriod);\n }\n\n /**\n * @notice Gets the price of a asset from the pyth oracle\n * @param asset Address of the asset\n * @return Price in USD\n */\n function getPrice(address asset) public view returns (uint256) {\n uint256 decimals;\n\n if (asset == BNB_ADDR) {\n decimals = 18;\n } else {\n IERC20Metadata token = IERC20Metadata(asset);\n decimals = token.decimals();\n }\n\n return _getPriceInternal(asset, decimals);\n }\n\n function _getPriceInternal(address asset, uint256 decimals) internal view returns (uint256) {\n TokenConfig storage tokenConfig = tokenConfigs[asset];\n if (tokenConfig.asset == address(0)) revert(\"asset doesn't exist\");\n\n // if the price is expired after it's compared against `maxStalePeriod`, the following call will revert\n PythStructs.Price memory priceInfo = underlyingPythOracle.getPriceNoOlderThan(\n tokenConfig.pythId,\n tokenConfig.maxStalePeriod\n );\n\n uint256 price = int256(priceInfo.price).toUint256();\n\n if (price == 0) revert(\"invalid pyth oracle price\");\n\n // the price returned from Pyth is price ** 10^expo, which is the real dollar price of the assets\n // we need to multiply it by 1e18 to make the price 18 decimals\n if (priceInfo.expo > 0) {\n return price * EXP_SCALE * (10 ** int256(priceInfo.expo).toUint256()) * (10 ** (18 - decimals));\n } else {\n return ((price * EXP_SCALE) / (10 ** int256(-priceInfo.expo).toUint256())) * (10 ** (18 - decimals));\n }\n }\n}\n" + }, + "contracts/oracles/SequencerChainlinkOracle.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity 0.8.25;\n\nimport { ChainlinkOracle } from \"./ChainlinkOracle.sol\";\nimport { AggregatorV3Interface } from \"@chainlink/contracts/src/v0.8/interfaces/AggregatorV3Interface.sol\";\n\n/**\n @title Sequencer Chain Link Oracle\n @notice Oracle to fetch price using chainlink oracles on L2s with sequencer\n*/\ncontract SequencerChainlinkOracle is ChainlinkOracle {\n /// @notice L2 Sequencer feed\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n AggregatorV3Interface public immutable sequencer;\n\n /// @notice L2 Sequencer grace period\n uint256 public constant GRACE_PERIOD_TIME = 3600;\n\n /**\n @notice Contract constructor\n @param _sequencer L2 sequencer\n @custom:oz-upgrades-unsafe-allow constructor\n */\n constructor(AggregatorV3Interface _sequencer) ChainlinkOracle() {\n require(address(_sequencer) != address(0), \"zero address\");\n\n sequencer = _sequencer;\n }\n\n /// @inheritdoc ChainlinkOracle\n function getPrice(address asset) public view override returns (uint) {\n if (!isSequencerActive()) revert(\"L2 sequencer unavailable\");\n return super.getPrice(asset);\n }\n\n function isSequencerActive() internal view returns (bool) {\n // answer from oracle is a variable with a value of either 1 or 0\n // 0: The sequencer is up\n // 1: The sequencer is down\n // startedAt: This timestamp indicates when the sequencer changed status\n (, int256 answer, uint256 startedAt, , ) = sequencer.latestRoundData();\n if (block.timestamp - startedAt <= GRACE_PERIOD_TIME || answer == 1) return false;\n return true;\n }\n}\n" + }, + "contracts/oracles/SFraxOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { ISFrax } from \"../interfaces/ISFrax.sol\";\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\n\n/**\n * @title SFraxOracle\n * @author Venus\n * @notice This oracle fetches the price of sFrax\n */\ncontract SFraxOracle is CorrelatedTokenOracle {\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address sFrax,\n address frax,\n address resilientOracle\n ) CorrelatedTokenOracle(sFrax, frax, resilientOracle) {}\n\n /**\n * @notice Fetches the amount of FRAX for 1 sFrax\n * @return amount The amount of FRAX for sFrax\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n return ISFrax(CORRELATED_TOKEN).convertToAssets(EXP_SCALE);\n }\n}\n" + }, + "contracts/oracles/SFrxETHOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { ISfrxEthFraxOracle } from \"../interfaces/ISfrxEthFraxOracle.sol\";\nimport { ensureNonzeroAddress, ensureNonzeroValue } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\nimport { AccessControlledV8 } from \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\";\nimport { OracleInterface } from \"../interfaces/OracleInterface.sol\";\n\n/**\n * @title SFrxETHOracle\n * @author Venus\n * @notice This oracle fetches the price of sfrxETH\n */\ncontract SFrxETHOracle is AccessControlledV8, OracleInterface {\n /// @notice Address of SfrxEthFraxOracle\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n ISfrxEthFraxOracle public immutable SFRXETH_FRAX_ORACLE;\n\n /// @notice Address of sfrxETH\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n address public immutable SFRXETH;\n\n /// @notice Maximum allowed price difference\n uint256 public maxAllowedPriceDifference;\n\n /// @notice Emits when the maximum allowed price difference is updated\n event MaxAllowedPriceDifferenceUpdated(uint256 oldMaxAllowedPriceDifference, uint256 newMaxAllowedPriceDifference);\n\n /// @notice Thrown if the price data is invalid\n error BadPriceData();\n\n /// @notice Thrown if the price difference exceeds the allowed limit\n error PriceDifferenceExceeded();\n\n /// @notice Thrown if the token address is invalid\n error InvalidTokenAddress();\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(address _sfrxEthFraxOracle, address _sfrxETH) {\n ensureNonzeroAddress(_sfrxEthFraxOracle);\n ensureNonzeroAddress(_sfrxETH);\n\n SFRXETH_FRAX_ORACLE = ISfrxEthFraxOracle(_sfrxEthFraxOracle);\n SFRXETH = _sfrxETH;\n\n _disableInitializers();\n }\n\n /**\n * @notice Sets the contracts required to fetch prices\n * @param _accessControlManager Address of the access control manager contract\n * @param _maxAllowedPriceDifference Maximum allowed price difference\n */\n function initialize(address _accessControlManager, uint256 _maxAllowedPriceDifference) external initializer {\n ensureNonzeroValue(_maxAllowedPriceDifference);\n\n __AccessControlled_init(_accessControlManager);\n maxAllowedPriceDifference = _maxAllowedPriceDifference;\n }\n\n /**\n * @notice Sets the maximum allowed price difference\n * @param _maxAllowedPriceDifference Maximum allowed price difference\n */\n function setMaxAllowedPriceDifference(uint256 _maxAllowedPriceDifference) external {\n _checkAccessAllowed(\"setMaxAllowedPriceDifference(uint256)\");\n ensureNonzeroValue(_maxAllowedPriceDifference);\n\n emit MaxAllowedPriceDifferenceUpdated(maxAllowedPriceDifference, _maxAllowedPriceDifference);\n maxAllowedPriceDifference = _maxAllowedPriceDifference;\n }\n\n /**\n * @notice Fetches the USD price of sfrxETH\n * @param asset Address of the sfrxETH token\n * @return price The price scaled by 1e18\n */\n function getPrice(address asset) external view returns (uint256) {\n if (asset != SFRXETH) revert InvalidTokenAddress();\n\n (bool isBadData, uint256 priceLow, uint256 priceHigh) = SFRXETH_FRAX_ORACLE.getPrices();\n\n if (isBadData) revert BadPriceData();\n\n // calculate price in USD\n uint256 priceHighInUSD = (EXP_SCALE ** 2) / priceLow;\n uint256 priceLowInUSD = (EXP_SCALE ** 2) / priceHigh;\n\n ensureNonzeroValue(priceHighInUSD);\n ensureNonzeroValue(priceLowInUSD);\n\n // validate price difference\n uint256 difference = (priceHighInUSD * EXP_SCALE) / priceLowInUSD;\n if (difference > maxAllowedPriceDifference) revert PriceDifferenceExceeded();\n\n // calculate and return average price\n return (priceHighInUSD + priceLowInUSD) / 2;\n }\n}\n" + }, + "contracts/oracles/SlisBNBOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { ISynclubStakeManager } from \"../interfaces/ISynclubStakeManager.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\n\n/**\n * @title SlisBNBOracle\n * @author Venus\n * @notice This oracle fetches the price of slisBNB asset\n */\ncontract SlisBNBOracle is CorrelatedTokenOracle {\n /// @notice This is used as token address of BNB on BSC\n address public constant NATIVE_TOKEN_ADDR = 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB;\n\n /// @notice Address of StakeManager\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n ISynclubStakeManager public immutable STAKE_MANAGER;\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address stakeManager,\n address slisBNB,\n address resilientOracle\n ) CorrelatedTokenOracle(slisBNB, NATIVE_TOKEN_ADDR, resilientOracle) {\n ensureNonzeroAddress(stakeManager);\n STAKE_MANAGER = ISynclubStakeManager(stakeManager);\n }\n\n /**\n * @notice Fetches the amount of BNB for 1 slisBNB\n * @return amount The amount of BNB for slisBNB\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n return STAKE_MANAGER.convertSnBnbToBnb(EXP_SCALE);\n }\n}\n" + }, + "contracts/oracles/StkBNBOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { IPStakePool } from \"../interfaces/IPStakePool.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\n\n/**\n * @title StkBNBOracle\n * @author Venus\n * @notice This oracle fetches the price of stkBNB asset\n */\ncontract StkBNBOracle is CorrelatedTokenOracle {\n /// @notice This is used as token address of BNB on BSC\n address public constant NATIVE_TOKEN_ADDR = 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB;\n\n /// @notice Address of StakePool\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IPStakePool public immutable STAKE_POOL;\n\n /// @notice Thrown if the pool token supply is zero\n error PoolTokenSupplyIsZero();\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address stakePool,\n address stkBNB,\n address resilientOracle\n ) CorrelatedTokenOracle(stkBNB, NATIVE_TOKEN_ADDR, resilientOracle) {\n ensureNonzeroAddress(stakePool);\n STAKE_POOL = IPStakePool(stakePool);\n }\n\n /**\n * @notice Fetches the amount of BNB for 1 stkBNB\n * @return price The amount of BNB for stkBNB\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n IPStakePool.Data memory exchangeRateData = STAKE_POOL.exchangeRate();\n\n if (exchangeRateData.poolTokenSupply == 0) {\n revert PoolTokenSupplyIsZero();\n }\n\n return (exchangeRateData.totalWei * EXP_SCALE) / exchangeRateData.poolTokenSupply;\n }\n}\n" + }, + "contracts/oracles/WBETHOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { IWBETH } from \"../interfaces/IWBETH.sol\";\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\n\n/**\n * @title WBETHOracle\n * @author Venus\n * @notice This oracle fetches the price of wBETH asset\n */\ncontract WBETHOracle is CorrelatedTokenOracle {\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address wbeth,\n address eth,\n address resilientOracle\n ) CorrelatedTokenOracle(wbeth, eth, resilientOracle) {}\n\n /**\n * @notice Fetches the amount of ETH for 1 wBETH\n * @return amount The amount of ETH for wBETH\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n return IWBETH(CORRELATED_TOKEN).exchangeRate();\n }\n}\n" + }, + "contracts/oracles/WeETHOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\nimport { IEtherFiLiquidityPool } from \"../interfaces/IEtherFiLiquidityPool.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\n\n/**\n * @title WeETHOracle\n * @author Venus\n * @notice This oracle fetches the price of weETH\n */\ncontract WeETHOracle is CorrelatedTokenOracle {\n /// @notice Address of Liqiudity pool\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IEtherFiLiquidityPool public immutable LIQUIDITY_POOL;\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address liquidityPool,\n address weETH,\n address eETH,\n address resilientOracle\n ) CorrelatedTokenOracle(weETH, eETH, resilientOracle) {\n ensureNonzeroAddress(liquidityPool);\n LIQUIDITY_POOL = IEtherFiLiquidityPool(liquidityPool);\n }\n\n /**\n * @notice Gets the eETH for 1 weETH\n * @return amount Amount of eETH\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n return LIQUIDITY_POOL.amountForShare(EXP_SCALE);\n }\n}\n" + }, + "contracts/oracles/WstETHOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { OracleInterface } from \"../interfaces/OracleInterface.sol\";\nimport { IStETH } from \"../interfaces/IStETH.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\n\n/**\n * @title WstETHOracle\n * @author Venus\n * @notice Depending on the equivalence flag price is either based on assumption that 1 stETH = 1 ETH\n * or the price of stETH/USD (secondary market price) is obtained from the oracle.\n */\ncontract WstETHOracle is OracleInterface {\n /// @notice A flag assuming 1:1 price equivalence between stETH/ETH\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n bool public immutable ASSUME_STETH_ETH_EQUIVALENCE;\n\n /// @notice Address of stETH\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IStETH public immutable STETH;\n\n /// @notice Address of wstETH\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n address public immutable WSTETH_ADDRESS;\n\n /// @notice Address of WETH\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n address public immutable WETH_ADDRESS;\n\n /// @notice Address of Resilient Oracle\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n OracleInterface public immutable RESILIENT_ORACLE;\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address wstETHAddress,\n address wETHAddress,\n address stETHAddress,\n address resilientOracleAddress,\n bool assumeEquivalence\n ) {\n ensureNonzeroAddress(wstETHAddress);\n ensureNonzeroAddress(wETHAddress);\n ensureNonzeroAddress(stETHAddress);\n ensureNonzeroAddress(resilientOracleAddress);\n WSTETH_ADDRESS = wstETHAddress;\n WETH_ADDRESS = wETHAddress;\n STETH = IStETH(stETHAddress);\n RESILIENT_ORACLE = OracleInterface(resilientOracleAddress);\n ASSUME_STETH_ETH_EQUIVALENCE = assumeEquivalence;\n }\n\n /**\n * @notice Gets the USD price of wstETH asset\n * @dev Depending on the equivalence flag price is either based on assumption that 1 stETH = 1 ETH\n * or the price of stETH/USD (secondary market price) is obtained from the oracle\n * @param asset Address of wstETH\n * @return wstETH Price in USD scaled by 1e18\n */\n function getPrice(address asset) public view returns (uint256) {\n if (asset != WSTETH_ADDRESS) revert(\"wrong wstETH address\");\n\n // get stETH amount for 1 wstETH scaled by 1e18\n uint256 stETHAmount = STETH.getPooledEthByShares(1 ether);\n\n // price is scaled 1e18 (oracle returns 36 - asset decimal scale)\n uint256 stETHUSDPrice = RESILIENT_ORACLE.getPrice(ASSUME_STETH_ETH_EQUIVALENCE ? WETH_ADDRESS : address(STETH));\n\n // stETHAmount (for 1 wstETH) * stETHUSDPrice / 1e18\n return (stETHAmount * stETHUSDPrice) / EXP_SCALE;\n }\n}\n" + }, + "contracts/oracles/WstETHOracleV2.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { IStETH } from \"../interfaces/IStETH.sol\";\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\n\n/**\n * @title WstETHOracleV2\n * @author Venus\n * @notice This oracle fetches the price of wstETH\n */\ncontract WstETHOracleV2 is CorrelatedTokenOracle {\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address wstETH,\n address stETH,\n address resilientOracle\n ) CorrelatedTokenOracle(wstETH, stETH, resilientOracle) {}\n\n /**\n * @notice Gets the stETH for 1 wstETH\n * @return amount Amount of stETH\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n return IStETH(UNDERLYING_TOKEN).getPooledEthByShares(EXP_SCALE);\n }\n}\n" + }, + "contracts/ResilientOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\n// SPDX-FileCopyrightText: 2022 Venus\npragma solidity 0.8.25;\n\nimport \"@openzeppelin/contracts-upgradeable/security/PausableUpgradeable.sol\";\nimport \"./interfaces/VBep20Interface.sol\";\nimport \"./interfaces/OracleInterface.sol\";\nimport \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\";\n\n/**\n * @title ResilientOracle\n * @author Venus\n * @notice The Resilient Oracle is the main contract that the protocol uses to fetch prices of assets.\n * \n * DeFi protocols are vulnerable to price oracle failures including oracle manipulation and incorrectly\n * reported prices. If only one oracle is used, this creates a single point of failure and opens a vector\n * for attacking the protocol.\n * \n * The Resilient Oracle uses multiple sources and fallback mechanisms to provide accurate prices and protect\n * the protocol from oracle attacks. Currently it includes integrations with Chainlink, Pyth, Binance Oracle\n * and TWAP (Time-Weighted Average Price) oracles. TWAP uses PancakeSwap as the on-chain price source.\n * \n * For every market (vToken) we configure the main, pivot and fallback oracles. The oracles are configured per \n * vToken's underlying asset address. The main oracle oracle is the most trustworthy price source, the pivot \n * oracle is used as a loose sanity checker and the fallback oracle is used as a backup price source. \n * \n * To validate prices returned from two oracles, we use an upper and lower bound ratio that is set for every\n * market. The upper bound ratio represents the deviation between reported price (the price that’s being\n * validated) and the anchor price (the price we are validating against) above which the reported price will\n * be invalidated. The lower bound ratio presents the deviation between reported price and anchor price below\n * which the reported price will be invalidated. So for oracle price to be considered valid the below statement\n * should be true:\n\n```\nanchorRatio = anchorPrice/reporterPrice\nisValid = anchorRatio <= upperBoundAnchorRatio && anchorRatio >= lowerBoundAnchorRatio\n```\n\n * In most cases, Chainlink is used as the main oracle, TWAP or Pyth oracles are used as the pivot oracle depending\n * on which supports the given market and Binance oracle is used as the fallback oracle. For some markets we may\n * use Pyth or TWAP as the main oracle if the token price is not supported by Chainlink or Binance oracles. \n * \n * For a fetched price to be valid it must be positive and not stagnant. If the price is invalid then we consider the\n * oracle to be stagnant and treat it like it's disabled.\n */\ncontract ResilientOracle is PausableUpgradeable, AccessControlledV8, ResilientOracleInterface {\n /**\n * @dev Oracle roles:\n * **main**: The most trustworthy price source\n * **pivot**: Price oracle used as a loose sanity checker\n * **fallback**: The backup source when main oracle price is invalidated\n */\n enum OracleRole {\n MAIN,\n PIVOT,\n FALLBACK\n }\n\n struct TokenConfig {\n /// @notice asset address\n address asset;\n /// @notice `oracles` stores the oracles based on their role in the following order:\n /// [main, pivot, fallback],\n /// It can be indexed with the corresponding enum OracleRole value\n address[3] oracles;\n /// @notice `enableFlagsForOracles` stores the enabled state\n /// for each oracle in the same order as `oracles`\n bool[3] enableFlagsForOracles;\n }\n\n uint256 public constant INVALID_PRICE = 0;\n\n /// @notice Native market address\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n address public immutable nativeMarket;\n\n /// @notice VAI address\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n address public immutable vai;\n\n /// @notice Set this as asset address for Native token on each chain.This is the underlying for vBNB (on bsc)\n /// and can serve as any underlying asset of a market that supports native tokens\n address public constant NATIVE_TOKEN_ADDR = 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB;\n\n /// @notice Bound validator contract address\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n BoundValidatorInterface public immutable boundValidator;\n\n mapping(address => TokenConfig) private tokenConfigs;\n\n event TokenConfigAdded(\n address indexed asset,\n address indexed mainOracle,\n address indexed pivotOracle,\n address fallbackOracle\n );\n\n /// Event emitted when an oracle is set\n event OracleSet(address indexed asset, address indexed oracle, uint256 indexed role);\n\n /// Event emitted when an oracle is enabled or disabled\n event OracleEnabled(address indexed asset, uint256 indexed role, bool indexed enable);\n\n /**\n * @notice Checks whether an address is null or not\n */\n modifier notNullAddress(address someone) {\n if (someone == address(0)) revert(\"can't be zero address\");\n _;\n }\n\n /**\n * @notice Checks whether token config exists by checking whether asset is null address\n * @dev address can't be null, so it's suitable to be used to check the validity of the config\n * @param asset asset address\n */\n modifier checkTokenConfigExistence(address asset) {\n if (tokenConfigs[asset].asset == address(0)) revert(\"token config must exist\");\n _;\n }\n\n /// @notice Constructor for the implementation contract. Sets immutable variables.\n /// @dev nativeMarketAddress can be address(0) if on the chain we do not support native market\n /// (e.g vETH on ethereum would not be supported, only vWETH)\n /// @param nativeMarketAddress The address of a native market (for bsc it would be vBNB address)\n /// @param vaiAddress The address of the VAI token (if there is VAI on the deployed chain).\n /// Set to address(0) of VAI is not existent.\n /// @param _boundValidator Address of the bound validator contract\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address nativeMarketAddress,\n address vaiAddress,\n BoundValidatorInterface _boundValidator\n ) notNullAddress(address(_boundValidator)) {\n nativeMarket = nativeMarketAddress;\n vai = vaiAddress;\n boundValidator = _boundValidator;\n\n _disableInitializers();\n }\n\n /**\n * @notice Initializes the contract admin and sets the BoundValidator contract address\n * @param accessControlManager_ Address of the access control manager contract\n */\n function initialize(address accessControlManager_) external initializer {\n __AccessControlled_init(accessControlManager_);\n __Pausable_init();\n }\n\n /**\n * @notice Pauses oracle\n * @custom:access Only Governance\n */\n function pause() external {\n _checkAccessAllowed(\"pause()\");\n _pause();\n }\n\n /**\n * @notice Unpauses oracle\n * @custom:access Only Governance\n */\n function unpause() external {\n _checkAccessAllowed(\"unpause()\");\n _unpause();\n }\n\n /**\n * @notice Batch sets token configs\n * @param tokenConfigs_ Token config array\n * @custom:access Only Governance\n * @custom:error Throws a length error if the length of the token configs array is 0\n */\n function setTokenConfigs(TokenConfig[] memory tokenConfigs_) external {\n if (tokenConfigs_.length == 0) revert(\"length can't be 0\");\n uint256 numTokenConfigs = tokenConfigs_.length;\n for (uint256 i; i < numTokenConfigs; ) {\n setTokenConfig(tokenConfigs_[i]);\n unchecked {\n ++i;\n }\n }\n }\n\n /**\n * @notice Sets oracle for a given asset and role.\n * @dev Supplied asset **must** exist and main oracle may not be null\n * @param asset Asset address\n * @param oracle Oracle address\n * @param role Oracle role\n * @custom:access Only Governance\n * @custom:error Null address error if main-role oracle address is null\n * @custom:error NotNullAddress error is thrown if asset address is null\n * @custom:error TokenConfigExistance error is thrown if token config is not set\n * @custom:event Emits OracleSet event with asset address, oracle address and role of the oracle for the asset\n */\n function setOracle(\n address asset,\n address oracle,\n OracleRole role\n ) external notNullAddress(asset) checkTokenConfigExistence(asset) {\n _checkAccessAllowed(\"setOracle(address,address,uint8)\");\n if (oracle == address(0) && role == OracleRole.MAIN) revert(\"can't set zero address to main oracle\");\n tokenConfigs[asset].oracles[uint256(role)] = oracle;\n emit OracleSet(asset, oracle, uint256(role));\n }\n\n /**\n * @notice Enables/ disables oracle for the input asset. Token config for the input asset **must** exist\n * @dev Configuration for the asset **must** already exist and the asset cannot be 0 address\n * @param asset Asset address\n * @param role Oracle role\n * @param enable Enabled boolean of the oracle\n * @custom:access Only Governance\n * @custom:error NotNullAddress error is thrown if asset address is null\n * @custom:error TokenConfigExistance error is thrown if token config is not set\n */\n function enableOracle(\n address asset,\n OracleRole role,\n bool enable\n ) external notNullAddress(asset) checkTokenConfigExistence(asset) {\n _checkAccessAllowed(\"enableOracle(address,uint8,bool)\");\n tokenConfigs[asset].enableFlagsForOracles[uint256(role)] = enable;\n emit OracleEnabled(asset, uint256(role), enable);\n }\n\n /**\n * @notice Updates the TWAP pivot oracle price.\n * @dev This function should always be called before calling getUnderlyingPrice\n * @param vToken vToken address\n */\n function updatePrice(address vToken) external override {\n address asset = _getUnderlyingAsset(vToken);\n (address pivotOracle, bool pivotOracleEnabled) = getOracle(asset, OracleRole.PIVOT);\n if (pivotOracle != address(0) && pivotOracleEnabled) {\n //if pivot oracle is not TwapOracle it will revert so we need to catch the revert\n try TwapInterface(pivotOracle).updateTwap(asset) {} catch {}\n }\n }\n\n /**\n * @notice Updates the pivot oracle price. Currently using TWAP\n * @dev This function should always be called before calling getPrice\n * @param asset asset address\n */\n function updateAssetPrice(address asset) external {\n (address pivotOracle, bool pivotOracleEnabled) = getOracle(asset, OracleRole.PIVOT);\n if (pivotOracle != address(0) && pivotOracleEnabled) {\n //if pivot oracle is not TwapOracle it will revert so we need to catch the revert\n try TwapInterface(pivotOracle).updateTwap(asset) {} catch {}\n }\n }\n\n /**\n * @dev Gets token config by asset address\n * @param asset asset address\n * @return tokenConfig Config for the asset\n */\n function getTokenConfig(address asset) external view returns (TokenConfig memory) {\n return tokenConfigs[asset];\n }\n\n /**\n * @notice Gets price of the underlying asset for a given vToken. Validation flow:\n * - Check if the oracle is paused globally\n * - Validate price from main oracle against pivot oracle\n * - Validate price from fallback oracle against pivot oracle if the first validation failed\n * - Validate price from main oracle against fallback oracle if the second validation failed\n * In the case that the pivot oracle is not available but main price is available and validation is successful,\n * main oracle price is returned.\n * @param vToken vToken address\n * @return price USD price in scaled decimal places.\n * @custom:error Paused error is thrown when resilent oracle is paused\n * @custom:error Invalid resilient oracle price error is thrown if fetched prices from oracle is invalid\n */\n function getUnderlyingPrice(address vToken) external view override returns (uint256) {\n if (paused()) revert(\"resilient oracle is paused\");\n\n address asset = _getUnderlyingAsset(vToken);\n return _getPrice(asset);\n }\n\n /**\n * @notice Gets price of the asset\n * @param asset asset address\n * @return price USD price in scaled decimal places.\n * @custom:error Paused error is thrown when resilent oracle is paused\n * @custom:error Invalid resilient oracle price error is thrown if fetched prices from oracle is invalid\n */\n function getPrice(address asset) external view override returns (uint256) {\n if (paused()) revert(\"resilient oracle is paused\");\n return _getPrice(asset);\n }\n\n /**\n * @notice Sets/resets single token configs.\n * @dev main oracle **must not** be a null address\n * @param tokenConfig Token config struct\n * @custom:access Only Governance\n * @custom:error NotNullAddress is thrown if asset address is null\n * @custom:error NotNullAddress is thrown if main-role oracle address for asset is null\n * @custom:event Emits TokenConfigAdded event when the asset config is set successfully by the authorized account\n */\n function setTokenConfig(\n TokenConfig memory tokenConfig\n ) public notNullAddress(tokenConfig.asset) notNullAddress(tokenConfig.oracles[uint256(OracleRole.MAIN)]) {\n _checkAccessAllowed(\"setTokenConfig(TokenConfig)\");\n\n tokenConfigs[tokenConfig.asset] = tokenConfig;\n emit TokenConfigAdded(\n tokenConfig.asset,\n tokenConfig.oracles[uint256(OracleRole.MAIN)],\n tokenConfig.oracles[uint256(OracleRole.PIVOT)],\n tokenConfig.oracles[uint256(OracleRole.FALLBACK)]\n );\n }\n\n /**\n * @notice Gets oracle and enabled status by asset address\n * @param asset asset address\n * @param role Oracle role\n * @return oracle Oracle address based on role\n * @return enabled Enabled flag of the oracle based on token config\n */\n function getOracle(address asset, OracleRole role) public view returns (address oracle, bool enabled) {\n oracle = tokenConfigs[asset].oracles[uint256(role)];\n enabled = tokenConfigs[asset].enableFlagsForOracles[uint256(role)];\n }\n\n function _getPrice(address asset) internal view returns (uint256) {\n uint256 pivotPrice = INVALID_PRICE;\n\n // Get pivot oracle price, Invalid price if not available or error\n (address pivotOracle, bool pivotOracleEnabled) = getOracle(asset, OracleRole.PIVOT);\n if (pivotOracleEnabled && pivotOracle != address(0)) {\n try OracleInterface(pivotOracle).getPrice(asset) returns (uint256 pricePivot) {\n pivotPrice = pricePivot;\n } catch {}\n }\n\n // Compare main price and pivot price, return main price and if validation was successful\n // note: In case pivot oracle is not available but main price is available and\n // validation is successful, the main oracle price is returned.\n (uint256 mainPrice, bool validatedPivotMain) = _getMainOraclePrice(\n asset,\n pivotPrice,\n pivotOracleEnabled && pivotOracle != address(0)\n );\n if (mainPrice != INVALID_PRICE && validatedPivotMain) return mainPrice;\n\n // Compare fallback and pivot if main oracle comparision fails with pivot\n // Return fallback price when fallback price is validated successfully with pivot oracle\n (uint256 fallbackPrice, bool validatedPivotFallback) = _getFallbackOraclePrice(asset, pivotPrice);\n if (fallbackPrice != INVALID_PRICE && validatedPivotFallback) return fallbackPrice;\n\n // Lastly compare main price and fallback price\n if (\n mainPrice != INVALID_PRICE &&\n fallbackPrice != INVALID_PRICE &&\n boundValidator.validatePriceWithAnchorPrice(asset, mainPrice, fallbackPrice)\n ) {\n return mainPrice;\n }\n\n revert(\"invalid resilient oracle price\");\n }\n\n /**\n * @notice Gets a price for the provided asset\n * @dev This function won't revert when price is 0, because the fallback oracle may still be\n * able to fetch a correct price\n * @param asset asset address\n * @param pivotPrice Pivot oracle price\n * @param pivotEnabled If pivot oracle is not empty and enabled\n * @return price USD price in scaled decimals\n * e.g. asset decimals is 8 then price is returned as 10**18 * 10**(18-8) = 10**28 decimals\n * @return pivotValidated Boolean representing if the validation of main oracle price\n * and pivot oracle price were successful\n * @custom:error Invalid price error is thrown if main oracle fails to fetch price of the asset\n * @custom:error Invalid price error is thrown if main oracle is not enabled or main oracle\n * address is null\n */\n function _getMainOraclePrice(\n address asset,\n uint256 pivotPrice,\n bool pivotEnabled\n ) internal view returns (uint256, bool) {\n (address mainOracle, bool mainOracleEnabled) = getOracle(asset, OracleRole.MAIN);\n if (mainOracleEnabled && mainOracle != address(0)) {\n try OracleInterface(mainOracle).getPrice(asset) returns (uint256 mainOraclePrice) {\n if (!pivotEnabled) {\n return (mainOraclePrice, true);\n }\n if (pivotPrice == INVALID_PRICE) {\n return (mainOraclePrice, false);\n }\n return (\n mainOraclePrice,\n boundValidator.validatePriceWithAnchorPrice(asset, mainOraclePrice, pivotPrice)\n );\n } catch {\n return (INVALID_PRICE, false);\n }\n }\n\n return (INVALID_PRICE, false);\n }\n\n /**\n * @dev This function won't revert when the price is 0 because getPrice checks if price is > 0\n * @param asset asset address\n * @return price USD price in 18 decimals\n * @return pivotValidated Boolean representing if the validation of fallback oracle price\n * and pivot oracle price were successfull\n * @custom:error Invalid price error is thrown if fallback oracle fails to fetch price of the asset\n * @custom:error Invalid price error is thrown if fallback oracle is not enabled or fallback oracle\n * address is null\n */\n function _getFallbackOraclePrice(address asset, uint256 pivotPrice) private view returns (uint256, bool) {\n (address fallbackOracle, bool fallbackEnabled) = getOracle(asset, OracleRole.FALLBACK);\n if (fallbackEnabled && fallbackOracle != address(0)) {\n try OracleInterface(fallbackOracle).getPrice(asset) returns (uint256 fallbackOraclePrice) {\n if (pivotPrice == INVALID_PRICE) {\n return (fallbackOraclePrice, false);\n }\n return (\n fallbackOraclePrice,\n boundValidator.validatePriceWithAnchorPrice(asset, fallbackOraclePrice, pivotPrice)\n );\n } catch {\n return (INVALID_PRICE, false);\n }\n }\n\n return (INVALID_PRICE, false);\n }\n\n /**\n * @dev This function returns the underlying asset of a vToken\n * @param vToken vToken address\n * @return asset underlying asset address\n */\n function _getUnderlyingAsset(address vToken) private view notNullAddress(vToken) returns (address asset) {\n if (vToken == nativeMarket) {\n asset = NATIVE_TOKEN_ADDR;\n } else if (vToken == vai) {\n asset = vai;\n } else {\n asset = VBep20Interface(vToken).underlying();\n }\n }\n}\n" + }, + "contracts/test/AccessControlManager.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\nimport \"@openzeppelin/contracts/access/AccessControl.sol\";\nimport \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlManager.sol\";\n\ncontract AccessControlManagerScenario is AccessControlManager {}\n" + }, + "contracts/test/BEP20Harness.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\n\ncontract BEP20Harness is ERC20 {\n uint8 public decimalsInternal = 18;\n\n constructor(string memory name_, string memory symbol_, uint8 decimals_) ERC20(name_, symbol_) {\n decimalsInternal = decimals_;\n }\n\n function faucet(uint256 amount) external {\n _mint(msg.sender, amount);\n }\n\n function decimals() public view virtual override returns (uint8) {\n return decimalsInternal;\n }\n}\n" + }, + "contracts/test/MockAnkrBNB.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/ERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\nimport { IAnkrBNB } from \"../interfaces/IAnkrBNB.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\n\ncontract MockAnkrBNB is ERC20, Ownable, IAnkrBNB {\n uint8 private immutable _decimals;\n uint256 public exchangeRate;\n\n constructor(string memory name_, string memory symbol_, uint8 decimals_) ERC20(name_, symbol_) Ownable() {\n _decimals = decimals_;\n }\n\n function faucet(uint256 amount) external {\n _mint(msg.sender, amount);\n }\n\n function setSharesToBonds(uint256 rate) external onlyOwner {\n exchangeRate = rate;\n }\n\n function sharesToBonds(uint256 amount) external view override returns (uint256) {\n return (amount * exchangeRate) / (10 ** uint256(_decimals));\n }\n\n function decimals() public view virtual override(ERC20, IAnkrBNB) returns (uint8) {\n return _decimals;\n }\n}\n" + }, + "contracts/test/MockEtherFiLiquidityPool.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"../interfaces/IEtherFiLiquidityPool.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\n\ncontract MockEtherFiLiquidityPool is IEtherFiLiquidityPool, Ownable {\n /// @notice The amount of eETH per weETH scaled by 1e18\n uint256 public amountPerShare;\n\n constructor() Ownable() {}\n\n function setAmountPerShare(uint256 _amountPerShare) external onlyOwner {\n amountPerShare = _amountPerShare;\n }\n\n function amountForShare(uint256 _share) external view override returns (uint256) {\n return (_share * amountPerShare) / 1e18;\n }\n}\n" + }, + "contracts/test/MockPyth.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"../interfaces/PythInterface.sol\";\n\ncontract MockPyth is AbstractPyth {\n mapping(bytes32 => PythStructs.PriceFeed) priceFeeds;\n uint64 sequenceNumber;\n\n uint256 singleUpdateFeeInWei;\n uint256 validTimePeriod;\n\n constructor(uint256 _validTimePeriod, uint256 _singleUpdateFeeInWei) {\n singleUpdateFeeInWei = _singleUpdateFeeInWei;\n validTimePeriod = _validTimePeriod;\n }\n\n // simply update price feeds\n function updatePriceFeedsHarness(PythStructs.PriceFeed[] calldata feeds) external {\n require(feeds.length > 0, \"feeds length must > 0\");\n for (uint256 i = 0; i < feeds.length; ) {\n priceFeeds[feeds[i].id] = feeds[i];\n unchecked {\n ++i;\n }\n }\n }\n\n // Takes an array of encoded price feeds and stores them.\n // You can create this data either by calling createPriceFeedData or\n // by using web3.js or ethers abi utilities.\n function updatePriceFeeds(bytes[] calldata updateData) public payable override {\n uint256 requiredFee = getUpdateFee(updateData.length);\n require(msg.value >= requiredFee, \"Insufficient paid fee amount\");\n\n if (msg.value > requiredFee) {\n (bool success, ) = payable(msg.sender).call{ value: msg.value - requiredFee }(\"\");\n require(success, \"failed to transfer update fee\");\n }\n\n uint256 freshPrices = 0;\n\n // Chain ID is id of the source chain that the price update comes from. Since it is just a mock contract\n // We set it to 1.\n uint16 chainId = 1;\n\n for (uint256 i = 0; i < updateData.length; ) {\n PythStructs.PriceFeed memory priceFeed = abi.decode(updateData[i], (PythStructs.PriceFeed));\n\n bool fresh = false;\n uint256 lastPublishTime = priceFeeds[priceFeed.id].price.publishTime;\n\n if (lastPublishTime < priceFeed.price.publishTime) {\n // Price information is more recent than the existing price information.\n fresh = true;\n priceFeeds[priceFeed.id] = priceFeed;\n freshPrices += 1;\n }\n\n emit PriceFeedUpdate(\n priceFeed.id,\n fresh,\n chainId,\n sequenceNumber,\n priceFeed.price.publishTime,\n lastPublishTime,\n priceFeed.price.price,\n priceFeed.price.conf\n );\n\n unchecked {\n i++;\n }\n }\n\n // In the real contract, the input of this function contains multiple batches that each contain multiple prices.\n // This event is emitted when a batch is processed. In this mock contract we consider\n // there is only one batch of prices.\n // Each batch has (chainId, sequenceNumber) as it's unique identifier. Here chainId\n // is set to 1 and an increasing sequence number is used.\n emit BatchPriceFeedUpdate(chainId, sequenceNumber, updateData.length, freshPrices);\n sequenceNumber += 1;\n\n // There is only 1 batch of prices\n emit UpdatePriceFeeds(msg.sender, 1, requiredFee);\n }\n\n function queryPriceFeed(bytes32 id) public view override returns (PythStructs.PriceFeed memory priceFeed) {\n require(priceFeeds[id].id != 0, \"no price feed found for the given price id\");\n return priceFeeds[id];\n }\n\n function priceFeedExists(bytes32 id) public view override returns (bool) {\n return (priceFeeds[id].id != 0);\n }\n\n function getValidTimePeriod() public view override returns (uint256) {\n return validTimePeriod;\n }\n\n function getUpdateFee(uint256 updateDataSize) public view override returns (uint256 feeAmount) {\n return singleUpdateFeeInWei * updateDataSize;\n }\n\n function createPriceFeedUpdateData(\n bytes32 id,\n int64 price,\n uint64 conf,\n int32 expo,\n int64 emaPrice,\n uint64 emaConf,\n uint64 publishTime\n ) public pure returns (bytes memory priceFeedData) {\n PythStructs.PriceFeed memory priceFeed;\n\n priceFeed.id = id;\n\n priceFeed.price.price = price;\n priceFeed.price.conf = conf;\n priceFeed.price.expo = expo;\n priceFeed.price.publishTime = publishTime;\n\n priceFeed.emaPrice.price = emaPrice;\n priceFeed.emaPrice.conf = emaConf;\n priceFeed.emaPrice.expo = expo;\n priceFeed.emaPrice.publishTime = publishTime;\n\n priceFeedData = abi.encode(priceFeed);\n }\n}\n" + }, + "contracts/test/MockSFrax.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/ERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\nimport { ISFrax } from \"../interfaces/ISFrax.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\n\ncontract MockSFrax is ERC20, Ownable, ISFrax {\n uint8 private immutable _decimals;\n uint256 public exchangeRate;\n\n constructor(string memory name_, string memory symbol_, uint8 decimals_) ERC20(name_, symbol_) Ownable() {\n _decimals = decimals_;\n }\n\n function faucet(uint256 amount) external {\n _mint(msg.sender, amount);\n }\n\n function setRate(uint256 rate) external onlyOwner {\n exchangeRate = rate;\n }\n\n function convertToAssets(uint256 shares) external view override returns (uint256) {\n return (shares * exchangeRate) / (10 ** uint256(_decimals));\n }\n\n function decimals() public view virtual override(ERC20, ISFrax) returns (uint8) {\n return _decimals;\n }\n}\n" + }, + "contracts/test/MockSimpleOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"../interfaces/OracleInterface.sol\";\n\ncontract MockSimpleOracle is OracleInterface {\n mapping(address => uint256) public prices;\n\n constructor() {\n //\n }\n\n function getUnderlyingPrice(address vToken) external view returns (uint256) {\n return prices[vToken];\n }\n\n function getPrice(address asset) external view returns (uint256) {\n return prices[asset];\n }\n\n function setPrice(address vToken, uint256 price) public {\n prices[vToken] = price;\n }\n}\n\ncontract MockBoundValidator is BoundValidatorInterface {\n mapping(address => bool) public validateResults;\n bool public twapUpdated;\n\n constructor() {\n //\n }\n\n function validatePriceWithAnchorPrice(\n address vToken,\n uint256 reporterPrice,\n uint256 anchorPrice\n ) external view returns (bool) {\n return validateResults[vToken];\n }\n\n function validateAssetPriceWithAnchorPrice(\n address asset,\n uint256 reporterPrice,\n uint256 anchorPrice\n ) external view returns (bool) {\n return validateResults[asset];\n }\n\n function setValidateResult(address token, bool pass) public {\n validateResults[token] = pass;\n }\n}\n" + }, + "contracts/test/MockV3Aggregator.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"@chainlink/contracts/src/v0.8/interfaces/AggregatorV2V3Interface.sol\";\n\n/**\n * @title MockV3Aggregator\n * @notice Based on the FluxAggregator contract\n * @notice Use this contract when you need to test\n * other contract's ability to read data from an\n * aggregator contract, but how the aggregator got\n * its answer is unimportant\n */\ncontract MockV3Aggregator is AggregatorV2V3Interface {\n uint256 public constant version = 0;\n\n uint8 public decimals;\n int256 public latestAnswer;\n uint256 public latestTimestamp;\n uint256 public latestRound;\n\n mapping(uint256 => int256) public getAnswer;\n mapping(uint256 => uint256) public getTimestamp;\n mapping(uint256 => uint256) private getStartedAt;\n\n constructor(uint8 _decimals, int256 _initialAnswer) {\n decimals = _decimals;\n updateAnswer(_initialAnswer);\n }\n\n function getRoundData(\n uint80 _roundId\n )\n external\n view\n returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)\n {\n return (_roundId, getAnswer[_roundId], getStartedAt[_roundId], getTimestamp[_roundId], _roundId);\n }\n\n function latestRoundData()\n external\n view\n returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)\n {\n return (\n uint80(latestRound),\n getAnswer[latestRound],\n getStartedAt[latestRound],\n getTimestamp[latestRound],\n uint80(latestRound)\n );\n }\n\n function description() external pure returns (string memory) {\n return \"v0.6/tests/MockV3Aggregator.sol\";\n }\n\n function updateAnswer(int256 _answer) public {\n latestAnswer = _answer;\n latestTimestamp = block.timestamp;\n latestRound++;\n getAnswer[latestRound] = _answer;\n getTimestamp[latestRound] = block.timestamp;\n getStartedAt[latestRound] = block.timestamp;\n }\n\n function updateRoundData(uint80 _roundId, int256 _answer, uint256 _timestamp, uint256 _startedAt) public {\n latestRound = _roundId;\n latestAnswer = _answer;\n latestTimestamp = _timestamp;\n getAnswer[latestRound] = _answer;\n getTimestamp[latestRound] = _timestamp;\n getStartedAt[latestRound] = _startedAt;\n }\n}\n" + }, + "contracts/test/MockWBETH.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/ERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\nimport { IWBETH } from \"../interfaces/IWBETH.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\n\ncontract MockWBETH is ERC20, Ownable, IWBETH {\n uint8 private immutable _decimals;\n uint256 public override exchangeRate;\n\n constructor(string memory name_, string memory symbol_, uint8 decimals_) ERC20(name_, symbol_) Ownable() {\n _decimals = decimals_;\n }\n\n function faucet(uint256 amount) external {\n _mint(msg.sender, amount);\n }\n\n function setExchangeRate(uint256 rate) external onlyOwner {\n exchangeRate = rate;\n }\n\n function decimals() public view virtual override(ERC20, IWBETH) returns (uint8) {\n return _decimals;\n }\n}\n" + }, + "contracts/test/PancakePairHarness.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\n// a library for performing various math operations\n\nlibrary Math {\n function min(uint256 x, uint256 y) internal pure returns (uint256 z) {\n z = x < y ? x : y;\n }\n\n // babylonian method (https://en.wikipedia.org/wiki/Methods_of_computing_square_roots#Babylonian_method)\n function sqrt(uint256 y) internal pure returns (uint256 z) {\n if (y > 3) {\n z = y;\n uint256 x = y / 2 + 1;\n while (x < z) {\n z = x;\n x = (y / x + x) / 2;\n }\n } else if (y != 0) {\n z = 1;\n }\n }\n}\n\n// range: [0, 2**112 - 1]\n// resolution: 1 / 2**112\n\nlibrary UQ112x112 {\n //solhint-disable-next-line state-visibility\n uint224 constant Q112 = 2 ** 112;\n\n // encode a uint112 as a UQ112x112\n function encode(uint112 y) internal pure returns (uint224 z) {\n z = uint224(y) * Q112; // never overflows\n }\n\n // divide a UQ112x112 by a uint112, returning a UQ112x112\n function uqdiv(uint224 x, uint112 y) internal pure returns (uint224 z) {\n z = x / uint224(y);\n }\n}\n\ncontract PancakePairHarness {\n using UQ112x112 for uint224;\n\n address public token0;\n address public token1;\n\n uint112 private reserve0; // uses single storage slot, accessible via getReserves\n uint112 private reserve1; // uses single storage slot, accessible via getReserves\n uint32 private blockTimestampLast; // uses single storage slot, accessible via getReserves\n\n uint256 public price0CumulativeLast;\n uint256 public price1CumulativeLast;\n uint256 public kLast; // reserve0 * reserve1, as of immediately after the most recent liquidity event\n\n // called once by the factory at time of deployment\n function initialize(address _token0, address _token1) external {\n token0 = _token0;\n token1 = _token1;\n }\n\n // update reserves and, on the first call per block, price accumulators\n function update(uint256 balance0, uint256 balance1, uint112 _reserve0, uint112 _reserve1) external {\n require(balance0 <= type(uint112).max && balance1 <= type(uint112).max, \"PancakeV2: OVERFLOW\");\n uint32 blockTimestamp = uint32(block.timestamp % 2 ** 32);\n unchecked {\n uint32 timeElapsed = blockTimestamp - blockTimestampLast; // overflow is desired\n if (timeElapsed > 0 && _reserve0 != 0 && _reserve1 != 0) {\n // * never overflows, and + overflow is desired\n price0CumulativeLast += uint256(UQ112x112.encode(_reserve1).uqdiv(_reserve0)) * timeElapsed;\n price1CumulativeLast += uint256(UQ112x112.encode(_reserve0).uqdiv(_reserve1)) * timeElapsed;\n }\n }\n reserve0 = uint112(balance0);\n reserve1 = uint112(balance1);\n blockTimestampLast = blockTimestamp;\n }\n\n function currentBlockTimestamp() external view returns (uint32) {\n return uint32(block.timestamp % 2 ** 32);\n }\n\n function getReserves() public view returns (uint112 _reserve0, uint112 _reserve1, uint32 _blockTimestampLast) {\n _reserve0 = reserve0;\n _reserve1 = reserve1;\n _blockTimestampLast = blockTimestampLast;\n }\n}\n" + }, + "contracts/test/VBEP20Harness.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"./BEP20Harness.sol\";\n\ncontract VBEP20Harness is BEP20Harness {\n /**\n * @notice Underlying asset for this VToken\n */\n address public underlying;\n\n constructor(\n string memory name_,\n string memory symbol_,\n uint8 decimals,\n address underlying_\n ) BEP20Harness(name_, symbol_, decimals) {\n underlying = underlying_;\n }\n}\n" + } + }, + "settings": { + "optimizer": { + "enabled": true, + "runs": 200, + "details": { + "yul": true + } + }, + "evmVersion": "paris", + "outputSelection": { + "*": { + "*": [ + "storageLayout", + "abi", + "evm.bytecode", + "evm.deployedBytecode", + "evm.methodIdentifiers", + "metadata", + "devdoc", + "userdoc", + "evm.gasEstimates" + ], + "": ["ast"] + } + }, + "metadata": { + "useLiteralContent": true + } + } +} diff --git a/deployments/sepolia/MockSfrxEthFraxOracle.json b/deployments/sepolia/MockSfrxEthFraxOracle.json new file mode 100644 index 00000000..41a1dcb5 --- /dev/null +++ b/deployments/sepolia/MockSfrxEthFraxOracle.json @@ -0,0 +1,257 @@ +{ + "address": "0x96f7FD1d922Bb6769773BeC88BE6aA615DE77ad1", + "abi": [ + { + "inputs": [], + "stateMutability": "nonpayable", + "type": "constructor" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "inputs": [], + "name": "getPrices", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + }, + { + "internalType": "uint256", + "name": "", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "isBadData", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "priceHigh", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "priceLow", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "bool", + "name": "_isBadData", + "type": "bool" + }, + { + "internalType": "uint256", + "name": "_priceLow", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "_priceHigh", + "type": "uint256" + } + ], + "name": "setPrices", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + } + ], + "transactionHash": "0x99e481298daec42fa544f155a24f0136f60ab69c138eeac26abd69c79d196fb6", + "receipt": { + "to": null, + "from": "0x464779C41C5f1Be598853C1F87bCC7087Ea75f28", + "contractAddress": "0x96f7FD1d922Bb6769773BeC88BE6aA615DE77ad1", + "transactionIndex": 35, + "gasUsed": "264189", + "logsBloom": "0x00200000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001008000000000000000800000000000000000020000000000000000000800000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000020000000000000400000000000000000000000000000000000010000000000000000", + "blockHash": "0x2e1e7530d43a3653dffca0881086bee3eec8ed312277f11efd95646cae80c8f6", + "transactionHash": "0x99e481298daec42fa544f155a24f0136f60ab69c138eeac26abd69c79d196fb6", + "logs": [ + { + "transactionIndex": 35, + "blockNumber": 6076948, + "transactionHash": "0x99e481298daec42fa544f155a24f0136f60ab69c138eeac26abd69c79d196fb6", + "address": "0x96f7FD1d922Bb6769773BeC88BE6aA615DE77ad1", + "topics": [ + "0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0", + "0x0000000000000000000000000000000000000000000000000000000000000000", + "0x000000000000000000000000464779c41c5f1be598853c1f87bcc7087ea75f28" + ], + "data": "0x", + "logIndex": 114, + "blockHash": "0x2e1e7530d43a3653dffca0881086bee3eec8ed312277f11efd95646cae80c8f6" + } + ], + "blockNumber": 6076948, + "cumulativeGasUsed": "5870057", + "status": 1, + "byzantium": true + }, + "args": [], + "numDeployments": 1, + "solcInputHash": "04e4e9272baf051bc64349e36ce2636f", + "metadata": "{\"compiler\":{\"version\":\"0.8.25+commit.b61c2a91\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferred\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"getPrices\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"isBadData\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"priceHigh\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"priceLow\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"renounceOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bool\",\"name\":\"_isBadData\",\"type\":\"bool\"},{\"internalType\":\"uint256\",\"name\":\"_priceLow\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"_priceHigh\",\"type\":\"uint256\"}],\"name\":\"setPrices\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"transferOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}],\"devdoc\":{\"kind\":\"dev\",\"methods\":{\"owner()\":{\"details\":\"Returns the address of the current owner.\"},\"renounceOwnership()\":{\"details\":\"Leaves the contract without owner. It will not be possible to call `onlyOwner` functions. Can only be called by the current owner. NOTE: Renouncing ownership will leave the contract without an owner, thereby disabling any functionality that is only available to the owner.\"},\"transferOwnership(address)\":{\"details\":\"Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner.\"}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{},\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/oracles/mocks/MockSFrxEthFraxOracle.sol\":\"MockSfrxEthFraxOracle\"},\"evmVersion\":\"paris\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts/access/Ownable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which provides a basic access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership}.\\n *\\n * This module is used through inheritance. It will make available the modifier\\n * `onlyOwner`, which can be applied to your functions to restrict their use to\\n * the owner.\\n */\\nabstract contract Ownable is Context {\\n address private _owner;\\n\\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial owner.\\n */\\n constructor() {\\n _transferOwnership(_msgSender());\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the owner.\\n */\\n modifier onlyOwner() {\\n _checkOwner();\\n _;\\n }\\n\\n /**\\n * @dev Returns the address of the current owner.\\n */\\n function owner() public view virtual returns (address) {\\n return _owner;\\n }\\n\\n /**\\n * @dev Throws if the sender is not the owner.\\n */\\n function _checkOwner() internal view virtual {\\n require(owner() == _msgSender(), \\\"Ownable: caller is not the owner\\\");\\n }\\n\\n /**\\n * @dev Leaves the contract without owner. It will not be possible to call\\n * `onlyOwner` functions. Can only be called by the current owner.\\n *\\n * NOTE: Renouncing ownership will leave the contract without an owner,\\n * thereby disabling any functionality that is only available to the owner.\\n */\\n function renounceOwnership() public virtual onlyOwner {\\n _transferOwnership(address(0));\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual onlyOwner {\\n require(newOwner != address(0), \\\"Ownable: new owner is the zero address\\\");\\n _transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual {\\n address oldOwner = _owner;\\n _owner = newOwner;\\n emit OwnershipTransferred(oldOwner, newOwner);\\n }\\n}\\n\",\"keccak256\":\"0xba43b97fba0d32eb4254f6a5a297b39a19a247082a02d6e69349e071e2946218\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Context.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract Context {\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n}\\n\",\"keccak256\":\"0xe2e337e6dde9ef6b680e07338c493ebea1b5fd09b43424112868e9cc1706bca7\",\"license\":\"MIT\"},\"contracts/interfaces/ISfrxEthFraxOracle.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\ninterface ISfrxEthFraxOracle {\\n function getPrices() external view returns (bool _isbadData, uint256 _priceLow, uint256 _priceHigh);\\n}\\n\",\"keccak256\":\"0x1444fbcfe658b985041e7ca5da6cce92fd143ca46d9793316ab2ef542fbde87a\",\"license\":\"BSD-3-Clause\"},\"contracts/oracles/mocks/MockSFrxEthFraxOracle.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\nimport \\\"../../interfaces/ISfrxEthFraxOracle.sol\\\";\\nimport \\\"@openzeppelin/contracts/access/Ownable.sol\\\";\\n\\ncontract MockSfrxEthFraxOracle is ISfrxEthFraxOracle, Ownable {\\n bool public isBadData;\\n uint256 public priceLow;\\n uint256 public priceHigh;\\n\\n constructor() Ownable() {}\\n\\n function setPrices(bool _isBadData, uint256 _priceLow, uint256 _priceHigh) external onlyOwner {\\n isBadData = _isBadData;\\n priceLow = _priceLow;\\n priceHigh = _priceHigh;\\n }\\n\\n function getPrices() external view override returns (bool, uint256, uint256) {\\n return (isBadData, priceLow, priceHigh);\\n }\\n}\\n\",\"keccak256\":\"0xe4f649d490f0db9a32355b6de0db20f23e4ee8b475e9bef78bb34ca48c2136af\",\"license\":\"BSD-3-Clause\"}},\"version\":1}", + "bytecode": "0x6080604052348015600f57600080fd5b50601733601b565b606b565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b61035c8061007a6000396000f3fe608060405234801561001057600080fd5b50600436106100885760003560e01c80638da5cb5b1161005b5780638da5cb5b146100ea578063bd9a548b14610105578063be00a66e14610137578063f2fde38b1461014057600080fd5b80630683e4ca1461008d5780632ade707e146100a95780635648718b146100be578063715018a6146100e2575b600080fd5b61009660015481565b6040519081526020015b60405180910390f35b6100bc6100b73660046102bc565b610153565b005b6000546100d290600160a01b900460ff1681565b60405190151581526020016100a0565b6100bc610180565b6000546040516001600160a01b0390911681526020016100a0565b600054600154600254600160a01b90920460ff16916040805193151584526020840192909252908201526060016100a0565b61009660025481565b6100bc61014e3660046102f6565b610194565b61015b610212565b60008054931515600160a01b0260ff60a01b1990941693909317909255600155600255565b610188610212565b610192600061026c565b565b61019c610212565b6001600160a01b0381166102065760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b60648201526084015b60405180910390fd5b61020f8161026c565b50565b6000546001600160a01b031633146101925760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016101fd565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b6000806000606084860312156102d157600080fd5b833580151581146102e157600080fd5b95602085013595506040909401359392505050565b60006020828403121561030857600080fd5b81356001600160a01b038116811461031f57600080fd5b939250505056fea26469706673582212202d2484c3cea77127165a22bbf682ff3c65ff59351185afdd645731643734cc1d64736f6c63430008190033", + "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100885760003560e01c80638da5cb5b1161005b5780638da5cb5b146100ea578063bd9a548b14610105578063be00a66e14610137578063f2fde38b1461014057600080fd5b80630683e4ca1461008d5780632ade707e146100a95780635648718b146100be578063715018a6146100e2575b600080fd5b61009660015481565b6040519081526020015b60405180910390f35b6100bc6100b73660046102bc565b610153565b005b6000546100d290600160a01b900460ff1681565b60405190151581526020016100a0565b6100bc610180565b6000546040516001600160a01b0390911681526020016100a0565b600054600154600254600160a01b90920460ff16916040805193151584526020840192909252908201526060016100a0565b61009660025481565b6100bc61014e3660046102f6565b610194565b61015b610212565b60008054931515600160a01b0260ff60a01b1990941693909317909255600155600255565b610188610212565b610192600061026c565b565b61019c610212565b6001600160a01b0381166102065760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b60648201526084015b60405180910390fd5b61020f8161026c565b50565b6000546001600160a01b031633146101925760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016101fd565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b6000806000606084860312156102d157600080fd5b833580151581146102e157600080fd5b95602085013595506040909401359392505050565b60006020828403121561030857600080fd5b81356001600160a01b038116811461031f57600080fd5b939250505056fea26469706673582212202d2484c3cea77127165a22bbf682ff3c65ff59351185afdd645731643734cc1d64736f6c63430008190033", + "devdoc": { + "kind": "dev", + "methods": { + "owner()": { + "details": "Returns the address of the current owner." + }, + "renounceOwnership()": { + "details": "Leaves the contract without owner. It will not be possible to call `onlyOwner` functions. Can only be called by the current owner. NOTE: Renouncing ownership will leave the contract without an owner, thereby disabling any functionality that is only available to the owner." + }, + "transferOwnership(address)": { + "details": "Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner." + } + }, + "version": 1 + }, + "userdoc": { + "kind": "user", + "methods": {}, + "version": 1 + }, + "storageLayout": { + "storage": [ + { + "astId": 1405, + "contract": "contracts/oracles/mocks/MockSFrxEthFraxOracle.sol:MockSfrxEthFraxOracle", + "label": "_owner", + "offset": 0, + "slot": "0", + "type": "t_address" + }, + { + "astId": 10013, + "contract": "contracts/oracles/mocks/MockSFrxEthFraxOracle.sol:MockSfrxEthFraxOracle", + "label": "isBadData", + "offset": 20, + "slot": "0", + "type": "t_bool" + }, + { + "astId": 10015, + "contract": "contracts/oracles/mocks/MockSFrxEthFraxOracle.sol:MockSfrxEthFraxOracle", + "label": "priceLow", + "offset": 0, + "slot": "1", + "type": "t_uint256" + }, + { + "astId": 10017, + "contract": "contracts/oracles/mocks/MockSFrxEthFraxOracle.sol:MockSfrxEthFraxOracle", + "label": "priceHigh", + "offset": 0, + "slot": "2", + "type": "t_uint256" + } + ], + "types": { + "t_address": { + "encoding": "inplace", + "label": "address", + "numberOfBytes": "20" + }, + "t_bool": { + "encoding": "inplace", + "label": "bool", + "numberOfBytes": "1" + }, + "t_uint256": { + "encoding": "inplace", + "label": "uint256", + "numberOfBytes": "32" + } + } + } +} diff --git a/deployments/sepolia/SFrxETHOracle.json b/deployments/sepolia/SFrxETHOracle.json new file mode 100644 index 00000000..f432d76b --- /dev/null +++ b/deployments/sepolia/SFrxETHOracle.json @@ -0,0 +1,517 @@ +{ + "address": "0x6E202555f0CA6558118C67150e16fbf89080eB3b", + "abi": [ + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "previousAdmin", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "AdminChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "beacon", + "type": "address" + } + ], + "name": "BeaconUpgraded", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "implementation", + "type": "address" + } + ], + "name": "Upgraded", + "type": "event" + }, + { + "stateMutability": "payable", + "type": "fallback" + }, + { + "inputs": [], + "name": "admin", + "outputs": [ + { + "internalType": "address", + "name": "admin_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "implementation", + "outputs": [ + { + "internalType": "address", + "name": "implementation_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + } + ], + "name": "upgradeTo", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + }, + { + "internalType": "bytes", + "name": "data", + "type": "bytes" + } + ], + "name": "upgradeToAndCall", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "stateMutability": "payable", + "type": "receive" + }, + { + "inputs": [], + "name": "BadPriceData", + "type": "error" + }, + { + "inputs": [], + "name": "InvalidTokenAddress", + "type": "error" + }, + { + "inputs": [], + "name": "PriceDifferenceExceeded", + "type": "error" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "sender", + "type": "address" + }, + { + "internalType": "address", + "name": "calledContract", + "type": "address" + }, + { + "internalType": "string", + "name": "methodSignature", + "type": "string" + } + ], + "name": "Unauthorized", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroAddressNotAllowed", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroValueNotAllowed", + "type": "error" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint8", + "name": "version", + "type": "uint8" + } + ], + "name": "Initialized", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint256", + "name": "oldMaxAllowedPriceDifference", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newMaxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "MaxAllowedPriceDifferenceUpdated", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "oldAccessControlManager", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAccessControlManager", + "type": "address" + } + ], + "name": "NewAccessControlManager", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferStarted", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "inputs": [], + "name": "SFRXETH", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "SFRXETH_FRAX_ORACLE", + "outputs": [ + { + "internalType": "contract ISfrxEthFraxOracle", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "acceptOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "accessControlManager", + "outputs": [ + { + "internalType": "contract IAccessControlManagerV8", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "asset", + "type": "address" + } + ], + "name": "getPrice", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_accessControlManager", + "type": "address" + }, + { + "internalType": "uint256", + "name": "_maxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "initialize", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "maxAllowedPriceDifference", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "pendingOwner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "name": "setAccessControlManager", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint256", + "name": "_maxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "setMaxAllowedPriceDifference", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_logic", + "type": "address" + }, + { + "internalType": "address", + "name": "admin_", + "type": "address" + }, + { + "internalType": "bytes", + "name": "_data", + "type": "bytes" + } + ], + "stateMutability": "payable", + "type": "constructor" + } + ], + "transactionHash": "0x2a81a6e3087eb84fa08aee42730b4c9edea8953456cf674ce3da963b201e65bf", + "receipt": { + "to": null, + "from": "0x464779C41C5f1Be598853C1F87bCC7087Ea75f28", + "contractAddress": "0x6E202555f0CA6558118C67150e16fbf89080eB3b", + "transactionIndex": 59, + "gasUsed": "622245", + "logsBloom": "0x00000000000000000000000000000000400000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000800000000000000000000080000000000000800000004000000000000000000000000000000000000000000000000000000000000000000024000000020000000000000000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "blockHash": "0x98a844c9330d6c98dcfb1f0039d9dbf16a9e8259922e2f08c712e4aee215e3fc", + "transactionHash": "0x2a81a6e3087eb84fa08aee42730b4c9edea8953456cf674ce3da963b201e65bf", + "logs": [ + { + "transactionIndex": 59, + "blockNumber": 6076954, + "transactionHash": "0x2a81a6e3087eb84fa08aee42730b4c9edea8953456cf674ce3da963b201e65bf", + "address": "0x6E202555f0CA6558118C67150e16fbf89080eB3b", + "topics": [ + "0xbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b", + "0x00000000000000000000000022f55239fe27ce429be407a1a9dd90365188b647" + ], + "data": "0x", + "logIndex": 157, + "blockHash": "0x98a844c9330d6c98dcfb1f0039d9dbf16a9e8259922e2f08c712e4aee215e3fc" + }, + { + "transactionIndex": 59, + "blockNumber": 6076954, + "transactionHash": "0x2a81a6e3087eb84fa08aee42730b4c9edea8953456cf674ce3da963b201e65bf", + "address": "0x6E202555f0CA6558118C67150e16fbf89080eB3b", + "topics": ["0x7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f"], + "data": "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001435866babd91311b1355cf3af488cca36db68e", + "logIndex": 158, + "blockHash": "0x98a844c9330d6c98dcfb1f0039d9dbf16a9e8259922e2f08c712e4aee215e3fc" + } + ], + "blockNumber": 6076954, + "cumulativeGasUsed": "11583687", + "status": 1, + "byzantium": true + }, + "args": ["0x22F55239FE27cE429be407A1a9dD90365188B647", "0x01435866babd91311b1355cf3af488cca36db68e", "0x"], + "numDeployments": 1, + "solcInputHash": "0e89febeebc7444140de8e67c9067d2c", + "metadata": "{\"compiler\":{\"version\":\"0.8.10+commit.fc410830\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_logic\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"admin_\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"_data\",\"type\":\"bytes\"}],\"stateMutability\":\"payable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"previousAdmin\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"AdminChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"beacon\",\"type\":\"address\"}],\"name\":\"BeaconUpgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"implementation\",\"type\":\"address\"}],\"name\":\"Upgraded\",\"type\":\"event\"},{\"stateMutability\":\"payable\",\"type\":\"fallback\"},{\"inputs\":[],\"name\":\"admin\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"admin_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"implementation\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"implementation_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"}],\"name\":\"upgradeTo\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"upgradeToAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"stateMutability\":\"payable\",\"type\":\"receive\"}],\"devdoc\":{\"details\":\"This contract implements a proxy that is upgradeable by an admin. To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector clashing], which can potentially be used in an attack, this contract uses the https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two things that go hand in hand: 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if that call matches one of the admin functions exposed by the proxy itself. 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the implementation. If the admin tries to call a function on the implementation it will fail with an error that says \\\"admin cannot fallback to proxy target\\\". These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due to sudden errors when trying to call a function from the proxy implementation. Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way, you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.\",\"kind\":\"dev\",\"methods\":{\"admin()\":{\"details\":\"Returns the current admin. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`\"},\"constructor\":{\"details\":\"Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.\"},\"implementation()\":{\"details\":\"Returns the current implementation. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`\"},\"upgradeTo(address)\":{\"details\":\"Upgrade the implementation of the proxy. NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.\"},\"upgradeToAndCall(address,bytes)\":{\"details\":\"Upgrade the implementation of the proxy, and then call a function from the new implementation as specified by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the proxied contract. NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.\"}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{},\"version\":1}},\"settings\":{\"compilationTarget\":{\"solc_0.8/proxy/OptimizedTransparentUpgradeableProxy.sol\":\"OptimizedTransparentUpgradeableProxy\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":999999},\"remappings\":[]},\"sources\":{\"solc_0.8/openzeppelin/interfaces/draft-IERC1822.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (interfaces/draft-IERC1822.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified\\n * proxy whose upgrades are fully controlled by the current implementation.\\n */\\ninterface IERC1822Proxiable {\\n /**\\n * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation\\n * address.\\n *\\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\\n * function revert if invoked through a proxy.\\n */\\n function proxiableUUID() external view returns (bytes32);\\n}\\n\",\"keccak256\":\"0x93b4e21c931252739a1ec13ea31d3d35a5c068be3163ccab83e4d70c40355f03\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/ERC1967/ERC1967Proxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/ERC1967/ERC1967Proxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../Proxy.sol\\\";\\nimport \\\"./ERC1967Upgrade.sol\\\";\\n\\n/**\\n * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an\\n * implementation address that can be changed. This address is stored in storage in the location specified by\\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the\\n * implementation behind the proxy.\\n */\\ncontract ERC1967Proxy is Proxy, ERC1967Upgrade {\\n /**\\n * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.\\n *\\n * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded\\n * function call, and allows initializating the storage of the proxy like a Solidity constructor.\\n */\\n constructor(address _logic, bytes memory _data) payable {\\n assert(_IMPLEMENTATION_SLOT == bytes32(uint256(keccak256(\\\"eip1967.proxy.implementation\\\")) - 1));\\n _upgradeToAndCall(_logic, _data, false);\\n }\\n\\n /**\\n * @dev Returns the current implementation address.\\n */\\n function _implementation() internal view virtual override returns (address impl) {\\n return ERC1967Upgrade._getImplementation();\\n }\\n}\\n\",\"keccak256\":\"0x6309f9f39dc6f4f45a24f296543867aa358e32946cd6b2874627a996d606b3a0\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/ERC1967/ERC1967Upgrade.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/ERC1967/ERC1967Upgrade.sol)\\n\\npragma solidity ^0.8.2;\\n\\nimport \\\"../beacon/IBeacon.sol\\\";\\nimport \\\"../../interfaces/draft-IERC1822.sol\\\";\\nimport \\\"../../utils/Address.sol\\\";\\nimport \\\"../../utils/StorageSlot.sol\\\";\\n\\n/**\\n * @dev This abstract contract provides getters and event emitting update functions for\\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.\\n *\\n * _Available since v4.1._\\n *\\n * @custom:oz-upgrades-unsafe-allow delegatecall\\n */\\nabstract contract ERC1967Upgrade {\\n // This is the keccak-256 hash of \\\"eip1967.proxy.rollback\\\" subtracted by 1\\n bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;\\n\\n /**\\n * @dev Storage slot with the address of the current implementation.\\n * This is the keccak-256 hash of \\\"eip1967.proxy.implementation\\\" subtracted by 1, and is\\n * validated in the constructor.\\n */\\n bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n\\n /**\\n * @dev Emitted when the implementation is upgraded.\\n */\\n event Upgraded(address indexed implementation);\\n\\n /**\\n * @dev Returns the current implementation address.\\n */\\n function _getImplementation() internal view returns (address) {\\n return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new address in the EIP1967 implementation slot.\\n */\\n function _setImplementation(address newImplementation) private {\\n require(Address.isContract(newImplementation), \\\"ERC1967: new implementation is not a contract\\\");\\n StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\\n }\\n\\n /**\\n * @dev Perform implementation upgrade\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeTo(address newImplementation) internal {\\n _setImplementation(newImplementation);\\n emit Upgraded(newImplementation);\\n }\\n\\n /**\\n * @dev Perform implementation upgrade with additional setup call.\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeToAndCall(\\n address newImplementation,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n _upgradeTo(newImplementation);\\n if (data.length > 0 || forceCall) {\\n Address.functionDelegateCall(newImplementation, data);\\n }\\n }\\n\\n /**\\n * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeToAndCallUUPS(\\n address newImplementation,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n // Upgrades from old implementations will perform a rollback test. This test requires the new\\n // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing\\n // this special case will break upgrade paths from old UUPS implementation to new ones.\\n if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) {\\n _setImplementation(newImplementation);\\n } else {\\n try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {\\n require(slot == _IMPLEMENTATION_SLOT, \\\"ERC1967Upgrade: unsupported proxiableUUID\\\");\\n } catch {\\n revert(\\\"ERC1967Upgrade: new implementation is not UUPS\\\");\\n }\\n _upgradeToAndCall(newImplementation, data, forceCall);\\n }\\n }\\n\\n /**\\n * @dev Storage slot with the admin of the contract.\\n * This is the keccak-256 hash of \\\"eip1967.proxy.admin\\\" subtracted by 1, and is\\n * validated in the constructor.\\n */\\n bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;\\n\\n /**\\n * @dev Emitted when the admin account has changed.\\n */\\n event AdminChanged(address previousAdmin, address newAdmin);\\n\\n /**\\n * @dev Returns the current admin.\\n */\\n function _getAdmin() internal view virtual returns (address) {\\n return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new address in the EIP1967 admin slot.\\n */\\n function _setAdmin(address newAdmin) private {\\n require(newAdmin != address(0), \\\"ERC1967: new admin is the zero address\\\");\\n StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;\\n }\\n\\n /**\\n * @dev Changes the admin of the proxy.\\n *\\n * Emits an {AdminChanged} event.\\n */\\n function _changeAdmin(address newAdmin) internal {\\n emit AdminChanged(_getAdmin(), newAdmin);\\n _setAdmin(newAdmin);\\n }\\n\\n /**\\n * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.\\n * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.\\n */\\n bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;\\n\\n /**\\n * @dev Emitted when the beacon is upgraded.\\n */\\n event BeaconUpgraded(address indexed beacon);\\n\\n /**\\n * @dev Returns the current beacon.\\n */\\n function _getBeacon() internal view returns (address) {\\n return StorageSlot.getAddressSlot(_BEACON_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new beacon in the EIP1967 beacon slot.\\n */\\n function _setBeacon(address newBeacon) private {\\n require(Address.isContract(newBeacon), \\\"ERC1967: new beacon is not a contract\\\");\\n require(Address.isContract(IBeacon(newBeacon).implementation()), \\\"ERC1967: beacon implementation is not a contract\\\");\\n StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;\\n }\\n\\n /**\\n * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does\\n * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).\\n *\\n * Emits a {BeaconUpgraded} event.\\n */\\n function _upgradeBeaconToAndCall(\\n address newBeacon,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n _setBeacon(newBeacon);\\n emit BeaconUpgraded(newBeacon);\\n if (data.length > 0 || forceCall) {\\n Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x17668652127feebed0ce8d9431ef95ccc8c4292f03e3b8cf06c6ca16af396633\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/Proxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/Proxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM\\n * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to\\n * be specified by overriding the virtual {_implementation} function.\\n *\\n * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a\\n * different contract through the {_delegate} function.\\n *\\n * The success and return data of the delegated call will be returned back to the caller of the proxy.\\n */\\nabstract contract Proxy {\\n /**\\n * @dev Delegates the current call to `implementation`.\\n *\\n * This function does not return to its internal call site, it will return directly to the external caller.\\n */\\n function _delegate(address implementation) internal virtual {\\n assembly {\\n // Copy msg.data. We take full control of memory in this inline assembly\\n // block because it will not return to Solidity code. We overwrite the\\n // Solidity scratch pad at memory position 0.\\n calldatacopy(0, 0, calldatasize())\\n\\n // Call the implementation.\\n // out and outsize are 0 because we don't know the size yet.\\n let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)\\n\\n // Copy the returned data.\\n returndatacopy(0, 0, returndatasize())\\n\\n switch result\\n // delegatecall returns 0 on error.\\n case 0 {\\n revert(0, returndatasize())\\n }\\n default {\\n return(0, returndatasize())\\n }\\n }\\n }\\n\\n /**\\n * @dev This is a virtual function that should be overriden so it returns the address to which the fallback function\\n * and {_fallback} should delegate.\\n */\\n function _implementation() internal view virtual returns (address);\\n\\n /**\\n * @dev Delegates the current call to the address returned by `_implementation()`.\\n *\\n * This function does not return to its internall call site, it will return directly to the external caller.\\n */\\n function _fallback() internal virtual {\\n _beforeFallback();\\n _delegate(_implementation());\\n }\\n\\n /**\\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other\\n * function in the contract matches the call data.\\n */\\n fallback() external payable virtual {\\n _fallback();\\n }\\n\\n /**\\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data\\n * is empty.\\n */\\n receive() external payable virtual {\\n _fallback();\\n }\\n\\n /**\\n * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`\\n * call, or as part of the Solidity `fallback` or `receive` functions.\\n *\\n * If overriden should call `super._beforeFallback()`.\\n */\\n function _beforeFallback() internal virtual {}\\n}\\n\",\"keccak256\":\"0xd5d1fd16e9faff7fcb3a52e02a8d49156f42a38a03f07b5f1810c21c2149a8ab\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/beacon/IBeacon.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev This is the interface that {BeaconProxy} expects of its beacon.\\n */\\ninterface IBeacon {\\n /**\\n * @dev Must return an address that can be used as a delegate call target.\\n *\\n * {BeaconProxy} will check that this address is a contract.\\n */\\n function implementation() external view returns (address);\\n}\\n\",\"keccak256\":\"0xd50a3421ac379ccb1be435fa646d66a65c986b4924f0849839f08692f39dde61\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCall(target, data, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n require(isContract(target), \\\"Address: static call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(isContract(target), \\\"Address: delegate call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n }\\n}\\n\",\"keccak256\":\"0x3777e696b62134e6177440dbe6e6601c0c156a443f57167194b67e75527439de\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/utils/StorageSlot.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/StorageSlot.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Library for reading and writing primitive types to specific storage slots.\\n *\\n * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.\\n * This library helps with reading and writing to such slots without the need for inline assembly.\\n *\\n * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.\\n *\\n * Example usage to set ERC1967 implementation slot:\\n * ```\\n * contract ERC1967 {\\n * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n *\\n * function _getImplementation() internal view returns (address) {\\n * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\\n * }\\n *\\n * function _setImplementation(address newImplementation) internal {\\n * require(Address.isContract(newImplementation), \\\"ERC1967: new implementation is not a contract\\\");\\n * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\\n * }\\n * }\\n * ```\\n *\\n * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._\\n */\\nlibrary StorageSlot {\\n struct AddressSlot {\\n address value;\\n }\\n\\n struct BooleanSlot {\\n bool value;\\n }\\n\\n struct Bytes32Slot {\\n bytes32 value;\\n }\\n\\n struct Uint256Slot {\\n uint256 value;\\n }\\n\\n /**\\n * @dev Returns an `AddressSlot` with member `value` located at `slot`.\\n */\\n function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `BooleanSlot` with member `value` located at `slot`.\\n */\\n function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.\\n */\\n function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `Uint256Slot` with member `value` located at `slot`.\\n */\\n function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n}\\n\",\"keccak256\":\"0xfe1b7a9aa2a530a9e705b220e26cd584e2fbdc9602a3a1066032b12816b46aca\",\"license\":\"MIT\"},\"solc_0.8/proxy/OptimizedTransparentUpgradeableProxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/transparent/TransparentUpgradeableProxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../openzeppelin/proxy/ERC1967/ERC1967Proxy.sol\\\";\\n\\n/**\\n * @dev This contract implements a proxy that is upgradeable by an admin.\\n *\\n * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector\\n * clashing], which can potentially be used in an attack, this contract uses the\\n * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two\\n * things that go hand in hand:\\n *\\n * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if\\n * that call matches one of the admin functions exposed by the proxy itself.\\n * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the\\n * implementation. If the admin tries to call a function on the implementation it will fail with an error that says\\n * \\\"admin cannot fallback to proxy target\\\".\\n *\\n * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing\\n * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due\\n * to sudden errors when trying to call a function from the proxy implementation.\\n *\\n * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,\\n * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.\\n */\\ncontract OptimizedTransparentUpgradeableProxy is ERC1967Proxy {\\n address internal immutable _ADMIN;\\n\\n /**\\n * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and\\n * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.\\n */\\n constructor(\\n address _logic,\\n address admin_,\\n bytes memory _data\\n ) payable ERC1967Proxy(_logic, _data) {\\n assert(_ADMIN_SLOT == bytes32(uint256(keccak256(\\\"eip1967.proxy.admin\\\")) - 1));\\n _ADMIN = admin_;\\n\\n // still store it to work with EIP-1967\\n bytes32 slot = _ADMIN_SLOT;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(slot, admin_)\\n }\\n emit AdminChanged(address(0), admin_);\\n }\\n\\n /**\\n * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.\\n */\\n modifier ifAdmin() {\\n if (msg.sender == _getAdmin()) {\\n _;\\n } else {\\n _fallback();\\n }\\n }\\n\\n /**\\n * @dev Returns the current admin.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.\\n *\\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\\n * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`\\n */\\n function admin() external ifAdmin returns (address admin_) {\\n admin_ = _getAdmin();\\n }\\n\\n /**\\n * @dev Returns the current implementation.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.\\n *\\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\\n * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`\\n */\\n function implementation() external ifAdmin returns (address implementation_) {\\n implementation_ = _implementation();\\n }\\n\\n /**\\n * @dev Upgrade the implementation of the proxy.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.\\n */\\n function upgradeTo(address newImplementation) external ifAdmin {\\n _upgradeToAndCall(newImplementation, bytes(\\\"\\\"), false);\\n }\\n\\n /**\\n * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified\\n * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the\\n * proxied contract.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.\\n */\\n function upgradeToAndCall(address newImplementation, bytes calldata data) external payable ifAdmin {\\n _upgradeToAndCall(newImplementation, data, true);\\n }\\n\\n /**\\n * @dev Returns the current admin.\\n */\\n function _admin() internal view virtual returns (address) {\\n return _getAdmin();\\n }\\n\\n /**\\n * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.\\n */\\n function _beforeFallback() internal virtual override {\\n require(msg.sender != _getAdmin(), \\\"TransparentUpgradeableProxy: admin cannot fallback to proxy target\\\");\\n super._beforeFallback();\\n }\\n\\n function _getAdmin() internal view virtual override returns (address) {\\n return _ADMIN;\\n }\\n}\\n\",\"keccak256\":\"0xa30117644e27fa5b49e162aae2f62b36c1aca02f801b8c594d46e2024963a534\",\"license\":\"MIT\"}},\"version\":1}", + "bytecode": "0x60a060405260405162000f5f38038062000f5f83398101604081905262000026916200044a565b82816200005560017f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbd6200052a565b60008051602062000f188339815191521462000075576200007562000550565b62000083828260006200013c565b50620000b3905060017fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61046200052a565b60008051602062000ef883398151915214620000d357620000d362000550565b6001600160a01b038216608081905260008051602062000ef88339815191528381556040805160008152602081019390935290917f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f910160405180910390a150505050620005b9565b620001478362000179565b600082511180620001555750805b156200017457620001728383620001bb60201b620002a91760201c565b505b505050565b6200018481620001ea565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b6060620001e3838360405180606001604052806027815260200162000f3860279139620002b2565b9392505050565b62000200816200039860201b620002d51760201c565b620002685760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b60648201526084015b60405180910390fd5b806200029160008051602062000f1883398151915260001b620003a760201b620002411760201c565b80546001600160a01b0319166001600160a01b039290921691909117905550565b60606001600160a01b0384163b6200031c5760405162461bcd60e51b815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f6044820152651b9d1c9858dd60d21b60648201526084016200025f565b600080856001600160a01b03168560405162000339919062000566565b600060405180830381855af49150503d806000811462000376576040519150601f19603f3d011682016040523d82523d6000602084013e6200037b565b606091505b5090925090506200038e828286620003aa565b9695505050505050565b6001600160a01b03163b151590565b90565b60608315620003bb575081620001e3565b825115620003cc5782518084602001fd5b8160405162461bcd60e51b81526004016200025f919062000584565b80516001600160a01b03811681146200040057600080fd5b919050565b634e487b7160e01b600052604160045260246000fd5b60005b83811015620004385781810151838201526020016200041e565b83811115620001725750506000910152565b6000806000606084860312156200046057600080fd5b6200046b84620003e8565b92506200047b60208501620003e8565b60408501519092506001600160401b03808211156200049957600080fd5b818601915086601f830112620004ae57600080fd5b815181811115620004c357620004c362000405565b604051601f8201601f19908116603f01168101908382118183101715620004ee57620004ee62000405565b816040528281528960208487010111156200050857600080fd5b6200051b8360208301602088016200041b565b80955050505050509250925092565b6000828210156200054b57634e487b7160e01b600052601160045260246000fd5b500390565b634e487b7160e01b600052600160045260246000fd5b600082516200057a8184602087016200041b565b9190910192915050565b6020815260008251806020840152620005a58160408501602087016200041b565b601f01601f19169190910160400192915050565b608051610900620005f86000396000818161011201528181610176015281816102060152818161025e01528181610287015261030901526109006000f3fe6080604052600436106100435760003560e01c80633659cfe61461005a5780634f1ef2861461007a5780635c60da1b1461008d578063f851a440146100cb57610052565b36610052576100506100e0565b005b6100506100e0565b34801561006657600080fd5b5061005061007536600461076c565b6100fa565b610050610088366004610787565b61015e565b34801561009957600080fd5b506100a26101ec565b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390f35b3480156100d757600080fd5b506100a2610244565b6100e86102f1565b6100f86100f36103e2565b610422565b565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156101565761015381604051806020016040528060008152506000610446565b50565b6101536100e0565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156101e4576101df8383838080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525060019250610446915050565b505050565b6101df6100e0565b60003373ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000161415610239576102346103e2565b905090565b6102416100e0565b90565b60003373ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016141561023957507f000000000000000000000000000000000000000000000000000000000000000090565b60606102ce83836040518060600160405280602781526020016108a460279139610471565b9392505050565b73ffffffffffffffffffffffffffffffffffffffff163b151590565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156100f8576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f7879207461726760648201527f6574000000000000000000000000000000000000000000000000000000000000608482015260a4015b60405180910390fd5b60006102347f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc5473ffffffffffffffffffffffffffffffffffffffff1690565b3660008037600080366000845af43d6000803e808015610441573d6000f35b3d6000fd5b61044f83610599565b60008251118061045c5750805b156101df5761046b83836102a9565b50505050565b606073ffffffffffffffffffffffffffffffffffffffff84163b610517576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f60448201527f6e7472616374000000000000000000000000000000000000000000000000000060648201526084016103d9565b6000808573ffffffffffffffffffffffffffffffffffffffff168560405161053f9190610836565b600060405180830381855af49150503d806000811461057a576040519150601f19603f3d011682016040523d82523d6000602084013e61057f565b606091505b509150915061058f8282866105e6565b9695505050505050565b6105a281610639565b60405173ffffffffffffffffffffffffffffffffffffffff8216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b606083156105f55750816102ce565b8251156106055782518084602001fd5b816040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016103d99190610852565b73ffffffffffffffffffffffffffffffffffffffff81163b6106dd576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201527f6f74206120636f6e74726163740000000000000000000000000000000000000060648201526084016103d9565b7f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc80547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff92909216919091179055565b803573ffffffffffffffffffffffffffffffffffffffff8116811461076757600080fd5b919050565b60006020828403121561077e57600080fd5b6102ce82610743565b60008060006040848603121561079c57600080fd5b6107a584610743565b9250602084013567ffffffffffffffff808211156107c257600080fd5b818601915086601f8301126107d657600080fd5b8135818111156107e557600080fd5b8760208285010111156107f757600080fd5b6020830194508093505050509250925092565b60005b8381101561082557818101518382015260200161080d565b8381111561046b5750506000910152565b6000825161084881846020870161080a565b9190910192915050565b602081526000825180602084015261087181604085016020870161080a565b601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016919091016040019291505056fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a26469706673582212206f70214c51cdd41c05ba0ffeb72b309ca3c8be178fd6e73c12162330799984f364736f6c634300080a0033b53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564", + "deployedBytecode": "0x6080604052600436106100435760003560e01c80633659cfe61461005a5780634f1ef2861461007a5780635c60da1b1461008d578063f851a440146100cb57610052565b36610052576100506100e0565b005b6100506100e0565b34801561006657600080fd5b5061005061007536600461076c565b6100fa565b610050610088366004610787565b61015e565b34801561009957600080fd5b506100a26101ec565b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390f35b3480156100d757600080fd5b506100a2610244565b6100e86102f1565b6100f86100f36103e2565b610422565b565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156101565761015381604051806020016040528060008152506000610446565b50565b6101536100e0565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156101e4576101df8383838080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525060019250610446915050565b505050565b6101df6100e0565b60003373ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000161415610239576102346103e2565b905090565b6102416100e0565b90565b60003373ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016141561023957507f000000000000000000000000000000000000000000000000000000000000000090565b60606102ce83836040518060600160405280602781526020016108a460279139610471565b9392505050565b73ffffffffffffffffffffffffffffffffffffffff163b151590565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156100f8576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f7879207461726760648201527f6574000000000000000000000000000000000000000000000000000000000000608482015260a4015b60405180910390fd5b60006102347f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc5473ffffffffffffffffffffffffffffffffffffffff1690565b3660008037600080366000845af43d6000803e808015610441573d6000f35b3d6000fd5b61044f83610599565b60008251118061045c5750805b156101df5761046b83836102a9565b50505050565b606073ffffffffffffffffffffffffffffffffffffffff84163b610517576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f60448201527f6e7472616374000000000000000000000000000000000000000000000000000060648201526084016103d9565b6000808573ffffffffffffffffffffffffffffffffffffffff168560405161053f9190610836565b600060405180830381855af49150503d806000811461057a576040519150601f19603f3d011682016040523d82523d6000602084013e61057f565b606091505b509150915061058f8282866105e6565b9695505050505050565b6105a281610639565b60405173ffffffffffffffffffffffffffffffffffffffff8216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b606083156105f55750816102ce565b8251156106055782518084602001fd5b816040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016103d99190610852565b73ffffffffffffffffffffffffffffffffffffffff81163b6106dd576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201527f6f74206120636f6e74726163740000000000000000000000000000000000000060648201526084016103d9565b7f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc80547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff92909216919091179055565b803573ffffffffffffffffffffffffffffffffffffffff8116811461076757600080fd5b919050565b60006020828403121561077e57600080fd5b6102ce82610743565b60008060006040848603121561079c57600080fd5b6107a584610743565b9250602084013567ffffffffffffffff808211156107c257600080fd5b818601915086601f8301126107d657600080fd5b8135818111156107e557600080fd5b8760208285010111156107f757600080fd5b6020830194508093505050509250925092565b60005b8381101561082557818101518382015260200161080d565b8381111561046b5750506000910152565b6000825161084881846020870161080a565b9190910192915050565b602081526000825180602084015261087181604085016020870161080a565b601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016919091016040019291505056fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a26469706673582212206f70214c51cdd41c05ba0ffeb72b309ca3c8be178fd6e73c12162330799984f364736f6c634300080a0033", + "implementation": "0x22F55239FE27cE429be407A1a9dD90365188B647", + "devdoc": { + "details": "This contract implements a proxy that is upgradeable by an admin. To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector clashing], which can potentially be used in an attack, this contract uses the https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two things that go hand in hand: 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if that call matches one of the admin functions exposed by the proxy itself. 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the implementation. If the admin tries to call a function on the implementation it will fail with an error that says \"admin cannot fallback to proxy target\". These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due to sudden errors when trying to call a function from the proxy implementation. Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way, you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.", + "kind": "dev", + "methods": { + "admin()": { + "details": "Returns the current admin. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`" + }, + "constructor": { + "details": "Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}." + }, + "implementation()": { + "details": "Returns the current implementation. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`" + }, + "upgradeTo(address)": { + "details": "Upgrade the implementation of the proxy. NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}." + }, + "upgradeToAndCall(address,bytes)": { + "details": "Upgrade the implementation of the proxy, and then call a function from the new implementation as specified by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the proxied contract. NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}." + } + }, + "version": 1 + }, + "userdoc": { + "kind": "user", + "methods": {}, + "version": 1 + }, + "storageLayout": { + "storage": [], + "types": null + } +} diff --git a/deployments/sepolia/SFrxETHOracle_Implementation.json b/deployments/sepolia/SFrxETHOracle_Implementation.json new file mode 100644 index 00000000..6dcb564b --- /dev/null +++ b/deployments/sepolia/SFrxETHOracle_Implementation.json @@ -0,0 +1,620 @@ +{ + "address": "0x22F55239FE27cE429be407A1a9dD90365188B647", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "_sfrxEthFraxOracle", + "type": "address" + }, + { + "internalType": "address", + "name": "_sfrxETH", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "constructor" + }, + { + "inputs": [], + "name": "BadPriceData", + "type": "error" + }, + { + "inputs": [], + "name": "InvalidTokenAddress", + "type": "error" + }, + { + "inputs": [], + "name": "PriceDifferenceExceeded", + "type": "error" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "sender", + "type": "address" + }, + { + "internalType": "address", + "name": "calledContract", + "type": "address" + }, + { + "internalType": "string", + "name": "methodSignature", + "type": "string" + } + ], + "name": "Unauthorized", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroAddressNotAllowed", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroValueNotAllowed", + "type": "error" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint8", + "name": "version", + "type": "uint8" + } + ], + "name": "Initialized", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint256", + "name": "oldMaxAllowedPriceDifference", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newMaxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "MaxAllowedPriceDifferenceUpdated", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "oldAccessControlManager", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAccessControlManager", + "type": "address" + } + ], + "name": "NewAccessControlManager", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferStarted", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "inputs": [], + "name": "SFRXETH", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "SFRXETH_FRAX_ORACLE", + "outputs": [ + { + "internalType": "contract ISfrxEthFraxOracle", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "acceptOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "accessControlManager", + "outputs": [ + { + "internalType": "contract IAccessControlManagerV8", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "asset", + "type": "address" + } + ], + "name": "getPrice", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_accessControlManager", + "type": "address" + }, + { + "internalType": "uint256", + "name": "_maxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "initialize", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "maxAllowedPriceDifference", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "pendingOwner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "name": "setAccessControlManager", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint256", + "name": "_maxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "setMaxAllowedPriceDifference", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + } + ], + "transactionHash": "0x9278ea6168db0980c84970dbdda1376399abb6cb17b58445ca9f6dfd4f501300", + "receipt": { + "to": null, + "from": "0x464779C41C5f1Be598853C1F87bCC7087Ea75f28", + "contractAddress": "0x22F55239FE27cE429be407A1a9dD90365188B647", + "transactionIndex": 31, + "gasUsed": "796005", + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000008000000400000000000000000000000000000000000000000800000004000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "blockHash": "0x9bf1eb5d34391e11b5785539d86a2201809d7bfc22398fc5786c15ef13094187", + "transactionHash": "0x9278ea6168db0980c84970dbdda1376399abb6cb17b58445ca9f6dfd4f501300", + "logs": [ + { + "transactionIndex": 31, + "blockNumber": 6076953, + "transactionHash": "0x9278ea6168db0980c84970dbdda1376399abb6cb17b58445ca9f6dfd4f501300", + "address": "0x22F55239FE27cE429be407A1a9dD90365188B647", + "topics": ["0x7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498"], + "data": "0x00000000000000000000000000000000000000000000000000000000000000ff", + "logIndex": 88, + "blockHash": "0x9bf1eb5d34391e11b5785539d86a2201809d7bfc22398fc5786c15ef13094187" + } + ], + "blockNumber": 6076953, + "cumulativeGasUsed": "6084890", + "status": 1, + "byzantium": true + }, + "args": ["0x96f7FD1d922Bb6769773BeC88BE6aA615DE77ad1", "0x14AECeEc177085fd09EA07348B4E1F7Fcc030fA1"], + "numDeployments": 1, + "solcInputHash": "04e4e9272baf051bc64349e36ce2636f", + "metadata": "{\"compiler\":{\"version\":\"0.8.25+commit.b61c2a91\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_sfrxEthFraxOracle\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_sfrxETH\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[],\"name\":\"BadPriceData\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidTokenAddress\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"PriceDifferenceExceeded\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"sender\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"calledContract\",\"type\":\"address\"},{\"internalType\":\"string\",\"name\":\"methodSignature\",\"type\":\"string\"}],\"name\":\"Unauthorized\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddressNotAllowed\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroValueNotAllowed\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint8\",\"name\":\"version\",\"type\":\"uint8\"}],\"name\":\"Initialized\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"oldMaxAllowedPriceDifference\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"newMaxAllowedPriceDifference\",\"type\":\"uint256\"}],\"name\":\"MaxAllowedPriceDifferenceUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"oldAccessControlManager\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAccessControlManager\",\"type\":\"address\"}],\"name\":\"NewAccessControlManager\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferStarted\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferred\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"SFRXETH\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"SFRXETH_FRAX_ORACLE\",\"outputs\":[{\"internalType\":\"contract ISfrxEthFraxOracle\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"acceptOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"accessControlManager\",\"outputs\":[{\"internalType\":\"contract IAccessControlManagerV8\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"asset\",\"type\":\"address\"}],\"name\":\"getPrice\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_accessControlManager\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_maxAllowedPriceDifference\",\"type\":\"uint256\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"maxAllowedPriceDifference\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pendingOwner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"renounceOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"accessControlManager_\",\"type\":\"address\"}],\"name\":\"setAccessControlManager\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"_maxAllowedPriceDifference\",\"type\":\"uint256\"}],\"name\":\"setMaxAllowedPriceDifference\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"transferOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Venus\",\"events\":{\"Initialized(uint8)\":{\"details\":\"Triggered when the contract has been initialized or reinitialized.\"}},\"kind\":\"dev\",\"methods\":{\"acceptOwnership()\":{\"details\":\"The new owner accepts the ownership transfer.\"},\"constructor\":{\"custom:oz-upgrades-unsafe-allow\":\"constructor\"},\"getPrice(address)\":{\"params\":{\"asset\":\"Address of the sfrxETH token\"},\"returns\":{\"_0\":\"price The price scaled by 1e18\"}},\"initialize(address,uint256)\":{\"params\":{\"_accessControlManager\":\"Address of the access control manager contract\",\"_maxAllowedPriceDifference\":\"Maximum allowed price difference\"}},\"owner()\":{\"details\":\"Returns the address of the current owner.\"},\"pendingOwner()\":{\"details\":\"Returns the address of the pending owner.\"},\"renounceOwnership()\":{\"details\":\"Leaves the contract without owner. It will not be possible to call `onlyOwner` functions. Can only be called by the current owner. NOTE: Renouncing ownership will leave the contract without an owner, thereby disabling any functionality that is only available to the owner.\"},\"setAccessControlManager(address)\":{\"custom:access\":\"Only Governance\",\"custom:event\":\"Emits NewAccessControlManager event\",\"details\":\"Admin function to set address of AccessControlManager\",\"params\":{\"accessControlManager_\":\"The new address of the AccessControlManager\"}},\"setMaxAllowedPriceDifference(uint256)\":{\"params\":{\"_maxAllowedPriceDifference\":\"Maximum allowed price difference\"}},\"transferOwnership(address)\":{\"details\":\"Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one. Can only be called by the current owner.\"}},\"stateVariables\":{\"SFRXETH\":{\"custom:oz-upgrades-unsafe-allow\":\"state-variable-immutable\"},\"SFRXETH_FRAX_ORACLE\":{\"custom:oz-upgrades-unsafe-allow\":\"state-variable-immutable\"}},\"title\":\"SFrxETHOracle\",\"version\":1},\"userdoc\":{\"errors\":{\"BadPriceData()\":[{\"notice\":\"Thrown if the price data is invalid\"}],\"InvalidTokenAddress()\":[{\"notice\":\"Thrown if the token address is invalid\"}],\"PriceDifferenceExceeded()\":[{\"notice\":\"Thrown if the price difference exceeds the allowed limit\"}],\"Unauthorized(address,address,string)\":[{\"notice\":\"Thrown when the action is prohibited by AccessControlManager\"}],\"ZeroAddressNotAllowed()\":[{\"notice\":\"Thrown if the supplied address is a zero address where it is not allowed\"}],\"ZeroValueNotAllowed()\":[{\"notice\":\"Thrown if the supplied value is 0 where it is not allowed\"}]},\"events\":{\"MaxAllowedPriceDifferenceUpdated(uint256,uint256)\":{\"notice\":\"Emits when the maximum allowed price difference is updated\"},\"NewAccessControlManager(address,address)\":{\"notice\":\"Emitted when access control manager contract address is changed\"}},\"kind\":\"user\",\"methods\":{\"SFRXETH()\":{\"notice\":\"Address of sfrxETH\"},\"SFRXETH_FRAX_ORACLE()\":{\"notice\":\"Address of SfrxEthFraxOracle\"},\"accessControlManager()\":{\"notice\":\"Returns the address of the access control manager contract\"},\"constructor\":{\"notice\":\"Constructor for the implementation contract.\"},\"getPrice(address)\":{\"notice\":\"Fetches the USD price of sfrxETH\"},\"initialize(address,uint256)\":{\"notice\":\"Sets the contracts required to fetch prices\"},\"maxAllowedPriceDifference()\":{\"notice\":\"Maximum allowed price difference\"},\"setAccessControlManager(address)\":{\"notice\":\"Sets the address of AccessControlManager\"},\"setMaxAllowedPriceDifference(uint256)\":{\"notice\":\"Sets the maximum allowed price difference\"}},\"notice\":\"This oracle fetches the price of sfrxETH\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/oracles/SFrxETHOracle.sol\":\"SFrxETHOracle\"},\"evmVersion\":\"paris\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable2Step.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"./OwnableUpgradeable.sol\\\";\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Contract module which provides access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership} and {acceptOwnership}.\\n *\\n * This module is used through inheritance. It will make available all functions\\n * from parent (Ownable).\\n */\\nabstract contract Ownable2StepUpgradeable is Initializable, OwnableUpgradeable {\\n function __Ownable2Step_init() internal onlyInitializing {\\n __Ownable_init_unchained();\\n }\\n\\n function __Ownable2Step_init_unchained() internal onlyInitializing {\\n }\\n address private _pendingOwner;\\n\\n event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Returns the address of the pending owner.\\n */\\n function pendingOwner() public view virtual returns (address) {\\n return _pendingOwner;\\n }\\n\\n /**\\n * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual override onlyOwner {\\n _pendingOwner = newOwner;\\n emit OwnershipTransferStarted(owner(), newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual override {\\n delete _pendingOwner;\\n super._transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev The new owner accepts the ownership transfer.\\n */\\n function acceptOwnership() public virtual {\\n address sender = _msgSender();\\n require(pendingOwner() == sender, \\\"Ownable2Step: caller is not the new owner\\\");\\n _transferOwnership(sender);\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n}\\n\",\"keccak256\":\"0x84efb8889801b0ac817324aff6acc691d07bbee816b671817132911d287a8c63\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/ContextUpgradeable.sol\\\";\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Contract module which provides a basic access control mechanism, where\\n * there is an account (an owner) that can be granted exclusive access to\\n * specific functions.\\n *\\n * By default, the owner account will be the one that deploys the contract. This\\n * can later be changed with {transferOwnership}.\\n *\\n * This module is used through inheritance. It will make available the modifier\\n * `onlyOwner`, which can be applied to your functions to restrict their use to\\n * the owner.\\n */\\nabstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {\\n address private _owner;\\n\\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial owner.\\n */\\n function __Ownable_init() internal onlyInitializing {\\n __Ownable_init_unchained();\\n }\\n\\n function __Ownable_init_unchained() internal onlyInitializing {\\n _transferOwnership(_msgSender());\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the owner.\\n */\\n modifier onlyOwner() {\\n _checkOwner();\\n _;\\n }\\n\\n /**\\n * @dev Returns the address of the current owner.\\n */\\n function owner() public view virtual returns (address) {\\n return _owner;\\n }\\n\\n /**\\n * @dev Throws if the sender is not the owner.\\n */\\n function _checkOwner() internal view virtual {\\n require(owner() == _msgSender(), \\\"Ownable: caller is not the owner\\\");\\n }\\n\\n /**\\n * @dev Leaves the contract without owner. It will not be possible to call\\n * `onlyOwner` functions. Can only be called by the current owner.\\n *\\n * NOTE: Renouncing ownership will leave the contract without an owner,\\n * thereby disabling any functionality that is only available to the owner.\\n */\\n function renounceOwnership() public virtual onlyOwner {\\n _transferOwnership(address(0));\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Can only be called by the current owner.\\n */\\n function transferOwnership(address newOwner) public virtual onlyOwner {\\n require(newOwner != address(0), \\\"Ownable: new owner is the zero address\\\");\\n _transferOwnership(newOwner);\\n }\\n\\n /**\\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\\n * Internal function without access restriction.\\n */\\n function _transferOwnership(address newOwner) internal virtual {\\n address oldOwner = _owner;\\n _owner = newOwner;\\n emit OwnershipTransferred(oldOwner, newOwner);\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n}\\n\",\"keccak256\":\"0x4075622496acc77fd6d4de4cc30a8577a744d5c75afad33fdeacf1704d6eda98\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\\n\\npragma solidity ^0.8.2;\\n\\nimport \\\"../../utils/AddressUpgradeable.sol\\\";\\n\\n/**\\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\\n *\\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\\n * reused. This mechanism prevents re-execution of each \\\"step\\\" but allows the creation of new initialization steps in\\n * case an upgrade adds a module that needs to be initialized.\\n *\\n * For example:\\n *\\n * [.hljs-theme-light.nopadding]\\n * ```solidity\\n * contract MyToken is ERC20Upgradeable {\\n * function initialize() initializer public {\\n * __ERC20_init(\\\"MyToken\\\", \\\"MTK\\\");\\n * }\\n * }\\n *\\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\\n * function initializeV2() reinitializer(2) public {\\n * __ERC20Permit_init(\\\"MyToken\\\");\\n * }\\n * }\\n * ```\\n *\\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\\n *\\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\\n *\\n * [CAUTION]\\n * ====\\n * Avoid leaving a contract uninitialized.\\n *\\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\\n *\\n * [.hljs-theme-light.nopadding]\\n * ```\\n * /// @custom:oz-upgrades-unsafe-allow constructor\\n * constructor() {\\n * _disableInitializers();\\n * }\\n * ```\\n * ====\\n */\\nabstract contract Initializable {\\n /**\\n * @dev Indicates that the contract has been initialized.\\n * @custom:oz-retyped-from bool\\n */\\n uint8 private _initialized;\\n\\n /**\\n * @dev Indicates that the contract is in the process of being initialized.\\n */\\n bool private _initializing;\\n\\n /**\\n * @dev Triggered when the contract has been initialized or reinitialized.\\n */\\n event Initialized(uint8 version);\\n\\n /**\\n * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\\n * `onlyInitializing` functions can be used to initialize parent contracts.\\n *\\n * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\\n * constructor.\\n *\\n * Emits an {Initialized} event.\\n */\\n modifier initializer() {\\n bool isTopLevelCall = !_initializing;\\n require(\\n (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\\n \\\"Initializable: contract is already initialized\\\"\\n );\\n _initialized = 1;\\n if (isTopLevelCall) {\\n _initializing = true;\\n }\\n _;\\n if (isTopLevelCall) {\\n _initializing = false;\\n emit Initialized(1);\\n }\\n }\\n\\n /**\\n * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\\n * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\\n * used to initialize parent contracts.\\n *\\n * A reinitializer may be used after the original initialization step. This is essential to configure modules that\\n * are added through upgrades and that require initialization.\\n *\\n * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\\n * cannot be nested. If one is invoked in the context of another, execution will revert.\\n *\\n * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\\n * a contract, executing them in the right order is up to the developer or operator.\\n *\\n * WARNING: setting the version to 255 will prevent any future reinitialization.\\n *\\n * Emits an {Initialized} event.\\n */\\n modifier reinitializer(uint8 version) {\\n require(!_initializing && _initialized < version, \\\"Initializable: contract is already initialized\\\");\\n _initialized = version;\\n _initializing = true;\\n _;\\n _initializing = false;\\n emit Initialized(version);\\n }\\n\\n /**\\n * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\\n * {initializer} and {reinitializer} modifiers, directly or indirectly.\\n */\\n modifier onlyInitializing() {\\n require(_initializing, \\\"Initializable: contract is not initializing\\\");\\n _;\\n }\\n\\n /**\\n * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\\n * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\\n * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\\n * through proxies.\\n *\\n * Emits an {Initialized} event the first time it is successfully executed.\\n */\\n function _disableInitializers() internal virtual {\\n require(!_initializing, \\\"Initializable: contract is initializing\\\");\\n if (_initialized != type(uint8).max) {\\n _initialized = type(uint8).max;\\n emit Initialized(type(uint8).max);\\n }\\n }\\n\\n /**\\n * @dev Returns the highest version that has been initialized. See {reinitializer}.\\n */\\n function _getInitializedVersion() internal view returns (uint8) {\\n return _initialized;\\n }\\n\\n /**\\n * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\\n */\\n function _isInitializing() internal view returns (bool) {\\n return _initializing;\\n }\\n}\\n\",\"keccak256\":\"0x89be10e757d242e9b18d5a32c9fbe2019f6d63052bbe46397a430a1d60d7f794\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary AddressUpgradeable {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n *\\n * Furthermore, `isContract` will also return true if the target contract within\\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\\n * which only has an effect at the end of a transaction.\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\\n *\\n * _Available since v4.8._\\n */\\n function verifyCallResultFromTarget(\\n address target,\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n if (success) {\\n if (returndata.length == 0) {\\n // only check isContract if the call was successful and the return data is empty\\n // otherwise we already know that it was a contract\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n }\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason or using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n /// @solidity memory-safe-assembly\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x9c80f545915582e63fe206c6ce27cbe85a86fc10b9cd2a0e8c9488fb7c2ee422\",\"license\":\"MIT\"},\"@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\nimport \\\"../proxy/utils/Initializable.sol\\\";\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract ContextUpgradeable is Initializable {\\n function __Context_init() internal onlyInitializing {\\n }\\n\\n function __Context_init_unchained() internal onlyInitializing {\\n }\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[50] private __gap;\\n}\\n\",\"keccak256\":\"0x963ea7f0b48b032eef72fe3a7582edf78408d6f834115b9feadd673a4d5bd149\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/IAccessControl.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev External interface of AccessControl declared to support ERC165 detection.\\n */\\ninterface IAccessControl {\\n /**\\n * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`\\n *\\n * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite\\n * {RoleAdminChanged} not being emitted signaling this.\\n *\\n * _Available since v3.1._\\n */\\n event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);\\n\\n /**\\n * @dev Emitted when `account` is granted `role`.\\n *\\n * `sender` is the account that originated the contract call, an admin role\\n * bearer except when using {AccessControl-_setupRole}.\\n */\\n event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Emitted when `account` is revoked `role`.\\n *\\n * `sender` is the account that originated the contract call:\\n * - if using `revokeRole`, it is the admin role bearer\\n * - if using `renounceRole`, it is the role bearer (i.e. `account`)\\n */\\n event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);\\n\\n /**\\n * @dev Returns `true` if `account` has been granted `role`.\\n */\\n function hasRole(bytes32 role, address account) external view returns (bool);\\n\\n /**\\n * @dev Returns the admin role that controls `role`. See {grantRole} and\\n * {revokeRole}.\\n *\\n * To change a role's admin, use {AccessControl-_setRoleAdmin}.\\n */\\n function getRoleAdmin(bytes32 role) external view returns (bytes32);\\n\\n /**\\n * @dev Grants `role` to `account`.\\n *\\n * If `account` had not been already granted `role`, emits a {RoleGranted}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function grantRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from `account`.\\n *\\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\\n *\\n * Requirements:\\n *\\n * - the caller must have ``role``'s admin role.\\n */\\n function revokeRole(bytes32 role, address account) external;\\n\\n /**\\n * @dev Revokes `role` from the calling account.\\n *\\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\\n * purpose is to provide a mechanism for accounts to lose their privileges\\n * if they are compromised (such as when a trusted device is misplaced).\\n *\\n * If the calling account had been granted `role`, emits a {RoleRevoked}\\n * event.\\n *\\n * Requirements:\\n *\\n * - the caller must be `account`.\\n */\\n function renounceRole(bytes32 role, address account) external;\\n}\\n\",\"keccak256\":\"0x59ce320a585d7e1f163cd70390a0ef2ff9cec832e2aa544293a00692465a7a57\",\"license\":\"MIT\"},\"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\nimport \\\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\\\";\\nimport \\\"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\\\";\\n\\nimport \\\"./IAccessControlManagerV8.sol\\\";\\n\\n/**\\n * @title AccessControlledV8\\n * @author Venus\\n * @notice This contract is helper between access control manager and actual contract. This contract further inherited by other contract (using solidity 0.8.13)\\n * to integrate access controlled mechanism. It provides initialise methods and verifying access methods.\\n */\\nabstract contract AccessControlledV8 is Initializable, Ownable2StepUpgradeable {\\n /// @notice Access control manager contract\\n IAccessControlManagerV8 private _accessControlManager;\\n\\n /**\\n * @dev This empty reserved space is put in place to allow future versions to add new\\n * variables without shifting down storage in the inheritance chain.\\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\\n */\\n uint256[49] private __gap;\\n\\n /// @notice Emitted when access control manager contract address is changed\\n event NewAccessControlManager(address oldAccessControlManager, address newAccessControlManager);\\n\\n /// @notice Thrown when the action is prohibited by AccessControlManager\\n error Unauthorized(address sender, address calledContract, string methodSignature);\\n\\n function __AccessControlled_init(address accessControlManager_) internal onlyInitializing {\\n __Ownable2Step_init();\\n __AccessControlled_init_unchained(accessControlManager_);\\n }\\n\\n function __AccessControlled_init_unchained(address accessControlManager_) internal onlyInitializing {\\n _setAccessControlManager(accessControlManager_);\\n }\\n\\n /**\\n * @notice Sets the address of AccessControlManager\\n * @dev Admin function to set address of AccessControlManager\\n * @param accessControlManager_ The new address of the AccessControlManager\\n * @custom:event Emits NewAccessControlManager event\\n * @custom:access Only Governance\\n */\\n function setAccessControlManager(address accessControlManager_) external onlyOwner {\\n _setAccessControlManager(accessControlManager_);\\n }\\n\\n /**\\n * @notice Returns the address of the access control manager contract\\n */\\n function accessControlManager() external view returns (IAccessControlManagerV8) {\\n return _accessControlManager;\\n }\\n\\n /**\\n * @dev Internal function to set address of AccessControlManager\\n * @param accessControlManager_ The new address of the AccessControlManager\\n */\\n function _setAccessControlManager(address accessControlManager_) internal {\\n require(address(accessControlManager_) != address(0), \\\"invalid acess control manager address\\\");\\n address oldAccessControlManager = address(_accessControlManager);\\n _accessControlManager = IAccessControlManagerV8(accessControlManager_);\\n emit NewAccessControlManager(oldAccessControlManager, accessControlManager_);\\n }\\n\\n /**\\n * @notice Reverts if the call is not allowed by AccessControlManager\\n * @param signature Method signature\\n */\\n function _checkAccessAllowed(string memory signature) internal view {\\n bool isAllowedToCall = _accessControlManager.isAllowedToCall(msg.sender, signature);\\n\\n if (!isAllowedToCall) {\\n revert Unauthorized(msg.sender, address(this), signature);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x0dcf283925f4dddc23ca0ee71d2cb96a9dd6e4cf08061b69fde1697ea39dc514\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity ^0.8.25;\\n\\nimport \\\"@openzeppelin/contracts/access/IAccessControl.sol\\\";\\n\\n/**\\n * @title IAccessControlManagerV8\\n * @author Venus\\n * @notice Interface implemented by the `AccessControlManagerV8` contract.\\n */\\ninterface IAccessControlManagerV8 is IAccessControl {\\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) external;\\n\\n function revokeCallPermission(\\n address contractAddress,\\n string calldata functionSig,\\n address accountToRevoke\\n ) external;\\n\\n function isAllowedToCall(address account, string calldata functionSig) external view returns (bool);\\n\\n function hasPermission(\\n address account,\\n address contractAddress,\\n string calldata functionSig\\n ) external view returns (bool);\\n}\\n\",\"keccak256\":\"0xaa29b098440d0b3a131c5ecdf25ce548790c1b5ac7bf9b5c0264b6af6f7a1e0b\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/constants.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity ^0.8.25;\\n\\n/// @dev Base unit for computations, usually used in scaling (multiplications, divisions)\\nuint256 constant EXP_SCALE = 1e18;\\n\\n/// @dev A unit (literal one) in EXP_SCALE, usually used in additions/subtractions\\nuint256 constant MANTISSA_ONE = EXP_SCALE;\\n\\n/// @dev The approximate number of seconds per year\\nuint256 constant SECONDS_PER_YEAR = 31_536_000;\\n\",\"keccak256\":\"0x14de93ead464da249af31bea0e3bcfb62ec693bea3475fb4d90f055ac81dc5eb\",\"license\":\"BSD-3-Clause\"},\"@venusprotocol/solidity-utilities/contracts/validators.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\\nerror ZeroAddressNotAllowed();\\n\\n/// @notice Thrown if the supplied value is 0 where it is not allowed\\nerror ZeroValueNotAllowed();\\n\\n/// @notice Checks if the provided address is nonzero, reverts otherwise\\n/// @param address_ Address to check\\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\\nfunction ensureNonzeroAddress(address address_) pure {\\n if (address_ == address(0)) {\\n revert ZeroAddressNotAllowed();\\n }\\n}\\n\\n/// @notice Checks if the provided value is nonzero, reverts otherwise\\n/// @param value_ Value to check\\n/// @custom:error ZeroValueNotAllowed is thrown if the provided value is 0\\nfunction ensureNonzeroValue(uint256 value_) pure {\\n if (value_ == 0) {\\n revert ZeroValueNotAllowed();\\n }\\n}\\n\",\"keccak256\":\"0xdb88e14d50dd21889ca3329d755673d022c47e8da005b6a545c7f69c2c4b7b86\",\"license\":\"BSD-3-Clause\"},\"contracts/interfaces/ISfrxEthFraxOracle.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\ninterface ISfrxEthFraxOracle {\\n function getPrices() external view returns (bool _isbadData, uint256 _priceLow, uint256 _priceHigh);\\n}\\n\",\"keccak256\":\"0x1444fbcfe658b985041e7ca5da6cce92fd143ca46d9793316ab2ef542fbde87a\",\"license\":\"BSD-3-Clause\"},\"contracts/interfaces/OracleInterface.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity ^0.8.25;\\n\\ninterface OracleInterface {\\n function getPrice(address asset) external view returns (uint256);\\n}\\n\\ninterface ResilientOracleInterface is OracleInterface {\\n function updatePrice(address vToken) external;\\n\\n function updateAssetPrice(address asset) external;\\n\\n function getUnderlyingPrice(address vToken) external view returns (uint256);\\n}\\n\\ninterface TwapInterface is OracleInterface {\\n function updateTwap(address asset) external returns (uint256);\\n}\\n\\ninterface BoundValidatorInterface {\\n function validatePriceWithAnchorPrice(\\n address asset,\\n uint256 reporterPrice,\\n uint256 anchorPrice\\n ) external view returns (bool);\\n}\\n\",\"keccak256\":\"0x2432799b0d824fc701beb4c30146e912b9aeecf77b5c1635dde6c5fbe6bfc3a7\",\"license\":\"BSD-3-Clause\"},\"contracts/oracles/SFrxETHOracle.sol\":{\"content\":\"// SPDX-License-Identifier: BSD-3-Clause\\npragma solidity 0.8.25;\\n\\nimport { ISfrxEthFraxOracle } from \\\"../interfaces/ISfrxEthFraxOracle.sol\\\";\\nimport { ensureNonzeroAddress, ensureNonzeroValue } from \\\"@venusprotocol/solidity-utilities/contracts/validators.sol\\\";\\nimport { EXP_SCALE } from \\\"@venusprotocol/solidity-utilities/contracts/constants.sol\\\";\\nimport { AccessControlledV8 } from \\\"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\\\";\\nimport { OracleInterface } from \\\"../interfaces/OracleInterface.sol\\\";\\n\\n/**\\n * @title SFrxETHOracle\\n * @author Venus\\n * @notice This oracle fetches the price of sfrxETH\\n */\\ncontract SFrxETHOracle is AccessControlledV8, OracleInterface {\\n /// @notice Address of SfrxEthFraxOracle\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n ISfrxEthFraxOracle public immutable SFRXETH_FRAX_ORACLE;\\n\\n /// @notice Address of sfrxETH\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n address public immutable SFRXETH;\\n\\n /// @notice Maximum allowed price difference\\n uint256 public maxAllowedPriceDifference;\\n\\n /// @notice Emits when the maximum allowed price difference is updated\\n event MaxAllowedPriceDifferenceUpdated(uint256 oldMaxAllowedPriceDifference, uint256 newMaxAllowedPriceDifference);\\n\\n /// @notice Thrown if the price data is invalid\\n error BadPriceData();\\n\\n /// @notice Thrown if the price difference exceeds the allowed limit\\n error PriceDifferenceExceeded();\\n\\n /// @notice Thrown if the token address is invalid\\n error InvalidTokenAddress();\\n\\n /// @notice Constructor for the implementation contract.\\n /// @custom:oz-upgrades-unsafe-allow constructor\\n constructor(address _sfrxEthFraxOracle, address _sfrxETH) {\\n ensureNonzeroAddress(_sfrxEthFraxOracle);\\n ensureNonzeroAddress(_sfrxETH);\\n\\n SFRXETH_FRAX_ORACLE = ISfrxEthFraxOracle(_sfrxEthFraxOracle);\\n SFRXETH = _sfrxETH;\\n\\n _disableInitializers();\\n }\\n\\n /**\\n * @notice Sets the contracts required to fetch prices\\n * @param _accessControlManager Address of the access control manager contract\\n * @param _maxAllowedPriceDifference Maximum allowed price difference\\n */\\n function initialize(address _accessControlManager, uint256 _maxAllowedPriceDifference) external initializer {\\n ensureNonzeroValue(_maxAllowedPriceDifference);\\n\\n __AccessControlled_init(_accessControlManager);\\n maxAllowedPriceDifference = _maxAllowedPriceDifference;\\n }\\n\\n /**\\n * @notice Sets the maximum allowed price difference\\n * @param _maxAllowedPriceDifference Maximum allowed price difference\\n */\\n function setMaxAllowedPriceDifference(uint256 _maxAllowedPriceDifference) external {\\n _checkAccessAllowed(\\\"setMaxAllowedPriceDifference(uint256)\\\");\\n ensureNonzeroValue(_maxAllowedPriceDifference);\\n\\n emit MaxAllowedPriceDifferenceUpdated(maxAllowedPriceDifference, _maxAllowedPriceDifference);\\n maxAllowedPriceDifference = _maxAllowedPriceDifference;\\n }\\n\\n /**\\n * @notice Fetches the USD price of sfrxETH\\n * @param asset Address of the sfrxETH token\\n * @return price The price scaled by 1e18\\n */\\n function getPrice(address asset) external view returns (uint256) {\\n if (asset != SFRXETH) revert InvalidTokenAddress();\\n\\n (bool isBadData, uint256 priceLow, uint256 priceHigh) = SFRXETH_FRAX_ORACLE.getPrices();\\n\\n if (isBadData) revert BadPriceData();\\n\\n // calculate price in USD\\n uint256 priceHighInUSD = (EXP_SCALE ** 2) / priceLow;\\n uint256 priceLowInUSD = (EXP_SCALE ** 2) / priceHigh;\\n\\n ensureNonzeroValue(priceHighInUSD);\\n ensureNonzeroValue(priceLowInUSD);\\n\\n // validate price difference\\n uint256 difference = (priceHighInUSD * EXP_SCALE) / priceLowInUSD;\\n if (difference > maxAllowedPriceDifference) revert PriceDifferenceExceeded();\\n\\n // calculate and return average price\\n return (priceHighInUSD + priceLowInUSD) / 2;\\n }\\n}\\n\",\"keccak256\":\"0xc70f573c15e65fee8f8524b2d189ea39866d30c3f83afab74a7d588480acd824\",\"license\":\"BSD-3-Clause\"}},\"version\":1}", + "bytecode": "0x60c060405234801561001057600080fd5b50604051610eb1380380610eb183398101604081905261002f91610168565b61003882610063565b61004181610063565b6001600160a01b03808316608052811660a05261005c61008d565b505061019b565b6001600160a01b03811661008a576040516342bcdf7f60e11b815260040160405180910390fd5b50565b600054610100900460ff16156100f95760405162461bcd60e51b815260206004820152602760248201527f496e697469616c697a61626c653a20636f6e747261637420697320696e697469604482015266616c697a696e6760c81b606482015260840160405180910390fd5b60005460ff9081161461014a576000805460ff191660ff9081179091556040519081527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b565b80516001600160a01b038116811461016357600080fd5b919050565b6000806040838503121561017b57600080fd5b6101848361014c565b91506101926020840161014c565b90509250929050565b60805160a051610ce46101cd60003960008181610132015261021201526000818160ee01526102690152610ce46000f3fe608060405234801561001057600080fd5b50600436106100cf5760003560e01c80638da5cb5b1161008c578063cd6dc68711610066578063cd6dc687146101b0578063d5445950146101c3578063e30c3978146101d6578063f2fde38b146101e757600080fd5b80638da5cb5b146101855780639fd1944f14610196578063b4a0bdf31461019f57600080fd5b80630e32cb86146100d4578063127cac45146100e957806335da603d1461012d57806341976e0914610154578063715018a61461017557806379ba50971461017d575b600080fd5b6100e76100e236600461097b565b6101fa565b005b6101107f000000000000000000000000000000000000000000000000000000000000000081565b6040516001600160a01b0390911681526020015b60405180910390f35b6101107f000000000000000000000000000000000000000000000000000000000000000081565b61016761016236600461097b565b61020e565b604051908152602001610124565b6100e76103ca565b6100e76103de565b6033546001600160a01b0316610110565b61016760c95481565b6097546001600160a01b0316610110565b6100e76101be36600461099d565b61045a565b6100e76101d13660046109c7565b61057c565b6065546001600160a01b0316610110565b6100e76101f536600461097b565b6105e7565b610202610658565b61020b816106b2565b50565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316826001600160a01b03161461026257604051630f58058360e11b815260040160405180910390fd5b60008060007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663bd9a548b6040518163ffffffff1660e01b8152600401606060405180830381865afa1580156102c5573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906102e991906109f0565b925092509250821561030e5760405163a40e329160e01b815260040160405180910390fd5b6000826103246002670de0b6b3a7640000610b21565b61032e9190610b30565b90506000826103466002670de0b6b3a7640000610b21565b6103509190610b30565b905061035b82610777565b61036481610777565b600081610379670de0b6b3a764000085610b52565b6103839190610b30565b905060c9548111156103a85760405163280cb9ed60e11b815260040160405180910390fd5b60026103b48385610b69565b6103be9190610b30565b98975050505050505050565b6103d2610658565b6103dc6000610798565b565b60655433906001600160a01b031681146104515760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084015b60405180910390fd5b61020b81610798565b600054610100900460ff161580801561047a5750600054600160ff909116105b806104945750303b158015610494575060005460ff166001145b6104f75760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610448565b6000805460ff19166001179055801561051a576000805461ff0019166101001790555b61052382610777565b61052c836107b1565b60c98290558015610577576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050565b61059d604051806060016040528060258152602001610c8a602591396107e9565b6105a681610777565b60c95460408051918252602082018390527f8d4d923222e4a17f030a7f3fe695e9e6c13b437df4b3b48c2332f584395aba90910160405180910390a160c955565b6105ef610658565b606580546001600160a01b0383166001600160a01b031990911681179091556106206033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b6033546001600160a01b031633146103dc5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610448565b6001600160a01b0381166107165760405162461bcd60e51b815260206004820152602560248201527f696e76616c696420616365737320636f6e74726f6c206d616e61676572206164604482015264647265737360d81b6064820152608401610448565b609780546001600160a01b038381166001600160a01b031983168117909355604080519190921680825260208201939093527f66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa0910160405180910390a15050565b8060000361020b5760405163273e150360e21b815260040160405180910390fd5b606580546001600160a01b031916905561020b81610887565b600054610100900460ff166107d85760405162461bcd60e51b815260040161044890610b7c565b6107e06108d9565b61020b81610908565b6097546040516318c5e8ab60e01b81526000916001600160a01b0316906318c5e8ab9061081c9033908690600401610c0d565b602060405180830381865afa158015610839573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061085d9190610c39565b90508061088357333083604051634a3fa29360e01b815260040161044893929190610c54565b5050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600054610100900460ff166109005760405162461bcd60e51b815260040161044890610b7c565b6103dc61092f565b600054610100900460ff166102025760405162461bcd60e51b815260040161044890610b7c565b600054610100900460ff166109565760405162461bcd60e51b815260040161044890610b7c565b6103dc33610798565b80356001600160a01b038116811461097657600080fd5b919050565b60006020828403121561098d57600080fd5b6109968261095f565b9392505050565b600080604083850312156109b057600080fd5b6109b98361095f565b946020939093013593505050565b6000602082840312156109d957600080fd5b5035919050565b8051801515811461097657600080fd5b600080600060608486031215610a0557600080fd5b610a0e846109e0565b925060208401519150604084015190509250925092565b634e487b7160e01b600052601160045260246000fd5b600181815b80851115610a76578160001904821115610a5c57610a5c610a25565b80851615610a6957918102915b93841c9390800290610a40565b509250929050565b600082610a8d57506001610b1b565b81610a9a57506000610b1b565b8160018114610ab05760028114610aba57610ad6565b6001915050610b1b565b60ff841115610acb57610acb610a25565b50506001821b610b1b565b5060208310610133831016604e8410600b8410161715610af9575081810a610b1b565b610b038383610a3b565b8060001904821115610b1757610b17610a25565b0290505b92915050565b600061099660ff841683610a7e565b600082610b4d57634e487b7160e01b600052601260045260246000fd5b500490565b8082028115828204841417610b1b57610b1b610a25565b80820180821115610b1b57610b1b610a25565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b6000815180845260005b81811015610bed57602081850181015186830182015201610bd1565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b0383168152604060208201819052600090610c3190830184610bc7565b949350505050565b600060208284031215610c4b57600080fd5b610996826109e0565b6001600160a01b03848116825283166020820152606060408201819052600090610c8090830184610bc7565b9594505050505056fe7365744d6178416c6c6f7765645072696365446966666572656e63652875696e7432353629a2646970667358221220635a5b40e1f18a7d04d511870430fba9ca8b71100b7a203df7f26ef36b0e369664736f6c63430008190033", + "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100cf5760003560e01c80638da5cb5b1161008c578063cd6dc68711610066578063cd6dc687146101b0578063d5445950146101c3578063e30c3978146101d6578063f2fde38b146101e757600080fd5b80638da5cb5b146101855780639fd1944f14610196578063b4a0bdf31461019f57600080fd5b80630e32cb86146100d4578063127cac45146100e957806335da603d1461012d57806341976e0914610154578063715018a61461017557806379ba50971461017d575b600080fd5b6100e76100e236600461097b565b6101fa565b005b6101107f000000000000000000000000000000000000000000000000000000000000000081565b6040516001600160a01b0390911681526020015b60405180910390f35b6101107f000000000000000000000000000000000000000000000000000000000000000081565b61016761016236600461097b565b61020e565b604051908152602001610124565b6100e76103ca565b6100e76103de565b6033546001600160a01b0316610110565b61016760c95481565b6097546001600160a01b0316610110565b6100e76101be36600461099d565b61045a565b6100e76101d13660046109c7565b61057c565b6065546001600160a01b0316610110565b6100e76101f536600461097b565b6105e7565b610202610658565b61020b816106b2565b50565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316826001600160a01b03161461026257604051630f58058360e11b815260040160405180910390fd5b60008060007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663bd9a548b6040518163ffffffff1660e01b8152600401606060405180830381865afa1580156102c5573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906102e991906109f0565b925092509250821561030e5760405163a40e329160e01b815260040160405180910390fd5b6000826103246002670de0b6b3a7640000610b21565b61032e9190610b30565b90506000826103466002670de0b6b3a7640000610b21565b6103509190610b30565b905061035b82610777565b61036481610777565b600081610379670de0b6b3a764000085610b52565b6103839190610b30565b905060c9548111156103a85760405163280cb9ed60e11b815260040160405180910390fd5b60026103b48385610b69565b6103be9190610b30565b98975050505050505050565b6103d2610658565b6103dc6000610798565b565b60655433906001600160a01b031681146104515760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084015b60405180910390fd5b61020b81610798565b600054610100900460ff161580801561047a5750600054600160ff909116105b806104945750303b158015610494575060005460ff166001145b6104f75760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610448565b6000805460ff19166001179055801561051a576000805461ff0019166101001790555b61052382610777565b61052c836107b1565b60c98290558015610577576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050565b61059d604051806060016040528060258152602001610c8a602591396107e9565b6105a681610777565b60c95460408051918252602082018390527f8d4d923222e4a17f030a7f3fe695e9e6c13b437df4b3b48c2332f584395aba90910160405180910390a160c955565b6105ef610658565b606580546001600160a01b0383166001600160a01b031990911681179091556106206033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b6033546001600160a01b031633146103dc5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610448565b6001600160a01b0381166107165760405162461bcd60e51b815260206004820152602560248201527f696e76616c696420616365737320636f6e74726f6c206d616e61676572206164604482015264647265737360d81b6064820152608401610448565b609780546001600160a01b038381166001600160a01b031983168117909355604080519190921680825260208201939093527f66fd58e82f7b31a2a5c30e0888f3093efe4e111b00cd2b0c31fe014601293aa0910160405180910390a15050565b8060000361020b5760405163273e150360e21b815260040160405180910390fd5b606580546001600160a01b031916905561020b81610887565b600054610100900460ff166107d85760405162461bcd60e51b815260040161044890610b7c565b6107e06108d9565b61020b81610908565b6097546040516318c5e8ab60e01b81526000916001600160a01b0316906318c5e8ab9061081c9033908690600401610c0d565b602060405180830381865afa158015610839573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061085d9190610c39565b90508061088357333083604051634a3fa29360e01b815260040161044893929190610c54565b5050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600054610100900460ff166109005760405162461bcd60e51b815260040161044890610b7c565b6103dc61092f565b600054610100900460ff166102025760405162461bcd60e51b815260040161044890610b7c565b600054610100900460ff166109565760405162461bcd60e51b815260040161044890610b7c565b6103dc33610798565b80356001600160a01b038116811461097657600080fd5b919050565b60006020828403121561098d57600080fd5b6109968261095f565b9392505050565b600080604083850312156109b057600080fd5b6109b98361095f565b946020939093013593505050565b6000602082840312156109d957600080fd5b5035919050565b8051801515811461097657600080fd5b600080600060608486031215610a0557600080fd5b610a0e846109e0565b925060208401519150604084015190509250925092565b634e487b7160e01b600052601160045260246000fd5b600181815b80851115610a76578160001904821115610a5c57610a5c610a25565b80851615610a6957918102915b93841c9390800290610a40565b509250929050565b600082610a8d57506001610b1b565b81610a9a57506000610b1b565b8160018114610ab05760028114610aba57610ad6565b6001915050610b1b565b60ff841115610acb57610acb610a25565b50506001821b610b1b565b5060208310610133831016604e8410600b8410161715610af9575081810a610b1b565b610b038383610a3b565b8060001904821115610b1757610b17610a25565b0290505b92915050565b600061099660ff841683610a7e565b600082610b4d57634e487b7160e01b600052601260045260246000fd5b500490565b8082028115828204841417610b1b57610b1b610a25565b80820180821115610b1b57610b1b610a25565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b6000815180845260005b81811015610bed57602081850181015186830182015201610bd1565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b0383168152604060208201819052600090610c3190830184610bc7565b949350505050565b600060208284031215610c4b57600080fd5b610996826109e0565b6001600160a01b03848116825283166020820152606060408201819052600090610c8090830184610bc7565b9594505050505056fe7365744d6178416c6c6f7765645072696365446966666572656e63652875696e7432353629a2646970667358221220635a5b40e1f18a7d04d511870430fba9ca8b71100b7a203df7f26ef36b0e369664736f6c63430008190033", + "devdoc": { + "author": "Venus", + "events": { + "Initialized(uint8)": { + "details": "Triggered when the contract has been initialized or reinitialized." + } + }, + "kind": "dev", + "methods": { + "acceptOwnership()": { + "details": "The new owner accepts the ownership transfer." + }, + "constructor": { + "custom:oz-upgrades-unsafe-allow": "constructor" + }, + "getPrice(address)": { + "params": { + "asset": "Address of the sfrxETH token" + }, + "returns": { + "_0": "price The price scaled by 1e18" + } + }, + "initialize(address,uint256)": { + "params": { + "_accessControlManager": "Address of the access control manager contract", + "_maxAllowedPriceDifference": "Maximum allowed price difference" + } + }, + "owner()": { + "details": "Returns the address of the current owner." + }, + "pendingOwner()": { + "details": "Returns the address of the pending owner." + }, + "renounceOwnership()": { + "details": "Leaves the contract without owner. It will not be possible to call `onlyOwner` functions. Can only be called by the current owner. NOTE: Renouncing ownership will leave the contract without an owner, thereby disabling any functionality that is only available to the owner." + }, + "setAccessControlManager(address)": { + "custom:access": "Only Governance", + "custom:event": "Emits NewAccessControlManager event", + "details": "Admin function to set address of AccessControlManager", + "params": { + "accessControlManager_": "The new address of the AccessControlManager" + } + }, + "setMaxAllowedPriceDifference(uint256)": { + "params": { + "_maxAllowedPriceDifference": "Maximum allowed price difference" + } + }, + "transferOwnership(address)": { + "details": "Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one. Can only be called by the current owner." + } + }, + "stateVariables": { + "SFRXETH": { + "custom:oz-upgrades-unsafe-allow": "state-variable-immutable" + }, + "SFRXETH_FRAX_ORACLE": { + "custom:oz-upgrades-unsafe-allow": "state-variable-immutable" + } + }, + "title": "SFrxETHOracle", + "version": 1 + }, + "userdoc": { + "errors": { + "BadPriceData()": [ + { + "notice": "Thrown if the price data is invalid" + } + ], + "InvalidTokenAddress()": [ + { + "notice": "Thrown if the token address is invalid" + } + ], + "PriceDifferenceExceeded()": [ + { + "notice": "Thrown if the price difference exceeds the allowed limit" + } + ], + "Unauthorized(address,address,string)": [ + { + "notice": "Thrown when the action is prohibited by AccessControlManager" + } + ], + "ZeroAddressNotAllowed()": [ + { + "notice": "Thrown if the supplied address is a zero address where it is not allowed" + } + ], + "ZeroValueNotAllowed()": [ + { + "notice": "Thrown if the supplied value is 0 where it is not allowed" + } + ] + }, + "events": { + "MaxAllowedPriceDifferenceUpdated(uint256,uint256)": { + "notice": "Emits when the maximum allowed price difference is updated" + }, + "NewAccessControlManager(address,address)": { + "notice": "Emitted when access control manager contract address is changed" + } + }, + "kind": "user", + "methods": { + "SFRXETH()": { + "notice": "Address of sfrxETH" + }, + "SFRXETH_FRAX_ORACLE()": { + "notice": "Address of SfrxEthFraxOracle" + }, + "accessControlManager()": { + "notice": "Returns the address of the access control manager contract" + }, + "constructor": { + "notice": "Constructor for the implementation contract." + }, + "getPrice(address)": { + "notice": "Fetches the USD price of sfrxETH" + }, + "initialize(address,uint256)": { + "notice": "Sets the contracts required to fetch prices" + }, + "maxAllowedPriceDifference()": { + "notice": "Maximum allowed price difference" + }, + "setAccessControlManager(address)": { + "notice": "Sets the address of AccessControlManager" + }, + "setMaxAllowedPriceDifference(uint256)": { + "notice": "Sets the maximum allowed price difference" + } + }, + "notice": "This oracle fetches the price of sfrxETH", + "version": 1 + }, + "storageLayout": { + "storage": [ + { + "astId": 347, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "_initialized", + "offset": 0, + "slot": "0", + "type": "t_uint8" + }, + { + "astId": 350, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "_initializing", + "offset": 1, + "slot": "0", + "type": "t_bool" + }, + { + "astId": 1007, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "__gap", + "offset": 0, + "slot": "1", + "type": "t_array(t_uint256)50_storage" + }, + { + "astId": 219, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "_owner", + "offset": 0, + "slot": "51", + "type": "t_address" + }, + { + "astId": 339, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "__gap", + "offset": 0, + "slot": "52", + "type": "t_array(t_uint256)49_storage" + }, + { + "astId": 128, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "_pendingOwner", + "offset": 0, + "slot": "101", + "type": "t_address" + }, + { + "astId": 207, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "__gap", + "offset": 0, + "slot": "102", + "type": "t_array(t_uint256)49_storage" + }, + { + "astId": 5192, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "_accessControlManager", + "offset": 0, + "slot": "151", + "type": "t_contract(IAccessControlManagerV8)5377" + }, + { + "astId": 5197, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "__gap", + "offset": 0, + "slot": "152", + "type": "t_array(t_uint256)49_storage" + }, + { + "astId": 8862, + "contract": "contracts/oracles/SFrxETHOracle.sol:SFrxETHOracle", + "label": "maxAllowedPriceDifference", + "offset": 0, + "slot": "201", + "type": "t_uint256" + } + ], + "types": { + "t_address": { + "encoding": "inplace", + "label": "address", + "numberOfBytes": "20" + }, + "t_array(t_uint256)49_storage": { + "base": "t_uint256", + "encoding": "inplace", + "label": "uint256[49]", + "numberOfBytes": "1568" + }, + "t_array(t_uint256)50_storage": { + "base": "t_uint256", + "encoding": "inplace", + "label": "uint256[50]", + "numberOfBytes": "1600" + }, + "t_bool": { + "encoding": "inplace", + "label": "bool", + "numberOfBytes": "1" + }, + "t_contract(IAccessControlManagerV8)5377": { + "encoding": "inplace", + "label": "contract IAccessControlManagerV8", + "numberOfBytes": "20" + }, + "t_uint256": { + "encoding": "inplace", + "label": "uint256", + "numberOfBytes": "32" + }, + "t_uint8": { + "encoding": "inplace", + "label": "uint8", + "numberOfBytes": "1" + } + } + } +} diff --git a/deployments/sepolia/SFrxETHOracle_Proxy.json b/deployments/sepolia/SFrxETHOracle_Proxy.json new file mode 100644 index 00000000..67570ab5 --- /dev/null +++ b/deployments/sepolia/SFrxETHOracle_Proxy.json @@ -0,0 +1,213 @@ +{ + "address": "0x6E202555f0CA6558118C67150e16fbf89080eB3b", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "_logic", + "type": "address" + }, + { + "internalType": "address", + "name": "admin_", + "type": "address" + }, + { + "internalType": "bytes", + "name": "_data", + "type": "bytes" + } + ], + "stateMutability": "payable", + "type": "constructor" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "previousAdmin", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "AdminChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "beacon", + "type": "address" + } + ], + "name": "BeaconUpgraded", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "implementation", + "type": "address" + } + ], + "name": "Upgraded", + "type": "event" + }, + { + "stateMutability": "payable", + "type": "fallback" + }, + { + "inputs": [], + "name": "admin", + "outputs": [ + { + "internalType": "address", + "name": "admin_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "implementation", + "outputs": [ + { + "internalType": "address", + "name": "implementation_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + } + ], + "name": "upgradeTo", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + }, + { + "internalType": "bytes", + "name": "data", + "type": "bytes" + } + ], + "name": "upgradeToAndCall", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "stateMutability": "payable", + "type": "receive" + } + ], + "transactionHash": "0x2a81a6e3087eb84fa08aee42730b4c9edea8953456cf674ce3da963b201e65bf", + "receipt": { + "to": null, + "from": "0x464779C41C5f1Be598853C1F87bCC7087Ea75f28", + "contractAddress": "0x6E202555f0CA6558118C67150e16fbf89080eB3b", + "transactionIndex": 59, + "gasUsed": "622245", + "logsBloom": "0x00000000000000000000000000000000400000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000800000000000000000000080000000000000800000004000000000000000000000000000000000000000000000000000000000000000000024000000020000000000000000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "blockHash": "0x98a844c9330d6c98dcfb1f0039d9dbf16a9e8259922e2f08c712e4aee215e3fc", + "transactionHash": "0x2a81a6e3087eb84fa08aee42730b4c9edea8953456cf674ce3da963b201e65bf", + "logs": [ + { + "transactionIndex": 59, + "blockNumber": 6076954, + "transactionHash": "0x2a81a6e3087eb84fa08aee42730b4c9edea8953456cf674ce3da963b201e65bf", + "address": "0x6E202555f0CA6558118C67150e16fbf89080eB3b", + "topics": [ + "0xbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b", + "0x00000000000000000000000022f55239fe27ce429be407a1a9dd90365188b647" + ], + "data": "0x", + "logIndex": 157, + "blockHash": "0x98a844c9330d6c98dcfb1f0039d9dbf16a9e8259922e2f08c712e4aee215e3fc" + }, + { + "transactionIndex": 59, + "blockNumber": 6076954, + "transactionHash": "0x2a81a6e3087eb84fa08aee42730b4c9edea8953456cf674ce3da963b201e65bf", + "address": "0x6E202555f0CA6558118C67150e16fbf89080eB3b", + "topics": ["0x7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f"], + "data": "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001435866babd91311b1355cf3af488cca36db68e", + "logIndex": 158, + "blockHash": "0x98a844c9330d6c98dcfb1f0039d9dbf16a9e8259922e2f08c712e4aee215e3fc" + } + ], + "blockNumber": 6076954, + "cumulativeGasUsed": "11583687", + "status": 1, + "byzantium": true + }, + "args": ["0x22F55239FE27cE429be407A1a9dD90365188B647", "0x01435866babd91311b1355cf3af488cca36db68e", "0x"], + "numDeployments": 1, + "solcInputHash": "0e89febeebc7444140de8e67c9067d2c", + "metadata": "{\"compiler\":{\"version\":\"0.8.10+commit.fc410830\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_logic\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"admin_\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"_data\",\"type\":\"bytes\"}],\"stateMutability\":\"payable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"previousAdmin\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"AdminChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"beacon\",\"type\":\"address\"}],\"name\":\"BeaconUpgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"implementation\",\"type\":\"address\"}],\"name\":\"Upgraded\",\"type\":\"event\"},{\"stateMutability\":\"payable\",\"type\":\"fallback\"},{\"inputs\":[],\"name\":\"admin\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"admin_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"implementation\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"implementation_\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"}],\"name\":\"upgradeTo\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"upgradeToAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"stateMutability\":\"payable\",\"type\":\"receive\"}],\"devdoc\":{\"details\":\"This contract implements a proxy that is upgradeable by an admin. To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector clashing], which can potentially be used in an attack, this contract uses the https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two things that go hand in hand: 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if that call matches one of the admin functions exposed by the proxy itself. 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the implementation. If the admin tries to call a function on the implementation it will fail with an error that says \\\"admin cannot fallback to proxy target\\\". These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due to sudden errors when trying to call a function from the proxy implementation. Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way, you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.\",\"kind\":\"dev\",\"methods\":{\"admin()\":{\"details\":\"Returns the current admin. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`\"},\"constructor\":{\"details\":\"Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.\"},\"implementation()\":{\"details\":\"Returns the current implementation. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`\"},\"upgradeTo(address)\":{\"details\":\"Upgrade the implementation of the proxy. NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.\"},\"upgradeToAndCall(address,bytes)\":{\"details\":\"Upgrade the implementation of the proxy, and then call a function from the new implementation as specified by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the proxied contract. NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.\"}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{},\"version\":1}},\"settings\":{\"compilationTarget\":{\"solc_0.8/proxy/OptimizedTransparentUpgradeableProxy.sol\":\"OptimizedTransparentUpgradeableProxy\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":999999},\"remappings\":[]},\"sources\":{\"solc_0.8/openzeppelin/interfaces/draft-IERC1822.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (interfaces/draft-IERC1822.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified\\n * proxy whose upgrades are fully controlled by the current implementation.\\n */\\ninterface IERC1822Proxiable {\\n /**\\n * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation\\n * address.\\n *\\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\\n * function revert if invoked through a proxy.\\n */\\n function proxiableUUID() external view returns (bytes32);\\n}\\n\",\"keccak256\":\"0x93b4e21c931252739a1ec13ea31d3d35a5c068be3163ccab83e4d70c40355f03\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/ERC1967/ERC1967Proxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/ERC1967/ERC1967Proxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../Proxy.sol\\\";\\nimport \\\"./ERC1967Upgrade.sol\\\";\\n\\n/**\\n * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an\\n * implementation address that can be changed. This address is stored in storage in the location specified by\\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the\\n * implementation behind the proxy.\\n */\\ncontract ERC1967Proxy is Proxy, ERC1967Upgrade {\\n /**\\n * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.\\n *\\n * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded\\n * function call, and allows initializating the storage of the proxy like a Solidity constructor.\\n */\\n constructor(address _logic, bytes memory _data) payable {\\n assert(_IMPLEMENTATION_SLOT == bytes32(uint256(keccak256(\\\"eip1967.proxy.implementation\\\")) - 1));\\n _upgradeToAndCall(_logic, _data, false);\\n }\\n\\n /**\\n * @dev Returns the current implementation address.\\n */\\n function _implementation() internal view virtual override returns (address impl) {\\n return ERC1967Upgrade._getImplementation();\\n }\\n}\\n\",\"keccak256\":\"0x6309f9f39dc6f4f45a24f296543867aa358e32946cd6b2874627a996d606b3a0\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/ERC1967/ERC1967Upgrade.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/ERC1967/ERC1967Upgrade.sol)\\n\\npragma solidity ^0.8.2;\\n\\nimport \\\"../beacon/IBeacon.sol\\\";\\nimport \\\"../../interfaces/draft-IERC1822.sol\\\";\\nimport \\\"../../utils/Address.sol\\\";\\nimport \\\"../../utils/StorageSlot.sol\\\";\\n\\n/**\\n * @dev This abstract contract provides getters and event emitting update functions for\\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.\\n *\\n * _Available since v4.1._\\n *\\n * @custom:oz-upgrades-unsafe-allow delegatecall\\n */\\nabstract contract ERC1967Upgrade {\\n // This is the keccak-256 hash of \\\"eip1967.proxy.rollback\\\" subtracted by 1\\n bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;\\n\\n /**\\n * @dev Storage slot with the address of the current implementation.\\n * This is the keccak-256 hash of \\\"eip1967.proxy.implementation\\\" subtracted by 1, and is\\n * validated in the constructor.\\n */\\n bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n\\n /**\\n * @dev Emitted when the implementation is upgraded.\\n */\\n event Upgraded(address indexed implementation);\\n\\n /**\\n * @dev Returns the current implementation address.\\n */\\n function _getImplementation() internal view returns (address) {\\n return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new address in the EIP1967 implementation slot.\\n */\\n function _setImplementation(address newImplementation) private {\\n require(Address.isContract(newImplementation), \\\"ERC1967: new implementation is not a contract\\\");\\n StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\\n }\\n\\n /**\\n * @dev Perform implementation upgrade\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeTo(address newImplementation) internal {\\n _setImplementation(newImplementation);\\n emit Upgraded(newImplementation);\\n }\\n\\n /**\\n * @dev Perform implementation upgrade with additional setup call.\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeToAndCall(\\n address newImplementation,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n _upgradeTo(newImplementation);\\n if (data.length > 0 || forceCall) {\\n Address.functionDelegateCall(newImplementation, data);\\n }\\n }\\n\\n /**\\n * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.\\n *\\n * Emits an {Upgraded} event.\\n */\\n function _upgradeToAndCallUUPS(\\n address newImplementation,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n // Upgrades from old implementations will perform a rollback test. This test requires the new\\n // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing\\n // this special case will break upgrade paths from old UUPS implementation to new ones.\\n if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) {\\n _setImplementation(newImplementation);\\n } else {\\n try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {\\n require(slot == _IMPLEMENTATION_SLOT, \\\"ERC1967Upgrade: unsupported proxiableUUID\\\");\\n } catch {\\n revert(\\\"ERC1967Upgrade: new implementation is not UUPS\\\");\\n }\\n _upgradeToAndCall(newImplementation, data, forceCall);\\n }\\n }\\n\\n /**\\n * @dev Storage slot with the admin of the contract.\\n * This is the keccak-256 hash of \\\"eip1967.proxy.admin\\\" subtracted by 1, and is\\n * validated in the constructor.\\n */\\n bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;\\n\\n /**\\n * @dev Emitted when the admin account has changed.\\n */\\n event AdminChanged(address previousAdmin, address newAdmin);\\n\\n /**\\n * @dev Returns the current admin.\\n */\\n function _getAdmin() internal view virtual returns (address) {\\n return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new address in the EIP1967 admin slot.\\n */\\n function _setAdmin(address newAdmin) private {\\n require(newAdmin != address(0), \\\"ERC1967: new admin is the zero address\\\");\\n StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;\\n }\\n\\n /**\\n * @dev Changes the admin of the proxy.\\n *\\n * Emits an {AdminChanged} event.\\n */\\n function _changeAdmin(address newAdmin) internal {\\n emit AdminChanged(_getAdmin(), newAdmin);\\n _setAdmin(newAdmin);\\n }\\n\\n /**\\n * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.\\n * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.\\n */\\n bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;\\n\\n /**\\n * @dev Emitted when the beacon is upgraded.\\n */\\n event BeaconUpgraded(address indexed beacon);\\n\\n /**\\n * @dev Returns the current beacon.\\n */\\n function _getBeacon() internal view returns (address) {\\n return StorageSlot.getAddressSlot(_BEACON_SLOT).value;\\n }\\n\\n /**\\n * @dev Stores a new beacon in the EIP1967 beacon slot.\\n */\\n function _setBeacon(address newBeacon) private {\\n require(Address.isContract(newBeacon), \\\"ERC1967: new beacon is not a contract\\\");\\n require(Address.isContract(IBeacon(newBeacon).implementation()), \\\"ERC1967: beacon implementation is not a contract\\\");\\n StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;\\n }\\n\\n /**\\n * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does\\n * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).\\n *\\n * Emits a {BeaconUpgraded} event.\\n */\\n function _upgradeBeaconToAndCall(\\n address newBeacon,\\n bytes memory data,\\n bool forceCall\\n ) internal {\\n _setBeacon(newBeacon);\\n emit BeaconUpgraded(newBeacon);\\n if (data.length > 0 || forceCall) {\\n Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x17668652127feebed0ce8d9431ef95ccc8c4292f03e3b8cf06c6ca16af396633\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/Proxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/Proxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM\\n * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to\\n * be specified by overriding the virtual {_implementation} function.\\n *\\n * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a\\n * different contract through the {_delegate} function.\\n *\\n * The success and return data of the delegated call will be returned back to the caller of the proxy.\\n */\\nabstract contract Proxy {\\n /**\\n * @dev Delegates the current call to `implementation`.\\n *\\n * This function does not return to its internal call site, it will return directly to the external caller.\\n */\\n function _delegate(address implementation) internal virtual {\\n assembly {\\n // Copy msg.data. We take full control of memory in this inline assembly\\n // block because it will not return to Solidity code. We overwrite the\\n // Solidity scratch pad at memory position 0.\\n calldatacopy(0, 0, calldatasize())\\n\\n // Call the implementation.\\n // out and outsize are 0 because we don't know the size yet.\\n let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)\\n\\n // Copy the returned data.\\n returndatacopy(0, 0, returndatasize())\\n\\n switch result\\n // delegatecall returns 0 on error.\\n case 0 {\\n revert(0, returndatasize())\\n }\\n default {\\n return(0, returndatasize())\\n }\\n }\\n }\\n\\n /**\\n * @dev This is a virtual function that should be overriden so it returns the address to which the fallback function\\n * and {_fallback} should delegate.\\n */\\n function _implementation() internal view virtual returns (address);\\n\\n /**\\n * @dev Delegates the current call to the address returned by `_implementation()`.\\n *\\n * This function does not return to its internall call site, it will return directly to the external caller.\\n */\\n function _fallback() internal virtual {\\n _beforeFallback();\\n _delegate(_implementation());\\n }\\n\\n /**\\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other\\n * function in the contract matches the call data.\\n */\\n fallback() external payable virtual {\\n _fallback();\\n }\\n\\n /**\\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data\\n * is empty.\\n */\\n receive() external payable virtual {\\n _fallback();\\n }\\n\\n /**\\n * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`\\n * call, or as part of the Solidity `fallback` or `receive` functions.\\n *\\n * If overriden should call `super._beforeFallback()`.\\n */\\n function _beforeFallback() internal virtual {}\\n}\\n\",\"keccak256\":\"0xd5d1fd16e9faff7fcb3a52e02a8d49156f42a38a03f07b5f1810c21c2149a8ab\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/proxy/beacon/IBeacon.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev This is the interface that {BeaconProxy} expects of its beacon.\\n */\\ninterface IBeacon {\\n /**\\n * @dev Must return an address that can be used as a delegate call target.\\n *\\n * {BeaconProxy} will check that this address is a contract.\\n */\\n function implementation() external view returns (address);\\n}\\n\",\"keccak256\":\"0xd50a3421ac379ccb1be435fa646d66a65c986b4924f0849839f08692f39dde61\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCall(target, data, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n require(isContract(target), \\\"Address: static call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(isContract(target), \\\"Address: delegate call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n }\\n}\\n\",\"keccak256\":\"0x3777e696b62134e6177440dbe6e6601c0c156a443f57167194b67e75527439de\",\"license\":\"MIT\"},\"solc_0.8/openzeppelin/utils/StorageSlot.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/StorageSlot.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Library for reading and writing primitive types to specific storage slots.\\n *\\n * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.\\n * This library helps with reading and writing to such slots without the need for inline assembly.\\n *\\n * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.\\n *\\n * Example usage to set ERC1967 implementation slot:\\n * ```\\n * contract ERC1967 {\\n * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n *\\n * function _getImplementation() internal view returns (address) {\\n * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\\n * }\\n *\\n * function _setImplementation(address newImplementation) internal {\\n * require(Address.isContract(newImplementation), \\\"ERC1967: new implementation is not a contract\\\");\\n * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\\n * }\\n * }\\n * ```\\n *\\n * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._\\n */\\nlibrary StorageSlot {\\n struct AddressSlot {\\n address value;\\n }\\n\\n struct BooleanSlot {\\n bool value;\\n }\\n\\n struct Bytes32Slot {\\n bytes32 value;\\n }\\n\\n struct Uint256Slot {\\n uint256 value;\\n }\\n\\n /**\\n * @dev Returns an `AddressSlot` with member `value` located at `slot`.\\n */\\n function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `BooleanSlot` with member `value` located at `slot`.\\n */\\n function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.\\n */\\n function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n\\n /**\\n * @dev Returns an `Uint256Slot` with member `value` located at `slot`.\\n */\\n function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {\\n assembly {\\n r.slot := slot\\n }\\n }\\n}\\n\",\"keccak256\":\"0xfe1b7a9aa2a530a9e705b220e26cd584e2fbdc9602a3a1066032b12816b46aca\",\"license\":\"MIT\"},\"solc_0.8/proxy/OptimizedTransparentUpgradeableProxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (proxy/transparent/TransparentUpgradeableProxy.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../openzeppelin/proxy/ERC1967/ERC1967Proxy.sol\\\";\\n\\n/**\\n * @dev This contract implements a proxy that is upgradeable by an admin.\\n *\\n * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector\\n * clashing], which can potentially be used in an attack, this contract uses the\\n * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two\\n * things that go hand in hand:\\n *\\n * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if\\n * that call matches one of the admin functions exposed by the proxy itself.\\n * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the\\n * implementation. If the admin tries to call a function on the implementation it will fail with an error that says\\n * \\\"admin cannot fallback to proxy target\\\".\\n *\\n * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing\\n * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due\\n * to sudden errors when trying to call a function from the proxy implementation.\\n *\\n * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,\\n * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.\\n */\\ncontract OptimizedTransparentUpgradeableProxy is ERC1967Proxy {\\n address internal immutable _ADMIN;\\n\\n /**\\n * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and\\n * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.\\n */\\n constructor(\\n address _logic,\\n address admin_,\\n bytes memory _data\\n ) payable ERC1967Proxy(_logic, _data) {\\n assert(_ADMIN_SLOT == bytes32(uint256(keccak256(\\\"eip1967.proxy.admin\\\")) - 1));\\n _ADMIN = admin_;\\n\\n // still store it to work with EIP-1967\\n bytes32 slot = _ADMIN_SLOT;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(slot, admin_)\\n }\\n emit AdminChanged(address(0), admin_);\\n }\\n\\n /**\\n * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.\\n */\\n modifier ifAdmin() {\\n if (msg.sender == _getAdmin()) {\\n _;\\n } else {\\n _fallback();\\n }\\n }\\n\\n /**\\n * @dev Returns the current admin.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.\\n *\\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\\n * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`\\n */\\n function admin() external ifAdmin returns (address admin_) {\\n admin_ = _getAdmin();\\n }\\n\\n /**\\n * @dev Returns the current implementation.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.\\n *\\n * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the\\n * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\\n * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`\\n */\\n function implementation() external ifAdmin returns (address implementation_) {\\n implementation_ = _implementation();\\n }\\n\\n /**\\n * @dev Upgrade the implementation of the proxy.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.\\n */\\n function upgradeTo(address newImplementation) external ifAdmin {\\n _upgradeToAndCall(newImplementation, bytes(\\\"\\\"), false);\\n }\\n\\n /**\\n * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified\\n * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the\\n * proxied contract.\\n *\\n * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.\\n */\\n function upgradeToAndCall(address newImplementation, bytes calldata data) external payable ifAdmin {\\n _upgradeToAndCall(newImplementation, data, true);\\n }\\n\\n /**\\n * @dev Returns the current admin.\\n */\\n function _admin() internal view virtual returns (address) {\\n return _getAdmin();\\n }\\n\\n /**\\n * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.\\n */\\n function _beforeFallback() internal virtual override {\\n require(msg.sender != _getAdmin(), \\\"TransparentUpgradeableProxy: admin cannot fallback to proxy target\\\");\\n super._beforeFallback();\\n }\\n\\n function _getAdmin() internal view virtual override returns (address) {\\n return _ADMIN;\\n }\\n}\\n\",\"keccak256\":\"0xa30117644e27fa5b49e162aae2f62b36c1aca02f801b8c594d46e2024963a534\",\"license\":\"MIT\"}},\"version\":1}", + "bytecode": "0x60a060405260405162000f5f38038062000f5f83398101604081905262000026916200044a565b82816200005560017f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbd6200052a565b60008051602062000f188339815191521462000075576200007562000550565b62000083828260006200013c565b50620000b3905060017fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61046200052a565b60008051602062000ef883398151915214620000d357620000d362000550565b6001600160a01b038216608081905260008051602062000ef88339815191528381556040805160008152602081019390935290917f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f910160405180910390a150505050620005b9565b620001478362000179565b600082511180620001555750805b156200017457620001728383620001bb60201b620002a91760201c565b505b505050565b6200018481620001ea565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b6060620001e3838360405180606001604052806027815260200162000f3860279139620002b2565b9392505050565b62000200816200039860201b620002d51760201c565b620002685760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b60648201526084015b60405180910390fd5b806200029160008051602062000f1883398151915260001b620003a760201b620002411760201c565b80546001600160a01b0319166001600160a01b039290921691909117905550565b60606001600160a01b0384163b6200031c5760405162461bcd60e51b815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f6044820152651b9d1c9858dd60d21b60648201526084016200025f565b600080856001600160a01b03168560405162000339919062000566565b600060405180830381855af49150503d806000811462000376576040519150601f19603f3d011682016040523d82523d6000602084013e6200037b565b606091505b5090925090506200038e828286620003aa565b9695505050505050565b6001600160a01b03163b151590565b90565b60608315620003bb575081620001e3565b825115620003cc5782518084602001fd5b8160405162461bcd60e51b81526004016200025f919062000584565b80516001600160a01b03811681146200040057600080fd5b919050565b634e487b7160e01b600052604160045260246000fd5b60005b83811015620004385781810151838201526020016200041e565b83811115620001725750506000910152565b6000806000606084860312156200046057600080fd5b6200046b84620003e8565b92506200047b60208501620003e8565b60408501519092506001600160401b03808211156200049957600080fd5b818601915086601f830112620004ae57600080fd5b815181811115620004c357620004c362000405565b604051601f8201601f19908116603f01168101908382118183101715620004ee57620004ee62000405565b816040528281528960208487010111156200050857600080fd5b6200051b8360208301602088016200041b565b80955050505050509250925092565b6000828210156200054b57634e487b7160e01b600052601160045260246000fd5b500390565b634e487b7160e01b600052600160045260246000fd5b600082516200057a8184602087016200041b565b9190910192915050565b6020815260008251806020840152620005a58160408501602087016200041b565b601f01601f19169190910160400192915050565b608051610900620005f86000396000818161011201528181610176015281816102060152818161025e01528181610287015261030901526109006000f3fe6080604052600436106100435760003560e01c80633659cfe61461005a5780634f1ef2861461007a5780635c60da1b1461008d578063f851a440146100cb57610052565b36610052576100506100e0565b005b6100506100e0565b34801561006657600080fd5b5061005061007536600461076c565b6100fa565b610050610088366004610787565b61015e565b34801561009957600080fd5b506100a26101ec565b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390f35b3480156100d757600080fd5b506100a2610244565b6100e86102f1565b6100f86100f36103e2565b610422565b565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156101565761015381604051806020016040528060008152506000610446565b50565b6101536100e0565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156101e4576101df8383838080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525060019250610446915050565b505050565b6101df6100e0565b60003373ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000161415610239576102346103e2565b905090565b6102416100e0565b90565b60003373ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016141561023957507f000000000000000000000000000000000000000000000000000000000000000090565b60606102ce83836040518060600160405280602781526020016108a460279139610471565b9392505050565b73ffffffffffffffffffffffffffffffffffffffff163b151590565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156100f8576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f7879207461726760648201527f6574000000000000000000000000000000000000000000000000000000000000608482015260a4015b60405180910390fd5b60006102347f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc5473ffffffffffffffffffffffffffffffffffffffff1690565b3660008037600080366000845af43d6000803e808015610441573d6000f35b3d6000fd5b61044f83610599565b60008251118061045c5750805b156101df5761046b83836102a9565b50505050565b606073ffffffffffffffffffffffffffffffffffffffff84163b610517576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f60448201527f6e7472616374000000000000000000000000000000000000000000000000000060648201526084016103d9565b6000808573ffffffffffffffffffffffffffffffffffffffff168560405161053f9190610836565b600060405180830381855af49150503d806000811461057a576040519150601f19603f3d011682016040523d82523d6000602084013e61057f565b606091505b509150915061058f8282866105e6565b9695505050505050565b6105a281610639565b60405173ffffffffffffffffffffffffffffffffffffffff8216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b606083156105f55750816102ce565b8251156106055782518084602001fd5b816040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016103d99190610852565b73ffffffffffffffffffffffffffffffffffffffff81163b6106dd576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201527f6f74206120636f6e74726163740000000000000000000000000000000000000060648201526084016103d9565b7f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc80547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff92909216919091179055565b803573ffffffffffffffffffffffffffffffffffffffff8116811461076757600080fd5b919050565b60006020828403121561077e57600080fd5b6102ce82610743565b60008060006040848603121561079c57600080fd5b6107a584610743565b9250602084013567ffffffffffffffff808211156107c257600080fd5b818601915086601f8301126107d657600080fd5b8135818111156107e557600080fd5b8760208285010111156107f757600080fd5b6020830194508093505050509250925092565b60005b8381101561082557818101518382015260200161080d565b8381111561046b5750506000910152565b6000825161084881846020870161080a565b9190910192915050565b602081526000825180602084015261087181604085016020870161080a565b601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016919091016040019291505056fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a26469706673582212206f70214c51cdd41c05ba0ffeb72b309ca3c8be178fd6e73c12162330799984f364736f6c634300080a0033b53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564", + "deployedBytecode": "0x6080604052600436106100435760003560e01c80633659cfe61461005a5780634f1ef2861461007a5780635c60da1b1461008d578063f851a440146100cb57610052565b36610052576100506100e0565b005b6100506100e0565b34801561006657600080fd5b5061005061007536600461076c565b6100fa565b610050610088366004610787565b61015e565b34801561009957600080fd5b506100a26101ec565b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390f35b3480156100d757600080fd5b506100a2610244565b6100e86102f1565b6100f86100f36103e2565b610422565b565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156101565761015381604051806020016040528060008152506000610446565b50565b6101536100e0565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156101e4576101df8383838080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525060019250610446915050565b505050565b6101df6100e0565b60003373ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000161415610239576102346103e2565b905090565b6102416100e0565b90565b60003373ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016141561023957507f000000000000000000000000000000000000000000000000000000000000000090565b60606102ce83836040518060600160405280602781526020016108a460279139610471565b9392505050565b73ffffffffffffffffffffffffffffffffffffffff163b151590565b3373ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001614156100f8576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f7879207461726760648201527f6574000000000000000000000000000000000000000000000000000000000000608482015260a4015b60405180910390fd5b60006102347f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc5473ffffffffffffffffffffffffffffffffffffffff1690565b3660008037600080366000845af43d6000803e808015610441573d6000f35b3d6000fd5b61044f83610599565b60008251118061045c5750805b156101df5761046b83836102a9565b50505050565b606073ffffffffffffffffffffffffffffffffffffffff84163b610517576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f60448201527f6e7472616374000000000000000000000000000000000000000000000000000060648201526084016103d9565b6000808573ffffffffffffffffffffffffffffffffffffffff168560405161053f9190610836565b600060405180830381855af49150503d806000811461057a576040519150601f19603f3d011682016040523d82523d6000602084013e61057f565b606091505b509150915061058f8282866105e6565b9695505050505050565b6105a281610639565b60405173ffffffffffffffffffffffffffffffffffffffff8216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b606083156105f55750816102ce565b8251156106055782518084602001fd5b816040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016103d99190610852565b73ffffffffffffffffffffffffffffffffffffffff81163b6106dd576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201527f6f74206120636f6e74726163740000000000000000000000000000000000000060648201526084016103d9565b7f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc80547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff92909216919091179055565b803573ffffffffffffffffffffffffffffffffffffffff8116811461076757600080fd5b919050565b60006020828403121561077e57600080fd5b6102ce82610743565b60008060006040848603121561079c57600080fd5b6107a584610743565b9250602084013567ffffffffffffffff808211156107c257600080fd5b818601915086601f8301126107d657600080fd5b8135818111156107e557600080fd5b8760208285010111156107f757600080fd5b6020830194508093505050509250925092565b60005b8381101561082557818101518382015260200161080d565b8381111561046b5750506000910152565b6000825161084881846020870161080a565b9190910192915050565b602081526000825180602084015261087181604085016020870161080a565b601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016919091016040019291505056fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a26469706673582212206f70214c51cdd41c05ba0ffeb72b309ca3c8be178fd6e73c12162330799984f364736f6c634300080a0033", + "devdoc": { + "details": "This contract implements a proxy that is upgradeable by an admin. To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector clashing], which can potentially be used in an attack, this contract uses the https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two things that go hand in hand: 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if that call matches one of the admin functions exposed by the proxy itself. 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the implementation. If the admin tries to call a function on the implementation it will fail with an error that says \"admin cannot fallback to proxy target\". These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due to sudden errors when trying to call a function from the proxy implementation. Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way, you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.", + "kind": "dev", + "methods": { + "admin()": { + "details": "Returns the current admin. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`" + }, + "constructor": { + "details": "Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}." + }, + "implementation()": { + "details": "Returns the current implementation. NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}. TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call. `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`" + }, + "upgradeTo(address)": { + "details": "Upgrade the implementation of the proxy. NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}." + }, + "upgradeToAndCall(address,bytes)": { + "details": "Upgrade the implementation of the proxy, and then call a function from the new implementation as specified by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the proxied contract. NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}." + } + }, + "version": 1 + }, + "userdoc": { + "kind": "user", + "methods": {}, + "version": 1 + }, + "storageLayout": { + "storage": [], + "types": null + } +} diff --git a/deployments/sepolia/solcInputs/04e4e9272baf051bc64349e36ce2636f.json b/deployments/sepolia/solcInputs/04e4e9272baf051bc64349e36ce2636f.json new file mode 100644 index 00000000..399f4998 --- /dev/null +++ b/deployments/sepolia/solcInputs/04e4e9272baf051bc64349e36ce2636f.json @@ -0,0 +1,271 @@ +{ + "language": "Solidity", + "sources": { + "@chainlink/contracts/src/v0.8/interfaces/AggregatorInterface.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface AggregatorInterface {\n function latestAnswer() external view returns (int256);\n\n function latestTimestamp() external view returns (uint256);\n\n function latestRound() external view returns (uint256);\n\n function getAnswer(uint256 roundId) external view returns (int256);\n\n function getTimestamp(uint256 roundId) external view returns (uint256);\n\n event AnswerUpdated(int256 indexed current, uint256 indexed roundId, uint256 updatedAt);\n\n event NewRound(uint256 indexed roundId, address indexed startedBy, uint256 startedAt);\n}\n" + }, + "@chainlink/contracts/src/v0.8/interfaces/AggregatorV2V3Interface.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./AggregatorInterface.sol\";\nimport \"./AggregatorV3Interface.sol\";\n\ninterface AggregatorV2V3Interface is AggregatorInterface, AggregatorV3Interface {}\n" + }, + "@chainlink/contracts/src/v0.8/interfaces/AggregatorV3Interface.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface AggregatorV3Interface {\n function decimals() external view returns (uint8);\n\n function description() external view returns (string memory);\n\n function version() external view returns (uint256);\n\n function getRoundData(uint80 _roundId)\n external\n view\n returns (\n uint80 roundId,\n int256 answer,\n uint256 startedAt,\n uint256 updatedAt,\n uint80 answeredInRound\n );\n\n function latestRoundData()\n external\n view\n returns (\n uint80 roundId,\n int256 answer,\n uint256 startedAt,\n uint256 updatedAt,\n uint80 answeredInRound\n );\n}\n" + }, + "@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable2Step.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./OwnableUpgradeable.sol\";\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module which provides access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership} and {acceptOwnership}.\n *\n * This module is used through inheritance. It will make available all functions\n * from parent (Ownable).\n */\nabstract contract Ownable2StepUpgradeable is Initializable, OwnableUpgradeable {\n function __Ownable2Step_init() internal onlyInitializing {\n __Ownable_init_unchained();\n }\n\n function __Ownable2Step_init_unchained() internal onlyInitializing {\n }\n address private _pendingOwner;\n\n event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner);\n\n /**\n * @dev Returns the address of the pending owner.\n */\n function pendingOwner() public view virtual returns (address) {\n return _pendingOwner;\n }\n\n /**\n * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.\n * Can only be called by the current owner.\n */\n function transferOwnership(address newOwner) public virtual override onlyOwner {\n _pendingOwner = newOwner;\n emit OwnershipTransferStarted(owner(), newOwner);\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.\n * Internal function without access restriction.\n */\n function _transferOwnership(address newOwner) internal virtual override {\n delete _pendingOwner;\n super._transferOwnership(newOwner);\n }\n\n /**\n * @dev The new owner accepts the ownership transfer.\n */\n function acceptOwnership() public virtual {\n address sender = _msgSender();\n require(pendingOwner() == sender, \"Ownable2Step: caller is not the new owner\");\n _transferOwnership(sender);\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n}\n" + }, + "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/ContextUpgradeable.sol\";\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module which provides a basic access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership}.\n *\n * This module is used through inheritance. It will make available the modifier\n * `onlyOwner`, which can be applied to your functions to restrict their use to\n * the owner.\n */\nabstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {\n address private _owner;\n\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\n\n /**\n * @dev Initializes the contract setting the deployer as the initial owner.\n */\n function __Ownable_init() internal onlyInitializing {\n __Ownable_init_unchained();\n }\n\n function __Ownable_init_unchained() internal onlyInitializing {\n _transferOwnership(_msgSender());\n }\n\n /**\n * @dev Throws if called by any account other than the owner.\n */\n modifier onlyOwner() {\n _checkOwner();\n _;\n }\n\n /**\n * @dev Returns the address of the current owner.\n */\n function owner() public view virtual returns (address) {\n return _owner;\n }\n\n /**\n * @dev Throws if the sender is not the owner.\n */\n function _checkOwner() internal view virtual {\n require(owner() == _msgSender(), \"Ownable: caller is not the owner\");\n }\n\n /**\n * @dev Leaves the contract without owner. It will not be possible to call\n * `onlyOwner` functions. Can only be called by the current owner.\n *\n * NOTE: Renouncing ownership will leave the contract without an owner,\n * thereby disabling any functionality that is only available to the owner.\n */\n function renounceOwnership() public virtual onlyOwner {\n _transferOwnership(address(0));\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Can only be called by the current owner.\n */\n function transferOwnership(address newOwner) public virtual onlyOwner {\n require(newOwner != address(0), \"Ownable: new owner is the zero address\");\n _transferOwnership(newOwner);\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Internal function without access restriction.\n */\n function _transferOwnership(address newOwner) internal virtual {\n address oldOwner = _owner;\n _owner = newOwner;\n emit OwnershipTransferred(oldOwner, newOwner);\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n}\n" + }, + "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../../utils/AddressUpgradeable.sol\";\n\n/**\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\n *\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\n * reused. This mechanism prevents re-execution of each \"step\" but allows the creation of new initialization steps in\n * case an upgrade adds a module that needs to be initialized.\n *\n * For example:\n *\n * [.hljs-theme-light.nopadding]\n * ```solidity\n * contract MyToken is ERC20Upgradeable {\n * function initialize() initializer public {\n * __ERC20_init(\"MyToken\", \"MTK\");\n * }\n * }\n *\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\n * function initializeV2() reinitializer(2) public {\n * __ERC20Permit_init(\"MyToken\");\n * }\n * }\n * ```\n *\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\n *\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\n *\n * [CAUTION]\n * ====\n * Avoid leaving a contract uninitialized.\n *\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\n *\n * [.hljs-theme-light.nopadding]\n * ```\n * /// @custom:oz-upgrades-unsafe-allow constructor\n * constructor() {\n * _disableInitializers();\n * }\n * ```\n * ====\n */\nabstract contract Initializable {\n /**\n * @dev Indicates that the contract has been initialized.\n * @custom:oz-retyped-from bool\n */\n uint8 private _initialized;\n\n /**\n * @dev Indicates that the contract is in the process of being initialized.\n */\n bool private _initializing;\n\n /**\n * @dev Triggered when the contract has been initialized or reinitialized.\n */\n event Initialized(uint8 version);\n\n /**\n * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\n * `onlyInitializing` functions can be used to initialize parent contracts.\n *\n * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\n * constructor.\n *\n * Emits an {Initialized} event.\n */\n modifier initializer() {\n bool isTopLevelCall = !_initializing;\n require(\n (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\n \"Initializable: contract is already initialized\"\n );\n _initialized = 1;\n if (isTopLevelCall) {\n _initializing = true;\n }\n _;\n if (isTopLevelCall) {\n _initializing = false;\n emit Initialized(1);\n }\n }\n\n /**\n * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\n * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\n * used to initialize parent contracts.\n *\n * A reinitializer may be used after the original initialization step. This is essential to configure modules that\n * are added through upgrades and that require initialization.\n *\n * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\n * cannot be nested. If one is invoked in the context of another, execution will revert.\n *\n * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\n * a contract, executing them in the right order is up to the developer or operator.\n *\n * WARNING: setting the version to 255 will prevent any future reinitialization.\n *\n * Emits an {Initialized} event.\n */\n modifier reinitializer(uint8 version) {\n require(!_initializing && _initialized < version, \"Initializable: contract is already initialized\");\n _initialized = version;\n _initializing = true;\n _;\n _initializing = false;\n emit Initialized(version);\n }\n\n /**\n * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\n * {initializer} and {reinitializer} modifiers, directly or indirectly.\n */\n modifier onlyInitializing() {\n require(_initializing, \"Initializable: contract is not initializing\");\n _;\n }\n\n /**\n * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\n * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\n * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\n * through proxies.\n *\n * Emits an {Initialized} event the first time it is successfully executed.\n */\n function _disableInitializers() internal virtual {\n require(!_initializing, \"Initializable: contract is initializing\");\n if (_initialized != type(uint8).max) {\n _initialized = type(uint8).max;\n emit Initialized(type(uint8).max);\n }\n }\n\n /**\n * @dev Returns the highest version that has been initialized. See {reinitializer}.\n */\n function _getInitializedVersion() internal view returns (uint8) {\n return _initialized;\n }\n\n /**\n * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\n */\n function _isInitializing() internal view returns (bool) {\n return _initializing;\n }\n}\n" + }, + "@openzeppelin/contracts-upgradeable/security/PausableUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/ContextUpgradeable.sol\";\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module which allows children to implement an emergency stop\n * mechanism that can be triggered by an authorized account.\n *\n * This module is used through inheritance. It will make available the\n * modifiers `whenNotPaused` and `whenPaused`, which can be applied to\n * the functions of your contract. Note that they will not be pausable by\n * simply including this module, only once the modifiers are put in place.\n */\nabstract contract PausableUpgradeable is Initializable, ContextUpgradeable {\n /**\n * @dev Emitted when the pause is triggered by `account`.\n */\n event Paused(address account);\n\n /**\n * @dev Emitted when the pause is lifted by `account`.\n */\n event Unpaused(address account);\n\n bool private _paused;\n\n /**\n * @dev Initializes the contract in unpaused state.\n */\n function __Pausable_init() internal onlyInitializing {\n __Pausable_init_unchained();\n }\n\n function __Pausable_init_unchained() internal onlyInitializing {\n _paused = false;\n }\n\n /**\n * @dev Modifier to make a function callable only when the contract is not paused.\n *\n * Requirements:\n *\n * - The contract must not be paused.\n */\n modifier whenNotPaused() {\n _requireNotPaused();\n _;\n }\n\n /**\n * @dev Modifier to make a function callable only when the contract is paused.\n *\n * Requirements:\n *\n * - The contract must be paused.\n */\n modifier whenPaused() {\n _requirePaused();\n _;\n }\n\n /**\n * @dev Returns true if the contract is paused, and false otherwise.\n */\n function paused() public view virtual returns (bool) {\n return _paused;\n }\n\n /**\n * @dev Throws if the contract is paused.\n */\n function _requireNotPaused() internal view virtual {\n require(!paused(), \"Pausable: paused\");\n }\n\n /**\n * @dev Throws if the contract is not paused.\n */\n function _requirePaused() internal view virtual {\n require(paused(), \"Pausable: not paused\");\n }\n\n /**\n * @dev Triggers stopped state.\n *\n * Requirements:\n *\n * - The contract must not be paused.\n */\n function _pause() internal virtual whenNotPaused {\n _paused = true;\n emit Paused(_msgSender());\n }\n\n /**\n * @dev Returns to normal state.\n *\n * Requirements:\n *\n * - The contract must be paused.\n */\n function _unpause() internal virtual whenPaused {\n _paused = false;\n emit Unpaused(_msgSender());\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n}\n" + }, + "@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary AddressUpgradeable {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n" + }, + "@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\n\npragma solidity ^0.8.0;\nimport \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Provides information about the current execution context, including the\n * sender of the transaction and its data. While these are generally available\n * via msg.sender and msg.data, they should not be accessed in such a direct\n * manner, since when dealing with meta-transactions the account sending and\n * paying for execution may not be the actual sender (as far as an application\n * is concerned).\n *\n * This contract is only required for intermediate, library-like contracts.\n */\nabstract contract ContextUpgradeable is Initializable {\n function __Context_init() internal onlyInitializing {\n }\n\n function __Context_init_unchained() internal onlyInitializing {\n }\n function _msgSender() internal view virtual returns (address) {\n return msg.sender;\n }\n\n function _msgData() internal view virtual returns (bytes calldata) {\n return msg.data;\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[50] private __gap;\n}\n" + }, + "@openzeppelin/contracts/access/AccessControl.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/AccessControl.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IAccessControl.sol\";\nimport \"../utils/Context.sol\";\nimport \"../utils/Strings.sol\";\nimport \"../utils/introspection/ERC165.sol\";\n\n/**\n * @dev Contract module that allows children to implement role-based access\n * control mechanisms. This is a lightweight version that doesn't allow enumerating role\n * members except through off-chain means by accessing the contract event logs. Some\n * applications may benefit from on-chain enumerability, for those cases see\n * {AccessControlEnumerable}.\n *\n * Roles are referred to by their `bytes32` identifier. These should be exposed\n * in the external API and be unique. The best way to achieve this is by\n * using `public constant` hash digests:\n *\n * ```solidity\n * bytes32 public constant MY_ROLE = keccak256(\"MY_ROLE\");\n * ```\n *\n * Roles can be used to represent a set of permissions. To restrict access to a\n * function call, use {hasRole}:\n *\n * ```solidity\n * function foo() public {\n * require(hasRole(MY_ROLE, msg.sender));\n * ...\n * }\n * ```\n *\n * Roles can be granted and revoked dynamically via the {grantRole} and\n * {revokeRole} functions. Each role has an associated admin role, and only\n * accounts that have a role's admin role can call {grantRole} and {revokeRole}.\n *\n * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means\n * that only accounts with this role will be able to grant or revoke other\n * roles. More complex role relationships can be created by using\n * {_setRoleAdmin}.\n *\n * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to\n * grant and revoke this role. Extra precautions should be taken to secure\n * accounts that have been granted it. We recommend using {AccessControlDefaultAdminRules}\n * to enforce additional security measures for this role.\n */\nabstract contract AccessControl is Context, IAccessControl, ERC165 {\n struct RoleData {\n mapping(address => bool) members;\n bytes32 adminRole;\n }\n\n mapping(bytes32 => RoleData) private _roles;\n\n bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;\n\n /**\n * @dev Modifier that checks that an account has a specific role. Reverts\n * with a standardized message including the required role.\n *\n * The format of the revert reason is given by the following regular expression:\n *\n * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/\n *\n * _Available since v4.1._\n */\n modifier onlyRole(bytes32 role) {\n _checkRole(role);\n _;\n }\n\n /**\n * @dev See {IERC165-supportsInterface}.\n */\n function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId);\n }\n\n /**\n * @dev Returns `true` if `account` has been granted `role`.\n */\n function hasRole(bytes32 role, address account) public view virtual override returns (bool) {\n return _roles[role].members[account];\n }\n\n /**\n * @dev Revert with a standard message if `_msgSender()` is missing `role`.\n * Overriding this function changes the behavior of the {onlyRole} modifier.\n *\n * Format of the revert message is described in {_checkRole}.\n *\n * _Available since v4.6._\n */\n function _checkRole(bytes32 role) internal view virtual {\n _checkRole(role, _msgSender());\n }\n\n /**\n * @dev Revert with a standard message if `account` is missing `role`.\n *\n * The format of the revert reason is given by the following regular expression:\n *\n * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/\n */\n function _checkRole(bytes32 role, address account) internal view virtual {\n if (!hasRole(role, account)) {\n revert(\n string(\n abi.encodePacked(\n \"AccessControl: account \",\n Strings.toHexString(account),\n \" is missing role \",\n Strings.toHexString(uint256(role), 32)\n )\n )\n );\n }\n }\n\n /**\n * @dev Returns the admin role that controls `role`. See {grantRole} and\n * {revokeRole}.\n *\n * To change a role's admin, use {_setRoleAdmin}.\n */\n function getRoleAdmin(bytes32 role) public view virtual override returns (bytes32) {\n return _roles[role].adminRole;\n }\n\n /**\n * @dev Grants `role` to `account`.\n *\n * If `account` had not been already granted `role`, emits a {RoleGranted}\n * event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n *\n * May emit a {RoleGranted} event.\n */\n function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {\n _grantRole(role, account);\n }\n\n /**\n * @dev Revokes `role` from `account`.\n *\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n *\n * May emit a {RoleRevoked} event.\n */\n function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {\n _revokeRole(role, account);\n }\n\n /**\n * @dev Revokes `role` from the calling account.\n *\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\n * purpose is to provide a mechanism for accounts to lose their privileges\n * if they are compromised (such as when a trusted device is misplaced).\n *\n * If the calling account had been revoked `role`, emits a {RoleRevoked}\n * event.\n *\n * Requirements:\n *\n * - the caller must be `account`.\n *\n * May emit a {RoleRevoked} event.\n */\n function renounceRole(bytes32 role, address account) public virtual override {\n require(account == _msgSender(), \"AccessControl: can only renounce roles for self\");\n\n _revokeRole(role, account);\n }\n\n /**\n * @dev Grants `role` to `account`.\n *\n * If `account` had not been already granted `role`, emits a {RoleGranted}\n * event. Note that unlike {grantRole}, this function doesn't perform any\n * checks on the calling account.\n *\n * May emit a {RoleGranted} event.\n *\n * [WARNING]\n * ====\n * This function should only be called from the constructor when setting\n * up the initial roles for the system.\n *\n * Using this function in any other way is effectively circumventing the admin\n * system imposed by {AccessControl}.\n * ====\n *\n * NOTE: This function is deprecated in favor of {_grantRole}.\n */\n function _setupRole(bytes32 role, address account) internal virtual {\n _grantRole(role, account);\n }\n\n /**\n * @dev Sets `adminRole` as ``role``'s admin role.\n *\n * Emits a {RoleAdminChanged} event.\n */\n function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {\n bytes32 previousAdminRole = getRoleAdmin(role);\n _roles[role].adminRole = adminRole;\n emit RoleAdminChanged(role, previousAdminRole, adminRole);\n }\n\n /**\n * @dev Grants `role` to `account`.\n *\n * Internal function without access restriction.\n *\n * May emit a {RoleGranted} event.\n */\n function _grantRole(bytes32 role, address account) internal virtual {\n if (!hasRole(role, account)) {\n _roles[role].members[account] = true;\n emit RoleGranted(role, account, _msgSender());\n }\n }\n\n /**\n * @dev Revokes `role` from `account`.\n *\n * Internal function without access restriction.\n *\n * May emit a {RoleRevoked} event.\n */\n function _revokeRole(bytes32 role, address account) internal virtual {\n if (hasRole(role, account)) {\n _roles[role].members[account] = false;\n emit RoleRevoked(role, account, _msgSender());\n }\n }\n}\n" + }, + "@openzeppelin/contracts/access/IAccessControl.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev External interface of AccessControl declared to support ERC165 detection.\n */\ninterface IAccessControl {\n /**\n * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`\n *\n * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite\n * {RoleAdminChanged} not being emitted signaling this.\n *\n * _Available since v3.1._\n */\n event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);\n\n /**\n * @dev Emitted when `account` is granted `role`.\n *\n * `sender` is the account that originated the contract call, an admin role\n * bearer except when using {AccessControl-_setupRole}.\n */\n event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);\n\n /**\n * @dev Emitted when `account` is revoked `role`.\n *\n * `sender` is the account that originated the contract call:\n * - if using `revokeRole`, it is the admin role bearer\n * - if using `renounceRole`, it is the role bearer (i.e. `account`)\n */\n event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);\n\n /**\n * @dev Returns `true` if `account` has been granted `role`.\n */\n function hasRole(bytes32 role, address account) external view returns (bool);\n\n /**\n * @dev Returns the admin role that controls `role`. See {grantRole} and\n * {revokeRole}.\n *\n * To change a role's admin, use {AccessControl-_setRoleAdmin}.\n */\n function getRoleAdmin(bytes32 role) external view returns (bytes32);\n\n /**\n * @dev Grants `role` to `account`.\n *\n * If `account` had not been already granted `role`, emits a {RoleGranted}\n * event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n */\n function grantRole(bytes32 role, address account) external;\n\n /**\n * @dev Revokes `role` from `account`.\n *\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n */\n function revokeRole(bytes32 role, address account) external;\n\n /**\n * @dev Revokes `role` from the calling account.\n *\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\n * purpose is to provide a mechanism for accounts to lose their privileges\n * if they are compromised (such as when a trusted device is misplaced).\n *\n * If the calling account had been granted `role`, emits a {RoleRevoked}\n * event.\n *\n * Requirements:\n *\n * - the caller must be `account`.\n */\n function renounceRole(bytes32 role, address account) external;\n}\n" + }, + "@openzeppelin/contracts/access/Ownable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/Context.sol\";\n\n/**\n * @dev Contract module which provides a basic access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership}.\n *\n * This module is used through inheritance. It will make available the modifier\n * `onlyOwner`, which can be applied to your functions to restrict their use to\n * the owner.\n */\nabstract contract Ownable is Context {\n address private _owner;\n\n event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\n\n /**\n * @dev Initializes the contract setting the deployer as the initial owner.\n */\n constructor() {\n _transferOwnership(_msgSender());\n }\n\n /**\n * @dev Throws if called by any account other than the owner.\n */\n modifier onlyOwner() {\n _checkOwner();\n _;\n }\n\n /**\n * @dev Returns the address of the current owner.\n */\n function owner() public view virtual returns (address) {\n return _owner;\n }\n\n /**\n * @dev Throws if the sender is not the owner.\n */\n function _checkOwner() internal view virtual {\n require(owner() == _msgSender(), \"Ownable: caller is not the owner\");\n }\n\n /**\n * @dev Leaves the contract without owner. It will not be possible to call\n * `onlyOwner` functions. Can only be called by the current owner.\n *\n * NOTE: Renouncing ownership will leave the contract without an owner,\n * thereby disabling any functionality that is only available to the owner.\n */\n function renounceOwnership() public virtual onlyOwner {\n _transferOwnership(address(0));\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Can only be called by the current owner.\n */\n function transferOwnership(address newOwner) public virtual onlyOwner {\n require(newOwner != address(0), \"Ownable: new owner is the zero address\");\n _transferOwnership(newOwner);\n }\n\n /**\n * @dev Transfers ownership of the contract to a new account (`newOwner`).\n * Internal function without access restriction.\n */\n function _transferOwnership(address newOwner) internal virtual {\n address oldOwner = _owner;\n _owner = newOwner;\n emit OwnershipTransferred(oldOwner, newOwner);\n }\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/ERC20.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/ERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IERC20.sol\";\nimport \"./extensions/IERC20Metadata.sol\";\nimport \"../../utils/Context.sol\";\n\n/**\n * @dev Implementation of the {IERC20} interface.\n *\n * This implementation is agnostic to the way tokens are created. This means\n * that a supply mechanism has to be added in a derived contract using {_mint}.\n * For a generic mechanism see {ERC20PresetMinterPauser}.\n *\n * TIP: For a detailed writeup see our guide\n * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How\n * to implement supply mechanisms].\n *\n * The default value of {decimals} is 18. To change this, you should override\n * this function so it returns a different value.\n *\n * We have followed general OpenZeppelin Contracts guidelines: functions revert\n * instead returning `false` on failure. This behavior is nonetheless\n * conventional and does not conflict with the expectations of ERC20\n * applications.\n *\n * Additionally, an {Approval} event is emitted on calls to {transferFrom}.\n * This allows applications to reconstruct the allowance for all accounts just\n * by listening to said events. Other implementations of the EIP may not emit\n * these events, as it isn't required by the specification.\n *\n * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}\n * functions have been added to mitigate the well-known issues around setting\n * allowances. See {IERC20-approve}.\n */\ncontract ERC20 is Context, IERC20, IERC20Metadata {\n mapping(address => uint256) private _balances;\n\n mapping(address => mapping(address => uint256)) private _allowances;\n\n uint256 private _totalSupply;\n\n string private _name;\n string private _symbol;\n\n /**\n * @dev Sets the values for {name} and {symbol}.\n *\n * All two of these values are immutable: they can only be set once during\n * construction.\n */\n constructor(string memory name_, string memory symbol_) {\n _name = name_;\n _symbol = symbol_;\n }\n\n /**\n * @dev Returns the name of the token.\n */\n function name() public view virtual override returns (string memory) {\n return _name;\n }\n\n /**\n * @dev Returns the symbol of the token, usually a shorter version of the\n * name.\n */\n function symbol() public view virtual override returns (string memory) {\n return _symbol;\n }\n\n /**\n * @dev Returns the number of decimals used to get its user representation.\n * For example, if `decimals` equals `2`, a balance of `505` tokens should\n * be displayed to a user as `5.05` (`505 / 10 ** 2`).\n *\n * Tokens usually opt for a value of 18, imitating the relationship between\n * Ether and Wei. This is the default value returned by this function, unless\n * it's overridden.\n *\n * NOTE: This information is only used for _display_ purposes: it in\n * no way affects any of the arithmetic of the contract, including\n * {IERC20-balanceOf} and {IERC20-transfer}.\n */\n function decimals() public view virtual override returns (uint8) {\n return 18;\n }\n\n /**\n * @dev See {IERC20-totalSupply}.\n */\n function totalSupply() public view virtual override returns (uint256) {\n return _totalSupply;\n }\n\n /**\n * @dev See {IERC20-balanceOf}.\n */\n function balanceOf(address account) public view virtual override returns (uint256) {\n return _balances[account];\n }\n\n /**\n * @dev See {IERC20-transfer}.\n *\n * Requirements:\n *\n * - `to` cannot be the zero address.\n * - the caller must have a balance of at least `amount`.\n */\n function transfer(address to, uint256 amount) public virtual override returns (bool) {\n address owner = _msgSender();\n _transfer(owner, to, amount);\n return true;\n }\n\n /**\n * @dev See {IERC20-allowance}.\n */\n function allowance(address owner, address spender) public view virtual override returns (uint256) {\n return _allowances[owner][spender];\n }\n\n /**\n * @dev See {IERC20-approve}.\n *\n * NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on\n * `transferFrom`. This is semantically equivalent to an infinite approval.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n */\n function approve(address spender, uint256 amount) public virtual override returns (bool) {\n address owner = _msgSender();\n _approve(owner, spender, amount);\n return true;\n }\n\n /**\n * @dev See {IERC20-transferFrom}.\n *\n * Emits an {Approval} event indicating the updated allowance. This is not\n * required by the EIP. See the note at the beginning of {ERC20}.\n *\n * NOTE: Does not update the allowance if the current allowance\n * is the maximum `uint256`.\n *\n * Requirements:\n *\n * - `from` and `to` cannot be the zero address.\n * - `from` must have a balance of at least `amount`.\n * - the caller must have allowance for ``from``'s tokens of at least\n * `amount`.\n */\n function transferFrom(address from, address to, uint256 amount) public virtual override returns (bool) {\n address spender = _msgSender();\n _spendAllowance(from, spender, amount);\n _transfer(from, to, amount);\n return true;\n }\n\n /**\n * @dev Atomically increases the allowance granted to `spender` by the caller.\n *\n * This is an alternative to {approve} that can be used as a mitigation for\n * problems described in {IERC20-approve}.\n *\n * Emits an {Approval} event indicating the updated allowance.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n */\n function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {\n address owner = _msgSender();\n _approve(owner, spender, allowance(owner, spender) + addedValue);\n return true;\n }\n\n /**\n * @dev Atomically decreases the allowance granted to `spender` by the caller.\n *\n * This is an alternative to {approve} that can be used as a mitigation for\n * problems described in {IERC20-approve}.\n *\n * Emits an {Approval} event indicating the updated allowance.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n * - `spender` must have allowance for the caller of at least\n * `subtractedValue`.\n */\n function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {\n address owner = _msgSender();\n uint256 currentAllowance = allowance(owner, spender);\n require(currentAllowance >= subtractedValue, \"ERC20: decreased allowance below zero\");\n unchecked {\n _approve(owner, spender, currentAllowance - subtractedValue);\n }\n\n return true;\n }\n\n /**\n * @dev Moves `amount` of tokens from `from` to `to`.\n *\n * This internal function is equivalent to {transfer}, and can be used to\n * e.g. implement automatic token fees, slashing mechanisms, etc.\n *\n * Emits a {Transfer} event.\n *\n * Requirements:\n *\n * - `from` cannot be the zero address.\n * - `to` cannot be the zero address.\n * - `from` must have a balance of at least `amount`.\n */\n function _transfer(address from, address to, uint256 amount) internal virtual {\n require(from != address(0), \"ERC20: transfer from the zero address\");\n require(to != address(0), \"ERC20: transfer to the zero address\");\n\n _beforeTokenTransfer(from, to, amount);\n\n uint256 fromBalance = _balances[from];\n require(fromBalance >= amount, \"ERC20: transfer amount exceeds balance\");\n unchecked {\n _balances[from] = fromBalance - amount;\n // Overflow not possible: the sum of all balances is capped by totalSupply, and the sum is preserved by\n // decrementing then incrementing.\n _balances[to] += amount;\n }\n\n emit Transfer(from, to, amount);\n\n _afterTokenTransfer(from, to, amount);\n }\n\n /** @dev Creates `amount` tokens and assigns them to `account`, increasing\n * the total supply.\n *\n * Emits a {Transfer} event with `from` set to the zero address.\n *\n * Requirements:\n *\n * - `account` cannot be the zero address.\n */\n function _mint(address account, uint256 amount) internal virtual {\n require(account != address(0), \"ERC20: mint to the zero address\");\n\n _beforeTokenTransfer(address(0), account, amount);\n\n _totalSupply += amount;\n unchecked {\n // Overflow not possible: balance + amount is at most totalSupply + amount, which is checked above.\n _balances[account] += amount;\n }\n emit Transfer(address(0), account, amount);\n\n _afterTokenTransfer(address(0), account, amount);\n }\n\n /**\n * @dev Destroys `amount` tokens from `account`, reducing the\n * total supply.\n *\n * Emits a {Transfer} event with `to` set to the zero address.\n *\n * Requirements:\n *\n * - `account` cannot be the zero address.\n * - `account` must have at least `amount` tokens.\n */\n function _burn(address account, uint256 amount) internal virtual {\n require(account != address(0), \"ERC20: burn from the zero address\");\n\n _beforeTokenTransfer(account, address(0), amount);\n\n uint256 accountBalance = _balances[account];\n require(accountBalance >= amount, \"ERC20: burn amount exceeds balance\");\n unchecked {\n _balances[account] = accountBalance - amount;\n // Overflow not possible: amount <= accountBalance <= totalSupply.\n _totalSupply -= amount;\n }\n\n emit Transfer(account, address(0), amount);\n\n _afterTokenTransfer(account, address(0), amount);\n }\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.\n *\n * This internal function is equivalent to `approve`, and can be used to\n * e.g. set automatic allowances for certain subsystems, etc.\n *\n * Emits an {Approval} event.\n *\n * Requirements:\n *\n * - `owner` cannot be the zero address.\n * - `spender` cannot be the zero address.\n */\n function _approve(address owner, address spender, uint256 amount) internal virtual {\n require(owner != address(0), \"ERC20: approve from the zero address\");\n require(spender != address(0), \"ERC20: approve to the zero address\");\n\n _allowances[owner][spender] = amount;\n emit Approval(owner, spender, amount);\n }\n\n /**\n * @dev Updates `owner` s allowance for `spender` based on spent `amount`.\n *\n * Does not update the allowance amount in case of infinite allowance.\n * Revert if not enough allowance is available.\n *\n * Might emit an {Approval} event.\n */\n function _spendAllowance(address owner, address spender, uint256 amount) internal virtual {\n uint256 currentAllowance = allowance(owner, spender);\n if (currentAllowance != type(uint256).max) {\n require(currentAllowance >= amount, \"ERC20: insufficient allowance\");\n unchecked {\n _approve(owner, spender, currentAllowance - amount);\n }\n }\n }\n\n /**\n * @dev Hook that is called before any transfer of tokens. This includes\n * minting and burning.\n *\n * Calling conditions:\n *\n * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens\n * will be transferred to `to`.\n * - when `from` is zero, `amount` tokens will be minted for `to`.\n * - when `to` is zero, `amount` of ``from``'s tokens will be burned.\n * - `from` and `to` are never both zero.\n *\n * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].\n */\n function _beforeTokenTransfer(address from, address to, uint256 amount) internal virtual {}\n\n /**\n * @dev Hook that is called after any transfer of tokens. This includes\n * minting and burning.\n *\n * Calling conditions:\n *\n * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens\n * has been transferred to `to`.\n * - when `from` is zero, `amount` tokens have been minted for `to`.\n * - when `to` is zero, `amount` of ``from``'s tokens have been burned.\n * - `from` and `to` are never both zero.\n *\n * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].\n */\n function _afterTokenTransfer(address from, address to, uint256 amount) internal virtual {}\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20.sol\";\n\n/**\n * @dev Interface for the optional metadata functions from the ERC20 standard.\n *\n * _Available since v4.1._\n */\ninterface IERC20Metadata is IERC20 {\n /**\n * @dev Returns the name of the token.\n */\n function name() external view returns (string memory);\n\n /**\n * @dev Returns the symbol of the token.\n */\n function symbol() external view returns (string memory);\n\n /**\n * @dev Returns the decimals places of the token.\n */\n function decimals() external view returns (uint8);\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/IERC20.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 standard as defined in the EIP.\n */\ninterface IERC20 {\n /**\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\n * another (`to`).\n *\n * Note that `value` may be zero.\n */\n event Transfer(address indexed from, address indexed to, uint256 value);\n\n /**\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\n * a call to {approve}. `value` is the new allowance.\n */\n event Approval(address indexed owner, address indexed spender, uint256 value);\n\n /**\n * @dev Returns the amount of tokens in existence.\n */\n function totalSupply() external view returns (uint256);\n\n /**\n * @dev Returns the amount of tokens owned by `account`.\n */\n function balanceOf(address account) external view returns (uint256);\n\n /**\n * @dev Moves `amount` tokens from the caller's account to `to`.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transfer(address to, uint256 amount) external returns (bool);\n\n /**\n * @dev Returns the remaining number of tokens that `spender` will be\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\n * zero by default.\n *\n * This value changes when {approve} or {transferFrom} are called.\n */\n function allowance(address owner, address spender) external view returns (uint256);\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\n * that someone may use both the old and the new allowance by unfortunate\n * transaction ordering. One possible solution to mitigate this race\n * condition is to first reduce the spender's allowance to 0 and set the\n * desired value afterwards:\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n *\n * Emits an {Approval} event.\n */\n function approve(address spender, uint256 amount) external returns (bool);\n\n /**\n * @dev Moves `amount` tokens from `from` to `to` using the\n * allowance mechanism. `amount` is then deducted from the caller's\n * allowance.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\n}\n" + }, + "@openzeppelin/contracts/utils/Context.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Provides information about the current execution context, including the\n * sender of the transaction and its data. While these are generally available\n * via msg.sender and msg.data, they should not be accessed in such a direct\n * manner, since when dealing with meta-transactions the account sending and\n * paying for execution may not be the actual sender (as far as an application\n * is concerned).\n *\n * This contract is only required for intermediate, library-like contracts.\n */\nabstract contract Context {\n function _msgSender() internal view virtual returns (address) {\n return msg.sender;\n }\n\n function _msgData() internal view virtual returns (bytes calldata) {\n return msg.data;\n }\n}\n" + }, + "@openzeppelin/contracts/utils/introspection/ERC165.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IERC165.sol\";\n\n/**\n * @dev Implementation of the {IERC165} interface.\n *\n * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check\n * for the additional interface id that will be supported. For example:\n *\n * ```solidity\n * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n * return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);\n * }\n * ```\n *\n * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.\n */\nabstract contract ERC165 is IERC165 {\n /**\n * @dev See {IERC165-supportsInterface}.\n */\n function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n return interfaceId == type(IERC165).interfaceId;\n }\n}\n" + }, + "@openzeppelin/contracts/utils/introspection/IERC165.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC165 standard, as defined in the\n * https://eips.ethereum.org/EIPS/eip-165[EIP].\n *\n * Implementers can declare support of contract interfaces, which can then be\n * queried by others ({ERC165Checker}).\n *\n * For an implementation, see {ERC165}.\n */\ninterface IERC165 {\n /**\n * @dev Returns true if this contract implements the interface defined by\n * `interfaceId`. See the corresponding\n * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]\n * to learn more about how these ids are created.\n *\n * This function call must use less than 30 000 gas.\n */\n function supportsInterface(bytes4 interfaceId) external view returns (bool);\n}\n" + }, + "@openzeppelin/contracts/utils/math/Math.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard math utilities missing in the Solidity language.\n */\nlibrary Math {\n enum Rounding {\n Down, // Toward negative infinity\n Up, // Toward infinity\n Zero // Toward zero\n }\n\n /**\n * @dev Returns the largest of two numbers.\n */\n function max(uint256 a, uint256 b) internal pure returns (uint256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two numbers.\n */\n function min(uint256 a, uint256 b) internal pure returns (uint256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two numbers. The result is rounded towards\n * zero.\n */\n function average(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b) / 2 can overflow.\n return (a & b) + (a ^ b) / 2;\n }\n\n /**\n * @dev Returns the ceiling of the division of two numbers.\n *\n * This differs from standard division with `/` in that it rounds up instead\n * of rounding down.\n */\n function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b - 1) / b can overflow on addition, so we distribute.\n return a == 0 ? 0 : (a - 1) / b + 1;\n }\n\n /**\n * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0\n * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)\n * with further edits by Uniswap Labs also under MIT license.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {\n unchecked {\n // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use\n // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\n // variables such that product = prod1 * 2^256 + prod0.\n uint256 prod0; // Least significant 256 bits of the product\n uint256 prod1; // Most significant 256 bits of the product\n assembly {\n let mm := mulmod(x, y, not(0))\n prod0 := mul(x, y)\n prod1 := sub(sub(mm, prod0), lt(mm, prod0))\n }\n\n // Handle non-overflow cases, 256 by 256 division.\n if (prod1 == 0) {\n // Solidity will revert if denominator == 0, unlike the div opcode on its own.\n // The surrounding unchecked block does not change this fact.\n // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.\n return prod0 / denominator;\n }\n\n // Make sure the result is less than 2^256. Also prevents denominator == 0.\n require(denominator > prod1, \"Math: mulDiv overflow\");\n\n ///////////////////////////////////////////////\n // 512 by 256 division.\n ///////////////////////////////////////////////\n\n // Make division exact by subtracting the remainder from [prod1 prod0].\n uint256 remainder;\n assembly {\n // Compute remainder using mulmod.\n remainder := mulmod(x, y, denominator)\n\n // Subtract 256 bit number from 512 bit number.\n prod1 := sub(prod1, gt(remainder, prod0))\n prod0 := sub(prod0, remainder)\n }\n\n // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.\n // See https://cs.stackexchange.com/q/138556/92363.\n\n // Does not overflow because the denominator cannot be zero at this stage in the function.\n uint256 twos = denominator & (~denominator + 1);\n assembly {\n // Divide denominator by twos.\n denominator := div(denominator, twos)\n\n // Divide [prod1 prod0] by twos.\n prod0 := div(prod0, twos)\n\n // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.\n twos := add(div(sub(0, twos), twos), 1)\n }\n\n // Shift in bits from prod1 into prod0.\n prod0 |= prod1 * twos;\n\n // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such\n // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for\n // four bits. That is, denominator * inv = 1 mod 2^4.\n uint256 inverse = (3 * denominator) ^ 2;\n\n // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works\n // in modular arithmetic, doubling the correct bits in each step.\n inverse *= 2 - denominator * inverse; // inverse mod 2^8\n inverse *= 2 - denominator * inverse; // inverse mod 2^16\n inverse *= 2 - denominator * inverse; // inverse mod 2^32\n inverse *= 2 - denominator * inverse; // inverse mod 2^64\n inverse *= 2 - denominator * inverse; // inverse mod 2^128\n inverse *= 2 - denominator * inverse; // inverse mod 2^256\n\n // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.\n // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is\n // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1\n // is no longer required.\n result = prod0 * inverse;\n return result;\n }\n }\n\n /**\n * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {\n uint256 result = mulDiv(x, y, denominator);\n if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {\n result += 1;\n }\n return result;\n }\n\n /**\n * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.\n *\n * Inspired by Henry S. Warren, Jr.'s \"Hacker's Delight\" (Chapter 11).\n */\n function sqrt(uint256 a) internal pure returns (uint256) {\n if (a == 0) {\n return 0;\n }\n\n // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.\n //\n // We know that the \"msb\" (most significant bit) of our target number `a` is a power of 2 such that we have\n // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.\n //\n // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`\n // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`\n // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`\n //\n // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.\n uint256 result = 1 << (log2(a) >> 1);\n\n // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,\n // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at\n // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision\n // into the expected uint128 result.\n unchecked {\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n return min(result, a / result);\n }\n }\n\n /**\n * @notice Calculates sqrt(a), following the selected rounding direction.\n */\n function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = sqrt(a);\n return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 2, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 128;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 64;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 32;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 16;\n }\n if (value >> 8 > 0) {\n value >>= 8;\n result += 8;\n }\n if (value >> 4 > 0) {\n value >>= 4;\n result += 4;\n }\n if (value >> 2 > 0) {\n value >>= 2;\n result += 2;\n }\n if (value >> 1 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 2, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log2(value);\n return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 10, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >= 10 ** 64) {\n value /= 10 ** 64;\n result += 64;\n }\n if (value >= 10 ** 32) {\n value /= 10 ** 32;\n result += 32;\n }\n if (value >= 10 ** 16) {\n value /= 10 ** 16;\n result += 16;\n }\n if (value >= 10 ** 8) {\n value /= 10 ** 8;\n result += 8;\n }\n if (value >= 10 ** 4) {\n value /= 10 ** 4;\n result += 4;\n }\n if (value >= 10 ** 2) {\n value /= 10 ** 2;\n result += 2;\n }\n if (value >= 10 ** 1) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 10, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log10(value);\n return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 256, rounded down, of a positive value.\n * Returns 0 if given 0.\n *\n * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.\n */\n function log256(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 16;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 8;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 4;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 2;\n }\n if (value >> 8 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 256, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log256(value);\n return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);\n }\n }\n}\n" + }, + "@openzeppelin/contracts/utils/math/SafeCast.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SafeCast.sol)\n// This file was procedurally generated from scripts/generate/templates/SafeCast.js.\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Wrappers over Solidity's uintXX/intXX casting operators with added overflow\n * checks.\n *\n * Downcasting from uint256/int256 in Solidity does not revert on overflow. This can\n * easily result in undesired exploitation or bugs, since developers usually\n * assume that overflows raise errors. `SafeCast` restores this intuition by\n * reverting the transaction when such an operation overflows.\n *\n * Using this library instead of the unchecked operations eliminates an entire\n * class of bugs, so it's recommended to use it always.\n *\n * Can be combined with {SafeMath} and {SignedSafeMath} to extend it to smaller types, by performing\n * all math on `uint256` and `int256` and then downcasting.\n */\nlibrary SafeCast {\n /**\n * @dev Returns the downcasted uint248 from uint256, reverting on\n * overflow (when the input is greater than largest uint248).\n *\n * Counterpart to Solidity's `uint248` operator.\n *\n * Requirements:\n *\n * - input must fit into 248 bits\n *\n * _Available since v4.7._\n */\n function toUint248(uint256 value) internal pure returns (uint248) {\n require(value <= type(uint248).max, \"SafeCast: value doesn't fit in 248 bits\");\n return uint248(value);\n }\n\n /**\n * @dev Returns the downcasted uint240 from uint256, reverting on\n * overflow (when the input is greater than largest uint240).\n *\n * Counterpart to Solidity's `uint240` operator.\n *\n * Requirements:\n *\n * - input must fit into 240 bits\n *\n * _Available since v4.7._\n */\n function toUint240(uint256 value) internal pure returns (uint240) {\n require(value <= type(uint240).max, \"SafeCast: value doesn't fit in 240 bits\");\n return uint240(value);\n }\n\n /**\n * @dev Returns the downcasted uint232 from uint256, reverting on\n * overflow (when the input is greater than largest uint232).\n *\n * Counterpart to Solidity's `uint232` operator.\n *\n * Requirements:\n *\n * - input must fit into 232 bits\n *\n * _Available since v4.7._\n */\n function toUint232(uint256 value) internal pure returns (uint232) {\n require(value <= type(uint232).max, \"SafeCast: value doesn't fit in 232 bits\");\n return uint232(value);\n }\n\n /**\n * @dev Returns the downcasted uint224 from uint256, reverting on\n * overflow (when the input is greater than largest uint224).\n *\n * Counterpart to Solidity's `uint224` operator.\n *\n * Requirements:\n *\n * - input must fit into 224 bits\n *\n * _Available since v4.2._\n */\n function toUint224(uint256 value) internal pure returns (uint224) {\n require(value <= type(uint224).max, \"SafeCast: value doesn't fit in 224 bits\");\n return uint224(value);\n }\n\n /**\n * @dev Returns the downcasted uint216 from uint256, reverting on\n * overflow (when the input is greater than largest uint216).\n *\n * Counterpart to Solidity's `uint216` operator.\n *\n * Requirements:\n *\n * - input must fit into 216 bits\n *\n * _Available since v4.7._\n */\n function toUint216(uint256 value) internal pure returns (uint216) {\n require(value <= type(uint216).max, \"SafeCast: value doesn't fit in 216 bits\");\n return uint216(value);\n }\n\n /**\n * @dev Returns the downcasted uint208 from uint256, reverting on\n * overflow (when the input is greater than largest uint208).\n *\n * Counterpart to Solidity's `uint208` operator.\n *\n * Requirements:\n *\n * - input must fit into 208 bits\n *\n * _Available since v4.7._\n */\n function toUint208(uint256 value) internal pure returns (uint208) {\n require(value <= type(uint208).max, \"SafeCast: value doesn't fit in 208 bits\");\n return uint208(value);\n }\n\n /**\n * @dev Returns the downcasted uint200 from uint256, reverting on\n * overflow (when the input is greater than largest uint200).\n *\n * Counterpart to Solidity's `uint200` operator.\n *\n * Requirements:\n *\n * - input must fit into 200 bits\n *\n * _Available since v4.7._\n */\n function toUint200(uint256 value) internal pure returns (uint200) {\n require(value <= type(uint200).max, \"SafeCast: value doesn't fit in 200 bits\");\n return uint200(value);\n }\n\n /**\n * @dev Returns the downcasted uint192 from uint256, reverting on\n * overflow (when the input is greater than largest uint192).\n *\n * Counterpart to Solidity's `uint192` operator.\n *\n * Requirements:\n *\n * - input must fit into 192 bits\n *\n * _Available since v4.7._\n */\n function toUint192(uint256 value) internal pure returns (uint192) {\n require(value <= type(uint192).max, \"SafeCast: value doesn't fit in 192 bits\");\n return uint192(value);\n }\n\n /**\n * @dev Returns the downcasted uint184 from uint256, reverting on\n * overflow (when the input is greater than largest uint184).\n *\n * Counterpart to Solidity's `uint184` operator.\n *\n * Requirements:\n *\n * - input must fit into 184 bits\n *\n * _Available since v4.7._\n */\n function toUint184(uint256 value) internal pure returns (uint184) {\n require(value <= type(uint184).max, \"SafeCast: value doesn't fit in 184 bits\");\n return uint184(value);\n }\n\n /**\n * @dev Returns the downcasted uint176 from uint256, reverting on\n * overflow (when the input is greater than largest uint176).\n *\n * Counterpart to Solidity's `uint176` operator.\n *\n * Requirements:\n *\n * - input must fit into 176 bits\n *\n * _Available since v4.7._\n */\n function toUint176(uint256 value) internal pure returns (uint176) {\n require(value <= type(uint176).max, \"SafeCast: value doesn't fit in 176 bits\");\n return uint176(value);\n }\n\n /**\n * @dev Returns the downcasted uint168 from uint256, reverting on\n * overflow (when the input is greater than largest uint168).\n *\n * Counterpart to Solidity's `uint168` operator.\n *\n * Requirements:\n *\n * - input must fit into 168 bits\n *\n * _Available since v4.7._\n */\n function toUint168(uint256 value) internal pure returns (uint168) {\n require(value <= type(uint168).max, \"SafeCast: value doesn't fit in 168 bits\");\n return uint168(value);\n }\n\n /**\n * @dev Returns the downcasted uint160 from uint256, reverting on\n * overflow (when the input is greater than largest uint160).\n *\n * Counterpart to Solidity's `uint160` operator.\n *\n * Requirements:\n *\n * - input must fit into 160 bits\n *\n * _Available since v4.7._\n */\n function toUint160(uint256 value) internal pure returns (uint160) {\n require(value <= type(uint160).max, \"SafeCast: value doesn't fit in 160 bits\");\n return uint160(value);\n }\n\n /**\n * @dev Returns the downcasted uint152 from uint256, reverting on\n * overflow (when the input is greater than largest uint152).\n *\n * Counterpart to Solidity's `uint152` operator.\n *\n * Requirements:\n *\n * - input must fit into 152 bits\n *\n * _Available since v4.7._\n */\n function toUint152(uint256 value) internal pure returns (uint152) {\n require(value <= type(uint152).max, \"SafeCast: value doesn't fit in 152 bits\");\n return uint152(value);\n }\n\n /**\n * @dev Returns the downcasted uint144 from uint256, reverting on\n * overflow (when the input is greater than largest uint144).\n *\n * Counterpart to Solidity's `uint144` operator.\n *\n * Requirements:\n *\n * - input must fit into 144 bits\n *\n * _Available since v4.7._\n */\n function toUint144(uint256 value) internal pure returns (uint144) {\n require(value <= type(uint144).max, \"SafeCast: value doesn't fit in 144 bits\");\n return uint144(value);\n }\n\n /**\n * @dev Returns the downcasted uint136 from uint256, reverting on\n * overflow (when the input is greater than largest uint136).\n *\n * Counterpart to Solidity's `uint136` operator.\n *\n * Requirements:\n *\n * - input must fit into 136 bits\n *\n * _Available since v4.7._\n */\n function toUint136(uint256 value) internal pure returns (uint136) {\n require(value <= type(uint136).max, \"SafeCast: value doesn't fit in 136 bits\");\n return uint136(value);\n }\n\n /**\n * @dev Returns the downcasted uint128 from uint256, reverting on\n * overflow (when the input is greater than largest uint128).\n *\n * Counterpart to Solidity's `uint128` operator.\n *\n * Requirements:\n *\n * - input must fit into 128 bits\n *\n * _Available since v2.5._\n */\n function toUint128(uint256 value) internal pure returns (uint128) {\n require(value <= type(uint128).max, \"SafeCast: value doesn't fit in 128 bits\");\n return uint128(value);\n }\n\n /**\n * @dev Returns the downcasted uint120 from uint256, reverting on\n * overflow (when the input is greater than largest uint120).\n *\n * Counterpart to Solidity's `uint120` operator.\n *\n * Requirements:\n *\n * - input must fit into 120 bits\n *\n * _Available since v4.7._\n */\n function toUint120(uint256 value) internal pure returns (uint120) {\n require(value <= type(uint120).max, \"SafeCast: value doesn't fit in 120 bits\");\n return uint120(value);\n }\n\n /**\n * @dev Returns the downcasted uint112 from uint256, reverting on\n * overflow (when the input is greater than largest uint112).\n *\n * Counterpart to Solidity's `uint112` operator.\n *\n * Requirements:\n *\n * - input must fit into 112 bits\n *\n * _Available since v4.7._\n */\n function toUint112(uint256 value) internal pure returns (uint112) {\n require(value <= type(uint112).max, \"SafeCast: value doesn't fit in 112 bits\");\n return uint112(value);\n }\n\n /**\n * @dev Returns the downcasted uint104 from uint256, reverting on\n * overflow (when the input is greater than largest uint104).\n *\n * Counterpart to Solidity's `uint104` operator.\n *\n * Requirements:\n *\n * - input must fit into 104 bits\n *\n * _Available since v4.7._\n */\n function toUint104(uint256 value) internal pure returns (uint104) {\n require(value <= type(uint104).max, \"SafeCast: value doesn't fit in 104 bits\");\n return uint104(value);\n }\n\n /**\n * @dev Returns the downcasted uint96 from uint256, reverting on\n * overflow (when the input is greater than largest uint96).\n *\n * Counterpart to Solidity's `uint96` operator.\n *\n * Requirements:\n *\n * - input must fit into 96 bits\n *\n * _Available since v4.2._\n */\n function toUint96(uint256 value) internal pure returns (uint96) {\n require(value <= type(uint96).max, \"SafeCast: value doesn't fit in 96 bits\");\n return uint96(value);\n }\n\n /**\n * @dev Returns the downcasted uint88 from uint256, reverting on\n * overflow (when the input is greater than largest uint88).\n *\n * Counterpart to Solidity's `uint88` operator.\n *\n * Requirements:\n *\n * - input must fit into 88 bits\n *\n * _Available since v4.7._\n */\n function toUint88(uint256 value) internal pure returns (uint88) {\n require(value <= type(uint88).max, \"SafeCast: value doesn't fit in 88 bits\");\n return uint88(value);\n }\n\n /**\n * @dev Returns the downcasted uint80 from uint256, reverting on\n * overflow (when the input is greater than largest uint80).\n *\n * Counterpart to Solidity's `uint80` operator.\n *\n * Requirements:\n *\n * - input must fit into 80 bits\n *\n * _Available since v4.7._\n */\n function toUint80(uint256 value) internal pure returns (uint80) {\n require(value <= type(uint80).max, \"SafeCast: value doesn't fit in 80 bits\");\n return uint80(value);\n }\n\n /**\n * @dev Returns the downcasted uint72 from uint256, reverting on\n * overflow (when the input is greater than largest uint72).\n *\n * Counterpart to Solidity's `uint72` operator.\n *\n * Requirements:\n *\n * - input must fit into 72 bits\n *\n * _Available since v4.7._\n */\n function toUint72(uint256 value) internal pure returns (uint72) {\n require(value <= type(uint72).max, \"SafeCast: value doesn't fit in 72 bits\");\n return uint72(value);\n }\n\n /**\n * @dev Returns the downcasted uint64 from uint256, reverting on\n * overflow (when the input is greater than largest uint64).\n *\n * Counterpart to Solidity's `uint64` operator.\n *\n * Requirements:\n *\n * - input must fit into 64 bits\n *\n * _Available since v2.5._\n */\n function toUint64(uint256 value) internal pure returns (uint64) {\n require(value <= type(uint64).max, \"SafeCast: value doesn't fit in 64 bits\");\n return uint64(value);\n }\n\n /**\n * @dev Returns the downcasted uint56 from uint256, reverting on\n * overflow (when the input is greater than largest uint56).\n *\n * Counterpart to Solidity's `uint56` operator.\n *\n * Requirements:\n *\n * - input must fit into 56 bits\n *\n * _Available since v4.7._\n */\n function toUint56(uint256 value) internal pure returns (uint56) {\n require(value <= type(uint56).max, \"SafeCast: value doesn't fit in 56 bits\");\n return uint56(value);\n }\n\n /**\n * @dev Returns the downcasted uint48 from uint256, reverting on\n * overflow (when the input is greater than largest uint48).\n *\n * Counterpart to Solidity's `uint48` operator.\n *\n * Requirements:\n *\n * - input must fit into 48 bits\n *\n * _Available since v4.7._\n */\n function toUint48(uint256 value) internal pure returns (uint48) {\n require(value <= type(uint48).max, \"SafeCast: value doesn't fit in 48 bits\");\n return uint48(value);\n }\n\n /**\n * @dev Returns the downcasted uint40 from uint256, reverting on\n * overflow (when the input is greater than largest uint40).\n *\n * Counterpart to Solidity's `uint40` operator.\n *\n * Requirements:\n *\n * - input must fit into 40 bits\n *\n * _Available since v4.7._\n */\n function toUint40(uint256 value) internal pure returns (uint40) {\n require(value <= type(uint40).max, \"SafeCast: value doesn't fit in 40 bits\");\n return uint40(value);\n }\n\n /**\n * @dev Returns the downcasted uint32 from uint256, reverting on\n * overflow (when the input is greater than largest uint32).\n *\n * Counterpart to Solidity's `uint32` operator.\n *\n * Requirements:\n *\n * - input must fit into 32 bits\n *\n * _Available since v2.5._\n */\n function toUint32(uint256 value) internal pure returns (uint32) {\n require(value <= type(uint32).max, \"SafeCast: value doesn't fit in 32 bits\");\n return uint32(value);\n }\n\n /**\n * @dev Returns the downcasted uint24 from uint256, reverting on\n * overflow (when the input is greater than largest uint24).\n *\n * Counterpart to Solidity's `uint24` operator.\n *\n * Requirements:\n *\n * - input must fit into 24 bits\n *\n * _Available since v4.7._\n */\n function toUint24(uint256 value) internal pure returns (uint24) {\n require(value <= type(uint24).max, \"SafeCast: value doesn't fit in 24 bits\");\n return uint24(value);\n }\n\n /**\n * @dev Returns the downcasted uint16 from uint256, reverting on\n * overflow (when the input is greater than largest uint16).\n *\n * Counterpart to Solidity's `uint16` operator.\n *\n * Requirements:\n *\n * - input must fit into 16 bits\n *\n * _Available since v2.5._\n */\n function toUint16(uint256 value) internal pure returns (uint16) {\n require(value <= type(uint16).max, \"SafeCast: value doesn't fit in 16 bits\");\n return uint16(value);\n }\n\n /**\n * @dev Returns the downcasted uint8 from uint256, reverting on\n * overflow (when the input is greater than largest uint8).\n *\n * Counterpart to Solidity's `uint8` operator.\n *\n * Requirements:\n *\n * - input must fit into 8 bits\n *\n * _Available since v2.5._\n */\n function toUint8(uint256 value) internal pure returns (uint8) {\n require(value <= type(uint8).max, \"SafeCast: value doesn't fit in 8 bits\");\n return uint8(value);\n }\n\n /**\n * @dev Converts a signed int256 into an unsigned uint256.\n *\n * Requirements:\n *\n * - input must be greater than or equal to 0.\n *\n * _Available since v3.0._\n */\n function toUint256(int256 value) internal pure returns (uint256) {\n require(value >= 0, \"SafeCast: value must be positive\");\n return uint256(value);\n }\n\n /**\n * @dev Returns the downcasted int248 from int256, reverting on\n * overflow (when the input is less than smallest int248 or\n * greater than largest int248).\n *\n * Counterpart to Solidity's `int248` operator.\n *\n * Requirements:\n *\n * - input must fit into 248 bits\n *\n * _Available since v4.7._\n */\n function toInt248(int256 value) internal pure returns (int248 downcasted) {\n downcasted = int248(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 248 bits\");\n }\n\n /**\n * @dev Returns the downcasted int240 from int256, reverting on\n * overflow (when the input is less than smallest int240 or\n * greater than largest int240).\n *\n * Counterpart to Solidity's `int240` operator.\n *\n * Requirements:\n *\n * - input must fit into 240 bits\n *\n * _Available since v4.7._\n */\n function toInt240(int256 value) internal pure returns (int240 downcasted) {\n downcasted = int240(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 240 bits\");\n }\n\n /**\n * @dev Returns the downcasted int232 from int256, reverting on\n * overflow (when the input is less than smallest int232 or\n * greater than largest int232).\n *\n * Counterpart to Solidity's `int232` operator.\n *\n * Requirements:\n *\n * - input must fit into 232 bits\n *\n * _Available since v4.7._\n */\n function toInt232(int256 value) internal pure returns (int232 downcasted) {\n downcasted = int232(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 232 bits\");\n }\n\n /**\n * @dev Returns the downcasted int224 from int256, reverting on\n * overflow (when the input is less than smallest int224 or\n * greater than largest int224).\n *\n * Counterpart to Solidity's `int224` operator.\n *\n * Requirements:\n *\n * - input must fit into 224 bits\n *\n * _Available since v4.7._\n */\n function toInt224(int256 value) internal pure returns (int224 downcasted) {\n downcasted = int224(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 224 bits\");\n }\n\n /**\n * @dev Returns the downcasted int216 from int256, reverting on\n * overflow (when the input is less than smallest int216 or\n * greater than largest int216).\n *\n * Counterpart to Solidity's `int216` operator.\n *\n * Requirements:\n *\n * - input must fit into 216 bits\n *\n * _Available since v4.7._\n */\n function toInt216(int256 value) internal pure returns (int216 downcasted) {\n downcasted = int216(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 216 bits\");\n }\n\n /**\n * @dev Returns the downcasted int208 from int256, reverting on\n * overflow (when the input is less than smallest int208 or\n * greater than largest int208).\n *\n * Counterpart to Solidity's `int208` operator.\n *\n * Requirements:\n *\n * - input must fit into 208 bits\n *\n * _Available since v4.7._\n */\n function toInt208(int256 value) internal pure returns (int208 downcasted) {\n downcasted = int208(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 208 bits\");\n }\n\n /**\n * @dev Returns the downcasted int200 from int256, reverting on\n * overflow (when the input is less than smallest int200 or\n * greater than largest int200).\n *\n * Counterpart to Solidity's `int200` operator.\n *\n * Requirements:\n *\n * - input must fit into 200 bits\n *\n * _Available since v4.7._\n */\n function toInt200(int256 value) internal pure returns (int200 downcasted) {\n downcasted = int200(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 200 bits\");\n }\n\n /**\n * @dev Returns the downcasted int192 from int256, reverting on\n * overflow (when the input is less than smallest int192 or\n * greater than largest int192).\n *\n * Counterpart to Solidity's `int192` operator.\n *\n * Requirements:\n *\n * - input must fit into 192 bits\n *\n * _Available since v4.7._\n */\n function toInt192(int256 value) internal pure returns (int192 downcasted) {\n downcasted = int192(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 192 bits\");\n }\n\n /**\n * @dev Returns the downcasted int184 from int256, reverting on\n * overflow (when the input is less than smallest int184 or\n * greater than largest int184).\n *\n * Counterpart to Solidity's `int184` operator.\n *\n * Requirements:\n *\n * - input must fit into 184 bits\n *\n * _Available since v4.7._\n */\n function toInt184(int256 value) internal pure returns (int184 downcasted) {\n downcasted = int184(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 184 bits\");\n }\n\n /**\n * @dev Returns the downcasted int176 from int256, reverting on\n * overflow (when the input is less than smallest int176 or\n * greater than largest int176).\n *\n * Counterpart to Solidity's `int176` operator.\n *\n * Requirements:\n *\n * - input must fit into 176 bits\n *\n * _Available since v4.7._\n */\n function toInt176(int256 value) internal pure returns (int176 downcasted) {\n downcasted = int176(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 176 bits\");\n }\n\n /**\n * @dev Returns the downcasted int168 from int256, reverting on\n * overflow (when the input is less than smallest int168 or\n * greater than largest int168).\n *\n * Counterpart to Solidity's `int168` operator.\n *\n * Requirements:\n *\n * - input must fit into 168 bits\n *\n * _Available since v4.7._\n */\n function toInt168(int256 value) internal pure returns (int168 downcasted) {\n downcasted = int168(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 168 bits\");\n }\n\n /**\n * @dev Returns the downcasted int160 from int256, reverting on\n * overflow (when the input is less than smallest int160 or\n * greater than largest int160).\n *\n * Counterpart to Solidity's `int160` operator.\n *\n * Requirements:\n *\n * - input must fit into 160 bits\n *\n * _Available since v4.7._\n */\n function toInt160(int256 value) internal pure returns (int160 downcasted) {\n downcasted = int160(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 160 bits\");\n }\n\n /**\n * @dev Returns the downcasted int152 from int256, reverting on\n * overflow (when the input is less than smallest int152 or\n * greater than largest int152).\n *\n * Counterpart to Solidity's `int152` operator.\n *\n * Requirements:\n *\n * - input must fit into 152 bits\n *\n * _Available since v4.7._\n */\n function toInt152(int256 value) internal pure returns (int152 downcasted) {\n downcasted = int152(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 152 bits\");\n }\n\n /**\n * @dev Returns the downcasted int144 from int256, reverting on\n * overflow (when the input is less than smallest int144 or\n * greater than largest int144).\n *\n * Counterpart to Solidity's `int144` operator.\n *\n * Requirements:\n *\n * - input must fit into 144 bits\n *\n * _Available since v4.7._\n */\n function toInt144(int256 value) internal pure returns (int144 downcasted) {\n downcasted = int144(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 144 bits\");\n }\n\n /**\n * @dev Returns the downcasted int136 from int256, reverting on\n * overflow (when the input is less than smallest int136 or\n * greater than largest int136).\n *\n * Counterpart to Solidity's `int136` operator.\n *\n * Requirements:\n *\n * - input must fit into 136 bits\n *\n * _Available since v4.7._\n */\n function toInt136(int256 value) internal pure returns (int136 downcasted) {\n downcasted = int136(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 136 bits\");\n }\n\n /**\n * @dev Returns the downcasted int128 from int256, reverting on\n * overflow (when the input is less than smallest int128 or\n * greater than largest int128).\n *\n * Counterpart to Solidity's `int128` operator.\n *\n * Requirements:\n *\n * - input must fit into 128 bits\n *\n * _Available since v3.1._\n */\n function toInt128(int256 value) internal pure returns (int128 downcasted) {\n downcasted = int128(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 128 bits\");\n }\n\n /**\n * @dev Returns the downcasted int120 from int256, reverting on\n * overflow (when the input is less than smallest int120 or\n * greater than largest int120).\n *\n * Counterpart to Solidity's `int120` operator.\n *\n * Requirements:\n *\n * - input must fit into 120 bits\n *\n * _Available since v4.7._\n */\n function toInt120(int256 value) internal pure returns (int120 downcasted) {\n downcasted = int120(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 120 bits\");\n }\n\n /**\n * @dev Returns the downcasted int112 from int256, reverting on\n * overflow (when the input is less than smallest int112 or\n * greater than largest int112).\n *\n * Counterpart to Solidity's `int112` operator.\n *\n * Requirements:\n *\n * - input must fit into 112 bits\n *\n * _Available since v4.7._\n */\n function toInt112(int256 value) internal pure returns (int112 downcasted) {\n downcasted = int112(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 112 bits\");\n }\n\n /**\n * @dev Returns the downcasted int104 from int256, reverting on\n * overflow (when the input is less than smallest int104 or\n * greater than largest int104).\n *\n * Counterpart to Solidity's `int104` operator.\n *\n * Requirements:\n *\n * - input must fit into 104 bits\n *\n * _Available since v4.7._\n */\n function toInt104(int256 value) internal pure returns (int104 downcasted) {\n downcasted = int104(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 104 bits\");\n }\n\n /**\n * @dev Returns the downcasted int96 from int256, reverting on\n * overflow (when the input is less than smallest int96 or\n * greater than largest int96).\n *\n * Counterpart to Solidity's `int96` operator.\n *\n * Requirements:\n *\n * - input must fit into 96 bits\n *\n * _Available since v4.7._\n */\n function toInt96(int256 value) internal pure returns (int96 downcasted) {\n downcasted = int96(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 96 bits\");\n }\n\n /**\n * @dev Returns the downcasted int88 from int256, reverting on\n * overflow (when the input is less than smallest int88 or\n * greater than largest int88).\n *\n * Counterpart to Solidity's `int88` operator.\n *\n * Requirements:\n *\n * - input must fit into 88 bits\n *\n * _Available since v4.7._\n */\n function toInt88(int256 value) internal pure returns (int88 downcasted) {\n downcasted = int88(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 88 bits\");\n }\n\n /**\n * @dev Returns the downcasted int80 from int256, reverting on\n * overflow (when the input is less than smallest int80 or\n * greater than largest int80).\n *\n * Counterpart to Solidity's `int80` operator.\n *\n * Requirements:\n *\n * - input must fit into 80 bits\n *\n * _Available since v4.7._\n */\n function toInt80(int256 value) internal pure returns (int80 downcasted) {\n downcasted = int80(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 80 bits\");\n }\n\n /**\n * @dev Returns the downcasted int72 from int256, reverting on\n * overflow (when the input is less than smallest int72 or\n * greater than largest int72).\n *\n * Counterpart to Solidity's `int72` operator.\n *\n * Requirements:\n *\n * - input must fit into 72 bits\n *\n * _Available since v4.7._\n */\n function toInt72(int256 value) internal pure returns (int72 downcasted) {\n downcasted = int72(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 72 bits\");\n }\n\n /**\n * @dev Returns the downcasted int64 from int256, reverting on\n * overflow (when the input is less than smallest int64 or\n * greater than largest int64).\n *\n * Counterpart to Solidity's `int64` operator.\n *\n * Requirements:\n *\n * - input must fit into 64 bits\n *\n * _Available since v3.1._\n */\n function toInt64(int256 value) internal pure returns (int64 downcasted) {\n downcasted = int64(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 64 bits\");\n }\n\n /**\n * @dev Returns the downcasted int56 from int256, reverting on\n * overflow (when the input is less than smallest int56 or\n * greater than largest int56).\n *\n * Counterpart to Solidity's `int56` operator.\n *\n * Requirements:\n *\n * - input must fit into 56 bits\n *\n * _Available since v4.7._\n */\n function toInt56(int256 value) internal pure returns (int56 downcasted) {\n downcasted = int56(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 56 bits\");\n }\n\n /**\n * @dev Returns the downcasted int48 from int256, reverting on\n * overflow (when the input is less than smallest int48 or\n * greater than largest int48).\n *\n * Counterpart to Solidity's `int48` operator.\n *\n * Requirements:\n *\n * - input must fit into 48 bits\n *\n * _Available since v4.7._\n */\n function toInt48(int256 value) internal pure returns (int48 downcasted) {\n downcasted = int48(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 48 bits\");\n }\n\n /**\n * @dev Returns the downcasted int40 from int256, reverting on\n * overflow (when the input is less than smallest int40 or\n * greater than largest int40).\n *\n * Counterpart to Solidity's `int40` operator.\n *\n * Requirements:\n *\n * - input must fit into 40 bits\n *\n * _Available since v4.7._\n */\n function toInt40(int256 value) internal pure returns (int40 downcasted) {\n downcasted = int40(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 40 bits\");\n }\n\n /**\n * @dev Returns the downcasted int32 from int256, reverting on\n * overflow (when the input is less than smallest int32 or\n * greater than largest int32).\n *\n * Counterpart to Solidity's `int32` operator.\n *\n * Requirements:\n *\n * - input must fit into 32 bits\n *\n * _Available since v3.1._\n */\n function toInt32(int256 value) internal pure returns (int32 downcasted) {\n downcasted = int32(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 32 bits\");\n }\n\n /**\n * @dev Returns the downcasted int24 from int256, reverting on\n * overflow (when the input is less than smallest int24 or\n * greater than largest int24).\n *\n * Counterpart to Solidity's `int24` operator.\n *\n * Requirements:\n *\n * - input must fit into 24 bits\n *\n * _Available since v4.7._\n */\n function toInt24(int256 value) internal pure returns (int24 downcasted) {\n downcasted = int24(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 24 bits\");\n }\n\n /**\n * @dev Returns the downcasted int16 from int256, reverting on\n * overflow (when the input is less than smallest int16 or\n * greater than largest int16).\n *\n * Counterpart to Solidity's `int16` operator.\n *\n * Requirements:\n *\n * - input must fit into 16 bits\n *\n * _Available since v3.1._\n */\n function toInt16(int256 value) internal pure returns (int16 downcasted) {\n downcasted = int16(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 16 bits\");\n }\n\n /**\n * @dev Returns the downcasted int8 from int256, reverting on\n * overflow (when the input is less than smallest int8 or\n * greater than largest int8).\n *\n * Counterpart to Solidity's `int8` operator.\n *\n * Requirements:\n *\n * - input must fit into 8 bits\n *\n * _Available since v3.1._\n */\n function toInt8(int256 value) internal pure returns (int8 downcasted) {\n downcasted = int8(value);\n require(downcasted == value, \"SafeCast: value doesn't fit in 8 bits\");\n }\n\n /**\n * @dev Converts an unsigned uint256 into a signed int256.\n *\n * Requirements:\n *\n * - input must be less than or equal to maxInt256.\n *\n * _Available since v3.0._\n */\n function toInt256(uint256 value) internal pure returns (int256) {\n // Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive\n require(value <= uint256(type(int256).max), \"SafeCast: value doesn't fit in an int256\");\n return int256(value);\n }\n}\n" + }, + "@openzeppelin/contracts/utils/math/SignedMath.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard signed math utilities missing in the Solidity language.\n */\nlibrary SignedMath {\n /**\n * @dev Returns the largest of two signed numbers.\n */\n function max(int256 a, int256 b) internal pure returns (int256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two signed numbers.\n */\n function min(int256 a, int256 b) internal pure returns (int256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two signed numbers without overflow.\n * The result is rounded towards zero.\n */\n function average(int256 a, int256 b) internal pure returns (int256) {\n // Formula from the book \"Hacker's Delight\"\n int256 x = (a & b) + ((a ^ b) >> 1);\n return x + (int256(uint256(x) >> 255) & (a ^ b));\n }\n\n /**\n * @dev Returns the absolute unsigned value of a signed value.\n */\n function abs(int256 n) internal pure returns (uint256) {\n unchecked {\n // must be unchecked in order to support `n = type(int256).min`\n return uint256(n >= 0 ? n : -n);\n }\n }\n}\n" + }, + "@openzeppelin/contracts/utils/Strings.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./math/Math.sol\";\nimport \"./math/SignedMath.sol\";\n\n/**\n * @dev String operations.\n */\nlibrary Strings {\n bytes16 private constant _SYMBOLS = \"0123456789abcdef\";\n uint8 private constant _ADDRESS_LENGTH = 20;\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` decimal representation.\n */\n function toString(uint256 value) internal pure returns (string memory) {\n unchecked {\n uint256 length = Math.log10(value) + 1;\n string memory buffer = new string(length);\n uint256 ptr;\n /// @solidity memory-safe-assembly\n assembly {\n ptr := add(buffer, add(32, length))\n }\n while (true) {\n ptr--;\n /// @solidity memory-safe-assembly\n assembly {\n mstore8(ptr, byte(mod(value, 10), _SYMBOLS))\n }\n value /= 10;\n if (value == 0) break;\n }\n return buffer;\n }\n }\n\n /**\n * @dev Converts a `int256` to its ASCII `string` decimal representation.\n */\n function toString(int256 value) internal pure returns (string memory) {\n return string(abi.encodePacked(value < 0 ? \"-\" : \"\", toString(SignedMath.abs(value))));\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.\n */\n function toHexString(uint256 value) internal pure returns (string memory) {\n unchecked {\n return toHexString(value, Math.log256(value) + 1);\n }\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.\n */\n function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {\n bytes memory buffer = new bytes(2 * length + 2);\n buffer[0] = \"0\";\n buffer[1] = \"x\";\n for (uint256 i = 2 * length + 1; i > 1; --i) {\n buffer[i] = _SYMBOLS[value & 0xf];\n value >>= 4;\n }\n require(value == 0, \"Strings: hex length insufficient\");\n return string(buffer);\n }\n\n /**\n * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.\n */\n function toHexString(address addr) internal pure returns (string memory) {\n return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);\n }\n\n /**\n * @dev Returns true if the two strings are equal.\n */\n function equal(string memory a, string memory b) internal pure returns (bool) {\n return keccak256(bytes(a)) == keccak256(bytes(b));\n }\n}\n" + }, + "@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/access/Ownable2StepUpgradeable.sol\";\n\nimport \"./IAccessControlManagerV8.sol\";\n\n/**\n * @title AccessControlledV8\n * @author Venus\n * @notice This contract is helper between access control manager and actual contract. This contract further inherited by other contract (using solidity 0.8.13)\n * to integrate access controlled mechanism. It provides initialise methods and verifying access methods.\n */\nabstract contract AccessControlledV8 is Initializable, Ownable2StepUpgradeable {\n /// @notice Access control manager contract\n IAccessControlManagerV8 private _accessControlManager;\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n\n /// @notice Emitted when access control manager contract address is changed\n event NewAccessControlManager(address oldAccessControlManager, address newAccessControlManager);\n\n /// @notice Thrown when the action is prohibited by AccessControlManager\n error Unauthorized(address sender, address calledContract, string methodSignature);\n\n function __AccessControlled_init(address accessControlManager_) internal onlyInitializing {\n __Ownable2Step_init();\n __AccessControlled_init_unchained(accessControlManager_);\n }\n\n function __AccessControlled_init_unchained(address accessControlManager_) internal onlyInitializing {\n _setAccessControlManager(accessControlManager_);\n }\n\n /**\n * @notice Sets the address of AccessControlManager\n * @dev Admin function to set address of AccessControlManager\n * @param accessControlManager_ The new address of the AccessControlManager\n * @custom:event Emits NewAccessControlManager event\n * @custom:access Only Governance\n */\n function setAccessControlManager(address accessControlManager_) external onlyOwner {\n _setAccessControlManager(accessControlManager_);\n }\n\n /**\n * @notice Returns the address of the access control manager contract\n */\n function accessControlManager() external view returns (IAccessControlManagerV8) {\n return _accessControlManager;\n }\n\n /**\n * @dev Internal function to set address of AccessControlManager\n * @param accessControlManager_ The new address of the AccessControlManager\n */\n function _setAccessControlManager(address accessControlManager_) internal {\n require(address(accessControlManager_) != address(0), \"invalid acess control manager address\");\n address oldAccessControlManager = address(_accessControlManager);\n _accessControlManager = IAccessControlManagerV8(accessControlManager_);\n emit NewAccessControlManager(oldAccessControlManager, accessControlManager_);\n }\n\n /**\n * @notice Reverts if the call is not allowed by AccessControlManager\n * @param signature Method signature\n */\n function _checkAccessAllowed(string memory signature) internal view {\n bool isAllowedToCall = _accessControlManager.isAllowedToCall(msg.sender, signature);\n\n if (!isAllowedToCall) {\n revert Unauthorized(msg.sender, address(this), signature);\n }\n }\n}\n" + }, + "@venusprotocol/governance-contracts/contracts/Governance/AccessControlManager.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\nimport \"@openzeppelin/contracts/access/AccessControl.sol\";\nimport \"./IAccessControlManagerV8.sol\";\n\n/**\n * @title AccessControlManager\n * @author Venus\n * @dev This contract is a wrapper of OpenZeppelin AccessControl extending it in a way to standartize access control within Venus Smart Contract Ecosystem.\n * @notice Access control plays a crucial role in the Venus governance model. It is used to restrict functions so that they can only be called from one\n * account or list of accounts (EOA or Contract Accounts).\n *\n * The implementation of `AccessControlManager`(https://github.com/VenusProtocol/governance-contracts/blob/main/contracts/Governance/AccessControlManager.sol)\n * inherits the [Open Zeppelin AccessControl](https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/access/AccessControl.sol)\n * contract as a base for role management logic. There are two role types: admin and granular permissions.\n * \n * ## Granular Roles\n * \n * Granular roles are built by hashing the contract address and its function signature. For example, given contract `Foo` with function `Foo.bar()` which\n * is guarded by ACM, calling `giveRolePermission` for account B do the following:\n * \n * 1. Compute `keccak256(contractFooAddress,functionSignatureBar)`\n * 1. Add the computed role to the roles of account B\n * 1. Account B now can call `ContractFoo.bar()`\n * \n * ## Admin Roles\n * \n * Admin roles allow for an address to call a function signature on any contract guarded by the `AccessControlManager`. This is particularly useful for\n * contracts created by factories.\n * \n * For Admin roles a null address is hashed in place of the contract address (`keccak256(0x0000000000000000000000000000000000000000,functionSignatureBar)`.\n * \n * In the previous example, giving account B the admin role, account B will have permissions to call the `bar()` function on any contract that is guarded by\n * ACM, not only contract A.\n * \n * ## Protocol Integration\n * \n * All restricted functions in Venus Protocol use a hook to ACM in order to check if the caller has the right permission to call the guarded function.\n * `AccessControlledV5` and `AccessControlledV8` abstract contract makes this integration easier. They call ACM's external method\n * `isAllowedToCall(address caller, string functionSig)`. Here is an example of how `setCollateralFactor` function in `Comptroller` is integrated with ACM:\n\n```\n contract Comptroller is [...] AccessControlledV8 {\n [...]\n function setCollateralFactor(VToken vToken, uint256 newCollateralFactorMantissa, uint256 newLiquidationThresholdMantissa) external {\n _checkAccessAllowed(\"setCollateralFactor(address,uint256,uint256)\");\n [...]\n }\n }\n```\n */\ncontract AccessControlManager is AccessControl, IAccessControlManagerV8 {\n /// @notice Emitted when an account is given a permission to a certain contract function\n /// @dev If contract address is 0x000..0 this means that the account is a default admin of this function and\n /// can call any contract function with this signature\n event PermissionGranted(address account, address contractAddress, string functionSig);\n\n /// @notice Emitted when an account is revoked a permission to a certain contract function\n event PermissionRevoked(address account, address contractAddress, string functionSig);\n\n constructor() {\n // Grant the contract deployer the default admin role: it will be able\n // to grant and revoke any roles\n _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);\n }\n\n /**\n * @notice Gives a function call permission to one single account\n * @dev this function can be called only from Role Admin or DEFAULT_ADMIN_ROLE\n * @param contractAddress address of contract for which call permissions will be granted\n * @dev if contractAddress is zero address, the account can access the specified function\n * on **any** contract managed by this ACL\n * @param functionSig signature e.g. \"functionName(uint256,bool)\"\n * @param accountToPermit account that will be given access to the contract function\n * @custom:event Emits a {RoleGranted} and {PermissionGranted} events.\n */\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) public {\n bytes32 role = keccak256(abi.encodePacked(contractAddress, functionSig));\n grantRole(role, accountToPermit);\n emit PermissionGranted(accountToPermit, contractAddress, functionSig);\n }\n\n /**\n * @notice Revokes an account's permission to a particular function call\n * @dev this function can be called only from Role Admin or DEFAULT_ADMIN_ROLE\n * \t\tMay emit a {RoleRevoked} event.\n * @param contractAddress address of contract for which call permissions will be revoked\n * @param functionSig signature e.g. \"functionName(uint256,bool)\"\n * @custom:event Emits {RoleRevoked} and {PermissionRevoked} events.\n */\n function revokeCallPermission(\n address contractAddress,\n string calldata functionSig,\n address accountToRevoke\n ) public {\n bytes32 role = keccak256(abi.encodePacked(contractAddress, functionSig));\n revokeRole(role, accountToRevoke);\n emit PermissionRevoked(accountToRevoke, contractAddress, functionSig);\n }\n\n /**\n * @notice Verifies if the given account can call a contract's guarded function\n * @dev Since restricted contracts using this function as a permission hook, we can get contracts address with msg.sender\n * @param account for which call permissions will be checked\n * @param functionSig restricted function signature e.g. \"functionName(uint256,bool)\"\n * @return false if the user account cannot call the particular contract function\n *\n */\n function isAllowedToCall(address account, string calldata functionSig) public view returns (bool) {\n bytes32 role = keccak256(abi.encodePacked(msg.sender, functionSig));\n\n if (hasRole(role, account)) {\n return true;\n } else {\n role = keccak256(abi.encodePacked(address(0), functionSig));\n return hasRole(role, account);\n }\n }\n\n /**\n * @notice Verifies if the given account can call a contract's guarded function\n * @dev This function is used as a view function to check permissions rather than contract hook for access restriction check.\n * @param account for which call permissions will be checked against\n * @param contractAddress address of the restricted contract\n * @param functionSig signature of the restricted function e.g. \"functionName(uint256,bool)\"\n * @return false if the user account cannot call the particular contract function\n */\n function hasPermission(\n address account,\n address contractAddress,\n string calldata functionSig\n ) public view returns (bool) {\n bytes32 role = keccak256(abi.encodePacked(contractAddress, functionSig));\n return hasRole(role, account);\n }\n}\n" + }, + "@venusprotocol/governance-contracts/contracts/Governance/IAccessControlManagerV8.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\nimport \"@openzeppelin/contracts/access/IAccessControl.sol\";\n\n/**\n * @title IAccessControlManagerV8\n * @author Venus\n * @notice Interface implemented by the `AccessControlManagerV8` contract.\n */\ninterface IAccessControlManagerV8 is IAccessControl {\n function giveCallPermission(address contractAddress, string calldata functionSig, address accountToPermit) external;\n\n function revokeCallPermission(\n address contractAddress,\n string calldata functionSig,\n address accountToRevoke\n ) external;\n\n function isAllowedToCall(address account, string calldata functionSig) external view returns (bool);\n\n function hasPermission(\n address account,\n address contractAddress,\n string calldata functionSig\n ) external view returns (bool);\n}\n" + }, + "@venusprotocol/solidity-utilities/contracts/constants.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\n/// @dev Base unit for computations, usually used in scaling (multiplications, divisions)\nuint256 constant EXP_SCALE = 1e18;\n\n/// @dev A unit (literal one) in EXP_SCALE, usually used in additions/subtractions\nuint256 constant MANTISSA_ONE = EXP_SCALE;\n\n/// @dev The approximate number of seconds per year\nuint256 constant SECONDS_PER_YEAR = 31_536_000;\n" + }, + "@venusprotocol/solidity-utilities/contracts/validators.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\n/// @notice Thrown if the supplied address is a zero address where it is not allowed\nerror ZeroAddressNotAllowed();\n\n/// @notice Thrown if the supplied value is 0 where it is not allowed\nerror ZeroValueNotAllowed();\n\n/// @notice Checks if the provided address is nonzero, reverts otherwise\n/// @param address_ Address to check\n/// @custom:error ZeroAddressNotAllowed is thrown if the provided address is a zero address\nfunction ensureNonzeroAddress(address address_) pure {\n if (address_ == address(0)) {\n revert ZeroAddressNotAllowed();\n }\n}\n\n/// @notice Checks if the provided value is nonzero, reverts otherwise\n/// @param value_ Value to check\n/// @custom:error ZeroValueNotAllowed is thrown if the provided value is 0\nfunction ensureNonzeroValue(uint256 value_) pure {\n if (value_ == 0) {\n revert ZeroValueNotAllowed();\n }\n}\n" + }, + "contracts/interfaces/FeedRegistryInterface.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\ninterface FeedRegistryInterface {\n function latestRoundDataByName(\n string memory base,\n string memory quote\n )\n external\n view\n returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound);\n\n function decimalsByName(string memory base, string memory quote) external view returns (uint8);\n}\n" + }, + "contracts/interfaces/IAnkrBNB.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface IAnkrBNB {\n function sharesToBonds(uint256 amount) external view returns (uint256);\n function decimals() external view returns (uint8);\n}\n" + }, + "contracts/interfaces/IEtherFiLiquidityPool.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface IEtherFiLiquidityPool {\n function amountForShare(uint256 _share) external view returns (uint256);\n}\n" + }, + "contracts/interfaces/IPendlePtOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface IPendlePtOracle {\n function getPtToAssetRate(address market, uint32 duration) external view returns (uint256);\n function getOracleState(\n address market,\n uint32 duration\n )\n external\n view\n returns (bool increaseCardinalityRequired, uint16 cardinalityRequired, bool oldestObservationSatisfied);\n}\n" + }, + "contracts/interfaces/IPStakePool.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface IPStakePool {\n struct Data {\n uint256 totalWei;\n uint256 poolTokenSupply;\n }\n\n /**\n * @dev The current exchange rate for converting stkBNB to BNB.\n */\n function exchangeRate() external view returns (Data memory);\n}\n" + }, + "contracts/interfaces/ISFrax.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface ISFrax {\n function convertToAssets(uint256 shares) external view returns (uint256);\n function decimals() external view returns (uint8);\n}\n" + }, + "contracts/interfaces/ISfrxEthFraxOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface ISfrxEthFraxOracle {\n function getPrices() external view returns (bool _isbadData, uint256 _priceLow, uint256 _priceHigh);\n}\n" + }, + "contracts/interfaces/IStaderStakeManager.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface IStaderStakeManager {\n function convertBnbXToBnb(uint256 _amount) external view returns (uint256);\n}\n" + }, + "contracts/interfaces/IStETH.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\ninterface IStETH {\n function getPooledEthByShares(uint256 _sharesAmount) external view returns (uint256);\n function decimals() external view returns (uint8);\n}\n" + }, + "contracts/interfaces/ISynclubStakeManager.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface ISynclubStakeManager {\n function convertSnBnbToBnb(uint256 _amount) external view returns (uint256);\n}\n" + }, + "contracts/interfaces/IWBETH.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\ninterface IWBETH {\n function exchangeRate() external view returns (uint256);\n function decimals() external view returns (uint8);\n}\n" + }, + "contracts/interfaces/OracleInterface.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\ninterface OracleInterface {\n function getPrice(address asset) external view returns (uint256);\n}\n\ninterface ResilientOracleInterface is OracleInterface {\n function updatePrice(address vToken) external;\n\n function updateAssetPrice(address asset) external;\n\n function getUnderlyingPrice(address vToken) external view returns (uint256);\n}\n\ninterface TwapInterface is OracleInterface {\n function updateTwap(address asset) external returns (uint256);\n}\n\ninterface BoundValidatorInterface {\n function validatePriceWithAnchorPrice(\n address asset,\n uint256 reporterPrice,\n uint256 anchorPrice\n ) external view returns (bool);\n}\n" + }, + "contracts/interfaces/PublicResolverInterface.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\n// SPDX-FileCopyrightText: 2022 Venus\npragma solidity ^0.8.25;\n\ninterface PublicResolverInterface {\n function addr(bytes32 node) external view returns (address payable);\n}\n" + }, + "contracts/interfaces/PythInterface.sol": { + "content": "// SPDX-License-Identifier: Apache-2.0\n// SPDX-FileCopyrightText: 2021 Pyth Data Foundation\npragma solidity ^0.8.25;\n\ncontract PythStructs {\n // A price with a degree of uncertainty, represented as a price +- a confidence interval.\n //\n // The confidence interval roughly corresponds to the standard error of a normal distribution.\n // Both the price and confidence are stored in a fixed-point numeric representation,\n // `x * (10^expo)`, where `expo` is the exponent.\n //\n // Please refer to the documentation at https://docs.pyth.network/consumers/best-practices for how\n // to how this price safely.\n struct Price {\n // Price\n int64 price;\n // Confidence interval around the price\n uint64 conf;\n // Price exponent\n int32 expo;\n // Unix timestamp describing when the price was published\n uint256 publishTime;\n }\n\n // PriceFeed represents a current aggregate price from pyth publisher feeds.\n struct PriceFeed {\n // The price ID.\n bytes32 id;\n // Latest available price\n Price price;\n // Latest available exponentially-weighted moving average price\n Price emaPrice;\n }\n}\n\n/// @title Consume prices from the Pyth Network (https://pyth.network/).\n/// @dev Please refer to the guidance at https://docs.pyth.network/consumers/best-practices\n/// for how to consume prices safely.\n/// @author Pyth Data Association\ninterface IPyth {\n /// @dev Emitted when an update for price feed with `id` is processed successfully.\n /// @param id The Pyth Price Feed ID.\n /// @param fresh True if the price update is more recent and stored.\n /// @param chainId ID of the source chain that the batch price update containing this price.\n /// This value comes from Wormhole, and you can find the corresponding chains\n /// at https://docs.wormholenetwork.com/wormhole/contracts.\n /// @param sequenceNumber Sequence number of the batch price update containing this price.\n /// @param lastPublishTime Publish time of the previously stored price.\n /// @param publishTime Publish time of the given price update.\n /// @param price Price of the given price update.\n /// @param conf Confidence interval of the given price update.\n event PriceFeedUpdate(\n bytes32 indexed id,\n bool indexed fresh,\n uint16 chainId,\n uint64 sequenceNumber,\n uint256 lastPublishTime,\n uint256 publishTime,\n int64 price,\n uint64 conf\n );\n\n /// @dev Emitted when a batch price update is processed successfully.\n /// @param chainId ID of the source chain that the batch price update comes from.\n /// @param sequenceNumber Sequence number of the batch price update.\n /// @param batchSize Number of prices within the batch price update.\n /// @param freshPricesInBatch Number of prices that were more recent and were stored.\n event BatchPriceFeedUpdate(uint16 chainId, uint64 sequenceNumber, uint256 batchSize, uint256 freshPricesInBatch);\n\n /// @dev Emitted when a call to `updatePriceFeeds` is processed successfully.\n /// @param sender Sender of the call (`msg.sender`).\n /// @param batchCount Number of batches that this function processed.\n /// @param fee Amount of paid fee for updating the prices.\n event UpdatePriceFeeds(address indexed sender, uint256 batchCount, uint256 fee);\n\n /// @notice Returns the period (in seconds) that a price feed is considered valid since its publish time\n function getValidTimePeriod() external view returns (uint256 validTimePeriod);\n\n /// @notice Returns the price and confidence interval.\n /// @dev Reverts if the price has not been updated within the last `getValidTimePeriod()` seconds.\n /// @param id The Pyth Price Feed ID of which to fetch the price and confidence interval.\n /// @return price - please read the documentation of PythStructs.Price to understand how to use this safely.\n function getPrice(bytes32 id) external view returns (PythStructs.Price memory price);\n\n /// @notice Returns the exponentially-weighted moving average price and confidence interval.\n /// @dev Reverts if the EMA price is not available.\n /// @param id The Pyth Price Feed ID of which to fetch the EMA price and confidence interval.\n /// @return price - please read the documentation of PythStructs.Price to understand how to use this safely.\n function getEmaPrice(bytes32 id) external view returns (PythStructs.Price memory price);\n\n /// @notice Returns the price of a price feed without any sanity checks.\n /// @dev This function returns the most recent price update in this contract without any recency checks.\n /// This function is unsafe as the returned price update may be arbitrarily far in the past.\n ///\n /// Users of this function should check the `publishTime` in the price to ensure that the returned price is\n /// sufficiently recent for their application. If you are considering using this function, it may be\n /// safer / easier to use either `getPrice` or `getPriceNoOlderThan`.\n /// @return price - please read the documentation of PythStructs.Price to understand how to use this safely.\n function getPriceUnsafe(bytes32 id) external view returns (PythStructs.Price memory price);\n\n /// @notice Returns the price that is no older than `age` seconds of the current time.\n /// @dev This function is a sanity-checked version of `getPriceUnsafe` which is useful in\n /// applications that require a sufficiently-recent price. Reverts if the price wasn't updated sufficiently\n /// recently.\n /// @return price - please read the documentation of PythStructs.Price to understand how to use this safely.\n function getPriceNoOlderThan(bytes32 id, uint256 age) external view returns (PythStructs.Price memory price);\n\n /// @notice Returns the exponentially-weighted moving average price of a price feed without any sanity checks.\n /// @dev This function returns the same price as `getEmaPrice` in the case where the price is available.\n /// However, if the price is not recent this function returns the latest available price.\n ///\n /// The returned price can be from arbitrarily far in the past; this function makes no guarantees that\n /// the returned price is recent or useful for any particular application.\n ///\n /// Users of this function should check the `publishTime` in the price to ensure that the returned price is\n /// sufficiently recent for their application. If you are considering using this function, it may be\n /// safer / easier to use either `getEmaPrice` or `getEmaPriceNoOlderThan`.\n /// @return price - please read the documentation of PythStructs.Price to understand how to use this safely.\n function getEmaPriceUnsafe(bytes32 id) external view returns (PythStructs.Price memory price);\n\n /// @notice Returns the exponentially-weighted moving average price that is no older than `age` seconds\n /// of the current time.\n /// @dev This function is a sanity-checked version of `getEmaPriceUnsafe` which is useful in\n /// applications that require a sufficiently-recent price. Reverts if the price wasn't updated sufficiently\n /// recently.\n /// @return price - please read the documentation of PythStructs.Price to understand how to use this safely.\n function getEmaPriceNoOlderThan(bytes32 id, uint256 age) external view returns (PythStructs.Price memory price);\n\n /// @notice Update price feeds with given update messages.\n /// This method requires the caller to pay a fee in wei; the required fee can be computed by calling\n /// `getUpdateFee` with the length of the `updateData` array.\n /// Prices will be updated if they are more recent than the current stored prices.\n /// The call will succeed even if the update is not the most recent.\n /// @dev Reverts if the transferred fee is not sufficient or the updateData is invalid.\n /// @param updateData Array of price update data.\n function updatePriceFeeds(bytes[] calldata updateData) external payable;\n\n /// @notice Wrapper around updatePriceFeeds that rejects fast if a price update is not necessary. A price update is\n /// necessary if the current on-chain publishTime is older than the given publishTime. It relies solely on the\n /// given `publishTimes` for the price feeds and does not read the actual price\n /// update publish time within `updateData`.\n ///\n /// This method requires the caller to pay a fee in wei; the required fee can be computed by calling\n /// `getUpdateFee` with the length of the `updateData` array.\n ///\n /// `priceIds` and `publishTimes` are two arrays with the same size that correspond to senders known publishTime\n /// of each priceId when calling this method. If all of price feeds within `priceIds` have updated and have\n /// a newer or equal publish time than the given publish time, it will reject the transaction to save gas.\n /// Otherwise, it calls updatePriceFeeds method to update the prices.\n ///\n /// @dev Reverts if update is not needed or the transferred fee is not sufficient or the updateData is invalid.\n /// @param updateData Array of price update data.\n /// @param priceIds Array of price ids.\n /// @param publishTimes Array of publishTimes. `publishTimes[i]` corresponds to known `publishTime` of `priceIds[i]`\n function updatePriceFeedsIfNecessary(\n bytes[] calldata updateData,\n bytes32[] calldata priceIds,\n uint64[] calldata publishTimes\n ) external payable;\n\n /// @notice Returns the required fee to update an array of price updates.\n /// @param updateDataSize Number of price updates.\n /// @return feeAmount The required fee in Wei.\n function getUpdateFee(uint256 updateDataSize) external view returns (uint256 feeAmount);\n}\n\nabstract contract AbstractPyth is IPyth {\n /// @notice Returns the price feed with given id.\n /// @dev Reverts if the price does not exist.\n /// @param id The Pyth Price Feed ID of which to fetch the PriceFeed.\n function queryPriceFeed(bytes32 id) public view virtual returns (PythStructs.PriceFeed memory priceFeed);\n\n /// @notice Returns true if a price feed with the given id exists.\n /// @param id The Pyth Price Feed ID of which to check its existence.\n function priceFeedExists(bytes32 id) public view virtual returns (bool exists);\n\n function getValidTimePeriod() public view virtual override returns (uint256 validTimePeriod);\n\n function getPrice(bytes32 id) external view override returns (PythStructs.Price memory price) {\n return getPriceNoOlderThan(id, getValidTimePeriod());\n }\n\n function getEmaPrice(bytes32 id) external view override returns (PythStructs.Price memory price) {\n return getEmaPriceNoOlderThan(id, getValidTimePeriod());\n }\n\n function getPriceUnsafe(bytes32 id) public view override returns (PythStructs.Price memory price) {\n PythStructs.PriceFeed memory priceFeed = queryPriceFeed(id);\n return priceFeed.price;\n }\n\n function getPriceNoOlderThan(\n bytes32 id,\n uint256 age\n ) public view override returns (PythStructs.Price memory price) {\n price = getPriceUnsafe(id);\n\n require(diff(block.timestamp, price.publishTime) <= age, \"no price available which is recent enough\");\n\n return price;\n }\n\n function getEmaPriceUnsafe(bytes32 id) public view override returns (PythStructs.Price memory price) {\n PythStructs.PriceFeed memory priceFeed = queryPriceFeed(id);\n return priceFeed.emaPrice;\n }\n\n function getEmaPriceNoOlderThan(\n bytes32 id,\n uint256 age\n ) public view override returns (PythStructs.Price memory price) {\n price = getEmaPriceUnsafe(id);\n\n require(diff(block.timestamp, price.publishTime) <= age, \"no ema price available which is recent enough\");\n\n return price;\n }\n\n function diff(uint256 x, uint256 y) internal pure returns (uint256) {\n if (x > y) {\n return x - y;\n } else {\n return y - x;\n }\n }\n\n // Access modifier is overridden to public to be able to call it locally.\n function updatePriceFeeds(bytes[] calldata updateData) public payable virtual override;\n\n function updatePriceFeedsIfNecessary(\n bytes[] calldata updateData,\n bytes32[] calldata priceIds,\n uint64[] calldata publishTimes\n ) external payable override {\n require(priceIds.length == publishTimes.length, \"priceIds and publishTimes arrays should have same length\");\n\n bool updateNeeded = false;\n for (uint256 i = 0; i < priceIds.length; ) {\n if (!priceFeedExists(priceIds[i]) || queryPriceFeed(priceIds[i]).price.publishTime < publishTimes[i]) {\n updateNeeded = true;\n break;\n }\n unchecked {\n i++;\n }\n }\n\n require(updateNeeded, \"no prices in the submitted batch have fresh prices, so this update will have no effect\");\n\n updatePriceFeeds(updateData);\n }\n}\n" + }, + "contracts/interfaces/SIDRegistryInterface.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\n// SPDX-FileCopyrightText: 2022 Venus\npragma solidity ^0.8.25;\n\ninterface SIDRegistryInterface {\n function resolver(bytes32 node) external view returns (address);\n}\n" + }, + "contracts/interfaces/VBep20Interface.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity ^0.8.25;\n\nimport \"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\";\n\ninterface VBep20Interface is IERC20Metadata {\n /**\n * @notice Underlying asset for this VToken\n */\n function underlying() external view returns (address);\n}\n" + }, + "contracts/oracles/AnkrBNBOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { IAnkrBNB } from \"../interfaces/IAnkrBNB.sol\";\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\n\n/**\n * @title AnkrBNBOracle\n * @author Venus\n * @notice This oracle fetches the price of ankrBNB asset\n */\ncontract AnkrBNBOracle is CorrelatedTokenOracle {\n /// @notice This is used as token address of BNB on BSC\n address public constant NATIVE_TOKEN_ADDR = 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB;\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address ankrBNB,\n address resilientOracle\n ) CorrelatedTokenOracle(ankrBNB, NATIVE_TOKEN_ADDR, resilientOracle) {}\n\n /**\n * @notice Fetches the amount of BNB for 1 ankrBNB\n * @return amount The amount of BNB for ankrBNB\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n return IAnkrBNB(CORRELATED_TOKEN).sharesToBonds(EXP_SCALE);\n }\n}\n" + }, + "contracts/oracles/BinanceOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\";\nimport \"../interfaces/VBep20Interface.sol\";\nimport \"../interfaces/SIDRegistryInterface.sol\";\nimport \"../interfaces/FeedRegistryInterface.sol\";\nimport \"../interfaces/PublicResolverInterface.sol\";\nimport \"../interfaces/OracleInterface.sol\";\nimport \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\";\nimport \"../interfaces/OracleInterface.sol\";\n\n/**\n * @title BinanceOracle\n * @author Venus\n * @notice This oracle fetches price of assets from Binance.\n */\ncontract BinanceOracle is AccessControlledV8, OracleInterface {\n /// @notice Used to fetch feed registry address.\n address public sidRegistryAddress;\n\n /// @notice Set this as asset address for BNB. This is the underlying address for vBNB\n address public constant BNB_ADDR = 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB;\n\n /// @notice Max stale period configuration for assets\n mapping(string => uint256) public maxStalePeriod;\n\n /// @notice Override symbols to be compatible with Binance feed registry\n mapping(string => string) public symbols;\n\n /// @notice Used to fetch price of assets used directly when space ID is not supported by current chain.\n address public feedRegistryAddress;\n\n /// @notice Emits when asset stale period is updated.\n event MaxStalePeriodAdded(string indexed asset, uint256 maxStalePeriod);\n\n /// @notice Emits when symbol of the asset is updated.\n event SymbolOverridden(string indexed symbol, string overriddenSymbol);\n\n /// @notice Emits when address of feed registry is updated.\n event FeedRegistryUpdated(address indexed oldFeedRegistry, address indexed newFeedRegistry);\n\n /**\n * @notice Checks whether an address is null or not\n */\n modifier notNullAddress(address someone) {\n if (someone == address(0)) revert(\"can't be zero address\");\n _;\n }\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor() {\n _disableInitializers();\n }\n\n /**\n * @notice Sets the contracts required to fetch prices\n * @param _sidRegistryAddress Address of SID registry\n * @param _accessControlManager Address of the access control manager contract\n */\n function initialize(address _sidRegistryAddress, address _accessControlManager) external initializer {\n sidRegistryAddress = _sidRegistryAddress;\n __AccessControlled_init(_accessControlManager);\n }\n\n /**\n * @notice Used to set the max stale period of an asset\n * @param symbol The symbol of the asset\n * @param _maxStalePeriod The max stake period\n */\n function setMaxStalePeriod(string memory symbol, uint256 _maxStalePeriod) external {\n _checkAccessAllowed(\"setMaxStalePeriod(string,uint256)\");\n if (_maxStalePeriod == 0) revert(\"stale period can't be zero\");\n if (bytes(symbol).length == 0) revert(\"symbol cannot be empty\");\n\n maxStalePeriod[symbol] = _maxStalePeriod;\n emit MaxStalePeriodAdded(symbol, _maxStalePeriod);\n }\n\n /**\n * @notice Used to override a symbol when fetching price\n * @param symbol The symbol to override\n * @param overrideSymbol The symbol after override\n */\n function setSymbolOverride(string calldata symbol, string calldata overrideSymbol) external {\n _checkAccessAllowed(\"setSymbolOverride(string,string)\");\n if (bytes(symbol).length == 0) revert(\"symbol cannot be empty\");\n\n symbols[symbol] = overrideSymbol;\n emit SymbolOverridden(symbol, overrideSymbol);\n }\n\n /**\n * @notice Used to set feed registry address when current chain does not support space ID.\n * @param newfeedRegistryAddress Address of new feed registry.\n */\n function setFeedRegistryAddress(\n address newfeedRegistryAddress\n ) external notNullAddress(newfeedRegistryAddress) onlyOwner {\n if (sidRegistryAddress != address(0)) revert(\"sidRegistryAddress must be zero\");\n emit FeedRegistryUpdated(feedRegistryAddress, newfeedRegistryAddress);\n feedRegistryAddress = newfeedRegistryAddress;\n }\n\n /**\n * @notice Uses Space ID to fetch the feed registry address\n * @return feedRegistryAddress Address of binance oracle feed registry.\n */\n function getFeedRegistryAddress() public view returns (address) {\n bytes32 nodeHash = 0x94fe3821e0768eb35012484db4df61890f9a6ca5bfa984ef8ff717e73139faff;\n\n SIDRegistryInterface sidRegistry = SIDRegistryInterface(sidRegistryAddress);\n address publicResolverAddress = sidRegistry.resolver(nodeHash);\n PublicResolverInterface publicResolver = PublicResolverInterface(publicResolverAddress);\n\n return publicResolver.addr(nodeHash);\n }\n\n /**\n * @notice Gets the price of a asset from the binance oracle\n * @param asset Address of the asset\n * @return Price in USD\n */\n function getPrice(address asset) public view returns (uint256) {\n string memory symbol;\n uint256 decimals;\n\n if (asset == BNB_ADDR) {\n symbol = \"BNB\";\n decimals = 18;\n } else {\n IERC20Metadata token = IERC20Metadata(asset);\n symbol = token.symbol();\n decimals = token.decimals();\n }\n\n string memory overrideSymbol = symbols[symbol];\n\n if (bytes(overrideSymbol).length != 0) {\n symbol = overrideSymbol;\n }\n\n return _getPrice(symbol, decimals);\n }\n\n function _getPrice(string memory symbol, uint256 decimals) internal view returns (uint256) {\n FeedRegistryInterface feedRegistry;\n\n if (sidRegistryAddress != address(0)) {\n // If sidRegistryAddress is available, fetch feedRegistryAddress from sidRegistry\n feedRegistry = FeedRegistryInterface(getFeedRegistryAddress());\n } else {\n // Use feedRegistry directly if sidRegistryAddress is not available\n feedRegistry = FeedRegistryInterface(feedRegistryAddress);\n }\n\n (, int256 answer, , uint256 updatedAt, ) = feedRegistry.latestRoundDataByName(symbol, \"USD\");\n if (answer <= 0) revert(\"invalid binance oracle price\");\n if (block.timestamp < updatedAt) revert(\"updatedAt exceeds block time\");\n\n uint256 deltaTime;\n unchecked {\n deltaTime = block.timestamp - updatedAt;\n }\n if (deltaTime > maxStalePeriod[symbol]) revert(\"binance oracle price expired\");\n\n uint256 decimalDelta = feedRegistry.decimalsByName(symbol, \"USD\");\n return (uint256(answer) * (10 ** (18 - decimalDelta))) * (10 ** (18 - decimals));\n }\n}\n" + }, + "contracts/oracles/BNBxOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { IStaderStakeManager } from \"../interfaces/IStaderStakeManager.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\n\n/**\n * @title BNBxOracle\n * @author Venus\n * @notice This oracle fetches the price of BNBx asset\n */\ncontract BNBxOracle is CorrelatedTokenOracle {\n /// @notice This is used as token address of BNB on BSC\n address public constant NATIVE_TOKEN_ADDR = 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB;\n\n /// @notice Address of StakeManager\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IStaderStakeManager public immutable STAKE_MANAGER;\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address stakeManager,\n address bnbx,\n address resilientOracle\n ) CorrelatedTokenOracle(bnbx, NATIVE_TOKEN_ADDR, resilientOracle) {\n ensureNonzeroAddress(stakeManager);\n STAKE_MANAGER = IStaderStakeManager(stakeManager);\n }\n\n /**\n * @notice Fetches the amount of BNB for 1 BNBx\n * @return price The amount of BNB for BNBx\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n return STAKE_MANAGER.convertBnbXToBnb(EXP_SCALE);\n }\n}\n" + }, + "contracts/oracles/BoundValidator.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"../interfaces/VBep20Interface.sol\";\nimport \"../interfaces/OracleInterface.sol\";\nimport \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\";\n\n/**\n * @title BoundValidator\n * @author Venus\n * @notice The BoundValidator contract is used to validate prices fetched from two different sources.\n * Each asset has an upper and lower bound ratio set in the config. In order for a price to be valid\n * it must fall within this range of the validator price.\n */\ncontract BoundValidator is AccessControlledV8, BoundValidatorInterface {\n struct ValidateConfig {\n /// @notice asset address\n address asset;\n /// @notice Upper bound of deviation between reported price and anchor price,\n /// beyond which the reported price will be invalidated\n uint256 upperBoundRatio;\n /// @notice Lower bound of deviation between reported price and anchor price,\n /// below which the reported price will be invalidated\n uint256 lowerBoundRatio;\n }\n\n /// @notice validation configs by asset\n mapping(address => ValidateConfig) public validateConfigs;\n\n /// @notice Emit this event when new validation configs are added\n event ValidateConfigAdded(address indexed asset, uint256 indexed upperBound, uint256 indexed lowerBound);\n\n /// @notice Constructor for the implementation contract. Sets immutable variables.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor() {\n _disableInitializers();\n }\n\n /**\n * @notice Initializes the owner of the contract\n * @param accessControlManager_ Address of the access control manager contract\n */\n function initialize(address accessControlManager_) external initializer {\n __AccessControlled_init(accessControlManager_);\n }\n\n /**\n * @notice Add multiple validation configs at the same time\n * @param configs Array of validation configs\n * @custom:access Only Governance\n * @custom:error Zero length error is thrown if length of the config array is 0\n * @custom:event Emits ValidateConfigAdded for each validation config that is successfully set\n */\n function setValidateConfigs(ValidateConfig[] memory configs) external {\n uint256 length = configs.length;\n if (length == 0) revert(\"invalid validate config length\");\n for (uint256 i; i < length; ) {\n setValidateConfig(configs[i]);\n unchecked {\n ++i;\n }\n }\n }\n\n /**\n * @notice Add a single validation config\n * @param config Validation config struct\n * @custom:access Only Governance\n * @custom:error Null address error is thrown if asset address is null\n * @custom:error Range error thrown if bound ratio is not positive\n * @custom:error Range error thrown if lower bound is greater than or equal to upper bound\n * @custom:event Emits ValidateConfigAdded when a validation config is successfully set\n */\n function setValidateConfig(ValidateConfig memory config) public {\n _checkAccessAllowed(\"setValidateConfig(ValidateConfig)\");\n\n if (config.asset == address(0)) revert(\"asset can't be zero address\");\n if (config.upperBoundRatio == 0 || config.lowerBoundRatio == 0) revert(\"bound must be positive\");\n if (config.upperBoundRatio <= config.lowerBoundRatio) revert(\"upper bound must be higher than lowner bound\");\n validateConfigs[config.asset] = config;\n emit ValidateConfigAdded(config.asset, config.upperBoundRatio, config.lowerBoundRatio);\n }\n\n /**\n * @notice Test reported asset price against anchor price\n * @param asset asset address\n * @param reportedPrice The price to be tested\n * @custom:error Missing error thrown if asset config is not set\n * @custom:error Price error thrown if anchor price is not valid\n */\n function validatePriceWithAnchorPrice(\n address asset,\n uint256 reportedPrice,\n uint256 anchorPrice\n ) public view virtual override returns (bool) {\n if (validateConfigs[asset].upperBoundRatio == 0) revert(\"validation config not exist\");\n if (anchorPrice == 0) revert(\"anchor price is not valid\");\n return _isWithinAnchor(asset, reportedPrice, anchorPrice);\n }\n\n /**\n * @notice Test whether the reported price is within the valid bounds\n * @param asset Asset address\n * @param reportedPrice The price to be tested\n * @param anchorPrice The reported price must be within the the valid bounds of this price\n */\n function _isWithinAnchor(address asset, uint256 reportedPrice, uint256 anchorPrice) private view returns (bool) {\n if (reportedPrice != 0) {\n // we need to multiply anchorPrice by 1e18 to make the ratio 18 decimals\n uint256 anchorRatio = (anchorPrice * 1e18) / reportedPrice;\n uint256 upperBoundAnchorRatio = validateConfigs[asset].upperBoundRatio;\n uint256 lowerBoundAnchorRatio = validateConfigs[asset].lowerBoundRatio;\n return anchorRatio <= upperBoundAnchorRatio && anchorRatio >= lowerBoundAnchorRatio;\n }\n return false;\n }\n\n // BoundValidator is to get inherited, so it's a good practice to add some storage gaps like\n // OpenZepplin proposed in their contracts: https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n // solhint-disable-next-line\n uint256[49] private __gap;\n}\n" + }, + "contracts/oracles/ChainlinkOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"../interfaces/VBep20Interface.sol\";\nimport \"../interfaces/OracleInterface.sol\";\nimport \"@chainlink/contracts/src/v0.8/interfaces/AggregatorV3Interface.sol\";\nimport \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\";\n\n/**\n * @title ChainlinkOracle\n * @author Venus\n * @notice This oracle fetches prices of assets from the Chainlink oracle.\n */\ncontract ChainlinkOracle is AccessControlledV8, OracleInterface {\n struct TokenConfig {\n /// @notice Underlying token address, which can't be a null address\n /// @notice Used to check if a token is supported\n /// @notice 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB address for native tokens\n /// (e.g BNB for BNB chain, ETH for Ethereum network)\n address asset;\n /// @notice Chainlink feed address\n address feed;\n /// @notice Price expiration period of this asset\n uint256 maxStalePeriod;\n }\n\n /// @notice Set this as asset address for native token on each chain.\n /// This is the underlying address for vBNB on BNB chain or an underlying asset for a native market on any chain.\n address public constant NATIVE_TOKEN_ADDR = 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB;\n\n /// @notice Manually set an override price, useful under extenuating conditions such as price feed failure\n mapping(address => uint256) public prices;\n\n /// @notice Token config by assets\n mapping(address => TokenConfig) public tokenConfigs;\n\n /// @notice Emit when a price is manually set\n event PricePosted(address indexed asset, uint256 previousPriceMantissa, uint256 newPriceMantissa);\n\n /// @notice Emit when a token config is added\n event TokenConfigAdded(address indexed asset, address feed, uint256 maxStalePeriod);\n\n modifier notNullAddress(address someone) {\n if (someone == address(0)) revert(\"can't be zero address\");\n _;\n }\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor() {\n _disableInitializers();\n }\n\n /**\n * @notice Initializes the owner of the contract\n * @param accessControlManager_ Address of the access control manager contract\n */\n function initialize(address accessControlManager_) external initializer {\n __AccessControlled_init(accessControlManager_);\n }\n\n /**\n * @notice Manually set the price of a given asset\n * @param asset Asset address\n * @param price Asset price in 18 decimals\n * @custom:access Only Governance\n * @custom:event Emits PricePosted event on succesfully setup of asset price\n */\n function setDirectPrice(address asset, uint256 price) external notNullAddress(asset) {\n _checkAccessAllowed(\"setDirectPrice(address,uint256)\");\n\n uint256 previousPriceMantissa = prices[asset];\n prices[asset] = price;\n emit PricePosted(asset, previousPriceMantissa, price);\n }\n\n /**\n * @notice Add multiple token configs at the same time\n * @param tokenConfigs_ config array\n * @custom:access Only Governance\n * @custom:error Zero length error thrown, if length of the array in parameter is 0\n */\n function setTokenConfigs(TokenConfig[] memory tokenConfigs_) external {\n if (tokenConfigs_.length == 0) revert(\"length can't be 0\");\n uint256 numTokenConfigs = tokenConfigs_.length;\n for (uint256 i; i < numTokenConfigs; ) {\n setTokenConfig(tokenConfigs_[i]);\n unchecked {\n ++i;\n }\n }\n }\n\n /**\n * @notice Add single token config. asset & feed cannot be null addresses and maxStalePeriod must be positive\n * @param tokenConfig Token config struct\n * @custom:access Only Governance\n * @custom:error NotNullAddress error is thrown if asset address is null\n * @custom:error NotNullAddress error is thrown if token feed address is null\n * @custom:error Range error is thrown if maxStale period of token is not greater than zero\n * @custom:event Emits TokenConfigAdded event on succesfully setting of the token config\n */\n function setTokenConfig(\n TokenConfig memory tokenConfig\n ) public notNullAddress(tokenConfig.asset) notNullAddress(tokenConfig.feed) {\n _checkAccessAllowed(\"setTokenConfig(TokenConfig)\");\n\n if (tokenConfig.maxStalePeriod == 0) revert(\"stale period can't be zero\");\n tokenConfigs[tokenConfig.asset] = tokenConfig;\n emit TokenConfigAdded(tokenConfig.asset, tokenConfig.feed, tokenConfig.maxStalePeriod);\n }\n\n /**\n * @notice Gets the price of a asset from the chainlink oracle\n * @param asset Address of the asset\n * @return Price in USD from Chainlink or a manually set price for the asset\n */\n function getPrice(address asset) public view virtual returns (uint256) {\n uint256 decimals;\n\n if (asset == NATIVE_TOKEN_ADDR) {\n decimals = 18;\n } else {\n IERC20Metadata token = IERC20Metadata(asset);\n decimals = token.decimals();\n }\n\n return _getPriceInternal(asset, decimals);\n }\n\n /**\n * @notice Gets the Chainlink price for a given asset\n * @param asset address of the asset\n * @param decimals decimals of the asset\n * @return price Asset price in USD or a manually set price of the asset\n */\n function _getPriceInternal(address asset, uint256 decimals) internal view returns (uint256 price) {\n uint256 tokenPrice = prices[asset];\n if (tokenPrice != 0) {\n price = tokenPrice;\n } else {\n price = _getChainlinkPrice(asset);\n }\n\n uint256 decimalDelta = 18 - decimals;\n return price * (10 ** decimalDelta);\n }\n\n /**\n * @notice Get the Chainlink price for an asset, revert if token config doesn't exist\n * @dev The precision of the price feed is used to ensure the returned price has 18 decimals of precision\n * @param asset Address of the asset\n * @return price Price in USD, with 18 decimals of precision\n * @custom:error NotNullAddress error is thrown if the asset address is null\n * @custom:error Price error is thrown if the Chainlink price of asset is not greater than zero\n * @custom:error Timing error is thrown if current timestamp is less than the last updatedAt timestamp\n * @custom:error Timing error is thrown if time difference between current time and last updated time\n * is greater than maxStalePeriod\n */\n function _getChainlinkPrice(\n address asset\n ) private view notNullAddress(tokenConfigs[asset].asset) returns (uint256) {\n TokenConfig memory tokenConfig = tokenConfigs[asset];\n AggregatorV3Interface feed = AggregatorV3Interface(tokenConfig.feed);\n\n // note: maxStalePeriod cannot be 0\n uint256 maxStalePeriod = tokenConfig.maxStalePeriod;\n\n // Chainlink USD-denominated feeds store answers at 8 decimals, mostly\n uint256 decimalDelta = 18 - feed.decimals();\n\n (, int256 answer, , uint256 updatedAt, ) = feed.latestRoundData();\n if (answer <= 0) revert(\"chainlink price must be positive\");\n if (block.timestamp < updatedAt) revert(\"updatedAt exceeds block time\");\n\n uint256 deltaTime;\n unchecked {\n deltaTime = block.timestamp - updatedAt;\n }\n\n if (deltaTime > maxStalePeriod) revert(\"chainlink price expired\");\n\n return uint256(answer) * (10 ** decimalDelta);\n }\n}\n" + }, + "contracts/oracles/common/CorrelatedTokenOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { OracleInterface } from \"../../interfaces/OracleInterface.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { IERC20Metadata } from \"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\";\n\n/**\n * @title CorrelatedTokenOracle\n * @notice This oracle fetches the price of a token that is correlated to another token.\n */\nabstract contract CorrelatedTokenOracle is OracleInterface {\n /// @notice Address of the correlated token\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n address public immutable CORRELATED_TOKEN;\n\n /// @notice Address of the underlying token\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n address public immutable UNDERLYING_TOKEN;\n\n /// @notice Address of Resilient Oracle\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n OracleInterface public immutable RESILIENT_ORACLE;\n\n /// @notice Thrown if the token address is invalid\n error InvalidTokenAddress();\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(address correlatedToken, address underlyingToken, address resilientOracle) {\n ensureNonzeroAddress(correlatedToken);\n ensureNonzeroAddress(underlyingToken);\n ensureNonzeroAddress(resilientOracle);\n CORRELATED_TOKEN = correlatedToken;\n UNDERLYING_TOKEN = underlyingToken;\n RESILIENT_ORACLE = OracleInterface(resilientOracle);\n }\n\n /**\n * @notice Fetches the price of the correlated token\n * @param asset Address of the correlated token\n * @return price The price of the correlated token in scaled decimal places\n */\n function getPrice(address asset) external view override returns (uint256) {\n if (asset != CORRELATED_TOKEN) revert InvalidTokenAddress();\n\n // get underlying token amount for 1 correlated token scaled by underlying token decimals\n uint256 underlyingAmount = _getUnderlyingAmount();\n\n // oracle returns (36 - asset decimal) scaled price\n uint256 underlyingUSDPrice = RESILIENT_ORACLE.getPrice(UNDERLYING_TOKEN);\n\n IERC20Metadata token = IERC20Metadata(CORRELATED_TOKEN);\n uint256 decimals = token.decimals();\n\n // underlyingAmount (for 1 correlated token) * underlyingUSDPrice / decimals(correlated token)\n return (underlyingAmount * underlyingUSDPrice) / (10 ** decimals);\n }\n\n /**\n * @notice Gets the underlying amount for correlated token\n * @return underlyingAmount Amount of underlying token\n */\n function _getUnderlyingAmount() internal view virtual returns (uint256);\n}\n" + }, + "contracts/oracles/mocks/MockBinanceFeedRegistry.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"../../interfaces/FeedRegistryInterface.sol\";\n\ncontract MockBinanceFeedRegistry is FeedRegistryInterface {\n mapping(string => uint256) public assetPrices;\n\n function setAssetPrice(string memory base, uint256 price) external {\n assetPrices[base] = price;\n }\n\n function latestRoundDataByName(\n string memory base,\n string memory quote\n )\n external\n view\n override\n returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)\n {\n quote;\n return (0, int256(assetPrices[base]), 0, block.timestamp - 10, 0);\n }\n\n function decimalsByName(string memory base, string memory quote) external view override returns (uint8) {\n return 8;\n }\n}\n" + }, + "contracts/oracles/mocks/MockBinanceOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { OwnableUpgradeable } from \"@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol\";\nimport { OracleInterface } from \"../../interfaces/OracleInterface.sol\";\n\ncontract MockBinanceOracle is OwnableUpgradeable, OracleInterface {\n mapping(address => uint256) public assetPrices;\n\n constructor() {}\n\n function initialize() public initializer {}\n\n function setPrice(address asset, uint256 price) external {\n assetPrices[asset] = price;\n }\n\n function getPrice(address token) public view returns (uint256) {\n return assetPrices[token];\n }\n}\n" + }, + "contracts/oracles/mocks/MockChainlinkOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { OwnableUpgradeable } from \"@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol\";\nimport { OracleInterface } from \"../../interfaces/OracleInterface.sol\";\n\ncontract MockChainlinkOracle is OwnableUpgradeable, OracleInterface {\n mapping(address => uint256) public assetPrices;\n\n //set price in 6 decimal precision\n constructor() {}\n\n function initialize() public initializer {\n __Ownable_init();\n }\n\n function setPrice(address asset, uint256 price) external {\n assetPrices[asset] = price;\n }\n\n //https://compound.finance/docs/prices\n function getPrice(address token) public view returns (uint256) {\n return assetPrices[token];\n }\n}\n" + }, + "contracts/oracles/mocks/MockPendlePtOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"../../interfaces/IPendlePtOracle.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\n\ncontract MockPendlePtOracle is IPendlePtOracle, Ownable {\n mapping(address => mapping(uint32 => uint256)) public ptToAssetRate;\n\n constructor() Ownable() {}\n\n function setPtToAssetRate(address market, uint32 duration, uint256 rate) external onlyOwner {\n ptToAssetRate[market][duration] = rate;\n }\n\n function getPtToAssetRate(address market, uint32 duration) external view returns (uint256) {\n return ptToAssetRate[market][duration];\n }\n\n function getOracleState(\n address market,\n uint32 duration\n )\n external\n view\n returns (bool increaseCardinalityRequired, uint16 cardinalityRequired, bool oldestObservationSatisfied)\n {\n return (false, 0, true);\n }\n}\n" + }, + "contracts/oracles/mocks/MockPythOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { OwnableUpgradeable } from \"@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol\";\nimport { IPyth } from \"../PythOracle.sol\";\nimport { OracleInterface } from \"../../interfaces/OracleInterface.sol\";\n\ncontract MockPythOracle is OwnableUpgradeable {\n mapping(address => uint256) public assetPrices;\n\n /// @notice the actual pyth oracle address fetch & store the prices\n IPyth public underlyingPythOracle;\n\n //set price in 6 decimal precision\n constructor() {}\n\n function initialize(address underlyingPythOracle_) public initializer {\n __Ownable_init();\n if (underlyingPythOracle_ == address(0)) revert(\"pyth oracle cannot be zero address\");\n underlyingPythOracle = IPyth(underlyingPythOracle_);\n }\n\n function setPrice(address asset, uint256 price) external {\n assetPrices[asset] = price;\n }\n\n //https://compound.finance/docs/prices\n function getPrice(address token) public view returns (uint256) {\n return assetPrices[token];\n }\n}\n" + }, + "contracts/oracles/mocks/MockSFrxEthFraxOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"../../interfaces/ISfrxEthFraxOracle.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\n\ncontract MockSfrxEthFraxOracle is ISfrxEthFraxOracle, Ownable {\n bool public isBadData;\n uint256 public priceLow;\n uint256 public priceHigh;\n\n constructor() Ownable() {}\n\n function setPrices(bool _isBadData, uint256 _priceLow, uint256 _priceHigh) external onlyOwner {\n isBadData = _isBadData;\n priceLow = _priceLow;\n priceHigh = _priceHigh;\n }\n\n function getPrices() external view override returns (bool, uint256, uint256) {\n return (isBadData, priceLow, priceHigh);\n }\n}\n" + }, + "contracts/oracles/OneJumpOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { OracleInterface } from \"../interfaces/OracleInterface.sol\";\nimport { IERC20Metadata } from \"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\";\n\n/**\n * @title OneJumpOracle\n * @author Venus\n * @notice This oracle fetches the price of an asset in through an intermediate asset\n */\ncontract OneJumpOracle is CorrelatedTokenOracle {\n /// @notice Address of the intermediate oracle\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n OracleInterface public immutable INTERMEDIATE_ORACLE;\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address correlatedToken,\n address underlyingToken,\n address resilientOracle,\n address intermediateOracle\n ) CorrelatedTokenOracle(correlatedToken, underlyingToken, resilientOracle) {\n ensureNonzeroAddress(intermediateOracle);\n INTERMEDIATE_ORACLE = OracleInterface(intermediateOracle);\n }\n\n /**\n * @notice Fetches the amount of the underlying token for 1 correlated token, using the intermediate oracle\n * @return amount The amount of the underlying token for 1 correlated token scaled by the underlying token decimals\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n uint256 underlyingDecimals = IERC20Metadata(UNDERLYING_TOKEN).decimals();\n uint256 correlatedDecimals = IERC20Metadata(CORRELATED_TOKEN).decimals();\n\n uint256 underlyingAmount = INTERMEDIATE_ORACLE.getPrice(CORRELATED_TOKEN);\n\n return (underlyingAmount * (10 ** correlatedDecimals)) / (10 ** (36 - underlyingDecimals));\n }\n}\n" + }, + "contracts/oracles/PendleOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { IPendlePtOracle } from \"../interfaces/IPendlePtOracle.sol\";\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\nimport { ensureNonzeroAddress, ensureNonzeroValue } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\n\n/**\n * @title PendleOracle\n * @author Venus\n * @notice This oracle fetches the price of a pendle token\n */\ncontract PendleOracle is CorrelatedTokenOracle {\n /// @notice Address of the PT oracle\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IPendlePtOracle public immutable PT_ORACLE;\n\n /// @notice Address of the market\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n address public immutable MARKET;\n\n /// @notice Twap duration for the oracle\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n uint32 public immutable TWAP_DURATION;\n\n /// @notice Thrown if the duration is invalid\n error InvalidDuration();\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address market,\n address ptOracle,\n address ptToken,\n address underlyingToken,\n address resilientOracle,\n uint32 twapDuration\n ) CorrelatedTokenOracle(ptToken, underlyingToken, resilientOracle) {\n ensureNonzeroAddress(market);\n ensureNonzeroAddress(ptOracle);\n ensureNonzeroValue(twapDuration);\n\n MARKET = market;\n PT_ORACLE = IPendlePtOracle(ptOracle);\n TWAP_DURATION = twapDuration;\n\n (bool increaseCardinalityRequired, , bool oldestObservationSatisfied) = PT_ORACLE.getOracleState(\n MARKET,\n TWAP_DURATION\n );\n if (increaseCardinalityRequired || !oldestObservationSatisfied) {\n revert InvalidDuration();\n }\n }\n\n /**\n * @notice Fetches the amount of underlying token for 1 pendle token\n * @return amount The amount of underlying token for pendle token\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n return PT_ORACLE.getPtToAssetRate(MARKET, TWAP_DURATION);\n }\n}\n" + }, + "contracts/oracles/PythOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"@openzeppelin/contracts/utils/math/SafeCast.sol\";\nimport \"@openzeppelin/contracts/utils/math/SignedMath.sol\";\nimport \"../interfaces/PythInterface.sol\";\nimport \"../interfaces/OracleInterface.sol\";\nimport \"../interfaces/VBep20Interface.sol\";\nimport \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\";\n\n/**\n * @title PythOracle\n * @author Venus\n * @notice PythOracle contract reads prices from actual Pyth oracle contract which accepts, verifies and stores\n * the updated prices from external sources\n */\ncontract PythOracle is AccessControlledV8, OracleInterface {\n // To calculate 10 ** n(which is a signed type)\n using SignedMath for int256;\n\n // To cast int64/int8 types from Pyth to unsigned types\n using SafeCast for int256;\n\n struct TokenConfig {\n bytes32 pythId;\n address asset;\n uint64 maxStalePeriod;\n }\n\n /// @notice Exponent scale (decimal precision) of prices\n uint256 public constant EXP_SCALE = 1e18;\n\n /// @notice Set this as asset address for BNB. This is the underlying for vBNB\n address public constant BNB_ADDR = 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB;\n\n /// @notice The actual pyth oracle address fetch & store the prices\n IPyth public underlyingPythOracle;\n\n /// @notice Token configs by asset address\n mapping(address => TokenConfig) public tokenConfigs;\n\n /// @notice Emit when setting a new pyth oracle address\n event PythOracleSet(address indexed oldPythOracle, address indexed newPythOracle);\n\n /// @notice Emit when a token config is added\n event TokenConfigAdded(address indexed asset, bytes32 indexed pythId, uint64 indexed maxStalePeriod);\n\n modifier notNullAddress(address someone) {\n if (someone == address(0)) revert(\"can't be zero address\");\n _;\n }\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor() {\n _disableInitializers();\n }\n\n /**\n * @notice Initializes the owner of the contract and sets required contracts\n * @param underlyingPythOracle_ Address of the Pyth oracle\n * @param accessControlManager_ Address of the access control manager contract\n */\n function initialize(\n address underlyingPythOracle_,\n address accessControlManager_\n ) external initializer notNullAddress(underlyingPythOracle_) {\n __AccessControlled_init(accessControlManager_);\n\n underlyingPythOracle = IPyth(underlyingPythOracle_);\n emit PythOracleSet(address(0), underlyingPythOracle_);\n }\n\n /**\n * @notice Batch set token configs\n * @param tokenConfigs_ Token config array\n * @custom:access Only Governance\n * @custom:error Zero length error is thrown if length of the array in parameter is 0\n */\n function setTokenConfigs(TokenConfig[] memory tokenConfigs_) external {\n if (tokenConfigs_.length == 0) revert(\"length can't be 0\");\n uint256 numTokenConfigs = tokenConfigs_.length;\n for (uint256 i; i < numTokenConfigs; ) {\n setTokenConfig(tokenConfigs_[i]);\n unchecked {\n ++i;\n }\n }\n }\n\n /**\n * @notice Set the underlying Pyth oracle contract address\n * @param underlyingPythOracle_ Pyth oracle contract address\n * @custom:access Only Governance\n * @custom:error NotNullAddress error thrown if underlyingPythOracle_ address is zero\n * @custom:event Emits PythOracleSet event with address of Pyth oracle.\n */\n function setUnderlyingPythOracle(\n IPyth underlyingPythOracle_\n ) external notNullAddress(address(underlyingPythOracle_)) {\n _checkAccessAllowed(\"setUnderlyingPythOracle(address)\");\n IPyth oldUnderlyingPythOracle = underlyingPythOracle;\n underlyingPythOracle = underlyingPythOracle_;\n emit PythOracleSet(address(oldUnderlyingPythOracle), address(underlyingPythOracle_));\n }\n\n /**\n * @notice Set single token config. `maxStalePeriod` cannot be 0 and `asset` cannot be a null address\n * @param tokenConfig Token config struct\n * @custom:access Only Governance\n * @custom:error Range error is thrown if max stale period is zero\n * @custom:error NotNullAddress error is thrown if asset address is null\n */\n function setTokenConfig(TokenConfig memory tokenConfig) public notNullAddress(tokenConfig.asset) {\n _checkAccessAllowed(\"setTokenConfig(TokenConfig)\");\n if (tokenConfig.maxStalePeriod == 0) revert(\"max stale period cannot be 0\");\n tokenConfigs[tokenConfig.asset] = tokenConfig;\n emit TokenConfigAdded(tokenConfig.asset, tokenConfig.pythId, tokenConfig.maxStalePeriod);\n }\n\n /**\n * @notice Gets the price of a asset from the pyth oracle\n * @param asset Address of the asset\n * @return Price in USD\n */\n function getPrice(address asset) public view returns (uint256) {\n uint256 decimals;\n\n if (asset == BNB_ADDR) {\n decimals = 18;\n } else {\n IERC20Metadata token = IERC20Metadata(asset);\n decimals = token.decimals();\n }\n\n return _getPriceInternal(asset, decimals);\n }\n\n function _getPriceInternal(address asset, uint256 decimals) internal view returns (uint256) {\n TokenConfig storage tokenConfig = tokenConfigs[asset];\n if (tokenConfig.asset == address(0)) revert(\"asset doesn't exist\");\n\n // if the price is expired after it's compared against `maxStalePeriod`, the following call will revert\n PythStructs.Price memory priceInfo = underlyingPythOracle.getPriceNoOlderThan(\n tokenConfig.pythId,\n tokenConfig.maxStalePeriod\n );\n\n uint256 price = int256(priceInfo.price).toUint256();\n\n if (price == 0) revert(\"invalid pyth oracle price\");\n\n // the price returned from Pyth is price ** 10^expo, which is the real dollar price of the assets\n // we need to multiply it by 1e18 to make the price 18 decimals\n if (priceInfo.expo > 0) {\n return price * EXP_SCALE * (10 ** int256(priceInfo.expo).toUint256()) * (10 ** (18 - decimals));\n } else {\n return ((price * EXP_SCALE) / (10 ** int256(-priceInfo.expo).toUint256())) * (10 ** (18 - decimals));\n }\n }\n}\n" + }, + "contracts/oracles/SequencerChainlinkOracle.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity 0.8.25;\n\nimport { ChainlinkOracle } from \"./ChainlinkOracle.sol\";\nimport { AggregatorV3Interface } from \"@chainlink/contracts/src/v0.8/interfaces/AggregatorV3Interface.sol\";\n\n/**\n @title Sequencer Chain Link Oracle\n @notice Oracle to fetch price using chainlink oracles on L2s with sequencer\n*/\ncontract SequencerChainlinkOracle is ChainlinkOracle {\n /// @notice L2 Sequencer feed\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n AggregatorV3Interface public immutable sequencer;\n\n /// @notice L2 Sequencer grace period\n uint256 public constant GRACE_PERIOD_TIME = 3600;\n\n /**\n @notice Contract constructor\n @param _sequencer L2 sequencer\n @custom:oz-upgrades-unsafe-allow constructor\n */\n constructor(AggregatorV3Interface _sequencer) ChainlinkOracle() {\n require(address(_sequencer) != address(0), \"zero address\");\n\n sequencer = _sequencer;\n }\n\n /// @inheritdoc ChainlinkOracle\n function getPrice(address asset) public view override returns (uint) {\n if (!isSequencerActive()) revert(\"L2 sequencer unavailable\");\n return super.getPrice(asset);\n }\n\n function isSequencerActive() internal view returns (bool) {\n // answer from oracle is a variable with a value of either 1 or 0\n // 0: The sequencer is up\n // 1: The sequencer is down\n // startedAt: This timestamp indicates when the sequencer changed status\n (, int256 answer, uint256 startedAt, , ) = sequencer.latestRoundData();\n if (block.timestamp - startedAt <= GRACE_PERIOD_TIME || answer == 1) return false;\n return true;\n }\n}\n" + }, + "contracts/oracles/SFraxOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { ISFrax } from \"../interfaces/ISFrax.sol\";\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\n\n/**\n * @title SFraxOracle\n * @author Venus\n * @notice This oracle fetches the price of sFrax\n */\ncontract SFraxOracle is CorrelatedTokenOracle {\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address sFrax,\n address frax,\n address resilientOracle\n ) CorrelatedTokenOracle(sFrax, frax, resilientOracle) {}\n\n /**\n * @notice Fetches the amount of FRAX for 1 sFrax\n * @return amount The amount of FRAX for sFrax\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n return ISFrax(CORRELATED_TOKEN).convertToAssets(EXP_SCALE);\n }\n}\n" + }, + "contracts/oracles/SFrxETHOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { ISfrxEthFraxOracle } from \"../interfaces/ISfrxEthFraxOracle.sol\";\nimport { ensureNonzeroAddress, ensureNonzeroValue } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\nimport { AccessControlledV8 } from \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\";\nimport { OracleInterface } from \"../interfaces/OracleInterface.sol\";\n\n/**\n * @title SFrxETHOracle\n * @author Venus\n * @notice This oracle fetches the price of sfrxETH\n */\ncontract SFrxETHOracle is AccessControlledV8, OracleInterface {\n /// @notice Address of SfrxEthFraxOracle\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n ISfrxEthFraxOracle public immutable SFRXETH_FRAX_ORACLE;\n\n /// @notice Address of sfrxETH\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n address public immutable SFRXETH;\n\n /// @notice Maximum allowed price difference\n uint256 public maxAllowedPriceDifference;\n\n /// @notice Emits when the maximum allowed price difference is updated\n event MaxAllowedPriceDifferenceUpdated(uint256 oldMaxAllowedPriceDifference, uint256 newMaxAllowedPriceDifference);\n\n /// @notice Thrown if the price data is invalid\n error BadPriceData();\n\n /// @notice Thrown if the price difference exceeds the allowed limit\n error PriceDifferenceExceeded();\n\n /// @notice Thrown if the token address is invalid\n error InvalidTokenAddress();\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(address _sfrxEthFraxOracle, address _sfrxETH) {\n ensureNonzeroAddress(_sfrxEthFraxOracle);\n ensureNonzeroAddress(_sfrxETH);\n\n SFRXETH_FRAX_ORACLE = ISfrxEthFraxOracle(_sfrxEthFraxOracle);\n SFRXETH = _sfrxETH;\n\n _disableInitializers();\n }\n\n /**\n * @notice Sets the contracts required to fetch prices\n * @param _accessControlManager Address of the access control manager contract\n * @param _maxAllowedPriceDifference Maximum allowed price difference\n */\n function initialize(address _accessControlManager, uint256 _maxAllowedPriceDifference) external initializer {\n ensureNonzeroValue(_maxAllowedPriceDifference);\n\n __AccessControlled_init(_accessControlManager);\n maxAllowedPriceDifference = _maxAllowedPriceDifference;\n }\n\n /**\n * @notice Sets the maximum allowed price difference\n * @param _maxAllowedPriceDifference Maximum allowed price difference\n */\n function setMaxAllowedPriceDifference(uint256 _maxAllowedPriceDifference) external {\n _checkAccessAllowed(\"setMaxAllowedPriceDifference(uint256)\");\n ensureNonzeroValue(_maxAllowedPriceDifference);\n\n emit MaxAllowedPriceDifferenceUpdated(maxAllowedPriceDifference, _maxAllowedPriceDifference);\n maxAllowedPriceDifference = _maxAllowedPriceDifference;\n }\n\n /**\n * @notice Fetches the USD price of sfrxETH\n * @param asset Address of the sfrxETH token\n * @return price The price scaled by 1e18\n */\n function getPrice(address asset) external view returns (uint256) {\n if (asset != SFRXETH) revert InvalidTokenAddress();\n\n (bool isBadData, uint256 priceLow, uint256 priceHigh) = SFRXETH_FRAX_ORACLE.getPrices();\n\n if (isBadData) revert BadPriceData();\n\n // calculate price in USD\n uint256 priceHighInUSD = (EXP_SCALE ** 2) / priceLow;\n uint256 priceLowInUSD = (EXP_SCALE ** 2) / priceHigh;\n\n ensureNonzeroValue(priceHighInUSD);\n ensureNonzeroValue(priceLowInUSD);\n\n // validate price difference\n uint256 difference = (priceHighInUSD * EXP_SCALE) / priceLowInUSD;\n if (difference > maxAllowedPriceDifference) revert PriceDifferenceExceeded();\n\n // calculate and return average price\n return (priceHighInUSD + priceLowInUSD) / 2;\n }\n}\n" + }, + "contracts/oracles/SlisBNBOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { ISynclubStakeManager } from \"../interfaces/ISynclubStakeManager.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\n\n/**\n * @title SlisBNBOracle\n * @author Venus\n * @notice This oracle fetches the price of slisBNB asset\n */\ncontract SlisBNBOracle is CorrelatedTokenOracle {\n /// @notice This is used as token address of BNB on BSC\n address public constant NATIVE_TOKEN_ADDR = 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB;\n\n /// @notice Address of StakeManager\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n ISynclubStakeManager public immutable STAKE_MANAGER;\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address stakeManager,\n address slisBNB,\n address resilientOracle\n ) CorrelatedTokenOracle(slisBNB, NATIVE_TOKEN_ADDR, resilientOracle) {\n ensureNonzeroAddress(stakeManager);\n STAKE_MANAGER = ISynclubStakeManager(stakeManager);\n }\n\n /**\n * @notice Fetches the amount of BNB for 1 slisBNB\n * @return amount The amount of BNB for slisBNB\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n return STAKE_MANAGER.convertSnBnbToBnb(EXP_SCALE);\n }\n}\n" + }, + "contracts/oracles/StkBNBOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { IPStakePool } from \"../interfaces/IPStakePool.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\n\n/**\n * @title StkBNBOracle\n * @author Venus\n * @notice This oracle fetches the price of stkBNB asset\n */\ncontract StkBNBOracle is CorrelatedTokenOracle {\n /// @notice This is used as token address of BNB on BSC\n address public constant NATIVE_TOKEN_ADDR = 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB;\n\n /// @notice Address of StakePool\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IPStakePool public immutable STAKE_POOL;\n\n /// @notice Thrown if the pool token supply is zero\n error PoolTokenSupplyIsZero();\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address stakePool,\n address stkBNB,\n address resilientOracle\n ) CorrelatedTokenOracle(stkBNB, NATIVE_TOKEN_ADDR, resilientOracle) {\n ensureNonzeroAddress(stakePool);\n STAKE_POOL = IPStakePool(stakePool);\n }\n\n /**\n * @notice Fetches the amount of BNB for 1 stkBNB\n * @return price The amount of BNB for stkBNB\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n IPStakePool.Data memory exchangeRateData = STAKE_POOL.exchangeRate();\n\n if (exchangeRateData.poolTokenSupply == 0) {\n revert PoolTokenSupplyIsZero();\n }\n\n return (exchangeRateData.totalWei * EXP_SCALE) / exchangeRateData.poolTokenSupply;\n }\n}\n" + }, + "contracts/oracles/WBETHOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { IWBETH } from \"../interfaces/IWBETH.sol\";\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\n\n/**\n * @title WBETHOracle\n * @author Venus\n * @notice This oracle fetches the price of wBETH asset\n */\ncontract WBETHOracle is CorrelatedTokenOracle {\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address wbeth,\n address eth,\n address resilientOracle\n ) CorrelatedTokenOracle(wbeth, eth, resilientOracle) {}\n\n /**\n * @notice Fetches the amount of ETH for 1 wBETH\n * @return amount The amount of ETH for wBETH\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n return IWBETH(CORRELATED_TOKEN).exchangeRate();\n }\n}\n" + }, + "contracts/oracles/WeETHOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\nimport { IEtherFiLiquidityPool } from \"../interfaces/IEtherFiLiquidityPool.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\n\n/**\n * @title WeETHOracle\n * @author Venus\n * @notice This oracle fetches the price of weETH\n */\ncontract WeETHOracle is CorrelatedTokenOracle {\n /// @notice Address of Liqiudity pool\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IEtherFiLiquidityPool public immutable LIQUIDITY_POOL;\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address liquidityPool,\n address weETH,\n address eETH,\n address resilientOracle\n ) CorrelatedTokenOracle(weETH, eETH, resilientOracle) {\n ensureNonzeroAddress(liquidityPool);\n LIQUIDITY_POOL = IEtherFiLiquidityPool(liquidityPool);\n }\n\n /**\n * @notice Gets the eETH for 1 weETH\n * @return amount Amount of eETH\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n return LIQUIDITY_POOL.amountForShare(EXP_SCALE);\n }\n}\n" + }, + "contracts/oracles/WstETHOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { OracleInterface } from \"../interfaces/OracleInterface.sol\";\nimport { IStETH } from \"../interfaces/IStETH.sol\";\nimport { ensureNonzeroAddress } from \"@venusprotocol/solidity-utilities/contracts/validators.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\n\n/**\n * @title WstETHOracle\n * @author Venus\n * @notice Depending on the equivalence flag price is either based on assumption that 1 stETH = 1 ETH\n * or the price of stETH/USD (secondary market price) is obtained from the oracle.\n */\ncontract WstETHOracle is OracleInterface {\n /// @notice A flag assuming 1:1 price equivalence between stETH/ETH\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n bool public immutable ASSUME_STETH_ETH_EQUIVALENCE;\n\n /// @notice Address of stETH\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IStETH public immutable STETH;\n\n /// @notice Address of wstETH\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n address public immutable WSTETH_ADDRESS;\n\n /// @notice Address of WETH\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n address public immutable WETH_ADDRESS;\n\n /// @notice Address of Resilient Oracle\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n OracleInterface public immutable RESILIENT_ORACLE;\n\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address wstETHAddress,\n address wETHAddress,\n address stETHAddress,\n address resilientOracleAddress,\n bool assumeEquivalence\n ) {\n ensureNonzeroAddress(wstETHAddress);\n ensureNonzeroAddress(wETHAddress);\n ensureNonzeroAddress(stETHAddress);\n ensureNonzeroAddress(resilientOracleAddress);\n WSTETH_ADDRESS = wstETHAddress;\n WETH_ADDRESS = wETHAddress;\n STETH = IStETH(stETHAddress);\n RESILIENT_ORACLE = OracleInterface(resilientOracleAddress);\n ASSUME_STETH_ETH_EQUIVALENCE = assumeEquivalence;\n }\n\n /**\n * @notice Gets the USD price of wstETH asset\n * @dev Depending on the equivalence flag price is either based on assumption that 1 stETH = 1 ETH\n * or the price of stETH/USD (secondary market price) is obtained from the oracle\n * @param asset Address of wstETH\n * @return wstETH Price in USD scaled by 1e18\n */\n function getPrice(address asset) public view returns (uint256) {\n if (asset != WSTETH_ADDRESS) revert(\"wrong wstETH address\");\n\n // get stETH amount for 1 wstETH scaled by 1e18\n uint256 stETHAmount = STETH.getPooledEthByShares(1 ether);\n\n // price is scaled 1e18 (oracle returns 36 - asset decimal scale)\n uint256 stETHUSDPrice = RESILIENT_ORACLE.getPrice(ASSUME_STETH_ETH_EQUIVALENCE ? WETH_ADDRESS : address(STETH));\n\n // stETHAmount (for 1 wstETH) * stETHUSDPrice / 1e18\n return (stETHAmount * stETHUSDPrice) / EXP_SCALE;\n }\n}\n" + }, + "contracts/oracles/WstETHOracleV2.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport { IStETH } from \"../interfaces/IStETH.sol\";\nimport { CorrelatedTokenOracle } from \"./common/CorrelatedTokenOracle.sol\";\nimport { EXP_SCALE } from \"@venusprotocol/solidity-utilities/contracts/constants.sol\";\n\n/**\n * @title WstETHOracleV2\n * @author Venus\n * @notice This oracle fetches the price of wstETH\n */\ncontract WstETHOracleV2 is CorrelatedTokenOracle {\n /// @notice Constructor for the implementation contract.\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address wstETH,\n address stETH,\n address resilientOracle\n ) CorrelatedTokenOracle(wstETH, stETH, resilientOracle) {}\n\n /**\n * @notice Gets the stETH for 1 wstETH\n * @return amount Amount of stETH\n */\n function _getUnderlyingAmount() internal view override returns (uint256) {\n return IStETH(UNDERLYING_TOKEN).getPooledEthByShares(EXP_SCALE);\n }\n}\n" + }, + "contracts/ResilientOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\n// SPDX-FileCopyrightText: 2022 Venus\npragma solidity 0.8.25;\n\nimport \"@openzeppelin/contracts-upgradeable/security/PausableUpgradeable.sol\";\nimport \"./interfaces/VBep20Interface.sol\";\nimport \"./interfaces/OracleInterface.sol\";\nimport \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlledV8.sol\";\n\n/**\n * @title ResilientOracle\n * @author Venus\n * @notice The Resilient Oracle is the main contract that the protocol uses to fetch prices of assets.\n * \n * DeFi protocols are vulnerable to price oracle failures including oracle manipulation and incorrectly\n * reported prices. If only one oracle is used, this creates a single point of failure and opens a vector\n * for attacking the protocol.\n * \n * The Resilient Oracle uses multiple sources and fallback mechanisms to provide accurate prices and protect\n * the protocol from oracle attacks. Currently it includes integrations with Chainlink, Pyth, Binance Oracle\n * and TWAP (Time-Weighted Average Price) oracles. TWAP uses PancakeSwap as the on-chain price source.\n * \n * For every market (vToken) we configure the main, pivot and fallback oracles. The oracles are configured per \n * vToken's underlying asset address. The main oracle oracle is the most trustworthy price source, the pivot \n * oracle is used as a loose sanity checker and the fallback oracle is used as a backup price source. \n * \n * To validate prices returned from two oracles, we use an upper and lower bound ratio that is set for every\n * market. The upper bound ratio represents the deviation between reported price (the price that’s being\n * validated) and the anchor price (the price we are validating against) above which the reported price will\n * be invalidated. The lower bound ratio presents the deviation between reported price and anchor price below\n * which the reported price will be invalidated. So for oracle price to be considered valid the below statement\n * should be true:\n\n```\nanchorRatio = anchorPrice/reporterPrice\nisValid = anchorRatio <= upperBoundAnchorRatio && anchorRatio >= lowerBoundAnchorRatio\n```\n\n * In most cases, Chainlink is used as the main oracle, TWAP or Pyth oracles are used as the pivot oracle depending\n * on which supports the given market and Binance oracle is used as the fallback oracle. For some markets we may\n * use Pyth or TWAP as the main oracle if the token price is not supported by Chainlink or Binance oracles. \n * \n * For a fetched price to be valid it must be positive and not stagnant. If the price is invalid then we consider the\n * oracle to be stagnant and treat it like it's disabled.\n */\ncontract ResilientOracle is PausableUpgradeable, AccessControlledV8, ResilientOracleInterface {\n /**\n * @dev Oracle roles:\n * **main**: The most trustworthy price source\n * **pivot**: Price oracle used as a loose sanity checker\n * **fallback**: The backup source when main oracle price is invalidated\n */\n enum OracleRole {\n MAIN,\n PIVOT,\n FALLBACK\n }\n\n struct TokenConfig {\n /// @notice asset address\n address asset;\n /// @notice `oracles` stores the oracles based on their role in the following order:\n /// [main, pivot, fallback],\n /// It can be indexed with the corresponding enum OracleRole value\n address[3] oracles;\n /// @notice `enableFlagsForOracles` stores the enabled state\n /// for each oracle in the same order as `oracles`\n bool[3] enableFlagsForOracles;\n }\n\n uint256 public constant INVALID_PRICE = 0;\n\n /// @notice Native market address\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n address public immutable nativeMarket;\n\n /// @notice VAI address\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n address public immutable vai;\n\n /// @notice Set this as asset address for Native token on each chain.This is the underlying for vBNB (on bsc)\n /// and can serve as any underlying asset of a market that supports native tokens\n address public constant NATIVE_TOKEN_ADDR = 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB;\n\n /// @notice Bound validator contract address\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n BoundValidatorInterface public immutable boundValidator;\n\n mapping(address => TokenConfig) private tokenConfigs;\n\n event TokenConfigAdded(\n address indexed asset,\n address indexed mainOracle,\n address indexed pivotOracle,\n address fallbackOracle\n );\n\n /// Event emitted when an oracle is set\n event OracleSet(address indexed asset, address indexed oracle, uint256 indexed role);\n\n /// Event emitted when an oracle is enabled or disabled\n event OracleEnabled(address indexed asset, uint256 indexed role, bool indexed enable);\n\n /**\n * @notice Checks whether an address is null or not\n */\n modifier notNullAddress(address someone) {\n if (someone == address(0)) revert(\"can't be zero address\");\n _;\n }\n\n /**\n * @notice Checks whether token config exists by checking whether asset is null address\n * @dev address can't be null, so it's suitable to be used to check the validity of the config\n * @param asset asset address\n */\n modifier checkTokenConfigExistence(address asset) {\n if (tokenConfigs[asset].asset == address(0)) revert(\"token config must exist\");\n _;\n }\n\n /// @notice Constructor for the implementation contract. Sets immutable variables.\n /// @dev nativeMarketAddress can be address(0) if on the chain we do not support native market\n /// (e.g vETH on ethereum would not be supported, only vWETH)\n /// @param nativeMarketAddress The address of a native market (for bsc it would be vBNB address)\n /// @param vaiAddress The address of the VAI token (if there is VAI on the deployed chain).\n /// Set to address(0) of VAI is not existent.\n /// @param _boundValidator Address of the bound validator contract\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address nativeMarketAddress,\n address vaiAddress,\n BoundValidatorInterface _boundValidator\n ) notNullAddress(address(_boundValidator)) {\n nativeMarket = nativeMarketAddress;\n vai = vaiAddress;\n boundValidator = _boundValidator;\n\n _disableInitializers();\n }\n\n /**\n * @notice Initializes the contract admin and sets the BoundValidator contract address\n * @param accessControlManager_ Address of the access control manager contract\n */\n function initialize(address accessControlManager_) external initializer {\n __AccessControlled_init(accessControlManager_);\n __Pausable_init();\n }\n\n /**\n * @notice Pauses oracle\n * @custom:access Only Governance\n */\n function pause() external {\n _checkAccessAllowed(\"pause()\");\n _pause();\n }\n\n /**\n * @notice Unpauses oracle\n * @custom:access Only Governance\n */\n function unpause() external {\n _checkAccessAllowed(\"unpause()\");\n _unpause();\n }\n\n /**\n * @notice Batch sets token configs\n * @param tokenConfigs_ Token config array\n * @custom:access Only Governance\n * @custom:error Throws a length error if the length of the token configs array is 0\n */\n function setTokenConfigs(TokenConfig[] memory tokenConfigs_) external {\n if (tokenConfigs_.length == 0) revert(\"length can't be 0\");\n uint256 numTokenConfigs = tokenConfigs_.length;\n for (uint256 i; i < numTokenConfigs; ) {\n setTokenConfig(tokenConfigs_[i]);\n unchecked {\n ++i;\n }\n }\n }\n\n /**\n * @notice Sets oracle for a given asset and role.\n * @dev Supplied asset **must** exist and main oracle may not be null\n * @param asset Asset address\n * @param oracle Oracle address\n * @param role Oracle role\n * @custom:access Only Governance\n * @custom:error Null address error if main-role oracle address is null\n * @custom:error NotNullAddress error is thrown if asset address is null\n * @custom:error TokenConfigExistance error is thrown if token config is not set\n * @custom:event Emits OracleSet event with asset address, oracle address and role of the oracle for the asset\n */\n function setOracle(\n address asset,\n address oracle,\n OracleRole role\n ) external notNullAddress(asset) checkTokenConfigExistence(asset) {\n _checkAccessAllowed(\"setOracle(address,address,uint8)\");\n if (oracle == address(0) && role == OracleRole.MAIN) revert(\"can't set zero address to main oracle\");\n tokenConfigs[asset].oracles[uint256(role)] = oracle;\n emit OracleSet(asset, oracle, uint256(role));\n }\n\n /**\n * @notice Enables/ disables oracle for the input asset. Token config for the input asset **must** exist\n * @dev Configuration for the asset **must** already exist and the asset cannot be 0 address\n * @param asset Asset address\n * @param role Oracle role\n * @param enable Enabled boolean of the oracle\n * @custom:access Only Governance\n * @custom:error NotNullAddress error is thrown if asset address is null\n * @custom:error TokenConfigExistance error is thrown if token config is not set\n */\n function enableOracle(\n address asset,\n OracleRole role,\n bool enable\n ) external notNullAddress(asset) checkTokenConfigExistence(asset) {\n _checkAccessAllowed(\"enableOracle(address,uint8,bool)\");\n tokenConfigs[asset].enableFlagsForOracles[uint256(role)] = enable;\n emit OracleEnabled(asset, uint256(role), enable);\n }\n\n /**\n * @notice Updates the TWAP pivot oracle price.\n * @dev This function should always be called before calling getUnderlyingPrice\n * @param vToken vToken address\n */\n function updatePrice(address vToken) external override {\n address asset = _getUnderlyingAsset(vToken);\n (address pivotOracle, bool pivotOracleEnabled) = getOracle(asset, OracleRole.PIVOT);\n if (pivotOracle != address(0) && pivotOracleEnabled) {\n //if pivot oracle is not TwapOracle it will revert so we need to catch the revert\n try TwapInterface(pivotOracle).updateTwap(asset) {} catch {}\n }\n }\n\n /**\n * @notice Updates the pivot oracle price. Currently using TWAP\n * @dev This function should always be called before calling getPrice\n * @param asset asset address\n */\n function updateAssetPrice(address asset) external {\n (address pivotOracle, bool pivotOracleEnabled) = getOracle(asset, OracleRole.PIVOT);\n if (pivotOracle != address(0) && pivotOracleEnabled) {\n //if pivot oracle is not TwapOracle it will revert so we need to catch the revert\n try TwapInterface(pivotOracle).updateTwap(asset) {} catch {}\n }\n }\n\n /**\n * @dev Gets token config by asset address\n * @param asset asset address\n * @return tokenConfig Config for the asset\n */\n function getTokenConfig(address asset) external view returns (TokenConfig memory) {\n return tokenConfigs[asset];\n }\n\n /**\n * @notice Gets price of the underlying asset for a given vToken. Validation flow:\n * - Check if the oracle is paused globally\n * - Validate price from main oracle against pivot oracle\n * - Validate price from fallback oracle against pivot oracle if the first validation failed\n * - Validate price from main oracle against fallback oracle if the second validation failed\n * In the case that the pivot oracle is not available but main price is available and validation is successful,\n * main oracle price is returned.\n * @param vToken vToken address\n * @return price USD price in scaled decimal places.\n * @custom:error Paused error is thrown when resilent oracle is paused\n * @custom:error Invalid resilient oracle price error is thrown if fetched prices from oracle is invalid\n */\n function getUnderlyingPrice(address vToken) external view override returns (uint256) {\n if (paused()) revert(\"resilient oracle is paused\");\n\n address asset = _getUnderlyingAsset(vToken);\n return _getPrice(asset);\n }\n\n /**\n * @notice Gets price of the asset\n * @param asset asset address\n * @return price USD price in scaled decimal places.\n * @custom:error Paused error is thrown when resilent oracle is paused\n * @custom:error Invalid resilient oracle price error is thrown if fetched prices from oracle is invalid\n */\n function getPrice(address asset) external view override returns (uint256) {\n if (paused()) revert(\"resilient oracle is paused\");\n return _getPrice(asset);\n }\n\n /**\n * @notice Sets/resets single token configs.\n * @dev main oracle **must not** be a null address\n * @param tokenConfig Token config struct\n * @custom:access Only Governance\n * @custom:error NotNullAddress is thrown if asset address is null\n * @custom:error NotNullAddress is thrown if main-role oracle address for asset is null\n * @custom:event Emits TokenConfigAdded event when the asset config is set successfully by the authorized account\n */\n function setTokenConfig(\n TokenConfig memory tokenConfig\n ) public notNullAddress(tokenConfig.asset) notNullAddress(tokenConfig.oracles[uint256(OracleRole.MAIN)]) {\n _checkAccessAllowed(\"setTokenConfig(TokenConfig)\");\n\n tokenConfigs[tokenConfig.asset] = tokenConfig;\n emit TokenConfigAdded(\n tokenConfig.asset,\n tokenConfig.oracles[uint256(OracleRole.MAIN)],\n tokenConfig.oracles[uint256(OracleRole.PIVOT)],\n tokenConfig.oracles[uint256(OracleRole.FALLBACK)]\n );\n }\n\n /**\n * @notice Gets oracle and enabled status by asset address\n * @param asset asset address\n * @param role Oracle role\n * @return oracle Oracle address based on role\n * @return enabled Enabled flag of the oracle based on token config\n */\n function getOracle(address asset, OracleRole role) public view returns (address oracle, bool enabled) {\n oracle = tokenConfigs[asset].oracles[uint256(role)];\n enabled = tokenConfigs[asset].enableFlagsForOracles[uint256(role)];\n }\n\n function _getPrice(address asset) internal view returns (uint256) {\n uint256 pivotPrice = INVALID_PRICE;\n\n // Get pivot oracle price, Invalid price if not available or error\n (address pivotOracle, bool pivotOracleEnabled) = getOracle(asset, OracleRole.PIVOT);\n if (pivotOracleEnabled && pivotOracle != address(0)) {\n try OracleInterface(pivotOracle).getPrice(asset) returns (uint256 pricePivot) {\n pivotPrice = pricePivot;\n } catch {}\n }\n\n // Compare main price and pivot price, return main price and if validation was successful\n // note: In case pivot oracle is not available but main price is available and\n // validation is successful, the main oracle price is returned.\n (uint256 mainPrice, bool validatedPivotMain) = _getMainOraclePrice(\n asset,\n pivotPrice,\n pivotOracleEnabled && pivotOracle != address(0)\n );\n if (mainPrice != INVALID_PRICE && validatedPivotMain) return mainPrice;\n\n // Compare fallback and pivot if main oracle comparision fails with pivot\n // Return fallback price when fallback price is validated successfully with pivot oracle\n (uint256 fallbackPrice, bool validatedPivotFallback) = _getFallbackOraclePrice(asset, pivotPrice);\n if (fallbackPrice != INVALID_PRICE && validatedPivotFallback) return fallbackPrice;\n\n // Lastly compare main price and fallback price\n if (\n mainPrice != INVALID_PRICE &&\n fallbackPrice != INVALID_PRICE &&\n boundValidator.validatePriceWithAnchorPrice(asset, mainPrice, fallbackPrice)\n ) {\n return mainPrice;\n }\n\n revert(\"invalid resilient oracle price\");\n }\n\n /**\n * @notice Gets a price for the provided asset\n * @dev This function won't revert when price is 0, because the fallback oracle may still be\n * able to fetch a correct price\n * @param asset asset address\n * @param pivotPrice Pivot oracle price\n * @param pivotEnabled If pivot oracle is not empty and enabled\n * @return price USD price in scaled decimals\n * e.g. asset decimals is 8 then price is returned as 10**18 * 10**(18-8) = 10**28 decimals\n * @return pivotValidated Boolean representing if the validation of main oracle price\n * and pivot oracle price were successful\n * @custom:error Invalid price error is thrown if main oracle fails to fetch price of the asset\n * @custom:error Invalid price error is thrown if main oracle is not enabled or main oracle\n * address is null\n */\n function _getMainOraclePrice(\n address asset,\n uint256 pivotPrice,\n bool pivotEnabled\n ) internal view returns (uint256, bool) {\n (address mainOracle, bool mainOracleEnabled) = getOracle(asset, OracleRole.MAIN);\n if (mainOracleEnabled && mainOracle != address(0)) {\n try OracleInterface(mainOracle).getPrice(asset) returns (uint256 mainOraclePrice) {\n if (!pivotEnabled) {\n return (mainOraclePrice, true);\n }\n if (pivotPrice == INVALID_PRICE) {\n return (mainOraclePrice, false);\n }\n return (\n mainOraclePrice,\n boundValidator.validatePriceWithAnchorPrice(asset, mainOraclePrice, pivotPrice)\n );\n } catch {\n return (INVALID_PRICE, false);\n }\n }\n\n return (INVALID_PRICE, false);\n }\n\n /**\n * @dev This function won't revert when the price is 0 because getPrice checks if price is > 0\n * @param asset asset address\n * @return price USD price in 18 decimals\n * @return pivotValidated Boolean representing if the validation of fallback oracle price\n * and pivot oracle price were successfull\n * @custom:error Invalid price error is thrown if fallback oracle fails to fetch price of the asset\n * @custom:error Invalid price error is thrown if fallback oracle is not enabled or fallback oracle\n * address is null\n */\n function _getFallbackOraclePrice(address asset, uint256 pivotPrice) private view returns (uint256, bool) {\n (address fallbackOracle, bool fallbackEnabled) = getOracle(asset, OracleRole.FALLBACK);\n if (fallbackEnabled && fallbackOracle != address(0)) {\n try OracleInterface(fallbackOracle).getPrice(asset) returns (uint256 fallbackOraclePrice) {\n if (pivotPrice == INVALID_PRICE) {\n return (fallbackOraclePrice, false);\n }\n return (\n fallbackOraclePrice,\n boundValidator.validatePriceWithAnchorPrice(asset, fallbackOraclePrice, pivotPrice)\n );\n } catch {\n return (INVALID_PRICE, false);\n }\n }\n\n return (INVALID_PRICE, false);\n }\n\n /**\n * @dev This function returns the underlying asset of a vToken\n * @param vToken vToken address\n * @return asset underlying asset address\n */\n function _getUnderlyingAsset(address vToken) private view notNullAddress(vToken) returns (address asset) {\n if (vToken == nativeMarket) {\n asset = NATIVE_TOKEN_ADDR;\n } else if (vToken == vai) {\n asset = vai;\n } else {\n asset = VBep20Interface(vToken).underlying();\n }\n }\n}\n" + }, + "contracts/test/AccessControlManager.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\nimport \"@openzeppelin/contracts/access/AccessControl.sol\";\nimport \"@venusprotocol/governance-contracts/contracts/Governance/AccessControlManager.sol\";\n\ncontract AccessControlManagerScenario is AccessControlManager {}\n" + }, + "contracts/test/BEP20Harness.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\n\ncontract BEP20Harness is ERC20 {\n uint8 public decimalsInternal = 18;\n\n constructor(string memory name_, string memory symbol_, uint8 decimals_) ERC20(name_, symbol_) {\n decimalsInternal = decimals_;\n }\n\n function faucet(uint256 amount) external {\n _mint(msg.sender, amount);\n }\n\n function decimals() public view virtual override returns (uint8) {\n return decimalsInternal;\n }\n}\n" + }, + "contracts/test/MockAnkrBNB.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/ERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\nimport { IAnkrBNB } from \"../interfaces/IAnkrBNB.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\n\ncontract MockAnkrBNB is ERC20, Ownable, IAnkrBNB {\n uint8 private immutable _decimals;\n uint256 public exchangeRate;\n\n constructor(string memory name_, string memory symbol_, uint8 decimals_) ERC20(name_, symbol_) Ownable() {\n _decimals = decimals_;\n }\n\n function faucet(uint256 amount) external {\n _mint(msg.sender, amount);\n }\n\n function setSharesToBonds(uint256 rate) external onlyOwner {\n exchangeRate = rate;\n }\n\n function sharesToBonds(uint256 amount) external view override returns (uint256) {\n return (amount * exchangeRate) / (10 ** uint256(_decimals));\n }\n\n function decimals() public view virtual override(ERC20, IAnkrBNB) returns (uint8) {\n return _decimals;\n }\n}\n" + }, + "contracts/test/MockEtherFiLiquidityPool.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"../interfaces/IEtherFiLiquidityPool.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\n\ncontract MockEtherFiLiquidityPool is IEtherFiLiquidityPool, Ownable {\n /// @notice The amount of eETH per weETH scaled by 1e18\n uint256 public amountPerShare;\n\n constructor() Ownable() {}\n\n function setAmountPerShare(uint256 _amountPerShare) external onlyOwner {\n amountPerShare = _amountPerShare;\n }\n\n function amountForShare(uint256 _share) external view override returns (uint256) {\n return (_share * amountPerShare) / 1e18;\n }\n}\n" + }, + "contracts/test/MockPyth.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"../interfaces/PythInterface.sol\";\n\ncontract MockPyth is AbstractPyth {\n mapping(bytes32 => PythStructs.PriceFeed) priceFeeds;\n uint64 sequenceNumber;\n\n uint256 singleUpdateFeeInWei;\n uint256 validTimePeriod;\n\n constructor(uint256 _validTimePeriod, uint256 _singleUpdateFeeInWei) {\n singleUpdateFeeInWei = _singleUpdateFeeInWei;\n validTimePeriod = _validTimePeriod;\n }\n\n // simply update price feeds\n function updatePriceFeedsHarness(PythStructs.PriceFeed[] calldata feeds) external {\n require(feeds.length > 0, \"feeds length must > 0\");\n for (uint256 i = 0; i < feeds.length; ) {\n priceFeeds[feeds[i].id] = feeds[i];\n unchecked {\n ++i;\n }\n }\n }\n\n // Takes an array of encoded price feeds and stores them.\n // You can create this data either by calling createPriceFeedData or\n // by using web3.js or ethers abi utilities.\n function updatePriceFeeds(bytes[] calldata updateData) public payable override {\n uint256 requiredFee = getUpdateFee(updateData.length);\n require(msg.value >= requiredFee, \"Insufficient paid fee amount\");\n\n if (msg.value > requiredFee) {\n (bool success, ) = payable(msg.sender).call{ value: msg.value - requiredFee }(\"\");\n require(success, \"failed to transfer update fee\");\n }\n\n uint256 freshPrices = 0;\n\n // Chain ID is id of the source chain that the price update comes from. Since it is just a mock contract\n // We set it to 1.\n uint16 chainId = 1;\n\n for (uint256 i = 0; i < updateData.length; ) {\n PythStructs.PriceFeed memory priceFeed = abi.decode(updateData[i], (PythStructs.PriceFeed));\n\n bool fresh = false;\n uint256 lastPublishTime = priceFeeds[priceFeed.id].price.publishTime;\n\n if (lastPublishTime < priceFeed.price.publishTime) {\n // Price information is more recent than the existing price information.\n fresh = true;\n priceFeeds[priceFeed.id] = priceFeed;\n freshPrices += 1;\n }\n\n emit PriceFeedUpdate(\n priceFeed.id,\n fresh,\n chainId,\n sequenceNumber,\n priceFeed.price.publishTime,\n lastPublishTime,\n priceFeed.price.price,\n priceFeed.price.conf\n );\n\n unchecked {\n i++;\n }\n }\n\n // In the real contract, the input of this function contains multiple batches that each contain multiple prices.\n // This event is emitted when a batch is processed. In this mock contract we consider\n // there is only one batch of prices.\n // Each batch has (chainId, sequenceNumber) as it's unique identifier. Here chainId\n // is set to 1 and an increasing sequence number is used.\n emit BatchPriceFeedUpdate(chainId, sequenceNumber, updateData.length, freshPrices);\n sequenceNumber += 1;\n\n // There is only 1 batch of prices\n emit UpdatePriceFeeds(msg.sender, 1, requiredFee);\n }\n\n function queryPriceFeed(bytes32 id) public view override returns (PythStructs.PriceFeed memory priceFeed) {\n require(priceFeeds[id].id != 0, \"no price feed found for the given price id\");\n return priceFeeds[id];\n }\n\n function priceFeedExists(bytes32 id) public view override returns (bool) {\n return (priceFeeds[id].id != 0);\n }\n\n function getValidTimePeriod() public view override returns (uint256) {\n return validTimePeriod;\n }\n\n function getUpdateFee(uint256 updateDataSize) public view override returns (uint256 feeAmount) {\n return singleUpdateFeeInWei * updateDataSize;\n }\n\n function createPriceFeedUpdateData(\n bytes32 id,\n int64 price,\n uint64 conf,\n int32 expo,\n int64 emaPrice,\n uint64 emaConf,\n uint64 publishTime\n ) public pure returns (bytes memory priceFeedData) {\n PythStructs.PriceFeed memory priceFeed;\n\n priceFeed.id = id;\n\n priceFeed.price.price = price;\n priceFeed.price.conf = conf;\n priceFeed.price.expo = expo;\n priceFeed.price.publishTime = publishTime;\n\n priceFeed.emaPrice.price = emaPrice;\n priceFeed.emaPrice.conf = emaConf;\n priceFeed.emaPrice.expo = expo;\n priceFeed.emaPrice.publishTime = publishTime;\n\n priceFeedData = abi.encode(priceFeed);\n }\n}\n" + }, + "contracts/test/MockSFrax.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/ERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\nimport { ISFrax } from \"../interfaces/ISFrax.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\n\ncontract MockSFrax is ERC20, Ownable, ISFrax {\n uint8 private immutable _decimals;\n uint256 public exchangeRate;\n\n constructor(string memory name_, string memory symbol_, uint8 decimals_) ERC20(name_, symbol_) Ownable() {\n _decimals = decimals_;\n }\n\n function faucet(uint256 amount) external {\n _mint(msg.sender, amount);\n }\n\n function setRate(uint256 rate) external onlyOwner {\n exchangeRate = rate;\n }\n\n function convertToAssets(uint256 shares) external view override returns (uint256) {\n return (shares * exchangeRate) / (10 ** uint256(_decimals));\n }\n\n function decimals() public view virtual override(ERC20, ISFrax) returns (uint8) {\n return _decimals;\n }\n}\n" + }, + "contracts/test/MockSimpleOracle.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"../interfaces/OracleInterface.sol\";\n\ncontract MockSimpleOracle is OracleInterface {\n mapping(address => uint256) public prices;\n\n constructor() {\n //\n }\n\n function getUnderlyingPrice(address vToken) external view returns (uint256) {\n return prices[vToken];\n }\n\n function getPrice(address asset) external view returns (uint256) {\n return prices[asset];\n }\n\n function setPrice(address vToken, uint256 price) public {\n prices[vToken] = price;\n }\n}\n\ncontract MockBoundValidator is BoundValidatorInterface {\n mapping(address => bool) public validateResults;\n bool public twapUpdated;\n\n constructor() {\n //\n }\n\n function validatePriceWithAnchorPrice(\n address vToken,\n uint256 reporterPrice,\n uint256 anchorPrice\n ) external view returns (bool) {\n return validateResults[vToken];\n }\n\n function validateAssetPriceWithAnchorPrice(\n address asset,\n uint256 reporterPrice,\n uint256 anchorPrice\n ) external view returns (bool) {\n return validateResults[asset];\n }\n\n function setValidateResult(address token, bool pass) public {\n validateResults[token] = pass;\n }\n}\n" + }, + "contracts/test/MockV3Aggregator.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"@chainlink/contracts/src/v0.8/interfaces/AggregatorV2V3Interface.sol\";\n\n/**\n * @title MockV3Aggregator\n * @notice Based on the FluxAggregator contract\n * @notice Use this contract when you need to test\n * other contract's ability to read data from an\n * aggregator contract, but how the aggregator got\n * its answer is unimportant\n */\ncontract MockV3Aggregator is AggregatorV2V3Interface {\n uint256 public constant version = 0;\n\n uint8 public decimals;\n int256 public latestAnswer;\n uint256 public latestTimestamp;\n uint256 public latestRound;\n\n mapping(uint256 => int256) public getAnswer;\n mapping(uint256 => uint256) public getTimestamp;\n mapping(uint256 => uint256) private getStartedAt;\n\n constructor(uint8 _decimals, int256 _initialAnswer) {\n decimals = _decimals;\n updateAnswer(_initialAnswer);\n }\n\n function getRoundData(\n uint80 _roundId\n )\n external\n view\n returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)\n {\n return (_roundId, getAnswer[_roundId], getStartedAt[_roundId], getTimestamp[_roundId], _roundId);\n }\n\n function latestRoundData()\n external\n view\n returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)\n {\n return (\n uint80(latestRound),\n getAnswer[latestRound],\n getStartedAt[latestRound],\n getTimestamp[latestRound],\n uint80(latestRound)\n );\n }\n\n function description() external pure returns (string memory) {\n return \"v0.6/tests/MockV3Aggregator.sol\";\n }\n\n function updateAnswer(int256 _answer) public {\n latestAnswer = _answer;\n latestTimestamp = block.timestamp;\n latestRound++;\n getAnswer[latestRound] = _answer;\n getTimestamp[latestRound] = block.timestamp;\n getStartedAt[latestRound] = block.timestamp;\n }\n\n function updateRoundData(uint80 _roundId, int256 _answer, uint256 _timestamp, uint256 _startedAt) public {\n latestRound = _roundId;\n latestAnswer = _answer;\n latestTimestamp = _timestamp;\n getAnswer[latestRound] = _answer;\n getTimestamp[latestRound] = _timestamp;\n getStartedAt[latestRound] = _startedAt;\n }\n}\n" + }, + "contracts/test/MockWBETH.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/ERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\nimport { IWBETH } from \"../interfaces/IWBETH.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\n\ncontract MockWBETH is ERC20, Ownable, IWBETH {\n uint8 private immutable _decimals;\n uint256 public override exchangeRate;\n\n constructor(string memory name_, string memory symbol_, uint8 decimals_) ERC20(name_, symbol_) Ownable() {\n _decimals = decimals_;\n }\n\n function faucet(uint256 amount) external {\n _mint(msg.sender, amount);\n }\n\n function setExchangeRate(uint256 rate) external onlyOwner {\n exchangeRate = rate;\n }\n\n function decimals() public view virtual override(ERC20, IWBETH) returns (uint8) {\n return _decimals;\n }\n}\n" + }, + "contracts/test/PancakePairHarness.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\n// a library for performing various math operations\n\nlibrary Math {\n function min(uint256 x, uint256 y) internal pure returns (uint256 z) {\n z = x < y ? x : y;\n }\n\n // babylonian method (https://en.wikipedia.org/wiki/Methods_of_computing_square_roots#Babylonian_method)\n function sqrt(uint256 y) internal pure returns (uint256 z) {\n if (y > 3) {\n z = y;\n uint256 x = y / 2 + 1;\n while (x < z) {\n z = x;\n x = (y / x + x) / 2;\n }\n } else if (y != 0) {\n z = 1;\n }\n }\n}\n\n// range: [0, 2**112 - 1]\n// resolution: 1 / 2**112\n\nlibrary UQ112x112 {\n //solhint-disable-next-line state-visibility\n uint224 constant Q112 = 2 ** 112;\n\n // encode a uint112 as a UQ112x112\n function encode(uint112 y) internal pure returns (uint224 z) {\n z = uint224(y) * Q112; // never overflows\n }\n\n // divide a UQ112x112 by a uint112, returning a UQ112x112\n function uqdiv(uint224 x, uint112 y) internal pure returns (uint224 z) {\n z = x / uint224(y);\n }\n}\n\ncontract PancakePairHarness {\n using UQ112x112 for uint224;\n\n address public token0;\n address public token1;\n\n uint112 private reserve0; // uses single storage slot, accessible via getReserves\n uint112 private reserve1; // uses single storage slot, accessible via getReserves\n uint32 private blockTimestampLast; // uses single storage slot, accessible via getReserves\n\n uint256 public price0CumulativeLast;\n uint256 public price1CumulativeLast;\n uint256 public kLast; // reserve0 * reserve1, as of immediately after the most recent liquidity event\n\n // called once by the factory at time of deployment\n function initialize(address _token0, address _token1) external {\n token0 = _token0;\n token1 = _token1;\n }\n\n // update reserves and, on the first call per block, price accumulators\n function update(uint256 balance0, uint256 balance1, uint112 _reserve0, uint112 _reserve1) external {\n require(balance0 <= type(uint112).max && balance1 <= type(uint112).max, \"PancakeV2: OVERFLOW\");\n uint32 blockTimestamp = uint32(block.timestamp % 2 ** 32);\n unchecked {\n uint32 timeElapsed = blockTimestamp - blockTimestampLast; // overflow is desired\n if (timeElapsed > 0 && _reserve0 != 0 && _reserve1 != 0) {\n // * never overflows, and + overflow is desired\n price0CumulativeLast += uint256(UQ112x112.encode(_reserve1).uqdiv(_reserve0)) * timeElapsed;\n price1CumulativeLast += uint256(UQ112x112.encode(_reserve0).uqdiv(_reserve1)) * timeElapsed;\n }\n }\n reserve0 = uint112(balance0);\n reserve1 = uint112(balance1);\n blockTimestampLast = blockTimestamp;\n }\n\n function currentBlockTimestamp() external view returns (uint32) {\n return uint32(block.timestamp % 2 ** 32);\n }\n\n function getReserves() public view returns (uint112 _reserve0, uint112 _reserve1, uint32 _blockTimestampLast) {\n _reserve0 = reserve0;\n _reserve1 = reserve1;\n _blockTimestampLast = blockTimestampLast;\n }\n}\n" + }, + "contracts/test/VBEP20Harness.sol": { + "content": "// SPDX-License-Identifier: BSD-3-Clause\npragma solidity 0.8.25;\n\nimport \"./BEP20Harness.sol\";\n\ncontract VBEP20Harness is BEP20Harness {\n /**\n * @notice Underlying asset for this VToken\n */\n address public underlying;\n\n constructor(\n string memory name_,\n string memory symbol_,\n uint8 decimals,\n address underlying_\n ) BEP20Harness(name_, symbol_, decimals) {\n underlying = underlying_;\n }\n}\n" + } + }, + "settings": { + "optimizer": { + "enabled": true, + "runs": 200, + "details": { + "yul": true + } + }, + "evmVersion": "paris", + "outputSelection": { + "*": { + "*": [ + "storageLayout", + "abi", + "evm.bytecode", + "evm.deployedBytecode", + "evm.methodIdentifiers", + "metadata", + "devdoc", + "userdoc", + "evm.gasEstimates" + ], + "": ["ast"] + } + }, + "metadata": { + "useLiteralContent": true + } + } +} diff --git a/helpers/deploymentConfig.ts b/helpers/deploymentConfig.ts index ee646099..c89ce2de 100644 --- a/helpers/deploymentConfig.ts +++ b/helpers/deploymentConfig.ts @@ -109,6 +109,7 @@ export const ADDRESSES: PreconfiguredAddresses = { WETH: "0x7b79995e5f793A07Bc00c21412e50Ecae098E7f9", PTweETH_26DEC2024: "0x56107201d3e4b7Db92dEa0Edb9e0454346AEb8B5", FRAX: "0x10630d59848547c9F59538E2d8963D63B912C075", + sfrxETH: "0x14AECeEc177085fd09EA07348B4E1F7Fcc030fA1", }, ethereum: { vBNBAddress: ethers.constants.AddressZero, From 41bac602d0b57b3c325c762e391b8132b57d5891 Mon Sep 17 00:00:00 2001 From: narayanprusty Date: Mon, 10 Jun 2024 07:01:43 +0000 Subject: [PATCH 20/26] feat: updating deployment files --- deployments/ethereum.json | 899 +++++++++++++++++++++++ deployments/ethereum_addresses.json | 3 + deployments/sepolia.json | 1046 +++++++++++++++++++++++++++ deployments/sepolia_addresses.json | 4 + 4 files changed, 1952 insertions(+) diff --git a/deployments/ethereum.json b/deployments/ethereum.json index 45dde988..d505e3a2 100644 --- a/deployments/ethereum.json +++ b/deployments/ethereum.json @@ -5742,6 +5742,905 @@ } ] }, + "SFrxETHOracle": { + "address": "0x987010fD82FDCe099174aC605B88E1cc35019ef4", + "abi": [ + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "previousAdmin", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "AdminChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "beacon", + "type": "address" + } + ], + "name": "BeaconUpgraded", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "implementation", + "type": "address" + } + ], + "name": "Upgraded", + "type": "event" + }, + { + "stateMutability": "payable", + "type": "fallback" + }, + { + "inputs": [], + "name": "admin", + "outputs": [ + { + "internalType": "address", + "name": "admin_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "implementation", + "outputs": [ + { + "internalType": "address", + "name": "implementation_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + } + ], + "name": "upgradeTo", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + }, + { + "internalType": "bytes", + "name": "data", + "type": "bytes" + } + ], + "name": "upgradeToAndCall", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "stateMutability": "payable", + "type": "receive" + }, + { + "inputs": [], + "name": "BadPriceData", + "type": "error" + }, + { + "inputs": [], + "name": "InvalidTokenAddress", + "type": "error" + }, + { + "inputs": [], + "name": "PriceDifferenceExceeded", + "type": "error" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "sender", + "type": "address" + }, + { + "internalType": "address", + "name": "calledContract", + "type": "address" + }, + { + "internalType": "string", + "name": "methodSignature", + "type": "string" + } + ], + "name": "Unauthorized", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroAddressNotAllowed", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroValueNotAllowed", + "type": "error" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint8", + "name": "version", + "type": "uint8" + } + ], + "name": "Initialized", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint256", + "name": "oldMaxAllowedPriceDifference", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newMaxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "MaxAllowedPriceDifferenceUpdated", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "oldAccessControlManager", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAccessControlManager", + "type": "address" + } + ], + "name": "NewAccessControlManager", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferStarted", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "inputs": [], + "name": "SFRXETH", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "SFRXETH_FRAX_ORACLE", + "outputs": [ + { + "internalType": "contract ISfrxEthFraxOracle", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "acceptOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "accessControlManager", + "outputs": [ + { + "internalType": "contract IAccessControlManagerV8", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "asset", + "type": "address" + } + ], + "name": "getPrice", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_accessControlManager", + "type": "address" + }, + { + "internalType": "uint256", + "name": "_maxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "initialize", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "maxAllowedPriceDifference", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "pendingOwner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "name": "setAccessControlManager", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint256", + "name": "_maxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "setMaxAllowedPriceDifference", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_logic", + "type": "address" + }, + { + "internalType": "address", + "name": "admin_", + "type": "address" + }, + { + "internalType": "bytes", + "name": "_data", + "type": "bytes" + } + ], + "stateMutability": "payable", + "type": "constructor" + } + ] + }, + "SFrxETHOracle_Implementation": { + "address": "0x3a6f2c02ec48dbEE4Ca406d701DCA2CC9d919EaD", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "_sfrxEthFraxOracle", + "type": "address" + }, + { + "internalType": "address", + "name": "_sfrxETH", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "constructor" + }, + { + "inputs": [], + "name": "BadPriceData", + "type": "error" + }, + { + "inputs": [], + "name": "InvalidTokenAddress", + "type": "error" + }, + { + "inputs": [], + "name": "PriceDifferenceExceeded", + "type": "error" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "sender", + "type": "address" + }, + { + "internalType": "address", + "name": "calledContract", + "type": "address" + }, + { + "internalType": "string", + "name": "methodSignature", + "type": "string" + } + ], + "name": "Unauthorized", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroAddressNotAllowed", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroValueNotAllowed", + "type": "error" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint8", + "name": "version", + "type": "uint8" + } + ], + "name": "Initialized", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint256", + "name": "oldMaxAllowedPriceDifference", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newMaxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "MaxAllowedPriceDifferenceUpdated", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "oldAccessControlManager", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAccessControlManager", + "type": "address" + } + ], + "name": "NewAccessControlManager", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferStarted", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "inputs": [], + "name": "SFRXETH", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "SFRXETH_FRAX_ORACLE", + "outputs": [ + { + "internalType": "contract ISfrxEthFraxOracle", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "acceptOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "accessControlManager", + "outputs": [ + { + "internalType": "contract IAccessControlManagerV8", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "asset", + "type": "address" + } + ], + "name": "getPrice", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_accessControlManager", + "type": "address" + }, + { + "internalType": "uint256", + "name": "_maxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "initialize", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "maxAllowedPriceDifference", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "pendingOwner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "name": "setAccessControlManager", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint256", + "name": "_maxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "setMaxAllowedPriceDifference", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + } + ] + }, + "SFrxETHOracle_Proxy": { + "address": "0x987010fD82FDCe099174aC605B88E1cc35019ef4", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "_logic", + "type": "address" + }, + { + "internalType": "address", + "name": "admin_", + "type": "address" + }, + { + "internalType": "bytes", + "name": "_data", + "type": "bytes" + } + ], + "stateMutability": "payable", + "type": "constructor" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "previousAdmin", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "AdminChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "beacon", + "type": "address" + } + ], + "name": "BeaconUpgraded", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "implementation", + "type": "address" + } + ], + "name": "Upgraded", + "type": "event" + }, + { + "stateMutability": "payable", + "type": "fallback" + }, + { + "inputs": [], + "name": "admin", + "outputs": [ + { + "internalType": "address", + "name": "admin_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "implementation", + "outputs": [ + { + "internalType": "address", + "name": "implementation_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + } + ], + "name": "upgradeTo", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + }, + { + "internalType": "bytes", + "name": "data", + "type": "bytes" + } + ], + "name": "upgradeToAndCall", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "stateMutability": "payable", + "type": "receive" + } + ] + }, "WeETHOracle_Equivalence": { "address": "0xEa687c54321Db5b20CA544f38f08E429a4bfCBc8", "abi": [ diff --git a/deployments/ethereum_addresses.json b/deployments/ethereum_addresses.json index 4d2e5486..7ac6e5c1 100644 --- a/deployments/ethereum_addresses.json +++ b/deployments/ethereum_addresses.json @@ -21,6 +21,9 @@ "SFraxOracle": "0x27F811933cA276387554eAffD9860e513bA95AC3", "SFraxOracle_Implementation": "0xeA98e3a8c3744B93e21c75aa4b2355f35c9617a7", "SFraxOracle_Proxy": "0x27F811933cA276387554eAffD9860e513bA95AC3", + "SFrxETHOracle": "0x987010fD82FDCe099174aC605B88E1cc35019ef4", + "SFrxETHOracle_Implementation": "0x3a6f2c02ec48dbEE4Ca406d701DCA2CC9d919EaD", + "SFrxETHOracle_Proxy": "0x987010fD82FDCe099174aC605B88E1cc35019ef4", "WeETHOracle_Equivalence": "0xEa687c54321Db5b20CA544f38f08E429a4bfCBc8", "WeETHOracle_Equivalence_Implementation": "0x3694ad1233FC1f7f71D3aD0b1dad128D8d1333AA", "WeETHOracle_Equivalence_Proxy": "0xEa687c54321Db5b20CA544f38f08E429a4bfCBc8", diff --git a/deployments/sepolia.json b/deployments/sepolia.json index 99688d3b..6ab37f4d 100644 --- a/deployments/sepolia.json +++ b/deployments/sepolia.json @@ -2845,6 +2845,153 @@ } ] }, + "MockSfrxEthFraxOracle": { + "address": "0x96f7FD1d922Bb6769773BeC88BE6aA615DE77ad1", + "abi": [ + { + "inputs": [], + "stateMutability": "nonpayable", + "type": "constructor" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "inputs": [], + "name": "getPrices", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + }, + { + "internalType": "uint256", + "name": "", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "isBadData", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "priceHigh", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "priceLow", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "bool", + "name": "_isBadData", + "type": "bool" + }, + { + "internalType": "uint256", + "name": "_priceLow", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "_priceHigh", + "type": "uint256" + } + ], + "name": "setPrices", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + } + ] + }, "PendleOracle-PT-weETH-26DEC2024": { "address": "0xAF83f9C9d849B6FF3A33da059Bf14A0E85493eb4", "abi": [ @@ -6422,6 +6569,905 @@ } ] }, + "SFrxETHOracle": { + "address": "0x6E202555f0CA6558118C67150e16fbf89080eB3b", + "abi": [ + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "previousAdmin", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "AdminChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "beacon", + "type": "address" + } + ], + "name": "BeaconUpgraded", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "implementation", + "type": "address" + } + ], + "name": "Upgraded", + "type": "event" + }, + { + "stateMutability": "payable", + "type": "fallback" + }, + { + "inputs": [], + "name": "admin", + "outputs": [ + { + "internalType": "address", + "name": "admin_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "implementation", + "outputs": [ + { + "internalType": "address", + "name": "implementation_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + } + ], + "name": "upgradeTo", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + }, + { + "internalType": "bytes", + "name": "data", + "type": "bytes" + } + ], + "name": "upgradeToAndCall", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "stateMutability": "payable", + "type": "receive" + }, + { + "inputs": [], + "name": "BadPriceData", + "type": "error" + }, + { + "inputs": [], + "name": "InvalidTokenAddress", + "type": "error" + }, + { + "inputs": [], + "name": "PriceDifferenceExceeded", + "type": "error" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "sender", + "type": "address" + }, + { + "internalType": "address", + "name": "calledContract", + "type": "address" + }, + { + "internalType": "string", + "name": "methodSignature", + "type": "string" + } + ], + "name": "Unauthorized", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroAddressNotAllowed", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroValueNotAllowed", + "type": "error" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint8", + "name": "version", + "type": "uint8" + } + ], + "name": "Initialized", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint256", + "name": "oldMaxAllowedPriceDifference", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newMaxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "MaxAllowedPriceDifferenceUpdated", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "oldAccessControlManager", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAccessControlManager", + "type": "address" + } + ], + "name": "NewAccessControlManager", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferStarted", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "inputs": [], + "name": "SFRXETH", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "SFRXETH_FRAX_ORACLE", + "outputs": [ + { + "internalType": "contract ISfrxEthFraxOracle", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "acceptOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "accessControlManager", + "outputs": [ + { + "internalType": "contract IAccessControlManagerV8", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "asset", + "type": "address" + } + ], + "name": "getPrice", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_accessControlManager", + "type": "address" + }, + { + "internalType": "uint256", + "name": "_maxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "initialize", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "maxAllowedPriceDifference", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "pendingOwner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "name": "setAccessControlManager", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint256", + "name": "_maxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "setMaxAllowedPriceDifference", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_logic", + "type": "address" + }, + { + "internalType": "address", + "name": "admin_", + "type": "address" + }, + { + "internalType": "bytes", + "name": "_data", + "type": "bytes" + } + ], + "stateMutability": "payable", + "type": "constructor" + } + ] + }, + "SFrxETHOracle_Implementation": { + "address": "0x22F55239FE27cE429be407A1a9dD90365188B647", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "_sfrxEthFraxOracle", + "type": "address" + }, + { + "internalType": "address", + "name": "_sfrxETH", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "constructor" + }, + { + "inputs": [], + "name": "BadPriceData", + "type": "error" + }, + { + "inputs": [], + "name": "InvalidTokenAddress", + "type": "error" + }, + { + "inputs": [], + "name": "PriceDifferenceExceeded", + "type": "error" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "sender", + "type": "address" + }, + { + "internalType": "address", + "name": "calledContract", + "type": "address" + }, + { + "internalType": "string", + "name": "methodSignature", + "type": "string" + } + ], + "name": "Unauthorized", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroAddressNotAllowed", + "type": "error" + }, + { + "inputs": [], + "name": "ZeroValueNotAllowed", + "type": "error" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint8", + "name": "version", + "type": "uint8" + } + ], + "name": "Initialized", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "uint256", + "name": "oldMaxAllowedPriceDifference", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "newMaxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "MaxAllowedPriceDifferenceUpdated", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "oldAccessControlManager", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAccessControlManager", + "type": "address" + } + ], + "name": "NewAccessControlManager", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferStarted", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "previousOwner", + "type": "address" + }, + { + "indexed": true, + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "OwnershipTransferred", + "type": "event" + }, + { + "inputs": [], + "name": "SFRXETH", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "SFRXETH_FRAX_ORACLE", + "outputs": [ + { + "internalType": "contract ISfrxEthFraxOracle", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "acceptOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "accessControlManager", + "outputs": [ + { + "internalType": "contract IAccessControlManagerV8", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "asset", + "type": "address" + } + ], + "name": "getPrice", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "_accessControlManager", + "type": "address" + }, + { + "internalType": "uint256", + "name": "_maxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "initialize", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "maxAllowedPriceDifference", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "owner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "pendingOwner", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "renounceOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "accessControlManager_", + "type": "address" + } + ], + "name": "setAccessControlManager", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "uint256", + "name": "_maxAllowedPriceDifference", + "type": "uint256" + } + ], + "name": "setMaxAllowedPriceDifference", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newOwner", + "type": "address" + } + ], + "name": "transferOwnership", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + } + ] + }, + "SFrxETHOracle_Proxy": { + "address": "0x6E202555f0CA6558118C67150e16fbf89080eB3b", + "abi": [ + { + "inputs": [ + { + "internalType": "address", + "name": "_logic", + "type": "address" + }, + { + "internalType": "address", + "name": "admin_", + "type": "address" + }, + { + "internalType": "bytes", + "name": "_data", + "type": "bytes" + } + ], + "stateMutability": "payable", + "type": "constructor" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": false, + "internalType": "address", + "name": "previousAdmin", + "type": "address" + }, + { + "indexed": false, + "internalType": "address", + "name": "newAdmin", + "type": "address" + } + ], + "name": "AdminChanged", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "beacon", + "type": "address" + } + ], + "name": "BeaconUpgraded", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ + { + "indexed": true, + "internalType": "address", + "name": "implementation", + "type": "address" + } + ], + "name": "Upgraded", + "type": "event" + }, + { + "stateMutability": "payable", + "type": "fallback" + }, + { + "inputs": [], + "name": "admin", + "outputs": [ + { + "internalType": "address", + "name": "admin_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [], + "name": "implementation", + "outputs": [ + { + "internalType": "address", + "name": "implementation_", + "type": "address" + } + ], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + } + ], + "name": "upgradeTo", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "newImplementation", + "type": "address" + }, + { + "internalType": "bytes", + "name": "data", + "type": "bytes" + } + ], + "name": "upgradeToAndCall", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "stateMutability": "payable", + "type": "receive" + } + ] + }, "WeETHOracle": { "address": "0xc7b78b5c1433C81c455CD1e9A68FF18764acbCe1", "abi": [ diff --git a/deployments/sepolia_addresses.json b/deployments/sepolia_addresses.json index 3fab05cb..c9833637 100644 --- a/deployments/sepolia_addresses.json +++ b/deployments/sepolia_addresses.json @@ -12,6 +12,7 @@ "MockEtherFiLiquidityPool": "0x4634Cc129ec46DbBab6a7E2b5c73c1b991be6cfC", "MockPendlePtOracle": "0xF5B307640435D38A5A8eE8b6665d24Bb098F11db", "MockSFrax": "0xd85FfECdB4287587BC53c1934D548bF7480F11C4", + "MockSfrxEthFraxOracle": "0x96f7FD1d922Bb6769773BeC88BE6aA615DE77ad1", "PendleOracle-PT-weETH-26DEC2024": "0xAF83f9C9d849B6FF3A33da059Bf14A0E85493eb4", "PendleOracle-PT-weETH-26DEC2024_Implementation": "0x73b615e88fDAe39fb8ED12d0dFeFBCDF5BA0E312", "PendleOracle-PT-weETH-26DEC2024_Proxy": "0xAF83f9C9d849B6FF3A33da059Bf14A0E85493eb4", @@ -24,6 +25,9 @@ "SFraxOracle": "0x163cA9Eb6340643154F8691C5DAd3aC844266717", "SFraxOracle_Implementation": "0x2fD256De0E5e783A51d3a661bCD5D04f1aF6E243", "SFraxOracle_Proxy": "0x163cA9Eb6340643154F8691C5DAd3aC844266717", + "SFrxETHOracle": "0x6E202555f0CA6558118C67150e16fbf89080eB3b", + "SFrxETHOracle_Implementation": "0x22F55239FE27cE429be407A1a9dD90365188B647", + "SFrxETHOracle_Proxy": "0x6E202555f0CA6558118C67150e16fbf89080eB3b", "WeETHOracle": "0xc7b78b5c1433C81c455CD1e9A68FF18764acbCe1", "WeETHOracle_Implementation": "0xE4De7A85e2BF39B6f6C1BA235aB33d3Fe2841195", "WeETHOracle_Proxy": "0xc7b78b5c1433C81c455CD1e9A68FF18764acbCe1", From 0b221a7bb7d8e04fd8b013806facb93bcb4038b9 Mon Sep 17 00:00:00 2001 From: Jesus Lanchas Date: Tue, 18 Jun 2024 13:20:20 +0200 Subject: [PATCH 21/26] docs: add audit reports for the sfrxETH oracle --- audits/110_sfrxETHOracle_certik_20240517.pdf | Bin 0 -> 1346303 bytes .../111_sfrxETHOracle_quantstamp_20240530.pdf | Bin 0 -> 460666 bytes 2 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 audits/110_sfrxETHOracle_certik_20240517.pdf create mode 100644 audits/111_sfrxETHOracle_quantstamp_20240530.pdf diff --git a/audits/110_sfrxETHOracle_certik_20240517.pdf b/audits/110_sfrxETHOracle_certik_20240517.pdf new file mode 100644 index 0000000000000000000000000000000000000000..1c09b3b54019a20fe811f8e8e51c16cf36001ad2 GIT binary patch literal 1346303 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�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

ep5B~G| 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�(~N-;4(mYWY)}cU<6a>7a2xv=uZu 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⁢B1lU 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