@ocap/client 1.25.5 → 1.26.0

package/docs/core-concepts-transaction-lifecycle.zh.md

@@ -1,72 +1,72 @@
 # 交易生命周期
 
-每一个修改区块链状态的操作，例如转移通证或创建资产，都是通过交易来执行的。理解交易的生命周期是使用 OCAP Client 构建应用的基础。此过程涉及四个主要阶段：准备、编码、签名和发送。
+每一个修改区块链状态的操作，例如转移通证或创建资产，都是通过交易来执行的。理解交易的生命周期是使用 OCAP 客户端构建应用程序的基础。此过程涉及四个主要阶段：准备、编码、签名和发送。
 
-OCAP Client 提供了一套灵活的方法，允许您为了最大程度的控制而单独执行这些步骤，或者为了方便而使用将它们组合在一起的高级辅助函数。
+OCAP 客户端提供了一套灵活的方法，允许您单独执行这些步骤以实现最大程度的控制，或者使用高级辅助函数将它们组合起来以方便使用。
 
 本指南将分解每个阶段，并说明单签名和多签名工作流。
 
 ## 生命周期概览
 
-下图说明了交易从准备到最终提交至区块链的完整过程。
+下图展示了一笔交易从准备到最终提交至区块链的完整过程。
 
-```d2 Transaction Lifecycle Diagram
+```d2 交易生命周期图
 direction: down
 
 Start: {
-  label: "1. Prepare Itx"
+  label: "1. 准备 Itx"
   shape: oval
 }
 
 Encode-Tx: {
-  label: "2. Encode Transaction\n(encode<Type>Tx)"
+  label: "2. 编码交易\n(encode<Type>Tx)"
   shape: rectangle
 }
 
 Sign-Tx: {
-  label: "3. Sign Transaction"
+  label: "3. 交易签名"
   shape: diamond
 }
 
 Single-Sign: {
-  label: "Single Signature\n(sign<Type>Tx)"
+  label: "单签名\n(sign<Type>Tx)"
   shape: rectangle
 }
 
 Multi-Sign-Flow: {
-  label: "Multi-Signature"
+  label: "多签名"
   shape: rectangle
   
   Multi-Sign-1: {
-    label: "Signer 1\n(multiSign<Type>Tx)"
+    label: "签名者 1\n(multiSign<Type>Tx)"
   }
   
   Multi-Sign-2: {
-    label: "Signer 2\n(multiSign<Type>Tx)"
+    label: "签名者 2\n(multiSign<Type>Tx)"
   }
 
   Multi-Sign-N: {
     label: "..."
   }
   
-  Multi-Sign-1 -> Multi-Sign-2: "Pass signed TX"
-  Multi-Sign-2 -> Multi-Sign-N: "Pass signed TX"
+  Multi-Sign-1 -> Multi-Sign-2: "传递已签名的交易"
+  Multi-Sign-2 -> Multi-Sign-N: "传递已签名的交易"
 }
 
 Send-Tx: {
-  label: "4. Send Transaction\n(send<Type>Tx)"
+  label: "4. 发送交易\n(send<Type>Tx)"
   shape: rectangle
 }
 
 End: {
-  label: "Transaction Hash"
+  label: "交易哈希"
   shape: oval
 }
 
 Start -> Encode-Tx
 Encode-Tx -> Sign-Tx
-Sign-Tx -> Single-Sign: "Single Signer"
-Sign-Tx -> Multi-Sign-Flow: "Multiple Signers"
+Sign-Tx -> Single-Sign: "单个签名者"
+Sign-Tx -> Multi-Sign-Flow: "多个签名者"
 Single-Sign -> Send-Tx
 Multi-Sign-Flow -> Send-Tx
 Send-Tx -> End
@@ -74,68 +74,68 @@ Send-Tx -> End
 
 ## 阶段 1：准备（创建 `itx`）
 
-每笔交易都始于一个 `itx`（内部交易）。这是一个纯粹的 JavaScript 对象，包含了您想要执行的操作的具体数据。例如，一个转账 `itx` 会包含接收方的地址和金额。
+每笔交易都始于一个 `itx`（内部交易）。这是一个纯 JavaScript 对象，包含了您想要执行的操作的具体数据。例如，一个转账 `itx` 会包含接收者的地址和金额。
 
