feat/SolaceNative (WIP)

.solhint.json

@@ -5,6 +5,7 @@
       "avoid-suicide": "error",
       "avoid-sha3": "warn",
       "compiler-version": ["error", "0.8.6"],
-      "func-visibility": ["warn", { "ignoreConstructors": true } ]
+      "func-visibility": ["warn", { "ignoreConstructors": true } ],
+      "not-rely-on-time": "off"
     }
 }

contracts/interfaces/native/GaugeStructs.sol

@@ -0,0 +1,25 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+pragma solidity 0.8.6;
+
+library GaugeStructs {
+    struct Vote {
+        uint256 gaugeID;
+        uint256 votePowerBPS;
+    }
+
+    /// @dev Struct pack into single 32-byte word
+    /// @param _votingContractsIndex Index for _votingContracts for last incomplete updateGaugeWeights() call.
+    /// @param _votersIndex Index for _voters[savedIndex_votingContracts] for last incomplete updateGaugeWeights() call.
+    /// @param _votesIndex Index for _votes[savedIndex_votingContracts][savedIndex_voters] for last incomplete updateGaugeWeights() call.
+    struct UpdateInfo {
+        uint80 _votingContractsIndex; // [0:80]
+        uint88 _votersIndex; // [80:168]
+        uint88 _votesIndex; // [168:256]
+    }
+
+    struct Gauge { 
+        bool active; // [0:8]
+        uint248 rateOnLine; // [8:256] Max value we reasonably expect is ~20% or 2e17. We only need log 2 2e17 = ~58 bits for this.
+        string name;
+    }
+}

contracts/interfaces/native/IDepositHelper.sol

@@ -0,0 +1,78 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+pragma solidity 0.8.6;
+
+
+/**
+ * @title IDepositHelper
+ * @author solace.fi
+ * @notice The process of depositing into Solace Native requires multiple steps across multiple contracts. This helper contract allows users to deposit with a single transaction.
+ *
+ * These steps are
+ * 1. Deposit governance token into [`UWP`](./../../native/UnderwritingPool).
+ * 2. Deposit [`UWP`](./../../native/UnderwritingPool) into [`UWE`](./../../native/UnderwritingEquity).
+ * 3. Deposit [`UWE`](./../../native/UnderwritingEquity) into an [`Underwriting Lock`](./../../native/UnderwritingLocker).
+ *
+ * These steps can be replaced with [`depositAndLock()`](#depositandlock) or [`depositIntoLock()`](#depositintolock).
+ */
+interface IDepositHelper {
+
+    /***************************************
+    VIEW FUNCTIONS
+    ***************************************/
+
+    /**
+     * @notice Address of the [underwriting pool](./../../native/UnderwritingPool).
+     * @return uwp The underwriting pool.
+     */
+    function underwritingPool() external view returns (address uwp);
+
+    /**
+     * @notice Address of [underwriting equity](./../../native/UnderwritingEquity).
+     * @return uwe The underwriting equity.
+     */
+    function underwritingEquity() external view returns (address uwe);
+
+    /**
+     * @notice Address of [underwriting locker](./../../native/UnderwritingLocker).
+     * @return locker The underwriting locker.
+     */
+    function underwritingLocker() external view returns (address locker);
+
+    /**
+     * @notice Calculates the amount of [`UWE`](./../../native/UnderwritingEquity) minted for an amount of a token deposited.
+     * The deposit token may be one of the tokens in [`UWP`](./../../native/UnderwritingPool), the [`UWP`](./../../native/UnderwritingPool) token, or the [`UWE`](./../../native/UnderwritingEquity) token.
+     * @param depositToken The address of the token to deposit.
+     * @param depositAmount The amount of the token to deposit.
+     * @return uweAmount The amount of [`UWE`](./../../native/UnderwritingEquity) that will be minted to the receiver.
+     */
+    function calculateDeposit(address depositToken, uint256 depositAmount) external view returns (uint256 uweAmount);
+
+    /***************************************
+    DEPOSIT FUNCTIONS
+    ***************************************/
+
+    /**
+     * @notice Deposits tokens into [`UWE`](./../../native/UnderwritingEquity) and deposits [`UWE`](./../../native/UnderwritingEquity) into a new [`UWE Lock`](./../../native/UnderwritingLocker).
+     * @param depositToken Address of the token to deposit.
+     * @param depositAmount Amount of the token to deposit.
+     * @param lockExpiry The timestamp the lock will unlock.
+     * @return lockID The ID of the newly created [`UWE Lock`](./../../native/UnderwritingLocker).
+     */
+    function depositAndLock(
+        address depositToken,
+        uint256 depositAmount,
+        uint256 lockExpiry
+    ) external returns (uint256 lockID);
+
+    /**
+     * @notice Deposits tokens into [`UWE`](./../../native/UnderwritingEquity) and deposits [`UWE`](./../../native/UnderwritingEquity) into an existing [`UWE Lock`](./../../native/UnderwritingLocker).
+     * @param depositToken Address of the token to deposit.
+     * @param depositAmount Amount of the token to deposit.
+     * @param lockID The ID of the [`UWE Lock`](./../../native/UnderwritingLocker) to deposit into.
+     */
+    function depositIntoLock(
+        address depositToken,
+        uint256 depositAmount,
+        uint256 lockID
+    ) external;
+}

