钱包管理¶

创建、导入、导出和管理本地钱包，以及会话状态（登录 / 锁定 / 切换）。

keystore 和密钥材料的相关概念，参见环境准备 / 配置参考。完整的首次运行流程，参见快速上手指南。

RegisterWallet¶

创建钱包。设置钱包密码后，wallet-cli 会生成地址和私钥。

ImportWallet¶

从十六进制字符串格式的私钥导入钱包。导入时需要设置密码。

ImportWalletByBase64¶

从 Base64 格式的私钥导入钱包。导入时需要设置密码。

ImportWalletByMnemonic¶

从助记词导入钱包。你需要设置密码并输入助记词。

wallet> ImportWalletByMnemonic
Please input password.
password:
Please input password again.
password:
Please enter 12 or 24 words (separated by spaces) [Attempt 1/3]:

ExportWalletMnemonic¶

导出钱包中该地址的助记词。

wallet> ExportWalletMnemonic
Please input your password.
password:
exportWalletMnemonic  successful !!
alert twist correct matter pass gather pit position stop empty coconut abandon

ExportWalletKeystore¶

以 TronLink 钱包格式导出钱包 keystore。

wallet> ExportWalletKeystore tronlink /tmp
Please input your password.
password:
exported keystore file : /tmp/TYdhEg8b7tXm92UDbRDXPtJNU6T9xVGbbo.json
exportWalletKeystore  successful !!

ImportWalletByKeystore¶

把 TronLink 格式的 keystore 文件导入 wallet-cli。

wallet> ImportWalletByKeystore tronlink /tmp/tronlink.json
Please enter the password for the keystore file, enter it once.
password:
Please input password.
password:
Please input password again.
password:
fileName = TYQq6zp51unQDNELmT4xKMWh5WLcwpCDZJ.json
importWalletByKeystore  successful !!

ImportWalletByLedger¶

把 Ledger 设备上派生的账户导入 wallet-cli。

wallet> ImportWalletByLedger
(Note:This will pair Ledger to user your hardware wallet)
Ledger device found: Nano X
Please input password.
password:
Please input password again.
password:
-------------------------------------------------
Default Account Address: TAT1dA8F9HXGqmhvMCjxCKAD29YxDRw81y
Default Path: m/44'/195'/0'/0/0
-------------------------------------------------
1. Import Default Account
2. Change Path
3. Custom Path
Please select an option, other inputs will exit this operation: 1
Import a wallet by Ledger  successful, keystore file : ./Wallet/Ledger-TAT1dA8F9HXGqmhvMCjxCKAD29YxDRw81y.json
You are now logged in, and you can perform operations using this account.

BackupWallet¶

备份钱包。输入钱包密码后，wallet-cli 会以十六进制字符串格式导出私钥，例如： 1234567890123456789012345678901234567890123456789012345678901234

BackupWallet2Base64¶

备份钱包。输入钱包密码后，wallet-cli 会以 Base64 格式导出私钥，例如： ch1jsHTxjUHBR+BMlS7JNGd3ejC28WdFvEeo6uUHZUU=

ChangePassword¶

修改钱包密码。

GenerateSubAccount¶

使用钱包中的助记词生成子账户。

wallet> GenerateSubAccount
Please input your password.
password:

=== GenerateSubAccount Generator ===
-------------------------------
Default Address: TYEhEg7b7tXm92UDbRDXPtJNU6T9xVGbbo
Default Path: m/44'/195'/0'/0/1
-------------------------------

1. Generate Default Path
2. Change Account
3. Custom Path

Enter your choice (1-3): 1
mnemonic file : ./Mnemonic/TYEhEg7b7tXm92UDbRDXPtJNU6T9xVGbbo.json
GenerateSubAccount successful, keystore file name is TYEhEg7b7tXm92UDbRDXPtJNU6T9xVGbbo.json
generateSubAccount  successful.

