> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hamilton.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Handle pauses, freezes and limits

> Every common reason a USDh call fails, the error you get, and how to check first.

**A USDh call fails for a small number of known reasons, and each one can be checked before you send.** Handle them so a failed call shows a clear message instead of breaking your app.

## Transfers

| Situation | Error | Check first |
| - | - | - |
| The whole system is paused | `EnforcedPause()` | `paused()` returns `true` |
| The sender is frozen | `from frozen` | `frozen(sender)` returns `true` |
| The receiver is frozen | `to frozen` | `frozen(receiver)` returns `true` |
| Not enough balance | `ERC20InsufficientBalance` | `balanceOf(sender)` |
| Not enough allowance | `ERC20InsufficientAllowance` | `allowance(owner, spender)` |

A freeze never takes a balance. A frozen address keeps its USDh until it is unfrozen. Pauses and freezes are used only for sanctions and emergencies.

## Minting and redeeming

| Situation | Error | Check first |
| - | - | - |
| The caller is not approved to mint | `not mint whitelisted` | `mintWhitelist(caller)` |
| The caller is not approved to redeem | `not redeem whitelisted` | `redeemWhitelist(caller)` |
| The stablecoin is not accepted | `stable not supported` | `supportedStables()` |
| The amount is zero | `amount=0` | |
| The receiver is the zero address | `to=0` | |
| The address has no redemption limit yet | `redeem cap not set` | `effectiveRedeemCap(caller)` returns `0` and `redeemCapOverrideSet(caller)` returns `false` |
| The redemption limit is used up | `redeem cap exceeded` | `effectiveRedeemCap(caller)` minus `redeemedInWindow(caller)` |

## Transfers with authorization

| Situation | Error |
| - | - |
| `receiveWithAuthorization` called by someone other than the receiver | `caller must be payee` |
| The nonce was already used or cancelled | The call reverts. Generate a new random nonce |
| Outside the `validAfter` and `validBefore` window | The call reverts. Sign a new authorization |

## Limits at a glance

| Limit | Value today | Changed by |
| - | - | - |
| Redemption window | 7 days per address | Timelock, 48 hours' notice |
| Default redemption limit | Half the balance when USDh was last minted to the address | Timelock, 48 hours' notice |
| USDh created against wires | 10,000,000 USDh per 24 hours, shared by all Mint Users | Timelock, 48 hours' notice |
| USDh created with a stablecoin | No cap | |

The business limits, such as the USD 100,000 minimum mint, are on [Limits and fees](https://docs.hamilton.xyz/using-hamilton/limits-and-timing.md).

*Last updated: 17 November 2026*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.