# 链上治理

在链上治理一章中，我们已为您介绍了：TOP AI Network链上治理的一切活动都通过提案、TCC表决的方式进行，且任何用户都可以发起提案。

TOP AI Network链上治理的核心组织是TOP社区委员会（TOP Community Council，以下简称TCC），TCC的职责是对社区提案进行表决和执行。

本章将为您介绍TOPIO链上治理相关功能，包括：

命令 说明
topio govern getProposal 查询链上治理提案。
topio govern CGP 查询链上治理参数。
topio govern submitProposal 提交链上治理提案。
topio govern withdrawProposal 撤回链上治理提案。
topio govern tccVote TCC表决提案。

# 查询链上治理提案

对提案投票前，可先获取提案详细信息了解提案。

请求方式

topio govern getProposal

请求参数

参数名称 是否必选 默认值 类型 说明
proposal_id 否 空字符串 String 提案ID，如为空，默认查询所有提案。
提案ID可通过topio govern getProposal查询。

选项

选项名称 默认值 类型 说明
-h, --help - - 查看命令帮助信息。

返回参数

参数名称 类型 说明
effective_timer_height Uint64 提案通过后生效时钟高度。如生效始终高度小于提案通过时的始终高度，那么提案在通过后会立刻生效。
expire_time String 提案失效时间，提案在259200个时钟高度内没有被TCC通过或者否决，提案将失效。
priority Uint8 提案优先级：1--Normal；2--Important；3--Critical。
proposal_deposit Uint64 提案保证金，单位uTOP。
proposal_id String 提案ID，系统自动生成，唯一。
proposal_type Uint8 提案类型：1--修改链上治理参数提案；2--社区基金管理提案。
proposer_account_addr String 提案发起者账户地址。
target String 当提案类型为修改链上治理参数提案时，target为链上治理参数名称，链上治理参数请参见链上治理参数说明；
当提案类型为社区基金管理提案时，target为接受转账账户地址，销毁账户地址为：T-b-gkhLhFJXVN3ZPQYZxphja93BEUtwKRdden。
value String 当target为链上治理参数时，value为修改后的值。
当target为接受转账账户地址，value为转账金额，单位uTOP。
voting_status Uint16 该提案投票表决状态：0--未开始；8--进行中；9--失败；10--成功。

请求样例

topio govern getProposal 1

返回样例

  • 成功返回
{
    "data" : {
      "1":{
	      "effective_timer_height": 1010110,
	      "expire_time": 1000
	      "priority": 3,
	      "proposal_deposit": 400,
	      "proposal_id": 1,
	      "proposal_type": 1,
         "proposer_account_addr" : "T800002276a7d58218ac4978733e5cca927a7d86cb7c87",
	      "target": archive_deposit,
	      "value": 1000,
	      "voting_status": 0
      }
   },
   "errmsg" : "ok",
   "errno" : 0,
   "sequence_id" : "3"
}
  • 失败返回
No data!

# 查询链上治理参数

请求方式

topio govern CGP

请求参数

无。

选项

选项名称 默认值 类型 说明
-h, --help - - 查看命令帮助信息。

返回参数

查询返回的参数值为参数当前最新值，关于参数的说明请参见链上治理参数。

请求样例

topio govern CGP

