RSK Swap is a fork of the famous Uniswap Protocol adapted to work on the RSK Network. It includes many new features and improvements. This article will serve as a high-level overview of these changes including:
For full details check out the:
In Uniswap V2, any ERC20 token can be pooled directly with any other ERC20 token. Wrapped RBTC (WRBTC) is used instead of native RBTC in the core contracts, although end users can still use RBTC through helper contracts.
The introduction of ERC20 token/ERC20 token pools in Uniswap V2 can be useful for liquidity providers, who can maintain more diverse ERC20 token denominated positions, without mandatory exposure to RBTC. One example would be a DAI/USDC pair, which should theoretically have little volatility for liquidity providers, but is useful for trading.
Having direct ERC20/ERC20 pairs can also improve prices because routing through RBTC for a swap between two other assets (say, DAI/USDC) involves paying fees and slippage on two separate pairs instead of one.
If two ERC20 tokens are not paired directly, and do not have a common pair between them, they can still be swapped as long as a path between them exists. Router contracts can be used to optimize between direct and multi-step swaps.
We still anticipate RBTC pairs being very popular, but expect to see growth in other types of pairs over time.
Uniswap V2 implements new functionality that enables highly decentralized and manipulation-resistant on-chain price feeds. This is achieved by measuring prices when they are expensive to manipulate, and cleverly accumulating historical data. This allows external smart contracts to create gas-efficient, time-weighted averages of Uniswap prices across any time interval.
On-chain price feeds are a critical component for many decentralized financial applications including those similar to derivatives, lending, margin trading, prediction markets and more. Despite closely tracking the real-world price most of the time, Uniswap V1 cannot be used safely as a price oracle because the price can move significantly in a short period of time.
Uniswap V2 includes a number of improvements for price feeds built on top of it. First, every pair measures (but does not store) the market price at the beginning of each block, before any trades take place. This price is expensive to manipulate because it was set by the last transaction in a previous block.
To set the measured price to one that is out of sync with the global market price, an attacker has to make a bad trade at the end of a previous block , typically with no guarantee that they will be able to arbitrage it back in the next block. Attackers will lose money to arbitrageurs, unless they can “selfishly” mine two blocks in a row. This type of attack presents a number of challenges and has not been observed to date.
This alone is not enough. If significant value settles based on the price resulting from this mechanism, then the profit of an attack likely can outweigh the loss.
Instead, Uniswap V2 adds this end-of-block price to a single cumulative-price variable in the core contract weighted by the amount of time this price existed. This variable represents a sum of the Uniswap price for every second in the entire history of the contract.
This variable can be used by external contracts to track accurate time-weighted average prices (TWAPs) across any time interval.
This is done by reading the cumulative price from an ERC20 token pair at the beginning and at the end of the interval. The difference in this cumulative price can then be divided by the length of the interval to create a TWAP for that period.
TWAPs can be used directly or as the basis for moving averages (EMAs and SMAs) as needed.
A few notes:
There are some nuances that are good to be aware of when using Uniswap V2 as an oracle, especially where manipulation resistance is concerned. The whitepaper elaborates on some of them. Additional oracle-focused developer guides and documentation will be released soon.
In the meantime, check out our example implementation of a 24 hr TWAP Oracle built on Uniswap V2!
Uniswap V2 flash swaps allow you to withdraw as much as you want of any ERC20 token on Uniswap at no upfront cost and do anything you want with them (execute arbitrary code), provided that by the end of the transaction execution, you either:
Liquidity provider fees are enforced by subtracting 0.3% from all input amounts, even if the input ERC20 tokens are being returned as part of a flash swap.
It is often the case that a series of transactions on RSK has a high upfront cost but ultimately a low net cost or is even net profitable by the end of the series. Flash swaps are incredibly useful because they remove upfront capital requirements and unnecessary constraints on order-of-operations for multi-step transactions that use Uniswap.
One example is arbitrage with no upfront capital. Imagine a scenario where you can sell 200 DOC for 1 RBTC on Uniswap and then sell that 1 RBTC on Money on Chain for 220 DOC at a 20 DOC profit. But, unfortunately, you don’t have any DOC in your wallet.
With flash swaps you could synchronously withdraw 1 RBTC from Uniswap, sell it on Oasis for 220 DOC and then pay for the RBTC on Uniswap with 200 of the DOC you just purchased.
Another example use case is improving the efficiency of margin trading protocols that borrow from lending protocols and use Uniswap for ERC20 token conversion. This is currently done with the following process:
With flash swaps this process is simplified to:
If the Uniswap pool does not receive enough DAI to cover the RBTC withdrawn, then the entire transaction will revert; thus, all ERC20 tokens are returned or paid for at the end of the transaction.
Uniswap V2 Core are the essential Uniswap V2 smart contracts, consisting of:
Core is minimalist in design, removing all logic that is not strictly necessary to secure liquidity stored in its pools. Logic related to trader security or ease-of-use must be implemented in external helper contracts. Since external helpers can be improved and replaced without needing to migrate liquidity, this improves on the flexibility and modularity of Uniswap.
Uniswap V2 Periphery (periphery) is an initial set of helpers, including:
Periphery contracts described as “Example” are for illustrative purposes only and should not be used in actual transactions.
While this is a huge improvement, there are some new smart contract patterns introduced which developers building on top of Uniswap should be aware of.
For additional details please read the architecture section of the in-progress Uniswap V2 docs or the core and periphery smart contracts themselves.
Uniswap V2 contains many other significant changes and improvements including the following:
Decentralization is in many ways about increasing participation and removing central points of failure. But for it to achieve its full potential as infrastructure in a fair and open financial system — it must continue to grow and improve.
To open a path to self-sustainability, the code for Uniswap V2 includes a small protocol charge mechanism. At launch, the protocol charge will default to 0, and the liquidity provider fee will be 0.30%. If the protocol charge is switched on, it will become 0.05% and the liquidity provider fee will be 0.25%.
This feature, including the exact percentage amounts, is hardcoded into the core contracts which remain decentralized and non-upgradable. It can be turned on, and directed by, a decentralized governance process deployed after the Uniswap V2 launch. There is no expectation that it will be turned on in the near future but it opens the possibility for future exploration.
DAO: "an entity that lives on the internet and exists autonomously, but also heavily relies on hiring individuals to perform certain tasks that the automaton itself cannot do."— Jesse Walden (@jessewldn) June 4, 2019
"Automation at the center, humans at the edges"
In the Classical Period of crypto (2014), Vitalik described decentralized autonomous organizations (DAOs) as “automation at the center, humans at the edges.”
an entity that lives on the internet and exists autonomously, but also heavily relies on hiring individuals to perform certain tasks that the automaton itself cannot do
This perfectly describes the Uniswap protocol’s path forward. In Uniswap V1 pricing, coordination, listing, and trade execution are fully automated while arbitrage and liquidity provision are incentivized.
However, the best version of Uniswap will be one that autonomously incentivizes contributions to its own growth and development as well as to the broader ecosystem in which it exists—one that supports the contributions of the incredible community that has formed and continues to grow.
Uniswap is an ideal candidate for exploring decentralized on-chain cash flows. Without any additional growth , it will generate more than $5M in liquidity provider fees this year. If the protocol charge was on, ~$830,000 of this would instead go to a decentralized funding mechanism used to support contributions to Uniswap and its ecosystem.
This type of support boosts network effects from which Uniswap and its users benefit greatly. Incentivized contributions lead to increased protocol functionality and usage. Usage generates fees which attracts liquidity. Increased liquidity further entrenches Uniswap, attracting additional users, contributors, and integrations.
For more details, please refer to the technical whitepaper or code.
While the core smart contracts are finished and deployed on RSK, additional work is still in progress.
The factory and an V2 router smart contract have already been deployed in Mainnet and Testnet.
We want to hear from you!
We will be releasing additional updates, information, and documentation over the coming months. We look forward to continued feedback and involvement from the fantastic Uniswap community. To get involved and stay up to date: