@ocap/client 1.25.5 → 1.26.0

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

@@ -1,22 +1,22 @@
 # 管理资产 (NFT)
 
-本指南全面介绍了如何使用 OCAP Client 管理非同质化代币（NFT）（也称为资产）的整个生命周期。你将学习如何从头开始创建新资产、更新其属性、建立用于标准化铸造的资产工厂，以及从该工厂获取新资产。
+本指南将全面介绍如何使用 OCAP Client 管理非同质化代币 (NFT)，也称为资产的整个生命周期。您将学习如何从零开始创建新资产、更新其属性、建立用于标准化铸造的资产工厂，以及如何从该工厂获取新资产。
 
 ## 创建新资产
 
-你可以使用 `createAsset` 方法在区块链上创建一个独特的、独立的资产。每个资产都会根据其初始属性派生出一个唯一的链上地址。
+您可以使用 `createAsset` 方法在区块链上创建一个独立的唯一资产。每个资产都会被分配一个唯一的链上地址，该地址由其初始属性派生而来。
 
 ```javascript icon=logos:javascript
-const { wallet } = getWallet(); // 用户钱包对象
+const { wallet } = getWallet(); // 用户的钱包对象
 
 async function createNewAsset() {
   try {
     const [hash, address] = await client.createAsset({
-      moniker: '我的独特数字艺术品',
+      moniker: 'My Unique Digital Artwork',
       data: {
         typeUrl: 'json',
         value: { 
-          description: '由艺术家 X 创作的独一无二的作品。',
+          description: 'A one-of-a-kind piece created by Artist X.',
           imageUrl: 'https://example.com/path/to/image.png',
         },
       },
@@ -25,11 +25,11 @@ async function createNewAsset() {
       wallet: wallet,
     });
 
-    console.log(`资产创建交易已发送: ${hash}`);
-    console.log(`新资产地址: ${address}`);
+    console.log(`Asset creation transaction sent: ${hash}`);
+    console.log(`New asset address: ${address}`);
     return address;
   } catch (error) {
-    console.error('创建资产时出错:', error);
+    console.error('Error creating asset:', error);
   }
 }
 
@@ -39,53 +39,53 @@ 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="[transactionHash, assetAddress]"></x-field>
+<x-field data-name="response" data-type="Promise<[string, string]>" data-desc="[交易哈希, 资产地址]"></x-field>
 
 ---
 
 ## 更新现有资产
 
-如果资产创建时设置了 `readonly: false`，你可以使用 `updateAsset` 方法修改其 `moniker` 和 `data` 字段。资产通过其唯一地址进行识别。
+如果资产创建时设置了 `readonly: false`，您可以使用 `updateAsset` 方法修改其 `moniker` 和 `data` 字段。通过资产的唯一地址来识别该资产。
 
 ```javascript icon=logos:javascript
-const { wallet } = getWallet(); // 用户钱包对象
+const { wallet } = getWallet(); // 用户的钱包对象
 const assetAddress = 'z362...'; // 要更新的资产地址
 
 async function updateExistingAsset() {
   try {
     const hash = await client.updateAsset({
       address: assetAddress,
-      moniker: '我更新后的数字艺术品',
+      moniker: 'My Updated Digital Artwork',
       data: {
         typeUrl: 'json',
         value: { 
-          description: '我的独特作品的更新描述。',
+          description: 'An updated description for my unique piece.',
           imageUrl: 'https://example.com/path/to/new_image.png',
         },
       },
       wallet: wallet,
     });
 
-    console.log(`资产更新交易已发送: ${hash}`);
+    console.log(`Asset update transaction sent: ${hash}`);
   } catch (error) {
-    console.error('更新资产时出错:', error);
+    console.error('Error updating asset:', error);
   }
 }
 
@@ -95,17 +95,17 @@ 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="transactionHash"></x-field>
+<x-field data-name="response" data-type="Promise<string>" data-desc="交易哈希"></x-field>
 
 ---
 
@@ -117,8 +117,8 @@ updateExistingAsset();
 const { wallet } = getWallet(); // 工厂所有者的钱包
 
 const factoryDefinition = {
-  name: '会议门票工厂',
-  description: '铸造 2024 年技术大会的门票。',
+  name: 'Conference Ticket Factory',
+  description: 'Mints tickets for the 2024 Tech Conference.',
   limit: 1000, // 最多可铸造 1000 张门票
   input: {
     // 定义铸造资产所需的数据
@@ -129,9 +129,9 @@ const factoryDefinition = {
     },
   },
   output: {
-    // 定义铸造资产的结构
-    moniker: '{{attendeeName}}的门票',
-    description: '2024 年技术大会的{{ticketType}}门票。',
+    // 定义铸造出的资产的结构
+    moniker: 'Ticket for {{attendeeName}}',
+    description: '{{ticketType}} admission for the 2024 Tech Conference.',
     transferrable: false, // 门票不可转让
   },
   hooks: [],
@@ -144,10 +144,10 @@ async function createFactory() {
       wallet: wallet,
     });
 
