This sip builds on top of SIP-267's direct integration functionality in order to offer an end-to-end cross-asset swap function at reduced fees, built on top of Synthetix's atomic exchanges and Curve's stable swap pools.
\nThe CurveIntegration sip allows users to trade between non-synths at reduced fees, with the trade executing by hoping over curve stable-swap pools along side Synthetix's atomic swap function.\nA user would be able to spend synthEquivalent and receive another synthEquivalent with the swap taking place with the following route:
synthEquivalent to synth over curve's stable swaps (USDC to sUSD)synth to synth with atomic swaps (sUSD to sETH)synth to synthEquivalent over curve's stable swaps (sETH to wETH)As an implementation note, no partial trades are allowed and the full route from synthEquivalent to synthEquivalent needs to be executed atomically within the same transaction.
The CurveIntegration contract takes advantage of the slippage model incorporated within curve's stable-swap pools, helping stall toxic volume to the extent of the imbalance in individual curve pools. This allows the protocol to lower Synthetix's exchange fees with the help of SIP-267's override function and designate the 30 bp uniswap pool as a source of pricing. Therefore, swaps that do not take place within the CurveIntegration contract would continue to trade using the pricing of the 5 bp uniswap pool, at their own independently configured fees.
CurveIntegration contract need be assigned respective synthEquivalents via setSynthEquivalent function. The designated synthEquivalent tokens need to exist in the Curve Stable-Swap pools specified in the next section.For example sUSD would be assigned USDC as synthEquivalent and sETH would have wETH as synthEquivalent.
\nsynthEquivalent, hence a wETH/sETH curve stable swap pool would need to be created.synthEquivalent & synth pair need to be mapped to a specific curve pool containing the respective these tokens. The specification would be done by calling setCurvePoolForSynthExchange function which takes in the address of the curve contract as an argument as well as the currencyKey of the synth.synthEquivalent and synth tokens.The CurveIntegration contract needs to be pointed to the DirectIntegration contract, in order to be able to trade atomically with Synthetix's atomic function and retrieve the respective fee and pricing parameters, taking into account overrides.
CurveIntegration contract uses the curve pool swap function StableSwap.exchange_underlying to trade a specified amount of tokens. The swap return amount is obtained using the StableSwap.get_dy_underlying function.Naming Convention:
\nsourceEquivalent is the token spent by the usersourceSynth is the synth obtained by trading the sourceEquivalent token on the specified curve stable swap pooldestinationSynth is the synth obtained by trading the sourceSynth over Synthetix's atomic exchangedestinationEquivalent is token received by the user when trading destinationSynth on the specified stable swap curve poolCrv(sourceEquivalent,sourceSynth) is the rate of exchange obtained from curve, swapping a sourceSynth per unit of sourceEquivalentAtomic(sourceSynth,destinationSynth) is Synthetix's atomic rate of exchange of a destinationSynth token per unit of sourceSynthCrv(destinationSynth,destinationEquivalent) is the rate of exchange obtained from curve, swapping a destinationEquivalent token per unit of destinationSynthCurve Integration Pricing Function:
\nThe CurveIntegration price is obtained using the function below:
\nCrv(sourceEquivalent,sourceSynth) * Atomic(sourceSynth,destinationSynth) * Crv(destinationSynth,destinationEquivalent)
Note that both the Curve and Synthetix fill price are dependent on the amount of exchange at each step.
A getReturnAmount function would be incorporated into the CurveIntegration which takes in the following arguments:
sourceEquivalent tokendestinationEquivalent tokensourceAmount representing the amount spent by the userThe function returns the amount expected to be received in destinationEquivalent token, by trading over the CurveIntegration contract.
In case a synth is tagged to trade at the pure chainlink price, then the chainlink price used to fetch the price over atomic pricing.\nIt is worth nothing that with the current implementation of the atomic swaps functionality, the protocol does not need to map synths that trade at the pure chainlink price to synthEquivalents, since no uniswap pool is used. However, in order for the CurveIntegration contract to be able to handle swaps with synths that trade at pure chainlink price, a synthEquivalent needs to be designated.
A minReturn function will be incorporated into CurveIntegration swap function, representing the minimum return amount a user accepts to receive in synthEquivalent for the amount of synthEquivalent spent. In case the return amount is below the minReturn, the transaction reverts.
setCurvePoolForSynthExchange allows the Spartan Council to designate the Curve Stable-Swap contract over which the synthEquivalent to synth trade executes.setSynthEquivalent allows the Spartan Council to designate the respective equivalent for each synth that can be traded on Crv pools.SIP rejected by author as the SIP-267 implementation does not require that SIP-268 be implemented as any address can be configured for integration.
\nCopyright and related rights waived via CC0.
"}},"pageContext":{"id":"c9e24f2b-c19e-5782-85fa-3b85155067de","frontmatter__sip":268,"__params":{"frontmatter__sip":"268"}}},"staticQueryHashes":[]}