泰山众筹阿凡达玩法公开，进一步解析马蹄链智能合约

泰山众筹在2月份新上线了一个项目——SUN4.0，目前已经改名阿凡达（ANATAR），后文就以阿凡达来称呼。这个阿凡达项目运行在马蹄链上，本质上是一个资金盘。但是和过去的资金盘不同，阿凡达又是以智能合约运行的。代码完全公开，用户在没有前端的情况下，可以通过调用合约拿回自己的资金。显得非常去中心化，非常透明，非常可靠。

今天，我们就了解一下阿凡达项目的玩法和运作逻辑，以及智能合约代码的逻辑。

一、阿凡达是怎么玩的？

阿凡达（ANATAR）的玩法本身是一个存MATIC币，赚Matic币的逻辑，由合约智能执行，完全去中心化。

假设用户准备了800人民币用来投资，他需要先购买Matic代币，即马蹄币。按照8元一个马蹄币的价格算的话，他可以买到100个马蹄币。然后用户将这800个Matic以质押的形式存到ANATAR的智能合约里，大概是会进行如下的分配：

• 65%～进⼊保险合约（即任何⼈动不了，⽤来保障⽤户本⾦，合约到期⾃动返回）
• 6%～进⼊静态奖励池
• 6%～进⼊动态奖励池直接分配完毕
• 0.5%～进⼊后60名奖⾦池进⾏累计
• 0.5%～进⼊节点分红池
• 2%～进⼊平台盈利，这个是平台利润

例如:100个MATIC进场，其中65%进入返本池直接锁死，6%动态，2%平台，1%后60名爆仓奖励，26%进入收益池，也就是静态提现池，收益池提现提空了就爆仓,爆仓后65%回本，35%出局，合约接着重启，生生不息！35%损失的，在第二次放大投资金额两倍，优先盈利，重启静态给到1.5%的收益。

静态每天0.3-1%，动态最高4.8% 分六个个合约池

• 1，自由合约（随进随出）24小时一次
• 2，超短合约（3-7天）系统匹配
• 3，短合约（8-15天）系统匹配
• 4，中合约（16-30天）系统匹配
• 5，长合约（31-90天）
• 6，超长合约（91-180天）

*动态:十二个级别，V1-V12，极差0.4%

二、阿凡达的合约代码拆解

从区块链浏览器可以发现，阿凡达项目部署了了多个合约，我们直接拆解主合约ANATAR.sol

