j-box · 链上签到工具（开源）

一个纯前端单页面应用，用于执行特定合约交互（默认场景：checkIn(uint256 tokenId)）。

项目特点是：无需后端、可本地导入钱包、支持交易预检（Gas 估算）与发送前确认。

---

功能概览

• 钱包导入：支持私钥 / 助记词导入
• 本地缓存：可选“记住钱包”，采用密码加密后写入浏览器本地存储
• 网络校验：可按填写的 Chain ID 与 RPC 返回链 ID 做一致性校验
• NFT 自动读取：通过 balanceOf + tokenOfOwnerByIndex 获取持仓 tokenId，并自动填入第一个 tokenId
• 交易预检：Gas 估算
• 风险分级：按函数进行高风险/中风险提示
• 二次确认：发送交易前展示预览信息，并要求手动确认
• 转账能力：支持发送 WJ，并展示转账前后余额对比
• 安全退出：支持一键清空敏感输入与运行态数据

---

页面流程（按步骤执行）

1. 连接钱包
   导入私钥/助记词，或解锁本地已缓存钱包。

2. 设置参数
   填写 RPC、合约地址、tokenId（可自动带入）；必要时展开高级设置（Chain ID / 函数名 / ABI）。

3. 预检并发送
   先看交易预览与 Gas 预检结果，再确认广播交易。

---

快速开始

方式一：直接打开

直接用浏览器打开 index.html。

方式二：本地静态服务（推荐）

在项目目录执行：

python3 -m http.server 4173

然后访问：

http://localhost:4173/

---

安全模型说明

• 钱包密钥仅在当前页面运行时内存中使用
• 勾选“记住此钱包”后，密钥会使用密码派生密钥加密后存储到 localStorage
• 加密方案基于 WebCrypto（PBKDF2 + AES-GCM）
• 页面支持发送前预检与人工确认，但不替代你对交易内容的独立审查

---

安全风险提示（请务必阅读）

• 本工具不是托管钱包，也不提供资产保险
• 私钥/助记词一旦泄露，资产可能不可逆损失
• 链上交易通常不可撤销，错误参数会导致资产或权限风险
• Gas 估算通过，不等于最终链上 100% 成功（状态可能在打包前变化）
• 使用公共 RPC 可能出现不稳定、延迟、错误返回或被限流
• 请优先在小额、测试场景验证后再用于真实资产

---

环境安全建议（强烈建议）

• 优先在本地单机运行，不建议直接在公网页面输入私钥/助记词
• 使用干净浏览器 Profile，禁用不必要扩展，避免剪贴板/输入被插件读取
• 系统与浏览器保持更新，开启杀毒和基础主机防护
• 不在公共电脑、远程共享桌面或来路不明设备上操作
• 大额资产请使用硬件钱包或仅用低权限专用账户
• 使用后执行“安全退出”，并按需清除本地缓存

---

责任边界

• 本项目按“现状”提供，不承诺适用于任何特定目的
• 使用者需自行评估合约调用与资产风险，并承担由此产生的后果
• 因用户设备环境不安全、扩展/木马、错误配置或误操作导致的资产损失，开发者不承担赔付责任

---

开源说明

• 欢迎 Fork / Issue / PR 一起完善
• 建议在仓库根目录补充 LICENSE 文件后再公开发布，以明确开源许可边界

---

适用场景

• 需要快速执行固定函数调用（如签到）
• 需要可视化预检与风险确认的轻量化运营工具
• 不希望引入后端服务的本地化交互场景