ClearWalletKeystore¶

清除登录账户的钱包 keystore。

wallet> ClearWalletKeystore

Warning: Dangerous operation!
This operation will permanently delete the Wallet&Mnemonic files of the Address: TABWx7yFhWrvZHbwKcCmFLyPLWjd2dZ2Rq
Warning: The private key and mnemonic words will be permanently lost and cannot be recovered!
Continue? (y/Y to proceed, c/C to cancel):
y

Final confirmation:
Please enter: 'DELETE' to confirm the delete operation:
Confirm: (DELETE): DELETE

Delete File  successful:
- /wallet-cli/Wallet/TABWx8yFhWrvZHbwKcCmFLyPLWjd2dZ2Rq.json
- /wallet-cli/Mnemonic/TABWx8yFhWrvZHbwKcCmFLyPLWjd2dZ2Rq.json
ClearWalletKeystore  successful !!!

ResetWallet¶

删除所有本地钱包 keystore 文件和助记词文件，并按提示重新注册或导入钱包。

wallet> resetwallet

Warning: Dangerous operation!
This operation will permanently delete the Wallet&Mnemonic files
Warning: The private key and mnemonic words will be permanently lost and cannot be recovered!
Continue? (y/Y to proceed, c/C to cancel):
y

Final confirmation:
Please enter: 'DELETE' to confirm the delete operation:
Confirm: (DELETE): DELETE
resetWallet  successful !!!
Now, you can RegisterWallet or ImportWallet again. Or import the wallet through other means.

LoginAll¶

用统一的密码登录多个 keystore 账户。

wallet> loginall
Please input your password.
password:
[========================================] 100%

No.  Address                                    Name
1    TJEEKTmaVTYSpJAxahtyuofnDSpe2seajB         main
2    TX1L9xonuUo1AHsjUZ3QzH8wCRmKm56Xew         cold
3    TVuVqnJFuuDxN36bhEbgDQS7rNGA5dSJB7         test
4    TRvVXgqddDGYRMx3FWf2tpVxXQQXDZxJQe         Ledger-TRvVXgqddDGYRMx3FWf2tpVxXQQXDZxJQe.json
5    TYXFDtn86VPFKg4mkwMs45DKDcpAyqsada         backup
Please choose No. between 1 and 5, or enter search to search wallets
5
LoginAll  successful !!!

Logout¶

登出当前钱包账户。

wallet> Logout
Logout  successful !!!

Lock¶

锁定登录账户，使其不允许签名和交易。需要在 config.conf 中设置 lockAccount = true。

wallet> lock
lock  successful !!!

Unlock¶

解锁已锁定的登录账户。默认在 300 秒后重新锁定；你可以传入以秒为单位的解锁时长。需要在 config.conf 中设置 lockAccount = true。

wallet> unlock 60
Please input your password.
password:
unlock  successful !!!

SwitchWallet¶

使用 LoginAll 登录之后，在多个钱包之间切换。

wallet> switchwallet

No.  Address                                    Name
1    TJEEKTmaVTYSpJAxahtyuofnDSpe2seajB         main
2    TX1L9xonuUo1AHsjUZ3QzH8wCRmKm56Xew         cold
3    TVuVqnJFuuDxN36bhEbgDQS7rNGA5dSJB7         test
4    TRvVXgqddDGYRMx3FWf2tpVxXQQXDZxJQe         Ledger-TRvVXgqddDGYRMx3FWf2tpVxXQQXDZxJQe.json
5    TYXFDtn86VPFKg4mkwMs45DKDcpAyqsada         backup
Please choose No. between 1 and 5, or enter search to search wallets
5
SwitchWallet  successful !!!

ModifyWalletName¶

修改钱包的名称。

wallet> ModifyWalletName new-name
Modify Wallet Name  successful !!

另请参见¶

account——账户查询与元数据
network——在网络之间切换
multisig · concepts/multisig