dfx wallet
dfx wallet コマンドとサブコマンド、フラグを使用すると、自分の Identity の Cycle ウォレット（以下、 Cycle Wallet ）を管理したり、他のアカウントの Cycle ウォレット Canister（以下、 Cycle Wallet Canister）のウォレットに Cycle を送ることができます：
dfx wallet コマンドを実行するための基本的なシンタックスは以下の通りです。
dfx wallet [option] <subcommand> [flag]指定する dfx wallet サブコマンドによっては、追加の引数、オプション、フラグが適用され要求されます。
特定の dfx wallet サブコマンドの使用情報を見るには、そのサブコマンドと --help フラグを指定してください。
例えば、dfx wallet send の使用情報を見るには、以下のコマンドを実行します：
dfx wallet send --helpdfx wallet コマンドの使用方法を説明した参考情報とサンプルは、適切なコマンドを選択してください。
| コマンド | 説明 |
|---|---|
選択した Identity の Principal を使用するコントローラーを追加します。 |
|
Cycle Wallet のアドレス帳を表示します。 |
|
選択された Identity の Cycle Wallet のカストディアンを Principal で承認します。 |
|
選択した Identity の Cycle Wallet 残高が表示されます。 |
|
選択した Identity の Cycle Wallet コントローラーの一覧を表示します。 |
|
選択した Identity の Cycle Wallet カストディアンの一覧を表示します。 |
|
カストディアンの Principal を使用して、Cycle Wallet のカストディアンを承認解除します。 |
|
|
使用法のメッセージと指定されたサブコマンドのヘルプを表示します。 |
|
|
選択した Identity の Cycle Wallet から指定したコントローラーを削除します。 |
|
選択した Identity の Cycle Wallet から、送信先ウォレットの Canister ID を使用して指定された Cycle 数量を別の Cycle Wallet に送信します。 |
|
Cycle Wallet の名前を指定します。 |
|
Cycle Wallet の Wasm モジュールを、DFX にバンドルされている最新のWasm にアップグレードします。 |
ウォレットの利用
dfx identity deploy-wallet コマンドを使用して、Identity に結びついた Cycle Wallet Canister を作成した後、 dfx wallet コマンドを使用して、Cycle Wallet の設定を変更したり、他の Cycle Wallet に Cycle を送信したり、コントローラーやカストディアンを追加・削除したりすることができます。
dfx wallet add-controller
ウォレットにコントローラーを追加するには、dfx wallet add-controller を使用します。コントローラーの役割を割り当てられた Identity は最も多くの権限を持ち、選択した Identity の Cycle Wallet に対して以下のアクションを実行することができます：
-
Cycle Wallet の名前の変更
-
アドレス帳に項目を追加
-
コントローラーの追加と削除
-
カストディアンの権限付与および権限解除
コントローラーはカストディアンでもあって、その役割に関連する以下のアクションを実行することができます：
-
Wallet 情報へのアクセス
-
Cycle の送金
-
コールの転送
-
Canister の作成
フラグ
以下のオプションフラグを dfx wallet add-controller コマンドで使用することができます。
| フラグ | 説明 |
|---|---|
|
利用情報を表示します。 |
|
バージョン情報を表示します。 |
オプション
以下のオプションは dfx canister call コマンドと一緒に使用することができます。
| オプション | 説明 |
|---|---|
|
追加したいコントローラーの環境（例： Internet Computer プラットフォーム やテストネット）を指定します。 |
dfx wallet addresses
dfx wallet addresses コマンドを使用して、ウォレットのアドレス帳を表示します。アドレスのエントリには、Principal と role（ Contact, Custodian, または Controller ）が含まれ、アドレスと関連付けられた name と kind（ Unknown, User, または Canister ）も含まれる場合があります。
フラグ
以下のオプションフラグは dfx wallet add-controller コマンドで使用することができます。
| フラグ | 説明 |
|---|---|
|
利用情報を表示します。 |
|
バージョン情報を表示します。 |
例
ウォレットのアドレス帳に登録されている情報を取得するには、dfx wallet addresses コマンドを使用します。例：
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 wallet authorize
ウォレットのカストディアンを承認するには、dfx wallet authorize コマンドを使用します。カストディアンの役割を割り当てられた Identity は、Cycle Wallet 上で次のアクションを実行できます：
-
Wallet 情報へのアクセス
-
Cycle の送金
-
コールの転送
-
Canister の作成
フラグ
dfx wallet authorize コマンドでは、以下のオプションフラグを使用することができます。
| フラグ | 説明 |
|---|---|
|
利用情報を表示します。 |
|
バージョン情報を表示します。 |
dfx wallet balance
dfx wallet controllers
dfx wallet custodians
dfx wallet deauthorize
dfx wallet name
dfx wallet remove-controller
dfx wallet remove-controller コマンドを使用すると、選択した Identity の Cycle Wallet のコントローラーを削除することができます。
フラグ
以下のオプションフラグは、 dfx wallet remove-controller コマンドで使用することができます。
| フラグ | 説明 |
|---|---|
|
利用情報を表示します。 |
|
バージョン情報を表示します。 |
dfx wallet send
dfx wallet send コマンドを使用すると、送信先 Cycle Wallet の Canister ID を利用して、選択した Identity の Cycle Wallet から別の Cycle Wallet に Cycle を送信することができます。
フラグ
dfx wallet send コマンドでは、以下のオプションフラグを使用することができます。
| フラグ | 説明 |
|---|---|
|
利用情報を表示します。 |
|
バージョン情報を表示します。 |
オプション
以下のオプションは、 dfx wallet send コマンドで使用することができます。
| オプション | 説明 |
|---|---|
|
接続先の環境をオーバーライドします。デフォルトでは、ローカルの Canister 実行環境が使用されます。ここには有効な URL（ |