@ocap/client 1.25.4 → 1.25.5

package/docs/how-to-guides-manage-assets.zh.md

@@ -1,13 +1,13 @@
 # 管理资产 (NFT)
 
-本指南将全面介绍如何使用 OCAP Client 管理非同质化代币（NFT），也称资产的整个生命周期。你将学习如何从头开始创建新资产、更新其属性、建立用于标准化铸造的资产工厂，以及从该工厂获取新资产。
+本指南全面介绍了如何使用 OCAP Client 管理非同质化代币（NFT）（也称为资产）的整个生命周期。你将学习如何从头开始创建新资产、更新其属性、建立用于标准化铸造的资产工厂，以及从该工厂获取新资产。
 
 ## 创建新资产
 
-你可以使用 `createAsset` 方法在区块链上创建一个独特的、独立的资产。每个资产都会被分配一个唯一的链上地址，该地址由其初始属性派生。
+你可以使用 `createAsset` 方法在区块链上创建一个独特的、独立的资产。每个资产都会根据其初始属性派生出一个唯一的链上地址。
 
 ```javascript icon=logos:javascript
-const { wallet } = getWallet(); // 用户的钱包对象
+const { wallet } = getWallet(); // 用户钱包对象
 
 async function createNewAsset() {
   try {
@@ -25,11 +25,11 @@ async function createNewAsset() {
       wallet: wallet,
     });
 
-    console.log(`资产创建交易已发送：${hash}`);
-    console.log(`新资产地址：${address}`);
+    console.log(`资产创建交易已发送: ${hash}`);
+    console.log(`新资产地址: ${address}`);
     return address;
   } catch (error) {
-    console.error('创建资产时出错：', error);
+    console.error('创建资产时出错:', error);
   }
 }
 
@@ -39,24 +39,24 @@ createNewAsset();
 ### 参数
 
 <x-field-group>
-  <x-field data-name="moniker" data-type="string" data-required="true" data-desc="资产的名称。"></x-field>
-  <x-field data-name="parent" data-type="string" data-default="''" data-required="false" data-desc="父资产的地址（如有）。"></x-field>
-  <x-field data-name="data" data-type="object" data-required="true" data-desc="资产的数据负载，必须包含 typeUrl 和 value。"></x-field>
-  <x-field data-name="readonly" data-type="boolean" data-default="false" data-required="false" data-desc="若为 true，则资产在创建后无法更新。"></x-field>
-  <x-field data-name="transferrable" data-type="boolean" data-default="true" data-required="false" data-desc="若为 true，则资产可以转移到另一个账户。"></x-field>
-  <x-field data-name="ttl" data-type="number" data-default="0" data-required="false" data-desc="资产首次消费后的存活时间（秒）。"></x-field>
-  <x-field data-name="display" data-type="object" data-required="false" data-desc="包含资产显示信息的对象。"></x-field>
-  <x-field data-name="endpoint" data-type="object" data-required="false" data-desc="包含资产端点详细信息的对象。"></x-field>
-  <x-field data-name="tags" data-type="string[]" data-default="[]" data-required="false" data-desc="用于对资产进行分类的字符串数组。"></x-field>
-  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="资产初始所有者的钱包对象。"></x-field>
-  <x-field data-name="delegator" data-type="string" data-default="''" data-required="false" data-desc="通过委托授权此交易的账户地址。"></x-field>
+  <x-field data-name="moniker" data-type="string" data-required="true" data-desc="资产的名称。" ></x-field>
+  <x-field data-name="parent" data-type="string" data-default="''" data-required="false" data-desc="父资产的地址（如有）。" ></x-field>
+  <x-field data-name="data" data-type="object" data-required="true" data-desc="资产的数据负载，必须包含 typeUrl 和 value。" ></x-field>
+  <x-field data-name="readonly" data-type="boolean" data-default="false" data-required="false" data-desc="如果为 true，资产在创建后无法更新。" ></x-field>
+  <x-field data-name="transferrable" data-type="boolean" data-default="true" data-required="false" data-desc="如果为 true，资产可以转移到另一个账户。" ></x-field>
+  <x-field data-name="ttl" data-type="number" data-default="0" data-required="false" data-desc="资产首次消费后的存活时间（秒）。" ></x-field>
+  <x-field data-name="display" data-type="object" data-required="false" data-desc="包含资产显示信息的对象。" ></x-field>
+  <x-field data-name="endpoint" data-type="object" data-required="false" data-desc="包含资产端点详细信息的对象。" ></x-field>
+  <x-field data-name="tags" data-type="string[]" data-default="[]" data-required="false" data-desc="用于对资产进行分类的字符串数组。" ></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="资产初始所有者的钱包对象。" ></x-field>
+  <x-field data-name="delegator" data-type="string" data-default="''" data-required="false" data-desc="通过委托授权此交易的账户地址。" ></x-field>
 </x-field-group>
 
 ### 返回值
 
 一个 `Promise`，它会解析为一个包含交易哈希和新资产链上地址的数组。
 
-<x-field data-name="response" data-type="Promise<[string, string]>" data-desc="[交易哈希, 资产地址]"></x-field>
+<x-field data-name="response" data-type="Promise<[string, string]>" data-desc="[transactionHash, assetAddress]"></x-field>
 
 ---
 
@@ -65,7 +65,7 @@ createNewAsset();
 如果资产创建时设置了 `readonly: false`，你可以使用 `updateAsset` 方法修改其 `moniker` 和 `data` 字段。资产通过其唯一地址进行识别。
 
 ```javascript icon=logos:javascript
