Heyue_test/PROJECT_INFO.md

YT Asset 合约测试前端项目

项目概述

这是一个用于测试 YT Asset 合约的前端项目，使用 React + TypeScript + WalletConnect 技术栈。

仓库信息

• Git仓库: https://code.desunweb3.com/xie/Heyue_test.git
• 账号: xie
• 访问令牌: ed6a912e50da5e7c67ce64608f112fa1e6b7b71d
• 克隆命令:

git clone https://xie:ed6a912e50da5e7c67ce64608f112fa1e6b7b71d@code.desunweb3.com/xie/Heyue_test.git

部署信息

• 域名: https://maxfight.vip
• 服务器IP: 152.69.205.186
• 端口: 50001
• 反向代理配置: /opt/1panel/apps/openresty/openresty/www/sites/maxfight.vip/proxy/root.conf

合约信息 (Arbitrum Sepolia 测试网)

测试私钥

0xa082a7037105ebd606bee80906687e400d89899bbb6ba0273a61528c2f5fab89

合约地址

合约	地址
YTAssetFactory	0x6DaB73519DbaFf23F36FEd24110e2ef5Cfc8aAC9
YT-A	0x0cA35994F033685E7a57ef9bc5d00dd3cf927330
YT-B	0x333805C9EE75f59Aa2Cc79DfDe2499F920c7b408
YT-C	0x6DF0ED6f0345F601A206974973dE9fC970598587
WUSD	0x939cf46F7A4d05da2a37213E7379a8b04528F590

合约文档位置

/root/Heyue_test/document/合约文档.md

项目结构

/root/Heyue_test/
├── frontend/                    # 前端项目目录
│   ├── src/
│   │   ├── config/
│   │   │   ├── wagmi.ts        # WalletConnect配置
│   │   │   └── contracts.ts    # 合约地址和ABI
│   │   ├── components/
│   │   │   ├── ConnectButton.tsx   # 钱包连接按钮
│   │   │   ├── LanguageSwitch.tsx  # 语言切换组件
│   │   │   ├── WUSDPanel.tsx       # WUSD铸造面板
│   │   │   ├── VaultPanel.tsx      # Vault交易面板
│   │   │   └── FactoryPanel.tsx    # Factory管理面板
│   │   ├── i18n/
│   │   │   ├── index.ts            # i18n配置
│   │   │   └── locales/
│   │   │       ├── en.json         # 英文翻译
│   │   │       └── zh.json         # 中文翻译
│   │   ├── App.tsx
│   │   ├── App.css
│   │   ├── main.tsx
│   │   └── index.css
│   ├── vite.config.ts
│   └── package.json
├── document/
│   └── 合约文档.md              # 合约ABI和详细信息
└── PROJECT_INFO.md             # 本文档

技术栈

• React: 19.2.3
• TypeScript: 5.9.3
• Vite: 7.3.0
• wagmi: 3.1.0
• viem: 2.42.1
• @web3modal/wagmi: 5.1.11
• react-i18next: 国际化支持

WalletConnect配置

• Project ID: 3a8170812b534d0ff9d794f19a901d64 (临时测试ID)
• 获取自己的ID: https://cloud.walletconnect.com/

功能列表

1. WUSD页面

• 显示WUSD余额
• 铸造WUSD代币

2. Vault交易页面

• 选择Vault (YT-A/B/C)
• 显示Vault信息 (总资产、闲置资产、总供应量、硬顶、价格等)
• 买入YT (用WUSD购买)
• 卖出YT (换回WUSD)
• 预览交易结果

3. Factory管理页面

• 显示Factory信息
• 显示所有Vault列表
• Owner可创建新Vault
• Owner可更新Vault价格

4. 国际化

• 支持英文和简体中文
• 语言切换按钮在右上角
• 语言设置保存到localStorage

常用命令

# 进入前端目录
cd /root/Heyue_test/frontend

# 安装依赖
npm install

# 开发模式运行 (端口50001)
npm run dev

# 构建生产版本
npm run build

# 后台启动开发服务器
nohup npm run dev > /tmp/vite.log 2>&1 &

# 查看运行日志
cat /tmp/vite.log

# 杀掉占用50001端口的进程
lsof -i :50001 | grep -v "^COMMAND" | awk '{print $2}' | xargs -r kill -9

Vite配置 (vite.config.ts)

export default defineConfig({
  plugins: [react()],
  server: {
    port: 50001,
    host: '0.0.0.0',
    strictPort: true,
    allowedHosts: ['maxfight.vip', 'localhost', '127.0.0.1'],
  }
})

注意事项

1. @web3modal/wagmi 已被官方弃用，建议迁移到 Reown AppKit
2. 当前使用的是公共测试WalletConnect项目ID，生产环境建议使用自己的ID
3. 合约部署在Arbitrum Sepolia测试网

待办事项

• 迁移到 Reown AppKit (替代 @web3modal/wagmi)
• 添加交易历史记录
• 添加更多错误处理和用户提示
• 优化打包大小 (当前有大chunk警告)

---

文档更新时间: 2025-12-15