wallet-cli config¶
查看 / 读取 / 设置配置项。
用法¶
wallet-cli config [<key>] [<value>] [options]
参数¶
key——要读取或设置的配置键；省略则显示完整的生效配置value——新值；省略则表示读取该键
选项¶
仅全局选项。
注意事项¶
已知的配置键：
| 键 | 取值 | 内置默认值 | 含义 |
|---|---|---|---|
defaultNetwork |
网络 id | tron:728126428 |
省略 --network 时使用的网络 |
defaultOutput |
text | json |
text |
省略 -o 时使用的输出格式 |
timeoutMs |
毫秒，任意大于 0 的有限数 | 60000 |
单次节点、服务或设备调用的默认超时（--timeout 可覆盖）。与 waitTimeoutMs 不同，它不要求是整数 |
waitTimeoutMs |
整数毫秒 ≥ 0 | 60000 |
广播类命令 --wait 轮询的默认时间上限 |
gasfreeApiKey |
string | （未设置） | GasFree API key（gasfree） |
gasfreeApiSecret |
string | （未设置） | GasFree API secret |
tronlinkSecretId |
string | （未设置） | TronLink 多签服务的 secretId（tx multisig） |
tronlinkSecretKey |
string | （未设置） | TronLink 多签服务的 secretKey |
tronlinkChannel |
string | （未设置） | TronLink 多签服务的 channel |
aliases |
—— | —— | 简称 → 规范 id 的映射（只读） |
networks |
—— | —— | 已知网络及其可配置字段（作为整体只读） |
networks.<id> |
—— | —— | 某个网络的可配置字段；<id> 可以是规范 id，也可以是别名 |
networks.<id>.httpEndpoint |
URL | 每个网络各自的值 | 要使用的节点 / RPC 端点 |
networks.<id>.apiKeyHeader |
header 名 | （未设置） | 商用端点用于认证的 header，例如 TRON-PRO-API-KEY |
networks.<id>.apiKey |
string | （未设置） | 通过该 header 发送的凭据。敏感信息——读取时始终以掩码显示 |
networks 和 aliases 作为整体是只读的；可写的网络设置就是 networks.<id>.… 那三个叶子键。其他任何子键都会返回 invalid_value，错误信息会列出受支持的键。
同时存在命令行选项和配置键时的优先级（从高到低）：命令行选项 > 配置值 > 内置默认值——例如 --timeout > 配置 timeoutMs > 内置的 60000。
敏感信息绝不会以明文呈现。 tronlinkSecretKey、gasfreeApiSecret 和 networks.<id>.apiKey 在任何读取中都返回 ********，设置它们时回显的 input 也是 "********"——值只写进 config.yaml，不会出现在终端里，也不会混进日志中你 shell 历史文件的邻居里。
列表中的端点会被隐藏部分内容，只有按名称读取时才显示完整值。 config 和 config networks 只将 httpEndpoint 显示为主机名，因为商用端点可能把 key 放在 URL 路径中。只有明确查询某个网络（config networks.tron:3448148188）或其叶子键（config networks.tron:3448148188.httpEndpoint）时，CLI 才会显示完整 URL。
由于 config.yaml 可能保存服务凭据，它会受到权限检查：符号链接，或对同组/其他用户可读的文件，都会以 insecure_config 失败。请对它执行 chmod 600。
外部服务的凭据是按环境区分的：GasFree（gasfreeApiKey / gasfreeApiSecret）和 TronLink（tronlinkSecretId / tronlinkSecretKey / tronlinkChannel）的凭据必须与当前 --network 所属的服务环境（主网 vs 测试网）匹配；不匹配会以 provider_error 失败，所以切换环境时记得同步更换。某个键未设置时，需要它的命令会给出明确的错误——gasfree 报 gasfree_credentials_missing，tx multisig 报 tronlink_credentials_missing。
取值非法时返回 invalid_value（退出码 2）。
示例¶
查看完整的生效配置：
wallet-cli config
defaultNetwork tron:728126428
defaultOutput text
timeoutMs 60000
waitTimeoutMs 60000
networks
tron:728126428
httpEndpoint api.trongrid.io
tron:3448148188
httpEndpoint nile.trongrid.io
tron:2494104990
httpEndpoint api.shasta.trongrid.io
eip155:1
httpEndpoint ethereum-rpc.publicnode.com
eip155:11155111
httpEndpoint ethereum-sepolia-rpc.publicnode.com
eip155:56
httpEndpoint bsc-dataseed.bnbchain.org
eip155:97
httpEndpoint bsc-testnet-dataseed.bnbchain.org
aliases
tron tron:728126428
tron:mainnet tron:728126428
nile tron:3448148188
tron:nile tron:3448148188
shasta tron:2494104990
tron:shasta tron:2494104990
ethereum eip155:1
sepolia eip155:11155111
bsc eip155:56
bsc-testnet eip155:97
tronlinkSecretId TEST
tronlinkSecretKey ********
tronlinkChannel test
gasfreeApiKey ak_9f2c71d0e8b64a53
gasfreeApiSecret ********
先读取某个键，再设置它：
wallet-cli config timeoutMs
timeoutMs 60000
wallet-cli config timeoutMs 120000
✅ Set config
Key timeoutMs
Value 120000
wallet-cli config timeoutMs 120000 -o json
{"schema":"wallet-cli.result.v1","success":true,"command":"config","data":{"key":"timeoutMs","value":120000,"input":"120000"},"meta":{"durationMs":3,"warnings":[]}}
把某个网络指向你自己的节点，或指向一个通过 header 认证的商用端点：
wallet-cli config networks.tron:3448148188.httpEndpoint http://127.0.0.1:8090
wallet-cli config networks.tron:728126428.apiKeyHeader TRON-PRO-API-KEY
wallet-cli config networks.tron:728126428.apiKey <your-key>
指名读取某个网络时，端点会完整给出，与上面的列表不同：
wallet-cli config networks.tron:3448148188
networks.tron:3448148188
httpEndpoint https://nile.trongrid.io
{"schema":"wallet-cli.result.v1","success":true,"command":"config","data":{"key":"networks.tron:3448148188","value":{"httpEndpoint":"https://nile.trongrid.io"}},"meta":{"durationMs":15,"warnings":[]}}
输出¶
data 随使用模式而异。本地命令——没有 chain 块。
| 模式 | data 字段 |
|---|---|
| 全部显示（无参数） | 每个配置键一个字段：defaultNetwork、defaultOutput、timeoutMs、waitTimeoutMs、networks（id → {httpEndpoint, apiKeyHeader?, apiKey?}，端点裁剪为主机名）、aliases（别名 → id）、tronlinkSecretId、tronlinkSecretKey、tronlinkChannel、gasfreeApiKey、gasfreeApiSecret |
读取（<key>） |
key、value |
设置（<key> <value>） |
key、value、input（用户输入的原始字符串；该键为敏感信息时为 "********"） |
某个网络字段未设置时，它在视图中是缺席的，而不是存在但为空——这个视图说明的是「哪些已经配置了」。
退出码¶
0 成功 · 1 执行失败（io_error——原子写入配置失败） · 2 用法错误（invalid_config——config.yaml 不可读或不是合法 YAML；insecure_config——文件中存有服务凭据，却是符号链接或对同组/其他用户可读，请对其执行 chmod 600；invalid_value——未知的键、给只读键传了值，或使用了不受支持的 networks.<id>.<field>）。参见 machine-interface。