feat(docs): enhance FXRP and Firelight documentation

fassko · fassko · commit 24b10681ad68 · 2026-01-16T14:38:12.000+02:00
diff --git a/docs/fxrp/firelight/01-status.mdx b/docs/fxrp/firelight/01-status.mdx
@@ -1,5 +1,5 @@
 ---
-title: Get Firelight Vaults Status
+title: Get Firelight Vault Status
 tags: [intermediate, fassets]
 slug: status
 description: Learn how to get Firelight vault status
@@ -22,7 +22,7 @@ The Firelight vault is an [ERC-4626](https://eips.ethereum.org/EIPS/eip-4626) va
 - [Flare Network Periphery Contracts](https://www.npmjs.com/package/@flarenetwork/flare-periphery-contracts)
 - Understanding of [FAssets](/fassets/overview)
 
-## Firelight Vaults Status Script
+## Firelight Vault Status Script
 
 The following script retrieves and displays information about the Firelight vault:
 
diff --git a/docs/fxrp/firelight/02-deposit.mdx b/docs/fxrp/firelight/02-deposit.mdx
@@ -1,5 +1,5 @@
 ---
-title: Deposit Assets into Firelight Vaults
+title: Deposit Assets into Firelight Vault
 tags: [intermediate, fassets]
 slug: deposit
 description: Learn how to deposit assets into a Firelight vault
@@ -24,7 +24,7 @@ Depositing assets is the process of transferring assets to the vault and receivi
 - Understanding of [FAssets](/fassets/overview)
 - Sufficient asset balance (e.g., FXRP) to deposit into the vault.
 
-## Firelight Vaults Deposit Script
+## Firelight Vault Deposit Script
 
 The following script demonstrates how to deposit assets into the Firelight vault:
 
diff --git a/docs/fxrp/firelight/03-mint.mdx b/docs/fxrp/firelight/03-mint.mdx
@@ -1,5 +1,5 @@
 ---
-title: Mint Firelight Vaults Shares
+title: Mint Firelight Vault Shares
 tags: [intermediate, fassets]
 slug: mint
 description: Learn how to mint Firelight vault shares
@@ -24,7 +24,7 @@ Minting shares is the process of depositing assets into the vault and receiving
 - Understanding of [FAssets](/fassets/overview)
 - Sufficient asset balance (e.g., FXRP) to deposit into the vault.
 
-## Firelight Vaults Mint Script
+## Firelight Vault Mint Script
 
 The following script demonstrates how to mint vault shares by depositing assets into the Firelight vault:
 
diff --git a/docs/fxrp/firelight/04-withdraw.mdx b/docs/fxrp/firelight/04-withdraw.mdx
@@ -1,5 +1,5 @@
 ---
-title: Withdraw Assets from Firelight Vaults
+title: Withdraw Assets from Firelight Vault
 tags: [intermediate, fassets]
 slug: withdraw
 description: Learn how to withdraw assets from a Firelight vault
@@ -25,7 +25,7 @@ The assets are not immediately transferred; they must be claimed once the period
 - Understanding of [FAssets](/fassets/overview)
 - Vault shares in the Firelight vault to withdraw.
 
-## Firelight Vaults Withdraw Script
+## Firelight Vault Withdraw Script
 
 The following script demonstrates how to create a withdrawal request from the Firelight vault:
 
diff --git a/docs/fxrp/firelight/05-redeem.mdx b/docs/fxrp/firelight/05-redeem.mdx
@@ -1,5 +1,5 @@
 ---
-title: Redeem Assets from Firelight Vaults
+title: Redeem Assets from Firelight Vault
 tags: [intermediate, fassets]
 slug: redeem
 description: Learn how to redeem assets from a Firelight vault
@@ -25,7 +25,7 @@ The assets are not immediately transferred; they must be claimed once the period
 - Understanding of [FAssets](/fassets/overview)
 - Vault shares in the Firelight vault to redeem.
 
-## Firelight Vaults Redeem Script
+## Firelight Vault Redeem Script
 
 The following script demonstrates how to create a redemption request from the Firelight vault:
 
diff --git a/docs/fxrp/firelight/_firelight.mdx b/docs/fxrp/firelight/_firelight.mdx
@@ -3,7 +3,7 @@ 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 operates on a [period-based logic](https://docs.firelight.finance/technical-documents#period-based-logic), where deposits and withdrawals are processed at specific intervals.
+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
diff --git a/docs/fxrp/overview.mdx b/docs/fxrp/overview.mdx
@@ -7,8 +7,45 @@ 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 Flare.
-It enables XRP holders to participate in Flare's DeFi ecosystem while maintaining the ability to redeem their tokens for the original XRP at any time.
+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
 
