How-to

In the following sections we will give some code on how this can be done through a Smart Contract or directly, with a console or with an app. ​

Smart Contract​

To create a new Smart Contract that uses the RIF On Chain platform, you can use any language and IDE you want. In this tutorial, we will show you how to do it using Solidity language, Truffle Framework and NPM. Truffle framework offers some template projects that you can use to develop applications that use smart contracts. You can get more information here. Assuming you already have your project up and running (if you don't, please follow this link) the only extra thing you need to do is to install our repo as a dependency in your NPM project. In order you need to do this you just need to run the following command. ​

npm install --save -E git+https://[e-mail]/money-on-chain/RDOC-Contract.git

Having done that lets you use our contract as a dependency to your contract. For this let's suppose you are doing some kind of contract that when executing a certain task charges a fixed commission. Now let's suppose that the commission is sent in RIFs because it is easier for the user but actually you want some USDRIF. The good news is that you can do this instantly just by redeeming them. The code necessary to do this is actually pretty simple. ​ You just have to import the contract ​

import 'money-on-chain/contracts/MoC.sol';

Receive the address in the constructor in order to be able to interact with it later, and the vendorAccount address needed to do the operation

constructor (MoC _mocContract, address vendorAccount, rest of your params...) {
//....rest of your constructor....
}

//Create a new redeem request
uint256 stableTokenAmount = 90;
moc.redeemStableTokenRequest(stableTokenAmount);

//Add 10 USDRIF to a redeem request.
moc.alterRedeemRequestAmount(true, 10);
//Sustract 5 USDRIF to a redeem request.
moc.alterRedeemRequestAmount(true, 5);

//Trying to redeem All USDRIF.
uint256 docBalance = stableToken.balanceOf(userAddress);
moc.redeemFreeStableTokenVendors(docBalance, vendorAccount);

You can send it immediately to you so you can start using it right away. In order to do this you should add a few more lines similar to the ones before, only that you will have to use the USDRIF token. ​ This will leave you with a contract similar to the following ​​

pragma solidity ^0.5.8;
import "money-on-chain/contracts/MoC.sol";
import "money-on-chain/contracts/token/StableToken.sol";
// Here you will import your own dependencies

contract YourRedeemingRDocContract {
    // Address of the MoC contract
    MoC public moc;
    // Address of the USDRIF token
    StableToken public stableToken;
    // USDRIF Amount
    uint256 stableTokenAmount;
    // Address that will receive the markup
    address public vendorAccount;
    // rest of your variables

    constructor (MoC _moc, StableToken _doc, uint256 _stableTokenAmount, address _vendorAccount) public {
        moc = _moc;
        doc = _doc;
        stableTokenAmount = _stableTokenAmount;
        vendorAccount = _vendorAccount;
        // You could have more variables to initialize here
    }
​
    function createRedeemRequest() public {
        uint256 previousBalance = stableToken.balanceOf(msg.sender);
        moc.redeemStableTokenRequest(stableTokenAmount);
        uint256 newBalance = stableToken.balanceOf(msg.sender);
    }

    function addToRedeemRequest(uint256 _addValue) public {
        moc.alterRedeemRequestAmount(true, stableTokenAmount);
        uint256 newBalance = stableToken.balanceOf(msg.sender);
    }

    function sustractToRedeemRequest(uint256 _addValue) public {
        moc.alterRedeemRequestAmount(false, stableTokenAmount);
        uint256 newBalance = stableToken.balanceOf(msg.sender);
    }

    function redeemFreeStableToken(uint256 _stableTokenAmount) public {
        uint256 previousBalance = stableToken.balanceOf(msg.sender);
        moc.redeemFreeStableTokenVendors(_stableTokenAmount, vendorAccount);
        uint256 newBalance = stableToken.balanceOf(msg.sender);
    }
    // rest of your contract
}​

And that is it, the only thing left to do is to add in the Truffle migrations scripts the address to MoC and StableToken when deploying YourRedeemingRDocContract and you are done.