🔮 PopMON (泡姆) - Fully On-Chain Web3 Gacha MachinePop! 爆出你的专属 Monad 极品卡牌!PopMON 是一款部署在 Monad Testnet 上的复古像素风 Web3 扭蛋机 / 刮刮乐 DApp。利用 Monad 的亚秒级出块和超低延迟,为你带来媲美 Web2 盲盒极其丝滑的“上头”抽卡体验。(建议在此处替换为实际的 Banner 截图)🎮 核心特性 (Key Features)纯链上概率与透明度 (Fully On-Chain Probability): 得益于 Monad 支持的 128KB 超大合约容量,所有的卡池爆率、抽卡逻辑和资产结算均通过 GachaPool.sol 智能合约在链上执行,绝对公平、开源且防篡改。原生代币支付 (Native MON Integration): 抛弃繁琐的稳定币转换,玩家直接使用 $MON 支付开启卡包(例如:1 MON / 次),完美融入 Monad 原生经济模型。复古沉浸式 Vibe (Immersive Pixel-Art Vibe): 精心设计的 8-bit 像素风 UI,内置专属“上头”芯片音乐 (Chiptune BGM),搭配刮刮乐物理涂层擦除动画 (ScratchReveal),情绪价值拉满。Monad 专属创世卡包 (Monad Genesis Pack): 首发包含 Monad 社区标志性吉祥物与文化符号 NFT(如 The Gazer, Cozy Muku, Pulse Icon 等),划分为 Legendary, Epic, Rare 等稀有度。实时全网抽卡广播 (Live Pulls Feed): 首页实时滚动全网玩家的出金记录,刺激社区的 FOMO 情绪。🛠 技术栈 (Tech Stack)前端 (Frontend / Web)框架: React 18 + Vite + TypeScript样式: Tailwind CSS + 自定义复古像素字体/动画Web3 交互: Ethers.js / Wagmi (用于连接钱包与合约交互)部署: Vercel智能合约 (Smart Contracts)语言: Solidity (^0.8.20)开发环境: Hardhat + TypeScript网络: Monad Testnet📁 目录结构 (Directory Structure)PlaintextPopMON/
├── contracts/ # 智能合约目录
│ ├── contracts/
│ │ ├── GachaCard.sol # ERC721/ERC1155 NFT 资产合约
│ │ └── GachaPool.sol # 扭蛋机核心逻辑、概率控制与金库合约
│ ├── scripts/
│ │ └── deploy.ts # 自动化部署脚本
│ └── hardhat.config.ts # Hardhat 配置 (包含 Monad Testnet 节点信息)
│
└── web/ # 客户端前端目录
├── public/ # 静态资源 (BGM, 像素 Logo, 卡面原图)
├── src/
│ ├── components/ # 复用组件 (RarityBadge, CardRevealModal, 刮刮乐特效等)
│ ├── pages/ # 页面路由 (首页、抽卡页、我的收藏页)
│ ├── abis.ts # 编译后的智能合约 ABI 文件
│ └── config.ts # 全局配置 (RPC, 合约地址等)
└── tailwind.config.cjs # Tailwind 主题与像素风扩展配置
🚀 快速启动 (Quick Start)1. 部署智能合约 (Contracts)请确保你的钱包已切换至 Monad Testnet 并且有足够的测试网 $MON 余额。Bashcd contracts
npm install
# 配置你的私钥到环境变量 (如 .env 文件)
# 编译合约
npx hardhat compile
# 部署到 Monad Testnet
npx hardhat run scripts/deploy.ts --network monadTestnet
部署成功后,请将控制台输出的 GachaPool 和 GachaCard 合约地址更新到前端的 web/src/config.ts 中。2. 运行前端项目 (Web)Bashcd web
npm install
# 启动本地开发服务器
npm run dev
打开浏览器访问 http://localhost:5173 即可体验。🗺 路线图 (Roadmap)[x] v1.0 - 创世爆芒: 完成基础架构部署,上线 Monad 创世像素卡包,跑通 $MON 支付与全链上随机数开盲盒逻辑。[ ] v1.5 - EIP-7702 丝滑集成: 接入 Monad 特色的 EIP-7702 授权机制,实现“一键授权,免签名连续百连抽”,彻底消灭 Web3 交互摩擦。[ ] v2.0 - 燃烧与质押池: 引入经济循环模型。玩家可以销毁 (Burn) 重复的普通卡牌兑换奖池中的 $MON 回血,或通过质押获取每日免费抽卡额度。[ ] v3.0 - 开放创造者卡池: 允许外部艺术家与社区项目方通过 PopMON 协议无代码部署他们自己的主题扭蛋机。📜 许可证 (License)MIT LicenseBuilt for the Monad Ecosystem. Insert Coin & Let's Pop! 👾