DOCS

About Reserve

1. What is Reserve’s mission?

  1. Reserve’s mission is to increase adoption of and access to sustainable, inflation proof, stable currency.


Reserve Rights (RSR)

2. What is the RSR token?

  1. RSR is the governance token for the Reserve Protocol ecosystem. The token can be staked on any RToken and provides stakers with the ability to participate in RToken governance, earn staking fees, and provide over-collateralization. Learn more about RSR.

3. Where can I stake RSR and what are the benefits and risks?

  1. You can stake RSR by accessing the Reserve Register 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?”

  1. 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.

  2. The remaining tokens belong to the Slow Wallet and Slower Wallet, controlled by Confusion Capital, who manages funding for Reserve Ecosystem initiatives. The Slower Wallet utilizes a hard-coded 4-week delay between initiating the 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?

  1. There are a number of RToken-specific factors which determine the returns for RSR stakers:

    1. The yield generated by the underlying RToken collateral.

    2. The percentage of yield allocated to RSR stakers for overcollateralization.

    3. The amount of RSR currently staked on the RToken.

  2. So 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 Reserve Register page for the respective RToken. See eUSD as an example. 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?

  1. Good news, your new RSR is already in your wallet. The bad news is some wallets do not auto discover the new RSR so you have to take a few extra steps.

  2. The RSR contract address changed in January 2022.

    1. Old contract address is 0x8762db106B2c2A0bccB3A80d1Ed41273552616E8.

    2. New contract address is 0x320623b8E4fF03373931769A31Fc52A4E78B5d70.

  3. For wallets such as Ledger or Metamask, manually add the new contract address to your wallet 0x320623b8E4fF03373931769A31Fc52A4E78B5d70 to view RSR.

  4. Here are specific steps for wallets like Metamask and Ledger:

    1. Metamask:

      1. Open the Metamask extension in your browser.

      2. Click on the three dots in the top right corner and click “View in explorer”.

      3. View your assets on Etherscan and confirm the correct new address is listed: 0x320623b8E4fF03373931769A31Fc52A4E78B5d70.

      4. If you have the old address, go to MetaMask, click “Import Token,” then go to the “custom token” tab and copy and paste the new address (see above).

      5. The wallet should automatically recognize the new RSR token.

      6. Click “Custom Token” and then “Import Tokens.”

      7. The new RSR token balance will be represented by the colored RSR token logo.

    2. Ledger:

      1. When using ledger, the new RSR should update automatically. If this action doesn’t occur then:

        1. Check on Etherscan using the “BalanceOf” option to ensure ownership

        2. Add the new contract 0x320623b8E4fF03373931769A31Fc52A4E78B5d70 or purchase a small amount of RSR to resolve this.

  5. If you are still having trouble with your wallet discovering new RSR and because there are so many different wallets such as Metamask, Coinbase Wallet, Zerion, Ledger, and Trezor, the best way to get specific instructions to add a new contact address to your wallet is to search for guides on your specific wallet. The process of adding new contract addresses is the same regardless of the token and hence is not RSR specific. The Reserve core team covers several wallets in this video.

