Merge branch 'main' into ftso-risks2

dineshpinto · web-flow · commit 13627aac95b5 · 2026-01-19T13:28:04.000+04:00
diff --git a/docs/fassets/1-overview.mdx b/docs/fassets/1-overview.mdx
@@ -132,6 +132,6 @@ Movements of funds require multiple signatures and follow formal agreements, not
 
 Learn more about the different components and processes involved in FAssets - [collateral](/fassets/collateral), [minting](/fassets/minting), [redemptions](/fassets/redemption), [liquidations](/fassets/liquidation) and [Core Vault](/fassets/core-vault).
 
-For developer resources, explore our [FXRP address](/fassets/developer-guides/fassets-fxrp-address), [minting](/fassets/developer-guides/fassets-mint), and [redemption](/fassets/developer-guides/fassets-redeem) guides to get started with FAssets integration.
+For developer resources, explore our [FXRP address](/fxrp/token-interactions/fxrp-address), [minting](/fassets/developer-guides/fassets-mint), and [redemption](/fassets/developer-guides/fassets-redeem) guides to get started with FAssets integration.
 
 :::
diff --git a/docs/fassets/2-minting.mdx b/docs/fassets/2-minting.mdx
@@ -335,6 +335,6 @@ Additionally, when agents create a vault, they can choose not to make it public,
 
 Learn more about the different components and processes involved in FAssets - [collateral](/fassets/collateral), [redemptions](/fassets/redemption), [liquidations](/fassets/liquidation) and [Core Vault](/fassets/core-vault).
 
-For developer resources, explore our [FXRP address](/fassets/developer-guides/fassets-fxrp-address), [minting](/fassets/developer-guides/fassets-mint), and [redemption](/fassets/developer-guides/fassets-redeem) guides to get started with FAssets integration.
+For developer resources, explore our [FXRP address](/fxrp/token-interactions/fxrp-address), [minting](/fassets/developer-guides/fassets-mint), and [redemption](/fassets/developer-guides/fassets-redeem) guides to get started with FAssets integration.
 
 :::
diff --git a/docs/fassets/3-redemption.mdx b/docs/fassets/3-redemption.mdx
@@ -158,6 +158,6 @@ The self-redeemed amount is not limited to a positive integer of lots and can be
 
 Learn more about the different components and processes involved in FAssets - [collateral](/fassets/collateral), [minting](/fassets/minting), [liquidations](/fassets/liquidation), and [Core Vault](/fassets/core-vault).
 
-For developer resources, explore our [FXRP address](/fassets/developer-guides/fassets-fxrp-address), [minting](/fassets/developer-guides/fassets-mint), and [redemption](/fassets/developer-guides/fassets-redeem) guides to get started with FAssets integration.
+For developer resources, explore our [FXRP address](/fxrp/token-interactions/fxrp-address), [minting](/fassets/developer-guides/fassets-mint), and [redemption](/fassets/developer-guides/fassets-redeem) guides to get started with FAssets integration.
 
 :::
diff --git a/docs/fassets/4-collateral.mdx b/docs/fassets/4-collateral.mdx
@@ -451,6 +451,6 @@ To reduce the likelihood of liquidations because the pool collateral is too low,
 
 Learn more about the different components and processes involved in FAssets - [minting](/fassets/minting), [redemptions](/fassets/redemption), [liquidations](/fassets/liquidation) and [Core Vault](/fassets/core-vault).
 
-For developer resources, explore our [FXRP address](/fassets/developer-guides/fassets-fxrp-address), [minting](/fassets/developer-guides/fassets-mint), and [redemption](/fassets/developer-guides/fassets-redeem) guides to get started with FAssets integration.
+For developer resources, explore our [FXRP address](/fxrp/token-interactions/fxrp-address), [minting](/fassets/developer-guides/fassets-mint), and [redemption](/fassets/developer-guides/fassets-redeem) guides to get started with FAssets integration.
 
 :::