-    console.log(`工厂创建交易已发送: ${hash}`);
-    console.log(`新工厂地址: ${factoryAddress}`);
+    console.log(`Factory creation transaction sent: ${hash}`);
+    console.log(`New factory address: ${factoryAddress}`);
   } catch (error) {
-    console.error('创建资产工厂时出错:', error);
+    console.error('Error creating asset factory:', error);
   }
 }
 
@@ -158,16 +158,16 @@ 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="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,24 +175,24 @@ createFactory();
 
 一个 `Promise`，它会解析为一个包含交易哈希和新工厂链上地址的数组。
 
-<x-field data-name="response" data-type="Promise<[string, string]>" data-desc="[transactionHash, factoryAddress]"></x-field>
+<x-field data-name="response" data-type="Promise<[string, string]>" data-desc="[交易哈希, 工厂地址]"></x-field>
 
 ---
 
 ## 从工厂获取资产
 
-从工厂获取资产是一个两步过程。首先，你准备铸造数据，这可以让你预览将要创建的资产。其次，你将交易提交到区块链以正式获取资产。
+从工厂获取资产是一个两步过程。首先，您准备铸造数据，这使您可以预览将要创建的资产。其次，您将交易提交到区块链以正式获取该资产。
 
-这种分离很有用，因为它允许应用程序在用户签署并提交最终交易之前，向用户展示他们将要收到的东西。
+这种分离很有用，因为它允许应用程序在用户签名并提交最终交易之前，向用户展示他们将要收到的东西。
 
 ### 步骤 1：准备资产数据
 
 `preMintAsset` 方法接收工厂地址和用户提供的输入，以生成最终的资产数据。此过程在链下发生，不需要交易。
 
 ```javascript icon=logos:javascript
-const factoryAddress = 'z2...'; // 先前创建的工厂的地址
-const { wallet: issuerWallet } = getIssuerWallet(); // 工厂所有者或受信任的发行人
-const { wallet: userWallet } = getUserWallet(); // 将拥有新资产的用户
+const factoryAddress = 'z2...'; // 先前创建的工厂地址
+const { wallet: issuerWallet } = getIssuerWallet(); // 工厂所有者或受信任的发行方
+const { wallet: userWallet } = getUserWallet(); // 将拥有新资产的用户的钱包
 
 async function prepareAssetForMinting() {
   try {
@@ -206,17 +206,17 @@ async function prepareAssetForMinting() {
       wallet: issuerWallet,
     });
 
-    console.log('已准备好用于铸造的资产数据:', mintingData);
+    console.log('Prepared asset data for minting:', mintingData);
     return mintingData;
   } catch (error) {
-    console.error('准备资产时出错:', error);
+    console.error('Error preparing asset:', error);
   }
 }
 ```
 
 ### 步骤 2：发送交易
 
-一旦铸造数据准备好，用户（未来的资产所有者）签署并发送 `acquireAsset` 交易。来自 `preMintAsset` 的 `itx` 对象被用作有效负载。
+一旦铸造数据准备好，用户（未来的资产所有者）签名并发送 `acquireAsset` 交易。来自 `preMintAsset` 的 `itx` 对象将用作有效负载。
 
 ```javascript icon=logos:javascript
 async function acquireNewAsset() {
@@ -230,26 +230,103 @@ async function acquireNewAsset() {
       wallet: userWallet, // 用户的钱包签署交易
     });
 
-    console.log(`资产获取交易已发送: ${hash}`);
-    console.log(`新资产将在以下地址可用: ${itx.address}`);
+    console.log(`Asset acquisition transaction sent: ${hash}`);
+    console.log(`New asset will be available at address: ${itx.address}`);
   } catch (error) {
-    console.error('获取资产时出错:', error);
+    console.error('Error acquiring asset:', error);
   }
 }
 
 acquireNewAsset();
 ```
 
