xlc/Parachain 众筹拍卖模块.md

## Parachain 众筹拍卖模块.md

      
    Raw
  

              Parachain 众筹拍卖模块.md
            
          
    Parachain 众筹拍卖模块

流程


管理员创建众筹 crowdfund::create

参数

orign: Origin

要求 Signed ，任何账号都可以发起众筹


cap: Balance

最多可以筹得的硬顶


first_slot: T::BlockNumber

竞拍的第一个租赁周期编号


last_slot: T::BlockNumber

竞拍的最后一个租赁周期编号


end: T::BlockNumber

众筹结束时间。一次众筹可以参与多次拍卖，但如果直到这个时间众筹还未成功，参与者就可以赎回资金


事件

Created(FundIndex)

众筹编号


发起众筹需要先预存一定数量的资金


参与者贡献资金 crowdfund::contribute

参数

orign: Origin

要求 Signed ，任何账号都可以参与众筹


index: FundIndex

参与的众筹编号


value: Balance

贡献额度，必须比系统预设的最低额度要多。这部分资金会转移给众筹模块。如果现在在拍卖的结束阶段，会在区块结束时执行竞拍


众筹成功，参与者可以生成参与众筹的证据，在平行链上认取相对应的奖励。
众筹成功，租赁时间到并且没有续约，参与者可以赎回参与资金
众筹失败，参与者可以赎回参与资金


## Parachain 拍卖流程介绍.md

      
    Raw
  

              Parachain 拍卖流程介绍.md
            
          
    Parachain 拍卖流程介绍

简介


一次拍卖4个周期的插槽租赁权，每个周期6个月。一个parachain最多竞拍4个周期的租赁权，也就是2年。
一个拍卖有几个阶段

拍卖开始
拍卖结束阶段开始
拍卖真正结束
拍卖结束阶段结束


其中 拍卖真正结束 时间是位置的，在 拍卖结束阶段结束 后才知晓。在 拍卖真正结束 之后的所有竞拍视为无效
一个账户可以分别参与多个不同租赁周期的竞拍，但是要求必须是连续的。比如在竞拍周期为6个月（1个周期）的情况下，可以分别竞拍周期0和周期1，但是在暂时获胜周期0的情况下，不能同时竞拍周期3，因为不连续。

相关代码

插槽模块：https://github.com/paritytech/polkadot/blob/master/runtime/src/slots.rs
众筹拍卖模块：https://github.com/paritytech/polkadot/blob/master/runtime/src/crowdfund.rs
Polkadot Wiki: https://wiki.polkadot.network/docs/en/learn-auction
Web3 Wiki: https://research.web3.foundation/en/latest/polkadot/Parachain-Allocation/
流程


系统发起拍卖 slots::new_auction

参数

orign: Origin

要求 Root， 也就是说只有治理模块可以发起拍卖


duration: BlockNumber

拍卖时长，当这么多块过后，进入 拍卖结束阶段开始


lease_period_index: LeasePeriodOf

要拍卖的第一个租赁周期的编号


事件

AuctionStarted(AuctionIndex, LeasePeriod, BlockNumber)

拍卖编号，租赁周期编号，拍卖结束阶段开始时间


一次只能有一个拍卖，不支持多个拍卖同时进行
进入 拍卖开始 阶段


用户 / 众筹账号 参与竞拍 slots::bid

参数

origin: Origin

要求 Signed，任何用户账号都可以发送交易参与竞拍


sub: SubId

竞拍编号。一个同样的用户账号可以发起多个不同的竞拍，不同的竞拍由竞拍编号来决定


auction_index: AuctionIndex

拍卖编号


first_slot: LeasePeriod

竞拍的第一个租赁周期编号


last_slot: LeasePeriod

竞拍的最后一个租赁周期编号


amount: Balance

竞拍金额。这部分资金会被锁仓直到竞拍结束，或者有人出更高价


事件

Reserved(AccountId, Balance, Balance)

账户，额外冻结资金，总共冻结资金


Unreserved(AccountId, Balance)

账户，总共解冻资金


现有 parachain / parathread 参与续拍 slots::bid_rewnew

参数

origin: Origin

要求 Signed ParaId。只能由现有的parachain / parathread通过治理模块发起


auction_index: AuctionIndex

同 slots::bid


first_slot: LeasePeriod

同 slots::bid


last_slot: LeasePeriod

同 slots::bid


amount: Balance

同 slots::bid


事件

同 slots::bid


拍卖时长后，进入  拍卖结束阶段开始

可以继续竞拍


结束阶段时长后，进入 拍卖结束阶段结束

竞拍截止
计算随机数，随机选取 拍卖结束阶段 中的一个区块作为 拍卖真正结束 区块
拍卖真正结束 区块中的最高竞拍者获胜，其他人的钱退回
事件

WonDeploy(NewBidder<AccountId>, SlotRange, ParaId, Balance)

竞拍成功账号和竞拍编号，租赁周期，平行编号，竞拍金额


WonRenewal(ParaId, SlotRange, Balance, Balance)

续拍成功平行编号，租赁周期，总共竞拍金额，额外竞拍金额


锁定 parachain runtime slots::fix_deploy_data

由 parachain 管理员账号发送


上传 parachain runtime slots::elaborate_deploy_data

任何人都可以发送，但是 runtime hash 必须符合之前由管理员锁定的 hash


租赁周期开始

把新的平行链锁仓的资金销毁，转换成记账
把退休的平行链记账的资金重新铸币退回给管理员账户


租赁周期期间

可以通过平行链治理模块参与续拍


租赁周期结束

如果没有续拍成功，记账的资金重新铸币退回给管理员账户