diff --git a/docs/fassets/5-core-vault.mdx b/docs/fassets/5-core-vault.mdx
@@ -195,6 +195,6 @@ It is the key to making cross-chain assets on Flare both **secure** and **effici
 
 Learn more about the different components and processes involved in FAssets - [collateral](/fassets/collateral), [minting](/fassets/minting), [redemptions](/fassets/redemption) and [liquidations](/fassets/liquidation).
 
-For developer resources, explore our [FXRP address](/fassets/developer-guides/fassets-fxrp-address), [minting](/fassets/developer-guides/fassets-mint), and [redemption](/fassets/developer-guides/fassets-redeem) guides to get started with FAssets integration.
+For developer resources, explore our [FXRP address](/fxrp/token-interactions/fxrp-address), [minting](/fassets/developer-guides/fassets-mint), and [redemption](/fassets/developer-guides/fassets-redeem) guides to get started with FAssets integration.
 
 :::
diff --git a/docs/fassets/6-liquidation.mdx b/docs/fassets/6-liquidation.mdx
@@ -335,6 +335,6 @@ They become unusable until the lock expires, and then they can be closed.
 
 Learn more about the different components and processes involved in FAssets - [collateral](/fassets/collateral), [minting](/fassets/minting), [redemptions](/fassets/redemption) and [Core Vault](/fassets/core-vault).
 
-For developer resources, explore our [FXRP address](/fassets/developer-guides/fassets-fxrp-address), [minting](/fassets/developer-guides/fassets-mint), and [redemption](/fassets/developer-guides/fassets-redeem) guides to get started with FAssets integration.
+For developer resources, explore our [FXRP address](/fxrp/token-interactions/fxrp-address), [minting](/fassets/developer-guides/fassets-mint), and [redemption](/fassets/developer-guides/fassets-redeem) guides to get started with FAssets integration.
 
 :::
diff --git a/docs/fassets/7-emergency-pause.mdx b/docs/fassets/7-emergency-pause.mdx
@@ -73,6 +73,6 @@ The system can respond appropriately to various types of threats while maintaini
 
 Learn more about the different components and processes involved in FAssets - [collateral](/fassets/collateral), [minting](/fassets/minting), [redemptions](/fassets/redemption), [liquidations](/fassets/liquidation) and [Core Vault](/fassets/core-vault).
 
-For developer resources, explore our [FXRP address](/fassets/developer-guides/fassets-fxrp-address), [minting](/fassets/developer-guides/fassets-mint), and [redemption](/fassets/developer-guides/fassets-redeem) guides to get started with FAssets integration.
+For developer resources, explore our [FXRP address](/fxrp/token-interactions/fxrp-address), [minting](/fassets/developer-guides/fassets-mint), and [redemption](/fassets/developer-guides/fassets-redeem) guides to get started with FAssets integration.
 
 :::
diff --git a/docs/fassets/8-operational-parameters.mdx b/docs/fassets/8-operational-parameters.mdx
@@ -66,6 +66,6 @@ To get the Core Vault settings you need to use the [`IAssetManager`](/fassets/re
 
 Learn more about the different components and processes involved in FAssets - [collateral](/fassets/collateral), [minting](/fassets/minting), [redemptions](/fassets/redemption), [liquidations](/fassets/liquidation) and [Core Vault](/fassets/core-vault).
 
-For developer resources, explore our [FXRP address](/fassets/developer-guides/fassets-fxrp-address), [minting](/fassets/developer-guides/fassets-mint), and [redemption](/fassets/developer-guides/fassets-redeem) guides to get started with FAssets integration.
+For developer resources, explore our [FXRP address](/fxrp/token-interactions/fxrp-address), [minting](/fassets/developer-guides/fassets-mint), and [redemption](/fassets/developer-guides/fassets-redeem) guides to get started with FAssets integration.
 
 :::
diff --git a/docs/fassets/developer-guides.mdx b/docs/fassets/developer-guides.mdx
@@ -99,20 +99,21 @@ Guides for [redeeming FAssets](/fassets/redemption) back to underlying assets.
 ## FXRP Token Interactions
 
 Guides for interacting with FXRP token.
+See also the [FXRP overview page](/fxrp/overview) for more FXRP resources.
 
 <DocCardList
   items={[
     {
       type: "link",
       label: "Get FXRP Token Address",
-      href: "/fassets/developer-guides/fassets-fxrp-address",
-      docId: "fassets/developer-guides/fassets-fxrp-address",
+      href: "/fxrp/token-interactions/fxrp-address",
+      docId: "fxrp/token-interactions/fxrp-address",
     },
     {
       type: "link",
       label: "Swap USDT0 to FXRP",
-      href: "/fassets/developer-guides/usdt0-fxrp-swap",
-      docId: "fassets/developer-guides/usdt0-fxrp-swap",
+      href: "/fxrp/token-interactions/usdt0-fxrp-swap",
+      docId: "fxrp/token-interactions/usdt0-fxrp-swap",
     },
   ]}
 />
@@ -137,3 +138,11 @@ Guides for reading and working with agent data.
     },
   ]}
 />