-const { wallet } = getWallet(); // 用户的钱包对象
+const { wallet } = getWallet(); // 用户钱包对象
 const assetAddress = 'z362...'; // 要更新的资产地址
 
 async function updateExistingAsset() {
@@ -76,16 +76,16 @@ async function updateExistingAsset() {
       data: {
         typeUrl: 'json',
         value: { 
-          description: '我这件独特作品的更新描述。',
+          description: '我的独特作品的更新描述。',
           imageUrl: 'https://example.com/path/to/new_image.png',
         },
       },
       wallet: wallet,
     });
 
-    console.log(`资产更新交易已发送：${hash}`);
+    console.log(`资产更新交易已发送: ${hash}`);
   } catch (error) {
-    console.error('更新资产时出错：', error);
+    console.error('更新资产时出错:', error);
   }
 }
 
@@ -95,30 +95,30 @@ updateExistingAsset();
 ### 参数
 
 <x-field-group>
-  <x-field data-name="address" data-type="string" data-required="true" data-desc="要更新资产的链上地址。"></x-field>
-  <x-field data-name="moniker" data-type="string" data-required="true" data-desc="资产的新名称。"></x-field>
-  <x-field data-name="data" data-type="object" data-required="true" data-desc="资产更新后的数据负载。"></x-field>
-  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="当前资产所有者的钱包对象。"></x-field>
+  <x-field data-name="address" data-type="string" data-required="true" data-desc="要更新的资产的链上地址。" ></x-field>
+  <x-field data-name="moniker" data-type="string" data-required="true" data-desc="资产的新名称。" ></x-field>
+  <x-field data-name="data" data-type="object" data-required="true" data-desc="资产的更新数据负载。" ></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="当前资产所有者的钱包对象。" ></x-field>
 </x-field-group>
 
 ### 返回值
 
 一个 `Promise`，它会解析为交易哈希。
 
-<x-field data-name="response" data-type="Promise<string>" data-desc="交易哈希"></x-field>
+<x-field data-name="response" data-type="Promise<string>" data-desc="transactionHash"></x-field>
 
 ---
 
 ## 创建资产工厂
 