-```javascript Preparing the itx icon=logos:javascript
+```javascript 准备 itx icon=logos:javascript
 // 我们转账交易的核心数据
 const itx = {
-  to: 'z2C8j81aL2oXpA5t42s2h4g9o8p1k6m3n7b', // 接收方地址
-  value: await client.fromTokenToUnit(10),   // 要发送的金额，已转换为链的基本单位
+  to: 'z2C8j81aL2oXpA5t42s2h4g9o8p1k6m3n7b', // 接收者地址
+  value: await client.fromTokenToUnit(10),   // 发送的金额，已转换为链的最小单位
 };
 ```
 
 ## 阶段 2：编码
 
-编码将 `itx` 和其他元数据转换为一种标准化的二进制格式，以便进行加密签名。客户端为每种交易类型提供了一个 `encode{TxType}Tx` 方法（例如，`encodeTransferV2Tx`）。
+编码将 `itx` 和其他元数据转换为可进行加密签名的标准化二进制格式。客户端为每种交易类型都提供了一个 `encode{TxType}Tx` 方法（例如 `encodeTransferV2Tx`）。
 
 在此阶段，客户端会自动添加必要的元数据：
 
-*   **`from`**：发送方地址，从提供的钱包中派生。
+*   **`from`**：发送者地址，从提供的钱包派生。
 *   **`chainId`**：目标区块链的标识符，自动获取。
-*   **`nonce`**：一个用于防止重放攻击的唯一数字，默认为当前时间戳（`Date.now()`）。
-*   **`pk`**：发送方钱包的公钥。
+*   **`nonce`**：用于防止重放攻击的唯一数字，默认为当前时间戳 (`Date.now()`)。
+*   **`pk`**：发送者钱包的公钥。
 
-编码函数会返回完整的交易对象和一个序列化数据的 `Buffer`，后者用于签名。
+编码函数返回完整的交易对象和用于签名的序列化数据 `Buffer`。
 
-```javascript Encoding the Transaction icon=logos:javascript
+```javascript 编码交易 icon=logos:javascript
 const { object: encodedTx, buffer: txBuffer } = await client.encodeTransferV2Tx({
   tx: { itx },
   wallet: senderWallet,
 });
 
-console.log('编码后的交易对象：', encodedTx);
-console.log('待签名的 Buffer：', txBuffer);
+console.log('Encoded TX Object:', encodedTx);
+console.log('Buffer to be signed:', txBuffer);
 ```
 
 ## 阶段 3：签名
 
-签名证明了账户的所有权并授权该交易。单签名和多签名工作流的过程有所不同。
+签名证明了账户的所有权并授权了该交易。单签名和多签名工作流的流程有所不同。
 
 ### 单签名工作流
 
-这是最常见的场景，即单个用户签署一笔交易。`sign{TxType}Tx` 方法接收编码后的交易，使用用户的私钥对二进制缓冲区进行签名，并填充 `signature` 字段。
+这是最常见的情景，即单个用户对一笔交易进行签名。`sign{TxType}Tx` 方法接收编码后的交易，使用用户的私钥对二进制缓冲区进行签名，并填充 `signature` 字段。
 
-```javascript Signing with a Single Signature icon=logos:javascript
+```javascript 使用单签名进行签名 icon=logos:javascript
 const signedTx = await client.signTransferV2Tx({
-  tx: encodedTx, // 编码步骤中得到的对象
+  tx: encodedTx, // 来自编码步骤的对象
   wallet: senderWallet,
 });
 
-console.log('签名：', signedTx.signature);
+console.log('Signature:', signedTx.signature);
 ```
 
 ### 多签名工作流
 
 多重签名（multisig）交易需要多方批准。这通常用于原子交换或共享账户。该过程是顺序的：
 
-1.  **准备**：创建初始交易时，需包含一个定义了所有必需签名者的 `signaturesList`。
-2.  **顺序签名**：交易从一个签名者传递到下一个。每个签名者使用相应的 `multiSign{TxType}Tx` 方法添加自己的签名。
+1.  **准备**：创建初始交易时，需包含一个 `signaturesList`，其中定义了所有必需的签名者。
+2.  **顺序签名**：交易从一个签名者传递到下一个。每个签名者使用相应的 `multiSign{TxType}Tx` 方法来添加他们的签名。
 
-在内部，`multiSign` 方法通过在编码交易以进行签名之前临时剥离所有现有签名，来确保各方签署的是完全相同的交易摘要。
+在内部，`multiSign` 方法通过在编码交易进行签名之前临时剥离所有现有签名，来确保各方签署完全相同的交易摘要。
 
-以下是一个关于 `ExchangeTx` 的示例，其中两方交换资产。
+以下是一个 `ExchangeTx` 的示例，其中两方交换资产。
 
-```javascript Multi-Signature Signing Example icon=logos:javascript
+```javascript 多重签名示例 icon=logos:javascript
 // 步骤 1：Alice（报价方）准备并签署交换交易。
 const txFromAlice = await client.prepareExchange({
   offerToken: 10,
@@ -145,23 +145,23 @@ const txFromAlice = await client.prepareExchange({
 });
 
 // 步骤 2：将交易发送给 Bob。
-// Bob（需求方）添加他的签名以最终完成交易。
+// Bob（需求方）添加他的签名以最终确定交易。
 const txFromBob = await client.finalizeExchange({
   tx: txFromAlice, // 由 Alice 签名的交易
   wallet: bobWallet,
 });
 
-console.log('Alice 的签名：', txFromBob.signaturesList[0].signature);
-console.log('Bob 的签名：', txFromBob.signaturesList[1].signature);
+console.log('Alice\'s Signature:', txFromBob.signaturesList[0].signature);
+console.log('Bob\'s Signature:', txFromBob.signaturesList[1].signature);
 ```
 
 ## 阶段 4：发送
 
