
一.项目核心需求
核心功能
体育投注玩法
-
玩法:初盘(开盘五分钟前截止投注)
-
胜平负
-
比分
-
正波反波
-
角球
-
接入的赛事(各种体育赛事)
-
欧冠
-
CBA
-
NBA
-
世界杯
-
...
推荐奖励
推荐奖励,合计万分之 70
级别
流水
备注
1 级
万 12
合计万分之 50
2 级
万 8
3 级
万 6
4 级
万 4
5 级
万 3
6 级
万 3
7 级
万 2
8 级
万 2
9 级
万 2
10 级
万 2
11 级
万 1.5
12 级
万 1.5
13 级
万 1
级别
流水
备注
1 级
万 12
合计万分之 50
2 级
万 8
3 级
万 6
4 级
万 4
5 级
万 3
6 级
万 3
7 级
万 2
8 级
万 2
9 级
万 2
10 级
万 2
11 级
万 1.5
12 级
万 1.5
13 级
万 1
获取动态奖励的条件
-
本人每天必须投注满 1000U 的流水才可以获得推荐奖
-
有效用户持有卡牌 NFT(持有 16 张卡牌,用户的 16 级推荐才是有效的)
-
一张可以拿一级流水
-
二张可以拿二级流水
-
...
-
十六张可以拿十六级流水
-
若整个网体中用户没有投注,自动降级处理
【图示 1】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/GqggdTWv7oMRv3xdYDElELALgHg
参与方式
用户充值 USDT, 直接参与
投注质押逻辑
用户投注多少 U,本金就是多少 U,收益使用 U 发放,用户投注的时候,需要锁定 20% 的质押资金去买代币,例如用户投注 1200U,其中 1000 U 去下单,剩下的 200 U 质押买代币。
如果用户后面不投注了,可以随时手动取回质押,取回质押的时候将代币换成 USDT 释放给用户,如果用户不手动取回质押,48 小时之后自动释放质押,资金兑换成 USDT 回到用户钱包。
用户盈亏处理
-
用户盈利
-
70% 的盈利资金给到用户
-
30% 的资金用于回购平台币(30% 的盈利系统拿了)
-
用户亏损
-
70% 亏损用户资金承担
-
30% 的亏损平台以 USDT 的形式反给用户,需要刷够 20 倍流水可以释放,线性释放
经济商模式
等级与收益一览
级别
日流水要求(个人要求1000以上USDT)
KPI考核日增
返佣比例
入门经纪商
0
3.0 %
0
一级经纪商
6 万
3.2 %
万分之 1
二级经纪商
12 万
3.4 %
万分之 2
三级经纪商
18 万
3.6 %
万分之 3
四级经纪商
24 万
3.8 %
万分之 4
五级经纪商
30 万
4.0 %
万分之 5
六级经纪商
36 万
4.2 %
万分之 6
七级经纪商
42 万
4.4 %
万分之 7
八级经纪商
48 万
4.6 %
万分之 8
九级经纪商
54 万
4.8 %
万分之 9
十级经纪商
60 万
5.0 %
万分之 20
级别
日流水要求(个人要求1000以上USDT)
KPI考核日增
返佣比例
入门经纪商
0
3.0 %
0
一级经纪商
6 万
3.2 %
万分之 1
二级经纪商
12 万
3.4 %
万分之 2
三级经纪商
18 万
3.6 %
万分之 3
四级经纪商
24 万
3.8 %
万分之 4
五级经纪商
30 万
4.0 %
万分之 5
六级经纪商
36 万
4.2 %
万分之 6
七级经纪商
42 万
4.4 %
万分之 7
八级经纪商
48 万
4.6 %
万分之 8
九级经纪商
54 万
4.8 %
万分之 9
十级经纪商
60 万
5.0 %
万分之 20
重要规则:
-
KPI 考核说明
-
考核标准:当日流水较昨日流水的新增百分比需达到要求
奖惩机制:
-
达到要求 → 维持或升级
-
未达要求 → 降级处理
-
低于3%日增 → 当日奖金不予发
-
仅考核今日流水与昨日流水的日增长率
后台代理机制
-
代理商开设下级代理统一提交客服后能审核,达到要求后开通
-
流水要求与KPI考核数字不可更改
返佣设置
-
返佣数字统一按业绩比例势行
-
所有团队的都吃万分之三十
代币经济模型
-
代币总量发行 10 亿枚
-
卡牌 100 U 一张, 享受权益,卡牌为 NFT
-
前期平台币不能买,只能挖矿产出,但是可以卖
-
参与投注千分之一需要平台币做为手续费,其中百分之七十销毁,百分之三十平台运营
-
参与投注需质押平台币(你参与金额的百分之二十(举例)参与 1000U 需质押 200U 平台币) 如不参与预测 200U 的百分之百 48 小时后一次性释放
-
平台币交易手续费是卖 3% ; 其中百分之七十销毁,百分之三十平台运营
-
下跌税, 币价下跌 3% 卖出的币扣 10%;币价下跌 6% 卖出扣 20%
-
人人可创建投注事件, 需质押平台币,质押量: 5000U 的平台币
-
项目方 0 持币,上线市场 0 流通, 100% 合约开源,科学的数学模型,合理的运行逻辑,平进控盘制度,强硬的技术手段,持久的内外循环
二.需求分析
体育数据源
体育板块肯定是要对接第三方的 API,通过调研你会发现,有很多体育平台可以对接,比方说:纳米数据,火星数据等
实名认证通过之后付费完成之后就可以使用 API,这里的 API 价格是可以讲价的
体育的赔率问题
研究发现,很多平台都会使用欧洲赔率,平台可以直接使用欧洲赔率
链上合约
-
FundingManager: 用户充值,提现和体育投注的盈亏数据处理
-
NftManager: 购买 NFT,NFT 挖矿奖励
-
RewardManager: 给经济商和推广网体发奖励
-
MnTokenManager: 代币合约,交易手续费,下跌税
-
LpManager: 打底池的合约
链下服务
-
监听合约事件
-
对接体育平台 API
-
体育板块 API
-
资金板块 API
-
用户安全盘块的 API
-
定时任务
三.系统架构设计
【图示 2】原文此处为流程图/白板图示,因平台导出限制未能搬运。
源文档: https://w2z1amg2x5.sg.larksuite.com/docx/GqggdTWv7oMRv3xdYDElELALgHg
在实际过程中要考量的点
-
数据平台出现问题
-
资金的管理方式,合约里面的资金怎么去安全管理
-
结算任务出现 bug 不结算了怎么办
-
代币大量卖出导致 K 线难看怎么办
四. 链上代码编写
链上代码变细
安装依赖
bash
forge install OpenZeppelin/openzeppelin-contracts-upgradeable
forge install OpenZeppelin/openzeppelin-contracts
forge install pancakeswap/pancake-swap-core
forge install pancakeswap/pancake-swap-periphery
把 remapping 文件搞好
bash
forge-std/=lib/forge-std/src/
@openzeppelin/=lib/openzeppelin-contracts/
@openzeppelin-upgrades/=lib/openzeppelin-contracts-upgradeable/
ds-test/=lib/openzeppelin-contracts-upgradeable/lib/forge-std/lib/ds-test/src/
erc4626-tests/=lib/openzeppelin-contracts-upgradeable/lib/erc4626-tests/
halmos-cheatcodes/=lib/openzeppelin-contracts-upgradeable/lib/halmos-cheatcodes/src/
openzeppelin-contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/
openzeppelin-contracts/=lib/openzeppelin-contracts/
openzeppelin-foundry-upgrades/=lib/openzeppelin-foundry-upgrades/src/
solidity-stringutils/=lib/openzeppelin-foundry-upgrades/lib/solidity-stringutils/
solmate/=lib/solmate/src/
@contracts/=src/contracts/
@/=src/
@openzeppelin-foundry-upgrades=lib/openzeppelin-foundry-upgrades/src/
@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/
@pancake-v3-router/=lib/pancake-v3-contracts/projects/router/contracts/
@pancakeswap/v3-router/contracts/=lib/pancake-v3-contracts/projects/router/contracts/
@pancake-v3-core/=lib/pancake-v3-contracts/projects/v3-core/contracts/
@pancakeswap/v3-core/contracts/=lib/pancake-v3-contracts/projects/v3-core/contracts/
@pancake-v3-periphery/=lib/pancake-v3-contracts/projects/v3-periphery/contracts/
@pancakeswap/v3-periphery/contracts/=lib/pancake-v3-contracts/projects/v3-periphery/contracts/
@pancake-v2-core/=lib/pancake-swap-core/contracts/
@pancake-v2-periphery/=lib/pancake-swap-periphery/contracts/
remapping 文件所在目录:s9sports/remappings.txt
部署合约
部署合约的地址准备
Address: 0x55225359b717dA1EA4270F78ddA384b0A9f53E28
Private key: 0xa3c456042022db6b15af6697ad215032881b1842e763e89ec5d4bebc16a443aa
环境变量的准备(测试往足够)
部署合约
MODE=0 forge script script/DeploySportsScript.sol:DeploySportsScript --sig "deployAll()" --slow --multi --rpc-url https://shared.ap-southeast-1.getblock.io/8e87ac495a5941ae9dfb9ea6ed9ae7d2 --broadcast --verify --etherscan-api-key I4C1AKJT8J9KJVCXHZKK317T3XV8IVASRX
部署完成之后合约地址
s9sports/cache/__deployed_addresses_dev.json
使用合约的过程
-
第一步:在 DappLink Token 先把发布出 CardManger 和 LPManager 设置好,执行发币的函数发币
-
第二步:用户使用 USDT 去 CardManager 里面买 NFT,没超过一万张价格会上涨 10%
-
第三步:链下服务每天给 NFT 持有人发奖励,用户通过 CardManager 里面的 validatorMineClaim 领取奖励
-
用户充值,提现,手续费收取,盈亏计算使用 FundingManager 合约
-
用户投注,质押 USDT 转换代币,释放时将代币卖成 USDT
-
用户 16 级奖励或者经济商奖励
合约继续作业
-
将代币合约里面获取价格手动写入的地方换成 Oracle 来实现(Uniswap 或者 PancakeSwap 的 Oracle 来替代)
-
在 fundingManager 买入投注函数,每次投注需要判断质押量是否足够,不够补齐质押
-
刷流水释放资金,改造 updateUserBalance 函数就可以(课上写完这个)
五.链下代码
- 和其他服务类似,这里就不再讲解了,不外乎是写代码逻辑,call 合约,监听合约事件
六.总结
-
真正分析一个需求来写合约代码
-
理解从需求开始到项目合约代码写完的整个流程
万 2
9 级
万 4
4 级
万 1
14 级
万 6
3 级
万 1
13 级
万 3
6 级
万 1.5
12 级
万 2
7 级
万 12
1 级
合计万分之 50
万 8
2 级
万 2
10 级
万 1.5
11 级
万 0.5
15 级
万 3
5 级
流水
级别
备注
万 2
8 级
万 0.5
16 级
42 万
七级经纪商
4.4 %
万分之 7
18 万
三级经纪商
3.6 %
万分之 3
54 万
九级经纪商
4.8 %
万分之 9
12 万
二级经纪商
3.4 %
万分之 2
6 万
一级经纪商
3.2 %
万分之 1
36 万
六级经纪商
4.2 %
万分之 6
30 万
五级经纪商
4.0 %
万分之 5
24 万
四级经纪商
3.8 %
万分之 4
0
入门经纪商
3.0 %
0
日流水要求(个人要求1000以上USDT)
级别
KPI考核日增
返佣比例
60 万
十级经纪商
48 万
八级经纪商
4.6 %
万分之 8
5.0 %
万分之 20
-
1 枚代币打底池,配 30 万U,初始币价:0.003 U
-
9 亿枚/1000 天,全网挖矿,每天产出 900000 枚代币,均分给 NFT 持有人
-
全网权重挖矿分红
-
一张拿一层流水分红
-
十六张拿十六层流水分红
-
每卖出 1 万张,价格上涨 10%
-
体育的事件
-
欧洲赔率
-
NFT 挖矿奖励发送
-
推广网体的结算任务
-
经纪商的结算任务
-
质押自动释放任务,将 token 兑换成 U 释放给用户
-
20 倍流水线性释放的任务
-
资金的定时销毁任务
-
事件结果不推送怎么:主动不断去获取事件结果,后台设置事件的批量结算按钮,手动录入结果
-
事件延期了怎么办:
-
用户投注的资金:一种方式是资金继续锁定,赛事重新开启之后投注入新的事件,这种好处质押也不用解除了;另一种赛事延期直接退回资金,对应事件质押也解锁
-
用户质押的资金
-
第一种方案继续锁定就可以
-
解除和这个事件质押进来的资金
-
通过其他事件质押的资金不用解除
-
通过这个延期事件质押的资金需要解除
-
事件的结果推送没有接到: 主动不断去获取事件结果,后台设置事件的批量结算按钮,手动录入结果
-
私钥有一定加密之后放到 secret manager (AWS 的组件)
-
再开一台 Google 云,通过内部 rpc 获取加密的 Key 过来解密
-
一半方式 AWS secret manager
-
一半放在 Google 云
-
内部的权限管理
-
开发和运维分离,密钥相关服务收拢到运维主管手里,其他运维没有权限操作
-
结算的时候可以并发逐条结算,批量结算不靠谱,一个失败可能导致全量,这种失败了只会影响局部的用户,使用补偿机制进行结算,单订单多次结算失败马上报警。
-
下跌税
-
下跌的价格怎么获取:oracle 的价格
-
FundingManager: 用户充值,提现和体育投注的盈亏数据处理
-
NftManager: 购买 NFT,NFT 挖矿奖励
-
RewardManager: 给经济商和推广网体发奖励
-
MnTokenManager: 代币合约,交易手续费,下跌税
-
LpManager: 打底池的合约
-
setPoolAddress:设置地址
-
poolAllocate:发币
-
buyCard 和 buyCards: 用户购买 NFT
-
validatorMine: 链下挖矿发奖励
-
validatorMineClaim:用户直接去 cliam 奖励
-
depositForUser:用户充钱进入系统
-
withdrawForUser:用户提现
-
updateUserBalance:用户盈亏之后由链下服务更新余额
-
collectFee:收取手续费的逻辑
-
stakingAndUseDappLink:质押 20% 的资金
-
releaseUsedStakingDappLinkToken:释放 20% 质押
-
withdrawStakingDappLink:质押的资金提走
-
distributeReward:链下服务发奖励
-
claimReward:用户 cliam 奖励
-
第一次投注:投 1000U,质押 200U,实际投注:800U
-
第二次投注:投注 1000U,因为一致质押了 200U,若没有释放质押,里面的质押时足够的,不用质押了
-
第三次投注:投注 2000U,质押 400U,前面已经质押了 200U,现在只需要补齐 200U 的质押就可以
-
用户盈利---已经完成
-
70% 的盈利资金给到用户
-
30% 的资金用于回购平台币(30% 的盈利系统拿了)
-
用户亏损---已经完成
-
70% 亏损用户资金承担
-
30% 的亏损平台以 USDT 的形式反给用户,需要刷够 20 倍流水可以释放,线性释放
-
刷流水,用户刷的流水在链下,从链把流水上,在 userReleasedAmount 用户释放的资金,同时将释放资金更新到用户余额,记得补充合约事件