ClaimX

ClaimX - AI智能金融生态系统平台

专注于新数字资产领域，引导您发现价值

�� 项目简介

ClaimX 是一个基于比特币生态系统的去中心化应用平台，旨在打破传统金融体系的壁垒，为全球用户提供简单、高效、低门槛的加密货币接入方式。平台专注于比特币铭文（Inscription）、符文（Rune）以及创新的空投机制。

✨ 核心特性

• 🪙 比特币铭文（Inscription） - 创建、管理和交易比特币铭文
• �� 比特币符文（Rune） - 支持符文的蚀刻、铸造和转移操作
• 🎁 智能空投系统 - 基于生物体征验证和DID系统的精准空投
• 💼 多钱包支持 - 集成主流比特币钱包，支持多种地址格式
• �� 多语言国际化 - 支持中文、英语、法语、日语、俄语
• 📊 链上数据分析 - 实时监控和分析比特币网络数据
• 🔧 实用工具集 - 批量转账、UTXO管理等实用功能

🛠️ 技术栈

前端框架

• Next.js 15.5 - React 全栈框架，支持SSR和SSG，使用最新的App Router
• TypeScript 5.5 - 类型安全的JavaScript超集
• React 18 - 用户界面构建库

样式和UI

• Tailwind CSS 4.1 - 实用优先的CSS框架，支持最新特性
• HeroUI - 现代化的React组件库
• Framer Motion - 动画库
• Iconify - 图标库

代码质量和工具

• ESLint 9.34 - 代码质量检查，使用新的扁平配置格式
• Prettier - 代码格式化工具
• TypeScript ESLint - TypeScript专用ESLint规则
• Security Plugin - 安全检查插件
• SonarJS - 代码质量分析

比特币相关

• bitcoinjs-lib - 比特币JavaScript库
• bip32/bip39 - HD钱包和助记词支持
• ecpair - 椭圆曲线密钥对管理

状态管理和工具

• Zustand - 轻量级状态管理
• SWR - 数据获取库
• Next Intl - 国际化支持
• ECharts - 数据可视化

📦 安装和运行

环境要求

• Node.js 22.x
• Yarn 或 npm

克隆项目

git clone <repository-url>
cd Claim.X

安装依赖

yarn install
# 或
npm install

开发环境运行

yarn dev
# 或
npm run dev

访问 http://localhost:3000 查看应用。

构建生产版本

yarn build
yarn start
# 或
npm run build
npm start

🔍 代码检测和格式化

ESLint 代码质量检查

# 检测所有文件
yarn lint

# 检测并自动修复
yarn lint --fix

# 检测特定文件
yarn lint app/components/Button.tsx

# 检测特定目录
yarn lint app/components/

TypeScript 类型检查

# 类型检查
yarn tsc --noEmit

# 监听模式类型检查
yarn tsc --noEmit --watch

代码格式化

# 格式化所有代码
yarn format

# 检查代码格式
yarn format:check

完整构建检测

# 包含类型检查和ESLint的完整构建
yarn build

# 开发模式（实时检测）
yarn dev

ESLint 配置说明

项目使用 ESLint 9.x 的新扁平配置格式 (eslint.config.js)，包含以下规则：

• 代码质量规则 - 复杂度控制、文件行数限制
• TypeScript 规则 - 类型安全、最佳实践
• React 规则 - JSX规范、组件最佳实践
• 安全规则 - 对象注入检测、潜在安全风险
• 导入/导出规则 - 模块导入规范
• 代码风格规则 - 空格、标点符号规范

VS Code 集成

推荐安装以下扩展以获得最佳开发体验：

• ESLint - 实时显示ESLint错误和警告
• TypeScript - TypeScript语言支持
• Prettier - 代码格式化
• Tailwind CSS IntelliSense - Tailwind CSS智能提示

�� 主要功能模块

1. 首页（Home）

• 平台概览和最新资讯
• 市场数据展示
• 快速导航入口

2. 领取页面（Claim）

• 空投资格检查
• 奖励领取功能
• 领取历史记录

3. 空投（Drops）

• 活跃空投项目展示
• 参与资格验证
• 空投进度跟踪

4. 协议（Protocol）

• 比特币铭文协议介绍
• 符文协议说明
• 技术文档

5. 工具（Tool）

• UTXO管理工具
• 批量转账功能
• 链上数据查询

6. 个人中心（Me）

• 钱包连接管理
• 资产概览
• 操作历史

�� 国际化支持

项目支持以下语言：

• 🇨🇳 中文 (zh)
• 🇺🇸 英语 (en)
• 🇫🇷 法语 (fr)
• ��🇵 日语 (ja)
• 🇷🇺 俄语 (ru)

语言配置文件位于 i18n/messages/ 目录下。

🔧 项目配置

网络配置

支持以下比特币网络：

• Bitcoin Mainnet
• Bitcoin Testnet
• Fractal Bitcoin Mainnet
• Fractal Bitcoin Testnet

地址格式支持

• P2TR (bc1p) - Taproot地址
• P2WPKH (bc1) - Native SegWit地址
• P2SH (3) - Pay-to-Script-Hash地址
• P2PKH (1) - Legacy地址

�� 项目结构