-一旦交易被完全签名，就可以发送到区块链节点进行处理。`send{TxType}Tx` 方法处理这最后一步。
+一旦交易被完全签名，就可以将其发送到区块链节点进行处理。`send{TxType}Tx` 方法处理这最后一步。
 
-为方便起见，如果您提供一个钱包和一个未签名的交易，这些方法也可以隐式执行签名步骤。该方法返回一个 promise，在成功提交后会解析为交易哈希。
+为方便起见，如果您提供一个钱包和一个未签名的交易，这些方法也可以隐式执行签名步骤。该方法返回一个 promise，在成功提交后，该 promise 会解析为交易哈希。
 
-```javascript Sending the Signed Transaction icon=logos:javascript
+```javascript 发送已签名的交易 icon=logos:javascript
 // 使用预先签名的交易
 const hash = await client.sendTransferV2Tx({ tx: signedTx, wallet: senderWallet });
 
@@ -171,13 +171,13 @@ const hash2 = await client.sendTransferV2Tx({
   wallet: senderWallet,
 });
 
-console.log('交易已发送！哈希：', hash);
+console.log('Transaction sent! Hash:', hash);
 ```
 
-您还可以包含一个 `commit: true` 选项，让客户端在解析 promise 之前，等待交易被完全确认并包含在区块中。
+您还可以包含一个 `commit: true` 选项，使客户端在解析 promise 之前，等待交易被完全确认并包含在区块中。
 
 ## 总结
 
-交易生命周期为与区块链交互提供了一个强大而灵活的框架。通过将过程分解为准备、编码、签名和发送这几个不同阶段，OCAP Client 为开发者提供了对交易创建的精细控制，同时也为常见用例提供了简单的高级辅助函数。
+交易生命周期为与区块链交互提供了一个强大而灵活的框架。通过将过程分解为不同的阶段——准备、编码、签名和发送——OCAP 客户端为开发人员提供了对交易创建的精细控制，同时也为常见用例提供了简单的高级辅助函数。
 
-有关如何处理交易费用的更多详情，请参阅[燃料费支付](./core-concepts-gas-payment.md)指南。要了解可用的不同客户端类型，请参阅[客户端架构](./core-concepts-client-architecture.md)文档。
+有关交易费用处理的更多详细信息，请参阅[燃料费支付](./core-concepts-gas-payment.md)指南。要了解可用的不同客户端类型，请参阅[客户端架构](./core-concepts-client-architecture.md)文档。

package/docs/core-concepts.ja.md

@@ -1,22 +1,22 @@
 # コアコンセプト
 
-このセクションでは、OCAP Client ライブラリを形成する基本原則とアーキテクチャ上の決定について詳しく説明します。これらのコアコンセプトを理解することで、ライブラリの可能性を最大限に引き出し、より効率的なコードを記述し、問題をより効果的にトラブルシューティングできるようになります。
+このセクションでは、OCAP Clientライブラリを形成する基本原則とアーキテクチャ上の決定について詳しく説明します。これらのコアコンセプトを理解することで、ライブラリの潜在能力を最大限に活用し、より効率的なコードを記述し、問題をより効果的にトラブルシューティングできるようになります。
 
-[ハウツーガイド](./how-to-guides.md)では特定のタスクのステップバイステップの手順を説明していますが、このセクションではその「方法」の背後にある「理由」を説明します。クライアントの構造、トランザクションが最初から最後までどのように処理されるか、リアルタイムイベントのリッスン方法、そしてガスレスなユーザーエクスペリエンスの作成方法について探ります。
+[ハウツーガイド](./how-to-guides.md)では特定のタスクについてステップバイステップの手順を説明していますが、このセクションでは「どのように」の背景にある「なぜ」を解説します。ここでは、クライアントの構造、トランザクションが最初から最後までどのように処理されるか、リアルタイムイベントをリッスンする方法、そしてガスレスなユーザーエクスペリエンスを作成する方法について探ります。
 
 <x-cards data-columns="2">
   <x-card data-title="クライアントアーキテクチャ" data-icon="lucide:architecture" data-href="/core-concepts/client-architecture">
-    さまざまなクライアント実装（Node、ブラウザ、Lite）について学び、パフォーマンスとバンドルサイズを最適化するために、ご自身の環境に適したものを選択する方法を学びます。
+    さまざまなクライアント実装（Node、Browser、Lite）について学び、パフォーマンスとバンドルサイズを最適化するために、ご自身の環境に適したものを選択する方法を解説します。
   </x-card>
   <x-card data-title="トランザクションのライフサイクル" data-icon="lucide:refresh-cw" data-href="/core-concepts/transaction-lifecycle">
-    単純な JavaScript オブジェクトからチェーン上で確認済みのブロックになるまでのトランザクションの過程を追い、作成、エンコード、署名、ブロードキャストまでをカバーします。
+    単純なJavaScriptオブジェクトからチェーン上で確認済みのブロックになるまでのトランザクションの過程を追い、作成、エンコード、署名、ブロードキャストについて説明します。
   </x-card>
   <x-card data-title="イベントサブスクリプション" data-icon="lucide:radio-tower" data-href="/core-concepts/event-subscriptions">
-    WebSocket ベースのサブスクリプション機能を使用してリアルタイムのオンチェーンイベントをリッスンし、動的で応答性の高いアプリケーションを実現する方法を発見します。
+    WebSocketベースのサブスクリプション機能を使用してリアルタイムのオンチェーンイベントをリッスンし、ダイナミックでレスポンシブなアプリケーションを実現する方法を発見します。
   </x-card>
   <x-card data-title="ガス支払い" data-icon="lucide:gas-pump" data-href="/core-concepts/gas-payment">
-    指定されたウォレットがユーザーのトランザクション手数料を負担できるようにする強力なガス支払い機能を探索し、シームレスでガスレスな体験を創出します。
+    指定されたウォレットがユーザーのトランザクション手数料を負担できるようにする強力なガス支払い機能を探求し、シームレスでガスレスな体験を創出します。
   </x-card>
 </x-cards>
 
-これらの基礎的なトピックを理解することで、OCAP Client を使用して、堅牢でスケーラブル、かつユーザーフレンドリーなアプリケーションを構築するための準備が整います。
+これらの基礎的なトピックを把握することで、OCAP Clientを使用して、堅牢でスケーラブル、かつユーザーフレンドリーなアプリケーションを構築するための十分な準備が整います。

package/docs/core-concepts.zh-TW.md

@@ -1,22 +1,22 @@
 # 核心概念
 
-本節深入探討了 OCAP Client 程式庫的基本原則和架構決策。理解這些核心概念將有助於您充分發揮程式庫的潛力，撰寫更有效率的程式碼，並更有效地解決問題。
+本節深入探討塑造 OCAP Client 程式庫的基本原則與架構決策。了解這些核心概念將有助於您充分發揮程式庫的全部潛力、編寫更有效率的程式碼，並更有效地解決問題。
 
-[操作指南](./how-to-guides.md) 提供了特定任務的逐步說明，而本節則解釋了「如何做」背後的「為什麼」。我們將探討客戶端的結構、交易從開始到結束的處理過程、如何監聽即時事件，以及如何創造無 Gas 費的使用者體驗。
+雖然[操作指南](./how-to-guides.md)為特定任務提供了逐步說明，但本節解釋了「如何做」背後的「為什麼」。我們將探討客戶端的結構、交易如何從頭到尾被處理、如何監聽即時事件，以及如何創造無 Gas 費的使用者體驗。
 
 <x-cards data-columns="2">
   <x-card data-title="客戶端架構" data-icon="lucide:architecture" data-href="/core-concepts/client-architecture">
-    了解不同的客戶端實作（Node、Browser、Lite），以及如何為您的環境選擇合適的實作以優化效能和打包大小。
+    了解不同的客戶端實作（Node、瀏覽器、精簡版），以及如何為您的環境選擇合適的實作以優化效能和套件大小。
   </x-card>
   <x-card data-title="交易生命週期" data-icon="lucide:refresh-cw" data-href="/core-concepts/transaction-lifecycle">
-    追蹤一筆交易從簡單的 JavaScript 物件到鏈上確認區塊的完整過程，涵蓋創建、編碼、簽署和廣播。
+    追蹤一筆交易從簡單的 JavaScript 物件到鏈上確認區塊的整個過程，涵蓋了建立、編碼、簽署和廣播。
   </x-card>
   <x-card data-title="事件訂閱" data-icon="lucide:radio-tower" data-href="/core-concepts/event-subscriptions">
     探索如何使用基於 WebSocket 的訂閱功能來監聽即時的鏈上事件，從而實現動態且響應迅速的應用程式。
   </x-card>
   <x-card data-title="Gas 費支付" data-icon="lucide:gas-pump" data-href="/core-concepts/gas-payment">
-    探索強大的 Gas 費支付功能，該功能允許指定錢包為使用者支付交易費用，創造無縫、無 Gas 費的體驗。
+    探索強大的 Gas 費支付功能，該功能允許指定的錢包為使用者贊助交易費用，從而創造無縫、無 Gas 費的體驗。
   </x-card>
 </x-cards>
 
-掌握這些基礎主題後，您將能充分準備好使用 OCAP Client 建立穩健、可擴展且使用者友善的應用程式。
+透過掌握這些基礎主題，您將具備足夠的能力，使用 OCAP Client 來建構穩健、可擴展且使用者友善的應用程式。

package/docs/core-concepts.zh.md

@@ -1,22 +1,22 @@
 # 核心概念
 
-本节深入探讨了构成 OCAP Client 库的基本原则和架构决策。理解这些核心概念将帮助您充分发挥该库的潜力，编写更高效的代码，并更有效地解决问题。
+本节深入探讨了构成 OCAP Client 库的基本原则和架构决策。理解这些核心概念将帮助您充分发挥该库的潜力，编写更高效的代码，并更有效地排查问题。
 
-虽然[操作指南](./how-to-guides.md)为特定任务提供了分步说明，但本节解释了“如何做”背后的“为什么”。我们将探讨客户端的结构、交易从开始到结束的处理过程、如何监听实时事件以及如何创建无 Gas 费用的用户体验。
+虽然[操作指南](./how-to-guides.md)为特定任务提供了分步指导，但本节旨在解释“如何做”背后的“为什么”。我们将探讨客户端的结构、交易从开始到结束的处理过程、如何监听实时事件以及如何创建无 Gas 费用的用户体验。
 
 <x-cards data-columns="2">
   <x-card data-title="客户端架构" data-icon="lucide:architecture" data-href="/core-concepts/client-architecture">
-    了解不同的客户端实现（Node、Browser、Lite），以及如何为您的环境选择合适的实现以优化性能和包大小。
+    了解不同的客户端实现（Node、浏览器、精简版），以及如何根据您的环境选择合适的实现以优化性能和包大小。
   </x-card>
   <x-card data-title="交易生命周期" data-icon="lucide:refresh-cw" data-href="/core-concepts/transaction-lifecycle">
-    追踪一笔交易从简单的 JavaScript 对象到链上确认块的全过程，包括创建、编码、签名和广播。
+    追踪一笔交易从一个简单的 JavaScript 对象到链上确认区块的全过程，涵盖创建、编码、签名和广播。
   </x-card>
   <x-card data-title="事件订阅" data-icon="lucide:radio-tower" data-href="/core-concepts/event-subscriptions">
-    了解如何使用基于 WebSocket 的订阅功能来监听链上实时事件，从而实现动态和响应迅速的应用程序。
+    了解如何使用基于 WebSocket 的订阅功能来监听实时链上事件，从而实现动态和响应迅速的应用程序。
   </x-card>
   <x-card data-title="Gas 费支付" data-icon="lucide:gas-pump" data-href="/core-concepts/gas-payment">
-    探索强大的 Gas 费支付功能，该功能允许指定钱包为用户代付交易费用，从而创造无缝、无需 Gas 费的体验。
+    探索强大的 Gas 费支付功能，该功能允许指定钱包为用户代付交易费用，从而创造无缝、免 Gas 费的体验。
   </x-card>
 </x-cards>
 
-通过掌握这些基础主题，您将能够使用 OCAP Client 构建稳健、可扩展且用户友好的应用程序。
+通过掌握这些基础主题，您将能更好地使用 OCAP Client 构建稳健、可扩展且用户友好的应用程序。

package/docs/getting-started-basic-usage.ja.md

@@ -1,44 +1,44 @@
 # 基本的な使い方
 
-このガイドでは、OCAP Clientを使い始めるための基本的な手順を説明します。クライアントの初期化、ArcBlock Beta Chainへの接続、そしてすべてが正しく設定されていることを確認するための基本的なクエリの実行方法を学びます。
+このガイドでは、OCAP Clientを使い始めるための基本的な手順を説明します。クライアントの初期化、ArcBlockベータチェーンへの接続、そしてすべてが正しく設定されていることを確認するための基本的なクエリの実行方法を学びます。
 
-このガイドに従うことで、わずか数分でブロックチェーンと対話する準備が整ったクライアントインスタンスを稼働させることができます。
+このガイドに従うことで、わずか数分でブロックチェーンとやり取りできる、動作可能なクライアントインスタンスを準備できます。
 
 ## 1. クライアントの初期化
 
-まず、`@ocap/client` パッケージをインポートし、`GraphQLClient` のインスタンスを作成する必要があります。コンストラクタには、接続したいブロックチェーンノードのGraphQLエンドポイントを渡します。このガイドでは、ArcBlock Beta Chainの公開エンドポイントを使用します。
+まず、`@ocap/client`パッケージをインポートし、`GraphQLClient`のインスタンスを作成する必要があります。コンストラクタは、接続したいブロックチェーンノードのGraphQLエンドポイントを引数に取ります。このガイドでは、ArcBlockベータチェーンの公開エンドポイントを使用します。
 
 ```javascript Initialize Client icon=logos:javascript
 const GraphQLClient = require('@ocap/client');
 
