Home

GSL (HIVE) 项目 Wiki

GSL 是一个基于 Berachain 的 DeFi 生态系统，核心围绕 HIVE 代币的质押挖矿、流动性提供、代币兑换和 FOMO3D 博弈游戏。

文档导航

项目概览

• 项目总览 — 系统架构、代码库组成、核心业务模块、合约地址

技术文档

• API接口文档 — 全部 HTTP API + 链上合约接口
• 智能合约文档 — Solidity 合约清单、数据结构、部署配置、安全特性
• 数据库模型文档 — MySQL 表结构、字段说明、枚举值、定时任务

权限与安全

• 权限与角色文档 — 三层权限体系（链上/后端/前端）、敏感操作、用户等级

业务逻辑与运维

• 业务逻辑与部署配置 — 奖励计算公式、环境配置、构建指南、外部依赖

代码库分析

• codebase-技术栈 — 语言、框架、依赖
• codebase-系统架构 — 架构模式、层次、数据流
• codebase-目录结构 — 文件组织、关键位置
• codebase-代码规范 — 编码风格、命名约定
• codebase-测试 — 测试框架与实践
• codebase-外部集成 — 第三方服务、区块链集成
• codebase-技术关注点 — 技术债务、安全问题

---

代码库组成

代码库	技术栈	说明
gsl-contracts	Solidity 0.8.25 / Foundry	链上智能合约
hive-gls-java	Spring Boot 2.7 / MyBatis Plus / Web3j	Java 后端服务
gsl-web-admin	Vue 3 / TypeScript / Element Plus	运营管理后台
gsl-dapp	Vue 3 / Web3.js / Ethers.js / Vant	用户端 DApp

系统架构

┌─────────────┐    ┌──────────────┐
│  gsl-dapp   │    │ gsl-web-admin│
│  (用户DApp)  │    │  (管理后台)   │
└──────┬──────┘    └──────┬───────┘
       │                   │
       │  HTTP/API         │  HTTP/API
       ▼                   ▼
┌──────────────────────────────────┐
│       hive-gls-java              │
│    (Spring Boot 后端服务)         │
│  ┌─────────┐  ┌───────────────┐  │
│  │ 事件监听 │  │  奖励结算Job  │  │
│  └────┬────┘  └───────┬───────┘  │
│       │               │          │
│  ┌────▼────────────────▼──────┐  │
│  │     MySQL + Redis          │  │
│  └────────────────────────────┘  │
└──────────────┬───────────────────┘
               │ Web3j
               ▼
┌──────────────────────────────────┐
│       gsl-contracts              │
│    (Berachain 智能合约)           │
│  StakeCore | LPStake | HiveSwap │
│  FOMO3D | UserRelation | Queue  │
└──────────────────────────────────┘

---

文档生成日期：2026-03-25