网络参数

TRON 常用网络参数及实时查询入口——资源定价、奖励、TVM 功能、提案有效期等。

📘

前置阅读

TRON 网络通过一组动态参数控制链的运行行为——资源定价、产块奖励、TVM 功能开关、提案有效期等。参数的当前值存储在链上;参数 ID、允许范围、分叉或版本前置条件、参数依赖关系及单向启用规则则由 java-tron 协议实现校验。委员会只能在这些规则允许的范围内通过提案修改参数,并非所有值都能任意设置或反向恢复。

任何 SR、SR 合伙人或 SR 候选人都可发起提案。时间戳达到或超过到期时间的首个维护触发区块会进行计票;只有本次维护更新前的 27 位活跃 SR 中至少 18 位赞成,提案才会通过并应用。

本文说明参数的读取途径,列出一组典型参数作为参考,并给出全量实时列表的数据源入口。提案的提交与投票机制见委员会与提案;端到端 TronWeb 演练见创建治理提案 recipe。

参数查询

通过 wallet/getchainparameters 接口可查询所有参数名称(key)及其当前值;数字 ID 不在该接口响应中返回。也可以在 TronScan 等区块浏览器的治理页面实时查看。

节点在接受 ProposalCreateContract 交易时,会根据当前 java-tron 版本校验参数范围、分叉前置条件和依赖关系;不满足约束的提案交易会被拒绝。已上链提案在投票窗口到期后的首次维护处理时,按本次维护更新前的活跃 SR 集统计有效批准票;达到 18 票后,新参数值写入链状态并用于后续区块。

完整列表在哪里查

📘

本页仅供核心参数参考。

TRON 有 70 余项动态参数,并随协议升级持续增加。本页仅列出部分典型参数,完整列表请参考以下数据源:

  • TRONSCAN 治理页 —— tronscan.org/#/sr/parameter —— 包含参数描述和当前值
  • 实时 API —— 向任意 TRON 节点 POST wallet/getchainparameters ,接口返回以参数名为 Key 的 JSON 数据(例如 getMaintenanceTimeInterval、getEnergyFee),便于机器直接读取与解析。

已同步主网的节点通过 wallet/getchainparameters 直接返回本地链状态;TRONSCAN 使用近实时索引,可能存在短暂延迟。两者不一致时,以确认同步完成的主网节点返回值为准,并结合当前 java-tron 版本核对参数约束。

示例参数

以下示例仅供参考,不涵盖全量列表,只列出费用估算、质押规划与 SR 治理中最常用的参数。表中数值是编写本文时的主网快照,实时状态请调用 API 或访问 TRONSCAN 获取。

网络层——治理、SR 经济与协议相关

ID名称当前值说明
#0getMaintenanceTimeInterval6 小时维护周期:SR 超级代表集轮换、投票计数、分成比例(Brokerage)变更及提案计票所依据的周期
#1getAccountUpgradeCost9,999 TRX申请 SR 候选人资格所需费用。由协议底层直接销毁并从流通量中移除——不可追回,即使账户停止担任 SR 也不例外
#5getWitnessPayPerBlock每区块 8 TRX支付给出块 SR 的产块奖励
#31getWitness127PayPerBlock每区块 128 TRX按获得票数加权,由前 127 名 SR 和 SR 合伙人共享的投票奖励池
#92getProposalExpireTime3 天新提案的基准投票窗口;实际到期时间向上取整至下次计划维护时间

用户层——资源与费用

ID名称当前值说明
#11getEnergyFee每单位能量 0.0001 TRX(100 sun)通过燃烧 TRX 支付合约调用费用时,每单位能量的单价
#47getMaxFeeLimit15,000 TRX智能合约调用的单笔交易 fee_limit 上限。超过该值的交易将被拒绝
#61getFreeNetLimit600 带宽每个账户每天的免费带宽配额(约可完成 2 笔简单 TRX 转账)
#70getUnfreezeDelayDays14 天在 Stake 2.0 中,unfreezebalancev2 与 withdrawexpireunfreeze 之间的等待时间

通过代码读取参数

查询所有参数值:

BASE_URL=https://api.trongrid.io   # 示例——替换为任意 TRON 节点(TronGrid、第三方或自托管)
curl -X POST ${BASE_URL}/wallet/getchainparameters

响应为一个包含 chainParameter 数组的 JSON 对象。每个数组成员都包含 key,并通常包含 value。其中 key 是上表“名称”列所示的描述性字符串,例如 getEnergyFee;表中的数字 ID 用于创建治理提案,不会作为该接口的 key 返回。

接口响应使用 proto3 JSON 映射,字段值为其类型的默认值时,可能从 JSON 中省略。value 的类型为 int64,默认值为 0。关于各字段类型的默认值及省略规则,请参阅 Proto3 默认值省略。

{
  "chainParameter": [
    { "key": "getMaintenanceTimeInterval", "value": 21600000 },
    { "key": "getAccountUpgradeCost", "value": 9999000000 },
    { "key": "getCreateAccountFee", "value": 100000 }
  ]
}

注意 API 返回值中,TRX 值以 sun 表示(1 TRX = 1,000,000 sun),时间间隔以毫秒表示。


相关资源