-// Beta Chainに接続
+// ベータチェーンに接続
 const client = new GraphQLClient('https://beta.abtnetwork.io/api');
 
-console.log('OCAP Clientが初期化されました！');
+console.log('OCAP Client initialized!');
 ```
 
-これにより、チェーンのクエリ、トランザクションの送信などのメソッドが事前設定されたクライアントインスタンスが作成されます。
+これにより、チェーンへのクエリ、トランザクションの送信などのメソッドが事前設定されたクライアントインスタンスが作成されます。
 
-## 2. ブロックチェーンのクエリ
+## 2. ブロックチェーンへのクエリ
 
-クライアントが初期化されたので、簡単な読み取り専用操作を実行して接続を確認できます。`getChainInfo` メソッドは、接続されたブロックチェーンに関する基本情報を取得し、認証を必要としないため、この目的に最適です。
+クライアントが初期化されたので、簡単な読み取り専用操作を実行して接続を確認できます。`getChainInfo`メソッドは、接続されたブロックチェーンに関する基本情報を取得し、認証を必要としないため、この目的に最適です。
 
 ```javascript Query Chain Info icon=logos:javascript
 (async () => {
   try {
     const { info } = await client.getChainInfo();
-    console.log('チェーン情報:', info);
+    console.log('Chain Info:', info);
   } catch (error) {
-    console.error('チェーン情報の取得に失敗しました:', error);
+    console.error('Failed to get chain info:', error);
   }
 })();
 ```
 
-リクエストが成功すると、`info` オブジェクトがコンソールに出力されます。これには、チェーンのID、ネットワーク、サポートされているトランザクションタイプなどの詳細が含まれます。これにより、クライアントがブロックチェーンノードと正常に通信していることが確認できます。
+リクエストが成功すると、`info`オブジェクトがコンソールに出力されます。これには、チェーンのID、ネットワーク、サポートされているトランザクションタイプなどの詳細が含まれます。これにより、クライアントがブロックチェーンノードと正常に通信していることが確認できます。
 
 ## 3. アカウントの準備
 
-トランザクション（書き込み操作）を送信するには、ウォレットが必要です。ローカルで新しいウォレットを生成できます。このウォレットは、オンチェーンでのアカウントIDを表します。
+トランザクション（書き込み操作）を送信するには、ウォレットが必要です。新しいウォレットはローカルで生成できます。このウォレットは、あなたのオンチェーンアカウントのアイデンティティを表します。
 
 ```javascript Create a Wallet icon=logos:javascript
 const { fromRandom } = require('@ocap/wallet');
