refactor(docs): update FXRP address links and add token interaction guides

fassko · fassko · commit 0ea220ef42bd · 2026-01-15T16:32:36.000+02: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,21 +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](/fassets/fxrp) for more FXRP resources.
+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",
     },
   ]}
 />
@@ -141,8 +141,8 @@ Guides for reading and working with agent data.
 
 :::tip[What's next]
 
-- Explore [FXRP](/fassets/fxrp) and discover what you can do with the FAsset representation of XRP.
+- 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](/fassets/fxrp#firelight) vault.
+- 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/overview.mdx b/docs/fxrp/overview.mdx
@@ -19,14 +19,14 @@ Guides for working directly with the FXRP token.
     {
       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",
     },
   ]}
 />
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
@@ -275,13 +275,13 @@ const sidebars: SidebarsConfig = {
           type: "category",
           label: "Token Interactions",
           link: {
-            slug: "/fxrp/interactions",
+            slug: "/fxrp/token-interactions",
             type: "generated-index",
             description: "Guides for interacting with FXRP token.",
           },
           items: [
-            "fassets/developer-guides/fassets-fxrp-address",
-            "fassets/developer-guides/usdt0-fxrp-swap",
+            "fxrp/token-interactions/fxrp-address",
+            "fxrp/token-interactions/usdt0-fxrp-swap",
           ],
         },
         {
diff --git a/src/features/FAssets/Reference/reference-data.ts b/src/features/FAssets/Reference/reference-data.ts
@@ -51,7 +51,7 @@ export const reference = [
     description: "The FAsset-wrapped XRP token.",
     guide: {
       title: "Learn how to get the FXRP address.",
-      link: "/fassets/developer-guides/fassets-fxrp-address",
+      link: "/fxrp/token-interactions/fxrp-address",
     },
   },
 ];
