feat(docs): update Minting Tag Manager details and enhance operational parameters

Author: fassko

docs/fassets/03-direct-minting.mdx

@@ -69,7 +69,7 @@ The `MintingTagManager` contract on Flare manages the reservation and ownership
 - Tags are assigned sequentially.
   The user always receives the next available tag.
 - The contract implements the **ERC-721** (NFT) interface, so reserved tags can be transferred or resold.
-- Tag owners can set a minting recipient with `setMintingRecipient` and a preferred executor with `setAllowedExecutor`.
+- Tag owners can set a preferred executor with `setAllowedExecutor`.
   Executor changes are not immediate: the new executor becomes active after a 10-minute cooldown to protect in-flight FDC proofs.
 - On initial reservation and tag transfer, the recipient resets to the new owner and the executor resets to the zero address.
 

docs/fassets/09-operational-parameters.mdx

@@ -66,6 +66,13 @@ Specific functions added to each parameter.
 
 <OperationalParameters sectionTitle="Direct Minting" networks={["coston2"]} />
 
+## Minting Tag Manager
+
+<OperationalParameters
+  sectionTitle="Minting Tag Manager"
+  networks={["coston2"]}
+/>
+
 ## Redeem With Tag
 
 <OperationalParameters sectionTitle="Redeem With Tag" networks={["coston2"]} />

docs/fassets/reference/IMintingTagManager.mdx