contract Avatar is ReentrancyGuard, Bucket {
uint256 public constant PRINCIPAL_RATIO = 650000; // 65%
uint256 public constant INVEST_RATIO = 260000; // 26%
uint256 public constant PLATFORM_RATIO = 20000; // 2%
uint256 public constant REFERRER_RATIO = 60000; // 6%
uint256 public constant INCENTIVE_RATIO = 10000; // 1%
uint256 public constant PRICE_PRECISION = 1e6;

uint256 public constant DEFAULT_INVEST_RETURN_RATE = 10000; // 1%
uint256 public constant BOOST_INVEST_RETURN_RATE = 5000; // 0.5%

uint256 public constant MAX_INVEST = 1e21; // 1000
uint256 public constant MIN_INVEST = 1e20; // 100

uint256 public constant TIME_UNIT = 1 days;
uint256[6] public DEFAULT_TARGET_AMOUNTS = [13e22, 25e22, 35e22, 50e22, 75e22, 125e22];

uint256 public constant MAX_SEARCH_DEPTH = 50;
uint256 public constant RANKED_INCENTIVE = 60;

address public platformAddress; // will be paymentsplitter contract address

uint256[6] public currentEpochs;

// ledge type => round epoch => address => position index => position info
mapping(uint256 => mapping(address => PositionInfo[]))[6] public roundLedgers;
//
mapping(uint256 => RoundInfo)[6] public roundInfos;
//
mapping(address => UserRoundInfo[])[6] public userRoundsInfos;

mapping(address => UserGlobalInfo) public userGlobalInfos;

mapping(address => address[]) public children; // used for easily retrieve the referrer tree structure from front-end

该合约定义了一些常量，包括资金分配比例、价格精度、最大/最小投资金额、时间单位等。它还包含了一些结构体，例如FundTarget、UserGlobalInfo、PositionInfo、LinkedPosition、RoundInfo和UserRoundInfo。

• truct FundTarget用于记录本轮筹资目标的情况，包括上次检查时间、目标金额和已经实现的金额。
• struct UserGlobalInfo记录了用户的全局信息，包括他的推荐人、推荐奖励总额、已领取的推荐奖励、加速积分、销售记录、总头寸金额、报告的销售额和销售级别。
• struct PositionInfo记录了用户头寸的详细信息，包括头寸金额、开仓时间、到期时间、投资回报率、已取回的金额、激励金额、投资回报金额、位置索引和是否可以领取激励。
• struct LinkedPosition记录了与某个回合相关联的某个头寸的地址和索引。
• struct RoundInfo记录了回合信息，包括筹资目标、所有头寸的总金额、当前的主要金额、当前的投资金额、所有头寸的总数、当前开放头寸的总数、当前的激励金额、激励快照、上次N个头寸的总数、链表中最后N个头寸的头节点、用户回合信息列表的本回合索引以及是否停止亏损。
• struct UserRoundInfo记录了用户在某个回合中的信息，包括当前的回合、总头寸金额、当前主要金额、总提取金额、总领取激励金额、总关闭头寸数和加速回报的金额。

function setStock(
uint256 ledgerType,
uint8[] calldata typeDays,
uint16[] calldata stock
) external {
require(ledgerType > 0, “Invalid ledger type”);
require(ledgerType < 6, “Invalid ledger type”);
require(msg.sender == tempAdmin, “Only admin”);
require(stock.length > 0, “Invalid stock array”);
require(typeDays.length == stock.length, “Invalid params”);

_setStock(ledgerType, typeDays, stock);
}

function openPosition(
uint256 ledgerType,
uint256 targetEpoch,
uint256 targetRate,
address referrer,
bool useBoost
) external payable notContract nonReentrant {
require(ledgerType < 6, “Invalid ledger type”);
require(targetEpoch == currentEpochs[ledgerType], “Invalid epoch”);
require(msg.value >= MIN_INVEST, “Too small”);
require(msg.value <= MAX_INVEST, “Too large”);
require(!gamePaused, “Paused”);

// load user global info
UserGlobalInfo storage userGlobalInfo = userGlobalInfos[msg.sender];
// load global round info
RoundInfo storage roundInfo = roundInfos[ledgerType][targetEpoch];
// placeholder for user round info
UserRoundInfo storage userRoundInfo;

// determine referrer
{
address _referrer = userGlobalInfo.referrer;
// if referrer is already set or msg.sender is the root user whose referrer is address(0)
if (_referrer == address(0) && children[msg.sender].length == 0) {
// if referrer is not set, set it and make sure it is a valid referrer
require(referrer != address(0) && referrer != msg.sender, “Invalid referrer”);
// make sure referrer is registered already
require(
userGlobalInfos[referrer].referrer != address(0) || children[referrer].length > 0,
“Invalid referrer”
);

// update storage
userGlobalInfo.referrer = referrer;
children[referrer].push(msg.sender);
emit NewReferrer(msg.sender, referrer);
}
}

构造函数:

• 初始化合约时被调用，设置了三个参数：_platformAddress、_tempAdmin、_operator。
• 对于每个参数，函数会检查它是否为0地址，如果是，就会抛出异常。
• 然后，它会通过 emit NewRound() 函数发出六个事件，分别为0到5，用于初始化所有轮次。
• 最后，它会将 tempAdmin 设置为 _tempAdmin，将 operator 设置为 _operator，将 platformAddress 设置为 _platformAddress，将 gamePaused 设置为 true。

setPause() 函数:

• 允许只有 operator 能够调用，以设置游戏的暂停状态。
• 如果要取消暂停，函数会检查 tempAdmin 是否已被删除。如果没有被删除，函数会抛出异常。

transferOperator() 函数:

• 允许只有 operator 能够调用，以转移操作者的身份。
• 函数会检查新的操作者地址是否为0地址，如果是，就会抛出异常。

dropTempAdmin() 函数:

• 允许只有 tempAdmin 能够调用，以删除临时管理员的身份。
• 使用 require 语句检查调用该函数的地址是否为临时管理员地址，若不是则会抛出异常。
• 将临时管理员地址设置为 0

batchSetReferrerInfo 函数：

• 此函数用于为多个用户设置推荐人信息。
• 函数接受三个数组类型的参数：users、referrers 和 salesLevels，分别表示需要设置推荐人信息的用户、他们的推荐人和销售级别。
• 使用 require 语句检查调用该函数的地址是否为临时管理员地址，若不是则会抛出异常。
• 使用 require 语句检查 users、referrers 和 salesLevels 数组的长度是否相等，若不相等则会抛出异常。

三、开发一个类似阿凡达的项目难不难

阿凡达项目的开发，主要是在两个方面：前端页面和后端的合约。DAPP前端的页面，包括设计、交互、操作等等，相对来说不是非常的复杂。但是后端的这个合约，就比较困难了。这个合约的设计极为复杂，且具有一定水平。光是拆解，几千字都写不完。