-### `acquireAsset` 的参数
+### 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="transactionHash"></x-field>
+<x-field data-name="response" data-type="Promise<string>" data-desc="交易哈希"></x-field>
+
+---
+
+## 从工厂铸造资产
+
+除了用户主导的 `acquireAsset` 流程外，授权的发行方（例如工厂所有者或受信任的发行方）可以铸造一个资产并将其直接发送到用户的账户。此过程也使用 `preMintAsset` 来准备数据，但最终的交易是 `mintAsset`，由发行方签名。
+
+此流程适用于空投、颁发证书或任何接收用户无需发起最终交易的情况。
+
+### 步骤 1：准备资产数据
+
+此步骤与获取流程相同。发行方调用 `preMintAsset` 在链下生成交易有效负载（`itx`）。
+
+```javascript icon=logos:javascript
+const factoryAddress = 'z2...'; // 工厂地址
+const { wallet: issuerWallet } = getIssuerWallet(); // 工厂所有者或受信任的发行方
+const userAddress = 'z1...'; // 将接收资产的用户的地址
+
+async function prepareAssetForMinting() {
+  try {
+    const mintingData = await client.preMintAsset({
+      factory: factoryAddress,
+      inputs: {
+        attendeeName: 'Jane Smith',
+        ticketType: 'General',
+      },
+      owner: userAddress,
+      wallet: issuerWallet, // 此处使用发行方的钱包
+    });
+
+    console.log('Prepared asset data for minting:', mintingData);
+    return mintingData;
+  } catch (error) {
+    console.error('Error preparing asset:', error);
+  }
+}
+```
+
+### 步骤 2：发送铸造交易
+
+发行方使用准备好的 `itx` 对象调用 `mintAsset`。交易由发行方的钱包签名，新创建的资产被分配给上一步中指定的所有者。
+
+```javascript icon=logos:javascript
+async function mintNewAsset() {
+  // 首先，从步骤 1 获取铸造数据
+  const itx = await prepareAssetForMinting();
+  if (!itx) return;
+
+  try {
+    // 发行方的钱包签署交易
+    const hash = await client.mintAsset({
+      itx: itx,
+      wallet: issuerWallet,
+    });
+
+    console.log(`Asset minting transaction sent: ${hash}`);
+    console.log(`New asset for ${userAddress} will be available at address: ${itx.address}`);
+  } catch (error) {
+    console.error('Error minting asset:', error);
+  }
+}
+
+mintNewAsset();
+```
+
+### mintAsset 的参数
+
+<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-group>
+
+### 返回值
+
+一个 `Promise`，它会解析为 `mintAsset` 操作的交易哈希。
+
+<x-field data-name="response" data-type="Promise<string>" data-desc="交易哈希"></x-field>

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

@@ -1,30 +1,30 @@
-# トークンを管理する
+# トークンの管理
 
-このガイドでは、OCAP Client を使用してファンジブルトークンを管理するための手順を詳しく説明します。トークンの設計図として機能するトークンファクトリーを設定し、それを使用してミント（新しいトークンの作成）およびバーン（既存のトークンの破棄）する方法を学びます。これらの操作は、アプリケーション内で独自の経済システムを構築・管理する上で基本となります。
+このガイドでは、OCAP Client を使用してファンジブルトークンを管理するための手順を詳しく説明します。トークンの設計図として機能するトークンファクトリーを設定し、それを使用してミント（新しいトークンの作成）およびバーン（既存のトークンの破棄）を行う方法を学びます。これらの操作は、アプリケーション内でカスタムエコノミーを作成および管理するための基本です。
 
-トークンをミントした後は、アカウント間で転送できます。そのプロセスの詳細については、[トークンとNFTの転送](./how-to-guides-transfer-tokens-and-nfts.md)ガイドを参照してください。
+トークンをミントしたら、アカウント間で転送できます。そのプロセスの詳細については、[トークンと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="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 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 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>
@@ -32,7 +32,7 @@
 
 ### 戻り値
 
-トランザクションハッシュと新しく作成されたトークンファクトリーのアドレスを含む配列に解決されるプロミスを返します。
+トランザクションハッシュと新しく作成されたトークンファクトリーのアドレスを含む配列に解決される Promise を返します。
 
 <x-field-group>
   <x-field data-name="[0]" data-type="string" data-desc="ファクトリー作成のトランザクションハッシュ。"></x-field>
@@ -41,7 +41,7 @@
 
 ### 例
 
-```javascript Create a Token Factory icon=logos:javascript
+```javascript トークンファクトリーの作成 icon=logos:javascript
 import Client from '@ocap/client';
 import Wallet from '@ocap/wallet';
 
@@ -49,7 +49,7 @@ const endpoint = 'https://beta.abtnetwork.io/api';
 const client = new Client(endpoint);
 const wallet = Wallet.fromRandom();
 
-// まず、ウォレットに資金があることを確認します。テストトークンはフォーセットから入手できます：
+// まず、ウォレットに資金があることを確認してください。テストトークンはフォーセットから入手できます：
 // https://faucet.abtnetwork.io/
 
 async function createFactory() {
@@ -63,32 +63,32 @@ async function createFactory() {
         description: 'The official currency for My Awesome Game.',
         maxTotalSupply: 1000000,
       },
-      feeRate: 100, // 1%の手数料
+      feeRate: 100, // 1% fee
     });
 
