MIP 29: Proposal: Save. Earn. Borrow w/mStableP2P (includes: licensing fees, increased LP activity, new product, more engagement)

Author: Howard Krieger, CEO of unFederalReserve

Created: December 9, 2022

Status: Under Review


  • Residual Token, Inc. proposes to build, launch and maintain mStableP2P, a savings, lending and borrowing tool that will integrate into the existing mStable ecosystem.
  • Residual Token, Inc. will not charge mStable development or maintenance fees, and mStable will not incur any out-of-pocket licensing or whitelisting fees.
  • Residual Token, Inc. requests that mStable - at its own expense - adds hyperlinks to its website that point to mStableP2P, and advertises mStableP2P to its users.
  • Liquidations, a common function required to keep a P2P platform healthy, are managed by outside bots with no economic benefit to Residual Token nor mStable.


Residual Token, Inc. (dba unFederalReserve) proposes to offer mStable a license to mStableP2P, a front-end interface to the ReserveLending Core.

The ReserveLending Core (hereafter, the ā€˜Coreā€™) is an overcollateralized Pool-to-Peer1 lending protocol that brings together savers, lenders and borrowers from a variety of cryptocurrency ecosystems, platforms and brands. This global connectivity is facilitated by the use of multiple front-ends that each provide access to the Coreā€™s single set of liquidity pools.

The Licensor, Residual Token, Inc. (hereafter, ā€˜Residualā€™), will build and maintain the mStableP2P front-end, and will not charge the Licensee, mStable, development or maintenance fees (development is estimated to cost around $50,000 of Residualā€™s own capital, and maintenance is approximately $3,000/mos). mStable will not incur any out-of-pocket licensing or whitelisting fees for hosting mStableP2P.

mStableā€™s treasury will earn 10% of the reserves generated from borrowers connecting through mStableP2P. In other words, it will earn a portion of the APY that mStableP2P borrowers pay on loans, and in the case of loan defaults, it will earn a portion of the recovered collateral.

Additionally, revenues from existing mStable trading tools are projected to increase due to higher trading volume. Residual projects a 30-40% increase in mStableā€™s trading volume as users take advantage of interest paying deposit accounts and affordable loans available through mStableP2P. Detailed projections are available in the Forecast section below.

Note, the extent of work requested to be undertaken by mStable - at its own expense - will be:

  • Adding hyperlinks to the mStable website that point to mStableP2P.
  • Advertising mStableP2P to both existing and future mStable users.

At the user level, mStableP2P will:

  • Empower Metamask, Wallet Connect and Coinbase Wallet users to earn APY - without relinquishing custody of their cryptocurrency to a third-party - via mStableP2Pā€˜s Supply or Deposit function;
  • Allow users to borrow a select set of cryptocurrency types on an overcollateralized basis at reasonable APYs; and
  • Provide users the ability to leverage up, short sell certain assets, or increase purchasing power using safe, reliable and easy-to-use features.

mStableā€™s users will also have the added bonus of combining the above benefits with the robust trading tools already offered by mStable, thus spending more time in the mStable ecosystem, and increasing overall engagement with the mStable product suite.