@@ -46,23 +46,23 @@ const { fromRandom } = require('@ocap/wallet');
 // 新しいランダムなウォレットを作成
 const wallet = fromRandom();
 
-console.log('新しいウォレットが作成されました:');
-console.log('アドレス:', wallet.address);
-console.log('公開鍵:', wallet.publicKey);
-console.log('秘密鍵:', wallet.secretKey);
+console.log('New wallet created:');
+console.log('Address:', wallet.address);
+console.log('PublicKey:', wallet.publicKey);
+console.log('SecretKey:', wallet.secretKey);
 ```
 
-**重要:** 新しく生成されたウォレットは単なるキーペアであり、まだブロックチェーン上には存在しません。アカウントは、そのアドレスが最初の受信トランザクションを受け取ったときに、オンチェーンで自動的に作成されます。
+**重要：** 新しく生成されたウォレットは、単なるキーペアです。まだブロックチェーン上には存在しません。アカウントは、そのアドレスが最初の受信トランザクションを受け取ったときに、オンチェーンで自動的に作成されます。
 
-新しいアカウントを有効にするには、テストトークンで資金を供給する必要があります。公式フォーセットからBeta Chain用の無料テストトークン（`TBA`）を入手できます：
+新しいアカウントを有効にするには、テストトークンで資金を供給する必要があります。ベータチェーン用の無料テストトークン（`TBA`）は、公式フォーセットから入手できます：
 
-<x-card data-title="ArcBlockフォーセット" data-icon="lucide:droplet" data-href="https://faucet.abtnetwork.io/" data-cta="テストトークンを取得">
+<x-card data-title="ArcBlock Faucet" data-icon="lucide:droplet" data-href="https://faucet.abtnetwork.io/" data-cta="テストトークンを取得">
   フォーセットにアクセスし、新しく生成したアドレスにTBAを送信して有効化してください。
 </x-card>
 
 ## 4. アカウント状態のクエリ
 
-フォーセットを使って新しいアカウントに資金を入金したら、その状態をクエリして残高を確認できます。
+フォーセットを使用して新しいアカウントに資金を供給したら、その状態をクエリして残高を確認できます。
 
 ```javascript Query Account State icon=logos:javascript
 (async () => {
@@ -71,17 +71,17 @@ console.log('秘密鍵:', wallet.secretKey);
     const address = wallet.address;
 
     const { state } = await client.getAccountState({ address });
-    console.log('アカウント状態:', state);
+    console.log('Account State:', state);
   } catch (error) {
-    console.error('アカウント状態の取得に失敗しました:', error);
+    console.error('Failed to get account state:', error);
   }
 })();
 ```
 
-レスポンスの `state` オブジェクトには、アカウントのアドレス、残高、ナンス（送信されたトランザクション数）、その他の詳細が含まれます。残高がゼロでないことを確認できれば、アカウントがフォーセットからトークンを受け取り、ブロックチェーン上で有効になったことが確定します。
+レスポンスの`state`オブジェクトには、アカウントのアドレス、残高、nonce（送信済みトランザクション数）、その他の詳細が含まれます。ゼロ以外の残高が表示されれば、アカウントがフォーセットからトークンを受け取り、ブロックチェーン上で有効になったことが確認できます。
 
 ## 次のステップ
 
-これでOCAP Clientのセットアップ、ブロックチェーンへの接続、アカウントの確認が正常に完了しました。より高度な操作に進む準備が整いました。
+これで、OCAP Clientのセットアップ、ブロックチェーンへの接続、アカウントの確認が正常に完了しました。より高度な操作を探求する準備が整いました。
 
 トークンの転送、アセットの管理などの一般的なタスクを実行する方法については、[ハウツーガイド](./how-to-guides.md)をご覧ください。

package/docs/getting-started-basic-usage.zh-TW.md

@@ -1,87 +1,87 @@
 # 基本用法
 
-本指南將引導您完成開始使用 OCAP Client 的基本步驟。您將學習如何初始化客戶端、連接到 ArcBlock Beta Chain，並執行基本查詢以確保一切設定正確。
+本指南將引導您完成開始使用 OCAP Client 的基本步驟。您將學習如何初始化客戶端、連接到 ArcBlock Beta 鏈，並執行基本查詢以確保一切設定正確。
 
-遵循本指南，您應可在幾分鐘內擁有一個可運作的客戶端實例，準備好與區塊鏈進行互動。
+遵循本指南，您應該能在幾分鐘內擁有一個可運作的客戶端實例，準備好與區塊鏈進行互動。
 
 ## 1. 初始化客戶端
 
-首先，您需要匯入 `@ocap/client` 套件並建立一個 `GraphQLClient` 的實例。建構函式需要傳入您想連接的區塊鏈節點的 GraphQL 端點。在本指南中，我們將使用 ArcBlock Beta Chain 的公共端點。
+首先，您需要匯入 `@ocap/client` 套件並建立一個 `GraphQLClient` 的實例。建構函式需要傳入您想連接的區塊鏈節點的 GraphQL 端點。在本指南中，我們將使用 ArcBlock Beta 鏈的公開端點。
 
-```javascript Initialize Client icon=logos:javascript
+```javascript 初始化客戶端 icon=logos:javascript
 const GraphQLClient = require('@ocap/client');
 
-// 連接到 Beta Chain
+// 連接到 Beta 鏈
 const client = new GraphQLClient('https://beta.abtnetwork.io/api');
 
-console.log('OCAP Client 初始化完成！');
+console.log('OCAP Client initialized!');
 ```
 
 這會建立一個客戶端實例，該實例已預先配置了查詢鏈、發送交易等方法。
 
 ## 2. 查詢區塊鏈
 
