Developer Guides

Step-by-step guides for integrating and building with the FAssets system on Flare.

Getting Started

Essential guides to begin working with FAssets.

Get Asset Manager Address

Get FXRP asset manager address from registry

Read FAssets Settings (Solidity)

Fetch FAsset Lot Size and Value in USD (via FTSO)

Read FAssets Settings (Node.js)

Fetch FAsset Lot Size and Value in USD (via FTSO)

Minting FAssets

Guides for minting FAssets from underlying assets.

New

Direct Mint FXRP

Mint FXRP in a single XRPL payment using direct minting.

New

Direct Mint FXRP with Tag

Mint FXRP using a reserved XRPL destination tag.

New

Check Direct Minting Limits

Read the live hourly and daily direct-minting rate limits and compute the maximum mint that fits both windows.

New

Transfer a Minting Tag

Transfer an existing minting tag NFT to another owner.

Redeeming FAssets

Guides for redeeming FAssets back to underlying assets.

New

Redeem FXRP by Amount

Redeem any amount of FXRP without rounding to whole lots.

New

Redeem FXRP with Tag

Redeem any amount of FXRP and require an XRPL destination tag on the agent's payment.

Redeem FAssets

Learn how to redeem FAssets

Swap and Redeem FAssets

Learn how to swap and redeem FAssets

Redemption Defaults

Monitor and handle redemption scenarios

Redemption Queue

Learn how to get the redemption queue

FAsset Auto-Redemption

Auto-redeem FAssets to native XRP cross-chain

FXRP Token Interactions

Guides for interacting with FXRP token. See also the FXRP overview page for more FXRP resources.

Get FXRP Token Address

Get FXRP address using the FAssets system

Swap USDT0 to FXRP

Swap USDT0 to FXRP using Uniswap V3 router

Agent Information

Guides for reading and working with agent data.

List FAssets Agents

Learn how to get a list of FAssets agents

Read FAssets Agent Details

Learn how to read FAssets agent details

What's next

• Explore FXRP and discover what you can do with the FAsset representation of XRP.
• Read the FAssets overview to understand how the system works.
• Learn how to earn yield on your FXRP with Firelight Vaults.

Reference application

The fassets-demo-dapp repository is a Next.js app that implements settings, mint, tags, transfer, and redeem on Coston2 using Wagmi, Viem, and the @flarenetwork/flare-wagmi-periphery-package. Use it alongside flare-viem-starter repository for scripted examples. A deployed instance is available on Coston2 for reference.