feat(docs): direct minting parameters and settings (#1340)

fassko · nikerzetic-aflabs · web-flow · commit c3ef6ad82982 · 2026-04-24T10:45:49.000+03:00
Co-authored-by: Nik Erzetič | AFLabs | Flare &lt;Nik.Erzetic@flare.network&gt;
diff --git a/docs/fassets/10-reference.mdx b/docs/fassets/10-reference.mdx
@@ -62,6 +62,12 @@ Smart contract interfaces for interacting with the FAssets system.
       href: "/fassets/reference/ICoreVaultManager",
       docId: "fassets/reference/ICoreVaultManager",
     },
+    {
+      type: "link",
+      label: "IMintingTagManager",
+      href: "/fassets/reference/IMintingTagManager",
+      docId: "fassets/reference/IMintingTagManager",
+    },
     {
       type: "link",
       label: "IAgentOwnerRegistry",
diff --git a/docs/fassets/reference/IAssetManager.mdx b/docs/fassets/reference/IAssetManager.mdx
@@ -98,6 +98,132 @@ function fAsset()
     returns (IERC20);
 ```
 
+## Direct Minting Settings
+
+### `directMintingPaymentAddress`
+
+Gets the XRPL address of the core vault.
+This is the payment address to which the underlying assets must be sent for direct minting.
+
+```solidity
+function directMintingPaymentAddress()
+    external view
+    returns (string memory);
+```
+
+### `getDirectMintingMinimumFeeUBA`
+
+Returns the minimum direct minting fee in UBA.
+
+```solidity
+function getDirectMintingMinimumFeeUBA()
+    external view
+    returns (uint256);
+```
+
+### `getDirectMintingFeeBIPS`
+
+Returns the direct minting fee in BIPS.
+
+```solidity
+function getDirectMintingFeeBIPS()
+    external view
+    returns (uint256);
+```
+
+### `getDirectMintingExecutorFeeUBA`
+
+Returns the direct minting executor fee in UBA.
+
+```solidity
+function getDirectMintingExecutorFeeUBA()
+    external view
+    returns (uint256);
+```
+
+### `getDirectMintingOthersCanExecuteAfterSeconds`
+
+Returns the time in seconds after which anyone can execute a direct minting request.
+
+```solidity
+function getDirectMintingOthersCanExecuteAfterSeconds()
+    external view
+    returns (uint256);
+```
+
+### `getDirectMintingHourlyLimitUBA`
+
+Returns the hourly direct minting limit in UBA.
+
+```solidity
+function getDirectMintingHourlyLimitUBA()
+    external view
+    returns (uint256);
+```
+
+### `getDirectMintingDailyLimitUBA`
+
+Returns the daily direct minting limit in UBA.
+
+```solidity
+function getDirectMintingDailyLimitUBA()
+    external view
+    returns (uint256);
+```
+
+### `getDirectMintingLargeMintingThresholdUBA`
+
+Returns the threshold above which direct minting is considered large, in UBA.
+
+```solidity
+function getDirectMintingLargeMintingThresholdUBA()
+    external view
+    returns (uint256);
+```
+
+### `getDirectMintingLargeMintingDelaySeconds`
+
+Returns the delay in seconds applied to large direct mintings.
+
+```solidity
+function getDirectMintingLargeMintingDelaySeconds()
+    external view
+    returns (uint256);
+```
+
+### `getDirectMintingFeeReceiver`
+
+Returns the address that receives direct minting fees.
+
+```solidity
+function getDirectMintingFeeReceiver()
+    external view
+    returns (address);
+```
+
+## Redeem With Tag Settings
+
+### `minimumRedeemAmountUBA`
+
+Returns the minimum redeem amount in UBA for redeem with tag.
+
+```solidity
+function minimumRedeemAmountUBA()
+    external view
+    returns (uint256);
+```
+
+### `getMintingTagManager`
+
+Returns the minting tag manager contract address.
+To interact with it, use the [IMintingTagManager](/fassets/reference/IMintingTagManager) reference.
+
+```solidity
+function getMintingTagManager()
+    external view
+    returns (address);
+```
+
 ## Agents
 
 ## `getAllAgents`
@@ -305,7 +431,8 @@ Sourced from `ICoreVaultSettings.sol` on [GitHub](https://github.com/flare-found
 
 ### `getCoreVaultManager`
 
-Returns the core vault manager address. To interact with the Core Vault manager reference the [Core Vault Manager](/fassets/reference/ICoreVaultManager) contract.
+Returns the core vault manager address.
+To interact with the Core Vault manager reference the [Core Vault Manager](/fassets/reference/ICoreVaultManager) contract.
 
 ```solidity
 function getCoreVaultManager()
diff --git a/docs/fassets/reference/IMintingTagManager.mdx b/docs/fassets/reference/IMintingTagManager.mdx
@@ -0,0 +1,97 @@
+---
+title: IMintingTagManager
+description: FAssets IMintingTagManager interface reference.
+keywords: [fassets, minting-tags, xrp, bitcoin, dogecoin, flare-network]
+sidebar_position: 5
+---
+
+Reference for managing and interacting with FAssets `IMintingTagManager`.
+
+To get the minting tag manager address, use the [getMintingTagManager](/fassets/reference/IAssetManager#getmintingtagmanager) function of the [IAssetManager](/fassets/reference/IAssetManager) contract.
+
+## Functions
+
+### `reserve`
+
+Reserve a new minting tag NFT by paying the reservation fee.
+The caller becomes the owner of this NFT (tag ID) and the initial minting recipient.
+
+```solidity
+function reserve() external payable returns (uint256);
+```
+
+#### Returns
+
+- The newly reserved minting tag ID.
+
+### `setMintingRecipient`
+
+Set the minting recipient for a tag.
+Only callable by the tag owner.
+The minting recipient is the address that receives minted FAssets when this tag is used.
+
+```solidity
+function setMintingRecipient(uint256 _mintingTag, address _recipient) external;
+```
+
+#### Parameters
+
+- `_mintingTag`: The minting tag ID.
+- `_recipient`: The new minting recipient address (must not be the zero address).
+
+### `reservationFee`
+
+Return the fee (in native currency) required to reserve a new minting tag.
+
+```solidity
+function reservationFee() external view returns (uint256);
+```
+
+### `reservedTagsForOwner`
+
+Return all minting tag IDs owned by the given address.
+
+```solidity
+function reservedTagsForOwner(address _owner) external view returns (uint256[] memory);
+```
+
+#### Parameters
+
+- `_owner`: The address to query.
+
+#### Returns
+
+- An array of minting tag IDs owned by `_owner`.
+
+### `mintingRecipient`
+
+Return the minting recipient for a given tag.
+
+```solidity
+function mintingRecipient(uint256 _mintingTag) external view returns (address);
+```
+
+#### Parameters
+
+- `_mintingTag`: The minting tag ID.
+
+#### Returns
+
+- The address that receives minted FAssets when this tag is used.
+
+### `allowedExecutor`
+
+Return the currently active allowed executor for a given tag.
+If no executor is set or the pending change has not been activated yet, this returns the previous executor.
+
+```solidity
+function allowedExecutor(uint256 _mintingTag) external view returns (address);
+```
+
+#### Parameters
+
+- `_mintingTag`: The minting tag ID.
+
+#### Returns
+
+- The address of the allowed executor, or `address(0)` if none is set.
diff --git a/src/features/FAssets/OperationalParameters/operational-parameters.ts b/src/features/FAssets/OperationalParameters/operational-parameters.ts
@@ -1253,7 +1253,9 @@ export const operationalParameters = [
     parameters: [
       {
         name: "Direct Minting Minimum Fee",
-        settingName: "directMintingMinimumFee",
+        functionName: "getDirectMintingMinimumFeeUBA",
+        interfaceLink:
+          "/fassets/reference/IAssetManager#getdirectmintingminimumfeeuba",
         description:
           "Minimum fee charged for direct minting, in base unit of the underlying asset (UBA).",
         values: {
@@ -1273,7 +1275,9 @@ export const operationalParameters = [
       },
       {
         name: "Direct Minting Fee",
-        settingName: "directMintingFeeBIPS",
+        functionName: "getDirectMintingFeeBIPS",
+        interfaceLink:
+          "/fassets/reference/IAssetManager#getdirectmintingfeebips",
         description:
           "Direct minting fee as a percentage of the minting amount, in BIPS.",
         values: {
@@ -1293,7 +1297,9 @@ export const operationalParameters = [
       },
       {
         name: "Direct Minting Executor Fee",
-        settingName: "directMintingExecutorFeeUBA",
+        functionName: "getDirectMintingExecutorFeeUBA",
+        interfaceLink:
+          "/fassets/reference/IAssetManager#getdirectmintingexecutorfeeuba",
         description:
           "Fee paid to the executor of a direct minting request, in base unit of the underlying asset (UBA). This only applies to direct mintings to address, for direct minting to smart account the executor fee is calculated and paid by the smart account manager.",
         values: {
@@ -1313,7 +1319,9 @@ export const operationalParameters = [
       },
       {
         name: "Direct Minting Others Can Execute After",
-        settingName: "directMintingOthersCanExecuteAfterSeconds",
+        functionName: "getDirectMintingOthersCanExecuteAfterSeconds",
+        interfaceLink:
+          "/fassets/reference/IAssetManager#getdirectmintingotherscanexecuteafterseconds",
         description:
           "Time in seconds after which anyone can execute a direct minting request (not just the executor set by the minter).",
         values: {
@@ -1333,7 +1341,9 @@ export const operationalParameters = [
       },
       {
         name: "Direct Minting Hourly Limit",
-        settingName: "directMintingHourlyLimitUBA",
+        functionName: "getDirectMintingHourlyLimitUBA",
+        interfaceLink:
+          "/fassets/reference/IAssetManager#getdirectmintinghourlylimituba",
         description:
           "Maximum amount that can be directly minted per hour, in base unit of the underlying asset (UBA). After that the mintings are delayed.",
         values: {
@@ -1353,7 +1363,9 @@ export const operationalParameters = [
       },
       {
         name: "Direct Minting Daily Limit",
-        settingName: "directMintingDailyLimitUBA",
+        functionName: "getDirectMintingDailyLimitUBA",
+        interfaceLink:
+          "/fassets/reference/IAssetManager#getdirectmintingdailylimituba",
         description:
           "Maximum amount that can be directly minted per day, in base unit of the underlying asset (UBA). After that the mintings are delayed.",
         values: {
@@ -1373,7 +1385,9 @@ export const operationalParameters = [
       },
       {
         name: "Direct Minting Large Minting Threshold",
-        settingName: "directMintingLargeMintingThresholdUBA",
+        functionName: "getDirectMintingLargeMintingThresholdUBA",
+        interfaceLink:
+          "/fassets/reference/IAssetManager#getdirectmintinglargemintingthresholduba",
         description:
           "Threshold above which a direct minting is considered large, in base unit of the underlying asset (UBA). Large mintings are always delayed.",
         values: {
@@ -1393,7 +1407,9 @@ export const operationalParameters = [
       },
       {
         name: "Direct Minting Large Minting Delay",
-        settingName: "directMintingLargeMintingDelaySeconds",
+        functionName: "getDirectMintingLargeMintingDelaySeconds",
+        interfaceLink:
+          "/fassets/reference/IAssetManager#getdirectmintinglargemintingdelayseconds",
         description:
           "Delay in seconds imposed on large direct mintings before they can be executed.",
         values: {
@@ -1413,7 +1429,9 @@ export const operationalParameters = [
       },
       {
         name: "Direct Minting Fee Receiver",
-        settingName: "directMintingFeeReceiver",
+        functionName: "getDirectMintingFeeReceiver",
+        interfaceLink:
+          "/fassets/reference/IAssetManager#getdirectmintingfeereceiver",
         description: "Address that receives the direct minting fee.",
         values: {
           flare: {
@@ -1437,7 +1455,9 @@ export const operationalParameters = [
     parameters: [
       {
         name: "Minimum Redeem Amount",
-        settingName: "minimumRedeemAmount",
+        functionName: "minimumRedeemAmountUBA",
+        interfaceLink:
+          "/fassets/reference/IAssetManager#minimumredeemamountuba",
         description:
           "Minimum amount that can be redeemed, in base unit of the underlying asset (UBA).",
         values: {