-現在客戶端已初始化，您可以執行一個簡單的唯讀操作來驗證連接。`getChainInfo` 方法非常適合此目的，因為它會獲取有關所連接區塊鏈的基本資訊，且無需任何身份驗證。
+既然客戶端已初始化，您可以執行一個簡單的唯讀操作來驗證連接。`getChainInfo` 方法非常適合此用途，因為它會擷取有關所連接區塊鏈的基本資訊，且不需要任何身份驗證。
 
-```javascript Query Chain Info icon=logos:javascript
+```javascript 查詢鏈資訊 icon=logos:javascript
 (async () => {
   try {
     const { info } = await client.getChainInfo();
-    console.log('鏈資訊：', info);
+    console.log('Chain Info:', info);
   } catch (error) {
-    console.error('獲取鏈資訊失敗：', error);
+    console.error('Failed to get chain info:', error);
   }
 })();
 ```
 
-如果請求成功，`info` 物件將被記錄到控制台，其中包含有關鏈的詳細資訊，例如其 ID、網路和支援的交易類型。這確認了您的客戶端已成功與區塊鏈節點通訊。
+如果請求成功，`info` 物件將會被記錄到主控台，其中包含鏈的詳細資訊，例如其 ID、網路和支援的交易類型。這確認了您的客戶端已成功與區塊鏈節點通訊。
 
-## 3. 準備一個帳戶
+## 3. 準備帳戶
 
-要發送交易（寫入操作），您需要一個錢包。您可以在本地生成一個新錢包。這個錢包代表您在鏈上的帳戶身份。
+要發送交易（寫入操作），您需要一個錢包。您可以在本地產生一個新錢包。這個錢包代表您在鏈上的帳戶身份。
 
-```javascript Create a Wallet icon=logos:javascript
+```javascript 建立錢包 icon=logos:javascript
 const { fromRandom } = require('@ocap/wallet');
 
 // 建立一個新的隨機錢包
 const wallet = fromRandom();
 
-console.log('新錢包已建立：');
-console.log('地址：', wallet.address);
-console.log('公鑰：', wallet.publicKey);
-console.log('私鑰：', wallet.secretKey);
+console.log('New wallet created:');
+console.log('Address:', wallet.address);
+console.log('PublicKey:', wallet.publicKey);
+console.log('SecretKey:', wallet.secretKey);
 ```
 
