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测试网络地址

SettingsRegistry: 0x31ff7a0106cae24756a62657660e3878dcec77dc
ClaimBountyCalculator: 0x8db5203dd8b34efcaa852b29ae9f597a75fbda4e
AuctionSettingIds: 0x2ae7d0bdddc056a682372864fe723f84bc9e8922
MysteriousTreasure: 0x50893ea6964e2c9fc3b9a791c556d752e317bb84
Atlantis: 0x8df7287914144d89adf44d8fdd0b72f4990fb2fc
genesisHolder: 0x59ec5f5f80ff8ae02049eeeea149c2befa63772b
BancorExchange: 0xe243c71d1531c356c8a7072979d4acc7362761ba
LandGenesisDData: 0xaac0ff28c64e6f06728a5e1ce6239f5e3709cd42
ClockAuction: 0x05ddf9e9d0459940c8616b1ff0790a243f1b1e41
RING: 0x6df4e0da83e47e3f6cd7d725224bc73f0e198c4f

AlexChien/market-contracts