# user.ts

**路径**：`src/api/user.ts`

## 功能用途

用户相关接口：获取用户信息、USDC 余额、修改自身用户名。对接 `/user/getUserInfo`、`/user/getUsdcBalance`、`/user/setSelfUsername`，均需鉴权。

## 核心能力

- `getUserInfo`：获取当前用户信息（头像、昵称等）
- `getUsdcBalance`：查询 USDC 余额（amount、available、locked 需除以 1_000_000）
- `setSelfUsername`：修改自身用户名（PUT `/user/setSelfUsername`）
- `formatUsdcBalance`：将原始数值转为显示用字符串（如 "0.00"）

## 类型说明

| 类型 | 说明 |
|------|------|
| `UserInfoData` | 用户信息结构 |
| `UsdcBalanceData` | 余额结构，amount/available/locked 为原始值 |

## 使用方式

```typescript
import { getUserInfo, getUsdcBalance, setSelfUsername, formatUsdcBalance } from '@/api/user'

const headers = { 'x-token': token, 'x-user-id': userId }

const userRes = await getUserInfo(headers)
const balanceRes = await getUsdcBalance(headers)

if (balanceRes.data) {
  const display = formatUsdcBalance(balanceRes.data.available)
}

// 修改自身用户名
const setRes = await setSelfUsername(headers, { username: 'new_username' })
if (setRes.code === 0 || setRes.code === 200) {
  // 建议：成功后调用 fetchUserInfo() 刷新页面展示
}
```

## 扩展方式

1. **更新个人信息**：新增 `updateUserInfo` 接口
2. **交易记录**：新增 `getUserTrades` 等接口
3. **多币种**：扩展 `UsdcBalanceData` 支持其他资产