@@ -63,11 +63,36 @@ function reservedTagsForOwner(address _owner) external view returns (uint256[] m
 
 - An array of minting tag IDs owned by `_owner`.
 
+### `transfer`
+
+Transfer a minting tag to a new owner.
+Also updates the minting recipient to the new owner and resets the allowed executor.
+
+```solidity
+/**
+ * Transfer a minting tag to a new owner. Also updates the minting recipient
+ * to the new owner and resets the allowed executor.
+ * @param _to The address to transfer the tag to.
+ * @param _mintingTag The minting tag id to transfer.
+ */
+function transfer(address _to, uint256 _mintingTag) external;
+```
+
+#### Parameters
+
+- `_to`: The address to transfer the tag to.
+- `_mintingTag`: The minting tag ID to transfer.
+
 ### `mintingRecipient`
 
 Return the minting recipient for a given tag.
 
 ```solidity
+/**
+ * Return the minting recipient for a given tag.
+ * @param _mintingTag The minting tag id.
+ * @return The address that receives minted f-assets when this tag is used.
+ */
 function mintingRecipient(uint256 _mintingTag) external view returns (address);
 ```
 

src/features/FAssets/OperationalParameters/index.tsx

@@ -2,6 +2,7 @@ import React from "react";
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 import Link from "@docusaurus/Link";
+import CopyButton from "@site/src/components/CopyButton";
 
 import { operationalParameters } from "./operational-parameters";
 
@@ -32,6 +33,20 @@ export default function OperationalParameters({
   type OperationalParameter =
     (typeof operationalParameters)[number]["parameters"][number];
   type Network = "songbird" | "coston" | "coston2" | "flare";
+  type ValueType = "text" | "address";
+
+  const networkAddressExplorerPrefix: Record<Network, string> = {
+    flare: "https://flare-explorer.flare.network/address/",
+    coston2: "https://coston2-explorer.flare.network/address/",
+    songbird: "https://songbird-explorer.flare.network/address/",
+    coston: "https://coston-explorer.flare.network/address/",
+  };
+  const networkExplorerLabel: Record<Network, string> = {
+    flare: "Flare Mainnet",
+    coston2: "Flare Testnet Coston2",
+    songbird: "Songbird Canary-Network",
+    coston: "Songbird Testnet Coston",
+  };
 
   function ParameterTable({
     network,
@@ -46,6 +61,8 @@ export default function OperationalParameters({
     hideBtc?: boolean;
     hideDoge?: boolean;
   }) {
+    const isAddress = (value: string) => /^0x[a-fA-F0-9]{40}$/.test(value);
+
     const getNetworkValue = (
       parameter: OperationalParameter,
       asset: "xrp" | "btc" | "doge",
@@ -54,6 +71,38 @@ export default function OperationalParameters({
       return typeof value === "string" && value.trim().length > 0 ? value : "-";
     };
 
+    const getValueType = (parameter: OperationalParameter): ValueType =>
+      "valueType" in parameter && parameter.valueType === "address"
+        ? "address"
+        : "text";
+
+    const renderValueCell = (
+      parameter: OperationalParameter,
+      asset: "xrp" | "btc" | "doge",
+    ) => {
+      const value = getNetworkValue(parameter, asset);
+      const valueType = getValueType(parameter);
+
+      if (valueType === "address" && value !== "-" && isAddress(value)) {
+        const explorerNetwork = networkExplorerLabel[network];
+        return (
+          <>
+            <Link
+              href={`${networkAddressExplorerPrefix[network]}${value}`}
+              target="_blank"
+              rel="noopener noreferrer"
+              title={`Open address in ${explorerNetwork} explorer`}
+            >
+              <code>{value}</code>
+            </Link>{" "}
+            <CopyButton textToCopy={value} />
+          </>
+        );
+      }
+
+      return <span dangerouslySetInnerHTML={{ __html: value }} />;
+    };
+
     return (
       <table>
         <thead>
@@ -112,27 +161,9 @@ export default function OperationalParameters({
                 <br />
                 {parameter.description}
               </td>
-              {!hideXrp && (
-                <td
-                  dangerouslySetInnerHTML={{
-                    __html: getNetworkValue(parameter, "xrp"),
-                  }}
-                />
-              )}
-              {!hideBtc && (
-                <td
-                  dangerouslySetInnerHTML={{
-                    __html: getNetworkValue(parameter, "btc"),
-                  }}
-                />
-              )}
-              {!hideDoge && (
-                <td
-                  dangerouslySetInnerHTML={{
-                    __html: getNetworkValue(parameter, "doge"),
-                  }}
-                />
-              )}
+              {!hideXrp && <td>{renderValueCell(parameter, "xrp")}</td>}
+              {!hideBtc && <td>{renderValueCell(parameter, "btc")}</td>}
+              {!hideDoge && <td>{renderValueCell(parameter, "doge")}</td>}
             </tr>
           ))}
         </tbody>

src/features/FAssets/OperationalParameters/operational-parameters.ts

@@ -1433,6 +1433,7 @@ export const operationalParameters = [
         interfaceLink:
           "/fassets/reference/IAssetManager#getdirectmintingfeereceiver",
         description: "Address that receives the direct minting fee.",
+        valueType: "address",
         values: {
           flare: {
             xrp: "0x0000000000000000000000000000000000000000",
@@ -1468,4 +1469,61 @@ export const operationalParameters = [
       },
     ],
   },
+  {
+    title: "Minting Tag Manager",
+    parameters: [
+      {
+        name: "Name (NFT)",
+        description: "NFT collection name used by the minting tag manager.",
+        values: {
+          coston2: {
+            xrp: "Minting Tag Manager (FTestXRP open beta)",
+          },
+        },
+      },
+      {
+        name: "Symbol (NFT)",
+        description: "NFT collection symbol used by the minting tag manager.",
+        values: {
+          coston2: {
+            xrp: "MTMTXRP",
+          },
+        },
+      },
+      {
+        name: "Reservation Fee",
+        functionName: "reservationFee",
+        interfaceLink: "/fassets/reference/IMintingTagManager#reservationfee",
+        description:
+          "Fee charged when reserving a minting tag for the NFT-based manager.",
+        values: {
+          coston2: {
+            xrp: "100 C2FLR",
+          },
+        },
+      },
+      {
+        name: "Reservation Fee Recipient",
+        functionName: "mintingRecipient",
+        interfaceLink: "/fassets/reference/IMintingTagManager#mintingRecipient",
+        description: "Address that receives reservation fees.",
+        valueType: "address",
+        values: {
+          coston2: {
+            xrp: "0x355156629f25102c3cc51b7630eb80E9De5d1211",
+          },
+        },
+      },
+      {
+        name: "Reserved Tag Count",
+        settingName: "reservedTagCount",
+        description: "Number of tags reserved for minting operations.",
+        values: {
+          coston2: {
+            xrp: "20",
+          },
+        },
+      },
+    ],
+  },
 ];