dfx 钱包

使用带有子命令和标志的 dfx wallet 命令来管理您身份的燃料费钱包，并将燃料费发送到其他帐户燃料费钱包容器的钱包。

运行 dfx wallet 命令的基本语法是:

dfx wallet [option] <subcommand> [flag]

根据您指定的 dfx wallet 子命令，可能会应用或需要其他参数、选项和标志。 要查看特定 dfx wallet 子命令的帮助信息，请指定子命令和 --help 标志。 例如，要查看 dfx wallet send 的帮助信息，可以运行以下命令:

dfx wallet send --help

有关说明使用 dfx wallet 命令的参考信息和示例，请选择适当的命令。

命令 描述

add-controller

使用所选身份的principal添加控制器。

addresses

显示燃料费钱包的地址簿。

authorize

委托人为所选身份的燃料费钱包授权托管人

balance

显示所选身份的燃料费钱包余额。

controllers

显示选定身份的燃料费钱包控制器列表。

custodians

显示选定身份的燃料费钱包保管人列表。

deauthorize

使用托管人的委托人取消对燃料费钱包托管人的授权。

help

显示使用消息和给定子命令的帮助。

name

如果您使用了 dfx wallet set-name 命令，则返回燃料费钱包的名称。

remove-controller

从选定身份的燃料费钱包中删除指定的控制器。

send

使用目标钱包容器 ID 将指定数量的燃料费从选定身份的燃料费钱包发送到另一个燃料费钱包。

set-name

为您的燃料费钱包指定一个名称。

upgrade

将燃料费钱包的 Wasm 模块升级到与 DFX 捆绑的当前 Wasm。

使用你的钱包

在您使用 dfx identity deploy-wallet 命令创建与身份绑定的燃料费钱包容器后，您可以使用 dfx wallet 命令修改您的燃料费钱包设置，将燃料费发送到其他燃料费钱包，并添加 或删除控制器和保管人。

dfx 钱包添加控制器

使用 dfx wallet add-controller 将控制器添加到钱包。 分配了控制器角色的身份拥有最多的权限，并且可以在所选身份的燃料费钱包上执行以下操作:

  • 重命名燃料费钱包。

  • 添加条目到通讯录。

  • 添加和删除控制器。

*授权和取消授权保管人。

控制器也是保管人，可以执行与该角色相关的以下操作:

*访问钱包信息。

  • 发送燃料费。

*转接电话。

*创建容器。

基本用法

dfx wallet add-controller [option]  [flag]

标志

您可以在 dfx wallet add-controller 命令中使用以下可选标志。

标志 说明

-h, --help

显示帮助信息。

-V, --version

显示版本信息。

选项

您可以在 dfx canister call 命令中使用以下选项。

选项 说明

--network <network>

指定要添加的控制器的环境（例如，Internet Computer platform 或 testnet）。

参数

您可以为 dfx wallet add-controller 命令指定以下参数。

参数 描述

controller

指定要添加到钱包的控制器principal。

例子

您可以使用 dfx wallet add-controller 命令将控制器添加到您的钱包。 如果您要添加的控制器位于不同的环境中，请使用 --network 选项指定它。 例如:

dfx wallet --network=https://192.168.74.4 add-controller hpff-grjfd-tg7cj-hfeuj-olrjd-vbego-lpcax-ou5ld-oh7kr-kl9kt-yae

dfx 钱包地址

使用`dfx walletaddress命令显示钱包的地址簿。地址条目包含principal和role（Contact、+Custodian+或+Controller+），并且可能包含 name` 和 kind（Unknown、User 或 Canister）与地址关联。

基本用法

dfx wallet addresses

标志

您可以在 dfx wallet add-controller 命令中使用以下可选标志。

标志 说明

-h, --help

显示帮助信息。

-V, --version

显示版本信息。

例子

您可以使用`dfx 钱包地址` 命令检索钱包地址簿中的地址信息。 例如:

dfx wallet addresses
Id: hpff-grjfd-tg7cj-hfeuj-olrjd-vbego-lpcax-ou5ld-oh7kr-kl9kt-yae, Kind: Unknown, Role: Controller, Name: ic_admin.
Id: e7ptl-4x43t-zxcvh-n6s6c-k2dre-doy7l-bbo6h-ok8ik-msiz3-eoxhl-6qe, Kind: Unknown, Role: Custodian, Name: alice_auth.

dfx 钱包授权

使用 dfx wallet authorize 命令为钱包授权托管人。 分配了保管人角色的身份可以在燃料费钱包上执行以下操作:

  • 访问钱包信息。

  • 发送燃料费。

  • 转接电话。

  • 创建容器。

基本用法

dfx wallet authorize <custodian> [flag]

标志

您可以在 dfx wallet authorize 命令中使用以下可选标志。

标志 说明

-h, --help

显示帮助信息。

-V, --version

显示版本信息。

参数

在 dfx wallet authorize 命令中使用以下必要参数。

参数 描述

<保管人>

指定您要作为保管人添加到所选身份的燃料费钱包的身份的委托人。

示例

例如，要将 alice_auth 添加为保管人，请在以下命令中指定她的委托人:

dfx wallet authorize dheus-mqf6t-xafkj-d3tuo-gh4ng-7t2kn-7ikxy-vvwad-dfpgu-em25m-2ae

dfx 钱包余额

使用`dfx wallet balance`命令显示所选身份的燃料费钱包的余额。

基本用法

dfx wallet balance

标志

您可以在 dfx wallet balance 命令中使用以下可选标志。

Flag Description

-h, --help

Displays usage information.

-V, --version

Displays version information.

例子

检查所选身份的燃料费钱包的余额。

dfx wallet balance

此命令显示您的燃料费钱包中的燃料费数。 例如:

89000000000000 cycles.

dfx 钱包控制器

使用 dfx wallet controllers 命令列出作为所选身份的燃料费钱包控制器的身份的principal。

基本用法

dfx wallet controllers

标志

您可以在 dfx wallet controllers 命令中使用以下可选标志。

标志 说明

-h, --help

显示帮助信息。

-V, --version

显示版本信息。

例子

列出您选择的身份的燃料费钱包的控制器。

dfx wallet controllers

如果有两个控制器，返回的信息应该类似于以下内容:

dheus-mqf6t-xafkj-d3tuo-gh4ng-7t2kn-7ikxy-vvwad-dfpgu-em25m-2ae
hpnmi-qgxsv-tgecj-hmjyn-gmfft-vbego-lpcax-ou4ld-oh7kr-l3nu2-yae

dfx 钱包保管人

使用 dfx wallet custodians 命令列出作为所选身份的燃料费钱包保管人的身份的委托人。 添加为控制者的身份也被列为保管人。

基本用法

dfx wallet custodians

标志

您可以在 dfx wallet custodians 命令中使用以下可选标志。

标志 说明

-h, --help

显示帮助信息。

-V, --version

显示版本信息。

例子

列出您选择的身份的燃料费钱包的保管人。

dfx wallet custodians

如果有两个保管人，则返回的信息应类似于以下内容:

dheus-mqf6t-xafkj-d3tuo-gh4ng-7t2kn-7ikxy-vvwad-dfpgu-em25m-2ae
hpnmi-qgxsv-tgecj-hmjyn-gmfft-vbego-lpcax-ou4ld-oh7kr-l3nu2-yae

dfx 钱包取消授权

使用 dfx wallet deauthorize 命令从燃料费钱包中删除保管人。

注意:如果保管人也是控制器，这也将删除控制器的角色。

基本用法

dfx wallet deauthorize <custodian> [flag]

标志

您可以在 dfx wallet deauthorize 命令中使用以下可选标志。

标志 说明

-h, --help

显示帮助信息。

-V, --version

显示版本信息。

参数

在 dfx wallet deauthorize 命令中使用以下必要参数。

参数 描述

<保管人>

指定要删除的保管人的委托人。

示例

