@ocap/client 1.25.6 → 1.26.0

package/docs/api-reference-transaction-helpers.zh-TW.md

@@ -1,8 +1,8 @@
 # 高階 API
 
-交易輔助工具是 OCAP Client 內建的高階函式，它將建立和簽署常見交易的複雜性抽象化。您無需手動建構交易物件，即可使用這些便利的方法來處理諸如建立資產、轉移代幣、質押和執行原子交換等工作流程。這些輔助工具確保交易結構正確，並顯著簡化開發過程。
+交易輔助函式是內建於 OCAP Client 的高階函式，它抽象化了建立和簽署常見交易的複雜性。您可以使用這些便利的方法來處理建立資產、轉移代幣、質押和執行原子交換等工作流程，而無需手動建構交易物件。這些輔助函式確保了交易結構的正確性，並顯著簡化了開發過程。
 
-要更深入地了解底層的交易生命週期，請參閱 [核心概念：交易生命週期](./core-concepts-transaction-lifecycle.md)。
+若要更深入地了解底層的交易生命週期，請參閱 [核心概念：交易生命週期](./core-concepts-transaction-lifecycle.md)。
 
 ---
 
@@ -10,16 +10,16 @@
 
 ### migrateAccount
 
-將帳戶的所有權遷移到新的金鑰對。這對於金鑰輪換或帳戶恢復很有用。
+將帳戶的所有權遷移到一個新的金鑰對。這對於金鑰輪替或帳戶復原非常有用。
 
 **參數**
 
 <x-field-group>
-  <x-field data-name="from" data-type="WalletObject" data-required="true" data-desc="要從中遷移的帳戶的錢包物件。"></x-field>
-  <x-field data-name="to" data-type="WalletObject" data-required="true" data-desc="要遷移到的帳戶的錢包物件。"></x-field>
+  <x-field data-name="from" data-type="WalletObject" data-required="true" data-desc="要移轉來源帳戶的錢包物件。"></x-field>
+  <x-field data-name="to" data-type="WalletObject" data-required="true" data-desc="要移轉目標帳戶的錢包物件。"></x-field>
 </x-field-group>
 
-**返回**
+**回傳值**
 
 <x-field data-name="transactionHash" data-type="Promise<string>" data-desc="已提交交易的雜湊值。"></x-field>
 
@@ -30,28 +30,28 @@ const txHash = await client.migrateAccount({
   from: oldWallet,
   to: newWallet,
 });
-console.log('Migration transaction hash:', txHash);
+console.log('遷移交易雜湊值：', txHash);
 ```
 
 ### delegate
 
-授權另一個帳戶（受託人）代表委託人發送特定類型的交易。這是一個用於建立安全、沙盒化權限的強大功能。
+授權另一個帳戶（被授權者）代表授權者發送特定類型的交易。這是一個用於建立安全、沙盒化權限的強大功能。
 
 **參數**
 
 <x-field-group>
-  <x-field data-name="from" data-type="WalletObject" data-required="true" data-desc="委託人的錢包，即授予權限的一方。"></x-field>
-  <x-field data-name="to" data-type="WalletObject" data-required="true" data-desc="受託人的錢包，即接收權限的一方。"></x-field>
-  <x-field data-name="privileges" data-type="array" data-required="true" data-desc="一個指定允許操作的權限物件陣列。">
-    <x-field data-name="typeUrl" data-type="string" data-required="true" data-desc="被允許的交易的類型 URL（例如：'fg:t:transfer_v2'）。"></x-field>
+  <x-field data-name="from" data-type="WalletObject" data-required="true" data-desc="授權者的錢包，即授予權限的一方。"></x-field>
+  <x-field data-name="to" data-type="WalletObject" data-required="true" data-desc="被授權者的錢包，即接收權限的一方。"></x-field>
+  <x-field data-name="privileges" data-type="array" data-required="true" data-desc="一個權限物件陣列，用於指定允許的操作。">
+    <x-field data-name="typeUrl" data-type="string" data-required="true" data-desc="被允許交易的類型 URL（例如 'fg:t:transfer_v2'）。"></x-field>
     <x-field data-name="limit" data-type="object" data-required="false" data-desc="對委託的可選限制。">
       <x-field data-name="tokens" data-type="array" data-desc="對特定同質化代幣的限制。"></x-field>
-      <x-field data-name="assets" data-type="array" data-desc="對特定資產（NFT）的限制。"></x-field>
+      <x-field data-name="assets" data-type="array" data-desc="對特定資產 (NFT) 的限制。"></x-field>
     </x-field>
   </x-field>
 </x-field-group>
 
-**返回**
+**回傳值**
 
 <x-field data-name="result" data-type="Promise<[string, string]>" data-desc="一個包含交易雜湊值和新建立的委託地址的陣列。"></x-field>
 
@@ -67,25 +67,25 @@ const [txHash, delegateAddress] = await client.delegate({
     },
   ],
 });
-console.log('Delegation tx hash:', txHash);
-console.log('Delegate address:', delegateAddress);
+console.log('委託交易雜湊值：', txHash);
+console.log('委託地址：', delegateAddress);
 ```
 
 ### revokeDelegate
 
