wallet-cli contract deploy

部署合约字节码。

用法

wallet-cli contract deploy (--artifact <path> | --code <hex> | --code-file <path>)
                           [--constructor-args <json> | --constructor-params <json>]
                           [--constructor-signature <sig>]
                           [--dry-run | --sign-only | --build-only | --wait [--wait-timeout <ms>]]
                           [--abi <json>] [--fee-limit <sun>] [--permission-id <n>] [--expiration <ms>]
                           [--gas-limit <n>] [--max-fee <gwei>] [--priority-fee <gwei>] [--nonce <n>]
                           [options]

说明

以当前账户（或 --account）部署合约的 creation 字节码，并报告新合约的地址；TRON 与 EVM 网络都适用。

字节码从哪里来——三选一，必须且只能给一个，否则报 invalid_value：

来源	适用场景
--artifact <path>	首选。 编译器产物（Foundry、Hardhat/sunhat、TronBox），其中同时包含字节码和 ABI，因此构造函数的参数类型来自编译器，而不是你手写
--code-file <path>	你只有字节码，且放在文件里——creation 字节码经常超出 shell 的参数长度上限
--code <hex>	你只有字节码，而且短到可以直接写在命令行里

读取 artifact 时会依次尝试 .bytecode.object、.bytecode、.evm.bytecode.object，并在存在时读取其 abi。若 artifact 中没有 creation 字节码，或只有 "0x"（接口或抽象合约），会被直接拒绝，而不是当成空合约部署出去。

构造函数的参数类型从哪里来。 --constructor-args 接收的是裸值（["18","MyToken"]），因此类型必须另有来源：--artifact 里的 ABI、显式的 --constructor-signature，或者在 TRON 上用 --abi。三者都没有时报 invalid_value。--constructor-params 接收的是自带类型信息的 {"type","value"} 条目，因此不需要 ABI，但它不能与 --artifact 同用。

TRON 必须有 ABI。 传 --artifact 或 --abi；两个都传是错误。--abi 仅限 TRON，且 ABI 中的 constructor 条目必须带有字符串形式的 stateMutability（"nonpayable" / "payable"）——solc 会输出它，但手工裁剪过的 ABI，或由 0.5 之前版本的 solc 生成的 ABI，可能没有。--constructor-signature 在 TRON 上不被接受。

执行模式与其他构建交易的写入类命令一致：--dry-run 只预览，--sign-only 输出可供 tx broadcast 使用的已签名交易，--build-only 输出未签名的交易，默认在提交时返回，--wait 则阻塞直到已确认/失败。

费用相关的参数跟随链家族——--fee-limit（TRON，默认 100000000 SUN），或 --gas-limit / --max-fee / --priority-fee / --nonce（EVM）。--help 会为每组打上标记，把其中一组用在另一个家族上会以 invalid_option 被拒绝。

命令需要一个账户。仅在需要签名的模式下，才必须通过 --password-stdin 提供 master password。 --dry-run 和 --build-only 不会解锁钱包，因此无需密码。仅观察账户无法签名，会返回 watch_only_no_signer。

在 TRON 上，Ledger app 无法对 CreateSmartContract 签名：Ledger 账户可以做试运行或构建，但签名类模式会以 ledger_unsupported 失败。通过 Ethereum app 在 EVM 上部署则不受此限制。

选项

选项	说明
--artifact <path>	必填（三选一）。同时包含字节码和 ABI 的编译器产物
--code <hex>	必填（三选一）。creation 字节码，hex 编码
--code-file <path>	必填（三选一）。存放 creation 字节码的文件
--constructor-args <json>	构造函数参数，以裸值的 JSON 数组给出，例如 ["18","MyToken"]
--constructor-params <json>	构造函数参数，以 {"type","value"} 条目给出；与 --artifact 互斥
--constructor-signature <sig>	没有 ABI 时给出构造函数的类型，例如 constructor(uint256,string)；用了 --artifact 就不需要它，且在 TRON 上不被接受
--dry-run	只做估算；与 --sign-only / --build-only 互斥
--sign-only	只签名不广播，输出已签名的 hex；与 --dry-run / --build-only 互斥
--build-only	构建并估算，输出未签名的 hex；与 --dry-run / --sign-only 互斥
--wait / --wait-timeout <ms>	广播后轮询直到已确认/失败（上限默认取配置 waitTimeoutMs，内置 60000）
--password-stdin	从 stdin 读取 master password

仅限 TRON：

选项	说明
--abi <json>	合约 ABI，JSON 数组字符串；除非由 --artifact 提供，否则必填
--fee-limit <sun>	允许燃烧的最大能量费用，单位 SUN（默认 100000000）
--permission-id <n>	用于签名的权限组（0=owner，1=witness，2-9=active）；默认 0
--expiration <ms>	交易过期时间（毫秒），最大 86400000（24 小时）；仅可与 --sign-only 或 --build-only 同用；省略时使用节点默认值（约 60 秒）