返回样例

  • 成功返回
{
   "data" : {
      "additional_issue_year_ratio" : "8",
      "application_contract_code_max_len" : "32768",
      "archive_election_interval" : "360",
      "auditor_group_count" : "2",
      "auditor_nodes_per_segment" : "27",
      "auditor_reward_ratio" : "10",
      "award_auditor_credit" : "30000",
      "award_validator_credit" : "30000",
      "backward_auditor_slash_credit" : "100000",
      "backward_node_lock_duration_increment" : "103680",
      "backward_validator_slash_credit" : "100000",
      "beacon_tx_fee" : "100000000",
      "cluster_election_interval" : "60",
      "cluster_election_minimum_rotation_ratio" : "66",
      "cluster_zero_workload" : "0",
      "contract_call_contracts_num" : "25",
      "cpu_gas_exchange_ratio" : "40",
      "cross_reading_rec_reg_contract_height_step_limitation" : "12",
      "cross_reading_rec_reg_contract_logic_timeout_limitation" : "60",
      "cross_reading_rec_standby_pool_contract_height_step_limitation" : "12",
      "cross_reading_rec_standby_pool_contract_logic_timeout_limitation" : "67",
      "custom_property_max_number" : "128",
      "custom_property_name_max_len" : "16",
      "dividend_ratio_change_interval" : "120960",
      "edge_election_interval" : "360",
      "edge_reward_ratio" : "2",
      "election_rotation_count_ratio" : "16",
      "free_gas" : "25000",
      "fullunit_contain_of_unit_num" : "21",
      "governance_reward_ratio" : "4",
      "initial_total_locked_token" : "1000000000000000",
      "max_archive_group_size" : "512",
      "max_auditor_group_size" : "64",
      "max_auditor_rotation_count" : "2",
      "max_edge_group_size" : "512",
      "max_election_committee_size" : "256",
      "max_gas_account" : "1000000",
      "max_gas_contract" : "50000000",
      "max_nodedeposit_lock_duration" : "3110400",
      "max_validator_group_size" : "128",
      "max_validator_stake" : "5000",
      "max_vote_nodes_num" : "10000",
      "min_auditor_deposit" : "1000000000000",
      "min_auditor_group_size" : "6",
      "min_credit" : "100000",
      "min_edge_deposit" : "200000000000",
      "min_election_committee_size" : "32",
      "min_free_gas_balance" : "100000000",
      "min_mainnet_active_archives" : "1",
      "min_mainnet_active_auditors" : "128",
      "min_mainnet_active_edges" : "1",
      "min_mainnet_active_validators" : "512",
      "min_mainnet_active_votes" : "384000000",
      "min_node_reward" : "0",
      "min_ratio_annual_total_reward" : "2",
      "min_stake_votes_num" : "1",
      "min_table_block_report" : "32",
      "min_tcc_proposal_deposit" : "0",
      "min_tx_deposit" : "100000",
      "min_validator_deposit" : "500000000000",
      "min_validator_group_size" : "6",
      "min_voter_dividend" : "0",
      "min_votes_num" : "1",
      "punish_interval_table_block" : "368640",
      "punish_interval_time_block" : "8640",
      "rec_election_interval" : "259201",
      "rec_standby_pool_update_interval" : "11",
      "reward_issue_interval" : "8640",
      "shard_zero_workload" : "0",
      "sign_block_publishment_threshold_value" : "0",
      "sign_block_ranking_publishment_threshold_value" : "10",
      "sign_block_ranking_reward_threshold_value" : "0",
      "sign_block_reward_threshold_value" : "80",
      "tableslash_report_schedule_interval" : "1",
      "tableworkload_report_schedule_interval" : "1",
      "task_num_per_round" : "16",
      "tcc_member_number" : "T800002276a7d58218ac4978733e5cca927a7d86cb7c87,T8000066ab344963eaa071f9636faac26b0d1a39900325",
      "tcc_proposal_expire_time" : "259200",
      "toggle_whitelist" : "0",
      "total_gas_shard" : "2160000000000",
      "tx_deposit_gas_exchange_ratio" : "20",
      "tx_send_timestamp_tolerance" : "300",
      "unlock_gas_staked_delay_time" : "8640",
      "usedgas_decay_cycle" : "8640",
      "validator_group_count" : "4",
      "validator_reward_ratio" : "60",
      "vote_reward_ratio" : "20",
      "votes_report_interval" : "30",
      "whitelist" : "T8000085a8e8acd53c72dca85dcb002a6710796975b4ba,T80000FD4f433c036268F17a1b4204eA907E70618d030E,T8000066ab344963eaa071f9636faac26b0d1a39900325,T800002276a7d58218ac4978733e5cca927a7d86cb7c87",
      "workload_per_tableblock" : "2",
      "workload_per_tx" : "1",
      "workload_report_min_table_block_num" : "32",
      "workload_timer_interval" : "17",
      "zec_election_interval" : "120977",
      "zec_standby_pool_update_interval" : "31",
      "zone_election_trigger_interval" : "31"
   },
   "errmsg" : "OK",
   "errno" : 0,
   "sequence_id" : "1"
}
  • 失败返回

无。

# 提交链上治理提案

任何用户都可以发起提案。

除了最低交易保证金0.1 TOP token，提交提案，需要扣除100 TOP token的交易手续费。

因此提交提案前请确保您的账户里至少有100.1 TOP token的余额。

# 链上治理参数修改提案

通过提案对链上治理参数进行修改。

# 社区基金管理提案

