Error 实现 error 接口

Set 设置缓存值

Row 添加一行按钮

Get 获取缓存值

--- 测试辅助 ---

Build 构建内联键盘

newMockAdminUseCase 创建默认空实现的 mock

toAdminUseCase 构建真实 *app.AdminUseCase，底层 repo 委托给 mock 函数

Clear 清除用户会话

Create 创建用户

GetDataString 获取临时数据为字符串

newTestRedPacketService 创建测试用的 RedPacketService 及其 mock 依赖 注意: db 传 nil，只测试不依赖事务的方法

Update 更新用户信息

newTestAdminUseCase 创建测试用的 AdminUseCase (仅测试非 gorm.DB 直接操作的方法)

FindByID 根据 ID 查询用户

InternalError 返回 500 错误

newTestMerchantService 创建测试用的 MerchantService 及其 mock 依赖

newTestWithdrawalService 创建测试用的 WithdrawalService 及其所有 mock 依赖

NewDepositMonitor 创建充值监控服务

DisplayName 获取显示名称 (优先 FullName, 其次 Username)

newTestUserService 创建测试用的 UserService 及其所有 mock 依赖

NewCryptoService 创建加密服务

Success 返回成功响应

NewKeyGenerator 创建地址生成器

newTestFinanceService 创建测试用的 FinanceService 及其 mock 依赖 注意: db 传 nil，只测试不依赖事务的方法

Close 关闭连接释放资源

GenerateAddress 生成新的 TRON 地址 流程: 生成私钥 -> 推导公钥 -> Keccak256 哈希 -> 取后 20 字节 -> 加 0x41 前缀 -> Base58Check 编码

SetStepWithData 设置步骤同时写入数据

newTestTransferUseCase 创建测试用的 TransferUseCase 及其 mock 依赖

parseJSONResponse 解析 JSON 响应体

BadRequest 返回 400 错误

newTestDepositService 创建测试用的 DepositService 及其所有 mock 依赖

GenerateToken 生成 JWT Token

Offset 计算数据库查询偏移量

newTestProfileService 创建测试用的 ProfileService 及其所有 mock 依赖

NewAdminUserHandler 创建用户管理处理器

AddAddress 动态添加监控地址 (新用户注册时调用，避免等待缓存刷新)

NewGrpcBlockClient 创建 gRPC 区块扫描客户端 endpoint: gRPC 端点地址，空值使用默认 grpc.trongrid.io:50051 apiKey: TronGrid API Key timeout: 单次 gRPC 调用超时，传 0 使用默认 10s batch

--- 地址缓存管理 --- isMonitoredAddress 检查地址是否在监控列表中 (读操作，使用 RLock)

Button 创建普通回调按钮

UpdateBalance 更新余额 (需在事务中使用)

newTestMonitor 创建用于测试的 DepositMonitor (使用 NewDepositMonitor 确保 addrCache 被初始化)

DecryptPrivateKey 解密私钥 (自动兼容新旧格式) encrypted: 密文字符串 (新格式 "scrypt:base64..." 或旧格式 "base64...") encryptionKey: 加密密钥 返回: 原始私钥 hex 字符串

