About Reserve
1. What is Reserve’s mission?
-
Reserve’s mission is to increase adoption of and access to stable, long-lasting, inflation-resistant currency.
Reserve Rights (RSR)
2. What is the RSR token?
-
Reserve Rights (RSR) is the governance token for the Reserve protocol ecosystem. RSR is an ERC-20 token common across all asset-backed currencies (“RTokens”) deployed via the Reserve protocol. RSR can be staked on a particular RToken, where it has two roles:
-
Staked RSR overcollateralizes an RToken and may receive a portion of the RToken collateral’s revenue in exchange for being the first capital-at-risk in the case of collateral default.
-
RSR stakers can participate in governance, proposing and voting on changes to the RToken’s configuration.
-
Staked RSR overcollateralizes an RToken and may receive a portion of the RToken collateral’s revenue in exchange for being the first capital-at-risk in the case of collateral default.
- Learn more about RSR.
3. Where can I stake RSR and what are the benefits and risks?
- You can stake RSR by accessing the Reserve Register app and selecting an RToken for staking. RSR staking is necessary in order to participate in governance and earn rewards. Stakers also provide first-loss capital in the event a collateral asset fails in the RToken or a black swan event occurs — such as what happened during USDC’s depeg. Learn more about staking.
4. What are RSR tokenomics and the role of the “Slow(er) Wallets?”
-
RSR has a fixed total supply of 100 billion tokens, out of which there are currently 50.6 billion in circulation, fully unlocked, including all early purchasers.
- The remaining tokens belong to the Slow Wallet and Slower Wallet, controlled by Confusion Capital, which manages funding for Reserve ecosystem initiatives. The Slower Wallet utilizes a hard-coded 4-week delay between initiating any withdrawal and completing it. Furthermore, no more than 1% of the total supply of RSR (i.e., no more than 1 billion RSR tokens) can be withdrawn from the Slower Wallet within any 4-week period.
5. How can I estimate my RSR staking returns?
- Depending on the RToken you choose, you can get a higher or lower staking yield. The fastest way to understand RSR staking yields is by visiting the respective RToken’s page on the Reserve Register app. See eUSD as an example. Once you have already staked, you will notice rewards accrual on the Stake tab of your RToken. Read more about RSR staking.
6. I have old Reserve Rights tokens (RSR) that I can no longer transfer from my wallet. How can I exchange these for the new RSR tokens?
- Good news: your new RSR is already in your wallet. The bad news is that some wallets do not auto-discover the new RSR, so you have to take a few extra steps. Read How to Upgrade to the New Reserve Rights (RSR) Contract for a comprehensive breakdown of your options.
7. How do I bridge between Ethereum and Base?
-
Bridge to Base
-
Bridge your RSR or RTokens to the Base network at https://app.reserve.org/#/bridge?chainId=1 after selecting the Ethereum network.
-
Verify the correct bridge page (https://app.reserve.org/#/bridge?chainId=1) and confirm that you are depositing to Base.
-
Send a small amount of ETH to Base for gas fees via app.reserve.org bridge or the Base Bridge.
-
Connect your wallet to app.reserve.org and specify the RSR or RToken amount to transfer.
-
Approve token spending for RSR or RToken and confirm the bridging transaction.
-
Wait for confirmation and find your RSR or RToken deposited to the same wallet on Base.
-
Keep in mind: due to Base being an optimistic rollup, it may take up to 7 days to withdraw from Base to Ethereum mainnet.
-
Bridge your RSR or RTokens to the Base network at https://app.reserve.org/#/bridge?chainId=1 after selecting the Ethereum network.
-
Bridge to Ethereum
-
Go to the Reserve Register bridge: https://app.reserve.org/#/bridge?chainId=8453.
-
If you are bridging from Base to Ethereum, make sure you have connected your wallet and you are on the Base network.
-
Select the asset you want to bridge.
-
Make sure you have enough Eth token in your wallet to cover the gas transaction cost.
-
You can now bridge your funds from Base to Ethereum.
- After the transaction has been completed, you can now switch to the Ethereum network in your wallet and see the funds that you bridged. Happy Bridging!
-
Go to the Reserve Register bridge: https://app.reserve.org/#/bridge?chainId=8453.
8. What are the Reserve ecosystem token contract addresses?
-
The contract addresses for all RTokens are available on the Reserve Register app.
Navigate to the RToken page you want, then find the contract address(es) featured in the header alongside the RToken’s name.
The example below, of Electronic Dollar’s page on the Reserve Register app, displays three unique addresses (for eUSD on Ethereum mainnet, Base, and Arbitrum One) as well as quick actions — the double square icon allows for easy copy/pasting of an address, and the arrow icon opens a link to the address on its respective blockchain explorer.
Reserve Register - Create, Mint, Redeem, Stake & Govern RTokens
9. What is Reserve Register?
- Reserve Register is a decentralized app (“dapp”) frontend enabling easy access to the Reserve protocol. The app allows anyone to create, mint, or redeem RTokens in a permissionless manner. Reserve Register also allows RSR holders to stake their RSR onto their preferred RToken to participate in governance, earn yield, and provide first-loss capital in the event of a depeg event.
10. Who can create an RToken?
- Because the Reserve protocol is permissionless and no coding experience is needed, anyone can create an RToken. DeFi developers, entrepreneurs, crypto protocols, apps, hedge funds, TradFi, and even rewards programs and video game/metaverse developers are all potential RToken deployers.
11. What RTokens are available to mint and how do I redeem an RToken?
-
RTokens are available to explore, mint, stake and govern via the Reserve Register app. Use the dropdown box to select from a number of RTokens and learn about their mandate, asset-backing, staking, and governance.
-
There are two ways to mint an RToken
-
Option one: You must have all the assets that the RToken uses in your wallet. Taking for example eUSD, minting requires the minter’s wallet to have the necessary amounts of saEthUSDC, wcUSDCv3, cUSDT, and saUSDT.
-
Option two: Reserve Register features “Zap minting” which allows you to mint any existing RToken using just a single asset. For example, you can mint eUSD by “zapping” into it with just USDC.
- Both functions can be found for your favorite RToken in the “Mint” section in Reserve Register.
-
Option one: You must have all the assets that the RToken uses in your wallet. Taking for example eUSD, minting requires the minter’s wallet to have the necessary amounts of saEthUSDC, wcUSDCv3, cUSDT, and saUSDT.
12. I would like to deploy my own RToken, where can I start?
- Start by reviewing the Official Documentation, the Deployment Guide, and the YouTube Tutorial, where you can find everything related to the process of deploying your RToken. Then you can visit Reserve Register to deploy.
13. How can I know the possible yield performance of an RToken idea/design I am considering?
- You can use the RToken Backtest tool to test the different possible collaterals for your RTokens and see which collateral assets produce the desired yield result.
14. I deployed my RToken and want it to be listed in Reserve Register, how can I do that ?
-
For your RToken to be listed in Reserve Register, you can create a pull request in this GitHub repository.
Reserve protocol operations
15. What blockchains are the Reserve Protocol available on?
- The Reserve protocol is integrated natively with Ethereum, Base, and Arbitrum One. RTokens can be bridged to many popular blockchains.
16. Has the Reserve Protocol been audited?
- Yes. Learn more about Reserve Protocol’s nine audits here.
17. Are the Reserve Protocol smart contracts decentralized?
- Yes. The core contracts are only upgradable via governance proposals that get approved by RSR stakers. These proposals can either change a single parameter or upgrade a contract.
18. How are RTokens decentralized?
- Collateral baskets are tokenized onchain, with the smart contract risk diversified over multiple protocols and assets. Each RToken is governed separately by RSR stakers and each can have an entirely different governance system.
19. What are Reserve Protocol and RToken risks?
- Smart contracts, depegs, counterparty and governance risks are all applicable to the Reserve Protocol. Read the Comprehensive Risk Mitigation at Reserve Protocol to dive deeper.
20. What are RToken collateral plugins and why are they important?
- Collateral plugins wrap ERC-20 tokens into assets that can back RTokens. Without them, native ERC-20 tokens are incompatible to collateralize RTokens. Learn more about collateral plugins.
21. What assets are available to be used as collateral in RTokens?
-
Any asset with a suitable collateral plugin can be used as a collateral asset within an RToken. Collateral plugins help to price underlying assets and surface properties required for the RToken to ascertain its status. Learn more about developing collateral plugins.
- Discover the currently available collateral options in Reserve Register.. New collateral assets are constantly being integrated into the protocol, and ambitious deployers can even create custom collateral plugins.
22. Are RTokens algorithmically backed?
- No, RTokens are not algorithmically backed. RTokens are fully asset backed 1:1 with exogenous collateral (i.e., external, unrelated assets) that, via smart contracts, are able to be redeemed at any time for the underlying assets.
23. How can an RToken deployer earn revenue?
- Revenue distribution for RTokens is entirely flexible. From the revenue that is being accrued, any portion can be sent to any number of arbitrary Ethereum addresses, including the RToken deployer. Revenue share percentages are set when deploying the RToken and can only be changed by community governance.
24. Where does RToken yield (revenue sharing) come from?
- Deposits in DeFi protocols such as Aave, Compound, Uniswap and Convex provide the depositor a receipt token that accrues yield. When these receipt tokens are used in collateral baskets for RTokens, the Reserve Protocol’s onchain operations harvest this yield to distribute to RToken stakeholders. This is performed 100% onchain. Learn more about RToken revenue handling.
25. How do RTokens harvest and reflect yield in price?
- As underlying RToken assets appreciate or rewards are earned, more RTokens can either be minted or obtained through revenue auctions. These RTokens are subsequently sent to the Furnace and melted. As a result, RTokens become redeemable for more of its base currency unit. RTokens that accrue revenue to its holders do not rebase, which means that yield-bearing dollar-denominated RTokens (for example) resemble flatcoins, rather than stablecoins. That is, its price will continue to increase over time ($1.00 → $1.10 → $1.20, and so on). Learn more about RToken revenue handling.
26. How is revenue distributed to RToken holders and RSR stakers?
- Once a threshold value has been met, RToken “revenue auctions” sell accrued rewards to buy RSR, which is subsequently distributed to RSR stakers. This process increases the redemption ratio of the staked RSR token (e.g. eusdRSR) relative to plain RSR. Learn more about RToken revenue handling.
27. How is the RToken peg maintained and what anti-bank run mechanisms are built-in?
-
The RToken peg is maintained by always enabling permissionless minting and redemption for the underlying collateral onchain. This enables market participants to take advantage of an arbitrage opportunity if the price of the RToken in the secondary market deviates from the net asset value of the underlying collateral.
-
RToken anti-bank run mechanisms include verifiable reserves, predictable recovery, overcollateralization, and proportional funds distribution, all of which are 100% onchain.
-
RTokens do not have the same recursive, negative feedback loops that UST/LUNA had because RTokens are not minted from any governance token. RTokens are 1:1 backed with exogenous assets with verifiable reserves onchain.
-
In the event one of the exogenous assets in the RToken basket drops by 10%, 20% or even 100%, the protocol would slash RSR stakers of the affected RToken and sell the failing collateral to buy the pre-programmed emergency collateral basket. Briefly the RToken would be below peg, yet the 100% redemption outcome would be verifiably predictable given the onchain overcollateralization. RTokens were battle-tested during the Silicon Valley Bank run that played a role in the March 9, 2023 depeg of USDC — learn more about RTokens’ autonomous self healing.
- Should there be a case where RToken collateral defaults and the RSR overcollateralization pool is spent with net collateral at < 100% of target price, the affected RToken holders receive proportional distribution rather than first-come-first-served exit - this eliminates the bad debt without a hyperinflation event.
-
RTokens do not have the same recursive, negative feedback loops that UST/LUNA had because RTokens are not minted from any governance token. RTokens are 1:1 backed with exogenous assets with verifiable reserves onchain.
28. How does RToken governance work?
-
The governance process follows a transparent and democratic approach. RSR stakers can propose, discuss, and vote on changes to the RToken(s) they’re staked on.
-
Governor Anastasius is the protocol's recommended governor implementation.
-
To participate in the governance of a specific RToken, go to the Reserve Register. Select the RToken you wish to govern and select the Governance section. You will be able to view all the governance proposals that have been submitted for the RToken. If there is any active proposal, you can select it and vote for or against it.
- Only those staking RSR on a specific RToken receive governance votes for that RToken, so ensure that you have done so if you wish to vote.
Anyone can create an RToken
In a similar way as how anyone can create a new trading pair on Uniswap, anyone can permissionlessly create a new Reserve stablecoin (RToken) by interacting with Reserve Protocol’s smart contracts. The protocol applies a system of factory smart contracts that allows anyone to deploy their own smart contract instance.
Creating an RToken can be done either by interacting directly with the Reserve Protocol’s smart contracts or any user interface that gets built on top of it. The first user interface for these smart contracts will be released by ABC Labs the company that's leading protocol development. Besides the creation of RTokens, this user interface will also support exploring usage and stats related to RTokens, RToken minting & redeeming, and RSR staking.
Non-compatible ERC20 assets
The following types of ERC20s are not supported to be used directly in an RToken system. These tokens should be be wrapped into a compatible ERC20 token to be used within the protocol. A concrete example is the use of Static ATokens for Aave V2.
- Rebasing Tokens that return yields by increasing the balances of users
- Tokens that take a "fee" on transfer
- Tokens that do not expose the decimals() in their interface. Decimals should always be between 1 and 18.
- ERC777 tokens which could allow reentrancy attacks
- Tokens with multiple entry points (multiple addresses)
- Tokens with multiple entry points (multiple addresses)
- Tokens that do not adhere to the ERC20 standard in general
Advanced RToken parameters
When deploying an RToken, the deployer has the ability to configure many different advanced parameters. The following list goes into detail about what these parameters do and some of the factors the deployer should keep in mind to set them.
As many of these parameters concern the Protocol Operations, we advise reading through that section of the documentation first—as it will give the deployer the necessary context to fully understand all parameters.
Trading delay(s)
The trading delay defines how many seconds should pass after the basket has been changed before a trade can be opened.
A collateral asset can instantly default if one of the invariants of the underlying DeFi protocol breaks. If that would happen, and we would not apply a trading delay, the protocol would react instantly by opening an auction. This would give only auctionLength seconds for people to bid on the auction, making it very possible for the protocol to lose value due to slippage.
The trading delay parameter may only be needed in the early days - before we get to a point where there is a robust market of MEV searchers. We expect that this parameter can be set to zero later on (once a robust market of MEV searchers is established).