-资产工厂是用于创建多个相似资产的模板。它定义了铸造新资产的结构、规则和逻辑，比单独创建每个资产更高效。这非常适合发行活动门票、证书或收藏品等用例。
+资产工厂是用于创建多个相似资产的模板。它定义了铸造新资产的结构、规则和逻辑，比单独创建每个资产更高效。这对于发行活动门票、证书或收藏品等用例非常理想。
 
 ```javascript icon=logos:javascript
 const { wallet } = getWallet(); // 工厂所有者的钱包
 
 const factoryDefinition = {
   name: '会议门票工厂',
-  description: '铸造 2024 年科技大会的门票。',
+  description: '铸造 2024 年技术大会的门票。',
   limit: 1000, // 最多可铸造 1000 张门票
   input: {
     // 定义铸造资产所需的数据
@@ -130,8 +130,8 @@ const factoryDefinition = {
   },
   output: {
     // 定义铸造资产的结构
-    moniker: '{{attendeeName}} 的门票',
-    description: '2024 年科技大会的 {{ticketType}} 门票。',
+    moniker: '{{attendeeName}}的门票',
+    description: '2024 年技术大会的{{ticketType}}门票。',
     transferrable: false, // 门票不可转让
   },
   hooks: [],
@@ -144,10 +144,10 @@ async function createFactory() {
       wallet: wallet,
     });
 
-    console.log(`工厂创建交易已发送：${hash}`);
-    console.log(`新工厂地址：${factoryAddress}`);
+    console.log(`工厂创建交易已发送: ${hash}`);
+    console.log(`新工厂地址: ${factoryAddress}`);
   } catch (error) {
-    console.error('创建资产工厂时出错：', error);
+    console.error('创建资产工厂时出错:', error);
   }
 }
 
@@ -157,17 +157,17 @@ createFactory();
 ### 参数
 
 <x-field-group>
-  <x-field data-name="factory" data-type="object" data-required="true" data-desc="定义工厂属性和铸造逻辑的对象。">
-    <x-field data-name="name" data-type="string" data-required="true" data-desc="工厂的名称。"></x-field>
-    <x-field data-name="description" data-type="string" data-required="true" data-desc="工厂用途的描述。"></x-field>
-    <x-field data-name="limit" data-type="number" data-default="0" data-required="false" data-desc="可从此工厂铸造的最大资产数量。0 表示无限制。"></x-field>
-    <x-field data-name="trustedIssuers" data-type="string[]" data-required="false" data-desc="有权从此工厂铸造的账户地址列表。"></x-field>
-    <x-field data-name="input" data-type="object" data-required="true" data-desc="定义铸造资产所需的输入数据。"></x-field>
-    <x-field data-name="output" data-type="object" data-required="true" data-desc="定义将要铸造的资产的结构和属性。"></x-field>
-    <x-field data-name="hooks" data-type="object[]" data-required="false" data-desc="在铸造过程中执行的钩子列表。"></x-field>
-    <x-field data-name="data" data-type="object" data-required="false" data-desc="与工厂一起存储的额外任意数据。"></x-field>
+  <x-field data-name="factory" data-type="object" data-required="true" data-desc="一个定义工厂属性和铸造逻辑的对象。">
+    <x-field data-name="name" data-type="string" data-required="true" data-desc="工厂的名称。" ></x-field>
+    <x-field data-name="description" data-type="string" data-required="true" data-desc="工厂用途的描述。" ></x-field>
+    <x-field data-name="limit" data-type="number" data-default="0" data-required="false" data-desc="可从此工厂铸造的最大资产数量。0 表示无限制。" ></x-field>
+    <x-field data-name="trustedIssuers" data-type="string[]" data-required="false" data-desc="有权从此工厂铸造的账户地址列表。" ></x-field>
+    <x-field data-name="input" data-type="object" data-required="true" data-desc="定义铸造资产所需的输入数据。" ></x-field>
+    <x-field data-name="output" data-type="object" data-required="true" data-desc="定义将要铸造的资产的结构和属性。" ></x-field>
+    <x-field data-name="hooks" data-type="object[]" data-required="false" data-desc="在铸造过程中执行的钩子列表。" ></x-field>
+    <x-field data-name="data" data-type="object" data-required="false" data-desc="与工厂一起存储的额外任意数据。" ></x-field>
   </x-field>
-  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="工厂所有者的钱包对象。"></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="工厂所有者的钱包对象。" ></x-field>
 </x-field-group>
 
 
@@ -175,23 +175,23 @@ createFactory();
 
 一个 `Promise`，它会解析为一个包含交易哈希和新工厂链上地址的数组。
 
-<x-field data-name="response" data-type="Promise<[string, string]>" data-desc="[交易哈希, 工厂地址]"></x-field>
+<x-field data-name="response" data-type="Promise<[string, string]>" data-desc="[transactionHash, factoryAddress]"></x-field>
 
 ---
 
 ## 从工厂获取资产
 
-从工厂获取资产是一个两步过程。首先，准备铸造数据，这可以让你预览将要创建的资产。其次，将交易提交到区块链以正式获取资产。
+从工厂获取资产是一个两步过程。首先，你准备铸造数据，这可以让你预览将要创建的资产。其次，你将交易提交到区块链以正式获取资产。
 
-这种分离很有用，因为它允许应用程序在用户签署并提交最终交易之前，向用户展示他们将要收到的内容。
+这种分离很有用，因为它允许应用程序在用户签署并提交最终交易之前，向用户展示他们将要收到的东西。
 
 ### 步骤 1：准备资产数据
 
-`preMintAsset` 方法接收工厂地址和用户提供的输入，以生成最终的资产数据。此过程在链下进行，无需交易。
+`preMintAsset` 方法接收工厂地址和用户提供的输入，以生成最终的资产数据。此过程在链下发生，不需要交易。
 
 ```javascript icon=logos:javascript