-    console.log('トークンファクトリーが正常に作成されました！');
-    console.log('トランザクションハッシュ:', hash);
-    console.log('ファクトリーアドレス:', factoryAddress);
+    console.log('Token factory created successfully!');
+    console.log('Transaction Hash:', hash);
+    console.log('Factory Address:', factoryAddress);
     return factoryAddress;
   } catch (error) {
-    console.error('トークンファクトリーの作成中にエラーが発生しました:', error);
+    console.error('Error creating token factory:', 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="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>
@@ -96,84 +96,84 @@ createFactory();
 
 ### 戻り値
 
-トランザクションハッシュに解決されるプロミスを返します。
+トランザクションハッシュに解決される Promise を返します。
 
 <x-field data-name="hash" data-type="string" data-desc="ミント操作のトランザクションハッシュ。"></x-field>
 
 ### 例
 
-```javascript Mint Tokens from a Factory icon=logos:javascript
+```javascript ファクトリーからトークンをミントする icon=logos:javascript
 async function mintNewTokens(factoryAddress) {
   try {
     const hash = await client.mintToken({
       wallet,
       tokenFactory: factoryAddress,
       amount: 5000,
-      receiver: wallet.address, // 自身のウォレットにトークンをミントする
-      maxReserve: 10, // 支払うリザーブトークンの最大値。ボンディングカーブの価格に基づいて調整してください。
+      receiver: wallet.address, // 自分のウォレットにトークンをミントします
+      maxReserve: 10, // 支払うリザーブトークンの最大額。ボンディングカーブの価格に基づいて調整してください。
     });
 
-    console.log('トークンが正常にミントされました！');
-    console.log('トランザクションハッシュ:', hash);
+    console.log('Tokens minted successfully!');
+    console.log('Transaction Hash:', hash);
   } catch (error) {
-    console.error('トークンのミント中にエラーが発生しました:', error);
+    console.error('Error minting tokens:', error);
   }
 }
 
-// `factoryAddress` が createFactory の例から利用可能であると仮定
+// createFactory の例で `factoryAddress` が利用可能であると仮定します
 // 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="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="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="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
+```javascript トークンをバーンする icon=logos:javascript
 async function burnExistingTokens(factoryAddress) {
   try {
     const hash = await client.burnToken({
       wallet,
       tokenFactory: factoryAddress,
       amount: 1000,
-      receiver: wallet.address, // 自身のウォレットにリザーブトークンを受け取る
-      minReserve: 1, // 受け取るリザーブトークンの最小値。ボンディングカーブの価格に基づいて調整してください。
+      receiver: wallet.address, // 自分のウォレットでリザーブトークンを受け取ります
+      minReserve: 1, // 受け取るリザーブトークンの最小額。ボンディングカーブの価格に基づいて調整してください。
     });
 
-    console.log('トークンが正常にバーンされました！');
-    console.log('トランザクションハッシュ:', hash);
+    console.log('Tokens burned successfully!');
+    console.log('Transaction Hash:', hash);
   } catch (error) {
-    console.error('トークンのバーン中にエラーが発生しました:', error);
+    console.error('Error burning tokens:', error);
   }
 }
 
-// `factoryAddress` が createFactory の例から利用可能であると仮定
+// createFactory の例で `factoryAddress` が利用可能であると仮定します
 // const factoryAddress = '...'; 
 // burnExistingTokens(factoryAddress);
 ```
 
 ## まとめ
 
-このガイドでは、ファンジブルトークンを管理するための完全なライフサイクル（ファクトリーの作成、新しいトークンのミント、供給を減らすためのバーン）を学びました。これらの強力なプリミティブにより、OCAP プラットフォーム上で高度な経済システムを構築できます。
+このガイドでは、ファンジブルトークンを管理するための完全なライフサイクル、つまりファクトリーの作成、新しいトークンのミント、そして供給量を減らすためのバーンについて学びました。これらの強力なプリミティブにより、OCAP プラットフォーム上で洗練された経済システムを構築できます。
 
-トークンの作成方法を学んだので、次のステップはトークンの移動方法を学ぶことです。[トークンとNFTの転送](./how-to-guides-transfer-tokens-and-nfts.md)ガイドでその方法を確認してください。
+トークンの作成方法を学んだので、次の論理的なステップはそれらを移動させる方法を学ぶことです。[トークンとNFTの転送](./how-to-guides-transfer-tokens-and-nfts.md)ガイドに進み、その方法を確認してください。