[Web3] 智能合约 15: 项目实战⑦ 从0到1 体育投注

一.项目核心需求

核心功能

体育投注玩法
  • 玩法:初盘(开盘五分钟前截止投注)

  • 胜平负

  • 比分

  • 正波反波

  • 角球

  • 接入的赛事(各种体育赛事)

  • 欧冠

  • 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 用户释放的资金,同时将释放资金更新到用户余额,记得补充合约事件

相关推荐
OxYGC1 天前
[Web3] 智能合约 13: 项目实战⑤ DappLink Oracle
oracle·web3·智能合约
木西4 天前
深度拆解 MyShell 底层:AI Agent 生态结算合约,如何实现安全防阻塞
web3·智能合约·solidity
Cooper255 天前
合约托管 + 验收释放:悬赏 DApp 的四态状态机与事件索引
web3·solidity
OxYGC6 天前
[Web3] 智能合约 04: 高级开发实战与 OpenZeppelin
web3·区块链·智能合约
笑容掩饰我的失落6 天前
区块链从小白到精通(七):Solidity 语法精讲——数据类型、函数、修饰器与事件
算法·区块链·php·智能合约·哈希算法
OxYGC6 天前
[Web3] 智能合约 03: 函数/事件/继承/接口/异常处理
web3·区块链·智能合约
笑容掩饰我的失落7 天前
区块链从小白到精通(八):从零实现一个标准 ERC-20 代币(完整可运行代码)
算法·区块链·php·智能合约·哈希算法
OxYGC7 天前
[Web3] 智能合约 02: Solidity 基础语法
web3·区块链·智能合约
OxYGC9 天前
[Web3] 基础第7篇: 说透比特币的基本框架与原理
web3·区块链·以太坊·比特币