Proposal: RIF On Chain V2 → V3 Upgrade (Multi-Collateral Support)

Overview

This proposal introduces an upgrade of the RIF On Chain (RoC) protocol from version V2 to version V3.

The main objective of this upgrade is to extend the collateral model by introducing multi-collateral support, allowing the protocol to use both:

  • RIF token (existing collateral)
  • DOC token (new collateral)

This enhancement strengthens the robustness and scalability of the system while preserving all existing business logic and protocol guarantees.

A coordinated dApp update will also be executed after governance approval.


Problem Statement

RIF plays a central role in the protocol as the primary collateral backing USDRIF, directly linking the stablecoin’s growth to the expansion of the ecosystem while enabling yield generation for long-term holders.

As adoption increases, demand for USDRIF and the availability of RIF for collateralisation may diverge. This creates a dependency on a single asset that can limit the protocol’s ability to scale supply efficiently in line with market demand.

Expanding the collateral base with additional assets such as DOC—a rBTC-backed stablecoin—introduces greater flexibility and resilience into the system. This approach reinforces RIF’s role at the core of the protocol while complementing it with external sources of liquidity, enabling more consistent scaling of USDRIF, improved market responsiveness, and a more seamless and transparent user experience


Proposed Changes

1. Multi-Collateral Support

The protocol will evolve from a single-collateral model (RIF-only) to a dual-collateral model (RIF + DOC).

  • A new collateral bucket based on DOC will be introduced
  • Both collateral types will jointly support a single USDRIF supply
  • The system will manage collateral through coordinated structures (buckets)

As described in the V3 whitepaper, this architecture allows:

  • RIF to absorb volatility and provide growth potential
  • DOC to provide stability and capital efficiency

2. Improved Stability Model

The addition of DOC introduces a stable collateral component, which:

  • Reduces reliance on RIF price dynamics
  • Allows safer expansion of USDRIF supply
  • Improves resilience during market stress

The system introduces mechanisms such as a Multi-Collateral Guard, which:

  • Coordinates collateral across buckets
  • Redistributes risk when one collateral becomes stressed

3. No Funds Migration Required

This upgrade does not require users to migrate funds.

Instead:

  • Existing contracts will remain in place
  • The upgrade will be executed through proxy contract upgrades
  • New collateral integrations will be added at the protocol level

This ensures:

  • Seamless transition for users
  • No disruption of existing positions
  • No need for manual interaction

4. No Changes to Business Logic

This upgrade does not modify any existing protocol rules:

  • Minting and redemption logic remains unchanged
  • Collateralization rules remain unchanged
  • Fee structure remains unchanged

The upgrade only adds new capabilities by introducing an additional collateral option.


5. dApp Upgrade

A coordinated dApp update will be performed after governance approval.

  • The dApp will enter maintenance mode temporarily
  • The protocol itself will remain fully operational
  • Users will not lose access to funds or protocol functionality

6. Governance Process

As with all protocol-level changes, this proposal will be submitted to a governance vote.

The upgrade will be executed only after:

  1. Proposal approval through governance
  2. Deployment of the changer contract
  3. Execution of the upgrade transaction

Technical Procedure

:warning:Warning: Some technical knowledge is required to fully understand this section.

The upgrade will be executed through a changer contract, which will:

  • Configure new collateral structures
  • Register new contracts
  • Update protocol references

Changer Contract

The changer contract to vote would be:

Name Address (and link to verified code in RSK blockscout explorer)
MultiCollateralUpgradeChanger 0x839228759C6640BB486a05c11b6A81166D8A9DC7

Existing Contracts to be Upgraded or Reconfigured

The following contracts are already part of the protocol and will be upgraded or reconfigured as part of this proposal:

Name Description Address
MocRif Proxy (RIF Bucket) Main contract handling the RIF collateral bucket (to be upgraded via proxy) 0xA270...A36A
USDRIF Proxy Stablecoin contract implementation (to be upgraded via proxy) 0x3A15...6e37
Legacy MocQueue (RIF Bucket) Existing queue contract used by the RIF bucket (state will be migrated) 0x9181...A9E3

New Contracts and Implementations

The upgrade introduces new implementations and contracts required to support multi-collateral functionality:

Name Description Address
MocRif Implementation (V3) New implementation for the RIF bucket logic 0x1a27...eC54
USDRIF Implementation (V3) Updated implementation for the USDRIF token 0x6D1B...5af9
MocCoreExpansion Implementation Extension contract enabling new protocol capabilities 0xd6a1...4207
New MocQueue Proxy (RIF Bucket) New queue contract using updated time-based logic 0x47f5...3Bf1
New Price Provider Updated price provider for USDRIF 0x6a5b...CC14
DOC Bucket (MocCARC20) New bucket contract enabling DOC as collateral 0x6975...4661
RIF/DOC MocSwapper Swapper contract enabling interaction between RIF and DOC collateral 0x0E60...7ba0
MocMultiCollateralGuard Proxy Core contract coordinating collateral across buckets 0x0237...F46F
MocMultiCollateralGuard Impl. Core contract coordinating collateral across buckets 0xC36D...3EBd

Additional Technical Notes

  • The USDRIF token will be extended to support minting and redemption from both:

    • RIF Bucket
    • DOC Bucket
  • The MocMultiCollateralGuard will be updated to:

    • Register the new DOC Bucket
    • Coordinate collateral between both buckets
  • The queue mechanism for the RIF bucket will be upgraded:

    • Migrating from block-based logic to timestamp-based logic
    • Preserving existing queue state (operation IDs)
  • No contracts are removed as part of this upgrade. Existing infrastructure is extended.

  • No user funds are migrated. All changes are executed through proxy upgrades and contract reconfiguration.

References


Summary

This proposal upgrades RIF On Chain to a multi-collateral protocol, enabling:

  • Increased stability through DOC collateral
  • Greater scalability of USDRIF issuance
  • Improved resilience under market stress
  • Seamless upgrade without fund migration
  • No changes to existing protocol rules

The upgrade represents a natural evolution of the protocol, expanding its capabilities while preserving its core design principles.

User Experience Improvements

In addition to the protocol-level enhancements, this upgrade introduces several improvements aimed at enhancing the overall user experience.

1. Updated and More Usable dApp

A new version of the dApp will be released alongside this upgrade, providing:

  • Improved interface and navigation
  • Better visualization of positions and collateral distribution
  • Clearer representation of multi-collateral interactions
  • Enhanced performance and responsiveness

This update makes the protocol more accessible to both new and existing users.


2. Support for Multiple Collateral Options

Users will be able to choose between different collateral types (RIF and DOC) when interacting with the protocol.

This provides:

  • Greater flexibility in risk management
  • Ability to select between volatile and stable collateral
  • More efficient capital allocation depending on market conditions

3. Joint Operations

The protocol maintains and improves support for joint operations, allowing users to perform combined actions in a single transaction.

Examples include:

  • Minting USDRIF together with collateral tokens when required to maintain coverage
  • Redeeming collateral tokens together with USDRIF to unlock positions
  • Combined operations that simplify user flows under constrained conditions

These operations reduce friction and improve capital efficiency.

:mega: Call to MOC holders: This proposal is being voted on. How to vote Tutorial. Use the voting site.

:mega: Llamado a los MOC holders: Esta propuesta se está votando. Tutorial de cómo votar. Usar el sitio de voto.

:mega: The voting process is over:

  • 29% of the MOC tokens total supply participated in the vote.
  • 100% voted in favor.
  • No one vote voted against the proposal.
  • The change was successfully implemented.

TX ID: 0x0xb59dd3c0400fad040f6ca5adebf64a99c81cd6946840adc1ff345755ef380e8b