The mStableP2P user interface will be custom designed to fit mStableā€™s existing brand style. Below are sample images of Residualā€™s own front-end, ReserveLendingTM. The mStableP2P front-end will share a similar overall layout, along with custom mStable theming across multiple webpages. (See also: https://app.unfederalreserve.com/markets)

Example I: User View of Current Deposits and Loans Outstanding

Example II: Market Overview

Example III: Liquidations

Example IV: Education Center

Also included with mStableP2P will be a range of ā€œhow-toā€ videos, along with user access to experts in the DeFi community. These experts will provide knowledge to the mStable community on strategies to employ depending on mStableā€™s usersā€™ wishes and market conditions.


Onboard mStable as a Licensee to mStableP2P, a front-end of the ReserveLending Core. Residual will build the customized front-end for mStable at no cost to mStable. mStableP2P will provide mStable users access to the ReserveLending Core in an experience simpatico with the mStable platform today, and will earn mStable 10% of reserves generated through mStableP2P. mStable - at its own expense - will add hyperlinks to its website that point to mStableP2P, and will advertise mStableP2P to its users.


Do not onboard mStable as a Licensee to mStableP2P.


In business since 2017, Residual Token, Inc. is a Fintech SaaS company specializing in banking, Web3 and DeFi software development. Licensing software is Residualā€™s primary source of revenue, and a live utility token, eRSDL, is used as part of its Licensing-as-a-Service (LaaS) model, which is explained in detail here: Licensing as a Service (LaaS) for blockchain enterprise solutions | by unFederalReserve | Medium

The ReserveLending Core is a retail DeFi protocol for overcollateralized Pool-to-Peer1 lending and borrowing that is owned by Residual. The Core is based on the CompoundĀ® Protocol, which is non-custodial, meaning that Residual does not have control over supplied assets, and users are not exposed to the typical risks inherent in centralized custodial lending. The Core is also permissionless, meaning that any address is free to access the Coreā€™s liquidity pools. A review of the Coreā€™s activity can be found here: unFederalReserve - Key Metrics

Front-ends (interfaces) to the Core allow users to supply assets to earn APY, and optionally use their supplied assets as collateral to borrow on margin. Users across all Core front-ends share access to the same Core liquidity pools. This means that a user accessing the Core from one front-end can supply assets to a liquidity pool; while a user accessing the Core from another front-end can borrow those assets from the same liquidity pool (assuming the borrower has supplied enough collateral to satisfy this key condition to the loan).

Residual hosts a front-end to the Core, branded ReserveLendingā„¢. Residual also offers front-end licenses to third parties (Licensees). Front-ends are custom-themed for Licensees, allowing for seamless integration with existing branded ecosystems.

Residual will build and maintain a customized front-end for Licensees, and will not charge Licensees development or maintenance fees. Furthermore, Licensees will not incur any out-of-pocket licensing or whitelisting fees for hosting a front-end.

The extent of work required to be undertaken by a Licensee - at its own expense - will be:

  • Adding hyperlinks to its website that point to the front-end.
  • Advertising the front-end to both existing and future users.

Allocation of Reserves

The reserves accumulated by the Core are allocated to:

  1. Rewards paid to Licensees
  2. License fees collected by Residual Token, Inc. (aka unFederalReserve)

Rewards paid to Licensees

The total allocation of Licensee rewards is divided amongst Licensees in amounts reflecting the percentage of the total TVL that is borrowed from the Core through each Licenseeā€™s front-end. Residual tracks and reports on these amounts using URL-related analytics and activity mapping. In this case, Residual will track Core activity tied to the mStableP2P front-end - using its URL - when estimating the licensing fee. Please refer to the Forecast section for detailed reward projections.

License fees collected by Residual Token, Inc. (aka unFederalReserve)

Given that Licensees do not pay any out-of-pocket licensing fees, Residual collects licensing fees from the Core reserves. In line with the Licensing-as-a-Service (LaaS) model, part of the licensing fees will be directed to reimburse Residual for its costs and profit expectations, and part will be used to conduct open market purchases of eRSDL tokens (eRSDL tokens are digital markers representing license state, and are burned as licenses are consumed).

Licensee benefits of hosting a Core front-end:

  • Rewards. Licensees are rewarded part of the Core reserves. A Licenseeā€™s rewards reflect the TVL that is borrowed from the Core through its front-end. The greater the amount borrowed, the greater the rewards.
  • No out-of-pocket licensing or whitelisting fees.
  • Residual will not charge development or maintenance fees.
  • Expansion of product offerings to both existing and potential users.
  • Removal of the need to build, test, maintain and audit a similar platform in-house.
  • The Core has undergone extensive security tests and audits; most notably Trail of Bits successfully completed an audit just a few months ago.
  • In-house Core access means that a Licenseeā€™s users no longer have to visit potentially risky third-party lending services.

User benefits of accessing the Core via a front-end:

  • Users can access global liquidity pools that are also accessed by users of other front-ends. As more users are introduced through new front-ends, the size of these liquidity pools is expected to grow significantly.
  • Users can earn APY by supplying assets.
  • Users can earn profits by shorting assets:
  1. Supply asset
  2. Borrow asset to be shorted
  3. Swap out of borrowed asset into a stable coin on a DEX/CEX
  4. Swap back into borrowed asset at a lower price
  5. Pay off borrowed asset
  • Users can take advantage of arbitrage opportunities:
  1. Supply asset
  2. Borrow asset
  3. Use borrowed asset to invest elsewhere. Profits or APY earned elsewhere should be greater than the Core spread (spread = borrow APY less supply APY, which is the effective cost of borrowing in the Core).
  • The Core has undergone extensive security tests and audits.
  • The front-end templates used to access the Core are designed for optimal user experience and ease-of-use.

Diagram I: Global Liquidity Pool ā€œCoreā€ Schematic


There are a variety of key performance indicators (KPIs) to consider when measuring the success of the mStable-Residual collaboration. The key driver of value for mStable will be the Total Value Locked (TVL) borrowed from the platform. Residual expects approximately a third of mStableā€™s users to be interested in using mStableP2Pā€™s deposit capabilities alone, without necessarily leveraging themselves or executing one of the shorting strategies discussed earlier. Given where Residual has seen market rates for borrowing, Residual expects mStableā€™s treasury to earn a 10% royalty on the estimated 3% reserve fee revenue (refer: Table 1). This 30bps is almost double to triple the standard 0.125% broker fee other borrowing lead-generation platforms receive.

Table 1: Pro Forma Licensing Revenue for mStable Treasury

The figures above represent estimates made by the management of Residual for the purposes of illustrating the potential revenue stream for mStableā€™s treasury. These estimates should not be relied upon as anything more than Residualā€™s best guess as to the volume the mStable user base would generate. Residual started with an aggressive growth curve for 2023, assuming a general market turn-around and increased adoption of mStable as mStableP2P and other products are added to mStableā€™s offering.

In this model, for instance, Residual assumes that average borrows can reach $200 million by the end of year 2, and continue experiencing significant growth in the following years. One way to verify or validate this assumption is by extrapolating from current usage trends. If just a tenth of the current daily trade volume went into deposits and was held there, then by year-end, the outstanding borrow balance would be around $50 million.

Additional to the above projections, mStableP2P saving, lending and borrowing activity is estimated to result in a 30-40% increase in mStableā€™s trading volume, thus resulting in an increase in its trading-derived revenues. The basis of this estimate is as follows:

Cointelegraph reports that, ā€œā€¦ utilization rates, or the percentage of stablecoins taken out as loans versus total supplied, have also fallen to around 30% to 40%ā€¦ ā€œ. Considering that the main use cases for borrowing off Pool-to-Peer lending platforms at present are for shorting from one of the liquidity pools and/or for leveraging into another purchase (note: debt consolidation, one-time purchases, ā€œquiet sellingā€, etc., are all considered, but are not the main drivers behind margin borrowing in crypto), Residual foresees similar metrics for mStable; whereby its users will supply onto mStableP2P, borrow stables, wBTC or ETH, and use those funds to swap into new tokens through mStable.

Interest Rate Models and Pricing Oracle

The Coreā€™s current APY model for USDC, DAI, and USDT is a JumpRate Version 2 model described in detail here: https://docs.cream.finance/lending/interest-rate-model

The model calls for the following inputs when calculating an APY:

Base Rate (Borrow) that includes a floor borrow rate, and logic to increase the borrow rate depending on utilization. At a certain utilization, or percentage of borrows vs total supply, the rate ā€œjumpsā€ to provide a repayment and supplying incentive.

The jump rate for borrowing includes factors such as:

  • A multiplier based on utilization;
  • A JumpMultiplier when utilization exceeds a ā€œKinkā€ amount; and
  • A Kink amount or utilization rate above which triggers the JumpMultiplier.

The existing factors for each pool that determine its utility include:

  • Collateral Factor: The Collateral Factor is the percentage of value that one is able to borrow against their total supply value. Looking at historical price data, Residual found a 90% collateral factor on stables to be a sensible choice. This higher collateral factor helps protect accountsā€™ positions from volatility of asset prices, and from liquidations. This assumption is based on Gauntletā€™s simulation risk report done on the Compound protocol. (Gauntlet).

  • Reserve Factor: The Reserve Factor is the percentage revenue the platform earns from its borrowers based on current borrow APYs and outstanding balances. Residual has lowered reserve factors to 15% to align with and beat other market participantā€™s settings. (The reserve factor is used to calculate the reserves collected, aka the Reserve Fee, whereby the Reserve Fee = Borrow APY * Reserve Factor).

The Core relies on an accurate token price oracle to constantly confirm margin balances versus borrowing limits (i.e. token price values in USD are also used for reporting purposes). Token prices in the Core are derived from a ChainlinkĀ® oracle. The Chainlink oracle was chosen for its accuracy and reliability - to avoid sudden hiccups in value accidentally triggering liquidations. As part of this proposal, Residual will bear the cost of maintaining the oracle as well as other elements of the infrastructure requiring regular maintenance and payments.

Here is an example of the USDC interest rate model:

Diagram II: Interest Rate Model (Example)

Changes to the interest model are controlled via Residualā€™s policies and procedures. These procedures include internal governance meetings to review the overall performance of the Core. Residual compares its rates and utilization to its competitors, along with the other factors mentioned above. It is Residualā€™s goal to maintain a leading position in terms of the highest supply APYs and the lowest borrow APYs available. Residual does not control all the market conditions required to meet those goals, but Residual does monitor and market the Core and its front-ends accordingly.

If through the governance process, a decision is reached regarding a factor adjustment, then the impact of the change is socialized across a variety of channels. If the impact of the change will result in an inattentive user being negatively impacted, then the change is voted on by members of the eRSDL (unFederalReserve) community. As a software provider, Residual strives to abstain from making changes to the Coreā€™s parameters, in favor of letting market conditions play out.


Residual considers user and product security a top priority. The implementation team, in collaboration with third-party auditors and experts, has worked hard to build a Core that is secure and dependable.

The Core is managed in-house by Residual and has governance and security protocols in place that prevent corruption of its contracts. From a process perspective, changes to the Coreā€™s key terms and provisions require management review, approval, and robust testing before publishing. Most changes fall into the category of adding tokens to the platform or adjusting interest rate pricing factors to optimize utilization.

Furthermore, the Core shares the same codebase used by unFederalReserveā€™s institutional permissioned and overcollateralized Pool-to-Peer platform, ReserveLending+, which has also undergone multiple rounds of security testing including an audit by Trail of Bits.

List of audits

The addresses for the Coreā€™s contracts are listed below:

Name Initializations Address
unFederal eRSDL uneRSDL 0xE4cC5A22B39fFB0A56d67F94f9300db20D786a5F
unFederal ETH unETH 0xFaCecE87e14B50eafc85C44C01702F5f485CA460
unFederal USDC unUSDC 0x6b576972de33BebDe3A703BfF52a091e79f8c87A
unFederal DAI unDAI 0x2dbA05B51eF5A7DE3E7c3327201CA2F8a25C2414
unFederal USDT unUSDT 0x6e2aA5bB90ac37D9006685AFc651ef067E1c7b44
unFederal WBTC unWBTC 0x5D446FC8DBd10EBAcfE9A427aB5402586af98cD4
unFederal AAVE unAAVE 0xD837eCa6C91c67D98461A411BA2f00bdA9960a9D
unFederal YFI unYFI 0x9e29Ce9cD25F4141dF6BB85b27Ef6933a16A5824
unFederal LINK unLINK 0x031002d15B0D0Cd7c9129d6F644446368deaE391

The following were security audits performed over these contracts. Please note that these audits do not include the 5,000+ hours of Q&A performed by an internal, independent team dedicated to that function.

Regulatory Compliance

Residual maintains a robust AML policy consistent with its role as software provider for a self-custodial product. Residual is FinCEN registered as a general entity; meaning that it is not obligated to report suspicious activity, however it chooses to do so in order for the unFederalReserve ecosystem to present to regulators in a manner consistent with expectations. Residual maintains consumer lending counsel among other attorney groups for this such purpose, and users of mStableP2P should expect to checkbox their understanding and agreement to end user terms of use. Users are also subject to the platformā€™s privacy policy which may change from time to time to align with evolving regulations.

Bad Borrowers and Recourse

Over-collateralized borrowing and lending reduces concerns around an individualā€™s willingness and ability to pay, and instead focuses on the use of collateral as the security interest against borrower default. The technology of the Core allows for liquidation bots to pay off loans whose outstanding balance as a percentage of its related collateral exceeds the collateral factor. However, there are instances where highly volatile collateral will drop too quickly for the bots to liquidate the loan. In those instances, vast amounts of loans may become unsecured. Worse still, as the value of the collateral rises, bots may re-engage and liquidate default loans as the price of the collateral rises; thus, putting sell pressure on the collateral token until all the liquidations have been cleared.

Options are limited here, but thankfully, the instances where enforcing recourse are few. One concept toyed around with by permissionless lenders is the dropping of forgiveness letter NFTs into the offenderā€™s wallet, informing the borrower of the tax implications of a forgiven loan in an effort to encourage paying back the loan. In general, the best way to limit these occurrences is to only allow stable collateral at reasonable borrow caps in those wallets. Residual does not currently cap the amount of a given token that can be borrowed, but this might be a feature to consider leveraging if utilization reached and held a rate untenable for long-term platform viability.

A development for which Residual advocates includes ā€œSupplierā€™s Rightsā€, where supplierā€™s en masse can vote to: impair bad debts on the platform, encourage an offending party to repay its loans, or split the collateral that remains on a pro rata basis.

Risks and mitigation strategies

Risk Category Specific Risk Mitigation Strategy
Technology Risk A failure of the mStableP2P front-end to accept wallet connections, supplied assets, borrows, and/or reflect true and accurate information regarding interest rates, amounts, prices, etc. Residualā€™s smart contract Core and front-ends have undergone multiple security audits and QA testing rounds. Residual will continue periodic review and testing, and address customer issues as they arise.
Reputation Risk A mStableP2P issue (real or perceived) causes people to associate that failure with the broader mStable platform. We are all in this together. An issue related to a specific userā€™s experience affects the entire product line and will be addressed immediately. We (Residual) have undergone crisis management training, and during the volatility of 2021/2022, have experienced handling FUD (real or perceived) across multiple channels. Transparency is the key to folks having confidence in a product. Residual will also support mStableā€™s larger publicity strategy in the event of a disruption that affects both platforms.
Financial Risk Cascading liquidations due to massive market price corrections We cannot control borrowers over-exposing themselves relative to the riskiness of their collateral. Liquidations are a healthy and natural part of any P2P platform. (Consider the analogy of the little bird that cleans alligator teeth). The Core uses a Chainlink pricing oracle to avoid pricing spikes of any of the listed tokens accidently booting borrowers off the platform. This is the best anyone in the industry can do right now to prevent sporadic liquidations. Cascading liquidations might affect collateral price and impact individual borrowers, but would not pose a risk to either company.
Political Risk Custody rules change or regulatory rules around custody change. Compound is self-custodial. The DAO, Residual, etc. have no control over the usersā€™ assets at any time. As a technology enabler, Residual is facilitating people transacting with one another and does not see any current pipeline legislation here or abroad that would impact its ability to operate the mStableP2P in a regulatory compliant manner.
Legal Risk Suppliers or borrowers disagree with the terms and conditions of the loans after they have entered into these agreements and choose to litigate. Residual has invested tens of thousands of dollars in legal fees designing and implementing the first P2P lending and borrowing agreement that accounts for the nuances of self-custody, changing lenders, changing borrowers, collateral and interest rates. We at Residual are extremely proud of this document that NO OTHER COMPOUND FORK employs to protect users, sponsors, affiliates and supporters of both unFederalReserve and all front-end Licensees. (Note: Residual engages with three law firms - a general counsel (outsourced), consumer lending counsel, patent and trademark counsel).


Residual is excited to offer this opportunity to the mStable community. Residual believes that the increased utility of mStableā€™s tools via mStableP2P will make it a leader amongst its peers. Thank you for taking the time to read through this proposal, asking questions and allowing us to address any concerns you may have.


1 Overcollateralized Pool-to-Peer (P2P) Lending vs Centralized Alternatives

In Overcollateralized P2P Lending, users (lenders) supply assets to a liquidity pool. The lenders can also use their supplied assets as collateral to borrow assets from the pool (thus becoming borrowers). The borrowers are overcollateralized, meaning the value of their collateral exceeds the value of their borrow. The Collateral Factor determines how much a borrower can borrow relative to their supplied collateral. The borrowers are charged interest (borrow APY), and the Reserve Factor determines how much of this interest is awarded to lenders (supply APY), and how much is collected by the operators of the protocol (in the protocolā€™s ā€˜reservesā€™).


Although the material contained in this website was prepared based on information from public and private sources that Residual Token, Inc. d/b/a unFederalReserve believes to be reliable, no representation, warranty or undertaking, stated or implied, is given as to the accuracy of the information contained herein, and Residual Token, Inc. expressly disclaims any liability for the accuracy and completeness of information contained in this or any article.

This article, our website, social media posts and other public forum materials are distributed for general informational and educational purposes only and is not intended to constitute legal, tax, accounting, or investment advice. The information, opinions and views contained herein have not been tailored to the objectives of any one individual, are current only as of the date hereof and may be subject to change at any time without prior notice. Residual Token, Inc. does not have any obligation to provide revised opinions in the event of changed circumstances.

All investment strategies and investments involve risk of loss. Nothing contained in this website should be construed as investment advice. Any reference to an investmentā€™s past or potential performance is not, and should not be construed as, a recommendation or as a guarantee of any specific outcome or profit.

Any ideas or strategies discussed herein should not be undertaken by any individual without prior consultation with a finance, tax or legal professional for the purpose of assessing whether the ideas or strategies that are discussed are suitable to you based on your own personal objectives, needs and risk tolerance. Residual Token, Inc. expressly disclaims any liability or loss incurred by any person who acts on the information, ideas or strategies discussed herein.

Hi there Howard,

first of all, thank you so much for creating such an elaborate and throughout proposal!

I would like to reroute you to MIP 20, which deals with the way we submit proposals for mStable. You have kind of jumped the gun there and created a MIP before creating a RFC to gather feedback from the rest of the community and protocol stewards.

Please do submit this as a RFC so we can then move it forward to a MIP as per specification. Iā€™ll close this for now and then merge once it has passed the RFC stage! :sunglasses:

If you got any more questions or issues regarding this, please donā€™t hesitate to reach out to me in our official Discord, and Iā€™ll be happy to help!