README

market-contracts

this project implements the whole Dutch Auction.

此项目实现了完整的荷兰式拍卖

拍卖合约

(只需要部署ClockAuction) ClockAuction.sol

前置准备

在部署ClockAuction之前需要部署的合约如下:

Land合约
RING合约
bancorExchange合约 (用于ETH和RING相互转换)
GenesisHolder合约 (即ClockAucion中的pangu)
LandData合约 (存储地块属性)

初始化相关

在合约的构造器中涉及到的参数，其意义分别是：

address _nftAddress: LAND合约地址
address _pangu: 拍卖的分账合约，执行初代拍卖的合约
address _registry: 注册各变量的合约地址

拍卖操作相关

1. 创建拍卖

使用LAND合约中的approveAndCall方法，传入参数为：

_to: 拍卖合约地址
_tokenId: 地块的tokenId
_startingPriceInToken: 起始价格（ring）
_endingPriceInToken: 终止价格(ring)，其实价格比终止价格高
_duration: 拍卖持续时间，以秒为单位
_seller: 卖方(或者地块拥有者指定的地块拍卖的受益人) 第3、4、5、6个变量拼成一个bytes，如下：（换行仅为了方便理解）

0x
000000000000000000000000000000000000000000084595161401484a000000
00000000000000000000000000000000000000000000152d02c7e14af6800000
000000000000000000000000000000000000000000000000000000000002cad8
000000000000000000000000da7fab79bfd0a27f04367f5b9b9348cb5d1b0023

2. 取消拍卖

使用clockAunction.sol中cancelAuction方法

注意：只允许此次拍卖的_seller取消，如果_seller不是该地块的拥有者的话，意味着地块拥有者也无法取消此次拍卖

3. 获得拍卖信息

使用clockAunction.sol中getAuction方法

4. 获得拍卖的现时价格

使用clockAunction.sol中getCurrentPriceInToken方法

5. 使用RING来竞拍地块

发送要竞拍某次拍卖使用的RING的数量，到clockAunction合约中，使用RING.transfer(address(BidAuctionRING),ringAmount,data)即可。其中data的长度为bytes64,组成如下：

第一个bytes32: tokenId(注意必须是64位原始格式，不要写十进制格式)
第二个bytes32: 推荐人的address

data的例子如下（分行仅为显示清晰）：

0x
0000000000000000000000000000000100000000000000000000000000000001
000000000000000000000000375eae23b65feb1833072328647902f1fe9afa61

注意：需要把tokenId转换成bytes格式

6. 使用ETH来竞拍地块

使用clockAunction.sol中的bidWithETH方法

提币相关

使用clockAunction.sol中的claimTokens方法

KOVAN测试网络地址

TradingRewardPoolAuthority: 0x45ce89ca7dd52a3a014d1b5b1f701b7f6f47b6c7
KTONAuthority: 0x53e9238d3e5c083ede29f074bd26467af17b5389
AuctionSettingIds: 0xb39a4e98ce16d5c9b2c77b205cb1401555ea424f
LandBaseAuthority: 0xbd794a98cc24aa6e3ccb82afa056444d31e65113
ClaimBountyCalculator: 0x9a6f0952392461dbc36fc3e1215f5f31958ffed1

ClockAuction: 0xb5bd48f53da98c92797b96adf5d918fb274285ff
ClockAuctionProxy:  0xba332453b171aac634b3bed88bfef28770acf7e3

MysteriousTreasure: 0x9095da261e2ad0214801d7ac8db0ff13913ba327
MysteriousTreasureProxy:  0xbeeb8ce024dbce8ba7e74671440cfa80c264f97d

GenesisHolder: 0xd8135e9ccec512d3ef696b188a45edab16b248f7
GenesisHolderProxy:  0x09da088f1a94b9a764c47609fa727a9ef4b5b390

RevenuePool: 0xa68f8bc7b7616bdc10611b83338f5a5927e3dd21
RvenuePoolProxy:  0x96b53ff8ded636d4a58a8a2f65eeda9ea392f4ff

TradingRewardPool: 0xc0a768a71b1722b5bcc908157795e7f820fa5841
TradingRewardPoolProxy_address:  0x611cb5e939c2815b690930fb3fec1a606ddcd7a5

@evolutionland/market

Usage no npm install needed!