-const factoryAddress = 'z2...'; // 先前创建的工厂地址
-const { wallet: issuerWallet } = getIssuerWallet(); // 工厂所有者或受信任的发行者
+const factoryAddress = 'z2...'; // 先前创建的工厂的地址
+const { wallet: issuerWallet } = getIssuerWallet(); // 工厂所有者或受信任的发行人
 const { wallet: userWallet } = getUserWallet(); // 将拥有新资产的用户
 
 async function prepareAssetForMinting() {
@@ -206,17 +206,17 @@ async function prepareAssetForMinting() {
       wallet: issuerWallet,
     });
 
-    console.log('准备好用于铸造的资产数据：', mintingData);
+    console.log('已准备好用于铸造的资产数据:', mintingData);
     return mintingData;
   } catch (error) {
-    console.error('准备资产时出错：', error);
+    console.error('准备资产时出错:', error);
   }
 }
 ```
 
 ### 步骤 2：发送交易
 
-铸造数据准备好后，用户（即未来的资产所有者）签署并发送 `acquireAsset` 交易。`preMintAsset` 返回的 `itx` 对象将用作有效载荷。
+一旦铸造数据准备好，用户（未来的资产所有者）签署并发送 `acquireAsset` 交易。来自 `preMintAsset` 的 `itx` 对象被用作有效负载。
 
 ```javascript icon=logos:javascript
 async function acquireNewAsset() {
@@ -230,10 +230,10 @@ async function acquireNewAsset() {
       wallet: userWallet, // 用户的钱包签署交易
     });
 
-    console.log(`资产获取交易已发送：${hash}`);
-    console.log(`新资产将在以下地址可用：${itx.address}`);
+    console.log(`资产获取交易已发送: ${hash}`);
+    console.log(`新资产将在以下地址可用: ${itx.address}`);
   } catch (error) {
-    console.error('获取资产时出错：', error);
+    console.error('获取资产时出错:', error);
   }
 }
 
@@ -243,13 +243,13 @@ acquireNewAsset();
 ### `acquireAsset` 的参数
 
 <x-field-group>
-  <x-field data-name="itx" data-type="object" data-required="true" data-desc="从 `preMintAsset` 方法返回的内部交易对象。"></x-field>
-  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="正在获取资产的用户的钱包。"></x-field>
-  <x-field data-name="delegator" data-type="string" data-default="''" data-required="false" data-desc="通过委托授权此交易的账户地址。"></x-field>
+  <x-field data-name="itx" data-type="object" data-required="true" data-desc="从 `preMintAsset` 方法返回的内部交易对象。" ></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="正在获取资产的用户的钱包。" ></x-field>
+  <x-field data-name="delegator" data-type="string" data-default="''" data-required="false" data-desc="通过委托授权此交易的账户地址。" ></x-field>
 </x-field-group>
 
 ### 返回值
 
 一个 `Promise`，它会解析为 `acquireAsset` 操作的交易哈希。
 
-<x-field data-name="response" data-type="Promise<string>" data-desc="交易哈希"></x-field>
+<x-field data-name="response" data-type="Promise<string>" data-desc="transactionHash"></x-field>

package/docs/how-to-guides-manage-tokens.ja.md