例如，要删除“alice_auth”作为保管人，请在以下命令中指定她的委托人:

dfx wallet deauthorize dheus-mqf6t-xafkj-d3tuo-gh4ng-7t2kn-7ikxy-vvwad-dfpgu-em25m-2ae

dfx 钱包名称

如果已使用 dfx wallet set-name 命令设置，则使用 dfx wallet name 命令显示所选身份的燃料费钱包的名称。

基本用法

dfx wallet name [flag]

标志

您可以在 dfx wallet name 命令中使用以下可选标志。

标志 说明

-h, --help

显示帮助信息。

-V, --version

显示版本信息。

示例

如果您已将您的燃料费钱包命名为“Terrances_wallet”，则该命令将返回以下内容:

Terrances_wallet

dfx 钱包删除控制器

使用 dfx wallet remove-controller 命令删除所选身份的周期钱包的控制器。

基本用法

dfx wallet remove-controller <controller> [flag]

标志

您可以在 dfx wallet remove-controller 命令中使用以下可选标志。

标志 说明

-h, --help

显示帮助信息。

-V, --version

显示版本信息。

参数

在 dfx wallet remove-controller 命令中使用以下必要参数。

参数 描述

<controller>

指定要删除的控制器的principal。

示例

例如，要删除 alice_auth 作为控制器，请在以下命令中指定她的principal:

dfx wallet remove-controller dheus-mqf6t-xafkj-d3tuo-gh4ng-7t2kn-7ikxy-vvwad-dfpgu-em25m-2ae

dfx 钱包发送

使用 dfx wallet send 命令将燃料费从所选身份的燃料费钱包发送到使用目标燃料费钱包的容器 ID 的另一个燃料费钱包。

基本用法

dfx wallet [network] send [flag] <destination> <amount>

标志

您可以在 dfx wallet send 命令中使用以下可选标志。

标志 说明

-h, --help

显示帮助信息。

-V, --version

显示版本信息。

选项

您可以在 dfx wallet send 命令中使用以下选项。

选项 说明

--network

覆盖要连接的环境。 默认情况下，使用本地容器执行环境。 可以在此处指定有效的 URL（以 http: 或 https: 开头）。 例如。 “http://localhost:12345/”是一个有效的网络名称。

参数

您必须为 dfx wallet send 命令指定以下参数。

参数 描述

<destination>

使用容器 ID 指定目标循环钱包。

<amount>

指定要发送的周期数。

例子

将周期从所选身份的燃料费钱包发送到另一个燃料费钱包。

例如，要将 2,000,000,000 个周期从所选身份的燃料费钱包`<ic_admin>发送到目标身份的燃料费钱包<buffy_standard>，钱包地址为r7inp-6aaaa- aaaaa-aaabq-cai`，运行以下命令:

dfx wallet send r7inp-6aaaa-aaaaa-aaabq-cai 2000000000

dfx 钱包设置名称

使用 dfx wallet set-name 命令为所选身份的燃料费钱包分配名称。

基本用法

    dfx wallet set-name [flag] <name>

参数

您必须为 dfx wallet set-name 命令指定以下参数。

参数 描述

<name>

Specify a name for the cycles wallet.

标志

您可以在 dfx wallet set-name 命令中使用以下可选标志。

标志 说明

-h, --help

显示帮助信息。

-V, --version

显示版本信息。

示例

如果要将当前身份的燃料费钱包的名称设置为“Terrances_wallet”，可以运行以下命令:

dfx wallet set-name Terrances_wallet

dfx 钱包升级

使用 dfx wallet upgrade 命令将燃料费钱包的 Wasm 模块升级为当前与 DFX 捆绑的 Wasm。

基本用法

    dfx wallet upgrade [flag]

标志

您可以在 dfx wallet upgrade 命令中使用以下可选标志。

标志 说明

-h, --help

显示帮助信息。

-V, --version

显示版本信息。

示例

要将 Wasm 模块升级到最新版本，请运行以下命令:

dfx wallet upgrade