Skip to content

Using the FAssets Demo Dapp to Mint and Redeem FAssets#

Users of the FAssets system can use the FAssets Demo Dapp with their Bifrost wallet to mint and redeem FAssets, which allow tokens on blockchains that do not support smart contracts to be used trustlessly with smart contracts on the Flare blockchain. Alternatively, you can use the command line to mint and redeem FAssets.

In this guide you will deposit some test XRP tokens into an XRP account and use the FAssets system to mint them into FTestXRP FAsset tokens on the Coston network. You will receive these tokens in a Coston account.

Open Beta

The FAssets system is currently in the Open Beta period. During this phase, user-friendly tools are still being developed.

Some web browsers and ad blockers might prevent this functionality.

Alternatively, you can contact support@flarelabs.org.

Prerequisites#

  • A computer and a mobile device.
  • The latest version of Bifrost Wallet installed on your mobile device and a wallet address created. Be sure to store your seed phrase somewhere very safe. For more information about securing your Flare experience, read this summary.

1. Activate Developer Mode in Your Bifrost Wallet#

To access test networks in Bifrost Wallet, you need to activate Developer Mode.

  1. Open your wallet, and click the cog icon displayed in the bottom-right corner of the screen to open the Settings menu.
  2. Click Advanced, then click the Developer Mode switch.

    Developer Mode
    Developer Mode.

  3. Click Enable to activate Developer Mode.

2. Get Your Addresses for Testnet Tokens#

To mint FAssets on the Coston network, you will need testnet tokens. Before you can use faucets to get the tokens, you must get from Bifrost the addresses of the accounts on the XRP and Coston networks that you will use later in this guide.

  1. Return to the Settings menu, click the upward arrow button, and then click Receive.

    Receive Token
    Choose to Receive a Token.

  2. In the Search coin field, type XRP, and select XRP in the results list.

    Receive XRP
    Choose to Receive XRP.

    Your XRPL testnet address is displayed as a QR code and a string of letters and numbers.

  3. Tap the string of letters and numbers below the QR code to copy your XRPL address, and paste it in a text file so that you can use it in later steps.

    XRPL Address
    Copy Your XRPL Address.

  4. Return to the Receive menu, type CFLR in the search field, and then select Coston Flare in the results list.

    Receive CFLR
    Choose to Receive CFLR.

    Your CFLR testnet address is displayed as a QR code and a string of letters and numbers.

  5. Tap the string of letters and numbers below the QR code to copy your CFLR address, and paste it in a text file so that you can use it in later steps.

    CFLR Address
    Copy Your CFLR Address.

3. Get Testnet Tokens#

You will need the addresses you copied in the previous step to get the testnet tokens. Testnet tokens are free and have no monetary value.

  1. On your computer, open the FAssets Demo Dapp.
  2. On the home page, click Get Your textXRP here. The XRPL Testnet Faucet page is displayed.
  3. Copy the XRPL address that you saved in Step 3 above, and paste it in the XRPL address field on the faucet page. The XRP address is the address that does not start with 0x.
  4. In the XRP (Testnet) field, select 1000 XRP.
  5. Select the checkbox.
  6. Click Send me XRP. TestXRP tokens are sent to your Bifrost Wallet.

    XRPL Faucet
    XRP Testnet Faucet page.

  7. Return to the FAssets Demo Dapp home page, and click Get Your CFLR here. The Official Flare Faucet page is displayed.

    Flare Faucet
    Official Flare Faucet page.

  8. Copy the CFLR address that you saved in Step 3 above, and paste it in the Flare address field on the faucet page. The Coston address is the address that starts with 0x.

  9. Click Request CFLR. 100 CFLR are sent to your Bifrost Wallet.

  10. In your Bifrost Wallet, review your updated balances of testXRP and CFLR.

    Token Balances
    Testnet Token Balances.

4. Connect Your Bifrost Wallet to the FAssets Demo Dapp#

  1. On your computer, open the FAssets Demo Dapp, click the Connect Bifrost Wallet button near the middle fo the page, and click Wallet Connect. A QR code is displayed.
  2. In Bifrost Wallet on your mobile device, click the blue arrow in the navigation bar, and select Connect.

    Connect Bifrost
    Connect Bifrost.

    Your camera application is activated.

  3. In your camera application, align the QR code displayed in Step 1 until the application detects it. Bifrost Wallet prompts you to connect.

    Confirm Connection
    Confirm Connection.

  4. Click Connect. The dapp is connected to your Bifrost Wallet. A confirmation dialog is displayed, and the FAssets Demo Dapp shows the balances of the two accounts.

5. Mint FTestXRP#

  1. In the FAssets Demo Dapp, locate the FAssets section on the page, and click Mint beside FTestXRP.

    Mint FTestXRP
    Mint FTestXRP.

  2. In the Lots field, specify how many lots of FTestXRP you want to mint. To help the FAssets system, split the total into multiple transactions made over several days.

    Lots
    Lots.

  3. Click Next. The minting process begins. In Bifrost Wallet, a confirmation prompt for the collateral reservation is displayed, which shows the number of lots you specified and the minting fee.

    Confirmation
    Confirm the Collateral Reservation.

  4. Click Confirm and input either your PIN or your biometrics, depending on the way you set up your wallet. The collateral is reserved, the CFLR is sent to the FAssets contract, and another confirmation prompt is displayed (Step 2 of this process).

    Confirmation
    Approve the Transaction.

  5. Click Confirm and input either your PIN or your biometrics, depending on the way you set up your wallet. The transaction is approved. The Data Connector trustlessly proves that you, via the FAssets Demo Dapp, sent the right amount of testXRP to the correct address with the correct reference. This process for the Data Connector to come to consensus and provide the FAssets system with a proof that this has occurred takes approximately 5 minutes. Progress through the four stages of processing the mint is displayed.

    Mint Progress
    Example of a Mint Progress Window.

    After the proof is received, the FTestXRP is minted, and the balance is displayed in your Bifrost Wallet.

    Mint Progress
    Example of a Mint Progress Window.

5. Redeem FTestXRP#

You can follow a similar process to redeem your FTestXRP and receive your original testXRP back in your wallet. During this open beta phase, if you run out of testXRP or Coston Flare, you can always head back to the faucets to get more. Each address can obtain a maximum of 1000 testXRP and 100 CFLR per day.

FTestXRP is a regular ERC-20 token on the Coston network, so you can send it or receive it using standard tools, and the receiver can use the redeeming process described here to get the testXRP back.

Warning

Remember to keep a small amount of CFLR for gas.