# Redeem FXRP with Tag

> Redeem any amount of FXRP and require an XRPL destination tag on the agent's payment.

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.

Source: https://dev.flare.network/fassets/developer-guides/fassets-redeem-with-tag

## Overview[​](#overview "Direct link to Overview")

This guide walks you through redeeming FXRP using [`redeemWithTag`](/fassets/reference/IAssetManager#redeemwithtag) on the `AssetManagerFXRP` contract. Compared to [`redeemAmount`](/fassets/developer-guides/fassets-redeem-amount), `redeemWithTag` adds a required XRPL destination tag that the agent must include in the redemption payment — useful when redeeming directly to an exchange address that requires a tag.

The complete runnable example is available in the [flare-viem-starter](https://github.com/flare-foundation/flare-viem-starter/blob/main/src/fassets/redeem-with-tag.ts) repository.

## Prerequisites[​](#prerequisites "Direct link to Prerequisites")

-   An EVM wallet with.
-   Native tokens on the same wallet to cover the gas fees.
-   An XRPL destination address and the destination tag the recipient requires.

## Redeem with Tag Script[​](#redeem-with-tag-script "Direct link to Redeem with Tag Script")

src/fassets/redeem-with-tag.ts

```
import { coston2 } from "@flarenetwork/flare-wagmi-periphery-package";import { parseEventLogs, type Address } from "viem";import { account, publicClient, walletClient } from "./utils/client";import { getContractAddressByName } from "./utils/flare-contract-registry";// 1. Amount to redeem in UBA (underlying base units; 1 XRP = 1_000_000 UBA).const REDEEM_AMOUNT_UBA = 5000000n;// 2. Redeemer underlying (XRPL) address that will receive the redeemed XRP.const REDEEMER_UNDERLYING_ADDRESS_STRING = "rSHYuiEvsYsKR8uUHhBTuGP5zjRcGt4nm";// 3. Executor (not used here, so the zero address).const EXECUTOR_ZERO_ADDRESS: Address =  "0x0000000000000000000000000000000000000000";// 4. XRPL destination tag the agent must include in the redemption payment//    (must fit in 32 bits; e.g. an exchange deposit tag).const REDEMPTION_DESTINATION_TAG = 72n;async function main() {  // 5. Resolve the AssetManagerFXRP address from the Flare Contract Registry.  const assetManagerAddress =    await getContractAddressByName("AssetManagerFXRP");  console.log("AssetManagerFXRP address:", assetManagerAddress, "\n");  // 6. Read the protocol-wide minimum redemption amount and assert that the  //    requested amount is above it. Smaller redemptions are rejected on-chain.  const minimumRedeemAmountUBA = await publicClient.readContract({    address: assetManagerAddress,    abi: coston2.iAssetManagerAbi,    functionName: "minimumRedeemAmountUBA",  });  console.log(    "minimumRedeemAmountUBA:",    minimumRedeemAmountUBA.toString(),    "\n",  );  console.log(    "Requested redeem amount UBA:",    REDEEM_AMOUNT_UBA.toString(),    "\n",  );  console.log(    "Redemption destination tag:",    REDEMPTION_DESTINATION_TAG.toString(),    "\n",  );  if (REDEEM_AMOUNT_UBA < minimumRedeemAmountUBA) {    throw new Error(      `Redeem amount (${REDEEM_AMOUNT_UBA.toString()}) must be greater than minimumRedeemAmountUBA (${minimumRedeemAmountUBA.toString()}).`,    );  }  // 7. Simulate the redeemWithTag call to validate args and produce a request  //    that walletClient can submit.  const { request } = await publicClient.simulateContract({    account,    address: assetManagerAddress,    abi: coston2.iAssetManagerAbi,    functionName: "redeemWithTag",    args: [      REDEEM_AMOUNT_UBA,      REDEEMER_UNDERLYING_ADDRESS_STRING,      EXECUTOR_ZERO_ADDRESS,      REDEMPTION_DESTINATION_TAG,    ],  });  // 8. Submit the redemption request transaction on Flare.  const txHash = await walletClient.writeContract(request);  console.log("redeemWithTag tx hash:", txHash, "\n");  // 9. Wait for the transaction receipt.  const receipt = await publicClient.waitForTransactionReceipt({    hash: txHash,  });  console.log("redeemWithTag status:", receipt.status, "\n");  // 10. Decode RedemptionWithTagRequested events from the receipt logs and  //     pick the one that belongs to this redeemer.  const redemptionLogs = parseEventLogs({    abi: coston2.iAssetManagerAbi,    eventName: "RedemptionWithTagRequested",    logs: receipt.logs,  });  const redemptionEvent = redemptionLogs.find(    (log) => log.args.redeemer.toLowerCase() === account.address.toLowerCase(),  );  if (!redemptionEvent) {    throw new Error(      "RedemptionWithTagRequested event not found for this transaction and redeemer",    );  }  console.log("RedemptionWithTagRequested event:", redemptionEvent, "\n");}void main()  .then(() => process.exit(0))  .catch((error) => {    console.error(error);    process.exit(1);  });
```

## Code Breakdown[​](#code-breakdown "Direct link to Code Breakdown")

1.  Set `REDEEM_AMOUNT_UBA` to the amount of FXRP to redeem in UBA (underlying base unit).
2.  Set `REDEEMER_UNDERLYING_ADDRESS_STRING` to the XRPL address that will receive the redeemed XRP from the agent.
3.  `EXECUTOR_ZERO_ADDRESS` is used because no executor is appointed in this example. Pass a real address to delegate default-handling to an executor.
4.  Set `REDEMPTION_DESTINATION_TAG` to the XRPL destination tag the agent must include on the redemption payment. It must fit in a 32-bit integer. See [minting with tag](/fassets/direct-minting#minting-tag-manager) for more details or check out the [minting with tag example](/fassets/developer-guides/fassets-direct-minting-tag) on how to reserve a tag.
5.  Resolve the `AssetManagerFXRP` address through the [Flare Contract Registry](/network/guides/flare-contracts-registry) using [`getContractAddressByName`](/network/guides/flare-contracts-registry).
6.  Read [`minimumRedeemAmountUBA`](/fassets/reference/IAssetManager#minimumredeemamountuba) and check that the requested amount is at least the protocol minimum.
7.  Simulate the [`redeemWithTag`](/fassets/reference/IAssetManager#redeemwithtag) call to validate the arguments and produce a signed request payload.
8.  Submit the redemption request transaction.
9.  Wait for the transaction receipt.
10.  Decode [`RedemptionWithTagRequested`](/fassets/reference/IAssetManagerEvents#redemptionwithtagrequested) events from the receipt logs with the `parseEventLogs` function and select the one whose `redeemer` matches the caller. A single call may emit multiple `RedemptionWithTagRequested` events when multiple agents fulfill the request.

## Important Notes[​](#important-notes "Direct link to Important Notes")

-   **XRP-only feature.** `redeemWithTag` is an XRP-only feature and is only available for FXRP.
-   **`minimumRedeemAmountUBA` is enforced on-chain.** Requests below the threshold revert.
-   **The redemption may be partial.** If the request requires too many redemption tickets, only part is filled and the leftover is returned via [`RedemptionAmountIncomplete`](/fassets/reference/IAssetManagerEvents#redemptionamountincomplete). Call `redeemWithTag` again for the remainder.
-   **Multiple agents may pay.** A single `redeemWithTag` call can produce several [`RedemptionWithTagRequested`](/fassets/reference/IAssetManagerEvents#redemptionwithtagrequested) events — one per agent serving the request. Track each `requestId` for the agent's underlying-chain payment.
-   **Default uses a dedicated proof type.** Confirming a tagged redemption uses `confirmXRPRedemptionPayment`, and if the agent fails to pay call `xrpRedemptionPaymentDefault` to start the default process.

What's next

To continue your FAssets development journey, you can:

-   Redeem any amount without a tag with [`redeemAmount`](/fassets/developer-guides/fassets-redeem-amount).
-   Handle non-paying agents in [Monitor Redemptions & Execute Defaults](/fassets/developer-guides/fassets-redemption-default).
-   Mint without a tag using [memo-based direct minting](/fassets/developer-guides/fassets-direct-minting) or [direct minting with tag](/fassets/developer-guides/fassets-direct-minting-tag).

FAssets demo dApp

The [FAssets demo dApp](https://fassets-demo-dapp.vercel.app/) showcases the FAssets system using the [Flare wagmi periphery package](https://www.npmjs.com/package/@flarenetwork/flare-wagmi-periphery-package). This app is a Next.js reference implementation for settings, minting, tags, transfer, and redeem functionality.

The source code is available in the [fassets-demo-dapp](https://github.com/flare-foundation/fassets-demo-dapp) repository.