![\"interest-rate.png\"](\"/static/interest-cefb467dc26abf54ac72d2a09c13afc1.png\")
Introduces an asymmetric funding rate mechanism for Perps V3.
\nBased on the configured parameters, asymmetry can be introduced to funding rates to add a net cost to traders monopolizing open interest. When trade is closed, the interest accrued is realized by the LPs backing the Perps supermarket.
\nWhile Perps V2 was supported by a large pool of collateral (SNX stakers) from inception, isolated deployments of Perps V3 will need to bootstrap liquidity and markets. Scaling positions and liquidity in concert is crucial for bounding LP risk appropriately. Perps V3 also implements a locking of LP collateral to ensure that open positions are backed by underlying collateral. However, without economic incentives to discourage total utilization of LP collateral, it is possible to engineer costless locking of LP collateral. The introduction of asymmetric funding provides acts as both an incentive for additional LPs to enter the market while also encouraging closing of positions to liberate LP collateral in a timely manner.
\nThis SIP proposes to upgrades the perps contracts to introduce 3 new parameters to enable asymmetric funding across any markets within the supermarket. For simplicity of accounting, this can be implemented as an interest rate that is only activated at very high levels of locked LP collateral; though in practice, it will be surfaced to end users as an asymmetric funding rate (e.g. 10% funding, 5% 'interest' = +5% for short, -15% for long)
\nThe parameters:
\nuint256 lowUtilizationInterestRateGradient\nuint256 interestRateGradientBreakpoint\nuint256 highUtilizationInterestRateGradient\n
The interest accrued is based on which side of the interestRateGradientBreakpoint the utilization % is. Below the breakpoint means the interest rate grows at the rate defined by lowUtilizationInterestRateGradient and anything above means the interest rate grows at the rate defined by highUtilizationInterestRateGradient.
The utilization rate is calculated as follows:
\nlockedOi / marketCreditCapacity\nNote: lockedOi is the entire open interest of all markets in the supermarket multiplied by their respective lockedOiRatio.
The interest is accrued by each trader based on their contribution to the locked open interest.
\nSetters/Getters
\nfunction setInterestRateParameters(\n uint128 lowUtilizationInterestRateGradient,\n uint128 interestRateGradientBreakpoint,\n uint128 highUtilizationInterestRateGradient\n) external;\n\nfunction getInterestRateParameters()\n external\n view\n returns (\n uint128 lowUtilizationInterestRateGradient,\n uint128 interestRateGradientBreakpoint,\n uint128 highUtilizationInterestRateGradient\n );\nBecause utilization rate is dependent on delegated collateral from the LP side, there is no hook that forces the rate on the perps supermarket to be updated when someone (un)delegates. For this reason, a convenience method to manually update the interest rate that could be called the LP app has been added:
\nfunction updateInterestRate() external;\nNew views have been added to surface the current utliziationRate or the computed interestRate of the supermarket:
\n/**\n * @notice Returns the current market interest rate\n * @return rate\n */\nfunction interestRate() external view returns (uint128 rate);\n\n/**\n * @notice Returns the super market utilization rate\n * @dev The rate is the minimumCredit / delegatedCollateral available.\n * @dev Locked credit is the sum of all markets open interest * configured lockedOiRatio\n * @dev delegatedCollateral is the credit capacity available to the supermarket\n * @return rate\n * @return delegatedCollateral\n * @return lockedCredit credit locked based on OI & lockedOiRatio\n */\nfunction utilizationRate()\n external\n view\n returns (uint256 rate, uint256 delegatedCollateral, uint256 lockedCredit);\nThe integrators can get a trader's owed interest by calling the previously available getOpenPosition which now returns that value:
function getOpenPosition(\n uint128 accountId,\n uint128 marketId\n )\n external\n view\n returns (\n int256 totalPnl,\n int256 accruedFunding,\n int128 positionSize,\n+ uint256 owedInterest\n );\nNew events added:
\n/**\n * @notice Gets emitted when the interest rate is updated.\n */\nevent InterestRateUpdated(uint128 indexed superMarketId, uint128 interestRate);\n\n/**\n * @notice Emitted when interest rate parameters are set\n */\nevent InterestRateParametersSet(\n uint256 lowUtilizationInterestRateGradient,\n uint256 interestRateGradientBreakpoint,\n uint256 highUtilizationInterestRateGradient\n);\n\n/**\n * @notice Gets emitted after any trade settles and includes interest charged to the trader on previous position\n */\nevent InterestCharged(uint128 indexed accountId, uint256 interest);\nNew test scenarios have been added to InterestRate.test.ts.
Check both trader1 and trader2 have accrued the proper interest based on configured interest rate parameters.
\nAnother test scenario added for when the interest rate parameters are turned off after being turned on: InterestRate.reset.test.ts
Added new tests to GlobalPerpsMarket.test.ts:
setInterestRateParametersgetInterestRateParametersPlease list all values configurable via SCCP under this implementation.
\nCopyright and related rights waived via CC0.
"}},"pageContext":{"id":"3af3f853-0f23-5b25-8ec9-7fc6583b1774","frontmatter__sip":354,"__params":{"frontmatter__sip":"354"}}},"staticQueryHashes":[]}