Skip to main content
Minting and redeeming happen on the contract itself, one for one, in a single transaction. Only wallets Hamilton has approved can call these functions. To become one, see How it works or email partners@hamilton.xyz.

Who can call what

  • Approval is per calling address. Minting and redeeming are approved separately. Check them with mintWhitelist(address) and redeemWhitelist(address).
  • The contract checks the caller, not the receiver. An approved route can mint USDh straight to its user’s wallet.
  • Accepted stablecoins are listed by supportedStables(). Today that is USDC only.

Mint

1

Approve the stablecoin

Approve the USDh contract to take the stablecoin amount from your wallet.
2

Call mintWithStable

The contract takes the stablecoin and sends the same amount of USDh to to, in the same transaction.
mint.ts
There is no daily cap when minting with a stablecoin. The daily cap only applies to USDh created against bank wires.

Redeem

Call redeemForStable(stable, usdhAmount, to). The USDh is burned from the caller, and the same amount of the stablecoin is sent to to.
redeem.ts

The redemption limit

Each address has its own limit in each 7-day window.
If your contract mints to your users instead of to itself, your own address never receives a balance, so its default limit stays at zero. Redemptions then fail with redeem cap not set. Ask Hamilton to set a limit for your address before you go live.

Minimal interface

IUSDh.sol

Go-live checklist

  1. Hamilton has confirmed which of your addresses can mint and which can redeem.
  2. You have tested a small mint and a small redemption.
  3. Your redemption limit is set, if your contract mints to your users.
  4. Your sanctions screening matches what your agreement with Hamilton requires.
Last updated: 17 November 2026