@@ -0,0 +1,179 @@
+# トークンを管理する
+
+このガイドでは、OCAP Client を使用してファンジブルトークンを管理するための手順を詳しく説明します。トークンの設計図として機能するトークンファクトリーを設定し、それを使用してミント（新しいトークンの作成）およびバーン（既存のトークンの破棄）する方法を学びます。これらの操作は、アプリケーション内で独自の経済システムを構築・管理する上で基本となります。
+
+トークンをミントした後は、アカウント間で転送できます。そのプロセスの詳細については、[トークンとNFTの転送](./how-to-guides-transfer-tokens-and-nfts.md)ガイドを参照してください。
+
+## トークンファクトリーを作成する
+
+トークンファクトリーは、名前、シンボル、供給メカニズムなど、ファンジブルトークンのプロパティとルールを定義するスマートコントラクトです。また、ミントとバーンのプロセスも管理します。新しいトークンを流通させるには、まずファクトリーを作成する必要があります。
+
+`createTokenFactory` メソッドは、新しいトークンファクトリーをブロックチェーンにデプロイします。
+
+### パラメータ
+<x-field-group>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="トランザクションに署名するために使用される、ファクトリー所有者のウォレットオブジェクト。"></x-field>
+  <x-field data-name="token" data-type="object" data-required="true" data-desc="作成されるトークンのプロパティを定義するオブジェクト。">
+    <x-field data-name="name" data-type="string" data-required="true" data-desc="トークンのフルネーム（例：'My Awesome Token'）。"></x-field>
+    <x-field data-name="symbol" data-type="string" data-required="true" data-desc="トークンのティッカーシンボル（例：'MAT'）。"></x-field>
+    <x-field data-name="decimal" data-type="number" data-required="true" data-desc="トークンがサポートする小数点以下の桁数。"></x-field>
+    <x-field data-name="description" data-type="string" data-required="false" data-desc="トークンの簡単な説明。"></x-field>
+    <x-field data-name="icon" data-type="string" data-required="false" data-desc="トークンのアイコンへのURL。"></x-field>
+    <x-field data-name="maxTotalSupply" data-type="number" data-required="false" data-desc="これまでにミントできる最大総供給量。"></x-field>
+  </x-field>
+  <x-field data-name="curve" data-type="object" data-required="false" data-desc="トークンの価格をプログラムで制御するボンディングカーブの設定。省略した場合、ミント/バーンはリザーブトークンに結び付けられません。">
+    <x-field data-name="basePrice" data-type="number" data-required="false" data-desc="リザーブ通貨でのトークンの基本価格。"></x-field>
+    <x-field data-name="fixedPrice" data-type="number" data-required="false" data-desc="動的なカーブを使用しない場合のトークンの固定価格。"></x-field>
+    <x-field data-name="slope" data-type="number" data-required="false" data-desc="ボンディングカーブの傾きで、その急勾配を決定します。"></x-field>
+  </x-field>
+  <x-field data-name="feeRate" data-type="number" data-default="0" data-required="false" data-desc="ミントおよびバーン操作の手数料率（ベーシスポイント単位）。"></x-field>
+  <x-field data-name="data" data-type="object" data-required="false" data-desc="トークンファクトリーに添付するオプションのカスタムデータ。"></x-field>
+</x-field-group>
+
+### 戻り値
+
+トランザクションハッシュと新しく作成されたトークンファクトリーのアドレスを含む配列に解決されるプロミスを返します。
+
+<x-field-group>
+  <x-field data-name="[0]" data-type="string" data-desc="ファクトリー作成のトランザクションハッシュ。"></x-field>
+  <x-field data-name="[1]" data-type="string" data-desc="新しいトークンファクトリーのアドレス。"></x-field>
+</x-field-group>
+
+### 例
+
+```javascript Create a Token Factory icon=logos:javascript
+import Client from '@ocap/client';
+import Wallet from '@ocap/wallet';
+
+const endpoint = 'https://beta.abtnetwork.io/api';
+const client = new Client(endpoint);
+const wallet = Wallet.fromRandom();
+
+// まず、ウォレットに資金があることを確認します。テストトークンはフォーセットから入手できます：
+// https://faucet.abtnetwork.io/
+
+async function createFactory() {
+  try {
+    const [hash, factoryAddress] = await client.createTokenFactory({
+      wallet,
+      token: {
+        name: 'My Game Coin',
+        symbol: 'MGC',
+        decimal: 18,
+        description: 'The official currency for My Awesome Game.',
+        maxTotalSupply: 1000000,
+      },
+      feeRate: 100, // 1%の手数料
+    });
+
+    console.log('トークンファクトリーが正常に作成されました！');
+    console.log('トランザクションハッシュ:', hash);
+    console.log('ファクトリーアドレス:', factoryAddress);
+    return factoryAddress;
+  } catch (error) {
+    console.error('トークンファクトリーの作成中にエラーが発生しました:', error);
+  }
+}
+
+createFactory();
+```
+
+## トークンをミントする
+
+ミントとは、新しいトークンを作成して総供給量に追加するプロセスです。これはトークンファクトリーを通じて行われます。ファクトリーがボンディングカーブで設定されている場合、ミントにはリザーブトークンでの支払いが必要になります。
+
+`mintToken` メソッドは、ファクトリーから指定された量のトークンをミントするトランザクションを開始します。
+
+### パラメータ
+<x-field-group>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="ミント操作に資金を提供し、トランザクションに署名するウォレット。"></x-field>
+  <x-field data-name="tokenFactory" data-type="string" data-required="true" data-desc="ミント元となるトークンファクトリーのアドレス。"></x-field>
+  <x-field data-name="amount" data-type="number" data-required="true" data-desc="ミントするトークンの数量。"></x-field>
+  <x-field data-name="receiver" data-type="string" data-required="true" data-desc="新しくミントされたトークンを受け取るアドレス。"></x-field>
+  <x-field data-name="maxReserve" data-type="number" data-required="true" data-desc="ウォレットが支払う意思のあるリザーブトークンの最大量。これはスリッページ保護メカニズムとして機能します。"></x-field>
+  <x-field data-name="data" data-type="object" data-required="false" data-desc="ミントトランザクションに添付するオプションのカスタムデータ。"></x-field>
+</x-field-group>
+
+### 戻り値
+
+トランザクションハッシュに解決されるプロミスを返します。
+
+<x-field data-name="hash" data-type="string" data-desc="ミント操作のトランザクションハッシュ。"></x-field>
+
+### 例
+
+```javascript Mint Tokens from a Factory icon=logos:javascript
+async function mintNewTokens(factoryAddress) {
+  try {
+    const hash = await client.mintToken({
+      wallet,
+      tokenFactory: factoryAddress,
+      amount: 5000,
+      receiver: wallet.address, // 自身のウォレットにトークンをミントする
+      maxReserve: 10, // 支払うリザーブトークンの最大値。ボンディングカーブの価格に基づいて調整してください。
+    });
+
+    console.log('トークンが正常にミントされました！');
+    console.log('トランザクションハッシュ:', hash);
+  } catch (error) {
+    console.error('トークンのミント中にエラーが発生しました:', error);
+  }
+}
+
+// `factoryAddress` が createFactory の例から利用可能であると仮定
+// const factoryAddress = '...'; 
+// mintNewTokens(factoryAddress);
+```
+
+## トークンをバーンする
+
+バーンはミントの反対で、トークンを流通から永久に削除します。トークンファクトリーがボンディングカーブを使用している場合、トークンをバーンすると、ユーザーに比例した量のリザーブ通貨が返されます。
+
+`burnToken` メソッドがこのプロセスを開始します。
+
+### パラメータ
+<x-field-group>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="バーンされるトークンを保持し、トランザクションに署名するウォレット。"></x-field>
+  <x-field data-name="tokenFactory" data-type="string" data-required="true" data-desc="トークンファクトリーのアドレス。"></x-field>
+  <x-field data-name="amount" data-type="number" data-required="true" data-desc="バーンするトークンの数量。"></x-field>
+  <x-field data-name="receiver" data-type="string" data-required="true" data-desc="見返りとしてリザーブトークンを受け取るアドレス。"></x-field>
+  <x-field data-name="minReserve" data-type="number" data-required="true" data-desc="ウォレットが受け取ると期待するリザーブトークンの最小量。これは価格の滑りから保護します。"></x-field>
+  <x-field data-name="data" data-type="object" data-required="false" data-desc="バーントランザクションに添付するオプションのカスタムデータ。"></x-field>
+</x-field-group>
+
+### 戻り値
+
+トランザクションハッシュに解決されるプロミスを返します。
+
+<x-field data-name="hash" data-type="string" data-desc="バーン操作のトランザクションハッシュ。"></x-field>
+
+### 例
+
+```javascript Burn Tokens icon=logos:javascript
+async function burnExistingTokens(factoryAddress) {
+  try {
+    const hash = await client.burnToken({
+      wallet,
+      tokenFactory: factoryAddress,
+      amount: 1000,
+      receiver: wallet.address, // 自身のウォレットにリザーブトークンを受け取る
+      minReserve: 1, // 受け取るリザーブトークンの最小値。ボンディングカーブの価格に基づいて調整してください。
+    });
+
+    console.log('トークンが正常にバーンされました！');
+    console.log('トランザクションハッシュ:', hash);
+  } catch (error) {
+    console.error('トークンのバーン中にエラーが発生しました:', error);
+  }
+}
+
+// `factoryAddress` が createFactory の例から利用可能であると仮定
+// const factoryAddress = '...'; 
+// burnExistingTokens(factoryAddress);
+```
+
+## まとめ
+
+このガイドでは、ファンジブルトークンを管理するための完全なライフサイクル（ファクトリーの作成、新しいトークンのミント、供給を減らすためのバーン）を学びました。これらの強力なプリミティブにより、OCAP プラットフォーム上で高度な経済システムを構築できます。
+
+トークンの作成方法を学んだので、次のステップはトークンの移動方法を学ぶことです。[トークンとNFTの転送](./how-to-guides-transfer-tokens-and-nfts.md)ガイドでその方法を確認してください。