-從受託人處撤銷先前授予的權限。
+從被授權者處撤銷先前授予的權限。
 
 **參數**
 
 <x-field-group>
-  <x-field data-name="from" data-type="WalletObject" data-required="true" data-desc="委託人的錢包。"></x-field>
-  <x-field data-name="to" data-type="WalletObject" data-required="true" data-desc="受託人的錢包。"></x-field>
-  <x-field data-name="privileges" data-type="array" data-required="true" data-desc="一個指定要撤銷權限的權限物件陣列。">
-     <x-field data-name="typeUrl" data-type="string" data-required="true" data-desc="要撤銷的交易的類型 URL（例如：'fg:t:transfer_v2'）。"></x-field>
+  <x-field data-name="from" data-type="WalletObject" data-required="true" data-desc="授權者的錢包。"></x-field>
+  <x-field data-name="to" data-type="WalletObject" data-required="true" data-desc="被授權者的錢包。"></x-field>
+  <x-field data-name="privileges" data-type="array" data-required="true" data-desc="一個權限物件陣列，用於指定要撤銷的權限。">
+     <x-field data-name="typeUrl" data-type="string" data-required="true" data-desc="要撤銷的交易類型 URL（例如 'fg:t:transfer_v2'）。"></x-field>
   </x-field>
 </x-field-group>
 
-**返回**
+**回傳值**
 
 <x-field data-name="transactionHash" data-type="Promise<string>" data-desc="已提交交易的雜湊值。"></x-field>
 
@@ -97,34 +97,34 @@ const txHash = await client.revokeDelegate({
   to: appWallet,
   privileges: ['fg:t:transfer_v2'],
 });