+
+:::tip[What's next]
+
+- Explore [FXRP](/fxrp/overview) and discover what you can do with the FAsset representation of XRP.
+- Read the [FAssets overview](/fassets/overview) to understand how the system works.
+- Learn how to earn yield on your FXRP with [Firelight Vaults](/fxrp/firelight).
+
+:::
diff --git a/docs/fxrp/firelight/01-status.mdx b/docs/fxrp/firelight/01-status.mdx
@@ -98,10 +98,10 @@ In this guide, you learned how to retrieve status information from a Firelight v
 
 To continue your Firelight development journey, you can:
 
-- Learn how to [deposit assets into a Firelight vault](/fassets/firelight/deposit).
-- Learn how to [mint Firelight vault shares](/fassets/firelight/mint) by specifying the number of shares.
-- Learn how to [withdraw assets from a Firelight vault](/fassets/firelight/withdraw).
-- Learn how to [redeem assets from a Firelight vault](/fassets/firelight/redeem).
+- Learn how to [deposit assets into a Firelight vault](/fxrp/firelight/deposit).
+- Learn how to [mint Firelight vault shares](/fxrp/firelight/mint) by specifying the number of shares.
+- Learn how to [withdraw assets from a Firelight vault](/fxrp/firelight/withdraw).
+- Learn how to [redeem assets from a Firelight vault](/fxrp/firelight/redeem).
 - Explore the [FAssets system overview](/fassets/overview) to understand the broader ecosystem.
 
 :::
diff --git a/docs/fxrp/firelight/02-deposit.mdx b/docs/fxrp/firelight/02-deposit.mdx
@@ -91,10 +91,10 @@ In this guide, you learned how to deposit assets into a Firelight vault by speci
 
 To continue your Firelight development journey, you can:
 
-- Learn how to [get Firelight vault status](/fassets/firelight/status) to monitor your position.
-- Learn how to [mint Firelight vault shares](/fassets/firelight/mint) by specifying the number of shares.
-- Learn how to [withdraw assets from a Firelight vault](/fassets/firelight/withdraw).
-- Learn how to [redeem assets from a Firelight vault](/fassets/firelight/redeem).
+- Learn how to [get Firelight vault status](/fxrp/firelight/status) to monitor your position.
+- Learn how to [mint Firelight vault shares](/fxrp/firelight/mint) by specifying the number of shares.
+- Learn how to [withdraw assets from a Firelight vault](/fxrp/firelight/withdraw).
+- Learn how to [redeem assets from a Firelight vault](/fxrp/firelight/redeem).
 - Explore the [FAssets system overview](/fassets/overview) to understand the broader ecosystem.
 
 :::
diff --git a/docs/fxrp/firelight/03-mint.mdx b/docs/fxrp/firelight/03-mint.mdx
@@ -93,10 +93,10 @@ In this guide, you learned how to mint vault shares in a Firelight vault by spec
 
 To continue your Firelight development journey, you can:
 
-- Learn how to [get Firelight vault status](/fassets/firelight/status) to monitor your position.
-- Learn how to [deposit assets into a Firelight vault](/fassets/firelight/deposit) by specifying the amount of assets to deposit.
-- Learn how to [withdraw assets from a Firelight vault](/fassets/firelight/withdraw).
-- Learn how to [redeem assets from a Firelight vault](/fassets/firelight/redeem).
+- Learn how to [get Firelight vault status](/fxrp/firelight/status) to monitor your position.
+- Learn how to [deposit assets into a Firelight vault](/fxrp/firelight/deposit) by specifying the amount of assets to deposit.
+- Learn how to [withdraw assets from a Firelight vault](/fxrp/firelight/withdraw).
+- Learn how to [redeem assets from a Firelight vault](/fxrp/firelight/redeem).
 - Explore the [FAssets system overview](/fassets/overview) to understand the broader ecosystem.
 
 :::
diff --git a/docs/fxrp/firelight/04-withdraw.mdx b/docs/fxrp/firelight/04-withdraw.mdx
@@ -103,10 +103,10 @@ Remember that withdrawals are delayed and must be claimed after the current peri
 
 To continue your Firelight development journey, you can:
 
-- Learn how to [get Firelight vault status](/fassets/firelight/status) to monitor your withdrawal requests.
-- Learn how to [redeem assets from a Firelight vault](/fassets/firelight/redeem) by specifying the number of shares.
-- Learn how to [deposit assets into a Firelight vault](/fassets/firelight/deposit).
-- Learn how to [mint Firelight vault shares](/fassets/firelight/mint) by specifying the number of shares.
+- Learn how to [get Firelight vault status](/fxrp/firelight/status) to monitor your withdrawal requests.
+- Learn how to [redeem assets from a Firelight vault](/fxrp/firelight/redeem) by specifying the number of shares.
+- Learn how to [deposit assets into a Firelight vault](/fxrp/firelight/deposit).
+- Learn how to [mint Firelight vault shares](/fxrp/firelight/mint) by specifying the number of shares.
 - Explore the [FAssets system overview](/fassets/overview) to understand the broader ecosystem.
 
 :::
diff --git a/docs/fxrp/firelight/05-redeem.mdx b/docs/fxrp/firelight/05-redeem.mdx
@@ -103,10 +103,10 @@ Remember that redemptions are delayed and must be claimed after the current peri
 
 To continue your Firelight development journey, you can:
 
-- Learn how to [get Firelight vault status](/fassets/firelight/status) to monitor your redemption requests.
-- Learn how to [withdraw assets from a Firelight vault](/fassets/firelight/withdraw) by specifying the amount of assets.
-- Learn how to [deposit assets into a Firelight vault](/fassets/firelight/deposit).
-- Learn how to [mint Firelight vault shares](/fassets/firelight/mint) by specifying the number of shares.
+- Learn how to [get Firelight vault status](/fxrp/firelight/status) to monitor your redemption requests.
+- Learn how to [withdraw assets from a Firelight vault](/fxrp/firelight/withdraw) by specifying the amount of assets.
+- Learn how to [deposit assets into a Firelight vault](/fxrp/firelight/deposit).
+- Learn how to [mint Firelight vault shares](/fxrp/firelight/mint) by specifying the number of shares.
 - Explore the [FAssets system overview](/fassets/overview) to understand the broader ecosystem.
 
 :::
diff --git a/docs/fxrp/firelight/_firelight.mdx b/docs/fxrp/firelight/_firelight.mdx
@@ -0,0 +1,50 @@
+import DocCardList from "@theme/DocCardList";
+
+[Firelight](https://firelight.finance) is a yield-generating protocol built on top of FXRP.
+It provides [ERC-4626](https://eips.ethereum.org/EIPS/eip-4626) compliant vault that allows users to deposit FXRP and earn yield through the [FAssets](/fassets/overview) system.
+
+Firelight vaults operate on a [period-based logic](https://docs.firelight.finance/technical-documents#period-based-logic), where deposits and withdrawals are processed at specific intervals.
+Users receive vault shares representing their proportional ownership of the vault's assets.
+
+<DocCardList
+  items={[
+    {
+      type: "link",
+      label: "Get Vault Status",
+      href: "/fxrp/firelight/status",
+      docId: "fxrp/firelight/status",
+    },
+    {
+      type: "link",
+      label: "Deposit Assets",
+      href: "/fxrp/firelight/deposit",
+      docId: "fxrp/firelight/deposit",
+    },
+    {
+      type: "link",
+      label: "Mint Shares",
+      href: "/fxrp/firelight/mint",
+      docId: "fxrp/firelight/mint",
+    },
+    {
+      type: "link",
+      label: "Withdraw Assets",
+      href: "/fxrp/firelight/withdraw",
+      docId: "fxrp/firelight/withdraw",
+    },
+    {
+      type: "link",
+      label: "Redeem Shares",
+      href: "/fxrp/firelight/redeem",
+      docId: "fxrp/firelight/redeem",
+    },
+  ]}
+/>
+
+:::tip[What's next]
+
+- Learn more about [FAssets](/fassets/overview) and how the system works.
+- Explore how to [mint FXRP](/fassets/developer-guides/fassets-mint) from XRP.
+- Discover how to [redeem FXRP](/fassets/developer-guides/fassets-redeem) back to XRP.
+
+:::
diff --git a/docs/fxrp/firelight/index.mdx b/docs/fxrp/firelight/index.mdx
@@ -0,0 +1,9 @@
+---
+title: Firelight Vaults
+description: Learn how to interact with Firelight vaults, ERC-4626 vaults compatible with FXRP.
+keywords: [fassets, flare-network, fxrp, firelight, vault, erc-4626]
+---
+
+import Firelight from "./_firelight.mdx";
+
+<Firelight />
diff --git a/docs/fxrp/overview.mdx b/docs/fxrp/overview.mdx
@@ -0,0 +1,73 @@
+---
+title: FXRP
+description: Explore what you can do with FXRP, the FAsset representation of XRP on Flare.
+keywords: [fassets, fxrp, xrp, flare-network, firelight, vault, defi]
+---
+
+import DocCardList from "@theme/DocCardList";
+import Firelight from "./firelight/_firelight.mdx";
+
+FXRP is the [FAsset](/fassets/overview) representation of XRP on the Flare network.
+It is an [ERC-20](https://eips.ethereum.org/EIPS/eip-20) token that represents XRP bridged from the XRP Ledger (XRPL) to Flare.
+
+FXRP is powered by the [FAssets](/fassets/overview) system, a trustless, over-collateralized bridge infrastructure that enables the creation of wrapped tokens for assets from non-smart contract networks.
+
+### Key Features
+
+- **ERC-20 Standard:** As an [ERC-20](https://eips.ethereum.org/EIPS/eip-20) token, FXRP is compatible with all EVM-compatible wallets, smart contracts, and DeFi protocols on Flare, giving you full interoperability across the ecosystem.
+- **Trustless Bridge:** Your FXRP is backed by the [FAssets](/fassets/overview) system, which uses the [Flare Data Connector (FDC)](/fdc/overview) to verify XRPL transactions, eliminating the need for trusted intermediaries.
+- **Always Redeemable:** You can redeem your FXRP for the original XRP at any time, maintaining complete control over your assets.
+- **DeFi Integration:** Use your FXRP in various DeFi applications, including lending, borrowing, yield farming, and liquidity provision across Flare's ecosystem.
+- **Yield Opportunities:** Earn yield on your FXRP through protocols like [Firelight](/fxrp/firelight/status), which provides [ERC-4626](https://eips.ethereum.org/EIPS/eip-4626) compliant vaults for FXRP holders.
+
+## How to Acquire FXRP
+
+There are three primary ways to acquire FXRP:
+
+### Using Minting dApp
+
+The most direct way to acquire FXRP is by minting it from native XRP on the XRP Ledger (XRPL) using a minting dApp.
+
+You can mint FXRP on either of the following dApps:
+
+- [https://fasset.oracle-daemon.com/flare](https://fasset.oracle-daemon.com/flare)
+- [https://fassets.au.cc](https://fassets.au.cc)
+
+### 2. Mint FXRP via Code
+
+You can also mint FXRP programmatically using smart contracts and code.
+
+This approach is ideal for developers who want to integrate FXRP minting into their applications or automate the process for their users.
+
+For complete code examples and step-by-step instructions, see the [FAssets minting guide](/fassets/developer-guides/fassets-mint).
+
+### 3. Swap Other Tokens for FXRP
+
+You can also acquire FXRP by swapping other tokens (such as USDT0, FLR, or other ERC-20 tokens) on decentralized exchanges (DEXs) on Flare.
+
+For example, you can swap USDT0 to FXRP using SparkDEX (Uniswap V3) as described in the [swap guide](/fxrp/token-interactions/usdt0-fxrp-swap).
+
+## FXRP Token Interactions
+
+Guides for working directly with the FXRP token.
+
+<DocCardList
+  items={[
+    {
+      type: "link",
+      label: "Get FXRP Token Address",
+      href: "/fxrp/token-interactions/fxrp-address",
+      docId: "fxrp/token-interactions/fxrp-address",
+    },
+    {
+      type: "link",
+      label: "Swap USDT0 to FXRP",
+      href: "/fxrp/token-interactions/usdt0-fxrp-swap",
+      docId: "fxrp/token-interactions/usdt0-fxrp-swap",
+    },
+  ]}
+/>
+
+## Firelight
+
+<Firelight />
diff --git a/docs/fxrp/token-interactions/0-fxrp-address.mdx b/docs/fxrp/token-interactions/0-fxrp-address.mdx
@@ -1,16 +1,16 @@
 ---
 title: Get FXRP Address
 tags: [intermediate, fassets]
-slug: fassets-fxrp-address
+slug: fxrp-address
 description: Get FXRP address using the FAssets system
 keywords: [fassets, flare-network, fxrp, asset-manager]
 sidebar_position: 2
 ---
 
 import CodeBlock from "@theme/CodeBlock";
 import FAssetsGetFxrpScript from "!!raw-loader!/examples/developer-hub-javascript/fassets_get_fxrp.ts";
-import RedemptionProcessPrerequisites from "./_redemption_process_prerequisites.mdx";
-import GetFXRPAssetManager from "./_get_fxrp_asset_manager.mdx";
+import RedemptionProcessPrerequisites from "../../fassets/developer-guides/_redemption_process_prerequisites.mdx";
+import GetFXRPAssetManager from "../../fassets/developer-guides/_get_fxrp_asset_manager.mdx";
 
 ## Overview
 
diff --git a/docs/fxrp/token-interactions/1-usdt0-fxrp-swap.mdx b/docs/fxrp/token-interactions/1-usdt0-fxrp-swap.mdx
@@ -28,7 +28,7 @@ Before starting, make sure you have:
 
 - V3 SwapRouter (SparkDEX): [0x8a1E35F5c98C4E85B36B7B253222eE17773b2781](https://flare-explorer.flare.network/address/0x8a1E35F5c98C4E85B36B7B253222eE17773b2781?tab=contract).
 - USDT0: [0xe7cd86e13AC4309349F30B3435a9d337750fC82D](https://flare-explorer.flare.network/address/0xe7cd86e13AC4309349F30B3435a9d337750fC82D).
-- FXRP: [resolved dynamically from the Asset Manager](/fassets/developer-guides/fassets-fxrp-address).
+- FXRP: [resolved dynamically from the Asset Manager](/fxrp/token-interactions/fxrp-address).
 
 ## Solidity Uniswap V3 Wrapper Contract
 
diff --git a/sidebars.ts b/sidebars.ts
diff --git a/src/css/custom.css b/src/css/custom.css
diff --git a/src/features/FAssets/Reference/reference-data.ts b/src/features/FAssets/Reference/reference-data.ts
diff --git a/static/img/ui/fxrp.dark.svg b/static/img/ui/fxrp.dark.svg
diff --git a/static/img/ui/fxrp.light.svg b/static/img/ui/fxrp.light.svg
