Obligation receipts and how to transfer borrower rights on NFTfi

NFTfi.com
4 min readDec 2, 2022

--

An obligation receipt allows its holder to exercise the right to get the NFT asset back once the loan is repaid, and borrowers can now transfer or sell it.

Please note: This feature is not yet officially supported. Users use the below instructions at their own risk. NFTfi will not provide any (e.g. Discord) user support/guidance related to obligation receipts!

What is an obligation receipt?

When a borrower takes out a loan on NFTfi, they must put down their NFT as collateral. Borrowers receive the loan principal from lenders, and lenders get promissory notes, giving them the right to receive the respective loan collateral NFTs in case of a loan default. The counterpart to the lender’s promissory notes are called obligation receipts — and govern borrower rights. Borrowers (specifically: the wallet they took out the loan with) have the right to get their collateral NFTs back upon full repayment of the loan principal plus interest. If a borrower wants to transfer this right to a new wallet or sell it to someone else — e.g. if he can’t repay the loan but wants to avoid default and monetize at least some of the collateral’s surplus value — he can now do so by optionally minting an ERC-721 obligation receipt NFT.

How to mint an obligation receipt?

To transfer the borrower’s rights to a new wallet, one must manually mint an obligation receipt on an active loan and then transfer this newly minted NFT to the new wallet. The obligation receipt will then allow its new holder to receive the collateralized NFT upon loan repayment from that wallet.

It does get a bit geeky here, but this is how to mint an obligation receipt:

Get the “loanId” of the loan:

  • Navigate to https://app.nftfi.com/ and open the asset page (an asset that is in escrow).
  • Open browser dev tools (press F12 on Chrome), navigate to the “Network” tab, and then refresh the page.
  • Find the “loanId” value in the JSON response of “/latest” network call, and take note of the “contractName” which will come in handy in the next step.

Mint the obligation receipt on Etherscan:

  • Navigate to the relevant NFTfi smart contract on Etherscan by choosing the correct smart contract:

“V2.loan.fixed-xxx” — for loans started before October 21, 2022: https://etherscan.io/address/0xf896527c49b44aab3cf22ae356fa3af8e331f280

“V2–1.loan.fixed-xxx” — for loans started on or after October 21, 2022:
https://etherscan.io/address/0x8252df1d8b29057d1afe3062bf5a64d503152bc8

“v2.loan.fixed.collection” — for loans started using a Standing Collection Offer: https://etherscan.io/address/0xe52cec0e90115abeb3304baa36bc2655731f7934

  • Ensure your Web3 wallet is connected.
  • Choose the “Contract” tab, then click “Write contract” below, and then select the “mintObligationReceipt” option.
  • Enter the “loanId” you got in step 1.
  • A MetaMask (if you are not using MetaMask, some other wallet) window will pop up. Accepting the pop-up will initiate the contract interaction and mint the obligation receipt. Once the transaction is complete, the Etherscan page will prompt you to “View your transaction.”
  • Click “View your transaction” and save the tokenId (see image below), which you’ll need in the next step.

How to transfer the newly minted obligation receipt?

Transfer the newly minted obligation receipt to a new wallet:

  • Navigate to the NFTfi Obligation Receipt contract on Etherscan:

https://etherscan.io/token/0xe73ECe5988FfF33a012CEA8BB6Fd5B27679fC481#writeContract

  • Choose the “Contract” tab, then click “Write contract,” and then select the “safeTransferFrom” option (7).
  • Insert the following into the respective fields: “From” wallet address, “To” wallet address, and tokenId (as shown in the previous section).
  • Click the “Write” button, and you will initiate the transaction.

Et voilà, the new holder wallet of the obligation receipt will now be able to pay back the loan and receive the loan collateral!

How to repay the loan (if holding an obligation receipt) via Etherscan?

Currently, our dApp UI does not support repaying the loan with the obligation receipt, so the holder of the obligation receipt must use Etherscan.

Here is the process for repaying the loan via Etherscan:

If you have any questions, don’t hesitate to reach out in the #support channel in our Discord, and make sure you follow us on Twitter for updates.

nftfi.com | Discord | Twitter | Join the Ambassador program

--

--

NFTfi.com

A simple marketplace for NFT collateralized loans. Put your own NFTs up as collateral for a loan, or offer loans to other users on their non-fungible tokens.