-console.log('Revocation tx hash:', txHash);
+console.log('撤銷委託交易雜湊值：', txHash);
 ```
 
 ---
 
-## 資產（NFT）管理
+## 資產 (NFT) 管理
 
 ### createAsset
 
-在區塊鏈上建立一個新資產（非同質化代幣）。
+在區塊鏈上建立一個新的資產（非同質化代幣）。
 
 **參數**
 
 <x-field-group>
   <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="一個包含資產元資料的 JSON 物件。"></x-field>
-  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="資產初始所有者的錢包。"></x-field>
+  <x-field data-name="data" data-type="object" data-required="true" data-desc="包含資產元資料的 JSON 物件。"></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="資產初始擁有者的錢包。"></x-field>
   <x-field data-name="parent" data-type="string" data-required="false" data-desc="父資產的地址，用於建立層級連結。"></x-field>
-  <x-field data-name="ttl" data-type="number" data-required="false" data-default="0" data-desc="首次消耗後的存活時間（以秒為單位）。"></x-field>
-  <x-field data-name="readonly" data-type="boolean" data-required="false" data-default="false" data-desc="如果為 true，資產在建立後無法更新。"></x-field>
-  <x-field data-name="transferrable" data-type="boolean" data-required="false" data-default="true" data-desc="如果為 true，資產可以轉移到另一個帳戶。"></x-field>
+  <x-field data-name="ttl" data-type="number" data-required="false" data-default="0" data-desc="首次消耗後的存活時間 (以秒為單位)。"></x-field>
+  <x-field data-name="readonly" data-type="boolean" data-required="false" data-default="false" data-desc="若為 true，資產在建立後無法更新。"></x-field>
+  <x-field data-name="transferrable" data-type="boolean" data-required="false" data-default="true" data-desc="若為 true，資產可以轉移至另一個帳戶。"></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-required="false" data-desc="用於分類的標籤陣列。"></x-field>
-  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="如果交易由受託人發送，則為委託人的地址。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="若交易由被授權者發送，則為授權者的地址。"></x-field>
 </x-field-group>
 
-**返回**
+**回傳值**
 
 <x-field data-name="result" data-type="Promise<[string, string]>" data-desc="一個包含交易雜湊值和新建立資產地址的陣列。"></x-field>
 
@@ -139,13 +139,13 @@ const [txHash, assetAddress] = await client.createAsset({
   },
   wallet: userWallet,
 });
-console.log('Create asset tx hash:', txHash);
-console.log('New asset address:', assetAddress);
+console.log('建立資產交易雜湊值：', txHash);
+console.log('新資產地址：', assetAddress);
 ```
 
 ### updateAsset
 
-更新現有非唯讀資產的 `moniker` 和 `data` 欄位。
+更新一個現有的、非唯讀資產的 `moniker` 和 `data` 欄位。
 
 **參數**
 
@@ -153,10 +153,10 @@ console.log('New asset address:', assetAddress);
   <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="資產的新 JSON 資料物件。"></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>
 
-**返回**
+**回傳值**
 
 <x-field data-name="transactionHash" data-type="Promise<string>" data-desc="已提交交易的雜湊值。"></x-field>
 
@@ -172,28 +172,28 @@ const txHash = await client.updateAsset({
   },
   wallet: userWallet,
 });
-console.log('Update asset tx hash:', txHash);
+console.log('更新資產交易雜湊值：', txHash);
 ```
 
 ### createAssetFactory
 
-建立一個資產工廠，它作為模板，用於鑄造具有一致結構的多個新資產。
+建立一個資產工廠，它作為一個模板，用於鑄造多個具有一致結構的新資產。
 
 **參數**
 
 <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-required="false" data-default="0" data-desc="可鑄造資產的最大數量（0 代表無限制）。"></x-field>
-    <x-field data-name="trustedIssuers" data-type="string[]" 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-required="false" data-default="0" 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>
   <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="擁有該工廠的錢包。"></x-field>
 </x-field-group>
 
-**返回**
+**回傳值**
 
 <x-field data-name="result" data-type="Promise<[string, string]>" data-desc="一個包含交易雜湊值和新建立工廠地址的陣列。"></x-field>
 
@@ -212,8 +212,8 @@ const [txHash, factoryAddress] = await client.createAssetFactory({
   factory: factoryConfig,
   wallet: eventCreatorWallet,
 });
-console.log('Create factory tx hash:', txHash);
-console.log('New factory address:', factoryAddress);
+console.log('建立工廠交易雜湊值：', txHash);
+console.log('新工廠地址：', factoryAddress);
 ```
 
 ### acquireAsset
@@ -223,28 +223,28 @@ console.log('New factory address:', factoryAddress);
 **參數**
 
 <x-field-group>
-  <x-field data-name="itx" data-type="AcquireAssetV2Tx" data-required="true" data-desc="內部交易物件，通常使用像 `preMintAsset` 這樣的輔助工具來準備。"></x-field>
+  <x-field data-name="itx" data-type="AcquireAssetV2Tx" 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-required="false" data-desc="委託人的地址（如適用）。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="授權者的地址，如果適用。"></x-field>
 </x-field-group>
 
