Using the Command Line to Mint and Redeem FAssets#

Users of the FAssets system can mint and redeem FAssets, allowing tokens on blockchains that do not support smart contracts to be used trustlessly with smart contracts on the Flare blockchain.

This guide provides the following information:

• How to set up the FAssets command-line tool.
• How to convert testnet XRP to FAssets (FTestXRP) on the Flare test network (minting).
• How to convert FAssets (FTestXRP) from Flare test network back to testnet XRP Ledger network (redemption).

Prerequisites#

To participate in the open beta, you need a server with at least a minimum of 2 CPUs and 4GB RAM, or 2GB if the database is on a separate server.

You will need knowledge of the following tools:

• Git version control system;
• Yarn package manager;
• Command line terminal;
• Code editor.

Setting up the FAssets tools#

Clone and Setup the Tools Repository#

1. Clone the repository and enter the working directory:

   git clone https://github.com/flare-labs-ltd/fasset-bots.git
   cd fasset-bots
   

2. Switch to the open_beta branch:

   git checkout open_beta
   

3. Install dependencies and build the project:

   yarn && yarn build
   

   Info

   Fresh installation can take more than 10 minutes, depending on if you have cached dependencies before.

4. Copy the environment file from a template .env.template to .env:

   cp .env.template .env
   

Configure User's Access Keys#

The FAsset user operates with multiple keys for the Flare and underlying network chains.

1. Generate the user's secrets using this command:

   yarn key-gen generateSecrets --user -o secrets.json
   

   Among other things, this command creates wallets on the XRP Ledger and Flare networks that you will use throughout the rest of this guide.

   Info

   This command can only be executed once, after which all secret keys will be generated. You must use a separate directory for each role you want to perform: agent, bot, or minter and redeemer.

   Warning

   The addresses in secrets.json are designed to be used as hot wallets and should not hold large amounts of tokens, since their private keys are accessible on a machine that is permanently online. Instead, it's best to keep your main account in an offline wallet and transfer funds to these hot wallets as needed.

2. Fund the user's FLR wallet with some CFLR to pay the gas fees. You can find the user wallet's address in the secrets.json file under the user.native.address key. You can get the CFLR tokens from the Flare faucet.

3. Prevent other users from reading the secrets.json file:

   chmod 600 secrets.json
   

4. Fill the native_rpc, xrp_rpc and indexer fields in the secrets.json file with the following values:

   "native_rpc": "AavSehMLhcgz3crQHH5YJ3Rt8GMQGdV9aViGilADXGnTcjij",
   "xrp_rpc": "4tg3AxysaZodxTqsCtcMnBdBIEkR6KDKGTdqBEA8g9MKq4bH",
   "indexer": "123456",
   

   Info

   These values apply only to the Coston Testnet and will be different for other networks.

Minting FAssets#

1. Use the command below to list all available agents and their minting fees. Then chose one.

   yarn user-bot --fasset FTestXRP agents
   

2. Use this command to determine the FAssets lot size, since you will need it next:

   yarn user-bot info -f FTestXRP
   

   You need to find the line in the command output that displays the lot size in this format:

   Lot size: 20 FTestXRP
   

3. Find your generated XRP Ledger testnet wallet address in user.testXRP.address from the secrets.json file you created above, and fund it using one of the faucets:

   • XRP Testnet Faucet
   • XRP Ledger Faucet

   Info

   The minimum amount of FAssets you can mint is one lot, determined by the previous command. Furthermore, agents charge a fee, and you should pay for a transaction on the XRP network. Once you have selected an agent and know its fee, request enough XRP from the faucet to pay for it, plus the transaction cost.

4. Mint the FTestXRP FAssets by running the following command, replacing AGENT_ADDRESS with an agent address from the list obtained before, and LOTS with the number of lots to mint:

   yarn user-bot mint -a AGENT_ADDRESS LOTS --fasset FTestXRP --secrets secrets.json
   

   Alternatively, you can rely on the FAssets system to automatically select the agent with the lowest fee by removing the -a AGENT_ADDRESS parameter from the previous command:

   yarn user-bot mint LOTS --fasset FTestXRP --secrets secrets.json
   

Redeeming FAssets#

Redeem the FTestXRP for the underlying asset obtained in the previous step by running the following command and replacing LOTS with the number of lots you want to redeem:

yarn user-bot redeem LOTS --fasset FTestXRP --secrets secrets.json

Related Pages#

• Deploying an FAssets Agent
• FAssets Open Beta