feat(docs): get fassets asset manager address (#727)

fassko · web-flow · commit 89408e5f64e7 · 2025-07-09T15:32:01.000+03:00
diff --git a/docs/fassets/developer-guides/1-fassets-get-asset-amanager-address-registry.mdx b/docs/fassets/developer-guides/1-fassets-get-asset-amanager-address-registry.mdx
@@ -0,0 +1,71 @@
+---
+title: Get FXRP Asset Manager Address
+tags: [intermediate, fassets]
+slug: fassets-asset-manager-address-contracts-registry
+description: Get FXRP asset manager address from the Flare contract registry
+keywords: [fassets, flare-network, fxrp, asset-manager]
+sidebar_position: 1
+---
+
+import CodeBlock from "@theme/CodeBlock";
+import Remix from "@site/src/components/remix";
+import AssetManagerRegistry from "!!raw-loader!/examples/developer-hub-solidity/FAssetsAssetManagerRegistry.sol";
+import ExploringAdditionalParameters from "./_exploring-additional-parameters.mdx";
+
+## Overview
+
+When building on the Flare Network, it is important to **avoid hardcoding contract addresses**, especially for key components such as the FXRP Asset Manager.
+These addresses can change between Flare testnets and mainnet deployments, and relying on fixed values can lead to broken integrations.
+
+Instead, you should dynamically fetch the FXRP Asset Manager address using the [Flare Contract Registry](/network/guides/flare-contracts-registry), the trusted source for obtaining contract addresses on any Flare network.
+
+In this guide, you will learn:
+
+- How to retrieve the [Asset Manager Controller](/fassets/reference/IAssetManagerController) using the Flare Contract Registry.
+- How to find the specific FXRP [Asset Manager](/fassets/reference/IAssetManager).
+- A sample Solidity contract that encapsulates this logic.
+
+## Sample code
+
+To get the [FAssets asset manager](/fassets/reference/IAssetManager) address, you can use the following smart contract that retrieves the [Asset Manager Controller](/fassets/reference/IAssetManagerController) address from the [Flare contract registry](/network/guides/flare-contracts-registry).
+
+<CodeBlock language="solidity" title="contracts/AssetManagerRegistry.sol">
+  {AssetManagerRegistry}
+</CodeBlock>
+
+{/* prettier-ignore */}
+<Remix fileName="FAssetsAssetManagerRegistry.sol">Open in Remix</Remix>
+<br></br>
+
+### Contract Breakdown
+
+1. Imports the necessary interfaces and libraries from the [Flare Periphery Contracts package](https://www.npmjs.com/package/@flarenetwork/flare-periphery-contracts).
+2. Defines a constant `TXRP_HASH` that is the hash of the string `TXRP`.
+   This is used to identify the FXRP asset manager.
+3. Implements a function `getFxrpAssetManager` that returns the FXRP [Asset Manager](/fassets/reference/IAssetManager) address.
+4. Uses the `ContractRegistry` library from the Flare Periphery Contracts package to get the [Asset Manager Controller](/fassets/reference/IAssetManagerController) address from the Flare contract registry.
+5. Uses the `IAssetManagerController` interface from the Flare Periphery Contracts package to get all the asset managers from the Asset Manager Controller.
+6. Iterates over the asset managers and returns the FXRP Asset Manager address.
+7. Gets the settings of the asset manager.
+8. Checks if the pool token suffix is `TXRP` and if true returns the FXRP Asset Manager address.
+
+You can find out this sample code in the [Flare starter kit](/network/guides/hardhat-foundry-starter-kit).
+
+:::tip Reusable Library
+
+To reuse this code to get the FXRP Asset Manager address in other smart contracts, you can wrap it in a reusable library.
+This is useful if you want to use the FXRP Asset Manager address in multiple smart contracts and avoid repeating the same code.
+
+:::
+
+## Next Steps
+
+In this guide, you learned how to get the FXRP Asset Manager address for the FAssets system by interacting with the `AssetManager` contract using the [`IAssetManager`](/fassets/reference/IAssetManager) interface.
+
+You should not hardcode the FXRP Asset Manager address in your smart contracts.
+
+To continue your FAssets development journey, you can:
+
+- Learn how to [mint FXRP](/fassets/developer-guides/fassets-mint).
+- Understand how to [redeem FXRP](/fassets/developer-guides/fassets-redeem).
+- Explore [FAssets system settings](/fassets/operational-parameters).
diff --git a/docs/fassets/developer-guides/2-fassets-fxrp.mdx b/docs/fassets/developer-guides/2-fassets-fxrp.mdx
@@ -4,7 +4,7 @@ tags: [intermediate, fassets]
 slug: fassets-fxrp-address
 description: Learn how to get FXRP address for interacting with the FAssets system
 keywords: [fassets, flare-network, fxrp, asset-manager]
-sidebar_position: 6
+sidebar_position: 2
 ---
 
 import CodeBlock from "@theme/CodeBlock";
diff --git a/docs/fassets/developer-guides/3-fassets-asset-manager-settings-solidity.mdx b/docs/fassets/developer-guides/3-fassets-asset-manager-settings-solidity.mdx
@@ -4,7 +4,7 @@ tags: [intermediate, fassets]
 slug: fassets-settings-solidity
 description: Fetch FAsset Lot Size and Value in USD (via FTSO) from a smart contract
 keywords: [fassets, ftso, oracle, flare-time-series-oracle, flare-network, node]
-sidebar_position: 4
+sidebar_position: 3
 ---
 
 import CodeBlock from "@theme/CodeBlock";
diff --git a/docs/fassets/developer-guides/4-fassets-asset-manager-settings-node.mdx b/docs/fassets/developer-guides/4-fassets-asset-manager-settings-node.mdx
@@ -4,7 +4,7 @@ tags: [intermediate, fassets]
 slug: fassets-settings-node
 description: Fetch FAsset Lot Size and Value in USD (via FTSO) using Node.js
 keywords: [fassets, ftso, oracle, flare-time-series-oracle, flare-network, node]
-sidebar_position: 3
+sidebar_position: 4
 ---
 
 import ExploringAdditionalParameters from "./_exploring-additional-parameters.mdx";
diff --git a/docs/fassets/developer-guides/5-fassets-minting.mdx b/docs/fassets/developer-guides/5-fassets-minting.mdx
@@ -4,7 +4,7 @@ tags: [intermediate, fassets]
 slug: fassets-mint
 description: Learn how to mint FAssets
 keywords: [fassets, flare-network]
-sidebar_position: 1
+sidebar_position: 5
 ---
 
 import CodeBlock from "@theme/CodeBlock";
diff --git a/docs/fassets/developer-guides/6-fassets-redeem.mdx b/docs/fassets/developer-guides/6-fassets-redeem.mdx
@@ -4,7 +4,7 @@ tags: [intermediate, fassets]
 slug: fassets-redeem
 description: Learn how to redeem FAssets
 keywords: [fassets, flare-network]
-sidebar_position: 2
+sidebar_position: 6
 ---
 
 import CodeBlock from "@theme/CodeBlock";
diff --git a/docs/fassets/developer-guides/7-fassets-swap-redeem.mdx b/docs/fassets/developer-guides/7-fassets-swap-redeem.mdx
@@ -4,7 +4,7 @@ tags: [intermediate, fassets]
 slug: fassets-swap-redeem
 description: Learn how to swap and redeem FAssets
 keywords: [fassets, flare-network]
-sidebar_position: 5
+sidebar_position: 7
 ---
 
 import CodeBlock from "@theme/CodeBlock";
diff --git a/docs/network/guides/flare-contracts-registry.mdx b/docs/network/guides/flare-contracts-registry.mdx
@@ -97,8 +97,9 @@ This library provides shorthand functions for accessing common protocol contract
 
 In the example, the `getRandomNumberViaContractLibrary` function demonstrates this approach.
 
-<br />
-:::tip If the contract you are looking for does not have a shorthand method in
+:::tip
+If the contract you are looking for does not have a shorthand method in
 the `ContractRegistry` library, you can fall back to using
 `getContractAddressByName` or call `getAllContracts` to list all registered
-contracts. :::
+contracts.
+:::
diff --git a/examples/developer-hub-solidity/FAssetsAssetManagerRegistry.sol b/examples/developer-hub-solidity/FAssetsAssetManagerRegistry.sol
@@ -0,0 +1,47 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+// 1. Import the necessary interfaces and libraries
+import {IFlareContractRegistry} from "@flarenetwork/flare-periphery-contracts/coston2/IFlareContractRegistry.sol";
+
+import {IAssetManager} from "@flarenetwork/flare-periphery-contracts/coston2/IAssetManager.sol";
+import {IAssetManagerController} from "@flarenetwork/flare-periphery-contracts/coston2/IAssetManagerController.sol";
+
+import {ContractRegistry} from "@flarenetwork/flare-periphery-contracts/coston2/ContractRegistry.sol";
+
+import {AssetManagerSettings} from "@flarenetwork/flare-periphery-contracts/coston2/userInterfaces/data/AssetManagerSettings.sol";
+
+contract AssetManagerRegistry {
+    // 2. Define a constant TXRP_HASH that is the hash of the string "TXRP"
+    bytes32 private constant TXRP_HASH = keccak256(abi.encodePacked("TXRP"));
+
+    // 3. Implement a function that returns the FXRP Asset Manager address
+    function getFxrpAssetManager() public view returns (address) {
+        // 4. Use the ContractRegistry library to get the AssetManagerController
+        IAssetManagerController assetManagerController = ContractRegistry
+            .getAssetManagerController();
+
+        // 5. Get all the asset managers from the AssetManagerController
+        IAssetManager[] memory assetManagers = assetManagerController
+            .getAssetManagers();
+
+        // 6. Iterate over the asset managers and return the FXRP Asset Manager address
+        for (uint256 i = 0; i < assetManagers.length; i++) {
+            IAssetManager assetManager = IAssetManager(assetManagers[i]);
+
+            // 7. Get the settings of the asset manager
+            AssetManagerSettings.Data memory settings = assetManager
+                .getSettings();
+
+            // Calculate the hash of the pool token suffix
+            bytes32 poolTokenSuffixHash = keccak256(abi.encodePacked(poolTokenSuffix));
+
+            //8. return the address of the asset manager that has the pool token suffix "TXRP"
+            if (poolTokenSuffixHash == TXRP_HASH) {
+                return address(assetManager);
+            }
+        }
+        // If no asset manager is found, return the zero address
+        return address(0);
+    }
+}
