网络参数
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 | 名称 | 当前值 | 说明 |
|---|---|---|---|
| #0 | getMaintenanceTimeInterval | 6 小时 | 维护周期:SR 超级代表集轮换、投票计数、分成比例(Brokerage)变更及提案计票所依据的周期 |
| #1 | getAccountUpgradeCost | 9,999 TRX | 申请 SR 候选人资格所需费用。由协议底层直接销毁并从流通量中移除——不可追回,即使账户停止担任 SR 也不例外 |
| #5 | getWitnessPayPerBlock | 每区块 8 TRX | 支付给出块 SR 的产块奖励 |
| #31 | getWitness127PayPerBlock | 每区块 128 TRX | 按获得票数加权,由前 127 名 SR 和 SR 合伙人共享的投票奖励池 |
| #92 | getProposalExpireTime | 3 天 | 新提案的基准投票窗口;实际到期时间向上取整至下次计划维护时间 |
用户层——资源与费用
| ID | 名称 | 当前值 | 说明 |
|---|---|---|---|
| #11 | getEnergyFee | 每单位能量 0.0001 TRX(100 sun) | 通过燃烧 TRX 支付合约调用费用时,每单位能量的单价 |
| #47 | getMaxFeeLimit | 15,000 TRX | 智能合约调用的单笔交易 fee_limit 上限。超过该值的交易将被拒绝 |
| #61 | getFreeNetLimit | 600 带宽 | 每个账户每天的免费带宽配额(约可完成 2 笔简单 TRX 转账) |
| #70 | getUnfreezeDelayDays | 14 天 | 在 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),时间间隔以毫秒表示。
相关资源
- 委员会与提案 —— 委员会和提案介绍
- 创建治理提案 —— 提交并跟踪提案的 TronWeb recipe
- 超级代表 —— 章节概览
wallet/getchainparameters—— 查询当前参数值wallet/proposalcreate—— 创建新提案
Updated 5 days ago
