APE土拍代码分析

纯属个人收集整理资料+揣测理解，我也不是NFT玩家，也没这个资金实力玩NFT。所以，理解上没有专业人士准确。

业务梳理

固定305APE价格售卖
售卖分为kyc pre-mint(Contributor才行，应该就是白名单吧)、公售（大家抢）、持有无聊猿和变异猿的人可以再mint
5.1买的是盲盒，5.2拆盒

operator也是操作了这些事情，业务理解应该没太大问题

代码注释

删掉了一些业务无关、重复、无需理解的代码

代码还算简单，只有通过随机数将土地和nft721的metadata关联起来有点疑问

通过链上操作可以知道tokenurl是在土拍前就设置了，并且再也没有改过，所以不是其他项目那样卖完后通过改url拆盒

项目方也上传了metadatahashes，所以所有nft metadata是事先就准备好了的

链上的随机数并没有参与链上业务的处理，比如通过随机数+tokenid获取metadata url

既然链上的方法都没有使用，那么这个关联操作应该是放在了链下，

api.otherside.xyz/lands/27893 访问这个地址后，通过他们未开源的算法，将27893+随机数指向了metaurl。但是这样是不是就能够通过修改算法，改变用户的nft了。。。。。。。这点没有想明白，如果有好心人愿意指导下我，可以zn978740431@gmail.com给我发邮件。

网上找到两个还算靠谱的实现文章，看起来都是在链上完成这个操作的，搞不明白ape是怎么想的。因为很多nft项目方在这上面做手脚，还是很想理解透这个事情。

https://vocus.cc/article/6212f73ffd89780001687585

https://zombit.info/write-to-the-nft-project/

// SPDX-License-Identifier: MIT
pragma solidity 0.8.10;