-**重要事項：** 新生成的錢包只是一個金鑰對。它尚未存在於區塊鏈上。當其地址收到第一筆傳入交易時，帳戶將在鏈上自動建立。
+**重要提示：** 新產生的錢包只是一個金鑰對。它尚未存在於區塊鏈上。當其地址收到第一筆傳入交易時，帳戶將在鏈上自動建立。
 
-要啟用您的新帳戶，您需要為其注資一些測試代幣。您可以從官方水龍頭獲取 Beta Chain 的免費測試代幣（`TBA`）：
+為了讓您的新帳戶生效，您需要用一些測試代幣為其注資。您可以從官方水龍頭獲取 Beta 鏈的免費測試代幣（`TBA`）：
 
 <x-card data-title="ArcBlock 水龍頭" data-icon="lucide:droplet" data-href="https://faucet.abtnetwork.io/" data-cta="獲取測試代幣">
-  訪問水龍頭並發送一些 TBA 到您新生成的地址以啟用它。
+  訪問水龍頭並發送一些 TBA 到您新產生的地址以啟動它。
 </x-card>
 
 ## 4. 查詢帳戶狀態
 
-使用水龍頭為您的新帳戶注資後，您可以查詢其狀態以驗證餘額。
+一旦您使用水龍頭為您的新帳戶注資後，您可以查詢其狀態以驗證餘額。
 