系统将治理奖励和零工作量节点奖励发放至社区基金账户，社区用户可以通过链上治理提案将账户中的余额转账至销毁账户，提案经过TCC表决通过后，销毁即生效。

社区基金账户地址：T2000138QMHWxXshXyZa1E48JU1LREu3UrT5KGD2U@0。

销毁账户地址：T!0001Ebj8hBvoLdvcEEUwNZ423zM3Kh9d4nL1Ug。

请求方式

topio govern submitProposal

请求参数

参数名称 是否必选 默认值 类型 说明
proposal_type 是 - Uint64 提案类型：1--链上治理参数修改提案；2--社区基金管理提案。
target 是 - String 当提案类型为链上治理参数修改提案时，target为链上治理参数名称，链上治理参数请参见链上治理参数说明；
当提案类型为社区基金管理提案时，target为接受转账账户地址，销毁账户地址：T!0001Ebj8hBvoLdvcEEUwNZ423zM3Kh9d4nL1Ug。
value 是 - String 当target为链上治理参数时，value为修改后的值。
当target为接受转账账户地址，value为转账金额，单位TOP。
proposal_deposit 是 - Double 提案保证金，链上治理参数，当前最低为0。
effective_timer_height 是 - Uint64 提案通过后生效时钟高度。如生效时钟高度小于提案通过时的时钟高度，那么提案在通过后会立刻生效。

选项

选项名称 默认值 类型 说明
-h, --help - - 查看命令帮助信息。

返回参数

参数名称 类型 说明
Transaction hash String 本次交易hash，可用于查询此次交易结果。

请求样例

topio govern submitProposal 1 advance_deposit 10000 100 1010110

返回样例

  • 成功返回
Transaction hash: 0xb777722eba6b3b9295f42171b0ed7a31d72f6465797ddeed111af4f0ad710a1f
Please use command 'topio querytx' to query transaction status later on!!!

根据交易hash，使用topio querytx查询交易，交易最终共识成功，则成功提交提案。

  • 失败返回

根据交易hash，使用topio querytx查询交易，交易最终共识失败，则提交提案失败。

# 撤回链上治理提案

提案只能由对应的提案者撤回。

请求方式

topio govern withdrawProposal

请求参数

参数名称 是否必选 默认值 类型 说明
proposal_id 是 - String 提案ID，提案ID可通过topio govern getProposal查询。

选项

选项名称 默认值 类型 说明
-h, --help - - 查看命令帮助信息。

返回参数

参数名称 类型 说明
Transaction hash String 本次交易hash，可用于查询此次交易结果。

请求样例

topio govern withdrawProposal 1

返回样例

  • 成功返回
Transaction hash: 0xe1befa7a1acae89fbbf9c3cab8314212fb671af003a9d581867b541428e02f56
Please use command 'topio querytx' to query transaction status later on!!!

根据交易hash，使用topio querytx查询交易，交易最终共识成功，则成功撤回提案。

  • 失败返回

根据交易hash，使用topio querytx查询交易，交易最终共识失败，则撤回提案失败。

# TCC表决提案

对提案投票前，可先获取提案详细信息了解提案。

只有TCC委员有表决权，表决通过的规则：需2/3的委员通过，且反对委员不超过20%。

提案表决通过后，且没有被否决，将形成立法命令，发给全网节点。

提案表决通过后，将形成立法命令，发给全网节点。

提案被表决通过后，系统将自动删除提案，无法查询提案。

请求方式

topio govern tccVote

请求参数

参数名称 是否必选 默认值 类型 说明
proposal_id 是 - String 提案ID，可通过topio govern getProposal查询。
opinion 是 - String 表决意见：true--赞成；false--反对。

选项

选项名称 默认值 类型 说明
-h, --help - - 查看命令帮助信息。

返回参数

参数名称 类型 说明
Transaction hash String 本次交易hash，可用于查询此次交易结果。

请求样例

topio govern tccVote 1 true

返回样例

  • 成功返回
Transaction hash: 0x1eca678e243743f226ebb6a42c7a5500a056c890574392c7bf70b6797e179902
Please use command 'topio querytx' to query transaction status later on!!!

根据交易hash，使用topio querytx查询交易，交易最终共识成功，则成功表决提案。

  • 失败返回

根据交易hash，使用topio querytx查询交易，交易最终共识失败，则表决提案失败。

← 备份与还原数据库 →

Last Updated: 2024/8/27 上午4:04:09