blocsys-technologies/wallet-reputation-extension

# 钱包地址信誉徽章 **加密钱包的来电显示** —— 一款浏览器扩展，能在网络上的每个 Ethereum 钱包地址旁叠加显示即时的信任徽章（安全 / 警告 / 高风险）。  ## 功能 - **实时钱包检测** —— 适用于任何网页：Etherscan、OpenSea、Uniswap、X / Twitter、Discord、Telegram、DeFi 应用、NFT 市场、博客。 - **内联信任徽章** —— 采用毛玻璃效果、现代 Web3 风格，高危钱包带有脉冲红光警示。 - **悬停提示框** —— 显示风险级别、原因、合约类型、安全标记、蜜罐状态、钓鱼检测及上次检查时间。 - **点击侧边面板** —— 提供完整的安全分析和建议。 - **右键上下文菜单** —— 对任何选中文本可使用“检查钱包信誉”功能。 - **高风险 Chrome 通知** —— 确保您绝不会错过任何关键警告。 - **弹出窗口控制面板** —— 显示统计信息、近期扫描、手动查询和各项控制。 - **选项页面** —— 细粒度设置（主题、徽章大小、提示框位置、扫描频率、通知）及关于部分。 - **ENS 支持** —— 自动解析 `*.eth` 域名。 - **24小时本地缓存**（内存 + `chrome.storage.local`） —— 访问快速，对 API 友好。 - **符合 CSP 规范**，无 `eval`，无内联 JS，DOM 注入经过安全过滤处理。 ## 技术栈 - React 18 + TypeScript（严格模式） - Vite 5 + `@crxjs/vite-plugin`（用于 MV3 打包） - Tailwind CSS 3（暗黑模式 + 毛玻璃效果设计系统） - Zustand（状态管理），Framer Motion（动画），Lucide（图标） - **单一 API** 获取安全数据：[GoPlus Security](https://docs.gopluslabs.io/) ## 快速开始 ``` # 安装依赖 npm install # 构建扩展至 ./dist npm run build # 在 Chrome 中加载 # - 前往 chrome://extensions # - 启用 "Developer mode" # - 点击 "Load unpacked" 并选择 ./dist 文件夹 ``` ### 开发（支持 popup / options 页面的 HMR） ``` npm run dev ``` 此命令会监听源文件并自动重新构建 `./dist` 目录。更改 manifest 后，请从 `chrome://extensions` 页面重新加载扩展。 ### 类型检查 / Lint ``` npm run type-check npm run lint ``` ### 打包上架 Chrome Web Store ``` npm run package # creates ./wallet-reputation-badge.zip ``` ## 目录结构 ``` src/ ├── assets/icons/ # extension-logo.png + 16/32/48/128 extension icons ├── background/ # MV3 service worker (api, storage, notifications, ctx menu) ├── components/ # Reusable React UI (popup + options) ├── content/ # Content scripts (scanner, badge, panel, CSS) ├── hooks/ # React hooks (useReputation, useChromeStorage, useTheme) ├── options/ # Options + About page (React) ├── popup/ # Popup dashboard (React) ├── services/ # GoPlus client, storage layer, messaging bus ├── store/ # Zustand store ├── styles/ # Tailwind globals + design tokens ├── types/ # All TypeScript types — strict, no `any` └── utils/ # Constants, helpers, sanitization, verdict engine ``` ## 工作原理（架构） ``` webpage background sw GoPlus API ┌─────────────────┐ CHECK_ADDRESS ┌──────────────┐ GET /v1/ ┌────────────┐ │ content script │ ──────────────▶ │ message bus │ ───────────▶ │ Address Sec│ │ (TreeWalker + │ ◀────────────── │ + cache │ ◀─────────── │ endpoint │ │ MutationObserver)│ ReputationReport (memory + chrome.storage) └────────────┘ └────────┬────────┘ └──────┬───────┘ │ inject badge │ ▼ ▼ (high-risk) ┌─────────────────┐ ┌──────────────┐ │ inline badge + │ │ chrome │ │ tooltip + panel │ │ notifications│ └─────────────────┘ └──────────────┘ ``` - **content script** 采用纯 TS 编写，以确保性能和 CSP 安全。 - **popup / options 页面** 使用 React + Tailwind 构建。 - 所有 API + 存储的数据流均通过 **background service worker** 路由，因此缓存可在各个标签页间共享，并且仅使用单一的限速器。 ## 隐私 我们不追踪钱包所有权。我们不收集个人数据。信誉报告会在您的设备上本地缓存 24 小时。唯一发出的外部请求是向您遇到的钱包地址发出的查询，该请求通过 HTTPS 发送至 GoPlus Security API。查看完整政策 → [blocsys.com/privacy-policy](https://blocsys.com/privacy-policy)。 ## 支持 - 联系方式：[blocsys.com/contact](https://blocsys.com/contact-us) - 隐私政策：[blocsys.com/privacy-policy](https://blocsys.com/privacy-policy) - 问题 / 功能请求：请通过联系页面与我们取得联系。 ## 路线图 请参阅 [`docs/FUTURE_SCALING.md`](./docs/FUTURE_SCALING.md) 获取包含分析、社区报告、高级订阅及可选后端服务层的公共路线图。 ## 许可证 MIT — © Blocsys。

标签：DeFi, ENS支持, Etherscan, Framer Motion, GoPlus Security API, Manifest V3, NFT, OpenSea, React, Syscalls, Tailwind CSS, TypeScript, Uniswap, Vite, Web3安全, Zustand, 以太坊生态, 加密货币, 区块链安全, 反欺诈, 多链浏览器扩展, 安全情报, 安全插件, 实时处理, 搜索语句（dork）, 自动化攻击, 诈骗防范, 钓鱼检测, 钱包地址信誉