package/docs/how-to-guides-manage-tokens.zh-TW.md

@@ -0,0 +1,179 @@
+# 管理代幣
+
+本指南提供使用 OCAP Client 管理同質化代幣的逐步說明。您將學習如何設定代幣工廠（作為您代幣的藍圖），然後用它來鑄造（創建新代幣）和銷毀（摧毀現有代幣）。這些操作是在您的應用程式中創建和管理自訂經濟體的基礎。
+
+一旦鑄造了代幣，您就可以在帳戶之間轉移它們。有關該過程的更多詳細資訊，請參閱 [轉移代幣和 NFT](./how-to-guides-transfer-tokens-and-nfts.md) 指南。
+
+## 建立代幣工廠
+
+代幣工廠是一種智能合約，它定義了同質化代幣的屬性和規則，例如其名稱、符號和供應機制。它還管理鑄造和銷毀的過程。建立工廠是任何新代幣進入流通前的第一步。
+
+`createTokenFactory` 方法將一個新的代幣工廠部署到區塊鏈上。
+
+### 參數
+<x-field-group>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="工廠所有者的錢包物件，用於簽署交易。"></x-field>
+  <x-field data-name="token" data-type="object" data-required="true" data-desc="一個定義要創建的代幣屬性的物件。">
+    <x-field data-name="name" data-type="string" data-required="true" data-desc="代幣的全名（例如，'My Awesome Token'）。"></x-field>
+    <x-field data-name="symbol" data-type="string" data-required="true" data-desc="代幣的股票代碼（例如，'MAT'）。"></x-field>
+    <x-field data-name="decimal" data-type="number" data-required="true" data-desc="代幣支援的小數位數。"></x-field>
+    <x-field data-name="description" data-type="string" data-required="false" data-desc="代幣的簡要描述。"></x-field>
+    <x-field data-name="icon" data-type="string" data-required="false" data-desc="代幣圖示的 URL。"></x-field>
+    <x-field data-name="maxTotalSupply" data-type="number" data-required="false" data-desc="可鑄造的最大總供應量。"></x-field>
+  </x-field>
+  <x-field data-name="curve" data-type="object" data-required="false" data-desc="聯合曲線的設定，以程式化方式控制代幣價格。如果省略，鑄造/銷毀將不與儲備代幣掛鉤。">
+    <x-field data-name="basePrice" data-type="number" data-required="false" data-desc="代幣以儲備貨幣計價的基礎價格。"></x-field>
+    <x-field data-name="fixedPrice" data-type="number" data-required="false" data-desc="代幣的固定價格，如果不使用動態曲線。"></x-field>
+    <x-field data-name="slope" data-type="number" data-required="false" data-desc="聯合曲線的斜率，決定其陡峭程度。"></x-field>
+  </x-field>
+  <x-field data-name="feeRate" data-type="number" data-default="0" data-required="false" data-desc="鑄造和銷毀操作的費率（以基點為單位）。"></x-field>
+  <x-field data-name="data" data-type="object" data-required="false" data-desc="可選的自訂資料，附加到代幣工廠。"></x-field>
+</x-field-group>
+
+### 返回值
+
+返回一個解析為包含交易雜湊值和新創建代幣工廠地址的陣列的 promise。
+
+<x-field-group>
+  <x-field data-name="[0]" data-type="string" data-desc="工廠創建的交易雜湊值。"></x-field>
+  <x-field data-name="[1]" data-type="string" data-desc="新代幣工廠的地址。"></x-field>
+</x-field-group>
+
+### 範例
+
+```javascript Create a Token Factory icon=logos:javascript
+import Client from '@ocap/client';
+import Wallet from '@ocap/wallet';
+
+const endpoint = 'https://beta.abtnetwork.io/api';
+const client = new Client(endpoint);
+const wallet = Wallet.fromRandom();
+
+// 首先，確保錢包有資金。您可以從水龍頭獲取測試代幣：
+// https://faucet.abtnetwork.io/
+
+async function createFactory() {
+  try {
+    const [hash, factoryAddress] = await client.createTokenFactory({
+      wallet,
+      token: {
+        name: 'My Game Coin',
+        symbol: 'MGC',
+        decimal: 18,
+        description: 'The official currency for My Awesome Game.',
+        maxTotalSupply: 1000000,
+      },
+      feeRate: 100, // 1% 手續費
+    });
+
+    console.log('代幣工廠建立成功！');
+    console.log('交易雜湊值：', hash);
+    console.log('工廠地址：', factoryAddress);
+    return factoryAddress;
+  } catch (error) {
+    console.error('建立代幣工廠時出錯：', error);
+  }
+}
+
+createFactory();
+```
+
+## 鑄造代幣
+
+鑄造是創建新代幣並將其加入總供應量的過程。這是透過代幣工廠完成的。如果工廠配置了聯合曲線，鑄造將需要支付儲備代幣。
+
+`mintToken` 方法會啟動一個交易，從工廠鑄造指定數量的代幣。
+
+### 參數
+<x-field-group>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="為鑄造操作提供資金並簽署交易的錢包。"></x-field>
+  <x-field data-name="tokenFactory" data-type="string" data-required="true" data-desc="要從中鑄造代幣的代幣工廠地址。"></x-field>
+  <x-field data-name="amount" data-type="number" data-required="true" data-desc="要鑄造的代幣數量。"></x-field>
+  <x-field data-name="receiver" data-type="string" data-required="true" data-desc="將接收新鑄造代幣的地址。"></x-field>
+  <x-field data-name="maxReserve" data-type="number" data-required="true" data-desc="錢包願意花費的儲備代幣最大數量。這可作為一種滑價保護機制。"></x-field>
+  <x-field data-name="data" data-type="object" data-required="false" data-desc="可選的自訂資料，附加到鑄造交易中。"></x-field>
+</x-field-group>
+
+### 返回值
+
+返回一個解析為交易雜湊值的 promise。
+
+<x-field data-name="hash" data-type="string" data-desc="鑄造操作的交易雜湊值。"></x-field>
+
+### 範例
+
+```javascript Mint Tokens from a Factory icon=logos:javascript
+async function mintNewTokens(factoryAddress) {
+  try {
+    const hash = await client.mintToken({
+      wallet,
+      tokenFactory: factoryAddress,
+      amount: 5000,
+      receiver: wallet.address, // 將代幣鑄造到我們自己的錢包
+      maxReserve: 10, // 要支付的最大儲備代幣。根據聯合曲線價格進行調整。
+    });
+
+    console.log('代幣鑄造成功！');
+    console.log('交易雜湊值：', hash);
+  } catch (error) {
+    console.error('鑄造代幣時出錯：', error);
+  }
+}
+
+// 假設 `factoryAddress` 可從 createFactory 範例中獲得
+// const factoryAddress = '...'; 
+// mintNewTokens(factoryAddress);
+```
+
+## 銷毀代幣
+
+銷毀與鑄造相反；它會永久地將代幣從流通中移除。如果代幣工廠使用聯合曲線，銷毀代幣將按比例返還儲備貨幣給用戶。
+
+`burnToken` 方法會啟動此過程。
+
+### 參數
+<x-field-group>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="持有要銷毀的代幣並將簽署交易的錢包。"></x-field>
+  <x-field data-name="tokenFactory" data-type="string" data-required="true" data-desc="代幣工廠的地址。"></x-field>
+  <x-field data-name="amount" data-type="number" data-required="true" data-desc="要銷毀的代幣數量。"></x-field>
+  <x-field data-name="receiver" data-type="string" data-required="true" data-desc="將接收返還的儲備代幣的地址。"></x-field>
+  <x-field data-name="minReserve" data-type="number" data-required="true" data-desc="錢包預期收到的最少儲備代幣數量。這可以防止價格滑動。"></x-field>
+  <x-field data-name="data" data-type="object" data-required="false" data-desc="可選的自訂資料，附加到銷毀交易中。"></x-field>
+</x-field-group>
+
+### 返回值
+
+返回一個解析為交易雜湊值的 promise。
+
+<x-field data-name="hash" data-type="string" data-desc="銷毀操作的交易雜湊值。"></x-field>
+
+### 範例
+
+```javascript Burn Tokens icon=logos:javascript
+async function burnExistingTokens(factoryAddress) {
+  try {
+    const hash = await client.burnToken({
+      wallet,
+      tokenFactory: factoryAddress,
+      amount: 1000,
+      receiver: wallet.address, // 將儲備代幣接收回我們自己的錢包
+      minReserve: 1, // 要接收的最小儲備代幣。根據聯合曲線價格進行調整。
+    });
+
+    console.log('代幣銷毀成功！');
+    console.log('交易雜湊值：', hash);
+  } catch (error) {
+    console.error('銷毀代幣時出錯：', error);
+  }
+}
+
+// 假設 `factoryAddress` 可從 createFactory 範例中獲得
+// const factoryAddress = '...'; 
+// burnExistingTokens(factoryAddress);
+```
+
+## 總結
+
+在本指南中，您學習了管理同質化代幣的完整生命週期：建立工廠、鑄造新代幣使其存在，以及銷毀它們以減少供應。這些強大的基礎功能讓您可以在 OCAP 平台上建構複雜的經濟系統。
+
+既然您知道了如何創建代幣，接下來合乎邏輯的一步就是學習如何轉移它們。請前往 [轉移代幣和 NFT](./how-to-guides-transfer-tokens-and-nfts.md) 指南查看如何操作。