contract Land  {
using SafeERC20 for IERC20;
// attributes
string private baseURI;

address public operator;
//公售开关
bool public publicSaleActive;
//公售时间
uint256 public publicSaleStartTime;
//荷兰拍用的
uint256 public publicSalePriceLoweringDuration;
uint256 public publicSaleStartPrice;
uint256 public publicSaleEndingPrice;
//荷兰拍用的

//记录当前的土地数量
uint256 public currentNumLandsMintedPublicSale;
//当前mint tokenId
uint256 public mintIndexPublicSaleAndContributors;
//ape地址，用于交钱
address public tokenContract;
//是否需要验证kyc
bool private isKycCheckRequired;
//验证kyc的hash root， Merkle tree验证
bytes32 public kycMerkleRoot;

//每次最大可以mint的上限
uint256 public maxMintPerTx;
//每个地址总共mint的上限
uint256 public maxMintPerAddress;
//每个地址mint的数量
mapping(address => uint256) public mintedPerAddress;
//无聊猿和变异猿是否可以额外mint
bool public claimableActive; 
bool public adminClaimStarted;

//无聊猿mint的信息
address public alphaContract; 
mapping(uint256 => bool) public alphaClaimed;
uint256 public alphaClaimedAmount;
//变异mint的信息
address public betaContract; 
mapping(uint256 => bool) public betaClaimed;
uint256 public betaClaimedAmount;
uint256 public betaNftIdCurrent;

//贡献者mint的信息
bool public contributorsClaimActive;
mapping(address => uint256) public contributors;
uint256 public futureLandsNftIdCurrent;

//未来还可以再mint
address public futureMinter;

//保证官方没有作弊，用于所有人拿这里面的数据进行验证
Metadata[] public metadataHashes;
//随机数seed, 线上结果       0xaa77729d3466ca35ae8d28b3bbac7cc36a5031efdc430821c02bc31a238af445
bytes32 public keyHash;
//请求随机数的费用
uint256 public fee;
//下面三个获得的随机数然后计算出来的偏移量 线上结果 35117
uint256 public publicSaleAndContributorsOffset;
//线上结果 5491
uint256 public alphaOffset;
//线上结果 15491
uint256 public betaOffset;
//是否请求过随机数
mapping(bytes32 => bool) public isRandomRequestForPublicSaleAndContributors;
bool public publicSaleAndContributorsRandomnessRequested;
bool public ownerClaimRandomnessRequested;

// constants
uint256 immutable public MAX_LANDS;
uint256 immutable public MAX_LANDS_WITH_FUTURE;
uint256 immutable public MAX_ALPHA_NFT_AMOUNT;
uint256 immutable public MAX_BETA_NFT_AMOUNT;
uint256 immutable public MAX_PUBLIC_SALE_AMOUNT;
uint256 immutable public RESERVED_CONTRIBUTORS_AMOUNT;
uint256 immutable public MAX_FUTURE_LANDS;
uint256 constant public MAX_MINT_PER_BLOCK = 150;

// structs
struct LandAmount {
    uint256 alpha;
    uint256 beta;
    uint256 publicSale;
    uint256 future;
}
struct ContributorAmount {
    address contributor;
    uint256 amount;
}

struct Metadata {
    bytes32 metadataHash;
    bytes32 shuffledArrayHash;
    uint256 startIndex;
    uint256 endIndex;
}

struct ContractAddresses {
    address alphaContract;
    address betaContract;
    address tokenContract;
}

// modifiers
。。。。。。。。。。

// events
。。。。。。。。。。

constructor(string memory name, string memory symbol,
    ContractAddresses memory addresses,
    LandAmount memory amount,
    ContributorAmount[] memory _contributors,
    address _vrfCoordinator, address _linkTokenAddress,
    bytes32 _vrfKeyHash, uint256 _vrfFee,
    address _operator
) ERC721(name, symbol) VRFConsumerBase(_vrfCoordinator, _linkTokenAddress) {
    //无聊猿和变异猿的地址，持有这个的能够mint（具体的业务忘记了）
    alphaContract = addresses.alphaContract;
    betaContract = addresses.betaContract;
    tokenContract = addresses.tokenContract;

    MAX_ALPHA_NFT_AMOUNT = amount.alpha;
    MAX_BETA_NFT_AMOUNT = amount.beta;
    MAX_PUBLIC_SALE_AMOUNT = amount.publicSale;
    MAX_FUTURE_LANDS = amount.future;

    betaNftIdCurrent = amount.alpha; //beta starts after alpha
    mintIndexPublicSaleAndContributors = amount.alpha + amount.beta; //public sale starts after beta

    //贡献者mint数量
    uint256 tempSum;
    for(uint256 i; i<_contributors.length; ++i){
        contributors[_contributors[i].contributor] = _contributors[i].amount;
        tempSum += _contributors[i].amount;
    }
    RESERVED_CONTRIBUTORS_AMOUNT = tempSum;
    //总数量
    MAX_LANDS = amount.alpha + amount.beta + amount.publicSale + RESERVED_CONTRIBUTORS_AMOUNT;
    //以后还可以mint的数量
    MAX_LANDS_WITH_FUTURE = MAX_LANDS + amount.future;
    futureLandsNftIdCurrent = MAX_LANDS; //future starts after public sale
    //用于随机数请求
    keyHash  = _vrfKeyHash;
    fee = _vrfFee;
    //操作者地址
    operator = _operator;
}

//一些set函数
。。。。。。。。。。

// Public Sale Methods
//公售
function startPublicSale(
    uint256 _publicSalePriceLoweringDuration, 
    uint256 _publicSaleStartPrice, 
    uint256 _publicSaleEndingPrice,
    uint256 _maxMintPerTx,
    uint256 _maxMintPerAddress,
    bool _isKycCheckRequired
) external onlyOperator {
    require(!publicSaleActive, "Public sale has already begun");
    //不用管，荷兰拍取消了
    publicSalePriceLoweringDuration = _publicSalePriceLoweringDuration;
    publicSaleStartPrice = _publicSaleStartPrice;
    publicSaleEndingPrice = _publicSaleEndingPrice;
    publicSaleStartTime = block.timestamp;
    publicSaleActive = true;
    //每次，每个地址的mint限制
    maxMintPerTx = _maxMintPerTx;
    maxMintPerAddress = _maxMintPerAddress;

    isKycCheckRequired = _isKycCheckRequired;

    emit LandPublicSaleStart(publicSalePriceLoweringDuration, publicSaleStartTime);
}

address public operator; //公售开关 bool public publicSaleActive; //公售时间 uint256 public publicSaleStartTime; //荷兰拍用的 uint256 public publicSalePriceLoweringDuration; uint256 public publicSaleStartPrice; uint256 public publicSaleEndingPrice; //荷兰拍用的 //记录当前的土地数量 uint256 public currentNumLandsMintedPublicSale; //当前mint tokenId uint256 public mintIndexPublicSaleAndContributors; //ape地址，用于交钱 address public tokenContract; //是否需要验证kyc bool private isKycCheckRequired; //验证kyc的hash root， Merkle tree验证 bytes32 public kycMerkleRoot;

//每次最大可以mint的上限 uint256 public maxMintPerTx; //每个地址总共mint的上限 uint256 public maxMintPerAddress; //每个地址mint的数量 mapping(address => uint256) public mintedPerAddress; //无聊猿和变异猿是否可以额外mint bool public claimableActive; bool public adminClaimStarted; //无聊猿mint的信息 address public alphaContract; mapping(uint256 => bool) public alphaClaimed; uint256 public alphaClaimedAmount; //变异mint的信息 address public betaContract; mapping(uint256 => bool) public betaClaimed; uint256 public betaClaimedAmount; uint256 public betaNftIdCurrent; //贡献者mint的信息 bool public contributorsClaimActive; mapping(address => uint256) public contributors; uint256 public futureLandsNftIdCurrent; //未来还可以再mint address public futureMinter; //保证官方没有作弊，用于所有人拿这里面的数据进行验证 Metadata[] public metadataHashes; //随机数seed, 线上结果 0xaa77729d3466ca35ae8d28b3bbac7cc36a5031efdc430821c02bc31a238af445 bytes32 public keyHash; //请求随机数的费用 uint256 public fee; //下面三个获得的随机数然后计算出来的偏移量线上结果 35117 uint256 public publicSaleAndContributorsOffset; //线上结果 5491 uint256 public alphaOffset; //线上结果 15491 uint256 public betaOffset; //是否请求过随机数 mapping(bytes32 => bool) public isRandomRequestForPublicSaleAndContributors; bool public publicSaleAndContributorsRandomnessRequested; bool public ownerClaimRandomnessRequested; // constants uint256 immutable public MAX_LANDS; uint256 immutable public MAX_LANDS_WITH_FUTURE; uint256 immutable public MAX_ALPHA_NFT_AMOUNT; uint256 immutable public MAX_BETA_NFT_AMOUNT; uint256 immutable public MAX_PUBLIC_SALE_AMOUNT; uint256 immutable public RESERVED_CONTRIBUTORS_AMOUNT; uint256 immutable public MAX_FUTURE_LANDS; uint256 constant public MAX_MINT_PER_BLOCK = 150; // structs struct LandAmount { uint256 alpha; uint256 beta; uint256 publicSale; uint256 future; } struct ContributorAmount { address contributor; uint256 amount; } struct Metadata { bytes32 metadataHash; bytes32 shuffledArrayHash; uint256 startIndex; uint256 endIndex; }

struct ContractAddresses { address alphaContract; address betaContract; address tokenContract; } // modifiers 。。。。。。。。。。 // events 。。。。。。。。。。 constructor(string memory name, string memory symbol, ContractAddresses memory addresses, LandAmount memory amount, ContributorAmount[] memory _contributors, address _vrfCoordinator, address _linkTokenAddress, bytes32 _vrfKeyHash, uint256 _vrfFee, address _operator ) ERC721(name, symbol) VRFConsumerBase(_vrfCoordinator, _linkTokenAddress) { //无聊猿和变异猿的地址，持有这个的能够mint（具体的业务忘记了） alphaContract = addresses.alphaContract; betaContract = addresses.betaContract; tokenContract = addresses.tokenContract; MAX_ALPHA_NFT_AMOUNT = amount.alpha; MAX_BETA_NFT_AMOUNT = amount.beta; MAX_PUBLIC_SALE_AMOUNT = amount.publicSale; MAX_FUTURE_LANDS = amount.future; betaNftIdCurrent = amount.alpha; //beta starts after alpha mintIndexPublicSaleAndContributors = amount.alpha + amount.beta; //public sale starts after beta //贡献者mint数量 uint256 tempSum; for(uint256 i; i<_contributors.length; ++i){ contributors[_contributors[i].contributor] = _contributors[i].amount; tempSum += _contributors[i].amount; } RESERVED_CONTRIBUTORS_AMOUNT = tempSum; //总数量 MAX_LANDS = amount.alpha + amount.beta + amount.publicSale + RESERVED_CONTRIBUTORS_AMOUNT; //以后还可以mint的数量 MAX_LANDS_WITH_FUTURE = MAX_LANDS + amount.future; futureLandsNftIdCurrent = MAX_LANDS; //future starts after public sale //用于随机数请求 keyHash = _vrfKeyHash; fee = _vrfFee; //操作者地址 operator = _operator; } //一些set函数。。。。。。。。。。 // Public Sale Methods //公售 function startPublicSale( uint256 _publicSalePriceLoweringDuration, uint256 _publicSaleStartPrice, uint256 _publicSaleEndingPrice, uint256 _maxMintPerTx, uint256 _maxMintPerAddress, bool _isKycCheckRequired ) external onlyOperator { require(!publicSaleActive, "Public sale has already begun"); //不用管，荷兰拍取消了 publicSalePriceLoweringDuration = _publicSalePriceLoweringDuration; publicSaleStartPrice = _publicSaleStartPrice; publicSaleEndingPrice = _publicSaleEndingPrice; publicSaleStartTime = block.timestamp; publicSaleActive = true; //每次，每个地址的mint限制 maxMintPerTx = _maxMintPerTx; maxMintPerAddress = _maxMintPerAddress; isKycCheckRequired = _isKycCheckRequired; emit LandPublicSaleStart(publicSalePriceLoweringDuration, publicSaleStartTime); }

point

More from point

point

More from point

No activity yet

More from point

point

point

No activity yet

More from point

APE土拍代码分析

APE土拍代码分析

业务梳理

代码注释

业务梳理

代码注释

No activity yet

No activity yet