仅限 EVM：

选项	说明
--gas-limit <n>	要授权的 gas 数量；默认取节点的估算值，不做冗余放大
--max-fee <gwei>	每单位 gas 的最高总费用（仅限 EIP-1559 链）
--priority-fee <gwei>	每单位 gas 的小费（仅限 EIP-1559 链）
--nonce <n>	交易 nonce；默认取账户的 pending nonce。在 --dry-run 下，显式给出的 nonce 会与账户已入块的计数比对，若已被用掉，会在任何估算之前以 nonce_too_low 失败；而仅仅高于下一个值的 nonce，仍只作为 meta.warnings 中的空档提示

此外还有全局选项。

示例

示例中的 $PW 是你的 master password（来自环境变量、密码管理器等），通过 --password-stdin 从 stdin 传入。

使用编译器产物——因为 artifact 自带 ABI，两个家族上的命令写法完全相同：

echo "$PW" | wallet-cli contract deploy --artifact ./build/contracts/Token.json --constructor-args '["18","MyToken"]' --network nile --password-stdin

echo "$PW" | wallet-cli contract deploy --artifact ./out/Token.sol/Token.json --constructor-args '["18","MyToken"]' --network sepolia --password-stdin

⏳ Contract deployed
  Address  TXg3jWThoa5AxuwRA4aRyFAhmRN9hjhQFU
  TxID     b7c...
  Status   pending — not yet on-chain
! Track it: wallet-cli tx info --network tron:3448148188 --txid b7c...

在 EVM 上使用裸字节码，并自行给出构造函数的类型：

echo "$PW" | wallet-cli contract deploy --code-file ./Token.bin --constructor-signature 'constructor(uint8,string)' --constructor-args '["18","MyToken"]' --network sepolia --password-stdin

演练一次 EVM 部署——地址此时已经可知，费用则是一个 gas 上限：

wallet-cli contract deploy --code 0x60006000f3 --network sepolia --dry-run

⏳ Dry run contract deploy
  Address  0xF3741D160A1E64A8D71fFE64CC0F111ddC7720E5
  Fee      ≤ 0.000117 ETH  (53,857 gas × 2.186156 gwei max)
  Tx       {"data":"0...000000"}

echo "$PW" | wallet-cli contract deploy --artifact ./build/contracts/Token.json --network nile --password-stdin -o json

{"schema":"wallet-cli.result.v1","success":true,"command":"contract.deploy","data":{"kind":"contract-deploy","contractAddress":"TXg3jWThoa5AxuwRA4aRyFAhmRN9hjhQFU","stage":"submitted","txId":"b7c..."},"meta":{"durationMs":15,"warnings":[]},"chain":{"family":"tron","network":"tron:3448148188","chainId":"3448148188"}}

输出

data 随阶段而变：

阶段	字段
默认（提交）	kind: "contract-deploy"、contractAddress、stage: "submitted"、txId
--wait（已确认）	同上，另加 confirmed、blockNumber、failed，以及实际开销——TRON 上是 feeSun，EVM 上是 gasUsed / feeWei / effectiveGasPriceWei
--dry-run	kind、mode: "dry-run"、contractAddress、fee、未签名的 tx（EVM 上另加 nonce）
--sign-only / --build-only	kind、mode、hex、fee，以及交易对象

contractAddress 在交易确认之前就已知，但两个家族的推导方式不同。在 EVM 上，它由部署者和 nonce 在本地算出。在 TRON 上，地址由最终的 txID 推导而来，因此它是从已准备好的交易中读回的——在 --permission-id / --expiration 绑定完毕、txID 定下来之后——而不是由构建器的输出算出。

退出码

0 已提交（提前退出的模式下则为已构建/已签名/已试运行） · 1 执行失败（watch_only_no_signer、ledger_unsupported——仅 TRON 签名时、auth_failed、nonce_too_low——--dry-run 配合一个已入块的 --nonce，且在推算合约地址之前就抛出、rpc_error、timeout） · 2 用法错误——file_not_found（指定路径上没有 artifact 或字节码文件），或以下情形之一报 invalid_value：--artifact / --code / --code-file 一个都没给或给了多个；--constructor-args 没有类型来源；--constructor-params 与 --artifact 同用；artifact 中没有 creation 字节码；TRON 部署既没给 --artifact 也没给 --abi，或两个都给了；或者 ABI 的 constructor 条目缺少字符串形式的 stateMutability。

另请参见

contract info · contract send · contract create2 · tx status

---