-```javascript Query Account State icon=logos:javascript
+```javascript 查詢帳戶狀態 icon=logos:javascript
 (async () => {
   try {
-    // 替換為您從水龍頭注資的地址
+    // 請替換為您從水龍頭注資的地址
     const address = wallet.address;
 
     const { state } = await client.getAccountState({ address });
-    console.log('帳戶狀態：', state);
+    console.log('Account State:', state);
   } catch (error) {
-    console.error('獲取帳戶狀態失敗：', error);
+    console.error('Failed to get account state:', error);
   }
 })();
 ```
 
-回應中的 `state` 物件將包含您帳戶的地址、餘額、nonce（已發送的交易數量）以及其他詳細資訊。看到非零餘額即確認您的帳戶已從水龍頭收到代幣，並已在區塊鏈上啟用。
+`state` 物件在回應中將包含您帳戶的地址、餘額、nonce（已發送的交易數量）以及其他詳細資訊。看到非零餘額即確認您的帳戶已從水龍頭收到代幣，並已在區塊鏈上啟用。
 
 ## 後續步驟
 
-您已成功設定 OCAP Client、連接到區塊鏈並驗證了您的帳戶。現在您已準備好探索更進階的操作。
+您已成功設定 OCAP Client、連接到區塊鏈並驗證了您的帳戶。現在，您已準備好探索更進階的操作。
 
 查看 [操作指南](./how-to-guides.md) 以學習如何執行常見任務，例如轉移代幣、管理資產等。