平行链卡槽拍卖

平行链卡槽拍卖是通过TRON主网上的提案发起的,提案发起时确定拍卖的轮次、卡槽数量、拍卖截止时间及卡槽有效期。平行链竞拍卡槽需要先向TRON注册跨链相关信息,然后TRON主链上的用户为注册的平行链投票,等到拍卖截止时间后的第一个维护期,会统计本轮次卡槽拍卖的投票结果,确定竞拍卡槽成功的平行链。

卡槽拍卖提案开启

主链如果需要开始平行链卡槽拍卖,需要主链SR发起卡槽拍卖提案,并对提案投票。

示例:
假设TRON主链开启拍卖轮次为第1轮、卡槽数量为01个、拍卖截止时间为1619431600(对应时间2021年4月26日)、卡槽有效期为100天的卡槽拍卖,则TRON主链需要开启如下提案,并对提案投票。

curl -X POST http://47.94.0.13:7096/wallet/proposalcreate -d 
'{
         "owner_address" : "419844F7600E018FD0D710E2145351D607B3316CE9",
          "parameters":[
                   {"key": 55,"value": 1011619431600100},
                   {"key": 56,"value": 100}
          ] 
}'

参数说明:
round:拍卖轮次,占2位,首位为0时可以省略,每次开启拍卖时轮次递增1
slotCount:拍卖卡槽的数量,占2位
endTime:拍卖结束时刻,以秒为单位的时间戳,占10位
duration:卡槽有效期,以天为单位,占3位
注:卡槽拍卖提案的value值格式如下:round + slotCount + endTime + duration,类型为long

返回值:
Transaction

平行链注册

向TRON注册本链的跨链信息。

示例:
假设TRON主链的卡槽拍卖提案已经通过,A链想成为TRON主链的平行链,则A链需要在TRON主链进行平行链注册,创建平行链注册交易接口如下:

curl -X POST http://47.94.0.13:7096/wallet/registercrosschain -d 
'{
          "owner_address": "41A1FA2B6729C898ADB9AE752F879F0AE405408E49",
          "proxy_address": "41A1FA2B6729C898ADB9AE752F879F0AE405408E49",
          "chain_id": "0000000000000000e5144509ff4d0f8100095d33112f407d9e6fbc68dc4f20b3",
          "sr_list":       ["41B363BFDC611FC2C8EDD416986244860E12D64365","416627FC729D90347D89204FF1723B4EE023671CB0","413025DF1BF6117D3DDF917038CE8592889B8B914F","4134A682045FA0DEF316A03AD822A22FC8D5ACFC02","41F54BE75D873621FF883E928E88CD7EA9476790FE","41239D49CD31608560022148DA1B89BE3034B7EE61"],
          "begin_sync_height": 1,
          "maintenance_time_interval": 300000,
          "parent_block_hash":        "0000000000000000e5144509ff4d0f8100095d33112f407d9e6fbc68dc4f20b3",
          "block_time": 1619331294000,
          "register_num": 1
}'

参数说明:
owner_address 注册账号地址,hexString格式
proxy_address 代理账号地址,hexString格式
chain_id 平行链ID,应为平行链创世块block hash
sr_list 平行链的SR地址列表
begin_sync_height TRON主链起始同步块,主链会从平行链的这个区块开始同步区块头,用于SPV验证。
maintenance_time_interval维护期间隔
parent_block_hash 起始同步区块的父区块哈希
block_time 起始同步的区块时间
register_num是注册编号,格式为int64

返回值:
Transaction

投票

从一轮卡槽拍卖开始到拍卖结束这段时间,用户都可以为平行链投票。进行投票时,系统会检查用户的账户余额,已经投票的TRX将被持续锁定(非消耗),主动撤票后,这些TRX才会解除锁定。

以下几种情况,已经投票的用户可以主动撤票:

  • 拍卖正在进行时
  • 拍卖结束后,投票的平行链竞选失败
  • 成功竞拍的平行链到期后

成功竞拍的平行链在到期之前,用户为其投票的TRX会保持锁定状态。

示例:
假设A链已经成功在TRON主链进行了平行链注册,则TRON主链上的用户可以给A链进行投票。
如下的示例中,表示在第1轮的拍卖中,地址为“owner_address”的用户为“chain_id”对应的平行链投出100 SUN。

curl -X POST http://47.94.0.13:7096/wallet/votecrosschain -d
'{
       "chain_id":"0000000000000000e5144509ff4d0f8100095d33112f407d9e6fbc68dc4f20b3",      
       "owner_address":"41A1FA2B6729C898ADB9AE752F879F0AE405408E49",
       "amount": 100, 
       "round": 1
}'

参数说明:
chain_id 被投票平行链ID
owner_address 投票人地址,默认为hexString格式
amount 投票的TRX数量,单位为SUN,票数必须是非负整数
round 拍卖轮次

返回值:
Transaction

撤票

允许用户撤销对平行链的投票,不过不允许对竞拍成功且在有效期内的平行链进行撤票。

示例:
假设A链已经成功在TRON主链进行了平行链注册,但是还未竞拍成功,所以用户可以撤销对A链的投票。
注:在竞拍结束后,对于未成功竞标的平行链的投票,用户需要主动撤票。

curl -X POST http://47.94.0.13:7096/wallet/unvotecrosschain -d 
'{ 
"chain_id":"0000000000000000e5144509ff4d0f8100095d33112f407d9e6fbc68dc4f20b3", "owner_address":"41A1FA2B6729C898ADB9AE752F879F0AE405408E49",
 "round": 1
}'

参数说明:
chain_id 被投票平行链ID
owner_address 投票账号地址,为hexString格式
round 拍卖轮次

返回值:
Transaction

查询投票

获取指定平行链投票详情列表

示例:

curl -X POST http://47.94.0.13:7096/wallet/getcrosschainvotedetaillist  -d 
'{ 
"chain_id":"123",
 "offset": 0,
 "limit": 10, 
"round": 1
}'

参数说明:
chain_id 平行链ID
offset 起始投票的index
limit 期望返回投票信息的数量,最大100
round 拍卖轮次

返回值:
平行链投票详情列表

示例:

curl -X GET http://47.94.0.13:7096/wallet/getcrosschainvotesummarylist?offset=0&limit=10&round=1

获取指定轮次指定平行链的投票详情

示例:

curl -X POST http://47.94.0.13:7096/wallet/getcrosschainvotedetaillist -d 
'{
       "chain_id":"0000000000000000e5144509ff4d0f8100095d33112f407d9e6fbc68dc4f20b3", 
       "round":1, 
       "offset":0,
       "limit":10
}'

获取平行链投票概要列表

示例:

curl -X POST http://47.94.0.13:7096/wallet/getcrosschainvotesummarylist  -d 
'{ 
        "offset": 0, 
        "limit": 10,
        "round": 1
}'

参数说明:
offset 起始平行链投票概要的index
limit 期望返回平行链投票概要的数量,最大100
round 拍卖轮次

返回值:
平行链投票概要列表

查询竞拍结果

查询本轮卡槽拍卖的竞拍结果。

示例:
假设TRON主链卡槽拍卖已经截止,查询TRON主链上卡槽拍卖成功的平行链相关信息。

curl -X GET http://47.94.0.13:7096/wallet/getparachainlist?round=1

参数说明:
round 拍卖轮次

返回值:
平行链ID列表