-**返回**
+**回傳值**
 
 <x-field data-name="transactionHash" data-type="Promise<string>" data-desc="已提交交易的雜湊值。"></x-field>
 
 **範例**
 
 ```javascript Send an AcquireAssetV2Tx icon=logos:javascript
-// First, prepare the minting transaction (e.g., on the server)
+// 首先，準備鑄造交易 (例如，在伺服器上)
 const itx = await client.preMintAsset({
   factory: factoryAddress,
   owner: userWallet.address,
   wallet: issuerWallet,
 });
 
-// Then, the user sends the transaction
+// 然後，使用者發送交易
 const txHash = await client.acquireAsset({ itx, wallet: userWallet });
-console.log('Acquire asset tx hash:', txHash);
+console.log('獲取資產交易雜湊值：', txHash);
 ```
 
 ### mintAsset
@@ -254,11 +254,11 @@ console.log('Acquire asset tx hash:', txHash);
 **參數**
 
 <x-field-group>
-  <x-field data-name="itx" data-type="MintAssetTx" data-required="true" data-desc="內部交易物件，通常使用 `preMintAsset` 準備。"></x-field>
+  <x-field data-name="itx" data-type="MintAssetTx" 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>
 
-**返回**
+**回傳值**
 
 <x-field data-name="transactionHash" data-type="Promise<string>" data-desc="已提交交易的雜湊值。"></x-field>
 
@@ -272,7 +272,7 @@ const itx = await client.preMintAsset({
 });
 
 const txHash = await client.mintAsset({ itx, wallet: issuerWallet });