contracts/interfaces/native/IFluxMegaOracle.sol

@@ -0,0 +1,74 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+pragma solidity 0.8.6;
+
+import "./IPriceOracle.sol";
+
+/**
+ * @title IFluxMegaOracle
+ * @author solace.fi
+ * @notice An oracle that consumes data from [Flux](https://fluxprotocol.org) and returns it in a useable format.
+ *
+ * [Governance](/docs/protocol/governance) can add or remove price feeds via [`addPriceFeeds()`](#addpricefeeds) and [`removePriceFeeds()`](#removepricefeeds). Users can view price feeds via [`priceFeedForToken(address token)`](#pricefeedfortoken). Users can use the price feeds via [`valueOfTokens()`](#valueoftokens). Users can list price feeds via [`tokensLength()`](#tokenslength) and [`tokenByIndex()`](#tokenbyindex).
+ */
+interface IFluxMegaOracle is IPriceOracle {
+
+    /***************************************
+    EVENTS
+    ***************************************/
+
+    /// @notice Emitted when a price feed is added.
+    event PriceFeedAdded(address indexed token);
+    /// @notice Emitted when a price feed is removed.
+    event PriceFeedRemoved(address indexed token);
+
+    /***************************************
+    VIEW FUNCTIONS
+    ***************************************/
+
+    struct PriceFeedData {
+        address token;
+        address priceFeed;
+        uint8 tokenDecimals;
+        uint8 priceFeedDecimals;
+    }
+
+    /**
+     * @notice Returns information about the price feed for a token.
+     * @dev Returns a zero struct if no known price feed.
+     * @param token The token to query price feed data of.
+     * @return data Information about te price feed.
+     */
+    function priceFeedForToken(address token) external view returns (PriceFeedData memory data);
+
+    /**
+     * @notice Lists the tokens in the oracle.
+     * @dev Enumerable `[0,tokensLength]`
+     * @param index The index to query.
+     * @return token The address of the token at that index.
+     */
+    function tokenByIndex(uint256 index) external view returns (address token);
+
+    /**
+     * @notice The number of tokens with feeds in this oracle.
+     * @return len The number of tokens.
+     */
+    function tokensLength() external view returns (uint256 len);
+
+    /***************************************
+    GOVERNANCE FUNCTIONS
+    ***************************************/
+
+    /**
+     * @notice Adds price feeds.
+     * Can only be called by the current [**governor**](/docs/protocol/governance).
+     * @param feeds The list of price feeds to add.
+     */
+    function addPriceFeeds(PriceFeedData[] memory feeds) external;
+
+    /**
+     * @notice Removes price feeds.
+     * Can only be called by the current [**governor**](/docs/protocol/governance).
+     * @param tokens The list of price feeds to remove.
+     */
+    function removePriceFeeds(address[] memory tokens) external;
+}

contracts/interfaces/native/IFluxPriceFeed.sol

@@ -0,0 +1,16 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+pragma solidity 0.8.6;
+
+
+/**
+ * @title Flux first-party price feed oracle
+ * @author fluxprotocol.org
+ * @notice Simple data posting on chain of a scalar value, compatible with Chainlink V2 and V3 aggregator interface
+ */
+interface IFluxPriceFeed {
+
+    /**
+     * @notice answer from the most recent report
+     */
+    function latestAnswer() external view returns (int256);
+}