Add document for how to convert icp tokens to cycles.

docusaurus/docs/getting-started/3-get-cycles/index.md

@@ -13,7 +13,15 @@ import TeamContact from '../../contact.md';
 
 ## 概述 {#overview}
 
-为了使互联网计算机可持续发展，开发人员需要支付其容器所消耗的资源费用（例如存储、算力等），而 cycles 则用于支付这些资源费用。接下来介绍几种获得 cycles 的方式。
+### 什么是 cycles {#what-is-cycles}
+
+为了使互联网计算机可持续发展，开发人员需要支付其容器所消耗的资源费用（例如存储、算力等），而 cycles 则用于支付这些资源费用。每一万亿个 cycles 等于1个 [XDR](https://en.wikipedia.org/wiki/Special_drawing_rights)，这意味着容器的运行成本与 ICP 代币的价格波动无关。关于更多 cycles 的信息，请参考[这里](https://internetcomputer.org/docs/current/concepts/tokens-cycles#cycles)。
+
+### 什么是 cycles 钱包 {#what-is-cycles-wallet}
+
+容器需要 cycles 来执行操作、并为所使用的资源付费，用户和开发人员通过一种称为 cycles 钱包的特殊容器来管理 cycles 的分配和所有权。关于 cycles 钱包的更多信息，请参考[这里](https://ic123.xyz/docs/getting-started/use-dfx/#cycles-wallet)。
+
+目前 cycles 钱包是一种复杂的解决方案，它本质上是一个容器、自身也会消耗 cycles。目前 DFINITY 基金会正在开发的一个新功能就是 [cycles 账本](https://internetcomputer.org/blog/2023/09/06/news-and-updates/update#upcoming-feature-cycles-ledger)，用来简化 cycles 的管理。
 
 ## 要求 {#prerequisites}
 
@@ -40,7 +48,9 @@ import TeamContact from '../../contact.md';
 点击该页面 `REQUEST CYCLES` 按钮加入 [DFINITY 官方 Dev Discord 服务器](https://discord.com/invite/jnjVVQaE2C)。
 
 :::info
+
 Discord 服务器地址：https://discord.com/invite/jnjVVQaE2C
+
 :::
 
 #### 提交 cycles 优惠券请求 {#request-cycles-coupon}
@@ -98,27 +108,182 @@ dfx identity use myNewIdentity
 请运行以下命令来领取免费 cycles：
 
 ```bash
-dfx wallet --network ic redeem-faucet-coupon <your-coupon-code>
+dfx wallet redeem-faucet-coupon <your-coupon-code> --network ic
 ```
 
+:::info
+
 该命令会帮你创建一个钱包，并将 cycles 转入其中，关于钱包的更多命令请参考[这里](https://ic123.xyz/docs/getting-started/use-dfx/#cycles-wallet)。
 
+:::
+
 ![cycle_faucet_claim](./img/cycle_faucet_claim.png)
 
 ### 验证 cycles {#verify-cycles}
 
 最后一步是通过一下命令检查钱包余额，以验证钱包是否设置正确。
 
 ```bash
-dfx wallet --network ic balance
+dfx wallet balance --network ic
 ```
 
 ![cycle_faucet_verify](./img/cycle_faucet_verify.png)
 
 
-## 从 ICP 获取 cycles
+## 将 ICP 转换为 cycles {#convert-icp-to-cycles}
+
+将 ICP 代币转换为 cycles，您首先需要获取一些 ICP 并将其转移到您的账户。您可以在交易所上获取 ICP 代币，或者向您认识的人请求一些。
+
+### 如何获取账户 {#get-account-id}
+
+当您创建[身份](https://ic123.xyz/docs/getting-started/ic-glossary/#identity)之后，您就会自动获得一个账本[账户](https://ic123.xyz/docs/getting-started/ic-glossary/#account)。
+
+您可以在命令行运行以下命令获取您的账户 ID：
+
+```
+dfx ledger account-id
+```
+
+您将会在命令行看到类似的输出：
+
+```
+e213184a548871a47fb526f3cba24e2ee2fbbc8129c4ab497ef2ce535130a0a4
+```
+
+:::info
+
+关于如何创建身份，您可以参考[这里](https://ic123.xyz/docs/getting-started/use-dfx/#create-identity)。关于身份的更多命令，请参考[这里](https://ic123.xyz/docs/getting-started/use-dfx/#identity)。
+
+:::
+
+### 如何获取 ICP 代币 {#get-icp-tokens}
+
+获取 ICP 代币有几种不同的方式，包括但不限于：
+
+- 通过支持 ICP 代币的交易所直接购买。请查看[该页面](https://coinmarketcap.com/currencies/internet-computer/markets/)以了解可以购买 ICP 代币的交易所。
+
+- 通过参与 [IC 治理](https://ic123.xyz/docs/ic-web3/stake-icp/)的奖励获得代币。
+
+- 通过参与 DFINITY 基金会的[开发者计划](https://ic123.xyz/docs/dev-resources/dev-grants/)获得 ICP 代币。
+
+- 作为[节点提供者](https://ic123.xyz/docs/ecosystem-guide/node-provider-faq/)获得 ICP 代币，以作为提供算力的报酬。
+
+通常来说，价值 5 到 10 美元的 ICP 代币足以开始您的开发工作。后续您可以根据您的工作流程和实际用例来决定是否获取更多的 ICP 代币。
+
+#### 查询 ICP 代币余额 {#get-icp-balance}
+
+当您获得了ICP 并转入[您的账户](#get-account-id)之后，你可以通过以下命令查询余额：
+
+```bash
+dfx ledger balance --network ic
+```
+
+您将会看到类似如下的输出：
+
+```
+12.49840000 ICP
+```
+
+### 如何创建 cycles 钱包 {#create-cycles-wallet}
+
+前面我们在介绍如何通过[领取优惠券](#claim-cycles)的方式获得 cycles 的时候，提到了 `dfx wallet redeem-faucet-coupon` 会自动帮您创建 cycles 钱包。
+
+接下来我们介绍如何自己手动创建钱包，如果您已经拥有 cycles 钱包（您可以通过 [dfx identity get-wallet](https://ic123.xyz/docs/getting-started/use-dfx/#get-wallet) 来查看您的钱包配置），则可以跳过此步骤。
+
+:::info
+
+您可以查看[该文档](https://ic123.xyz/docs/getting-started/use-dfx/#cycles-wallet)了解更多关于 cycles 钱包的信息。
+
+:::
+
+#### 创建一个新的容器 {#create-canister}
+
+Cycles 钱包本质上是一个特殊的容器，所以第一步我们需要创建一个新的容器，您可以参考 [dfx ledger create-canister](https://ic123.xyz/docs/getting-started/use-dfx/#ledger-create-canister) 来创建容器。下面是一个示例：
+
+```bash
+dfx ledger create-canister tsqwz-udeik-5migd-ehrev-pvoqv-szx2g-akh5s-fkyqc-zy6q7-snav6-uqe --amount 1.25 --network ic
+```
+
+该命令将在 IC 主网上创建一个容器，将指定的主体设置为容器的控制者，并向充值价值为 `1.25 ICP` 的 cycles。
+
+如果创建成功会返回类似如下所示信息：
+
+```
+Transfer sent at BlockHeight: 20
+Canister created with id: "53zcu-tiaaa-aaaaa-qaaba-cai"
+```
+
+#### 安装 cycles 钱包代码 {#install-cycles-wallet}
+
+创建容器完成后，我们将运行如下命令将 cycles 钱包代码安装到所创建的容器之中：
+
+```bash
+dfx identity --network ic deploy-wallet <canister-identifier>
+```
+
+关于 `dfx identity deploy-wallet` 的详细信息可以参考[这里](https://ic123.xyz/docs/getting-started/use-dfx/#deploy-wallet)。
+
+下面是一个示例：
+
+```bash
+dfx identity deploy-wallet 53zcu-tiaaa-aaaaa-qaaba-cai --network ic
+```
+
+它会在 IC 主网上在指定容器 (53zcu-tiaaa-aaaaa-qaaba-cai) 安装 cycles 钱包 Wasm 代码。
+
+### 如何从 ICP 充值 cycles 钱包  {#topup-cycles-wallet}
+
+如果您已经拥有了 cycles 钱包，希望直接将 ICP 代币转换为 cycles，可以使用 `dfx ledger top-up` 命令。下面是一个示例：
+
+```bash
+dfx ledger top-up --icp 1 5a46r-jqaaa-aaaaa-qaadq-cai --network ic
+```
+
+其中 `5a46r-jqaaa-aaaaa-qaadq-cai` 是示例的 cycles 钱包容器 ID，您可以替换为您自己的钱包容器 ID。
+
+更多关于 `dfx ledger top-up` 的信息，请参考[这里](https://ic123.xyz/docs/getting-started/use-dfx/#top-up-cycles)。
+
+### 如何给容器充值 cycles {#topup-canister}
+
+除了给 cycles 钱包充值，您也可以给普通容器进行充值。
+
+#### 查看容器 cycles 余额 {#get-canister-status}
+
+在决定是否给容器充值之前，您可以通过 dfx canister status 命令来查看容器的状态，包括容器的 cycles 余额，以下是一个示例：
+
+```bash
+dfx canister status b5wdk-xiaaa-aaaan-qlsqq-cai --network=ic
+```
+
+#### 如何从 ICP 充值容器 {#topup-canister-icp}
+
+同样可以使用 `dfx ledger top-up` 命令。下面是一个示例：
+
+```bash
+dfx ledger top-up --icp 1 b5wdk-xiaaa-aaaan-qlsqq-cai --network ic
+```
+
+其中 `b5wdk-xiaaa-aaaan-qlsqq-cai` 是示例的 容器 ID，您可以替换为您自己的容器 ID。
+
+#### 如何从 cycles 钱包充值容器 {#deposit-cycles}
+
+- 使用 `dfx canister deposit-cycles` 从 cycles 钱包充值容器，以下是一个示例：
+
+  ```bash
+  dfx canister deposit-cycles 2000000000000 b5wdk-xiaaa-aaaan-qlsqq-cai --network ic
+  ```
+
+  其中 `b5wdk-xiaaa-aaaan-qlsqq-cai` 是示例的 容器 ID，您可以替换为您自己的容器 ID。
+
+- 使用 `dfx wallet send` 从 cycles 钱包充值容器，以下是一个示例：
+
+  ```bash
+  dfx wallet send 2000000000000 b5wdk-xiaaa-aaaan-qlsqq-cai --network ic
+  ```
+
+  其中 `b5wdk-xiaaa-aaaan-qlsqq-cai` 是示例的 容器 ID，您可以替换为您自己的容器 ID。
 
-## 总结
+## 总结 {#conclusion}
 
 至此您已经准备好在 IC 上托管网站或按照我们的 [dApps 教程](https://ic123.xyz/docs/getting-started/code-examples/)进行操作，您可以在[这里](https://internetcomputer.org/docs/current/tutorials/)找到相关教程。