-console.log('Mint asset tx hash:', txHash);
+console.log('鑄造資產交易雜湊值：', txHash);
 ```
 
 ---
@@ -281,7 +281,7 @@ console.log('Mint asset tx hash:', txHash);
 
 ### createTokenFactory
 
-建立一個用於鑄造和銷毀特定同質化代幣的新工廠，通常基於聯合曲線定價模型。
+為鑄造和銷毀特定的同質化代幣建立一個新工廠，通常基於聯合曲線定價模型。
 
 **參數**
 
@@ -289,13 +289,13 @@ console.log('Mint asset tx hash:', txHash);
   <x-field data-name="feeRate" data-type="number" data-required="false" data-default="0" data-desc="鑄造和銷毀操作的手續費率。"></x-field>
   <x-field data-name="curve" data-type="object" data-required="true" data-desc="用於定價的聯合曲線配置。"></x-field>
   <x-field data-name="token" data-type="object" data-required="true">
-    <x-field-desc markdown>要建立的代幣的配置。這包括諸如 `name`、`symbol`、`decimal` 和 `maxTotalSupply` 等屬性。</x-field-desc>
+    <x-field-desc markdown>要建立的代幣的配置。這包括 `name`、`symbol`、`decimal` 和 `maxTotalSupply` 等屬性。</x-field-desc>
   </x-field>
   <x-field data-name="data" data-type="object" 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="wallet" data-type="WalletObject" data-required="true" data-desc="工廠擁有者的錢包。"></x-field>
 </x-field-group>
 
-**返回**
+**回傳值**
 
 <x-field data-name="result" data-type="Promise<[string, string]>" data-desc="一個包含交易雜湊值和新建立代幣工廠地址的陣列。"></x-field>
 
@@ -304,7 +304,7 @@ console.log('Mint asset tx hash:', txHash);
 ```javascript Send a CreateTokenFactoryTx icon=logos:javascript
 const [txHash, factoryAddress] = await client.createTokenFactory({
   feeRate: 100, // 1%
-  curve: { fixedPrice: '1' }, // 1 native token per new token
+  curve: { fixedPrice: '1' }, // 每個新代幣對應 1 個原生代幣
   token: {
     name: 'My Community Token',
     symbol: 'MCT',
@@ -313,8 +313,8 @@ const [txHash, factoryAddress] = await client.createTokenFactory({
   },
   wallet: creatorWallet,
 });
-console.log('Create token factory tx hash:', txHash);
-console.log('New token factory address:', factoryAddress);
+console.log('建立代幣工廠交易雜湊值：', txHash);
+console.log('新代幣工廠地址：', factoryAddress);
 ```
 
 ### updateTokenFactory
@@ -327,10 +327,10 @@ console.log('New token factory address:', factoryAddress);
   <x-field data-name="address" data-type="string" data-required="true" data-desc="要更新的代幣工廠地址。"></x-field>
   <x-field data-name="feeRate" data-type="number" 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="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>
 
-**返回**
+**回傳值**
 
 <x-field data-name="transactionHash" data-type="Promise<string>" data-desc="已提交交易的雜湊值。"></x-field>
 
@@ -342,12 +342,12 @@ const txHash = await client.updateTokenFactory({
   feeRate: 50, // 0.5%
   wallet: ownerWallet,
 });
-console.log('Update token factory tx hash:', txHash);
+console.log('更新代幣工廠交易雜湊值：', txHash);
 ```
 
 ### mintToken
 
-從代幣工廠鑄造新代幣，以換取儲備代幣（通常是原生鏈代幣）。成本由工廠的聯合曲線決定。
+從代幣工廠鑄造新代幣，以換取儲備代幣（通常是鏈原生代幣）。成本由工廠的聯合曲線決定。
 
 **參數**
 
@@ -360,7 +360,7 @@ console.log('Update token factory tx hash:', txHash);
   <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="發起鑄造的錢包。"></x-field>
 </x-field-group>
 
-**返回**
+**回傳值**
 
 <x-field data-name="transactionHash" data-type="Promise<string>" data-desc="已提交交易的雜湊值。"></x-field>
 
@@ -371,10 +371,10 @@ const txHash = await client.mintToken({
   tokenFactory: 'z2f...',
   amount: 100,
   receiver: userWallet.address,
-  maxReserve: 105, // Willing to pay up to 105 native tokens
+  maxReserve: 105, // 願意支付最多 105 個原生代幣
   wallet: userWallet,
 });
-console.log('Mint token tx hash:', txHash);
+console.log('鑄造代幣交易雜湊值：', txHash);
 ```
 
 ### burnToken
@@ -387,12 +387,12 @@ console.log('Mint token tx hash:', txHash);
   <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="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 data-name="wallet" data-type="WalletObject" data-required="true" data-desc="發起銷毀的錢包。"></x-field>
 </x-field-group>
 
-**返回**
+**回傳值**
 
 <x-field data-name="transactionHash" data-type="Promise<string>" data-desc="已提交交易的雜湊值。"></x-field>
 
@@ -403,10 +403,10 @@ const txHash = await client.burnToken({
   tokenFactory: 'z2f...',
   amount: 50,
   receiver: userWallet.address,
-  minReserve: 48, // Expecting to receive at least 48 native tokens
+  minReserve: 48, // 期望收到至少 48 個原生代幣
   wallet: userWallet,
 });
-console.log('Burn token tx hash:', txHash);
+console.log('銷毀代幣交易雜湊值：', txHash);
 ```
 
 ---
@@ -415,7 +415,7 @@ console.log('Burn token tx hash:', txHash);
 
 ### transfer
 
-在單一交易中將原生代幣、自訂同質化代幣和/或資產（NFT）轉移到另一個帳戶。
+在單一交易中將原生代幣、自訂同質化代幣和/或資產 (NFT) 轉移到另一個帳戶。
 
 **參數**
 
@@ -423,16 +423,16 @@ console.log('Burn token tx hash:', txHash);
   <x-field data-name="to" data-type="string" 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="token" data-type="number" data-required="false" data-default="0" data-desc="要轉移的鏈原生代幣數量。"></x-field>
-  <x-field data-name="assets" data-type="string[]" data-required="false" data-desc="要轉移的資產地址（NFT）陣列。"></x-field>
+  <x-field data-name="assets" data-type="string[]" data-required="false" data-desc="要轉移的資產地址 (NFT) 陣列。"></x-field>
   <x-field data-name="tokens" data-type="object[]" data-required="false" data-desc="要轉移的自訂同質化代幣物件陣列。">
     <x-field data-name="address" data-type="string" data-required="true" data-desc="自訂代幣合約的地址。"></x-field>
     <x-field data-name="value" data-type="number" data-required="true" data-desc="要轉移的自訂代幣數量。"></x-field>
   </x-field>
   <x-field data-name="memo" data-type="string" data-required="false" data-desc="交易的可選備註。"></x-field>
-  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="委託人的地址（如適用）。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="授權者的地址，如果適用。"></x-field>
 </x-field-group>
 
-**返回**
+**回傳值**
 
 <x-field data-name="transactionHash" data-type="Promise<string>" data-desc="已提交交易的雜湊值。"></x-field>
 
@@ -441,50 +441,50 @@ console.log('Burn token tx hash:', txHash);
 ```javascript Send a TransferV2Tx icon=logos:javascript
 const txHash = await client.transfer({
   to: 'z1sb...',
-  token: 1.5, // 1.5 of the native chain token
-  assets: ['z3g...'], // An NFT
-  tokens: [{ address: 'z2t...', value: 100 }], // 100 of a custom token
+  token: 1.5, // 1.5 個鏈原生代幣
+  assets: ['z3g...'], // 一個 NFT
+  tokens: [{ address: 'z2t...', value: 100 }], // 100 個自訂代幣
   memo: 'Payment for services',
   wallet: senderWallet,
 });
-console.log('Transfer tx hash:', txHash);
+console.log('轉帳交易雜湊值：', txHash);
 ```
 
 ### prepareExchange
 
-準備原子交換交易中發送方的一半。它會簽署發送方的報價，並返回一個可以傳遞給接收方的交易物件。
+準備原子交換（exchange）交易中發送方的一半。它會簽署發送方的要約並回傳一個可以傳遞給接收方的交易物件。
 
 **參數**
 
 <x-field-group>
   <x-field data-name="receiver" data-type="string" 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="wallet" data-type="WalletObject" data-required="true" data-desc="提出要約的使用者錢包。"></x-field>
   <x-field data-name="offerToken" data-type="number" data-required="false" data-desc="提供的原生代幣數量。"></x-field>
   <x-field data-name="offerAssets" data-type="string[]" data-required="false" data-desc="提供的資產地址陣列。"></x-field>
   <x-field data-name="offerTokens" data-type="object[]" data-required="false" data-desc="提供的自訂同質化代幣陣列。"></x-field>
-  <x-field data-name="demandToken" data-type="number" data-required="false" data-desc="要求回報的原生代幣數量。"></x-field>
-  <x-field data-name="demandAssets" data-type="string[]" data-required="false" data-desc="要求回報的資產地址陣列。"></x-field>
-  <x-field data-name="demandTokens" data-type="object[]" data-required="false" data-desc="要求回報的自訂同質化代幣陣列。"></x-field>
+  <x-field data-name="demandToken" data-type="number" data-required="false" data-desc="要求交換的原生代幣數量。"></x-field>
+  <x-field data-name="demandAssets" data-type="string[]" data-required="false" data-desc="要求交換的資產地址陣列。"></x-field>
+  <x-field data-name="demandTokens" data-type="object[]" data-required="false" data-desc="要求交換的自訂同質化代幣陣列。"></x-field>
   <x-field data-name="memo" data-type="string" data-required="false" data-desc="交易的可選備註。"></x-field>
 </x-field-group>
 
-**返回**
+**回傳值**
 
 <x-field data-name="transactionObject" data-type="Promise<object>" data-desc="部分簽署的交易物件。"></x-field>
 
 ### finalizeExchange
 
-完成原子交換中接收方的一半。它接收來自 `prepareExchange` 的部分簽署交易，添加接收方的簽名，並返回完全簽署的交易物件。
+完成原子交換中接收方的一半。它接收來自 `prepareExchange` 的部分簽署交易，加入接收方的簽名，並回傳完全簽署的交易物件。
 
 **參數**
 
 <x-field-group>
-  <x-field data-name="tx" data-type="object" data-required="true" data-desc="從 `prepareExchange` 返回的交易物件。"></x-field>
-  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="接受報價的使用者錢包。"></x-field>
+  <x-field data-name="tx" data-type="object" data-required="true" data-desc="從 `prepareExchange` 回傳的交易物件。"></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" 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="transactionObject" data-type="Promise<object>" data-desc="完全簽署的多重簽名交易物件。"></x-field>
 
@@ -495,34 +495,34 @@ console.log('Transfer tx hash:', txHash);
 **參數**
 
 <x-field-group>
-  <x-field data-name="tx" data-type="object" data-required="true" data-desc="從 `finalizeExchange` 返回的交易物件。"></x-field>
+  <x-field data-name="tx" data-type="object" data-required="true" data-desc="從 `finalizeExchange` 回傳的交易物件。"></x-field>
   <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="提交交易的使用者錢包。"></x-field>
 </x-field-group>
 
-**返回**
+**回傳值**
 
 <x-field data-name="transactionHash" data-type="Promise<string>" data-desc="已提交交易的雜湊值。"></x-field>
 
 **範例（完整交換流程）**
 
 ```javascript Perform an atomic swap icon=logos:javascript
-// 1. Offerer prepares the transaction
+// 1. 要約方準備交易
 const offerTx = await client.prepareExchange({
   receiver: receiverWallet.address,
-  offerAssets: ['z3g...'], // Offer an NFT
-  demandToken: 10, // Demand 10 native tokens
+  offerAssets: ['z3g...'], // 提供一個 NFT
+  demandToken: 10, // 要求 10 個原生代幣
   wallet: offererWallet,
 });
 
-// 2. Receiver finalizes the transaction
+// 2. 接收方完成交易
 const finalTx = await client.finalizeExchange({
   tx: offerTx,
   wallet: receiverWallet,
 });
 
-// 3. Either party can send the finalized transaction
+// 3. 任何一方都可以發送最終確定的交易
 const txHash = await client.exchange({ tx: finalTx, wallet: offererWallet });
-console.log('Exchange tx hash:', txHash);
+console.log('交換交易雜湊值：', txHash);
 ```
 
 ---
@@ -541,11 +541,11 @@ console.log('Exchange tx hash:', txHash);
   <x-field data-name="assets" data-type="string[]" data-required="false" data-desc="要質押的資產地址陣列。"></x-field>
   <x-field data-name="tokens" data-type="object[]" data-required="false" data-desc="要質押的同質化代幣物件陣列。"></x-field>
   <x-field data-name="locked" data-type="boolean" data-required="false" data-default="false" data-desc="質押在建立時是否被鎖定。"></x-field>
-  <x-field data-name="slashers" data-type="string[]" data-required="false" data-desc="被允許懲罰此質押的地址列表。"></x-field>
+  <x-field data-name="slashers" data-type="string[]" data-required="false" data-desc="被允許削減此質押的地址列表。"></x-field>
   <x-field data-name="message" data-type="string" data-required="false" data-desc="質押的可選備註。"></x-field>
 </x-field-group>
 
-**返回**
+**回傳值**
 
 <x-field data-name="result" data-type="Promise<[string, string]>" data-desc="一個包含交易雜湊值和新建立質押地址的陣列。"></x-field>
 
@@ -558,24 +558,24 @@ const [txHash, stakeAddress] = await client.stake({
   message: 'Staking for validator rewards',
   wallet: userWallet,
 });
-console.log('Stake tx hash:', txHash);
-console.log('New stake address:', stakeAddress);
+console.log('質押交易雜湊值：', txHash);
+console.log('新質押地址：', stakeAddress);
 ```
 
 ### revokeStake
 
-撤銷先前質押的代幣和/或資產，啟動將其歸還給所有者的流程。請注意，在資產可以領取之前，可能會有一個解綁期。
+撤銷先前質押的代幣和/或資產，啟動將其歸還給所有者的過程。請注意，在可以領取資產之前，可能會有一個解質押期。
 
 **參數**
 
 <x-field-group>
   <x-field data-name="from" data-type="string" 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="wallet" data-type="WalletObject" data-required="true" data-desc="質押擁有者的錢包。"></x-field>
   <x-field data-name="assets" data-type="string[]" data-required="false" data-desc="要撤銷的資產地址陣列。"></x-field>
   <x-field data-name="tokens" data-type="object[]" data-required="false" data-desc="要撤銷的同質化代幣物件陣列。"></x-field>
 </x-field-group>
 
-**返回**
+**回傳值**
 
 <x-field data-name="transactionHash" data-type="Promise<string>" data-desc="已提交交易的雜湊值。"></x-field>
 
@@ -587,22 +587,22 @@ const txHash = await client.revokeStake({
   tokens: [{ address: 'z2t...', value: 1000 }],
   wallet: userWallet,
 });
-console.log('Revoke stake tx hash:', txHash);
+console.log('撤銷質押交易雜湊值：', txHash);
 ```
 
 ### claimStake
 
-領取已成功撤銷並度過解綁期的質押物品。
+從一個已成功撤銷並度過解質押期的質押中領取項目。
 
 **參數**
 
 <x-field-group>
   <x-field data-name="from" data-type="string" data-required="true" data-desc="要從中領取的質押地址。"></x-field>
   <x-field data-name="evidence" data-type="string" data-required="true" data-desc="`revokeStake` 交易的交易雜湊值。"></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>
 
-**返回**
+**回傳值**
 
 <x-field data-name="transactionHash" data-type="Promise<string>" data-desc="已提交交易的雜湊值。"></x-field>
 
@@ -615,24 +615,24 @@ const txHash = await client.claimStake({
   evidence: revokeTxHash,
   wallet: userWallet,
 });
-console.log('Claim stake tx hash:', txHash);
+console.log('領取質押交易雜湊值：', txHash);
 ```
 
 ### slashStake
 
-允許指定的懲罰者對質押進行懲罰，通常是因為不當行為。被懲罰的資產將被轉移到指定的金庫地址。
+允許指定的削減者懲罰一個質押，通常是因為不當行為。被削減的資產會被轉移到一個指定的金庫地址。
 
 **參數**
 
 <x-field-group>
-  <x-field data-name="from" data-type="string" data-required="true" data-desc="要懲罰的質押地址。"></x-field>
-  <x-field data-name="reason" data-type="string" 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="assets" data-type="string[]" data-required="false" data-desc="要懲罰的資產地址陣列。"></x-field>
-  <x-field data-name="tokens" data-type="object[]" data-required="false" data-desc="要懲罰的同質化代幣物件陣列。"></x-field>
+  <x-field data-name="from" data-type="string" data-required="true" data-desc="要削減的質押地址。"></x-field>
+  <x-field data-name="reason" data-type="string" 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="assets" data-type="string[]" data-required="false" data-desc="要削減的資產地址陣列。"></x-field>
+  <x-field data-name="tokens" data-type="object[]" data-required="false" data-desc="要削減的同質化代幣物件陣列。"></x-field>
 </x-field-group>
 
-**返回**
+**回傳值**
 
 <x-field data-name="transactionHash" data-type="Promise<string>" data-desc="已提交交易的雜湊值。"></x-field>
 
@@ -645,5 +645,5 @@ const txHash = await client.slashStake({
   tokens: [{ address: 'z2t...', value: 500 }],
   wallet: slasherWallet,
 });
-console.log('Slash stake tx hash:', txHash);
+console.log('削減質押交易雜湊值：', txHash);
 ```