EncryptPrivateKey 使用 scrypt KDF + AES-256-GCM 加密私钥 privateKeyHex: 原始私钥 hex 字符串 encryptionKey: 加密密钥 (任意长度，通过 scrypt 派生为 32 字节) 返回: "scrypt:" + base64(s

NewAuthHandler 创建认证处理器

getAdminID 从 context 获取管理员 ID

newTestWalletService 创建测试用的 WalletService 及其 mock 依赖

ProcessDeposit 处理充值到账 1. 检查交易是否已存在 (防重复) 2. 创建充值记录 3. 等待确认后更新余额 + 创建交易流水 返回: 充值记录, 是否为新记录, 错误

RegisterModule 注册模块处理器 module: 模块前缀 (如 "Wallet", "Transfer", "Exchange") handler: 该模块的回调处理函数

SetData 存储临时数据

辅助函数：创建 gin 测试上下文并返回 recorder

hashPIN 辅助函数：生成 bcrypt hash

GetStep 获取当前步骤

NewAdminMerchantHandler 创建商户管理处理器

addressCount 返回当前缓存的地址数量

--- 通用辅助函数 --- parsePagination 解析分页参数

GetWalletOverview 获取钱包主页概览数据

注意: ExchangeService.ExecuteExchange 使用了 gorm.DB 事务，无法直接通过 mock port 接口测试。 这里测试非事务方法: GetAllRatesDisplay, GetExchangePair, CalculateExchange newTestExc

newTestUserUseCase 创建测试用的 UserUseCase 及其依赖的 mock

newTestWithdrawalUseCase 创建测试用的 WithdrawalUseCase 及其 mock 依赖

parseIDParam 解析 URL 路径中的 ID 参数

辅助函数：从 recorder 解析 JSON 响应

--- 键盘和显示构建 --- BuildPINKeyboard 构建 4x3 数字键盘

NewWalletService 创建钱包领域服务

buildPINDisplay 构建 PIN 输入状态显示文本 entered: 已输入的数字字符串 (如 "12") mode: "set" / "confirm" / "verify" / "change_old" / "change_new" / "change_confirm"

newTestAdminService 创建测试用的 AdminService 及其 mock 依赖

newTestExchangeUseCase 创建测试用的 ExchangeUseCase 及其 mock 依赖

注意: TransferService.ExecuteTransfer 使用了 gorm.DB 事务和内部 txWalletRepo/txTransferRepo/txTransactionRepo， 无法直接通过 mock port 接口测试事务方法。 这里测试非事务方法: CreateRecei

--- 审计日志 --- CreateAuditLog 创建审计日志 (委托给 AdminService)

FindByUserIDAndCurrencyForUpdate 带行锁查询钱包

ListByUserID 获取用户充值列表 (分页)

NewAdminExchangeRateHandler 创建汇率管理处理器

NewWithdrawalSender 创建提币发送器 configRepo 用于动态读取 withdraw_usdt_auto_threshold 等运营参数

SuccessWithPagination 返回带分页的成功响应

VerifyPIN 验证支付密码 返回: 验证是否通过, 剩余重试次数, 错误

AdjustUserBalance 管理员调整用户余额 amount 为正数表示增加，负数表示扣减

ErrorFromAppError 从 AppError 返回错误响应

FindByUserIDAndCurrency 根据用户 ID 和币种查询钱包

GetBalance 获取用户余额

HandleTextMessage 处理文本消息中的 PIN 输入 PIN 已改为内联键盘输入，文本输入不再处理 PIN 返回 false 表示不是 PIN 流程

L 获取全局 Logger 实例

NewUserService 创建用户领域服务

SendWithdrawal 执行提币发送 返回: (txHash, isManual, error) amount <= threshold: 自动签名广播，返回 txHash amount > threshold: 返回 ("", true, nil) 表示需人工处理 阈值从 system_co

pinButton 创建数字按钮

========== JWTAuth 中间件测试 ========== setupRouter 创建带有 JWTAuth 中间件的测试路由

setupUSDTConfig 设置 USDT 提币配置

AdminOnly 管理员权限检查 (排除 viewer)

BuildWalletHomeText 构建钱包主页消息文本 每行使用不同的自定义 emoji (tg-emoji HTML 标签)，需要 Bot 主人有 Telegram Premium

ClaimRedPacket 领取红包 (Redis 分布式锁保护)

CompleteWithdrawal 完成提币 (链上发送成功后调用) 1. 扣减余额 (解冻 + 扣款) 2. 更新提币记录 3. 创建交易流水

FindByUserID 获取用户所有钱包

GetByID 根据 ID 获取商户详情

GetWallet 获取用户指定币种钱包

GetWithdrawConfig 获取指定币种的提币配置

HasPIN 判断是否已设置支付密码