wallet-cli chain params

August 17, 2026 · View on GitHub

Show on-chain governance parameters.

Synopsis

wallet-cli chain params [--key <name>] [options]

Description

Lists the chain's governance parameters — network-wide system settings changed by SR proposals (this CLI does not create proposals). --key returns a single one. Keys pass through exactly as the chain returns them; text output adds thousands separators and units (SUN / ms) for known numeric keys, -o json keeps raw values.

Frequently used keys:

KeyMeaning
getEnergyFeeEnergy unit price (SUN/energy) — the burn rate when you lack energy; core input to fee estimation
getTransactionFeeBandwidth unit price (SUN/byte) — the burn rate once free bandwidth is spent
getCreateAccountFeeSystem-side account creation fee (SUN) — part of the extra cost of sending to a fresh address
getWitnessPayPerBlockSR reward per block produced (SUN) — feeds the voting-reward pool
getMaintenanceTimeIntervalMaintenance cycle length (ms; 21,600,000 = 6 h) — the vote-tally / SR-ranking period

For the fee-relevant prices in friendlier form, use chain prices.

Options

OptionDescription
--key <string>Return only this parameter (e.g. getEnergyFee)

Plus the global options.

Examples

A single parameter with --key:

wallet-cli chain params --key getEnergyFee --network tron:nile
Key    getEnergyFee
Value  210 SUN

All parameters (excerpt):

wallet-cli chain params --network tron:nile
| Key                        | Value          |
| -------------------------- | -------------- |
| getEnergyFee               | 210 SUN        |
| getTransactionFee          | 1,000 SUN      |
| getCreateAccountFee        | 100,000 SUN    |
| getWitnessPayPerBlock      | 16,000,000 SUN |
| getMaintenanceTimeInterval | 21,600,000 ms  |
wallet-cli chain params --network tron:nile -o json
{"schema":"wallet-cli.result.v1","success":true,"command":"chain.params","data":{"params":[{"key":"getEnergyFee","value":210},{"key":"getTransactionFee","value":1000},{"key":"getCreateAccountFee","value":100000}]},"meta":{"durationMs":19,"warnings":[]},"chain":{"family":"tron","network":"tron:nile","chainId":"nile"}}

Output

data.params[] — one entry per parameter:

FieldTypeMeaning
keystringParameter name, verbatim from the chain
valuenumberRaw chain value, no unit suffix (text adds SUN / ms)

Exit status

0 success · 1 execution failure (rpc_error; not_found--key doesn't exist) · 2 usage error (invalid_value).

See also

chain prices · chain node