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

# Quickstart

> Read a USDh balance and send USDh from your app in a few minutes.

**This page gets you from nothing to a working USDh balance and transfer.** The examples use [viem](https://viem.sh). Any Ethereum library works the same way, because USDh is a standard ERC-20.

**1. Add the contract**

Use the proxy address. Never use the implementation address behind it.

```typescript usdh.ts theme={null}
import { erc20Abi } from "viem";

export const USDH = {
  address: "0xbcFC42391e55484129191eDfcC766a2c6F9eb503",
  abi: erc20Abi,
} as const;
```

**2. Read a balance**

USDh has 6 decimals, so `1000000` base units is 1 USDh. Read `decimals()` rather than hard-coding it.

```typescript balance.ts theme={null}
import { createPublicClient, http, formatUnits } from "viem";
import { mainnet } from "viem/chains";
import { USDH } from "./usdh";

const client = createPublicClient({ chain: mainnet, transport: http() });

const [raw, decimals] = await Promise.all([
  client.readContract({ ...USDH, functionName: "balanceOf", args: ["0xYourAddress"] }),
  client.readContract({ ...USDH, functionName: "decimals" }),
]);

console.log(`${formatUnits(raw, decimals)} USDh`);
```

**3. Send USDh**

A transfer works like any ERC-20 transfer.

```typescript transfer.ts theme={null}
import { parseUnits } from "viem";
import { USDH } from "./usdh";

const hash = await walletClient.writeContract({
  ...USDH,
  functionName: "transfer",
  args: ["0xRecipient", parseUnits("25", 6)], // 25 USDh
});
```

**4. Handle the two USDh-specific cases**

A transfer can fail if the whole system is paused, or if the sender or receiver is frozen. Check before you send, and show a clear message if either is true. See [Handle pauses, freezes and limits](https://docs.hamilton.xyz/for-developers/errors-and-limits.md).

## Next

* Accepting USDh in a product: [Accept and hold USDh](https://docs.hamilton.xyz/for-developers/accept-usdh.md)
* Minting and redeeming as a Mint User or approved route: [Mint and redeem from code](https://docs.hamilton.xyz/for-developers/mint-and-redeem.md)

*Last updated: 17 November 2026*


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