> ## 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.

# Build with USDh

> What you can build with USDh, the networks it runs on, and where to start.

**USDh is a standard ERC-20 token on Ethereum, so any app that handles USDC can handle USDh.** There is no API or SDK to install. You work directly with the token contract, which is open source and verified on Etherscan.

## What you can build

> [card] [Accept and hold USDh](https://docs.hamilton.xyz/for-developers/accept-usdh.md)
>
> Wallets, payment apps, treasuries and exchanges. Show balances, send and receive USDh.

> [card] [Mint and redeem from code](https://docs.hamilton.xyz/for-developers/mint-and-redeem.md)
>
> For Mint Users and approved routes such as aggregators. Turn USDC into USDh and back, one for one.

> [card] [Handle pauses, freezes and limits](https://docs.hamilton.xyz/for-developers/errors-and-limits.md)
>
> Every way a call can fail, and how to check before you send it.

> [card] [Contract reference](https://docs.hamilton.xyz/for-developers/reference.md)
>
> Every function, event and error you are likely to use.

## Networks

| Network | Chain ID | USDh address |
| - | - | - |
| Ethereum mainnet | 1 | [`0xbcFC42391e55484129191eDfcC766a2c6F9eb503`](https://etherscan.io/token/0xbcfc42391e55484129191edfcc766a2c6f9eb503) |

More networks are planned. Any address not listed on [Contracts](https://docs.hamilton.xyz/for-developers/contract-addresses.md) is not current.

## USDh at a glance

| | |
| - | - |
| Standard | ERC-20, with EIP-2612 `permit` and EIP-3009 transfers with authorization |
| Decimals | 6, the same as USDC |
| Upgrades | Behind a proxy. The address never changes. New code can only take effect 48 hours after it is scheduled in public |
| Admin powers | Held by a timelock and separate multisig wallets. See [Roles and permissions](https://docs.hamilton.xyz/for-developers/roles.md) |
| Can a balance be taken? | No. An address can be frozen for sanctions, but there is no code to move or seize a balance |
| Audit | Not audited yet. See [Security](https://docs.hamilton.xyz/trust-and-transparency/security-and-audits.md) |

## Who to contact

Building something with USDh, or want to mint and redeem as an approved route? Email [partners@hamilton.xyz](mailto:partners@hamilton.xyz).

*These pages describe the contract code live on Ethereum today, in force since 13 August 2026.*

*Last updated: 17 November 2026*


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