# Maturity redemption Source: https://docs.settlemint.com/docs/operators/token-features/maturity-redemption How operators configure the maturity-redemption token feature, complete issuance before maturity, and trigger holder redemption when a fixed-income asset reaches its maturity date. The maturity-redemption token feature handles the end-of-life redemption flow for fixed-income instruments. After the maturity date, an authorised operator triggers the redemption state, the feature transfers face value from the configured treasury to each holder, and the position burns. Holders cannot transfer after the maturity-state transition. Maturity also closes issuance. The supply outstanding at maturity becomes the fixed redemption basis, and the platform stops accepting new mints for the token from that point on. Complete all issuance before you mature the instrument. For the architecture and lifecycle model, see [Maturity redemption](/docs/architects/components/token-features/maturity-redemption). ## When it attaches [#when-it-attaches] Bond, CD, and structured-note templates attach maturity-redemption. See the fixed-income, cash, and structured sections of the [system templates catalog](/docs/operators/asset-creation/system-templates). ## What you configure [#what-you-configure] In the Asset Designer details step, fill the maturity-redemption parameter block: | Parameter | Description | | ------------------- | --------------------------------------------------------------------------------------- | | `maturityDate` | Date the instrument matures. Immutable after deployment for most templates. | | `denominationAsset` | ERC-20 token face value pays in. Typically the same token the instrument was priced in. | | `treasury` | Wallet that holds the denomination asset and funds redemption payments. | | `faceValue` | Redemption amount per token, in the denomination asset's units. | The denomination-asset prerequisite is checked when you select a template: if no compatible ERC-20 exists in the tenant, the template card is disabled until you create or register one. ## What you operate [#what-you-operate] After deployment, work through these steps in order: 1. Fund the treasury before maturity. It must hold at least `faceValue × totalSupply` of the denomination asset so every holder can redeem. 2. Finish issuance before triggering maturity. The platform fixes the redemption basis to the supply at that moment and rejects new mints from then on, so issue the full intended supply first. 3. Trigger maturity on or after the maturity date through the asset detail workspace's maturity tab. The trigger moves the asset into redemption state and blocks new mints and holder transfers. 4. Holders claim through the platform's redemption flow. The platform transfers face value from the treasury to each holder and burns the position. 5. Reconcile leftovers: any treasury balance remaining after all holders have redeemed stays in the treasury for the operator to reclaim. ## Redemption solvency check [#redemption-solvency-check] When a holder opens the redeem-at-maturity sheet, the Console previews the payout and checks treasury solvency before letting them sign. The payout is calculated as the redeem amount multiplied by face value, and that figure is compared against the treasury's available denomination-asset balance. * While the treasury balance is still resolving, the sheet shows **Verifying treasury balance…** and keeps the redeem button disabled. * If the treasury cannot cover the payout, the sheet shows a **Treasury funding gap** warning with the requested payout next to the treasury available balance, and keeps the redeem button disabled until the treasury is topped up. * When the treasury balance is known and covers the payout, the holder can continue and sign. The same check runs whether the holder reaches redemption from the asset's maturity tab or from the global task queue, so an underfunded redemption is stopped before signing in both paths. Keep the redemption treasury funded so holders are not blocked at this step. ## Operating considerations [#operating-considerations] * The redemption-state transition is one-way. The platform does not support un-matureing an asset. * Maturity closes ordinary issuance. After maturity the redemption budget is fixed to the supply recorded at maturity, so a token matured with zero outstanding supply has a zero redemption budget. Mint the full intended supply before you mature. * Redemptions and authorised custodian transfers still work after maturity. Maturity blocks new issuance and ordinary holder transfers. Holders can still burn their position to redeem, and custodians can still apply forced corrections. * Fund the treasury before holders redeem. The redeem sheet checks treasury solvency and blocks signing when the treasury cannot cover the payout. It does not move funds for you, so a short treasury keeps holders at the funding-gap warning until you top it up. * Transfers up to the maturity date run through the asset's normal compliance modules. The maturity feature does not change whether a transfer is eligible prior to that date. * Some templates fix the redemption treasury to the deploying wallet rather than prompting for it when you create the asset. Read the template detail in the catalog to confirm. ## Troubleshooting [#troubleshooting] | What you see | What to check | | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Mint rejected on a matured token | Maturity closes issuance. The redemption basis is fixed to the supply at maturity, so the platform rejects new mints and hides the mint button once the token is matured. Issue any remaining supply before maturity, or create a new instrument for fresh supply. | | Holder redemption fails after maturity | Confirm the redemption treasury holds enough of the denomination asset to cover face value for the requesting holder. | | Redeem button stays disabled with a "Treasury funding gap" warning | The requested payout exceeds the treasury's available balance. Top up the redemption treasury so it covers the payout (redeem amount × face value), then reopen the sheet. | | Redeem sheet shows "Verifying treasury balance…" | Treasury solvency data is still resolving. Wait for the balance to load; if it does not resolve, confirm the redemption treasury is configured and reachable. | | Maturity trigger rejected | Confirm the maturity date has passed and the trigger is submitted by an account with the maturity role. | | Transfers still pass after maturity | Confirm the maturity trigger has confirmed on chain; the state transition is asynchronous. | ## Read next [#read-next] * [Maturity redemption architecture](/docs/architects/components/token-features/maturity-redemption) * [Fixed treasury yield](/docs/operators/token-features/fixed-treasury-yield): often paired with maturity-redemption for coupon-paying bonds. * [System templates catalog](/docs/operators/asset-creation/system-templates#fixed-income-asset-class-fixed-income)