7. How do I bridge between Ethereum and Base?

  1. Bridge to Base

    1. Bridge your RSR or RTokens to the Base network at https://app.reserve.org/#/bridge?chainId=1 after selecting the Ethereum network.

    2. Verify the correct bridge page (https://app.reserve.org/#/bridge?chainId=1) and confirm that you are depositing to Base.

    3. Send a small amount of ETH to Base for gas fees via app.reserve.org bridge or the Base Bridge.

    4. Connect your wallet to app.reserve.org and specify the RSR or RToken amount to transfer.

    5. Approve token spending for RSR or RToken and confirm the bridging transaction.

    6. Wait for confirmation and find your RSR or RToken deposited to the same wallet on Base.

    7. Keep in mind, due to Base being an optimistic rollup, it may take up to 7 days to withdraw from Base to the mainnet.

  2. Bridge to Ethereum

    1. Go to the Reserve Register bridge: https://app.reserve.org/#/bridge?chainId=8453.

    2. If you are bridging from Ethereum to Base make sure you have connected your wallet and you are on the ethereum mainnet.

    3. Select the asset you want to bridge.

    4. Make sure you have enough Eth token in your wallet to cover the gas transaction cost.

    5. You can now bridge your funds from Ethereum to Base.

    6. After the transaction has been completed, you can now switch to the Base network in your wallet and see the funds that you bridged. Happy Bridging!

8. What are the Reserve ecosystem token contract addresses?


Reserve Register - Create, Mint, Redeem, Stake & Govern RTokens

9. What is Reserve Register?

  1. Reserve Register is a dAPP frontend enabling users to easily access the Reserve Protocol. The dApp 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?

  1. RTokens are permissionless and no coding experience is needed, meaning 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?

  1. RTokens are available to explore, mint, stake and govern at Reserve Register. Use the dropdown box to select from a number of RTokens and learn about their mandate, asset backing, staking and governance.

  2. There are two ways to mint an RToken

    1. You must have all the assets that the RToken uses in your wallet. Taking for example eUSD, minters require saUSDC, saUSDT, cuUSDC and cuUSDT.

    2. Alternatively, Reserve Register features "Zap Minting" which allows you to mint any existing RToken using just 1 asset. For example, you can mint eUSD with just USDC.

    3. Both functions can be found for your favorite RToken in the "Mint + Redeem" section in Reserve Register.

12. I would like to deploy my own RToken, where can I start?

  1. 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?

  1. 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 ?

  1. For your RToken to be listed in Reserve Register, you can create a pull request in its github repository and ABC Labs will review it.


Reserve protocol operations

15. What blockchains are the Reserve Protocol available on?

  1. The Reserve Protocol is available on the Ethereum mainnet and Base L2. RTokens can be bridged to many popular blockchains.

16. Has the Reserve Protocol been audited?

  1. Yes. Learn more about Reserve Protocol’s five audits below:

    1. Trail of Bits: Report date: Aug 2022, review report: (link)

    2. Solidified: Report date: Oct 2022, review report: (link)

    3. Ackee: Report date: Oct 2022, review report: (link)

    4. Halborn: Report date: Nov 2022, review report: (link)

    5. Code4rena: Report date: Mar 2023, review report: (link)

17. Are the Reserve Protocol smart contracts decentralized?

  1. Yes. The core contracts are only upgradable through 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?

  1. 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?

  1. 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?

  1. Collateral plugins convert ERC20 tokens into assets that can back RTokens. Without them, native ERC20 tokens are incompatible to collateralize RTokens. Learn more about collateral plugins.

21. What assets are available to be used as collateral in RTokens?

  1. 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.

  2. Discover the currently available collateral options in Reserve Register deployment wizard “add to basket”. New collateral assets are constantly being integrated into the protocol.

22. Are RTokens algorithmically backed?

  1. No, RTokens are not algorithmically backed. RTokens are fully asset backed 1:1 with exogenous collateral (aka 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?

  1. 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. Revisit question #12 to understand RToken setup parameters.

24. Where does RToken yield (revenue sharing) come from?

  1. 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?

  1. 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?

  1. 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?

  1. 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.

  2. RToken anti-bank run mechanisms include verifiable reserves, predictable recovery, overcollateralization and proportional funds distribution, ALL ONCHAIN.

    1. RTokens do not have the same recursive, negative feedback loops that UST/LUNA had since RTokens are not minted from any governance token. RTokens are 1:1 backed with exogenous assets with verifiable reserves onchain.

    2. 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 about autonomous self healing.

    3. 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.

28. How does RToken governance work?

  1. The RToken governance process follows a transparent and democratic approach. RSR stakers can propose, discuss, and vote on changes to the protocol.

  2. Governor Alexios is the protocol's recommended governor implementation.

  3. To participate in the Governance of a specific RToken go to 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.

  4. 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.